Repository navigation
Agents.MD shipped and bug fixes to DB agent - #86
Merged
Merged
Conversation
Coding agents are becoming the first visitor that matters: Deno ships deno.com/agents.md and a paste-one-line block, and the same door was missing here. static/agents.md is setup instructions written for an agent, with three verified paths - a throwaway demo project the agent mints itself (no account; the id is the credential, the dashboard link is the handoff), a self-hosted deploy via the CLI, and a managed console project. llms.txt points at it. The landing page gets a Deno-style install section between the runtime strip and pricing: the CLI one-liner, then "Or let your agent do it" with a copyable "Read frostbase.dev/agents.md and set up Frostbase in this project". The demo path was verified against production, which surfaced two things the doc now reflects: fresh collections default to readAccess/writeAccess "auth", so the flow mints a project JWT via anonymous sign-in first; and the doc creates collections explicitly (PUT /db/admin/collections/:name) because the lazy auto-create pull is currently answering persistent 503s on production while the explicit push path works - see the ensure-config Sentry tag.
The first REST touch of a brand-new project answered a persistent 503
("collection is unavailable") - on production and reproduced locally.
The collection's lazy config pull reached the parent DbAgent through a
raw namespace stub, and plain RPC bypasses the SDK's fetch-path
initialization, so a parent that had never been woken over HTTP served
the pull before onStart had run its migrations: "no such table:
collections", caught, 503 - forever, until anything touched the parent
over HTTP. The dashboard always provisions through the admin surface
(which wakes the parent properly), which is why the console masked it
and why every e2e db test missed it too.
getAgentByName exists for exactly this - it synchronizes on onStart
before returning the stub - so the three parentStub helpers (collection,
table, gateway) now use it instead of namespace.get(idFromName()). The
new e2e test drives the uncovered path: a genuinely fresh project whose
very first contact is the REST write, asserting the auth refusal that
proves auto-create ran rather than the 503.
Found while verifying agents.md's demo path against production; the
version stays 0.7.0 so publishing remains a release decision.
This branch was successfully deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
No description provided.