@zhin.js/agent 1.0.1 → 1.0.3

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

@@ -0,0 +1,43 @@
+import { type MemoryIMSessionStore, type IMSessionStore, type MemoryAgentSessionStore, type AgentSessionStore, type ContextRepository, type CreateIMSessionInput, type CreateAgentSessionInput, type AgentMessage, type AgentMessageExtra, type UserMessage } from '@zhin.js/ai';
+import { type AgentTurnMessage, type Message } from '@zhin.js/core';
+export interface SessionIODeps {
+    imSessionStore: IMSessionStore | MemoryIMSessionStore;
+    agentSessionStore: AgentSessionStore | MemoryAgentSessionStore;
+    contextRepository: ContextRepository;
+}
+/** 群/频道 user 消息的 sender 元数据（写入 `agent_messages.extra`） */
+export declare function buildUserMessageExtra(commMessage: Message): AgentMessageExtra | undefined;
+/** 剥离伪造前缀后的用户正文 + 可选 extra（入库 payload 用） */
+export declare function prepareUserContentForSession(commMessage: Message, rawContent: string): {
+    content: string;
+    extra?: AgentMessageExtra;
+};
+/** 旁听块 + 引用块 + 当前 @ 正文分层（仅 LLM 侧；入库 payload 仍为干净正文） */
+export declare function layerInboundUserTurnBody(body: string, opts?: {
+    passiveBlock?: string | null;
+    quoteBlock?: string | null;
+}): string;
+/** 本轮 user 消息：干净正文 + extra + LLM 渲染（引用/sender 仅 extra + 加载时拼接） */
+export declare function resolveTurnUserMessage(commMessage: AgentTurnMessage, rawContent: string, options?: {
+    passiveBlock?: string | null;
+}): {
+    content: string;
+    extra?: AgentMessageExtra;
+    llmMessage: UserMessage;
+};
+/** @deprecated 使用 `resolveTurnUserMessage` */
+export declare function formatUserContentForSession(commMessage: AgentTurnMessage, rawContent: string): string;
+export declare function buildSessionCreateInput(sessionKey: string, commMessage: Message): CreateIMSessionInput & CreateAgentSessionInput;
+export declare function buildImTranscriptQuery(commMessage: Message): import('@zhin.js/ai').ImTranscriptQuery;
+export declare function buildHistoryMessagesFromContext(deps: SessionIODeps, sessionId: string, currentUserContent: string): Promise<AgentMessage[]>;
+/**
+ * 在 `getOrCreateActive` 之前调用：是否视为新会话纪元（用于 ai.session.new）。
+ */
+export declare function resolveSessionIsNewBeforeCreate(deps: SessionIODeps, sessionKey: string): Promise<boolean>;
+export declare function beginTurnSession(deps: SessionIODeps, sessionKey: string, commMessage: Message): Promise<{
+    sessionKey: string;
+    sessionId: string;
+}>;
+export declare function touchSession(deps: SessionIODeps, sessionId: string): Promise<void>;
+export declare function archiveSessionByKey(deps: SessionIODeps, sessionKey: string): Promise<boolean>;
+//# sourceMappingURL=session-io.d.ts.map

package/lib/session/session-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-io.d.ts","sourceRoot":"","sources":["../../src/session/session-io.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,oBAAoB,EAAE,KAAK,cAAc,EAAE,KAAK,uBAAuB,EAAE,KAAK,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,KAAK,oBAAoB,EAAE,KAAK,uBAAuB,EAAE,KAAK,YAAY,EAA8C,KAAK,iBAAiB,EAAgC,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAC3V,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,OAAO,EAAiJ,MAAM,eAAe,CAAC;AAEnN,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,cAAc,GAAG,oBAAoB,CAAC;IACtD,iBAAiB,EAAE,iBAAiB,GAAG,uBAAuB,CAAC;IAC/D,iBAAiB,EAAE,iBAAiB,CAAC;CACtC;AA+BD,0DAA0D;AAC1D,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,OAAO,GAAG,iBAAiB,GAAG,SAAS,CAWzF;AAED,4CAA4C;AAC5C,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,OAAO,EACpB,UAAU,EAAE,MAAM,GACjB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,iBAAiB,CAAA;CAAE,CAIhD;AAED,uDAAuD;AACvD,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAClE,MAAM,CAMR;AAED,kEAAkE;AAClE,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,gBAAgB,EAC7B,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACzC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAAC,UAAU,EAAE,WAAW,CAAA;CAAE,CAqBzE;AAED,8CAA8C;AAC9C,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,gBAAgB,EAC7B,UAAU,EAAE,MAAM,GACjB,MAAM,CAKR;AAED,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,OAAO,GACnB,oBAAoB,GAAG,uBAAuB,CAShD;AAED,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,OAAO,GACnB,OAAO,aAAa,EAAE,iBAAiB,CAOzC;AAED,wBAAsB,+BAA+B,CACnD,IAAI,EAAE,aAAa,EACnB,SAAS,EAAE,MAAM,EACjB,kBAAkB,EAAE,MAAM,GACzB,OAAO,CAAC,YAAY,EAAE,CAAC,CAIzB;AAED;;GAEG;AACH,wBAAsB,+BAA+B,CACnD,IAAI,EAAE,aAAa,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC,CAGlB;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,aAAa,EACnB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,OAAO,GACnB,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAIpD;AAED,wBAAsB,YAAY,CAChC,IAAI,EAAE,aAAa,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,aAAa,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC,CAGlB"}

package/lib/session/session-io.js

@@ -0,0 +1,135 @@
+import { createUserMessage, renderUserMessageForLlm } from '@zhin.js/ai';
+import { formatSenderRolesForLabel, QUOTE_CONTEXT_BLOCK_EXTRA_KEY, resolveSceneFieldsFromMessage, senderRolesFromMessage, stripUserSpoofedSenderPrefix } from '@zhin.js/core';
+import { CURRENT_MESSAGE_MARKER } from '../config/index.js';
+function sanitizeSenderAttr(value) {
+    const trimmed = value.trim().replace(/[\]\s]+/g, '_');
+    return trimmed.length > 0 ? trimmed.slice(0, 64) : 'unknown';
+}
+function resolveSenderDisplayName(message) {
+    if (!message?.$sender)
+        return 'unknown';
+    const sender = message.$sender;
+    const raw = sender.nickname || sender.name || sender.id;
+    return raw != null ? sanitizeSenderAttr(String(raw)) : 'unknown';
+}
+function mapPlatformRoleForLabel(role) {
+    if (!role || role === 'member')
+        return undefined;
+    if (role === 'owner')
+        return 'scene_owner';
+    if (role === 'admin')
+        return 'scene_admin';
+    return role;
+}
+function resolveSenderRoleLabels(commMessage) {
+    const labels = formatSenderRolesForLabel([...senderRolesFromMessage(commMessage)])
+        .split(',')
+        .map((r) => r.trim())
+        .filter((r) => r && r !== 'user');
+    const platform = mapPlatformRoleForLabel(commMessage.$sender.role);
+    if (platform && !labels.includes(platform))
+        labels.push(platform);
+    return labels.length > 0 ? labels : ['user'];
+}
+/** 群/频道 user 消息的 sender 元数据（写入 `agent_messages.extra`） */
+export function buildUserMessageExtra(commMessage) {
+    const scope = commMessage.$channel?.type || 'private';
+    if (scope !== 'group' && scope !== 'channel')
+        return undefined;
+    const roleLabels = resolveSenderRoleLabels(commMessage);
+    const sender = {
+        id: sanitizeSenderAttr(String(commMessage.$sender.id || 'unknown')),
+        name: resolveSenderDisplayName(commMessage),
+        roles: roleLabels.length > 0 ? roleLabels : ['user'],
+        scope,
+    };
+    return { sender };
+}
+/** 剥离伪造前缀后的用户正文 + 可选 extra（入库 payload 用） */
+export function prepareUserContentForSession(commMessage, rawContent) {
+    const content = stripUserSpoofedSenderPrefix(rawContent);
+    const extra = buildUserMessageExtra(commMessage);
+    return { content, extra };
+}
+/** 旁听块 + 引用块 + 当前 @ 正文分层（仅 LLM 侧；入库 payload 仍为干净正文） */
+export function layerInboundUserTurnBody(body, opts) {
+    const parts = [];
+    if (opts?.passiveBlock?.trim())
+        parts.push(opts.passiveBlock.trim());
+    if (opts?.quoteBlock?.trim())
+        parts.push(opts.quoteBlock.trim());
+    if (parts.length === 0)
+        return body;
+    return `${parts.join('\n\n')}\n\n${CURRENT_MESSAGE_MARKER}\n${body}`;
+}
+/** 本轮 user 消息：干净正文 + extra + LLM 渲染（引用/sender 仅 extra + 加载时拼接） */
+export function resolveTurnUserMessage(commMessage, rawContent, options) {
+    const { content, extra: senderExtra } = prepareUserContentForSession(commMessage, rawContent);
+    const quoteBlock = commMessage.extra?.[QUOTE_CONTEXT_BLOCK_EXTRA_KEY];
+    const quoteText = typeof quoteBlock === 'string' && quoteBlock.trim() ? quoteBlock.trim() : undefined;
+    const extra = {
+        ...senderExtra,
+        ...(quoteText ? { quote: { block: quoteText, messageId: commMessage.$quote_id } } : {}),
+    };
+    const hasExtra = !!(extra.sender || extra.quote);
+    const layered = layerInboundUserTurnBody(content, {
+        passiveBlock: options?.passiveBlock,
+        quoteBlock: quoteText,
+    });
+    const inlinedContext = layered !== content;
+    const llmMessage = renderUserMessageForLlm(createUserMessage(layered), inlinedContext
+        ? (senderExtra?.sender ? { sender: senderExtra.sender } : undefined)
+        : (hasExtra ? extra : undefined));
+    return { content, extra: hasExtra ? extra : undefined, llmMessage };
+}
+/** @deprecated 使用 `resolveTurnUserMessage` */
+export function formatUserContentForSession(commMessage, rawContent) {
+    const { llmMessage } = resolveTurnUserMessage(commMessage, rawContent);
+    if (llmMessage.role !== 'user')
+        return rawContent;
+    const block = llmMessage.content.find((b) => b.type === 'text');
+    return block?.type === 'text' ? block.text : rawContent;
+}
+export function buildSessionCreateInput(sessionKey, commMessage) {
+    const { platform, endpointId, sceneId, sceneType } = resolveSceneFieldsFromMessage(commMessage);
+    return {
+        session_key: sessionKey,
+        platform,
+        endpoint_id: endpointId,
+        scene_id: sceneId,
+        scene_type: sceneType,
+    };
+}
+export function buildImTranscriptQuery(commMessage) {
+    const { platform, endpointId, sceneId } = resolveSceneFieldsFromMessage(commMessage);
+    return {
+        platform,
+        endpointId,
+        sceneId,
+    };
+}
+export async function buildHistoryMessagesFromContext(deps, sessionId, currentUserContent) {
+    const loaded = await deps.contextRepository.loadContext(sessionId);
+    const timestamp = Date.now();
+    return [...loaded.messages, { role: 'user', content: [{ type: 'text', text: currentUserContent }], timestamp }];
+}
+/**
+ * 在 `getOrCreateActive` 之前调用：是否视为新会话纪元（用于 ai.session.new）。
+ */
+export async function resolveSessionIsNewBeforeCreate(deps, sessionKey) {
+    const active = await deps.agentSessionStore.findActive(sessionKey);
+    return !active;
+}
+export async function beginTurnSession(deps, sessionKey, commMessage) {
+    const input = buildSessionCreateInput(sessionKey, commMessage);
+    const record = await deps.agentSessionStore.getOrCreateActive(input);
+    return { sessionKey, sessionId: record.session_id };
+}
+export async function touchSession(deps, sessionId) {
+    await deps.agentSessionStore.touch(sessionId);
+}
+export async function archiveSessionByKey(deps, sessionKey) {
+    await deps.contextRepository.archiveSession(sessionKey);
+    return deps.agentSessionStore.archiveByKey(sessionKey);
+}
+//# sourceMappingURL=session-io.js.map

package/lib/session/session-io.js.map

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

package/lib/session/session-system.d.ts

@@ -0,0 +1,31 @@
+import type { Message } from '@zhin.js/core';
+import type { ZhinAgentPrivate } from '../internal/agent-host.js';
+import { buildTurnUserMessages } from '../context/turn-user-message.js';
+import type { SessionStrategy, SessionSystemConfig } from './contracts.js';
+import { type SessionIODeps } from './session-io.js';
+export type { SessionIODeps } from './session-io.js';
+export interface TurnSessionPrep {
+    sessionKey: string;
+    userId: string;
+    sessionId: string;
+    isNewSession: boolean;
+    passiveBlock: string | null;
+    turnUser: ReturnType<typeof buildTurnUserMessages>;
+}
+export declare class SessionSystem {
+    private readonly _config;
+    private readonly strategies;
+    constructor(_config?: SessionSystemConfig);
+    registerStrategy(name: string, strategy: SessionStrategy): void;
+    resolveSessionKey(message: Message, strategyName?: string): string;
+    resolvePassiveBlock(message: Message): string | null;
+    sessionDeps(host: ZhinAgentPrivate): SessionIODeps;
+    prepareTextTurn(host: ZhinAgentPrivate, commMessage: Message, content: string, options?: {
+        deferredAutoContinue?: boolean;
+        strategyName?: string;
+    }): Promise<TurnSessionPrep>;
+    touchAfterTurn(host: ZhinAgentPrivate, sessionId: string): Promise<void>;
+    archiveByKey(host: ZhinAgentPrivate, sessionKey: string): Promise<boolean>;
+}
+export declare function createSessionSystem(config?: SessionSystemConfig): SessionSystem;
+//# sourceMappingURL=session-system.d.ts.map

package/lib/session/session-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-system.d.ts","sourceRoot":"","sources":["../../src/session/session-system.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAExE,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,KAAK,aAAa,EAAwF,MAAM,iBAAiB,CAAC;AAG3I,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC;CACpD;AAED,qBAAa,aAAa;IAGZ,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsC;gBAEpC,OAAO,GAAE,mBAAwB;IAI9D,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI;IAI/D,iBAAiB,CACf,OAAO,EAAE,OAAO,EAChB,YAAY,GAAE,MAAwB,GACrC,MAAM;IAMT,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;IAMpD,WAAW,CAAC,IAAI,EAAE,gBAAgB,GAAG,aAAa;IAQ5C,eAAe,CACnB,IAAI,EAAE,gBAAgB,EACtB,WAAW,EAAE,OAAO,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,oBAAoB,CAAC,EAAE,OAAO,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GAClE,OAAO,CAAC,eAAe,CAAC;IA2BrB,cAAc,CAAC,IAAI,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxE,YAAY,CAAC,IAAI,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAGjF;AAED,wBAAgB,mBAAmB,CAAC,MAAM,GAAE,mBAAwB,GAAG,aAAa,CAEnF"}

package/lib/session/session-system.js

@@ -0,0 +1,70 @@
+import { resolveAgentTurnSessionKey } from '../collaboration/resolve-agent-session-key.js';
+import { buildTurnUserMessages } from '../context/turn-user-message.js';
+import { logPhase } from '../internal/phase-trace.js';
+import { beginTurnSession, resolveSessionIsNewBeforeCreate, touchSession, archiveSessionByKey } from './session-io.js';
+import { consumePassiveGroupContextForTurn } from './passive-group-session.js';
+import { CollaborationSessionStrategy } from './strategies.js';
+export class SessionSystem {
+    _config;
+    strategies = new Map();
+    constructor(_config = {}) {
+        this._config = _config;
+        this.registerStrategy('collaboration', new CollaborationSessionStrategy());
+    }
+    registerStrategy(name, strategy) {
+        this.strategies.set(name, strategy);
+    }
+    resolveSessionKey(message, strategyName = 'collaboration') {
+        const strategy = this.strategies.get(strategyName);
+        if (strategy)
+            return strategy.resolveSessionKey(message);
+        return resolveAgentTurnSessionKey(message);
+    }
+    resolvePassiveBlock(message) {
+        const channelScope = message.$channel?.type;
+        if (channelScope !== 'group' && channelScope !== 'channel')
+            return null;
+        return consumePassiveGroupContextForTurn(message);
+    }
+    sessionDeps(host) {
+        return {
+            imSessionStore: host.imSessionStore,
+            agentSessionStore: host.agentSessionStore,
+            contextRepository: host.contextRepository,
+        };
+    }
+    async prepareTextTurn(host, commMessage, content, options) {
+        const deps = this.sessionDeps(host);
+        const sessionKey = this.resolveSessionKey(commMessage, options?.strategyName);
+        const userId = commMessage.$sender.id || 'unknown';
+        const passiveBlock = this.resolvePassiveBlock(commMessage);
+        const turnUser = buildTurnUserMessages(commMessage, content, passiveBlock);
+        const isNewSession = await resolveSessionIsNewBeforeCreate(deps, sessionKey);
+        if (options?.deferredAutoContinue) {
+            logPhase(host.phaseConfig, 'turn.deferred_auto_continue', sessionKey, {});
+        }
+        else {
+            host.resetDeferredAutoContinueDepth(sessionKey);
+        }
+        await host.waitForMemoryPersistence();
+        const { sessionId } = await beginTurnSession(deps, sessionKey, commMessage);
+        return {
+            sessionKey,
+            userId,
+            sessionId,
+            isNewSession,
+            passiveBlock,
+            turnUser,
+        };
+    }
+    async touchAfterTurn(host, sessionId) {
+        await touchSession(this.sessionDeps(host), sessionId);
+    }
+    async archiveByKey(host, sessionKey) {
+        return archiveSessionByKey(this.sessionDeps(host), sessionKey);
+    }
+}
+export function createSessionSystem(config = {}) {
+    return new SessionSystem(config);
+}
+//# sourceMappingURL=session-system.js.map

package/lib/session/session-system.js.map

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

package/lib/session/session-tree-commands.d.ts

@@ -0,0 +1,5 @@
+import { type Message } from '@zhin.js/core';
+import type { ZhinAgentPrivate } from '../internal/agent-host.js';
+export declare function listSessionTreeForCommMessage(host: ZhinAgentPrivate, commMessage: Message): Promise<string>;
+export declare function jumpSessionTreeForCommMessage(host: ZhinAgentPrivate, commMessage: Message, index: number): Promise<string>;
+//# sourceMappingURL=session-tree-commands.d.ts.map

package/lib/session/session-tree-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-tree-commands.d.ts","sourceRoot":"","sources":["../../src/session/session-tree-commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AAG5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAQlE,wBAAsB,6BAA6B,CACjD,IAAI,EAAE,gBAAgB,EACtB,WAAW,EAAE,OAAO,GACnB,OAAO,CAAC,MAAM,CAAC,CAUjB;AAED,wBAAsB,6BAA6B,CACjD,IAAI,EAAE,gBAAgB,EACtB,WAAW,EAAE,OAAO,EACpB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,CAUjB"}

package/lib/session/session-tree-commands.js

@@ -0,0 +1,32 @@
+import { resolveIMSessionIdFromMessage } from '@zhin.js/core';
+import { beginTurnSession } from '../session/session-io.js';
+function formatBranchList(points) {
+    if (points.length === 0)
+        return '当前会话无 user 分支点';
+    return points
+        .map(p => `${p.index}. ${p.preview}`)
+        .join('\n');
+}
+export async function listSessionTreeForCommMessage(host, commMessage) {
+    const sessionKey = resolveIMSessionIdFromMessage(commMessage);
+    const deps = {
+        imSessionStore: host.imSessionStore,
+        agentSessionStore: host.agentSessionStore,
+        contextRepository: host.contextRepository,
+    };
+    const { sessionId } = await beginTurnSession(deps, sessionKey, commMessage);
+    const points = await host.contextRepository.listBranchPoints(sessionId);
+    return `🌳 会话分支点（/tree N 跳转，/fork N 从该点继续）：\n${formatBranchList(points)}`;
+}
+export async function jumpSessionTreeForCommMessage(host, commMessage, index) {
+    const sessionKey = resolveIMSessionIdFromMessage(commMessage);
+    const deps = {
+        imSessionStore: host.imSessionStore,
+        agentSessionStore: host.agentSessionStore,
+        contextRepository: host.contextRepository,
+    };
+    const { sessionId } = await beginTurnSession(deps, sessionKey, commMessage);
+    const result = await host.contextRepository.jumpToBranchIndex(sessionId, index);
+    return result.ok ? `✅ ${result.message}` : `ℹ️ ${result.message}`;
+}
+//# sourceMappingURL=session-tree-commands.js.map

package/lib/session/session-tree-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-tree-commands.js","sourceRoot":"","sources":["../../src/session/session-tree-commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAgB,MAAM,eAAe,CAAC;AAE5E,OAAO,EAAE,gBAAgB,EAAsB,MAAM,0BAA0B,CAAC;AAEhF,SAAS,gBAAgB,CAAC,MAA4B;IACpD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,gBAAgB,CAAC;IACjD,OAAO,MAAM;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;SACpC,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,IAAsB,EACtB,WAAoB;IAEpB,MAAM,UAAU,GAAG,6BAA6B,CAAC,WAAW,CAAC,CAAC;IAC9D,MAAM,IAAI,GAAkB;QAC1B,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;QACzC,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;KAC1C,CAAC;IACF,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;IAC5E,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;IACxE,OAAO,wCAAwC,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;AAC5E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,IAAsB,EACtB,WAAoB,EACpB,KAAa;IAEb,MAAM,UAAU,GAAG,6BAA6B,CAAC,WAAW,CAAC,CAAC;IAC9D,MAAM,IAAI,GAAkB;QAC1B,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;QACzC,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;KAC1C,CAAC;IACF,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;IAC5E,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAChF,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;AACpE,CAAC"}

package/lib/session/strategies.d.ts

@@ -0,0 +1,11 @@
+import { type Message } from '@zhin.js/core';
+import type { SessionStrategy } from './contracts.js';
+export declare class CollaborationSessionStrategy implements SessionStrategy {
+    resolveSessionKey(message: Message): string;
+    shouldArchive(message: Message): boolean;
+}
+export declare class SimpleSessionStrategy implements SessionStrategy {
+    resolveSessionKey(message: Message): string;
+    shouldArchive(_message: Message): boolean;
+}
+//# sourceMappingURL=strategies.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"strategies.d.ts","sourceRoot":"","sources":["../../src/session/strategies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AAE5E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,qBAAa,4BAA6B,YAAW,eAAe;IAClE,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;IAI3C,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;CAGzC;AAED,qBAAa,qBAAsB,YAAW,eAAe;IAC3D,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;IAI3C,aAAa,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO;CAG1C"}

package/lib/session/strategies.js

@@ -0,0 +1,19 @@
+import { resolveIMSessionIdFromMessage } from '@zhin.js/core';
+import { resolveAgentTurnSessionKey } from '../collaboration/resolve-agent-session-key.js';
+export class CollaborationSessionStrategy {
+    resolveSessionKey(message) {
+        return resolveAgentTurnSessionKey(message);
+    }
+    shouldArchive(message) {
+        return message.$channel?.type === 'group';
+    }
+}
+export class SimpleSessionStrategy {
+    resolveSessionKey(message) {
+        return resolveIMSessionIdFromMessage(message);
+    }
+    shouldArchive(_message) {
+        return false;
+    }
+}
+//# sourceMappingURL=strategies.js.map

package/lib/session/strategies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategies.js","sourceRoot":"","sources":["../../src/session/strategies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAgB,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,0BAA0B,EAAE,MAAM,+CAA+C,CAAC;AAG3F,MAAM,OAAO,4BAA4B;IACvC,iBAAiB,CAAC,OAAgB;QAChC,OAAO,0BAA0B,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED,aAAa,CAAC,OAAgB;QAC5B,OAAO,OAAO,CAAC,QAAQ,EAAE,IAAI,KAAK,OAAO,CAAC;IAC5C,CAAC;CACF;AAED,MAAM,OAAO,qBAAqB;IAChC,iBAAiB,CAAC,OAAgB;QAChC,OAAO,6BAA6B,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;IAED,aAAa,CAAC,QAAiB;QAC7B,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/lib/session-tree-runtime-registry.d.ts

@@ -2,7 +2,7 @@
  * Session tree runtime — 供 Host API 调用（ADR 0010 D3 Console API）。
  */
 import type { AgentSessionStore, ContextRepository, MemoryAgentSessionStore, SessionBranchPoint } from '@zhin.js/ai';
-import type { ZhinAgentPrivate } from './zhin-agent/zhin-agent-private.js';
+import type { ZhinAgentPrivate } from './internal/agent-host.js';
 export interface SessionTreeRuntimeHandle {
     contextRepository: ContextRepository;
     agentSessionStore: AgentSessionStore | MemoryAgentSessionStore;

package/lib/session-tree-runtime-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-tree-runtime-registry.d.ts","sourceRoot":"","sources":["../src/session-tree-runtime-registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EACnB,MAAM,aAAa,CAAC;AAKrB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAE3E,MAAM,WAAW,wBAAwB;IACvC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,iBAAiB,EAAE,iBAAiB,GAAG,uBAAuB,CAAC;IAC/D,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzE,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/F,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACnE,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACpE;AAID,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,wBAAwB,GAAG,IAAI,GAAG,IAAI,CAEnF;AAED,wBAAgB,qBAAqB,IAAI,wBAAwB,GAAG,IAAI,CAEvE;AAED,wBAAgB,iCAAiC,CAC/C,IAAI,EAAE,gBAAgB,GACrB,wBAAwB,CAc1B"}
+{"version":3,"file":"session-tree-runtime-registry.d.ts","sourceRoot":"","sources":["../src/session-tree-runtime-registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EACnB,MAAM,aAAa,CAAC;AAKrB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,MAAM,WAAW,wBAAwB;IACvC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,iBAAiB,EAAE,iBAAiB,GAAG,uBAAuB,CAAC;IAC/D,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzE,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/F,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACnE,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACpE;AAID,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,wBAAwB,GAAG,IAAI,GAAG,IAAI,CAEnF;AAED,wBAAgB,qBAAqB,IAAI,wBAAwB,GAAG,IAAI,CAEvE;AAED,wBAAgB,iCAAiC,CAC/C,IAAI,EAAE,gBAAgB,GACrB,wBAAwB,CAc1B"}

package/lib/session-tree-runtime-registry.js

@@ -1,7 +1,7 @@
 /**
  * Session tree runtime — 供 Host API 调用（ADR 0010 D3 Console API）。
  */
-import { jumpToBranchIndexWithSummarization, switchActiveLeafWithBranchSummarization, } from './zhin-agent/branch-summarization-runtime.js';
+import { jumpToBranchIndexWithSummarization, switchActiveLeafWithBranchSummarization, } from './session/branch-summarization-runtime.js';
 let runtime = null;
 export function setSessionTreeRuntime(handle) {
     runtime = handle;

package/lib/session-tree-runtime-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-tree-runtime-registry.js","sourceRoot":"","sources":["../src/session-tree-runtime-registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,OAAO,EACL,kCAAkC,EAClC,uCAAuC,GACxC,MAAM,8CAA8C,CAAC;AAYtD,IAAI,OAAO,GAAoC,IAAI,CAAC;AAEpD,MAAM,UAAU,qBAAqB,CAAC,MAAuC;IAC3E,OAAO,GAAG,MAAM,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,IAAsB;IAEtB,OAAO;QACL,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;QACzC,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;QACzC,gBAAgB,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,EAAE,CACzC,uCAAuC,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC;QACrE,iBAAiB,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,CACtC,kCAAkC,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC;QAC5D,gBAAgB,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,SAAS,CAAC;QACnF,sBAAsB,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE;YAC3C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;YACnE,OAAO,MAAM,EAAE,UAAU,IAAI,IAAI,CAAC;QACpC,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"session-tree-runtime-registry.js","sourceRoot":"","sources":["../src/session-tree-runtime-registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,OAAO,EACL,kCAAkC,EAClC,uCAAuC,GACxC,MAAM,2CAA2C,CAAC;AAYnD,IAAI,OAAO,GAAoC,IAAI,CAAC;AAEpD,MAAM,UAAU,qBAAqB,CAAC,MAAuC;IAC3E,OAAO,GAAG,MAAM,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,IAAsB;IAEtB,OAAO;QACL,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;QACzC,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;QACzC,gBAAgB,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,EAAE,CACzC,uCAAuC,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC;QACrE,iBAAiB,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,CACtC,kCAAkC,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC;QAC5D,gBAAgB,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,SAAS,CAAC;QACnF,sBAAsB,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE;YAC3C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;YACnE,OAAO,MAAM,EAAE,UAAU,IAAI,IAAI,CAAC;QACpC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/lib/skill/contracts.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Skill System — 模块契约（与实现同步）。
+ *
+ * 实现：包装 `SkillRegistry`；`search` 使用 registry TF-IDF 真实 score。
+ */
+import type { AgentTool } from '@zhin.js/ai';
+import type { Message } from '@zhin.js/core';
+export interface Skill {
+    name: string;
+    description: string;
+    tools: AgentTool[];
+    keywords: string[];
+    tags: string[];
+    platforms?: string[];
+}
+export interface SkillSearchResult {
+    skill: Skill;
+    score: number;
+}
+export interface SkillSearchOptions {
+    maxResults?: number;
+    platform?: string;
+}
+export interface SkillSystemConfig {
+}
+export interface TurnContext {
+    message: Message;
+}
+//# sourceMappingURL=contracts.d.ts.map

package/lib/skill/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/skill/contracts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;CAEjC;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;CAClB"}

package/lib/skill/contracts.js

@@ -0,0 +1,7 @@
+/**
+ * Skill System — 模块契约（与实现同步）。
+ *
+ * 实现：包装 `SkillRegistry`；`search` 使用 registry TF-IDF 真实 score。
+ */
+export {};
+//# sourceMappingURL=contracts.js.map

package/lib/skill/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../src/skill/contracts.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/lib/skill/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Skill System — SkillRegistry 统一出口（契约见 contracts.ts）。
+ */
+export type { Skill, SkillSearchResult, SkillSearchOptions, SkillSystemConfig, TurnContext, } from './contracts.js';
+export { SkillSystem, createSkillSystem, defaultSkillSystem, } from './skill-system.js';
+export { SkillRegistry } from '../orchestrator/skill-registry.js';
+export type { Skill as OrchestratorSkill, SkillMetadata } from '../orchestrator/types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skill/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACV,KAAK,EACL,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,GACZ,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,YAAY,EAAE,KAAK,IAAI,iBAAiB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC"}

package/lib/skill/index.js

@@ -0,0 +1,6 @@
+/**
+ * Skill System — SkillRegistry 统一出口（契约见 contracts.ts）。
+ */
+export { SkillSystem, createSkillSystem, defaultSkillSystem, } from './skill-system.js';
+export { SkillRegistry } from '../orchestrator/skill-registry.js';
+//# sourceMappingURL=index.js.map

package/lib/skill/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/skill/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC"}

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