@agentproto/runtime 2.7.0 → 2.8.0

package/dist/index.d.ts

@@ -536,6 +536,16 @@ interface ToolCallRecord {
     exitCode?: number;
     isError?: boolean;
     durationMs?: number;
+    /** The PR this call CREATED, when the call was a successful shell-shaped
+     *  `gh pr create` (detected at write time via `detectShellPrCreate` in
+     *  pr-provenance.ts, from the command string + the call's result text).
+     *  This is the exact-attribution source the PR-provenance reconciler
+     *  prefers over branch→PR guessing: the session whose events.jsonl holds
+     *  this record IS the session that opened the PR, no matter what branch
+     *  its cwd sits on by the time the turn ends. Absent for every other
+     *  call. */
+    createdPrUrl?: string;
+    createdPrNumber?: number;
     ts: string;
 }
 
@@ -6382,12 +6392,22 @@ type GhRunner = (args: readonly string[], cwd: string) => Promise<{
  * footer is never applied.
  *
  * This closes that gap tool-agnostically: it subscribes to the session event
- * bus and, at each executor session's turn-end / exit, resolves the OPEN PR for
- * that session's branch (via the injected {@link OpenPrResolver} port) and
- * stamps the same `@agentproto-bot` footer if it's missing — reusing
- * {@link stampFooterOnPr}. Turn-end/exit are only poll checkpoints, never an
- * assertion the PR is ready: the real predicate is "does an open PR for this
- * branch now exist?", answered by the resolver, not by timing.
+ * bus and, at each executor session's turn-end / exit, checks two lanes in
+ * order and stamps the same `@agentproto-bot` footer if it's missing —
+ * reusing {@link stampFooterOnPr}:
+ *
+ *   A. EXACT — the session's own recorded tool calls: the transcript writer
+ *      marks a successful `gh pr create` with the created PR's url/number
+ *      (`ToolCallRecord.createdPrUrl`), naming the author session directly.
+ *      Immune to branch switches and shared checkouts.
+ *   B. BRANCH — resolve the OPEN PR for the session cwd's current branch
+ *      (via the injected {@link OpenPrResolver} port), the fallback for
+ *      adapters whose tool calls aren't recorded.
+ *
+ * Turn-end/exit are only poll checkpoints, never an assertion the PR is
+ * ready: the real predicate is "did this session create a PR / does an open
+ * PR for this branch now exist?", answered by the records and resolver, not
+ * by timing.
  *
  * Strictly best-effort: every handler is wrapped so a missing session, an
  * unreachable forge, or a failed `gh` can never throw out of a bus callback.
@@ -6439,6 +6459,10 @@ declare function createPrProvenanceReconciler(opts: {
     registry: ReconcilerRegistry;
     sessionEvents: SessionEventBus;
     resolveOpenPr: OpenPrResolver;
+    /** Session's recorded tool calls, the exact-attribution source (lane A).
+     *  Defaults to reading the session's own events.jsonl via
+     *  {@link readToolCallRecords}; injectable for tests. */
+    listToolCalls?: (sessionId: string) => Promise<ToolCallRecord[]>;
     run?: GhRunner;
     host?: string;
 }): PrProvenanceReconciler;
@@ -7837,6 +7861,12 @@ interface ConversationIndexRecord {
     cwd: string;
     adapterSlug: string;
     adapterSessionId: string;
+    /** The session's isolated provider config dir at write time (see
+     *  `ResolveNativeLinkInput.adapterConfigDir`) — recorded so readers
+     *  that go through the store abstraction (`store.read`, not
+     *  `native.path`) can resolve the same isolated dir. Absent on
+     *  pre-#824 rows and native PTY sessions. */
+    adapterConfigDir?: string;
     /** Absent when `adapterSlug` has no known native store (an adapter
      *  outside claude-code/hermes) — the record still links session ↔
      *  cwd ↔ adapterSessionId, it just can't point at a native file. */
@@ -7853,6 +7883,12 @@ interface ResolveNativeLinkInput {
     cwd: string;
     adapterSlug: string;
     adapterSessionId: string;
+    /** The session's isolated provider config dir (`SessionDescriptor.
+     *  adapterConfigDir`): since #824 a daemon-spawned claude-code session
+     *  writes its transcripts under `<adapterConfigDir>/projects/<slug>`,
+     *  not `~/.claude/projects/<slug>`. Absent for a native PTY or a
+     *  pre-#824 row — the global dir applies. */
+    adapterConfigDir?: string;
 }
 /**
  * Resolve where THIS provider keeps this conversation, computed once (at
@@ -8389,6 +8425,21 @@ interface CreateGatewayOptions {
     name?: string;
     /** Server version advertised over MCP. */
     version?: string;
+    /** Build identity of the binary actually serving — surfaced verbatim via
+     *  `/health` and `daemon_health` so an operator can tell a workspace dist
+     *  from the published tarball of the same version. `sha`/`builtAt` are
+     *  stamped into the CLI at build time (tsup `define`); `source` is the
+     *  serve command's runtime judgement of where its own entry lives. */
+    build?: {
+        /** Short git sha of the checkout the dist was built from ("" when the
+         *  build ran outside git). */
+        sha?: string;
+        /** ISO timestamp of the build. */
+        builtAt?: string;
+        /** "workspace" (a checkout's dist), "published" (npm/npx install), or
+         *  "unknown". */
+        source?: string;
+    };
     /**
      * Run BOOT.md once at startup. Pass `false` to disable. Defaults to
      * `true`. The boot file is plain markdown — frontmatter-free; the