@zhin.js/agent 1.0.1 → 1.0.3

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/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Session System — SessionSystem + 策略 + session-io（契约见 contracts.ts）。
+ */
+export type { Session, CreateSessionInput, SessionStore, SessionStrategy, SessionSystemConfig, } from './contracts.js';
+export type { SessionIODeps } from './session-io.js';
+export type { TurnSessionPrep } from './session-system.js';
+export { SessionSystem, createSessionSystem } from './session-system.js';
+export { CollaborationSessionStrategy, SimpleSessionStrategy, } from './strategies.js';
+export { buildUserMessageExtra, prepareUserContentForSession, layerInboundUserTurnBody, resolveTurnUserMessage, formatUserContentForSession, buildSessionCreateInput, buildImTranscriptQuery, buildHistoryMessagesFromContext, resolveSessionIsNewBeforeCreate, beginTurnSession, touchSession, archiveSessionByKey, } from './session-io.js';
+export { resolveAgentTurnSessionKey, resolveAgentSessionKeyForTurn, resolveArtifactRunId, } from '../collaboration/resolve-agent-session-key.js';
+export { resolvePassiveGroupSessionKey, recordPassiveGroupMessage, consumePassiveGroupContextForTurn, appendPassiveGroupMessageToContext, } from './passive-group-session.js';
+export { pushPassiveGroupLine, drainPassiveGroupBuffer, peekPassiveGroupBuffer, formatPassiveGroupContextBlock, prunePassiveLines, MAX_PASSIVE_LINES, PASSIVE_TTL_MS, } from './passive-group-buffer.js';
+export type { PassiveGroupLine } from './passive-group-buffer.js';
+export { listSessionTreeForCommMessage, jumpSessionTreeForCommMessage, } from './session-tree-commands.js';
+export { summarizeAbandonedBranchIfNeeded, } from './branch-summarization-runtime.js';
+export type { BranchSummarizationOptions } from './branch-summarization-runtime.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/session/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACV,OAAO,EACP,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EACL,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,qBAAqB,EACrB,4BAA4B,EAC5B,wBAAwB,EACxB,sBAAsB,EACtB,2BAA2B,EAC3B,uBAAuB,EACvB,sBAAsB,EACtB,+BAA+B,EAC/B,+BAA+B,EAC/B,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,0BAA0B,EAC1B,6BAA6B,EAC7B,oBAAoB,GACrB,MAAM,+CAA+C,CAAC;AAEvD,OAAO,EACL,6BAA6B,EAC7B,yBAAyB,EACzB,iCAAiC,EACjC,kCAAkC,GACnC,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,sBAAsB,EACtB,8BAA8B,EAC9B,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,GACf,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAElE,OAAO,EACL,6BAA6B,EAC7B,6BAA6B,GAC9B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,gCAAgC,GACjC,MAAM,mCAAmC,CAAC;AAC3C,YAAY,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC"}

package/lib/session/index.js

@@ -0,0 +1,12 @@
+/**
+ * Session System — SessionSystem + 策略 + session-io（契约见 contracts.ts）。
+ */
+export { SessionSystem, createSessionSystem } from './session-system.js';
+export { CollaborationSessionStrategy, SimpleSessionStrategy, } from './strategies.js';
+export { buildUserMessageExtra, prepareUserContentForSession, layerInboundUserTurnBody, resolveTurnUserMessage, formatUserContentForSession, buildSessionCreateInput, buildImTranscriptQuery, buildHistoryMessagesFromContext, resolveSessionIsNewBeforeCreate, beginTurnSession, touchSession, archiveSessionByKey, } from './session-io.js';
+export { resolveAgentTurnSessionKey, resolveAgentSessionKeyForTurn, resolveArtifactRunId, } from '../collaboration/resolve-agent-session-key.js';
+export { resolvePassiveGroupSessionKey, recordPassiveGroupMessage, consumePassiveGroupContextForTurn, appendPassiveGroupMessageToContext, } from './passive-group-session.js';
+export { pushPassiveGroupLine, drainPassiveGroupBuffer, peekPassiveGroupBuffer, formatPassiveGroupContextBlock, prunePassiveLines, MAX_PASSIVE_LINES, PASSIVE_TTL_MS, } from './passive-group-buffer.js';
+export { listSessionTreeForCommMessage, jumpSessionTreeForCommMessage, } from './session-tree-commands.js';
+export { summarizeAbandonedBranchIfNeeded, } from './branch-summarization-runtime.js';
+//# sourceMappingURL=index.js.map

package/lib/session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAaH,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EACL,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,qBAAqB,EACrB,4BAA4B,EAC5B,wBAAwB,EACxB,sBAAsB,EACtB,2BAA2B,EAC3B,uBAAuB,EACvB,sBAAsB,EACtB,+BAA+B,EAC/B,+BAA+B,EAC/B,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,0BAA0B,EAC1B,6BAA6B,EAC7B,oBAAoB,GACrB,MAAM,+CAA+C,CAAC;AAEvD,OAAO,EACL,6BAA6B,EAC7B,yBAAyB,EACzB,iCAAiC,EACjC,kCAAkC,GACnC,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,sBAAsB,EACtB,8BAA8B,EAC9B,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,GACf,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,6BAA6B,EAC7B,6BAA6B,GAC9B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,gCAAgC,GACjC,MAAM,mCAAmC,CAAC"}

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/passive-group-buffer.d.ts

@@ -0,0 +1,15 @@
+export interface PassiveGroupLine {
+    senderId: string;
+    senderName?: string;
+    text: string;
+    at: number;
+}
+export declare const MAX_PASSIVE_LINES = 50;
+export declare const PASSIVE_TTL_MS: number;
+export declare function prunePassiveLines(lines: PassiveGroupLine[]): PassiveGroupLine[];
+export declare function pushPassiveGroupLine(sessionKey: string, line: PassiveGroupLine): void;
+export declare function drainPassiveGroupBuffer(sessionKey: string): PassiveGroupLine[];
+/** 测试 / 诊断 */
+export declare function peekPassiveGroupBuffer(sessionKey: string): readonly PassiveGroupLine[];
+export declare function formatPassiveGroupContextBlock(lines: readonly PassiveGroupLine[]): string | null;
+//# sourceMappingURL=passive-group-buffer.d.ts.map

package/lib/session/passive-group-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"passive-group-buffer.d.ts","sourceRoot":"","sources":["../../src/session/passive-group-buffer.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAID,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,eAAO,MAAM,cAAc,QAAiB,CAAC;AAE7C,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,gBAAgB,EAAE,CAK/E;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAIrF;AAED,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAI9E;AAED,cAAc;AACd,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,gBAAgB,EAAE,CAEtF;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,GAAG,MAAM,GAAG,IAAI,CAchG"}

package/lib/session/passive-group-buffer.js

@@ -0,0 +1,45 @@
+/**
+ * 群/频道旁听缓冲：未 @ 的消息先入内存，@ 触发时再与当前 @ 合并发给 LLM。
+ */
+import { HISTORY_CONTEXT_MARKER } from '../config/index.js';
+const buffers = new Map();
+export const MAX_PASSIVE_LINES = 50;
+export const PASSIVE_TTL_MS = 30 * 60 * 1000;
+export function prunePassiveLines(lines) {
+    const cutoff = Date.now() - PASSIVE_TTL_MS;
+    const fresh = lines.filter((line) => line.at >= cutoff);
+    if (fresh.length <= MAX_PASSIVE_LINES)
+        return fresh;
+    return fresh.slice(fresh.length - MAX_PASSIVE_LINES);
+}
+export function pushPassiveGroupLine(sessionKey, line) {
+    const list = buffers.get(sessionKey) ?? [];
+    list.push(line);
+    buffers.set(sessionKey, prunePassiveLines(list));
+}
+export function drainPassiveGroupBuffer(sessionKey) {
+    const list = buffers.get(sessionKey) ?? [];
+    buffers.delete(sessionKey);
+    return list;
+}
+/** 测试 / 诊断 */
+export function peekPassiveGroupBuffer(sessionKey) {
+    return buffers.get(sessionKey) ?? [];
+}
+export function formatPassiveGroupContextBlock(lines) {
+    if (lines.length === 0)
+        return null;
+    const body = lines
+        .map((line) => {
+        const name = (line.senderName?.trim() || line.senderId).replace(/[\]\s]+/g, '_').slice(0, 64);
+        const id = line.senderId.trim() || 'unknown';
+        return `[sender:id=${id} name=${name} roles=user] ${line.text}`;
+    })
+        .join('\n');
+    return [
+        HISTORY_CONTEXT_MARKER,
+        'Group messages since your last reply (not @mentions; background only — respond to the current @ message below).',
+        body,
+    ].join('\n');
+}
+//# sourceMappingURL=passive-group-buffer.js.map

package/lib/session/passive-group-buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"passive-group-buffer.js","sourceRoot":"","sources":["../../src/session/passive-group-buffer.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAS5D,MAAM,OAAO,GAAG,IAAI,GAAG,EAA8B,CAAC;AAEtD,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AACpC,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAE7C,MAAM,UAAU,iBAAiB,CAAC,KAAyB;IACzD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,cAAc,CAAC;IAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,MAAM,CAAC,CAAC;IACxD,IAAI,KAAK,CAAC,MAAM,IAAI,iBAAiB;QAAE,OAAO,KAAK,CAAC;IACpD,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,iBAAiB,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,UAAkB,EAAE,IAAsB;IAC7E,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;IAC3C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,UAAkB;IACxD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;IAC3C,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC3B,OAAO,IAAI,CAAC;AACd,CAAC;AAED,cAAc;AACd,MAAM,UAAU,sBAAsB,CAAC,UAAkB;IACvD,OAAO,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,KAAkC;IAC/E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,MAAM,IAAI,GAAG,KAAK;SACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC9F,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC;QAC7C,OAAO,cAAc,EAAE,SAAS,IAAI,gBAAgB,IAAI,CAAC,IAAI,EAAE,CAAC;IAClE,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,OAAO;QACL,sBAAsB;QACtB,iHAAiH;QACjH,IAAI;KACL,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/lib/session/passive-group-session.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 群/频道 Passive Group 上下文 — session key SSOT + buffer record/drain。
+ */
+import type { Message } from '@zhin.js/core';
+import type { CollaborationScene } from '../collaboration/types.js';
+import type { ZhinAgentPrivate } from '../internal/agent-host.js';
+export declare function resolvePassiveGroupSessionKey(message: Message, cell?: CollaborationScene): string;
+export declare function recordPassiveGroupMessage(agent: ZhinAgentPrivate, message: Message, rawText: string, cell?: CollaborationScene): Promise<void>;
+export declare function consumePassiveGroupContextForTurn(message: Message): string | null;
+/** @deprecated use recordPassiveGroupMessage */
+export declare function appendPassiveGroupMessageToContext(agent: ZhinAgentPrivate, message: Message, rawText: string, cell?: CollaborationScene): Promise<void>;
+//# sourceMappingURL=passive-group-session.d.ts.map

package/lib/session/passive-group-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"passive-group-session.d.ts","sourceRoot":"","sources":["../../src/session/passive-group-session.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAQpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AASlE,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE,kBAAkB,GACxB,MAAM,CAER;AAED,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,kBAAkB,GACxB,OAAO,CAAC,IAAI,CAAC,CAcf;AAED,wBAAgB,iCAAiC,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAGjF;AAED,gDAAgD;AAChD,wBAAsB,kCAAkC,CACtD,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,kBAAkB,GACxB,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/lib/session/passive-group-session.js

@@ -0,0 +1,36 @@
+import { resolveAgentTurnSessionKey } from '../collaboration/resolve-agent-session-key.js';
+import { buildSessionCreateInput, prepareUserContentForSession } from './session-io.js';
+import { drainPassiveGroupBuffer, formatPassiveGroupContextBlock, pushPassiveGroupLine, } from './passive-group-buffer.js';
+function resolveSenderDisplayName(message) {
+    if (!message?.$sender)
+        return 'unknown';
+    const sender = message.$sender;
+    const raw = sender.nickname || sender.name || sender.id;
+    return raw != null ? String(raw).trim().slice(0, 64) : 'unknown';
+}
+export function resolvePassiveGroupSessionKey(message, cell) {
+    return resolveAgentTurnSessionKey(message, cell);
+}
+export async function recordPassiveGroupMessage(agent, message, rawText, cell) {
+    const { content } = prepareUserContentForSession(message, rawText);
+    if (!content.trim())
+        return;
+    const sessionKey = resolvePassiveGroupSessionKey(message, cell);
+    const sessionInput = buildSessionCreateInput(sessionKey, message);
+    await agent.agentSessionStore.getOrCreateActive(sessionInput);
+    pushPassiveGroupLine(sessionKey, {
+        senderId: String(message.$sender?.id ?? 'unknown'),
+        senderName: resolveSenderDisplayName(message),
+        text: content,
+        at: Date.now(),
+    });
+}
+export function consumePassiveGroupContextForTurn(message) {
+    const sessionKey = resolvePassiveGroupSessionKey(message);
+    return formatPassiveGroupContextBlock(drainPassiveGroupBuffer(sessionKey));
+}
+/** @deprecated use recordPassiveGroupMessage */
+export async function appendPassiveGroupMessageToContext(agent, message, rawText, cell) {
+    await recordPassiveGroupMessage(agent, message, rawText, cell);
+}
+//# sourceMappingURL=passive-group-session.js.map

package/lib/session/passive-group-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"passive-group-session.js","sourceRoot":"","sources":["../../src/session/passive-group-session.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,0BAA0B,EAAE,MAAM,+CAA+C,CAAC;AAC3F,OAAO,EAAE,uBAAuB,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AACxF,OAAO,EACL,uBAAuB,EACvB,8BAA8B,EAC9B,oBAAoB,GACrB,MAAM,2BAA2B,CAAC;AAGnC,SAAS,wBAAwB,CAAC,OAAgB;IAChD,IAAI,CAAC,OAAO,EAAE,OAAO;QAAE,OAAO,SAAS,CAAC;IACxC,MAAM,MAAM,GAAG,OAAO,CAAC,OAA4D,CAAC;IACpF,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,EAAE,CAAC;IACxD,OAAO,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,OAAgB,EAChB,IAAyB;IAEzB,OAAO,0BAA0B,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,KAAuB,EACvB,OAAgB,EAChB,OAAe,EACf,IAAyB;IAEzB,MAAM,EAAE,OAAO,EAAE,GAAG,4BAA4B,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACnE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE;QAAE,OAAO;IAE5B,MAAM,UAAU,GAAG,6BAA6B,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAChE,MAAM,YAAY,GAAG,uBAAuB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAClE,MAAM,KAAK,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC;IAE9D,oBAAoB,CAAC,UAAU,EAAE;QAC/B,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,IAAI,SAAS,CAAC;QAClD,UAAU,EAAE,wBAAwB,CAAC,OAAO,CAAC;QAC7C,IAAI,EAAE,OAAO;QACb,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;KACf,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,iCAAiC,CAAC,OAAgB;IAChE,MAAM,UAAU,GAAG,6BAA6B,CAAC,OAAO,CAAC,CAAC;IAC1D,OAAO,8BAA8B,CAAC,uBAAuB,CAAC,UAAU,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED,gDAAgD;AAChD,MAAM,CAAC,KAAK,UAAU,kCAAkC,CACtD,KAAuB,EACvB,OAAgB,EAChB,OAAe,EACf,IAAyB;IAEzB,MAAM,yBAAyB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;AACjE,CAAC"}

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"}