@zhin.js/agent 1.0.2 → 1.0.4

package/lib/session/http-step-projector.js

@@ -0,0 +1,118 @@
+/**
+ * Projects turn-scoped steps from AgentStream events (ADR 0040 P3 / ADR 0041).
+ */
+import { AgentStreamEventType } from '@zhin.js/ai/agent-stream';
+import { AgentStepStatus, createStepId, } from '@zhin.js/ai/agent-step-checkpoint';
+function interruptKindFromEvent(event) {
+    if (event.type === AgentStreamEventType.INPUT_REQUESTED)
+        return 'approval';
+    if (event.type === AgentStreamEventType.AUTHORIZATION_REQUIRED)
+        return 'authorization';
+    return 'unknown';
+}
+export class HttpStepProjector {
+    steps = [];
+    current = null;
+    getSteps() {
+        return [...this.steps];
+    }
+    restoreSteps(steps) {
+        this.steps = [...steps];
+        this.current = null;
+        for (let i = this.steps.length - 1; i >= 0; i--) {
+            if (this.steps[i].status === AgentStepStatus.RUNNING) {
+                this.current = { ...this.steps[i] };
+                break;
+            }
+        }
+    }
+    /** Returns extra step wire events to append after the triggering event. */
+    onStreamEvent(event) {
+        const extras = [];
+        const ts = event.timestamp ?? Date.now();
+        if (event.type === AgentStreamEventType.TURN_STARTED) {
+            const turnId = typeof event.data?.turnId === 'string' ? event.data.turnId : undefined;
+            const step = {
+                stepId: createStepId(),
+                turnId,
+                status: AgentStepStatus.RUNNING,
+                startedAt: ts,
+            };
+            this.current = step;
+            this.steps.push(step);
+            extras.push({
+                type: AgentStreamEventType.STEP_STARTED,
+                timestamp: ts,
+                data: { stepId: step.stepId, turnId, status: step.status },
+            });
+            return extras;
+        }
+        if (!this.current)
+            return extras;
+        if (event.type === AgentStreamEventType.INPUT_REQUESTED
+            || event.type === AgentStreamEventType.AUTHORIZATION_REQUIRED) {
+            const requestId = typeof event.data?.requestId === 'string' ? event.data.requestId : undefined;
+            this.current.status = AgentStepStatus.INTERRUPTED;
+            this.current.interruptKind = interruptKindFromEvent(event);
+            this.current.requestId = requestId;
+            extras.push({
+                type: AgentStreamEventType.STEP_INTERRUPTED,
+                timestamp: ts,
+                data: {
+                    stepId: this.current.stepId,
+                    turnId: this.current.turnId,
+                    status: this.current.status,
+                    interruptKind: this.current.interruptKind,
+                    requestId,
+                },
+            });
+            return extras;
+        }
+        if (event.type === AgentStreamEventType.TURN_COMPLETED) {
+            this.current.status = AgentStepStatus.COMPLETED;
+            this.current.completedAt = ts;
+            extras.push({
+                type: AgentStreamEventType.STEP_COMPLETED,
+                timestamp: ts,
+                data: {
+                    stepId: this.current.stepId,
+                    turnId: this.current.turnId,
+                    status: this.current.status,
+                },
+            });
+            this.current = null;
+            return extras;
+        }
+        if (event.type === AgentStreamEventType.TURN_FAILED) {
+            this.current.status = AgentStepStatus.INTERRUPTED;
+            this.current.completedAt = ts;
+            extras.push({
+                type: AgentStreamEventType.STEP_INTERRUPTED,
+                timestamp: ts,
+                data: {
+                    stepId: this.current.stepId,
+                    turnId: this.current.turnId,
+                    status: this.current.status,
+                    interruptKind: 'unknown',
+                },
+            });
+            this.current = null;
+            return extras;
+        }
+        return extras;
+    }
+    pendingRequestIds() {
+        const ids = new Set();
+        for (const step of this.steps) {
+            if (step.status === AgentStepStatus.INTERRUPTED && step.requestId) {
+                ids.add(step.requestId);
+            }
+        }
+        return [...ids];
+    }
+    isParked() {
+        return this.pendingRequestIds().length > 0
+            || (this.current?.status === AgentStepStatus.INTERRUPTED);
+    }
+}
+//# sourceMappingURL=http-step-projector.js.map

package/lib/session/http-step-projector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-step-projector.js","sourceRoot":"","sources":["../../src/session/http-step-projector.ts"],"names":[],"mappings":"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"}

package/lib/session/http-turn-runner.d.ts

@@ -0,0 +1,16 @@
+import type { AgentStreamBus } from '../event/agent-stream-bus.js';
+import type { ZhinAgent } from '../zhin-agent/index.js';
+import type { ParkController, HttpSessionParkState } from './park-controller.js';
+export interface HttpTurnRunnerDeps {
+    getAgent: () => ZhinAgent | null;
+    bus: AgentStreamBus;
+    park: ParkController;
+    sessions: Map<string, HttpSessionParkState>;
+    onPersist?: (sessionId: string) => void;
+}
+export declare class HttpTurnRunner {
+    private readonly deps;
+    constructor(deps: HttpTurnRunnerDeps);
+    run(sessionId: string, message: string): Promise<void>;
+}
+//# sourceMappingURL=http-turn-runner.d.ts.map

package/lib/session/http-turn-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-turn-runner.d.ts","sourceRoot":"","sources":["../../src/session/http-turn-runner.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,SAAS,GAAG,IAAI,CAAC;IACjC,GAAG,EAAE,cAAc,CAAC;IACpB,IAAI,EAAE,cAAc,CAAC;IACrB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IAC5C,SAAS,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAED,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,kBAAkB;IAE/C,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CA8C7D"}

package/lib/session/http-turn-runner.js

@@ -0,0 +1,57 @@
+/**
+ * HTTP turn runner — processStream without duplicate TurnEvent mapping (ADR 0041).
+ */
+import { createSyntheticMessage } from '@zhin.js/core';
+import { AgentStreamEventType } from '@zhin.js/ai/agent-stream';
+export class HttpTurnRunner {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async run(sessionId, message) {
+        const state = this.deps.sessions.get(sessionId);
+        if (!state)
+            return;
+        const agent = this.deps.getAgent();
+        if (!agent) {
+            state.status = 'failed';
+            await this.deps.bus.publish({
+                type: AgentStreamEventType.SESSION_FAILED,
+                data: { code: 'AGENT_UNAVAILABLE', message: 'ZhinAgent runtime 未就绪' },
+            }, { sessionId, httpSessionId: sessionId });
+            return;
+        }
+        state.turnRunning = true;
+        const commMessage = createSyntheticMessage({
+            adapter: 'host',
+            endpoint: 'zhin-v1',
+            sender: { id: 'http-client', isMaster: true },
+            channel: { type: 'private', id: sessionId },
+            extra: { httpSessionId: sessionId },
+        });
+        try {
+            for await (const _turnEvent of agent.processStream(message, commMessage)) {
+                /* wire events arrive via HttpSessionSink */
+            }
+            state.status = 'waiting';
+            this.deps.park.emitSessionWaiting(state, state.parked ? 'parked' : 'idle');
+        }
+        catch (err) {
+            state.status = 'failed';
+            const msg = err instanceof Error ? err.message : String(err);
+            await this.deps.bus.publish({
+                type: AgentStreamEventType.TURN_FAILED,
+                data: { code: 'TURN_ERROR', message: msg },
+            }, { sessionId, httpSessionId: sessionId });
+            await this.deps.bus.publish({
+                type: AgentStreamEventType.SESSION_FAILED,
+                data: { code: 'TURN_ERROR', message: msg },
+            }, { sessionId, httpSessionId: sessionId });
+        }
+        finally {
+            state.turnRunning = false;
+            this.deps.onPersist?.(sessionId);
+        }
+    }
+}
+//# sourceMappingURL=http-turn-runner.js.map

package/lib/session/http-turn-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-turn-runner.js","sourceRoot":"","sources":["../../src/session/http-turn-runner.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAahE,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,IAAwB;QAAxB,SAAI,GAAJ,IAAI,CAAoB;IAAG,CAAC;IAEzD,KAAK,CAAC,GAAG,CAAC,SAAiB,EAAE,OAAe;QAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAChD,IAAI,CAAC,KAAK;YAAE,OAAO;QAEnB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACnC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC;YACxB,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;gBAC1B,IAAI,EAAE,oBAAoB,CAAC,cAAc;gBACzC,IAAI,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,uBAAuB,EAAE;aACtE,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC;YAC5C,OAAO;QACT,CAAC;QAED,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC;QAEzB,MAAM,WAAW,GAAG,sBAAsB,CAAC;YACzC,OAAO,EAAE,MAAM;YACf,QAAQ,EAAE,SAAS;YACnB,MAAM,EAAE,EAAE,EAAE,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAE;YAC7C,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE;YAC3C,KAAK,EAAE,EAAE,aAAa,EAAE,SAAS,EAAE;SACpC,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,IAAI,KAAK,EAAE,MAAM,UAAU,IAAI,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,CAAC;gBACzE,4CAA4C;YAC9C,CAAC;YACD,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC7E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC;YACxB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;gBAC1B,IAAI,EAAE,oBAAoB,CAAC,WAAW;gBACtC,IAAI,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,EAAE;aAC3C,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC;YAC5C,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;gBAC1B,IAAI,EAAE,oBAAoB,CAAC,cAAc;gBACzC,IAAI,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,EAAE;aAC3C,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC;QAC9C,CAAC;gBAAS,CAAC;YACT,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC;YAC1B,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,SAAS,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;CACF"}

package/lib/session/im-approval-adapter.d.ts

@@ -0,0 +1,12 @@
+/**
+ * IM ask_user adapter for SessionInteractionPort (ADR 0041).
+ */
+import type { Message, Plugin } from '@zhin.js/core';
+import type { ApprovalRequestInput, SessionInteractionPort } from './session-interaction-port.js';
+export declare class ImApprovalAdapter implements SessionInteractionPort {
+    private readonly plugin;
+    private readonly commMessage;
+    constructor(plugin: Plugin | undefined, commMessage: Message);
+    requestApproval(input: ApprovalRequestInput): Promise<boolean>;
+}
+//# sourceMappingURL=im-approval-adapter.d.ts.map

package/lib/session/im-approval-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"im-approval-adapter.d.ts","sourceRoot":"","sources":["../../src/session/im-approval-adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,KAAK,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAElG,qBAAa,iBAAkB,YAAW,sBAAsB;IAE5D,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,WAAW;gBADX,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,WAAW,EAAE,OAAO;IAGjC,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;CAiBrE"}

package/lib/session/im-approval-adapter.js

@@ -0,0 +1,24 @@
+import { AskUserBuiltinTool } from '../builtin/ask-user-tool.js';
+export class ImApprovalAdapter {
+    plugin;
+    commMessage;
+    constructor(plugin, commMessage) {
+        this.plugin = plugin;
+        this.commMessage = commMessage;
+    }
+    async requestApproval(input) {
+        if (!this.plugin) {
+            throw new Error('approval required but Host plugin is unavailable');
+        }
+        const askTool = new AskUserBuiltinTool(this.plugin);
+        const raw = await askTool.run({
+            question: input.question,
+            type: 'confirm',
+            timeout: input.timeoutMs ?? 120,
+            sensitive: true,
+        }, this.commMessage);
+        const answer = typeof raw === 'string' ? raw.trim().toLowerCase() : String(raw);
+        return answer === 'yes';
+    }
+}
+//# sourceMappingURL=im-approval-adapter.js.map

package/lib/session/im-approval-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"im-approval-adapter.js","sourceRoot":"","sources":["../../src/session/im-approval-adapter.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAGjE,MAAM,OAAO,iBAAiB;IAET;IACA;IAFnB,YACmB,MAA0B,EAC1B,WAAoB;QADpB,WAAM,GAAN,MAAM,CAAoB;QAC1B,gBAAW,GAAX,WAAW,CAAS;IACpC,CAAC;IAEJ,KAAK,CAAC,eAAe,CAAC,KAA2B;QAC/C,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QACtE,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpD,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,CAC3B;YACE,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,KAAK,CAAC,SAAS,IAAI,GAAG;YAC/B,SAAS,EAAE,IAAI;SAChB,EACD,IAAI,CAAC,WAAW,CACjB,CAAC;QACF,MAAM,MAAM,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAChF,OAAO,MAAM,KAAK,KAAK,CAAC;IAC1B,CAAC;CACF"}

package/lib/session/park-controller.d.ts

@@ -0,0 +1,24 @@
+import { type AgentStreamEvent } from '@zhin.js/ai/agent-stream';
+import type { AgentStepCheckpoint } from '@zhin.js/ai/agent-step-checkpoint';
+import type { AgentStreamBus } from '../event/agent-stream-bus.js';
+import type { HttpStepProjector } from './http-step-projector.js';
+export interface HttpSessionParkState {
+    sessionId: string;
+    continuationToken: string;
+    status: 'running' | 'waiting' | 'completed' | 'failed';
+    parked: boolean;
+    pendingRequestIds: string[];
+    turnRunning: boolean;
+    stepProjector: HttpStepProjector;
+}
+export declare class ParkController {
+    private readonly bus;
+    constructor(bus: AgentStreamBus);
+    newContinuationToken(): string;
+    syncPendingFromEvent(state: HttpSessionParkState, event: AgentStreamEvent): void;
+    refreshParked(state: HttpSessionParkState): void;
+    shouldEmitMidTurnPark(state: HttpSessionParkState, event: AgentStreamEvent): boolean;
+    emitSessionWaiting(state: HttpSessionParkState, reason: 'idle' | 'parked'): void;
+    getSteps(state: HttpSessionParkState): AgentStepCheckpoint[];
+}
+//# sourceMappingURL=park-controller.d.ts.map

package/lib/session/park-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"park-controller.d.ts","sourceRoot":"","sources":["../../src/session/park-controller.ts"],"names":[],"mappings":"AAIA,OAAO,EAAwB,KAAK,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACvF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IACvD,MAAM,EAAE,OAAO,CAAC;IAChB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,EAAE,iBAAiB,CAAC;CAClC;AAED,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,cAAc;IAEhD,oBAAoB,IAAI,MAAM;IAI9B,oBAAoB,CAAC,KAAK,EAAE,oBAAoB,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAsBhF,aAAa,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI;IAIhD,qBAAqB,CAAC,KAAK,EAAE,oBAAoB,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO;IASpF,kBAAkB,CAAC,KAAK,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAgBhF,QAAQ,CAAC,KAAK,EAAE,oBAAoB,GAAG,mBAAmB,EAAE;CAG7D"}

package/lib/session/park-controller.js

@@ -0,0 +1,58 @@
+/**
+ * Park / waiting semantics for HTTP sessions (ADR 0040 P3 / ADR 0041).
+ */
+import { randomUUID } from 'node:crypto';
+import { AgentStreamEventType } from '@zhin.js/ai/agent-stream';
+export class ParkController {
+    bus;
+    constructor(bus) {
+        this.bus = bus;
+    }
+    newContinuationToken() {
+        return `zhin:${randomUUID()}`;
+    }
+    syncPendingFromEvent(state, event) {
+        const requestId = typeof event.data?.requestId === 'string' ? event.data.requestId : '';
+        if (!requestId)
+            return;
+        if (event.type === AgentStreamEventType.INPUT_REQUESTED
+            || event.type === AgentStreamEventType.AUTHORIZATION_REQUIRED) {
+            if (!state.pendingRequestIds.includes(requestId)) {
+                state.pendingRequestIds = [...state.pendingRequestIds, requestId];
+            }
+            return;
+        }
+        if (event.type === AgentStreamEventType.INPUT_COMPLETED
+            || event.type === AgentStreamEventType.AUTHORIZATION_COMPLETED) {
+            state.pendingRequestIds = state.pendingRequestIds.filter((id) => id !== requestId);
+        }
+    }
+    refreshParked(state) {
+        state.parked = state.pendingRequestIds.length > 0 || state.stepProjector.isParked();
+    }
+    shouldEmitMidTurnPark(state, event) {
+        return state.turnRunning
+            && state.parked
+            && (event.type === AgentStreamEventType.INPUT_REQUESTED
+                || event.type === AgentStreamEventType.AUTHORIZATION_REQUIRED);
+    }
+    emitSessionWaiting(state, reason) {
+        state.status = 'waiting';
+        state.continuationToken = this.newContinuationToken();
+        void this.bus.publish({
+            type: AgentStreamEventType.SESSION_WAITING,
+            data: {
+                sessionId: state.sessionId,
+                continuationToken: state.continuationToken,
+                parked: reason === 'parked',
+                reason,
+                pendingRequestIds: state.pendingRequestIds,
+                steps: state.stepProjector.getSteps(),
+            },
+        }, { sessionId: state.sessionId, httpSessionId: state.sessionId });
+    }
+    getSteps(state) {
+        return state.stepProjector.getSteps();
+    }
+}
+//# sourceMappingURL=park-controller.js.map

package/lib/session/park-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"park-controller.js","sourceRoot":"","sources":["../../src/session/park-controller.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAyB,MAAM,0BAA0B,CAAC;AAevF,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,GAAmB;QAAnB,QAAG,GAAH,GAAG,CAAgB;IAAG,CAAC;IAEpD,oBAAoB;QAClB,OAAO,QAAQ,UAAU,EAAE,EAAE,CAAC;IAChC,CAAC;IAED,oBAAoB,CAAC,KAA2B,EAAE,KAAuB;QACvE,MAAM,SAAS,GAAG,OAAO,KAAK,CAAC,IAAI,EAAE,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QACxF,IAAI,CAAC,SAAS;YAAE,OAAO;QAEvB,IACE,KAAK,CAAC,IAAI,KAAK,oBAAoB,CAAC,eAAe;eAChD,KAAK,CAAC,IAAI,KAAK,oBAAoB,CAAC,sBAAsB,EAC7D,CAAC;YACD,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBACjD,KAAK,CAAC,iBAAiB,GAAG,CAAC,GAAG,KAAK,CAAC,iBAAiB,EAAE,SAAS,CAAC,CAAC;YACpE,CAAC;YACD,OAAO;QACT,CAAC;QAED,IACE,KAAK,CAAC,IAAI,KAAK,oBAAoB,CAAC,eAAe;eAChD,KAAK,CAAC,IAAI,KAAK,oBAAoB,CAAC,uBAAuB,EAC9D,CAAC;YACD,KAAK,CAAC,iBAAiB,GAAG,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;IAED,aAAa,CAAC,KAA2B;QACvC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,aAAa,CAAC,QAAQ,EAAE,CAAC;IACtF,CAAC;IAED,qBAAqB,CAAC,KAA2B,EAAE,KAAuB;QACxE,OAAO,KAAK,CAAC,WAAW;eACnB,KAAK,CAAC,MAAM;eACZ,CACD,KAAK,CAAC,IAAI,KAAK,oBAAoB,CAAC,eAAe;mBAChD,KAAK,CAAC,IAAI,KAAK,oBAAoB,CAAC,sBAAsB,CAC9D,CAAC;IACN,CAAC;IAED,kBAAkB,CAAC,KAA2B,EAAE,MAAyB;QACvE,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC;QACzB,KAAK,CAAC,iBAAiB,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAC;QACtD,KAAK,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;YACpB,IAAI,EAAE,oBAAoB,CAAC,eAAe;YAC1C,IAAI,EAAE;gBACJ,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;gBAC1C,MAAM,EAAE,MAAM,KAAK,QAAQ;gBAC3B,MAAM;gBACN,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;gBAC1C,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,QAAQ,EAAE;aACtC;SACF,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,aAAa,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,QAAQ,CAAC,KAA2B;QAClC,OAAO,KAAK,CAAC,aAAa,CAAC,QAAQ,EAAE,CAAC;IACxC,CAAC;CACF"}

package/lib/session/resolve-session-interaction-port.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Resolve SessionInteractionPort from transport context (ADR 0041).
+ */
+import { type Message, type Plugin } from '@zhin.js/core';
+import type { HttpApprovalAdapter } from './http-approval-adapter.js';
+import type { SessionInteractionPort } from './session-interaction-port.js';
+export declare function readHttpSessionId(commMessage: Message): string | undefined;
+export declare function resolveSessionInteractionPort(commMessage: Message, plugin: Plugin | undefined, httpApprovalAdapter?: HttpApprovalAdapter): SessionInteractionPort;
+//# sourceMappingURL=resolve-session-interaction-port.d.ts.map

package/lib/session/resolve-session-interaction-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-session-interaction-port.d.ts","sourceRoot":"","sources":["../../src/session/resolve-session-interaction-port.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAE5E,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAG1E;AAED,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,OAAO,EACpB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,mBAAmB,CAAC,EAAE,mBAAmB,GACxC,sBAAsB,CAMxB"}

package/lib/session/resolve-session-interaction-port.js

@@ -0,0 +1,13 @@
+import { ImApprovalAdapter } from './im-approval-adapter.js';
+export function readHttpSessionId(commMessage) {
+    const extra = commMessage.extra;
+    return typeof extra?.httpSessionId === 'string' ? extra.httpSessionId : undefined;
+}
+export function resolveSessionInteractionPort(commMessage, plugin, httpApprovalAdapter) {
+    const httpSessionId = readHttpSessionId(commMessage);
+    if (httpSessionId && httpApprovalAdapter) {
+        return httpApprovalAdapter;
+    }
+    return new ImApprovalAdapter(plugin, commMessage);
+}
+//# sourceMappingURL=resolve-session-interaction-port.js.map

package/lib/session/resolve-session-interaction-port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-session-interaction-port.js","sourceRoot":"","sources":["../../src/session/resolve-session-interaction-port.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAG7D,MAAM,UAAU,iBAAiB,CAAC,WAAoB;IACpD,MAAM,KAAK,GAAI,WAAmD,CAAC,KAAK,CAAC;IACzE,OAAO,OAAO,KAAK,EAAE,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC;AACpF,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,WAAoB,EACpB,MAA0B,EAC1B,mBAAyC;IAEzC,MAAM,aAAa,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;IACrD,IAAI,aAAa,IAAI,mBAAmB,EAAE,CAAC;QACzC,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IACD,OAAO,IAAI,iBAAiB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AACpD,CAAC"}

package/lib/session/session-event-log.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Append-only HTTP session event log (ADR 0041).
+ */
+import type { AgentStreamEvent } from '@zhin.js/ai/agent-stream';
+export type SessionEventListener = (event: AgentStreamEvent, index: number) => void;
+export declare class SessionEventLog {
+    private readonly events;
+    private readonly listeners;
+    getEvents(sessionId: string): AgentStreamEvent[];
+    append(sessionId: string, event: AgentStreamEvent): number;
+    slice(sessionId: string, startIndex: number): AgentStreamEvent[];
+    subscribe(sessionId: string, listener: SessionEventListener): () => void;
+    replaceEvents(sessionId: string, events: AgentStreamEvent[]): void;
+    deleteSession(sessionId: string): void;
+    private notify;
+}
+//# sourceMappingURL=session-event-log.d.ts.map

package/lib/session/session-event-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-event-log.d.ts","sourceRoot":"","sources":["../../src/session/session-event-log.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;AAEpF,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyC;IAChE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgD;IAE1E,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAIhD,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,MAAM;IAgB1D,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAMhE,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI;IAaxE,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,GAAG,IAAI;IAIlE,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKtC,OAAO,CAAC,MAAM;CAOf"}

package/lib/session/session-event-log.js

@@ -0,0 +1,56 @@
+export class SessionEventLog {
+    events = new Map();
+    listeners = new Map();
+    getEvents(sessionId) {
+        return this.events.get(sessionId) ?? [];
+    }
+    append(sessionId, event) {
+        const stamped = {
+            ...event,
+            timestamp: event.timestamp ?? Date.now(),
+        };
+        let list = this.events.get(sessionId);
+        if (!list) {
+            list = [];
+            this.events.set(sessionId, list);
+        }
+        list.push(stamped);
+        const index = list.length - 1;
+        this.notify(sessionId, stamped, index);
+        return index;
+    }
+    slice(sessionId, startIndex) {
+        const list = this.events.get(sessionId) ?? [];
+        const from = Math.max(0, Math.floor(startIndex));
+        return list.slice(from);
+    }
+    subscribe(sessionId, listener) {
+        let set = this.listeners.get(sessionId);
+        if (!set) {
+            set = new Set();
+            this.listeners.set(sessionId, set);
+        }
+        set.add(listener);
+        return () => {
+            set?.delete(listener);
+            if (set?.size === 0)
+                this.listeners.delete(sessionId);
+        };
+    }
+    replaceEvents(sessionId, events) {
+        this.events.set(sessionId, [...events]);
+    }
+    deleteSession(sessionId) {
+        this.events.delete(sessionId);
+        this.listeners.delete(sessionId);
+    }
+    notify(sessionId, event, index) {
+        const set = this.listeners.get(sessionId);
+        if (!set)
+            return;
+        for (const listener of set) {
+            listener(event, index);
+        }
+    }
+}
+//# sourceMappingURL=session-event-log.js.map

package/lib/session/session-event-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-event-log.js","sourceRoot":"","sources":["../../src/session/session-event-log.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,eAAe;IACT,MAAM,GAAG,IAAI,GAAG,EAA8B,CAAC;IAC/C,SAAS,GAAG,IAAI,GAAG,EAAqC,CAAC;IAE1E,SAAS,CAAC,SAAiB;QACzB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;IAC1C,CAAC;IAED,MAAM,CAAC,SAAiB,EAAE,KAAuB;QAC/C,MAAM,OAAO,GAAqB;YAChC,GAAG,KAAK;YACR,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE;SACzC,CAAC;QACF,IAAI,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,GAAG,EAAE,CAAC;YACV,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACnC,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QACvC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,SAAiB,EAAE,UAAkB;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,SAAS,CAAC,SAAiB,EAAE,QAA8B;QACzD,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACxC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QACrC,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAClB,OAAO,GAAG,EAAE;YACV,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;YACtB,IAAI,GAAG,EAAE,IAAI,KAAK,CAAC;gBAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACxD,CAAC,CAAC;IACJ,CAAC;IAED,aAAa,CAAC,SAAiB,EAAE,MAA0B;QACzD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,aAAa,CAAC,SAAiB;QAC7B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC9B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC;IAEO,MAAM,CAAC,SAAiB,EAAE,KAAuB,EAAE,KAAa;QACtE,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,KAAK,MAAM,QAAQ,IAAI,GAAG,EAAE,CAAC;YAC3B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;CACF"}

package/lib/session/session-interaction-port.d.ts

@@ -0,0 +1,15 @@
+/**
+ * SessionInteractionPort — blocking HITL only (ADR 0041).
+ * Stream events publish via AgentStreamBus separately.
+ */
+export interface ApprovalRequestInput {
+    requestId: string;
+    toolName: string;
+    question: string;
+    timeoutMs?: number;
+}
+export interface SessionInteractionPort {
+    requestApproval(input: ApprovalRequestInput): Promise<boolean>;
+    resolveApproval?(requestId: string, approved: boolean): boolean;
+}
+//# sourceMappingURL=session-interaction-port.d.ts.map

package/lib/session/session-interaction-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-interaction-port.d.ts","sourceRoot":"","sources":["../../src/session/session-interaction-port.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/D,eAAe,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC;CACjE"}

package/lib/session/session-interaction-port.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session-interaction-port.js.map

package/lib/session/session-interaction-port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-interaction-port.js","sourceRoot":"","sources":["../../src/session/session-interaction-port.ts"],"names":[],"mappings":""}

package/lib/skill/progressive-disclosure.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Skills progressive disclosure — Eve-aligned discover → load_skill (ADR 0039 P1).
+ */
+/** Builtin meta tools for on-demand skill loading. */
+export declare const SKILL_DISCLOSURE_TOOLS: readonly ["discover", "load_skill"];
+/** Recommended agent turn sequence for deferred skills. */
+export declare const SKILL_DISCLOSURE_STEPS: readonly ["discover(kind=skill, query=...)", "load_skill(name)", "call tools unlocked by the skill"];
+export declare const SKILL_DISCLOSURE_PROMPT_HINT: string;
+//# sourceMappingURL=progressive-disclosure.d.ts.map

package/lib/skill/progressive-disclosure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progressive-disclosure.d.ts","sourceRoot":"","sources":["../../src/skill/progressive-disclosure.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,sDAAsD;AACtD,eAAO,MAAM,sBAAsB,qCAAsC,CAAC;AAE1E,2DAA2D;AAC3D,eAAO,MAAM,sBAAsB,sGAIzB,CAAC;AAEX,eAAO,MAAM,4BAA4B,QAE8B,CAAC"}

package/lib/skill/progressive-disclosure.js

@@ -0,0 +1,14 @@
+/**
+ * Skills progressive disclosure — Eve-aligned discover → load_skill (ADR 0039 P1).
+ */
+/** Builtin meta tools for on-demand skill loading. */
+export const SKILL_DISCLOSURE_TOOLS = ['discover', 'load_skill'];
+/** Recommended agent turn sequence for deferred skills. */
+export const SKILL_DISCLOSURE_STEPS = [
+    'discover(kind=skill, query=...)',
+    'load_skill(name)',
+    'call tools unlocked by the skill',
+];
+export const SKILL_DISCLOSURE_PROMPT_HINT = 'Skills are not fully injected upfront. Use discover(kind=skill) to search, '
+    + 'then load_skill(name) before following skill-specific procedures.';
+//# sourceMappingURL=progressive-disclosure.js.map

package/lib/skill/progressive-disclosure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progressive-disclosure.js","sourceRoot":"","sources":["../../src/skill/progressive-disclosure.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,sDAAsD;AACtD,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,UAAU,EAAE,YAAY,CAAU,CAAC;AAE1E,2DAA2D;AAC3D,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,iCAAiC;IACjC,kBAAkB;IAClB,kCAAkC;CAC1B,CAAC;AAEX,MAAM,CAAC,MAAM,4BAA4B,GACvC,6EAA6E;MAC3E,mEAAmE,CAAC"}

package/lib/stability/memory-pressure.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-pressure.d.ts","sourceRoot":"","sources":["../../src/stability/memory-pressure.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAiB,MAAM,EAAE,MAAM,iBAAiB,CAAC;AASxD,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,MAAM,CAAC;IACtB,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACnC;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,wBAAwB,EAAE,CAAC;IACxC,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAiCD,wBAAsB,uBAAuB,CAC3C,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAO,GAC3D,OAAO,CAAC,uBAAuB,CAAC,CAgBlC;AAED,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,uBAA4B,GAAG,MAAM,IAAI,CAwDvF"}
+{"version":3,"file":"memory-pressure.d.ts","sourceRoot":"","sources":["../../src/stability/memory-pressure.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAiB,MAAM,EAAa,MAAM,iBAAiB,CAAC;AASnE,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,MAAM,CAAC;IACtB,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACnC;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,wBAAwB,EAAE,CAAC;IACxC,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAiCD,wBAAsB,uBAAuB,CAC3C,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAO,GAC3D,OAAO,CAAC,uBAAuB,CAAC,CAgBlC;AAED,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,uBAA4B,GAAG,MAAM,IAAI,CAwDvF"}

package/lib/stability/memory-pressure.js

@@ -1,10 +1,10 @@
 /**
  * ADR 0014 P2-1 — 关键全局 Map / RSS 内存压力监控
  */
-import { formatCompact, Logger } from '@zhin.js/logger';
+import { formatCompact, getLogger } from '@zhin.js/logger';
 import { getCompactionStateCount, evictCompactionStatesIfOverPressure } from '../memory/compaction-runtime.js';
 import { getPendingOrchestrationCount, evictPendingOrchestrationIfOverPressure, } from '../security/owner-approve-always-store.js';
-const defaultLogger = new Logger(null, 'StabilityMonitor');
+const defaultLogger = getLogger('StabilityMonitor');
 const DEFAULT_COLLECTORS = [
     {
         name: 'compactionStates',

package/lib/stability/memory-pressure.js.map

@@ -1 +1 @@
-{"version":3,"file":"memory-pressure.js","sourceRoot":"","sources":["../../src/stability/memory-pressure.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"memory-pressure.js","sourceRoot":"","sources":["../../src/stability/memory-pressure.ts"],"names":[],"mappings":"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"}

package/lib/state/agent-state-store.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Session-scoped agent state — defineState runtime (ADR 0039 P2).
+ * In-memory per sessionId; not durable across restarts (P3 workflow ADR).
+ */
+export type StateInitialFn<T> = T | (() => T);
+export interface RegisteredAuthoringState {
+    runtimeName: string;
+    pluginName: string;
+    initial: () => unknown;
+}
+export declare function resetAgentStateStoreForTests(): void;
+export declare function registerAuthoringState(entry: RegisteredAuthoringState): void;
+export declare function listRegisteredAuthoringStates(): RegisteredAuthoringState[];
+export declare function registerAuthoringStateFromDefinition(runtimeName: string, pluginName: string, initial?: StateInitialFn<unknown>): void;
+export declare function getAgentState<T = unknown>(sessionId: string, name: string): T | undefined;
+export declare function updateAgentState<T = unknown>(sessionId: string, name: string, updater: (prev: T | undefined) => T): T;
+export declare function clearAgentStateSession(sessionId: string): void;
+//# sourceMappingURL=agent-state-store.d.ts.map

package/lib/state/agent-state-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-state-store.d.ts","sourceRoot":"","sources":["../../src/state/agent-state-store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AAE9C,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,OAAO,CAAC;CACxB;AAKD,wBAAgB,4BAA4B,IAAI,IAAI,CAGnD;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,wBAAwB,GAAG,IAAI,CAE5E;AAED,wBAAgB,6BAA6B,IAAI,wBAAwB,EAAE,CAE1E;AAOD,wBAAgB,oCAAoC,CAClD,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,GAChC,IAAI,CAMN;AAED,wBAAgB,aAAa,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAQzF;AAED,wBAAgB,gBAAgB,CAAC,CAAC,GAAG,OAAO,EAC1C,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,SAAS,KAAK,CAAC,GAClC,CAAC,CAMH;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAE9D"}