@zhin.js/agent 0.3.1 → 1.0.2

package/lib/context/agents-instruction.js

@@ -0,0 +1,94 @@
+/**
+ * AGENTS.md 合并链：子目录（近）→ workspace root（远），注入 Turn envelope。
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { loadBootstrapFiles } from '../bootstrap.js';
+const agentsFileCache = new Map();
+async function readAgentsFile(filePath) {
+    try {
+        const stats = await fs.promises.stat(filePath);
+        const cached = agentsFileCache.get(filePath);
+        if (cached && cached.mtimeMs === stats.mtimeMs) {
+            return cached.content;
+        }
+        const content = (await fs.promises.readFile(filePath, 'utf-8')).trim();
+        if (!content)
+            return null;
+        agentsFileCache.set(filePath, { content, mtimeMs: stats.mtimeMs });
+        return content;
+    }
+    catch {
+        agentsFileCache.delete(filePath);
+        return null;
+    }
+}
+export function clearAgentsInstructionCache() {
+    agentsFileCache.clear();
+}
+function displayAgentsPath(absPath, workspaceRoot) {
+    const root = normalizeAgentsPath(workspaceRoot);
+    const abs = normalizeAgentsPath(absPath);
+    const rel = path.relative(root, abs);
+    return rel && !rel.startsWith('..') ? rel : path.basename(abs);
+}
+function normalizeAgentsPath(filePath) {
+    try {
+        return fs.realpathSync.native(filePath);
+    }
+    catch {
+        return path.resolve(filePath);
+    }
+}
+export async function collectAgentsInstructionChain(workspaceDir) {
+    const workspaceRoot = path.resolve(workspaceDir || process.cwd());
+    const startDir = path.resolve(process.cwd());
+    const entries = [];
+    const seen = new Set();
+    let current = startDir;
+    while (true) {
+        const candidate = path.resolve(path.join(current, 'AGENTS.md'));
+        const normalized = normalizeAgentsPath(candidate);
+        if (!seen.has(normalized)) {
+            const content = await readAgentsFile(candidate);
+            if (content) {
+                entries.push({
+                    path: displayAgentsPath(candidate, workspaceRoot),
+                    content,
+                });
+                seen.add(normalized);
+            }
+        }
+        if (path.resolve(current) === workspaceRoot)
+            break;
+        const parent = path.dirname(current);
+        if (parent === current)
+            break;
+        current = parent;
+    }
+    const bootstrapFiles = await loadBootstrapFiles(workspaceRoot);
+    const rootAgents = bootstrapFiles.find(f => f.name === 'AGENTS.md' && !f.missing);
+    if (rootAgents?.content?.trim() && rootAgents.path) {
+        const resolved = path.resolve(rootAgents.path);
+        const normalized = normalizeAgentsPath(resolved);
+        if (!seen.has(normalized)) {
+            entries.push({
+                path: displayAgentsPath(resolved, workspaceRoot),
+                content: rootAgents.content.trim(),
+            });
+            seen.add(normalized);
+        }
+    }
+    return entries;
+}
+export async function buildAgentsEnvelopeContext(workspaceDir) {
+    const chain = await collectAgentsInstructionChain(workspaceDir);
+    if (chain.length === 0)
+        return null;
+    const lines = ['[Agents instructions]'];
+    for (const entry of chain) {
+        lines.push('', `## ${entry.path}`, '', entry.content);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=agents-instruction.js.map

package/lib/context/agents-instruction.js.map

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

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

@@ -0,0 +1,47 @@
+import { type AgentMessage } from '@zhin.js/ai';
+import type { Message } from '@zhin.js/core';
+import type { ZhinAgentPrivate } from '../internal/agent-host.js';
+import type { BuildContext, ContextBuilder, ContextInjector, ContextSystemConfig } from './contracts.js';
+export type { TurnEnvelopeParts } from './envelope-parts.js';
+export { ProfileContextBuilder, CollaborationContextBuilder, ToneInjector, createDefaultContextBuilders, } from './default-builders.js';
+export declare class ContextSystem {
+    private readonly _config;
+    private builders;
+    private injectors;
+    constructor(_config?: ContextSystemConfig);
+    addBuilder(builder: ContextBuilder): void;
+    addInjector(injector: ContextInjector): void;
+    private mergePipeline;
+    private runPipeline;
+    /**
+     * Builder/injector pipeline：内置 profile/collaboration/tone 写入 envelope；
+     * 注册的 builder 可追加 AgentMessage[]。
+     */
+    build(context: BuildContext): Promise<AgentMessage[]>;
+    /** 生产 turn 路径：envelope 经 pipeline 收集，再组装 user 消息与模型候选。 */
+    buildTextTurnContext(input: TextTurnContextInput): Promise<TextTurnContextOutput>;
+}
+export interface TextTurnContextInput {
+    host: ZhinAgentPrivate;
+    commMessage: Message;
+    content: string;
+    turnUser: {
+        rawContent: string;
+        userMessageExtra?: import('@zhin.js/ai').AgentMessageExtra;
+        promptMessages: import('@zhin.js/ai').UserMessage[];
+    };
+    deferredStats?: string;
+    prebuiltMessages?: AgentMessage[];
+    mode?: 'chat' | 'vision';
+}
+export interface TextTurnContextOutput {
+    userMessages: AgentMessage[];
+    personaEnhanced: string;
+    modelCandidates: string[];
+    modelId: string;
+    providerAlias: string;
+    turnEnvelope: string | null;
+}
+/** 每 host 独立实例 + 默认 builder/injector（与 toolSystem 一致，非全局单例）。 */
+export declare function createContextSystemForHost(host: ZhinAgentPrivate): ContextSystem;
+//# sourceMappingURL=context-system.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context-system.d.ts","sourceRoot":"","sources":["../../src/context/context-system.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAwB,MAAM,aAAa,CAAC;AACtE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAElE,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,mBAAmB,EAAiB,MAAM,gBAAgB,CAAC;AAYxH,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,YAAY,EACZ,4BAA4B,GAC7B,MAAM,uBAAuB,CAAC;AAE/B,qBAAa,aAAa;IAIZ,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,QAAQ,CAAwB;IACxC,OAAO,CAAC,SAAS,CAAyB;gBAEb,OAAO,GAAE,mBAAwB;IAE9D,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAIzC,WAAW,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAI5C,OAAO,CAAC,aAAa;YAqBP,WAAW;IAoBzB;;;OAGG;IACG,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAI3D,0DAA0D;IACpD,oBAAoB,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAwDxF;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,gBAAgB,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE;QACR,UAAU,EAAE,MAAM,CAAC;QACnB,gBAAgB,CAAC,EAAE,OAAO,aAAa,EAAE,iBAAiB,CAAC;QAC3D,cAAc,EAAE,OAAO,aAAa,EAAE,WAAW,EAAE,CAAC;KACrD,CAAC;IACF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,YAAY,EAAE,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,YAAY,EAAE,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,gEAAgE;AAChE,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,gBAAgB,GAAG,aAAa,CAMhF"}

package/lib/context/context-system.js

@@ -0,0 +1,115 @@
+import { getLlmTransportModel } from '@zhin.js/ai';
+import { createDefaultContextBuilders } from './default-builders.js';
+import { applyTurnContextToUserMessages, prependEnvelopeToFirstUserText, } from './turn-user-message.js';
+import { buildAgentsEnvelopeContext } from './agents-instruction.js';
+import { buildTurnContextEnvelope, resolveQuoteSystemHint, } from './turn-envelope.js';
+import { resolveModelCandidates } from './model-resolver.js';
+export { ProfileContextBuilder, CollaborationContextBuilder, ToneInjector, createDefaultContextBuilders, } from './default-builders.js';
+export class ContextSystem {
+    _config;
+    builders = [];
+    injectors = [];
+    constructor(_config = {}) {
+        this._config = _config;
+    }
+    addBuilder(builder) {
+        this.builders.push(builder);
+    }
+    addInjector(injector) {
+        this.injectors.push(injector);
+    }
+    mergePipeline(host) {
+        if (!host) {
+            return { builders: [...this.builders], injectors: [...this.injectors] };
+        }
+        const defaults = createDefaultContextBuilders(host);
+        const builderNames = new Set(defaults.builders.map((b) => b.name));
+        const injectorNames = new Set(defaults.injectors.map((i) => i.name));
+        return {
+            builders: [
+                ...defaults.builders,
+                ...this.builders.filter((b) => !builderNames.has(b.name)),
+            ],
+            injectors: [
+                ...defaults.injectors,
+                ...this.injectors.filter((i) => !injectorNames.has(i.name)),
+            ],
+        };
+    }
+    async runPipeline(context, host) {
+        const { builders, injectors } = this.mergePipeline(host ?? context.host);
+        const built = [];
+        for (const builder of builders) {
+            built.push(...await builder.build(context));
+        }
+        const injectCtx = {
+            message: context.message,
+            inboundContent: context.inboundContent,
+            envelope: context.envelope,
+        };
+        return injectors.reduce((messages, injector) => injector.inject(messages, injectCtx), built);
+    }
+    /**
+     * Builder/injector pipeline：内置 profile/collaboration/tone 写入 envelope；
+     * 注册的 builder 可追加 AgentMessage[]。
+     */
+    async build(context) {
+        return this.runPipeline(context, context.host);
+    }
+    /** 生产 turn 路径：envelope 经 pipeline 收集，再组装 user 消息与模型候选。 */
+    async buildTextTurnContext(input) {
+        const { host, commMessage, content, turnUser, deferredStats, prebuiltMessages } = input;
+        const mode = input.mode ?? 'chat';
+        const envelopeParts = {};
+        const buildCtx = {
+            message: commMessage,
+            inboundContent: content,
+            host,
+            envelope: envelopeParts,
+        };
+        const extraMessages = await this.runPipeline(buildCtx, host);
+        const personaEnhanced = host.buildDisciplinedPrompt(host.config.persona);
+        const modelCandidates = resolveModelCandidates(host.getTurnProvider().models, host.modelRegistry, host.getTurnProvider().name, host.config, mode === 'vision' ? 'vision' : 'chat');
+        const modelId = modelCandidates[0] || host.getTurnProvider().models[0] || 'gpt-4o-mini';
+        const providerAlias = host.getTurnProvider().name;
+        const llmModel = getLlmTransportModel(providerAlias, modelId);
+        const agentsContext = await buildAgentsEnvelopeContext();
+        const turnEnvelope = buildTurnContextEnvelope({
+            commMessage,
+            profileSummary: envelopeParts.profileSummary,
+            toneHint: envelopeParts.toneHint,
+            deferredStats,
+            activeSkillsContext: host.getTurnActiveSkills() || undefined,
+            quoteSystemHint: resolveQuoteSystemHint(commMessage),
+            collaborationHint: envelopeParts.collaborationHint,
+            modelLine: `${providerAlias}/${modelId}`,
+            sdk: llmModel.sdk,
+            agentsContext: agentsContext ?? undefined,
+        });
+        let userMessages = prebuiltMessages?.length
+            ? prependEnvelopeToFirstUserText(prebuiltMessages, turnEnvelope)
+            : applyTurnContextToUserMessages(turnUser.promptMessages, turnEnvelope);
+        if (extraMessages.length > 0) {
+            userMessages = [...extraMessages, ...userMessages];
+        }
+        return {
+            userMessages,
+            personaEnhanced,
+            modelCandidates,
+            modelId,
+            providerAlias,
+            turnEnvelope,
+        };
+    }
+}
+/** 每 host 独立实例 + 默认 builder/injector（与 toolSystem 一致，非全局单例）。 */
+export function createContextSystemForHost(host) {
+    const system = new ContextSystem();
+    const { builders, injectors } = createDefaultContextBuilders(host);
+    for (const builder of builders)
+        system.addBuilder(builder);
+    for (const injector of injectors)
+        system.addInjector(injector);
+    return system;
+}
+//# sourceMappingURL=context-system.js.map

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

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

package/lib/context/context-tail-limit.d.ts

@@ -0,0 +1,7 @@
+import type { ZhinAgentConfig } from '../config/index.js';
+/** 默认 agent 上下文 tail 条数（与 topic slidingWindowSize 解耦）。 */
+export declare const DEFAULT_CONTEXT_TAIL_MESSAGE_LIMIT = 80;
+/** 多 Bot 协作 Cell 推荐 tail（五角色群聊；过大易淹没模型）。 */
+export declare const COLLABORATION_CONTEXT_TAIL_MESSAGE_LIMIT = 32;
+export declare function resolveContextTailMessageLimit(config: Pick<ZhinAgentConfig, 'contextTailMessageLimit' | 'slidingWindowSize'>): number;
+//# sourceMappingURL=context-tail-limit.d.ts.map

package/lib/context/context-tail-limit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-tail-limit.d.ts","sourceRoot":"","sources":["../../src/context/context-tail-limit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,0DAA0D;AAC1D,eAAO,MAAM,kCAAkC,KAAK,CAAC;AAErD,4CAA4C;AAC5C,eAAO,MAAM,wCAAwC,KAAK,CAAC;AAE3D,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,yBAAyB,GAAG,mBAAmB,CAAC,GAC7E,MAAM,CAMR"}

package/lib/context/context-tail-limit.js

@@ -0,0 +1,12 @@
+/** 默认 agent 上下文 tail 条数（与 topic slidingWindowSize 解耦）。 */
+export const DEFAULT_CONTEXT_TAIL_MESSAGE_LIMIT = 80;
+/** 多 Bot 协作 Cell 推荐 tail（五角色群聊；过大易淹没模型）。 */
+export const COLLABORATION_CONTEXT_TAIL_MESSAGE_LIMIT = 32;
+export function resolveContextTailMessageLimit(config) {
+    if (typeof config.contextTailMessageLimit === 'number' && config.contextTailMessageLimit > 0) {
+        return config.contextTailMessageLimit;
+    }
+    // 历史误用 slidingWindowSize(=5) 作为 tail，协作场景会严重截断。
+    return Math.max(config.slidingWindowSize ?? 5, DEFAULT_CONTEXT_TAIL_MESSAGE_LIMIT);
+}
+//# sourceMappingURL=context-tail-limit.js.map

package/lib/context/context-tail-limit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-tail-limit.js","sourceRoot":"","sources":["../../src/context/context-tail-limit.ts"],"names":[],"mappings":"AAEA,0DAA0D;AAC1D,MAAM,CAAC,MAAM,kCAAkC,GAAG,EAAE,CAAC;AAErD,4CAA4C;AAC5C,MAAM,CAAC,MAAM,wCAAwC,GAAG,EAAE,CAAC;AAE3D,MAAM,UAAU,8BAA8B,CAC5C,MAA8E;IAE9E,IAAI,OAAO,MAAM,CAAC,uBAAuB,KAAK,QAAQ,IAAI,MAAM,CAAC,uBAAuB,GAAG,CAAC,EAAE,CAAC;QAC7F,OAAO,MAAM,CAAC,uBAAuB,CAAC;IACxC,CAAC;IACD,gDAAgD;IAChD,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,iBAAiB,IAAI,CAAC,EAAE,kCAAkC,CAAC,CAAC;AACrF,CAAC"}

package/lib/context/contracts.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Context System — 模块契约（与实现同步）。
+ *
+ * 实现：builder/injector 链 + `buildTextTurnContext`（turn 级编排入口）。
+ * `BuildContext.host` 为生产路径注入的 `ZhinAgentPrivate` 只读面。
+ */
+import type { AgentMessage } from '@zhin.js/ai';
+import type { Message } from '@zhin.js/core';
+import type { ZhinAgentPrivate } from '../internal/agent-host.js';
+import type { TurnEnvelopeParts } from './envelope-parts.js';
+export interface BuildContext {
+    message: Message;
+    inboundContent?: string;
+    sessionKey?: string;
+    /** 生产 turn 路径注入；builder 写入 envelope 片段 */
+    host?: ZhinAgentPrivate;
+    envelope?: Partial<TurnEnvelopeParts>;
+}
+export interface InjectContext {
+    message: Message;
+    inboundContent?: string;
+    envelope?: Partial<TurnEnvelopeParts>;
+}
+export interface ContextBuilder {
+    name: string;
+    build(context: BuildContext): Promise<AgentMessage[]>;
+}
+export interface ContextInjector {
+    name: string;
+    inject(messages: AgentMessage[], context: InjectContext): AgentMessage[];
+}
+export interface ContextSystemConfig {
+}
+//# sourceMappingURL=contracts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/context/contracts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,aAAa,GAAG,YAAY,EAAE,CAAC;CAC1E;AAED,MAAM,WAAW,mBAAmB;CAEnC"}

package/lib/context/contracts.js

@@ -0,0 +1,8 @@
+/**
+ * Context System — 模块契约（与实现同步）。
+ *
+ * 实现：builder/injector 链 + `buildTextTurnContext`（turn 级编排入口）。
+ * `BuildContext.host` 为生产路径注入的 `ZhinAgentPrivate` 只读面。
+ */
+export {};
+//# sourceMappingURL=contracts.js.map

package/lib/context/contracts.js.map

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

package/lib/context/default-builders.d.ts

@@ -0,0 +1,24 @@
+import { type AgentMessage } from '@zhin.js/ai';
+import type { ZhinAgentPrivate } from '../internal/agent-host.js';
+import type { BuildContext, ContextBuilder, ContextInjector, InjectContext } from './contracts.js';
+export declare class ProfileContextBuilder implements ContextBuilder {
+    private readonly host;
+    name: string;
+    constructor(host: ZhinAgentPrivate);
+    build(context: BuildContext): Promise<AgentMessage[]>;
+}
+export declare class CollaborationContextBuilder implements ContextBuilder {
+    name: string;
+    build(context: BuildContext): Promise<AgentMessage[]>;
+}
+export declare class ToneInjector implements ContextInjector {
+    private readonly host;
+    name: string;
+    constructor(host: ZhinAgentPrivate);
+    inject(messages: AgentMessage[], context: InjectContext): AgentMessage[];
+}
+export declare function createDefaultContextBuilders(host: ZhinAgentPrivate): {
+    builders: ContextBuilder[];
+    injectors: ContextInjector[];
+};
+//# sourceMappingURL=default-builders.d.ts.map

package/lib/context/default-builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-builders.d.ts","sourceRoot":"","sources":["../../src/context/default-builders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAc,MAAM,aAAa,CAAC;AAE5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACnG,qBAAa,qBAAsB,YAAW,cAAc;IAG9C,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,IAAI,SAAa;gBAEY,IAAI,EAAE,gBAAgB;IAE7C,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAS5D;AAED,qBAAa,2BAA4B,YAAW,cAAc;IAChE,IAAI,SAAmB;IAEjB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAQ5D;AAED,qBAAa,YAAa,YAAW,eAAe;IAGtC,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,IAAI,SAAU;gBAEe,IAAI,EAAE,gBAAgB;IAEnD,MAAM,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,aAAa,GAAG,YAAY,EAAE;CAQzE;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,gBAAgB,GAAG;IACpE,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,SAAS,EAAE,eAAe,EAAE,CAAC;CAC9B,CAQA"}

package/lib/context/default-builders.js

@@ -0,0 +1,56 @@
+import { detectTone } from '@zhin.js/ai';
+import { resolveCollaborationTurnHint } from '../collaboration/collaboration-context.js';
+export class ProfileContextBuilder {
+    host;
+    name = 'profile';
+    constructor(host) {
+        this.host = host;
+    }
+    async build(context) {
+        if (!context.envelope)
+            return [];
+        const userId = context.message.$sender.id || 'unknown';
+        const summary = await this.host.userProfiles.buildProfileSummary(userId);
+        if (summary?.trim()) {
+            context.envelope.profileSummary = summary;
+        }
+        return [];
+    }
+}
+export class CollaborationContextBuilder {
+    name = 'collaboration';
+    async build(context) {
+        if (!context.envelope)
+            return [];
+        const hint = resolveCollaborationTurnHint(context.message, context.inboundContent);
+        if (hint) {
+            context.envelope.collaborationHint = hint;
+        }
+        return [];
+    }
+}
+export class ToneInjector {
+    host;
+    name = 'tone';
+    constructor(host) {
+        this.host = host;
+    }
+    inject(messages, context) {
+        if (context.envelope && context.inboundContent !== undefined) {
+            context.envelope.toneHint = this.host.config.toneAwareness
+                ? detectTone(context.inboundContent).hint
+                : '';
+        }
+        return messages;
+    }
+}
+export function createDefaultContextBuilders(host) {
+    return {
+        builders: [
+            new ProfileContextBuilder(host),
+            new CollaborationContextBuilder(),
+        ],
+        injectors: [new ToneInjector(host)],
+    };
+}
+//# sourceMappingURL=default-builders.js.map

package/lib/context/default-builders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-builders.js","sourceRoot":"","sources":["../../src/context/default-builders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,UAAU,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,4BAA4B,EAAE,MAAM,2CAA2C,CAAC;AAGzF,MAAM,OAAO,qBAAqB;IAGH;IAF7B,IAAI,GAAG,SAAS,CAAC;IAEjB,YAA6B,IAAsB;QAAtB,SAAI,GAAJ,IAAI,CAAkB;IAAG,CAAC;IAEvD,KAAK,CAAC,KAAK,CAAC,OAAqB;QAC/B,IAAI,CAAC,OAAO,CAAC,QAAQ;YAAE,OAAO,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,SAAS,CAAC;QACvD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;QACzE,IAAI,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;YACpB,OAAO,CAAC,QAAQ,CAAC,cAAc,GAAG,OAAO,CAAC;QAC5C,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;CACF;AAED,MAAM,OAAO,2BAA2B;IACtC,IAAI,GAAG,eAAe,CAAC;IAEvB,KAAK,CAAC,KAAK,CAAC,OAAqB;QAC/B,IAAI,CAAC,OAAO,CAAC,QAAQ;YAAE,OAAO,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,4BAA4B,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;QACnF,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,CAAC,QAAQ,CAAC,iBAAiB,GAAG,IAAI,CAAC;QAC5C,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;CACF;AAED,MAAM,OAAO,YAAY;IAGM;IAF7B,IAAI,GAAG,MAAM,CAAC;IAEd,YAA6B,IAAsB;QAAtB,SAAI,GAAJ,IAAI,CAAkB;IAAG,CAAC;IAEvD,MAAM,CAAC,QAAwB,EAAE,OAAsB;QACrD,IAAI,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;YAC7D,OAAO,CAAC,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa;gBACxD,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,IAAI;gBACzC,CAAC,CAAC,EAAE,CAAC;QACT,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AAED,MAAM,UAAU,4BAA4B,CAAC,IAAsB;IAIjE,OAAO;QACL,QAAQ,EAAE;YACR,IAAI,qBAAqB,CAAC,IAAI,CAAC;YAC/B,IAAI,2BAA2B,EAAE;SAClC;QACD,SAAS,EAAE,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;KACpC,CAAC;AACJ,CAAC"}

package/lib/context/envelope-parts.d.ts

@@ -0,0 +1,13 @@
+/** Turn envelope 片段 — builder/injector pipeline 写入，buildTextTurnContext 读取。 */
+export interface TurnEnvelopeParts {
+    profileSummary?: string;
+    toneHint?: string;
+    deferredStats?: string;
+    activeSkillsContext?: string;
+    quoteSystemHint?: string;
+    collaborationHint?: string;
+    modelLine?: string;
+    sdk?: string;
+    agentsContext?: string;
+}
+//# sourceMappingURL=envelope-parts.d.ts.map

package/lib/context/envelope-parts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope-parts.d.ts","sourceRoot":"","sources":["../../src/context/envelope-parts.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,MAAM,WAAW,iBAAiB;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/lib/context/envelope-parts.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=envelope-parts.js.map

package/lib/context/envelope-parts.js.map

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

package/lib/context/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Context System — builder/injector 链 + turn 上下文构建。
+ */
+export type { BuildContext, InjectContext, ContextBuilder, ContextInjector, ContextSystemConfig, } from './contracts.js';
+export type { TurnEnvelopeParts } from './envelope-parts.js';
+export type { TextTurnContextInput, TextTurnContextOutput } from './context-system.js';
+export type { TurnContextEnvelopeInput } from './turn-envelope.js';
+export type { AgentsInstructionEntry } from './agents-instruction.js';
+export type { ModelResolverConfig } from './model-resolver.js';
+export { ContextSystem, createContextSystemForHost, ProfileContextBuilder, ToneInjector, CollaborationContextBuilder, createDefaultContextBuilders, } from './context-system.js';
+export { buildTurnContextEnvelope, prependTurnContextEnvelope, formatSessionContextLine, resolveQuoteSystemHint, TURN_CONTEXT_BEGIN, TURN_CONTEXT_END, } from './turn-envelope.js';
+export { buildTurnUserMessages, applyTurnContextToUserMessages, prependEnvelopeToFirstUserText, } from './turn-user-message.js';
+export { buildAgentsEnvelopeContext, collectAgentsInstructionChain, clearAgentsInstructionCache, } from './agents-instruction.js';
+export { resolveModel, resolveModelCandidates } from './model-resolver.js';
+export { DEFAULT_CONTEXT_TAIL_MESSAGE_LIMIT, COLLABORATION_CONTEXT_TAIL_MESSAGE_LIMIT, resolveContextTailMessageLimit, } from './context-tail-limit.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACV,YAAY,EACZ,aAAa,EACb,cAAc,EACd,eAAe,EACf,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,YAAY,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACvF,YAAY,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AACnE,YAAY,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACtE,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,OAAO,EACL,aAAa,EACb,0BAA0B,EAC1B,qBAAqB,EACrB,YAAY,EACZ,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,wBAAwB,EACxB,0BAA0B,EAC1B,wBAAwB,EACxB,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,qBAAqB,EACrB,8BAA8B,EAC9B,8BAA8B,GAC/B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,0BAA0B,EAC1B,6BAA6B,EAC7B,2BAA2B,GAC5B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE3E,OAAO,EACL,kCAAkC,EAClC,wCAAwC,EACxC,8BAA8B,GAC/B,MAAM,yBAAyB,CAAC"}

package/lib/context/index.js

@@ -0,0 +1,10 @@
+/**
+ * Context System — builder/injector 链 + turn 上下文构建。
+ */
+export { ContextSystem, createContextSystemForHost, ProfileContextBuilder, ToneInjector, CollaborationContextBuilder, createDefaultContextBuilders, } from './context-system.js';
+export { buildTurnContextEnvelope, prependTurnContextEnvelope, formatSessionContextLine, resolveQuoteSystemHint, TURN_CONTEXT_BEGIN, TURN_CONTEXT_END, } from './turn-envelope.js';
+export { buildTurnUserMessages, applyTurnContextToUserMessages, prependEnvelopeToFirstUserText, } from './turn-user-message.js';
+export { buildAgentsEnvelopeContext, collectAgentsInstructionChain, clearAgentsInstructionCache, } from './agents-instruction.js';
+export { resolveModel, resolveModelCandidates } from './model-resolver.js';
+export { DEFAULT_CONTEXT_TAIL_MESSAGE_LIMIT, COLLABORATION_CONTEXT_TAIL_MESSAGE_LIMIT, resolveContextTailMessageLimit, } from './context-tail-limit.js';
+//# sourceMappingURL=index.js.map

package/lib/context/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAgBH,OAAO,EACL,aAAa,EACb,0BAA0B,EAC1B,qBAAqB,EACrB,YAAY,EACZ,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,wBAAwB,EACxB,0BAA0B,EAC1B,wBAAwB,EACxB,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,qBAAqB,EACrB,8BAA8B,EAC9B,8BAA8B,GAC/B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,0BAA0B,EAC1B,6BAA6B,EAC7B,2BAA2B,GAC5B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE3E,OAAO,EACL,kCAAkC,EAClC,wCAAwC,EACxC,8BAA8B,GAC/B,MAAM,yBAAyB,CAAC"}

package/lib/context/model-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-resolver.d.ts","sourceRoot":"","sources":["../../src/context/model-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,YAAY,CAC1B,cAAc,EAAE,MAAM,EAAE,EACxB,aAAa,EAAE,aAAa,GAAG,IAAI,EACnC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,mBAAmB,EAC3B,IAAI,GAAE,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAkB,EAC1D,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAER;AAED,wBAAgB,sBAAsB,CACpC,cAAc,EAAE,MAAM,EAAE,EACxB,aAAa,EAAE,aAAa,GAAG,IAAI,EACnC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,mBAAmB,EAC3B,IAAI,GAAE,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAkB,EAC1D,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,EAAE,CAuBV"}

package/lib/context/model-resolver.js

@@ -0,0 +1,28 @@
+export function resolveModel(providerModels, modelRegistry, providerName, config, task = 'chat', preferred) {
+    return resolveModelCandidates(providerModels, modelRegistry, providerName, config, task, preferred)[0];
+}
+export function resolveModelCandidates(providerModels, modelRegistry, providerName, config, task = 'chat', preferred) {
+    const candidates = [];
+    if (preferred)
+        candidates.push(preferred);
+    if (task === 'chat' && config.chatModel && !candidates.includes(config.chatModel)) {
+        candidates.push(config.chatModel);
+    }
+    if (task === 'vision' && config.visionModel && !candidates.includes(config.visionModel)) {
+        candidates.push(config.visionModel);
+    }
+    if (modelRegistry) {
+        for (const id of modelRegistry.selectModels(providerName, task, 5)) {
+            if (providerModels.length > 0 && !providerModels.includes(id))
+                continue;
+            if (!candidates.includes(id))
+                candidates.push(id);
+        }
+    }
+    for (const id of providerModels) {
+        if (!candidates.includes(id))
+            candidates.push(id);
+    }
+    return candidates;
+}
+//# sourceMappingURL=model-resolver.js.map

package/lib/context/model-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-resolver.js","sourceRoot":"","sources":["../../src/context/model-resolver.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,YAAY,CAC1B,cAAwB,EACxB,aAAmC,EACnC,YAAoB,EACpB,MAA2B,EAC3B,OAAoD,MAAM,EAC1D,SAAkB;IAElB,OAAO,sBAAsB,CAAC,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AACzG,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,cAAwB,EACxB,aAAmC,EACnC,YAAoB,EACpB,MAA2B,EAC3B,OAAoD,MAAM,EAC1D,SAAkB;IAElB,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,IAAI,SAAS;QAAE,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC1C,IAAI,IAAI,KAAK,MAAM,IAAI,MAAM,CAAC,SAAS,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QAClF,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC;IACD,IAAI,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,WAAW,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;QACxF,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,aAAa,EAAE,CAAC;QAClB,KAAK,MAAM,EAAE,IAAI,aAAa,CAAC,YAAY,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;YACnE,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAAE,SAAS;YACxE,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAAE,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,KAAK,MAAM,EAAE,IAAI,cAAc,EAAE,CAAC;QAChC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAAE,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/lib/context/turn-envelope.d.ts

@@ -0,0 +1,20 @@
+import { type AgentTurnMessage, type Message } from '@zhin.js/core';
+export declare const TURN_CONTEXT_BEGIN = "[Turn context]";
+export declare const TURN_CONTEXT_END = "[/Turn context]";
+export interface TurnContextEnvelopeInput {
+    commMessage?: Message;
+    profileSummary?: string;
+    toneHint?: string;
+    deferredStats?: string;
+    activeSkillsContext?: string;
+    quoteSystemHint?: string;
+    collaborationHint?: string;
+    modelLine?: string;
+    sdk?: string;
+    agentsContext?: string;
+}
+export declare function formatSessionContextLine(commMessage: Message): string | null;
+export declare function resolveQuoteSystemHint(commMessage?: AgentTurnMessage): string | undefined;
+export declare function buildTurnContextEnvelope(input: TurnContextEnvelopeInput): string | null;
+export declare function prependTurnContextEnvelope(content: string, envelope: string | null | undefined): string;
+//# sourceMappingURL=turn-envelope.d.ts.map

package/lib/context/turn-envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-envelope.d.ts","sourceRoot":"","sources":["../../src/context/turn-envelope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,OAAO,EAAiE,MAAM,eAAe,CAAC;AAEnI,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AACnD,eAAO,MAAM,gBAAgB,oBAAoB,CAAC;AAElD,MAAM,WAAW,wBAAwB;IACvC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAS5E;AAED,wBAAgB,sBAAsB,CAAC,WAAW,CAAC,EAAE,gBAAgB,GAAG,MAAM,GAAG,SAAS,CAIzF;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,wBAAwB,GAAG,MAAM,GAAG,IAAI,CA0DvF;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAGvG"}