@cat-factory/server 0.311.3 → 0.314.0

package/dist/agents/ContainerRepoBootstrapper.d.ts

@@ -1,9 +1,10 @@
-import type { BootstrapJobHandle, BootstrapJobRepository, BootstrapJobUpdate, BootstrapRepoOutcome, BootstrapRepoRequest, GitHubClient, MonorepoTargetRepo, GitHubInstallationRepository, GitHubRepo, GroupCacheHandle, ModelRef, RepoBootstrapper, RepoProjectionRepository } from '@cat-factory/kernel';
+import type { AgentContextRecorder, BootstrapJobHandle, BootstrapJobRepository, BootstrapJobUpdate, BootstrapRepoOutcome, BootstrapRepoRequest, GitHubClient, MonorepoTargetRepo, GitHubInstallationRepository, GitHubRepo, GroupCacheHandle, ModelRef, RepoBootstrapper, RepoProjectionRepository } from '@cat-factory/kernel';
 import type { ContainerSessionService } from '../containers/ContainerSessionService.js';
+import { type ToolTrajectoryDeps } from './toolTrajectory.js';
 import type { JobPackageRegistrySpec } from './ContainerAgentExecutor.js';
 import type { MintInstallationToken } from './repoTargeting.js';
 import { type ResolveRunnerTransport } from './RunnerJobClient.js';
-export interface ContainerRepoBootstrapperDependencies {
+export interface ContainerRepoBootstrapperDependencies extends ToolTrajectoryDeps {
     /**
      * Resolve which runner backend (Cloudflare container or self-hosted pool) a
      * bootstrap job dispatches to — the same seam the implementation executor rides.
@@ -39,6 +40,12 @@ export interface ContainerRepoBootstrapperDependencies {
     githubApiBase?: string;
     /** Web base for building the created repo's URL (defaults to github.com). */
     webBaseUrl?: string;
+    /**
+     * Records the complete context each bootstrap dispatch handed its agent (best-effort, gated
+     * inside the recorder). Absent ⇒ a bootstrap's "Provided context" tab is empty, which is the
+     * shape every other agent run's would have if its executor skipped this call.
+     */
+    agentContextObservability?: AgentContextRecorder;
     /**
      * Resolve the workspace's private package-registry entries for the bootstrap
      * container (the scaffolder installs dependencies too). Same seam as
@@ -84,29 +91,120 @@ export declare class ContainerRepoBootstrapper implements RepoBootstrapper {
      * Pre-flight the target repo and dispatch the bootstrap container as a
      * background job (returns once accepted, like `/run`). Throws on a pre-flight
      * failure so the run fails fast before a board frame is created.
+     *
+     * THREE dispatch shapes, chosen by the target and the run's delivery. A new repository
+     * delivered by `direct_push` is the original one (adapt a clone, reinitialise, force-push);
+     * everything else is the ordinary coding shape (clone the writable target, template beside it
+     * read-only, work branch, pull request), because the target already holds a history nobody may
+     * reset: the monorepo's, or the initial commit a pull request has to be opened against.
      */
     startBootstrap(request: BootstrapRepoRequest): Promise<BootstrapJobHandle>;
+    /**
+     * Pre-flight the pre-created target repository of a NEW-REPO run: it exists, the App can
+     * write to it, and it holds no real content.
+     *
+     * The target repo is created up front: by the user via the host's new-repo page, or, for
+     * privileged-tier orgs (ADR 0005), programmatically via the create-repo endpoint behind the
+     * modal's "Create repository" button.
+     *
+     * The emptiness rule binds under both deliveries, because both WRITE a whole service into the
+     * repository: a force-push would clobber real content and a pull request would propose
+     * deleting it. What differs is the FLOOR: a pull request needs an initial commit to branch
+     * from, so that delivery also refuses a repository with none.
+     */
+    private preflightNewRepoTarget;
+    /**
+     * Dispatch a NEW-REPO run delivered as a pull request: the ordinary coding shape against the
+     * (already-initialised) target repository, with the reference template beside it as a
+     * READ-ONLY sibling checkout.
+     *
+     * Deliberately NOT the `bootstrap` spec, which is the whole reason this path exists
+     * separately: that spec reinitialises history and force-pushes, and a branch whose history
+     * shares no ancestor with the default branch is not something a pull request can be opened
+     * from. Here the target's own initial commit is the base, so the diff a reviewer reads is the
+     * service being added.
+     */
+    private startNewRepoPullRequest;
     /**
      * Dispatch a monorepo bootstrap's APPLY phase: an ordinary coding job on the monorepo, with
      * the reference template alongside it as a READ-ONLY sibling checkout.
      *
      * Deliberately the plain coding shape rather than a `bootstrap` spec, and that is the design:
-     * the harness already knows how to clone a writable primary at a work branch, clone
-     * `referenceRepos` beside it without ever branching or pushing them, and open one pull request
-     * for the primary. A bespoke bootstrap mode here would be a second implementation of that with
-     * one extra way to get the push wrong, against a repository that holds other people's code.
+     * the harness already knows how to clone a writable primary (at a work branch, or at the
+     * default branch it commits onto, per the run's delivery), clone `referenceRepos` beside it
+     * without ever branching or pushing them, and open one pull request for the primary when it
+     * was given one to open. A bespoke bootstrap mode here would be a second implementation of
+     * that with one extra way to get the push wrong, against a repository that holds other
+     * people's code.
      *
      * `repo.serviceDirectory` is what scopes the agent to the new subdirectory: the same field
      * every monorepo-service run rides, so the working-directory rule is stated in one place.
      *
      * Two pre-flights, both about the monorepo rather than about a new repo: the App must be able
      * to WRITE to it (a read-only grant reads fine and 403s on the push, after a board frame
-     * exists), and the target directory must still be absent at dispatch time, because the orchestration
-     * pre-flighted it before the survey, and a review can be settled days later.
+     * exists), and the target directory must still be absent at dispatch time, because the
+     * orchestration pre-flighted it before the survey and a review can be settled days later.
      */
     private startMonorepoBootstrap;
+    /**
+     * The dispatch both non-force-push shapes share: clone the writable target, fetch the
+     * reference template beside it read-only, and either open a work branch plus a pull request
+     * or commit onto the target's own default branch.
+     *
+     * ONE builder rather than one per target, because the delivery rule is the interesting part
+     * and a second copy of it is a second place for `newBranch` and `pr` to disagree: a body
+     * carrying a branch but no PR pushes work onto a branch nobody is told about.
+     */
+    private dispatchCodingShape;
+    /**
+     * Resolve the reference template a run reads from: its clone spec, plus the numeric id the
+     * run's installation token has to be scoped to.
+     *
+     * ONE resolution for both dispatch shapes, because both CLONE the template and both mint the
+     * token that clone runs on. Two copies is what left the force-push path granting only its push
+     * target while cloning the template with that same token, so a PRIVATE reference architecture
+     * 404s on clone under one delivery and works under the other, and what left it assuming the
+     * template's base branch was `main`.
+     *
+     * A template the installation cannot read resolves to no id and the conventional branch rather
+     * than refusing the run: the clone then fails inside the harness naming the repository, which
+     * is a better report than a pre-flight throw here, and the warning says which read failed.
+     */
+    private resolveReferenceTemplate;
+    /**
+     * The model-locked LLM-proxy session token a bootstrap container runs under.
+     *
+     * Keyed on the RUN, never on the drive: a monorepo run's apply phase is dispatched under its
+     * own container job id, so minting on that id files the apply's model calls under a key no
+     * run-scoped read asks for, and the run reports only what its survey spent.
+     */
+    private mintSessionToken;
+    /** The host's web base, trailing slashes stripped, for building clone URLs. */
+    private webBase;
     /** Poll a dispatched bootstrap job, mapping the runner job view into an update. */
     pollBootstrap(handle: BootstrapJobHandle): Promise<BootstrapJobUpdate>;
+    /**
+     * The dispatched container job as an {@link AgentJobHandle}, the shape the shared trajectory
+     * drain speaks. `runId` is the bootstrap RUN and `jobId` the container job it dispatched,
+     * which is the same split every execution step's handle carries.
+     */
+    private jobHandle;
+    /**
+     * The resolved model as every OTHER producer writes it: `provider:model`, which is the format
+     * `AgentJobHandle.model` and `agentContextSnapshotSchema.model` both document. A bare model id
+     * renders beside prefixed ones on the same panel and gives nothing to a reader that splits the
+     * field to recover the provider.
+     */
+    private resolvedModel;
+    /**
+     * File what this dispatch handed the agent, so a bootstrap's Provided-context tab answers the
+     * same question every other agent run's does.
+     *
+     * AWAITED for the reason `recordAgentContextSnapshot` states: it runs after the container has
+     * already been accepted, so it delays nothing but the handle's return, and an un-awaited insert
+     * is dropped outright on the Worker, where this runs inside a Workflow step.
+     */
+    private recordDispatchContext;
     /**
      * Best-effort: reclaim the per-run container for a job. Releases through the same
      * transport the run dispatched to (keyed by job id) — for the Cloudflare backend
@@ -125,7 +223,20 @@ export declare class ContainerRepoBootstrapper implements RepoBootstrapper {
         installationId: number;
         githubId: number;
     }>;
-    /** Construct the success outcome from the installation + the recorded job's repo name. */
+    /**
+     * Construct the success outcome from the installation + the recorded job's repo name.
+     *
+     * `resultDefaultBranch` is what the HARNESS reported, and only the `bootstrap` spec reports one
+     * (it echoes back the branch it force-pushed, which it also created). The plain coding shape a
+     * `pull_request` run takes reports none, so the branch is READ off the target repository rather
+     * than defaulted to `main`: this field states which branch the work lands on, and a repository
+     * whose default is `master`, `trunk` or an org-wide choice would otherwise be recorded as a ref
+     * that does not exist. One read, on the terminal poll only. A failed read keeps the
+     * conventional fallback and says so in a warning, rather than failing a delivered run over the
+     * one field nothing reads back.
+     */
     private buildOutcome;
+    /** The run's stored row, which a poll addresses only by id. */
+    private requireRecord;
 }
 //# sourceMappingURL=ContainerRepoBootstrapper.d.ts.map

package/dist/agents/ContainerRepoBootstrapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ContainerRepoBootstrapper.d.ts","sourceRoot":"","sources":["../../src/agents/ContainerRepoBootstrapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,YAAY,EAEZ,kBAAkB,EAClB,4BAA4B,EAC5B,UAAU,EACV,gBAAgB,EAChB,QAAQ,EACR,gBAAgB,EAEhB,wBAAwB,EACzB,MAAM,qBAAqB,CAAA;AAG5B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAA;AACvF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AACzE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAC/D,OAAO,EAAmB,KAAK,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAGnF,MAAM,WAAW,qCAAqC;IACpD;;;OAGG;IACH,gBAAgB,EAAE,sBAAsB,CAAA;IACxC,wEAAwE;IACxE,sBAAsB,EAAE,4BAA4B,CAAA;IACpD,sFAAsF;IACtF,sBAAsB,EAAE,sBAAsB,CAAA;IAC9C,4FAA4F;IAC5F,cAAc,EAAE,wBAAwB,CAAA;IACxC;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,gBAAgB,CAAC,UAAU,EAAE,CAAC,CAAA;IACpD,oFAAoF;IACpF,YAAY,EAAE,YAAY,CAAA;IAC1B;;;;OAIG;IACH,qBAAqB,EAAE,qBAAqB,CAAA;IAC5C,iFAAiF;IACjF,cAAc,EAAE,uBAAuB,CAAA;IACvC,kEAAkE;IAClE,KAAK,EAAE,QAAQ,CAAA;IACf,oFAAoF;IACpF,YAAY,EAAE,MAAM,CAAA;IACpB,sFAAsF;IACtF,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;;;OAKG;IACH,wBAAwB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAAA;CACtF;AA+CD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,yBAA0B,YAAW,gBAAgB;IAIpD,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHjC,uFAAuF;IACvF,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAiB;IAEtC,YAA6B,IAAI,EAAE,qCAAqC,EAEvE;IAED,kFAAkF;IAC5E,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGhE;IAED;;;;;;;OAOG;IACG,qBAAqB,CACzB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CASpC;IAED,0FAA0F;IACpF,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKjF;IAED;;;;OAIG;IACG,cAAc,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAkM/E;IAED;;;;;;;;;;;;;;;;;OAiBG;YACW,sBAAsB;IAuHpC,mFAAmF;IAC7E,aAAa,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAgD3E;IAED;;;;;;OAMG;IACG,aAAa,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ7D;IAED;;;;;OAKG;IACG,uBAAuB,CAC3B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAoBvD;IAED,0FAA0F;YAC5E,YAAY;CAkB3B"}
+{"version":3,"file":"ContainerRepoBootstrapper.d.ts","sourceRoot":"","sources":["../../src/agents/ContainerRepoBootstrapper.ts"],"names":[],"mappings":"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"}