@automatalabs/pi-acp 0.3.2 → 0.4.0

package/README.md

@@ -88,6 +88,21 @@ cleared synchronously before aborting so queued content never restarts generatio
 cancellation. Unexpected internal failures also resolve as `{ outcome: "failed" }` rather than a
 JSON-RPC error.
 
+### Loaded-session turn-terminal state (`_session/loaded_turn`)
+
+Pi also advertises the `_session/loaded_turn` extension at top-level initialize metadata as
+`_meta: { loadedTurn: { supported: true } }` — the re-attach arm's AUTHORITATIVE completion
+evidence for a session re-opened with `session/load` (the REPL broker's restore path).
+`_session/loaded_turn/query { sessionId }` answers whether the loaded session's founding turn is
+still running right now: `running` while a turn executes in this process (the client then waits
+for the `_session/loaded_turn/ended` push — sent with the turn's stop reason, or its error, when
+the turn finishes, arming and clearing a one-shot watch), `completed` when the session journal's
+last message entry is an assistant message (pi persists every complete LLM message atomically at
+`message_end`, so a completed turn always leaves an assistant leaf and the replay's trailing
+assistant message is the turn's FINAL message — authoritative, never a quiet-gap guess), and
+`interrupted` otherwise (the journal shows an interrupted/abandoned turn — nothing is running, so
+re-issue is safe). A query for an unknown session is the standard `unknown_session` error.
+
 ## Development
 
 The `pnpm test` script intentionally runs `tsc -p tsconfig.type-tests.json` before the runtime test suite. This is a small deviation from the test-script example in the frozen specification and ensures the T2b public type-contract check is enforced in local and CI test runs.

package/dist/agent.d.ts

@@ -1,6 +1,7 @@
 import type { AgentNotificationContext, AgentRequestContext, AuthenticateRequest, CloseSessionRequest, ForkSessionRequest, InitializeRequest, ListSessionsRequest, LoadSessionRequest, NewSessionRequest, PromptRequest, ResumeSessionRequest, SetSessionConfigOptionRequest } from "@agentclientprotocol/sdk";
 import type { PiAcpDeps } from "./deps.js";
 import type { SteeringRequest, SteeringResponse } from "./steering.js";
+import type { LoadedTurnQueryRequest, LoadedTurnStatus } from "./loaded-turn.js";
 export { PKG_VERSION } from "./version.js";
 export declare class PiAcpAgent {
     private readonly deps;
@@ -43,6 +44,9 @@ export declare class PiAcpAgent {
             steering: {
                 supported: boolean;
             };
+            loadedTurn: {
+                supported: boolean;
+            };
         };
     };
     authenticate(context: AgentRequestContext<AuthenticateRequest>): Record<string, never>;
@@ -88,6 +92,11 @@ export declare class PiAcpAgent {
     }>;
     prompt(context: AgentRequestContext<PromptRequest>): Promise<import("@agentclientprotocol/sdk").PromptResponse>;
     steer(context: AgentRequestContext<SteeringRequest>): Promise<SteeringResponse>;
+    /** `_session/loaded_turn/query` (see `src/loaded-turn.ts`): the loaded
+     *  session's authoritative founding-turn terminal classification. */
+    loadedTurnQuery(context: AgentRequestContext<LoadedTurnQueryRequest>): {
+        status: LoadedTurnStatus;
+    };
     cancel(context: AgentNotificationContext<{
         sessionId: string;
     }>): void;

package/dist/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAElB,iBAAiB,EACjB,aAAa,EACb,oBAAoB,EACpB,6BAA6B,EAC9B,MAAM,0BAA0B,CAAC;AAWlC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAS3C,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGvE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AA0H3C,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAY;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgC;IACrD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;IACtD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA8B;IACjE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA+B;IAC5D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAmC;IAClE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAM;IACpC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,cAAc,CAA4B;IAClD,OAAO,CAAC,gBAAgB,CAAS;gBAErB,IAAI,EAAE,SAAS;IAI3B,UAAU,CAAC,QAAQ,EAAE,mBAAmB,CAAC,iBAAiB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAmB3D,YAAY,CAAC,OAAO,EAAE,mBAAmB,CAAC,mBAAmB,CAAC;IAI9D,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,OAAO;IAKf,OAAO,CAAC,YAAY;IAmBpB,OAAO,CAAC,KAAK;IAMb,OAAO,CAAC,IAAI;YAOE,UAAU;YAkCV,SAAS;IAqLvB,OAAO,CAAC,YAAY;IAKpB,UAAU,CAAC,OAAO,EAAE,mBAAmB,CAAC,iBAAiB,CAAC;;;;;IA6B1D,OAAO,CAAC,QAAQ;IAgDhB,WAAW,CAAC,OAAO,EAAE,mBAAmB,CAAC,kBAAkB,CAAC;;;;IAI5D,aAAa,CAAC,OAAO,EAAE,mBAAmB,CAAC,oBAAoB,CAAC;;;;IAIhE,WAAW,CAAC,OAAO,EAAE,mBAAmB,CAAC,kBAAkB,CAAC;;;;;IA8EtD,YAAY,CAAC,OAAO,EAAE,mBAAmB,CAAC,mBAAmB,CAAC;;;;;;;;IAqC9D,YAAY,CAAC,OAAO,EAAE,mBAAmB,CAAC,mBAAmB,CAAC;IA0BpE,OAAO,CAAC,WAAW;IAOnB,eAAe,CAAC,OAAO,EAAE,mBAAmB,CAAC,6BAA6B,CAAC;;;IAU3E,MAAM,CAAC,OAAO,EAAE,mBAAmB,CAAC,aAAa,CAAC;IAIlD,KAAK,CAAC,OAAO,EAAE,mBAAmB,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAW/E,MAAM,CAAC,OAAO,EAAE,wBAAwB,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI;YAIxD,eAAe;IAwB7B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAWV,iBAAiB;CA4BhC"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAElB,iBAAiB,EACjB,aAAa,EACb,oBAAoB,EACpB,6BAA6B,EAC9B,MAAM,0BAA0B,CAAC;AAWlC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAS3C,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,KAAK,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGjF,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AA0H3C,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAY;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgC;IACrD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;IACtD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA8B;IACjE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA+B;IAC5D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAmC;IAClE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAM;IACpC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,cAAc,CAA4B;IAClD,OAAO,CAAC,gBAAgB,CAAS;gBAErB,IAAI,EAAE,SAAS;IAI3B,UAAU,CAAC,QAAQ,EAAE,mBAAmB,CAAC,iBAAiB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAmB3D,YAAY,CAAC,OAAO,EAAE,mBAAmB,CAAC,mBAAmB,CAAC;IAI9D,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,OAAO;IAKf,OAAO,CAAC,YAAY;IAmBpB,OAAO,CAAC,KAAK;IAMb,OAAO,CAAC,IAAI;YAOE,UAAU;YAkCV,SAAS;IAqLvB,OAAO,CAAC,YAAY;IAKpB,UAAU,CAAC,OAAO,EAAE,mBAAmB,CAAC,iBAAiB,CAAC;;;;;IA6B1D,OAAO,CAAC,QAAQ;IAgDhB,WAAW,CAAC,OAAO,EAAE,mBAAmB,CAAC,kBAAkB,CAAC;;;;IAI5D,aAAa,CAAC,OAAO,EAAE,mBAAmB,CAAC,oBAAoB,CAAC;;;;IAIhE,WAAW,CAAC,OAAO,EAAE,mBAAmB,CAAC,kBAAkB,CAAC;;;;;IA8EtD,YAAY,CAAC,OAAO,EAAE,mBAAmB,CAAC,mBAAmB,CAAC;;;;;;;;IAqC9D,YAAY,CAAC,OAAO,EAAE,mBAAmB,CAAC,mBAAmB,CAAC;IA0BpE,OAAO,CAAC,WAAW;IAOnB,eAAe,CAAC,OAAO,EAAE,mBAAmB,CAAC,6BAA6B,CAAC;;;IAU3E,MAAM,CAAC,OAAO,EAAE,mBAAmB,CAAC,aAAa,CAAC;IAIlD,KAAK,CAAC,OAAO,EAAE,mBAAmB,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAW/E;yEACqE;IACrE,eAAe,CAAC,OAAO,EAAE,mBAAmB,CAAC,sBAAsB,CAAC,GAAG;QACrE,MAAM,EAAE,gBAAgB,CAAC;KAC1B;IAID,MAAM,CAAC,OAAO,EAAE,wBAAwB,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI;YAIxD,eAAe;IAwB7B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAWV,iBAAiB;CA4BhC"}

package/dist/agent.js

@@ -148,7 +148,7 @@ export class PiAcpAgent {
                 sessionCapabilities: { resume: {}, fork: {}, list: {}, close: {} },
             },
             authMethods: AUTH_METHODS,
-            _meta: { steering: { supported: true } },
+            _meta: { steering: { supported: true }, loadedTurn: { supported: true } },
         };
     }
     authenticate(context) {
@@ -652,6 +652,11 @@ export class PiAcpAgent {
             return { outcome: "failed" };
         });
     }
+    /** `_session/loaded_turn/query` (see `src/loaded-turn.ts`): the loaded
+     *  session's authoritative founding-turn terminal classification. */
+    loadedTurnQuery(context) {
+        return { status: this.requireLive(context.params.sessionId).loadedTurnStatus() };
+    }
     cancel(context) {
         this.live.get(context.params.sessionId)?.cancel();
     }

package/dist/loaded-turn.d.ts

@@ -0,0 +1,54 @@
+/**
+ * The `_session/loaded_turn` vendor extension — turn-TERMINAL state for
+ * loaded sessions (the steering-extension precedent; the REPL broker's
+ * re-attach arm's authoritative completion evidence). Advertised at
+ * initialize via `_meta.loadedTurn.supported === true`; a client seam
+ * against a server without the advertisement degrades guest-visibly
+ * (never settles partial output, never re-issues a possibly-running
+ * turn).
+ *
+ * - `_session/loaded_turn/query` — the client asks, right after a
+ *   `session/load` response, whether the loaded session's founding turn
+ *   is still running RIGHT NOW. pi-acp answers honestly from its own
+ *   state: `running` when a turn is executing in this process, otherwise
+ *   `completed` when the session journal's last message entry is an
+ *   assistant message (the founding turn's final message — pi persists
+ *   each complete LLM message atomically at `message_end`, so a
+ *   completed turn always leaves an assistant leaf and the replay's
+ *   trailing assistant message is authoritative), else `interrupted`
+ *   (the journal shows an interrupted/abandoned turn — nothing is
+ *   running, so re-issue is safe).
+ * - `_session/loaded_turn/ended` — pushed when a turn that the query
+ *   classified `running` ends: its ACP stop reason for a response
+ *   outcome, or its error. (pi-acp can only report `running` while a
+ *   turn is live in-process, and `session/load` rejects sessions that
+ *   are already open in-process, so in practice the notification fires
+ *   for a turn the client loaded while it was still executing — the
+ *   contract is complete for that case.)
+ */
+export declare const LOADED_TURN_QUERY_METHOD: "_session/loaded_turn/query";
+export declare const LOADED_TURN_ENDED_METHOD: "_session/loaded_turn/ended";
+export type LoadedTurnStatus = "completed" | "running" | "interrupted";
+export interface LoadedTurnQueryRequest {
+    sessionId: string;
+}
+export interface LoadedTurnQueryResponse {
+    status: LoadedTurnStatus;
+}
+export interface LoadedTurnEndedNotification {
+    sessionId: string;
+    /** The ACP stop-reason vocabulary for a turn that ended with a
+     *  response; absent when the turn ended by failing. */
+    stopReason?: string;
+    /** The turn's error, when it ended by failing (the client then
+     *  rejects the founding call instead of settling). */
+    error?: {
+        name: string;
+        message: string;
+    };
+}
+/** Runtime parser used by the ACP SDK's custom-request overload. */
+export declare const loadedTurnQueryParser: {
+    parse(value: unknown): LoadedTurnQueryRequest;
+};
+//# sourceMappingURL=loaded-turn.d.ts.map

package/dist/loaded-turn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loaded-turn.d.ts","sourceRoot":"","sources":["../src/loaded-turn.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,wBAAwB,EAAG,4BAAqC,CAAC;AAC9E,eAAO,MAAM,wBAAwB,EAAG,4BAAqC,CAAC;AAE9E,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,SAAS,GAAG,aAAa,CAAC;AAEvE,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAED,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB;2DACuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;0DACsD;IACtD,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C;AAMD,oEAAoE;AACpE,eAAO,MAAM,qBAAqB;iBACnB,OAAO,GAAG,sBAAsB;CAM9C,CAAC"}

package/dist/loaded-turn.js

@@ -0,0 +1,43 @@
+import { RequestError } from "@agentclientprotocol/sdk";
+/**
+ * The `_session/loaded_turn` vendor extension — turn-TERMINAL state for
+ * loaded sessions (the steering-extension precedent; the REPL broker's
+ * re-attach arm's authoritative completion evidence). Advertised at
+ * initialize via `_meta.loadedTurn.supported === true`; a client seam
+ * against a server without the advertisement degrades guest-visibly
+ * (never settles partial output, never re-issues a possibly-running
+ * turn).
+ *
+ * - `_session/loaded_turn/query` — the client asks, right after a
+ *   `session/load` response, whether the loaded session's founding turn
+ *   is still running RIGHT NOW. pi-acp answers honestly from its own
+ *   state: `running` when a turn is executing in this process, otherwise
+ *   `completed` when the session journal's last message entry is an
+ *   assistant message (the founding turn's final message — pi persists
+ *   each complete LLM message atomically at `message_end`, so a
+ *   completed turn always leaves an assistant leaf and the replay's
+ *   trailing assistant message is authoritative), else `interrupted`
+ *   (the journal shows an interrupted/abandoned turn — nothing is
+ *   running, so re-issue is safe).
+ * - `_session/loaded_turn/ended` — pushed when a turn that the query
+ *   classified `running` ends: its ACP stop reason for a response
+ *   outcome, or its error. (pi-acp can only report `running` while a
+ *   turn is live in-process, and `session/load` rejects sessions that
+ *   are already open in-process, so in practice the notification fires
+ *   for a turn the client loaded while it was still executing — the
+ *   contract is complete for that case.)
+ */
+export const LOADED_TURN_QUERY_METHOD = "_session/loaded_turn/query";
+export const LOADED_TURN_ENDED_METHOD = "_session/loaded_turn/ended";
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** Runtime parser used by the ACP SDK's custom-request overload. */
+export const loadedTurnQueryParser = {
+    parse(value) {
+        if (!isRecord(value) || typeof value.sessionId !== "string") {
+            throw RequestError.invalidParams(undefined, "invalid _session/loaded_turn/query request");
+        }
+        return value;
+    },
+};

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,MAAM,EACZ,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AAGxD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,MAAM,CAAC,OAAO,GAAE,aAAkB;;;GAqBvD"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,MAAM,EACZ,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AAIxD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,MAAM,CAAC,OAAO,GAAE,aAAkB;;;GAsBvD"}

package/dist/server.js

@@ -3,6 +3,7 @@ import { agent as acpAgent, methods, ndJsonStream, } from "@agentclientprotocol/
 import { PiAcpAgent } from "./agent.js";
 import { resolveDeps } from "./deps.js";
 import { SESSION_STEERING_METHOD, steeringRequestParser } from "./steering.js";
+import { LOADED_TURN_QUERY_METHOD, loadedTurnQueryParser } from "./loaded-turn.js";
 export { PiAcpAgent } from "./agent.js";
 export async function runAcp(options = {}) {
     const impl = new PiAcpAgent(await resolveDeps(options.deps));
@@ -18,6 +19,7 @@ export async function runAcp(options = {}) {
         .onRequest(methods.agent.session.setConfigOption, (context) => impl.setConfigOption(context))
         .onRequest(methods.agent.session.prompt, (context) => impl.prompt(context))
         .onRequest(SESSION_STEERING_METHOD, steeringRequestParser, (context) => impl.steer(context))
+        .onRequest(LOADED_TURN_QUERY_METHOD, loadedTurnQueryParser, (context) => impl.loadedTurnQuery(context))
         .onNotification(methods.agent.session.cancel, (context) => impl.cancel(context));
     const stream = options.stream ?? ndJsonStream(Writable.toWeb(process.stdout), Readable.toWeb(process.stdin));
     const connection = app.connect(stream);

package/dist/session.d.ts

@@ -5,6 +5,7 @@ import type { PiAcpDeps } from "./deps.js";
 import type { McpBridge, McpResultProjection } from "./mcp-bridge.js";
 import { type ChildProcessRegistrySlot } from "./child-process-registry.js";
 import type { SteeringRequest, SteeringResponse } from "./steering.js";
+import { type LoadedTurnStatus } from "./loaded-turn.js";
 export interface PiSessionOptions {
     sessionId: string;
     session: AgentSession;
@@ -45,8 +46,32 @@ export declare class PiSession {
     private cleanupGeneration;
     private resourceDisposePromise;
     private bridgeClosePromise;
+    /** The `_session/loaded_turn` extension's watch flag: set when a
+     *  `loadedTurnStatus()` query answered `running` (a client is waiting
+     *  for that turn's authoritative end), cleared — and the
+     *  `_session/loaded_turn/ended` notification sent — when the turn
+     *  finishes for any reason (response outcome with its stop reason, or
+     *  a failure with its error). */
+    private loadedTurnReportedRunning;
     constructor(options: PiSessionOptions);
     get busy(): boolean;
+    /**
+     * The `_session/loaded_turn/query` answer — the authoritative
+     * founding-turn terminal classification for a loaded session (see
+     * `packages/pi-acp/src/loaded-turn.ts`):
+     *
+     * - `running` when a turn is executing in this process right now (the
+     *   client then waits for the `_session/loaded_turn/ended` push — the
+     *   watch flag is armed here so the turn's finish sends it),
+     * - `completed` when the session journal's last message entry is an
+     *   assistant message (pi persists every complete LLM message
+     *   atomically at `message_end`, so a completed turn always leaves an
+     *   assistant leaf and the replay's trailing assistant message is the
+     *   turn's FINAL message — authoritative, never a quiet-gap guess),
+     * - `interrupted` otherwise (the journal shows an interrupted or
+     *   abandoned turn — no turn is running, so re-issue is safe).
+     */
+    loadedTurnStatus(): LoadedTurnStatus;
     configOptions(): import("@agentclientprotocol/sdk").SessionConfigOption[];
     publishAvailableModels(models: readonly Model<Api>[]): void;
     activeTurnSignal(): AbortSignal | undefined;

package/dist/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAClG,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAc3C,OAAO,KAAK,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAuB,KAAK,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACjG,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,kBAAkB,CAAC;AA2B1B,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,YAAY,CAAC;IACrB,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,SAAS,CAAC;IACrB,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACnD,eAAe,EAAE,SAAS,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;IACvC,aAAa,EAAE,wBAAwB,CAAC;IACxC,mBAAmB,EAAE,eAAe,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/F;AAED,qBAAa,SAAS;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,EAAE,YAAY,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAY;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmC;IACpE,OAAO,CAAC,eAAe,CAAwB;IAC/C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA2B;IACzD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAkB;IACtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+B;IACxD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAC/C,OAAO,CAAC,IAAI,CAA4B;IACxC,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,CAAC,UAAU,CAAyB;IAC3C,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAgC;IACnE,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,iBAAiB,CAAgC;IACzD,OAAO,CAAC,sBAAsB,CAA4B;IAC1D,OAAO,CAAC,kBAAkB,CAA4B;IACtD;;;;;qCAKiC;IACjC,OAAO,CAAC,yBAAyB,CAAS;gBAE9B,OAAO,EAAE,gBAAgB;IAuCrC,IAAI,IAAI,IAAI,OAAO,CAElB;IAED;;;;;;;;;;;;;;;OAeG;IACH,gBAAgB,IAAI,gBAAgB;IAiBpC,aAAa;IAIb,sBAAsB,CAAC,MAAM,EAAE,SAAS,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI;IAI3D,gBAAgB,IAAI,WAAW,GAAG,SAAS;IAE3C,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IASrC,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAMpC,OAAO,CAAC,SAAS;IAwBX,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtB,MAAM,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAWvD,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IAkBzD,OAAO,CAAC,MAAM;IAuCd,OAAO,CAAC,mBAAmB;IAW3B,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,WAAW;IA8GnB,OAAO,CAAC,SAAS;IAiBjB,OAAO,CAAC,WAAW;YAOL,aAAa;YAQb,gBAAgB;YAoBhB,gBAAgB;IA0BxB,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;IAKxF;;;;6EAIyE;IACzE,OAAO,CAAC,SAAS;IAmFjB;;;0EAGsE;IAChE,KAAK,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;YAUjD,YAAY;IAmC1B;;;+DAG2D;IAC3D,OAAO,CAAC,YAAY;IAoBpB;;;;2FAIuF;YACzE,kBAAkB;IAkChC;;;;4FAIwF;IACxF,OAAO,CAAC,0BAA0B;IA0BlC,MAAM,IAAI,IAAI;IAId,mBAAmB,IAAI,IAAI;IASrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBxB,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC;IAKjD,IAAI,iBAAiB,IAAI,MAAM,CAAiD;IAEhF,IAAI,oBAAoB,IAAI,OAAO,CAElC;IAEK,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAgCvC,MAAM,IAAI,IAAI;CAOf"}

package/dist/session.js

@@ -9,6 +9,7 @@ import { translateEvent } from "./translate.js";
 import { agentMessages, promptUsage, terminalAssistant, usageUpdate, } from "./usage.js";
 import { installPermissionWrapper } from "./permissions.js";
 import { ChildCleanupFailure } from "./child-process-registry.js";
+import { LOADED_TURN_ENDED_METHOD, } from "./loaded-turn.js";
 export class PiSession {
     sessionId;
     pi;
@@ -36,6 +37,13 @@ export class PiSession {
     cleanupGeneration;
     resourceDisposePromise;
     bridgeClosePromise;
+    /** The `_session/loaded_turn` extension's watch flag: set when a
+     *  `loadedTurnStatus()` query answered `running` (a client is waiting
+     *  for that turn's authoritative end), cleared — and the
+     *  `_session/loaded_turn/ended` notification sent — when the turn
+     *  finishes for any reason (response outcome with its stop reason, or
+     *  a failure with its error). */
+    loadedTurnReportedRunning = false;
     constructor(options) {
         this.sessionId = options.sessionId;
         this.pi = options.session;
@@ -80,6 +88,36 @@ export class PiSession {
     get busy() {
         return this.activeTurn !== undefined || this.configReserved || this.closing;
     }
+    /**
+     * The `_session/loaded_turn/query` answer — the authoritative
+     * founding-turn terminal classification for a loaded session (see
+     * `packages/pi-acp/src/loaded-turn.ts`):
+     *
+     * - `running` when a turn is executing in this process right now (the
+     *   client then waits for the `_session/loaded_turn/ended` push — the
+     *   watch flag is armed here so the turn's finish sends it),
+     * - `completed` when the session journal's last message entry is an
+     *   assistant message (pi persists every complete LLM message
+     *   atomically at `message_end`, so a completed turn always leaves an
+     *   assistant leaf and the replay's trailing assistant message is the
+     *   turn's FINAL message — authoritative, never a quiet-gap guess),
+     * - `interrupted` otherwise (the journal shows an interrupted or
+     *   abandoned turn — no turn is running, so re-issue is safe).
+     */
+    loadedTurnStatus() {
+        const turn = this.activeTurn;
+        if (turn !== undefined && !turn.completed && !this.closing) {
+            this.loadedTurnReportedRunning = true;
+            return "running";
+        }
+        const leaf = this.manager.getLeafEntry();
+        if (leaf !== undefined &&
+            leaf.type === "message" &&
+            leaf.message.role === "assistant") {
+            return "completed";
+        }
+        return "interrupted";
+    }
     configOptions() {
         return [thinkingLevelOption(this.pi), modelOption(this.pi, this.availableModels)];
     }
@@ -184,6 +222,26 @@ export class PiSession {
         turn.releaseBoundary = undefined;
         if (this.activeTurn === turn)
             this.activeTurn = undefined;
+        // The `_session/loaded_turn` extension's authoritative end push: a
+        // client that was told this turn was `running` at query time gets the
+        // ended notification now — with the turn's stop reason (response
+        // outcome) or its error (failure), never both. Best-effort: a
+        // failing notification must not break the turn's settlement. The
+        // push is ORDERED behind the turn's final update pump (review round
+        // 6): the last deltas were only enqueued (the pump delivers them
+        // asynchronously), and the re-attach seam settles with the
+        // accumulated text at the terminal marker — a marker delivered
+        // before the final chunk would durably settle PARTIAL text.
+        if (this.loadedTurnReportedRunning) {
+            this.loadedTurnReportedRunning = false;
+            const notification = "response" in outcome
+                ? { sessionId: this.sessionId, stopReason: outcome.response.stopReason }
+                : { sessionId: this.sessionId, error: normalizeTurnError(outcome.error) };
+            void this.drain()
+                .catch(() => undefined)
+                .then(() => this.client.notify(LOADED_TURN_ENDED_METHOD, notification))
+                .catch(() => undefined);
+        }
         const generation = this.cleanupGeneration;
         if (generation?.resumeRefreshesOnSettlement && generation.mode === "cancel-only") {
             this.cleanupGeneration = undefined;
@@ -743,3 +801,18 @@ export class PiSession {
         });
     }
 }
+/** Normalize a turn's failure into the loaded-turn ended notification's
+ *  `{ name, message }` error shape (best-effort — the notification
+ *  carries the turn's error verbatim-ish, never the whole stack). */
+function normalizeTurnError(error) {
+    if (error !== null && typeof error === "object") {
+        const candidate = error;
+        return {
+            name: typeof candidate.name === "string" ? candidate.name : "Error",
+            message: typeof candidate.message === "string"
+                ? candidate.message
+                : String(candidate.message ?? error),
+        };
+    }
+    return { name: "Error", message: String(error) };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automatalabs/pi-acp",
-  "version": "0.3.2",
+  "version": "0.4.0",
   "license": "Apache-2.0",
   "engines": {
     "node": ">=22.19.0"
@@ -31,13 +31,13 @@
   },
   "dependencies": {
     "@agentclientprotocol/sdk": "1.3.0",
-    "@earendil-works/pi-ai": "0.84.0",
-    "@earendil-works/pi-coding-agent": "0.84.0",
+    "@earendil-works/pi-ai": "0.84.1",
+    "@earendil-works/pi-coding-agent": "0.84.1",
     "@modelcontextprotocol/sdk": "1.29.0",
     "typebox": "1.3.2"
   },
   "devDependencies": {
-    "@earendil-works/pi-agent-core": "0.84.0"
+    "@earendil-works/pi-agent-core": "0.84.1"
   },
   "scripts": {
     "build": "tsc -b",