@zhin.js/agent 1.1.30 → 1.1.32

package/lib/plugin-runtime/native-file-tools.js

@@ -3,11 +3,22 @@ import * as path from 'node:path';
 import { defineAgentTool, toolFeatureId, } from '@zhin.js/tool';
 import { MAX_EDIT_FILE_SIZE, MAX_READ_FILE_SIZE, isFileStale } from '../security/file-policy.js';
 import { findActualStringInFile, preserveQuoteStyleInEdit } from './file-edit-quote-utils.js';
+import { walkWorkspaceFiles } from './file-search-scope.js';
+/** Output budgets keep one exploratory call from flooding the model context. */
+const MAX_READ_LINES = 2_000;
+const MAX_LINE_CHARS = 500;
+const MAX_LIST_ENTRIES = 500;
+const MAX_GLOB_FILES = 100;
+const DEFAULT_GREP_MATCHES = 50;
+const MAX_GREP_MATCHES = 200;
+const MAX_GREP_OUTPUT_BYTES = 24 * 1024;
+const MAX_GREP_FILE_BYTES = 2 * 1024 * 1024;
+const NARROW_HINT = 'narrow the pattern, path, or include filter to see more';
 /** Native ToolFeature definitions; no classic Tool, Message, or process cwd dependency. */
 export function createNativeFileToolFeatures() {
     return Object.freeze([
         feature('read_file', defineAgentTool({
-            description: 'Read a UTF-8 text file inside the authorized workspace with optional line slicing.',
+            description: `Read a UTF-8 text file inside the authorized workspace with optional line slicing (at most ${MAX_READ_LINES} lines per call).`,
             inputSchema: objectSchema({
                 file_path: { type: 'string', description: 'Path relative to the authorized workspace' },
                 offset: { type: 'number', description: 'Zero-based first line' },
@@ -36,13 +47,14 @@ export function createNativeFileToolFeatures() {
             execute: editFile,
         })),
         feature('list_dir', defineAgentTool({
-            description: 'List entries in a directory inside the authorized workspace.',
+            description: `List up to ${MAX_LIST_ENTRIES} entries in a directory inside the authorized workspace.`,
             inputSchema: objectSchema({ path: { type: 'string', description: 'Directory path' } }, ['path']),
             requiresApproval: 'never',
             execute: listDir,
         })),
         feature('glob', defineAgentTool({
-            description: 'Find up to 100 files matching a glob pattern inside the authorized workspace.',
+            description: `Find up to ${MAX_GLOB_FILES} files matching a glob pattern inside the authorized workspace. `
+                + 'Skips node_modules, .git, build output and .gitignore matches unless cwd points inside them.',
             inputSchema: objectSchema({
                 pattern: { type: 'string', description: 'Glob pattern such as **/*.ts' },
                 cwd: { type: 'string', description: 'Search directory inside the workspace' },
@@ -51,13 +63,15 @@ export function createNativeFileToolFeatures() {
             execute: globFiles,
         })),
         feature('grep', defineAgentTool({
-            description: 'Search UTF-8 files by regular expression inside the authorized workspace.',
+            description: 'Search UTF-8 files by a specific regular expression inside the authorized workspace. '
+                + 'Skips node_modules, .git, build output and .gitignore matches unless path points inside them. '
+                + 'To view a whole file use read_file; to find files use glob or list_dir.',
             inputSchema: objectSchema({
                 pattern: { type: 'string', description: 'Regular expression' },
                 path: { type: 'string', description: 'File or directory to search' },
                 include: { type: 'string', description: 'Optional file glob' },
                 ignore_case: { type: 'boolean' },
-                limit: { type: 'number', description: 'Maximum matching lines' },
+                limit: { type: 'number', description: `Maximum matching lines (default ${DEFAULT_GREP_MATCHES}, max ${MAX_GREP_MATCHES})` },
             }, ['pattern']),
             requiresApproval: 'never',
             execute: grepFiles,
@@ -80,10 +94,16 @@ async function readFile(input, context) {
     const content = await fs.readFile(target, { encoding: 'utf8', signal: context.signal });
     const lines = content.split('\n');
     const offset = nonNegativeInteger(input.offset, 0);
-    const limit = nonNegativeInteger(input.limit, lines.length);
-    const sliced = lines.slice(offset, offset + limit);
-    const numbered = sliced.map((line, index) => `${offset + index + 1} | ${line}`).join('\n');
-    return `File: ${target} (${lines.length} lines, showing ${offset + 1}-${Math.min(offset + limit, lines.length)})\n${numbered}`;
+    const limit = Math.min(nonNegativeInteger(input.limit, MAX_READ_LINES), MAX_READ_LINES);
+    const end = Math.min(offset + limit, lines.length);
+    const numbered = lines.slice(offset, end)
+        .map((line, index) => `${offset + index + 1} | ${clipLine(line)}`)
+        .join('\n');
+    const header = `File: ${target} (${lines.length} lines, showing ${offset + 1}-${end})`;
+    const more = end < lines.length
+        ? `\n[${lines.length - end} more lines; call read_file again with offset=${end} to continue]`
+        : '';
+    return `${header}\n${numbered}${more}`;
 }
 async function writeFile(input, context) {
     const target = authorizedAbsolutePath(input.file_path, context);
@@ -120,78 +140,125 @@ async function listDir(input, context) {
     const target = authorizedAbsolutePath(input.path, context);
     context.signal.throwIfAborted();
     const entries = await fs.readdir(target, { withFileTypes: true });
-    return entries.length === 0
-        ? `Directory ${target} is empty`
-        : entries.sort((left, right) => left.name.localeCompare(right.name))
-            .map((entry) => `${entry.isDirectory() ? '[DIR]  ' : '       '}${entry.name}`)
-            .join('\n');
+    if (entries.length === 0)
+        return `Directory ${target} is empty`;
+    const listed = entries.sort((left, right) => left.name.localeCompare(right.name))
+        .slice(0, MAX_LIST_ENTRIES)
+        .map((entry) => `${entry.isDirectory() ? '[DIR]  ' : '       '}${entry.name}`)
+        .join('\n');
+    return entries.length > MAX_LIST_ENTRIES
+        ? `${listed}\n[truncated: showing ${MAX_LIST_ENTRIES} of ${entries.length} entries; use glob with a narrower pattern]`
+        : listed;
 }
 async function globFiles(input, context) {
     const root = authorizedAbsolutePath(input.cwd, context);
     const pattern = requiredString(input.pattern, 'pattern');
     const matches = [];
     const matcher = globMatcher(pattern);
-    for await (const file of walkFiles(root, context.signal)) {
+    let truncated = false;
+    for await (const file of walkWorkspaceFiles(root, workspaceRootOf(context), context.signal)) {
         const relative = slash(path.relative(root, file));
-        if (matcher.test(relative))
-            matches.push(relative);
-        if (matches.length >= 100)
+        if (!matcher.test(relative))
+            continue;
+        if (matches.length >= MAX_GLOB_FILES) {
+            truncated = true;
             break;
+        }
+        matches.push(relative);
     }
-    return matches.length === 0
-        ? `No files matching '${pattern}'`
-        : `Found ${matches.length} files:\n${matches.join('\n')}`;
+    if (matches.length === 0)
+        return `No files matching '${pattern}'`;
+    const notice = truncated ? `\n[truncated at ${MAX_GLOB_FILES} files; ${NARROW_HINT}]` : '';
+    return `Found ${matches.length} files:\n${matches.join('\n')}${notice}`;
 }
 async function grepFiles(input, context) {
     const root = authorizedAbsolutePath(input.path, context);
     const pattern = requiredString(input.pattern, 'pattern');
     const expression = new RegExp(pattern, input.ignore_case === true ? 'i' : undefined);
+    assertSelectivePattern(pattern, expression);
     const include = typeof input.include === 'string' && input.include.trim()
         ? globMatcher(input.include)
         : undefined;
-    const limit = Math.max(1, nonNegativeInteger(input.limit, 50));
+    const limit = Math.min(Math.max(1, nonNegativeInteger(input.limit, DEFAULT_GREP_MATCHES)), MAX_GREP_MATCHES);
     const stat = await fs.stat(root);
-    const files = stat.isDirectory() ? walkFiles(root, context.signal) : singleFile(root);
+    const files = stat.isDirectory()
+        ? walkWorkspaceFiles(root, workspaceRootOf(context), context.signal)
+        : singleFile(root);
     const matches = [];
-    for await (const file of files) {
+    let bytes = 0;
+    let truncated;
+    search: for await (const file of files) {
         context.signal.throwIfAborted();
         if (include && !include.test(path.basename(file)))
             continue;
-        let content;
-        try {
-            content = await fs.readFile(file, { encoding: 'utf8', signal: context.signal });
-        }
-        catch {
+        const content = await readSearchableText(file, context.signal);
+        if (content === undefined)
             continue;
-        }
         const lines = content.split('\n');
         for (let index = 0; index < lines.length; index += 1) {
-            expression.lastIndex = 0;
-            if (expression.test(lines[index]))
-                matches.push(`${slash(path.relative(root, file) || path.basename(file))}:${index + 1}:${lines[index]}`);
-            if (matches.length >= limit)
-                break;
+            if (!expression.test(lines[index]))
+                continue;
+            const match = `${slash(path.relative(root, file) || path.basename(file))}:${index + 1}:${clipLine(lines[index])}`;
+            if (matches.length >= limit) {
+                truncated = `${limit} matches`;
+                break search;
+            }
+            bytes += Buffer.byteLength(match) + 1;
+            if (bytes > MAX_GREP_OUTPUT_BYTES) {
+                truncated = `${MAX_GREP_OUTPUT_BYTES} bytes`;
+                break search;
+            }
+            matches.push(match);
         }
-        if (matches.length >= limit)
-            break;
     }
-    return matches.length === 0 ? `No matches for '${pattern}'` : matches.join('\n');
-}
-async function* walkFiles(root, signal) {
-    const entries = await fs.readdir(root, { withFileTypes: true });
-    entries.sort((left, right) => left.name.localeCompare(right.name));
-    for (const entry of entries) {
-        signal.throwIfAborted();
-        const target = path.join(root, entry.name);
-        if (entry.isDirectory())
-            yield* walkFiles(target, signal);
-        else if (entry.isFile())
-            yield target;
+    if (matches.length === 0)
+        return `No matches for '${pattern}'`;
+    return truncated
+        ? `${matches.join('\n')}\n[truncated at ${truncated}; ${NARROW_HINT}]`
+        : matches.join('\n');
+}
+/**
+ * A pattern that matches the empty string matches every line of every file:
+ * it dumps whole trees into context instead of locating anything.
+ */
+function assertSelectivePattern(pattern, expression) {
+    if (!expression.test(''))
+        return;
+    throw new Error(`grep pattern '${pattern}' matches every line, so it cannot locate anything. `
+        + 'Use read_file to view a file, glob or list_dir to find files, '
+        + 'or give grep a specific text or regular expression to look for.');
+}
+/** Skip oversized and binary files: they are never useful grep context. */
+async function readSearchableText(file, signal) {
+    try {
+        const stat = await fs.stat(file);
+        if (stat.size > MAX_GREP_FILE_BYTES)
+            return undefined;
+        const buffer = await fs.readFile(file, { signal });
+        if (buffer.subarray(0, 8_192).includes(0))
+            return undefined;
+        return buffer.toString('utf8');
+    }
+    catch (error) {
+        if (signal.aborted)
+            throw error;
+        return undefined;
     }
 }
+function clipLine(line) {
+    return line.length > MAX_LINE_CHARS
+        ? `${line.slice(0, MAX_LINE_CHARS)}… [line truncated, ${line.length} chars]`
+        : line;
+}
 async function* singleFile(file) {
     yield file;
 }
+function workspaceRootOf(context) {
+    const workspaceRoot = context.policy.filesystem?.workspaceRoot;
+    if (!workspaceRoot)
+        throw new Error('File input was not authorized by TurnToolRuntime');
+    return workspaceRoot;
+}
 function authorizedAbsolutePath(value, context) {
     const target = requiredString(value ?? context.policy.filesystem?.workspaceRoot, 'path');
     const workspaceRoot = context.policy.filesystem?.workspaceRoot;
@@ -220,8 +287,10 @@ function globMatcher(pattern) {
     for (let index = 0; index < pattern.length; index += 1) {
         const character = pattern[index];
         if (character === '*' && pattern[index + 1] === '*') {
-            source += '.*';
-            index += 1;
+            // `**/` also matches zero directories, so `**/package.json` finds the root manifest.
+            const spansSeparator = pattern[index + 2] === '/';
+            source += spansSeparator ? '(?:.*/)?' : '.*';
+            index += spansSeparator ? 2 : 1;
         }
         else if (character === '*')
             source += '[^/]*';

package/lib/plugin-runtime/native-file-tools.js.map

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

package/lib/plugin-runtime/native-semantic-memory-tools.d.ts

@@ -1,17 +1,43 @@
-import { type MemoryEntryRecord, type MemoryEntryRepository, type MemoryEntrySearchInput, type MemoryEntryUpsertInput } from '@zhin.js/ai';
+import { type MemoryEntryListInput, type MemoryEntryLocator, type MemoryEntryRecord, type MemoryEntryRepository, type MemoryEntrySearchInput, type MemoryEntryUpsertInput } from '@zhin.js/ai';
 import { toolFeatureId, type AgentToolDefinition } from '@zhin.js/tool';
+import { type RecallResult, type RecallTurnView, type SemanticRecallOptions } from '../memory/semantic-recall.js';
 import { type NativeSearchDecisionResolver } from '../decision/retrieval.js';
 export interface NativeSemanticMemoryToolFeature {
     readonly feature: typeof toolFeatureId;
     readonly name: string;
     readonly definition: Readonly<AgentToolDefinition<Record<string, unknown>, string>>;
 }
+export interface SemanticMemoryRuntimeOptions {
+    /**
+     * Whether the task a `task_state` entry is bound to still exists. When it
+     * returns false the entry is hidden from recall (it also expires by TTL).
+     * Without a resolver, bound task state lives until its TTL.
+     */
+    readonly isTaskActive?: (taskId: string) => boolean;
+    /** Per-turn recall (#734); see `ai.memory.semantic.recall`. */
+    readonly recall?: SemanticRecallOptions;
+}
 /** Candidate-owned semantic-memory authority. It becomes ready during required DB activation. */
 export declare class SemanticMemoryRuntime {
     #private;
+    constructor(options?: SemanticMemoryRuntimeOptions);
     activate(repository: MemoryEntryRepository): void;
     dispose(): void;
     search(input: MemoryEntrySearchInput, signal: AbortSignal): Promise<MemoryEntryRecord[]>;
+    find(locator: MemoryEntryLocator, signal: AbortSignal): Promise<MemoryEntryRecord | null>;
+    /** Whether the database repository is active (recall is skipped otherwise). */
+    get active(): boolean;
+    /**
+     * BM25 top-k memory relevant to `query`, rendered within the recall budget.
+     * Returns null when recall is off, the runtime is inactive, or nothing matches.
+     */
+    recall(view: RecallTurnView, query: string, signal: AbortSignal): Promise<RecallResult | null>;
+    /** Live entries in one scope, newest first (management view). */
+    list(input: MemoryEntryListInput, signal: AbortSignal): Promise<MemoryEntryRecord[]>;
+    /** Deletes one entry; it is never recalled again. */
+    delete(id: string, signal: AbortSignal): Promise<boolean>;
+    /** Best-effort recall bookkeeping; never fails the search that triggered it. */
+    markUsed(ids: readonly string[]): Promise<void>;
     upsert(input: MemoryEntryUpsertInput, signal: AbortSignal): Promise<MemoryEntryRecord>;
 }
 export declare function createNativeSemanticMemoryToolFeatures(runtime: SemanticMemoryRuntime, resolveDecision?: NativeSearchDecisionResolver): readonly NativeSemanticMemoryToolFeature[];

package/lib/plugin-runtime/native-semantic-memory-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"native-semantic-memory-tools.d.ts","sourceRoot":"","sources":["../../src/plugin-runtime/native-semantic-memory-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAE1B,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC5B,MAAM,aAAa,CAAC;AACrB,OAAO,EAEL,aAAa,EACb,KAAK,mBAAmB,EAEzB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAgD,KAAK,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAE3H,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,OAAO,EAAE,OAAO,aAAa,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,mBAAmB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;CACrF;AAED,iGAAiG;AACjG,qBAAa,qBAAqB;;IAGhC,QAAQ,CAAC,UAAU,EAAE,qBAAqB,GAAG,IAAI;IAKjD,OAAO,IAAI,IAAI;IAIT,MAAM,CAAC,KAAK,EAAE,sBAAsB,EAAE,MAAM,EAAE,WAAW;IAOzD,MAAM,CAAC,KAAK,EAAE,sBAAsB,EAAE,MAAM,EAAE,WAAW;CAWhE;AAED,wBAAgB,sCAAsC,CACpD,OAAO,EAAE,qBAAqB,EAC9B,eAAe,CAAC,EAAE,4BAA4B,GAC7C,SAAS,+BAA+B,EAAE,CAkC5C"}
+{"version":3,"file":"native-semantic-memory-tools.d.ts","sourceRoot":"","sources":["../../src/plugin-runtime/native-semantic-memory-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAE1B,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC5B,MAAM,aAAa,CAAC;AACrB,OAAO,EAEL,aAAa,EACb,KAAK,mBAAmB,EAEzB,MAAM,eAAe,CAAC;AACvB,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC3B,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAgD,KAAK,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAE3H,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,OAAO,EAAE,OAAO,aAAa,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,mBAAmB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;CACrF;AAED,MAAM,WAAW,4BAA4B;IAC3C;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IACpD,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,CAAC,EAAE,qBAAqB,CAAC;CACzC;AAED,iGAAiG;AACjG,qBAAa,qBAAqB;;gBAIpB,OAAO,GAAE,4BAAiC;IAItD,QAAQ,CAAC,UAAU,EAAE,qBAAqB,GAAG,IAAI;IAKjD,OAAO,IAAI,IAAI;IAIT,MAAM,CAAC,KAAK,EAAE,sBAAsB,EAAE,MAAM,EAAE,WAAW;IAUzD,IAAI,CAAC,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,WAAW;IAK3D,+EAA+E;IAC/E,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED;;;OAGG;IACG,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAOpG,iEAAiE;IAC3D,IAAI,CAAC,KAAK,EAAE,oBAAoB,EAAE,MAAM,EAAE,WAAW;IAK3D,qDAAqD;IAC/C,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAK/D,gFAAgF;IAC1E,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAS/C,MAAM,CAAC,KAAK,EAAE,sBAAsB,EAAE,MAAM,EAAE,WAAW;CAWhE;AAED,wBAAgB,sCAAsC,CACpD,OAAO,EAAE,qBAAqB,EAC9B,eAAe,CAAC,EAAE,4BAA4B,GAC7C,SAAS,+BAA+B,EAAE,CAqC5C"}

package/lib/plugin-runtime/native-semantic-memory-tools.js

@@ -1,9 +1,16 @@
-import { parseMemoryTags, } from '@zhin.js/ai';
+import { isMemoryEntryKind, MEMORY_ENTRY_KINDS, parseMemoryTags, } from '@zhin.js/ai';
 import { defineAgentTool, toolFeatureId, } from '@zhin.js/tool';
+import { recallRelevantMemory, } from '../memory/semantic-recall.js';
+import { resolveTurnTrustLevel } from '../security/trust-level.js';
+import { decideMemoryWrite, defaultMemoryScope, memoryExpiry } from '../memory/memory-write-policy.js';
 import { rerankDecisionMatches, resolveSearchDecision } from '../decision/retrieval.js';
 /** Candidate-owned semantic-memory authority. It becomes ready during required DB activation. */
 export class SemanticMemoryRuntime {
     #repository;
+    #options;
+    constructor(options = {}) {
+        this.#options = options;
+    }
     activate(repository) {
         if (this.#repository)
             throw new Error('Semantic memory runtime is already active');
@@ -16,8 +23,52 @@ export class SemanticMemoryRuntime {
         signal.throwIfAborted();
         const result = await this.#requireRepository().search(input);
         signal.throwIfAborted();
+        const isTaskActive = this.#options.isTaskActive;
+        return isTaskActive
+            ? result.filter((entry) => entry.kind !== 'task_state' || !entry.task_id || isTaskActive(entry.task_id))
+            : result;
+    }
+    async find(locator, signal) {
+        signal.throwIfAborted();
+        return this.#requireRepository().find(locator);
+    }
+    /** Whether the database repository is active (recall is skipped otherwise). */
+    get active() {
+        return this.#repository !== undefined;
+    }
+    /**
+     * BM25 top-k memory relevant to `query`, rendered within the recall budget.
+     * Returns null when recall is off, the runtime is inactive, or nothing matches.
+     */
+    async recall(view, query, signal) {
+        if (!this.#repository)
+            return null;
+        const result = await recallRelevantMemory(this, view, query, signal, this.#options.recall);
+        if (result)
+            await this.markUsed(result.entries.map((entry) => entry.id));
         return result;
     }
+    /** Live entries in one scope, newest first (management view). */
+    async list(input, signal) {
+        signal.throwIfAborted();
+        return this.#requireRepository().list(input);
+    }
+    /** Deletes one entry; it is never recalled again. */
+    async delete(id, signal) {
+        signal.throwIfAborted();
+        return this.#requireRepository().delete(id);
+    }
+    /** Best-effort recall bookkeeping; never fails the search that triggered it. */
+    async markUsed(ids) {
+        if (ids.length === 0)
+            return;
+        try {
+            await this.#requireRepository().markUsed(ids);
+        }
+        catch {
+            // last_used_at is advisory.
+        }
+    }
     async upsert(input, signal) {
         signal.throwIfAborted();
         const result = await this.#requireRepository().upsert(input);
@@ -47,16 +98,19 @@ export function createNativeSemanticMemoryToolFeatures(runtime, resolveDecision)
             execute: (input, context) => searchMemory(runtime, input, context, resolveDecision),
         })),
         feature('memory_upsert', defineAgentTool({
-            description: 'Create or update one durable semantic-memory fact in an authorized scope.',
+            description: 'Create or update one durable semantic-memory entry in an authorized scope. '
+                + 'kind: user_fact (stable fact), preference, task_state (temporary, expires), episodic (a past event).',
             inputSchema: Object.freeze({
                 type: 'object',
                 properties: Object.freeze({
                     key: Object.freeze({ type: 'string' }),
                     content: Object.freeze({ type: 'string' }),
                     scope: Object.freeze({ type: 'string', enum: Object.freeze(['global', 'platform', 'session', 'user']) }),
+                    kind: Object.freeze({ type: 'string', enum: MEMORY_ENTRY_KINDS }),
                     tags: Object.freeze({ type: 'array', items: Object.freeze({ type: 'string' }), maxItems: 20 }),
-                    source: Object.freeze({ type: 'string' }),
                     confidence: Object.freeze({ type: 'number', minimum: 0, maximum: 1 }),
+                    task_id: Object.freeze({ type: 'string', description: 'Task a task_state entry belongs to.' }),
+                    ttl_hours: Object.freeze({ type: 'number', minimum: 0, description: 'Expiry; task_state defaults to 24h (max 168h).' }),
                 }),
                 required: Object.freeze(['key', 'content']),
             }),
@@ -82,9 +136,11 @@ async function searchMemory(runtime, input, context, resolveDecision) {
     const hits = await rerankDecisionMatches(decision, query, candidates, entry => `${entry.key}: ${entry.content}\nTags: ${parseMemoryTags(entry.tags).join(', ')}`, limit, context.signal);
     if (hits.length === 0)
         return `未找到与 "${query}" 相关的记忆条目。`;
+    await runtime.markUsed(hits.map((entry) => entry.id));
     return `找到 ${hits.length} 条记忆：\n${hits.map((entry) => {
         const tags = parseMemoryTags(entry.tags);
         return `- [${entry.scope}${entry.scope_key ? `:${entry.scope_key}` : ''}] ${entry.key}=${entry.content}`
+            + (entry.kind !== 'user_fact' ? ` (${entry.kind})` : '')
             + (tags.length ? ` (tags: ${tags.join(', ')})` : '');
     }).join('\n')}`;
 }
@@ -129,19 +185,34 @@ async function searchVisibleMemory(runtime, query, limit, context) {
 async function upsertMemory(runtime, input, context) {
     const key = requiredString(input.key, 'key');
     const content = requiredString(input.content, 'content');
-    const scope = optionalScope(input.scope) ?? 'global';
+    const level = resolveTurnTrustLevel(context);
+    const scope = optionalScope(input.scope) ?? defaultMemoryScope(level);
+    const kind = optionalKind(input.kind) ?? 'user_fact';
     const tags = Array.isArray(input.tags) ? input.tags.map(String) : undefined;
     const confidence = typeof input.confidence === 'number' ? input.confidence : 1;
+    const ttlHours = typeof input.ttl_hours === 'number' ? input.ttl_hours : undefined;
+    const taskId = kind === 'task_state' && typeof input.task_id === 'string' ? input.task_id.trim() : '';
+    const locator = { scope, scope_key: scopeKey(scope, context), key };
+    const existing = await runtime.find(locator, context.signal);
+    const decision = decideMemoryWrite({ level, scope, kind, existing });
+    if (!decision.allowed)
+        return `未写入记忆：${decision.reason}`;
+    const expiresAt = memoryExpiry(kind, ttlHours, Date.now());
     const record = await runtime.upsert({
-        scope,
-        scope_key: scopeKey(scope, context),
-        key,
+        ...locator,
         content,
         tags,
-        source: typeof input.source === 'string' ? input.source : 'tool:memory_upsert',
+        kind,
+        // Attribution comes from the turn, never from model input.
+        source: `turn:${context.turnId}`,
+        source_turn: context.turnId,
+        trust_level: level,
+        task_id: taskId,
         confidence,
+        ...(expiresAt !== undefined ? { expires_at: expiresAt } : {}),
     }, context.signal);
-    return `已写入记忆 ${record.id}: [${record.scope}] ${record.key}=${record.content}`;
+    const replaced = existing && existing.content !== record.content ? '（已覆盖旧值，旧版本保留在历史中）' : '';
+    return `已写入记忆 ${record.id}: [${record.scope}] ${record.key}=${record.content}${replaced}`;
 }
 function scopeKey(scope, context) {
     if (scope === 'global')
@@ -162,6 +233,13 @@ function optionalScope(value) {
         return value;
     throw new TypeError('scope must be global, platform, session, or user');
 }
+function optionalKind(value) {
+    if (value === undefined)
+        return undefined;
+    if (isMemoryEntryKind(value))
+        return value;
+    throw new TypeError(`kind must be one of ${MEMORY_ENTRY_KINDS.join(', ')}`);
+}
 function requiredString(value, field) {
     if (typeof value !== 'string' || !value.trim())
         throw new TypeError(`${field} must be a non-empty string`);

package/lib/plugin-runtime/native-semantic-memory-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"native-semantic-memory-tools.js","sourceRoot":"","sources":["../../src/plugin-runtime/native-semantic-memory-tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"native-semantic-memory-tools.js","sourceRoot":"","sources":["../../src/plugin-runtime/native-semantic-memory-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,GAShB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,eAAe,EACf,aAAa,GAGd,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,oBAAoB,GAIrB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACvG,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAqC,MAAM,0BAA0B,CAAC;AAmB3H,iGAAiG;AACjG,MAAM,OAAO,qBAAqB;IAChC,WAAW,CAAoC;IACtC,QAAQ,CAA+B;IAEhD,YAAY,UAAwC,EAAE;QACpD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED,QAAQ,CAAC,UAAiC;QACxC,IAAI,IAAI,CAAC,WAAW;YAAE,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QACnF,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;IAChC,CAAC;IAED,OAAO;QACL,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAA6B,EAAE,MAAmB;QAC7D,MAAM,CAAC,cAAc,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7D,MAAM,CAAC,cAAc,EAAE,CAAC;QACxB,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;QAChD,OAAO,YAAY;YACjB,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,YAAY,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACxG,CAAC,CAAC,MAAM,CAAC;IACb,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAA2B,EAAE,MAAmB;QACzD,MAAM,CAAC,cAAc,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,kBAAkB,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACjD,CAAC;IAED,+EAA+E;IAC/E,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC;IACxC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM,CAAC,IAAoB,EAAE,KAAa,EAAE,MAAmB;QACnE,IAAI,CAAC,IAAI,CAAC,WAAW;YAAE,OAAO,IAAI,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC3F,IAAI,MAAM;YAAE,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;QACzE,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,iEAAiE;IACjE,KAAK,CAAC,IAAI,CAAC,KAA2B,EAAE,MAAmB;QACzD,MAAM,CAAC,cAAc,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,kBAAkB,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC;IAED,qDAAqD;IACrD,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,MAAmB;QAC1C,MAAM,CAAC,cAAc,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,kBAAkB,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,gFAAgF;IAChF,KAAK,CAAC,QAAQ,CAAC,GAAsB;QACnC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC7B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAChD,CAAC;QAAC,MAAM,CAAC;YACP,4BAA4B;QAC9B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAA6B,EAAE,MAAmB;QAC7D,MAAM,CAAC,cAAc,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7D,MAAM,CAAC,cAAc,EAAE,CAAC;QACxB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,kBAAkB;QAChB,IAAI,CAAC,IAAI,CAAC,WAAW;YAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QACjF,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,UAAU,sCAAsC,CACpD,OAA8B,EAC9B,eAA8C;IAE9C,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,OAAO,CAAC,eAAe,EAAE,eAAe,CAAC;YACvC,WAAW,EAAE,0EAA0E;YACvF,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC;gBACzB,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC;oBACxB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;oBACxC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;oBACxG,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;iBAClE,CAAC;gBACF,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC;aACnC,CAAC;YACF,gBAAgB,EAAE,OAAO;YACzB,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,eAAe,CAAC;SACpF,CAAC,CAAC;QACH,OAAO,CAAC,eAAe,EAAE,eAAe,CAAC;YACvC,WAAW,EAAE,6EAA6E;kBACtF,sGAAsG;YAC1G,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC;gBACzB,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC;oBACxB,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;oBACtC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;oBAC1C,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;oBACxG,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC;oBACjE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;oBAC9F,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;oBACrE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qCAAqC,EAAE,CAAC;oBAC9F,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,gDAAgD,EAAE,CAAC;iBACxH,CAAC;gBACF,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;aAC5C,CAAC;YACF,gBAAgB,EAAE,SAAS;YAC3B,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC;SACnE,CAAC,CAAC;KACJ,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,YAAY,CACzB,OAA8B,EAC9B,KAA8B,EAC9B,OAA6B,EAC7B,eAA8C;IAE9C,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvG,MAAM,QAAQ,GAAG,qBAAqB,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;IACjE,MAAM,cAAc,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IAC7C,MAAM,UAAU,GAAG,KAAK;QACtB,CAAC,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC;YACnB,KAAK;YACL,KAAK;YACL,SAAS,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;YACnC,KAAK,EAAE,cAAc;SACtB,EAAE,OAAO,CAAC,MAAM,CAAC;QACpB,CAAC,CAAC,MAAM,mBAAmB,CAAC,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;IACvE,MAAM,IAAI,GAAG,MAAM,qBAAqB,CAAC,QAAQ,EAAE,KAAK,EAAE,UAAU,EAClE,KAAK,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK,KAAK,CAAC,OAAO,WAAW,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACrH,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,KAAK,YAAY,CAAC;IACzD,MAAM,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IACtD,OAAO,MAAM,IAAI,CAAC,MAAM,UAAU,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACnD,MAAM,IAAI,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzC,OAAO,MAAM,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE;cACpG,CAAC,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;cACtD,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAClB,CAAC;AAED,KAAK,UAAU,mBAAmB,CAChC,OAA8B,EAC9B,KAAa,EACb,KAAa,EACb,OAA6B;IAE7B,MAAM,SAAS,GAAuD;QACpE,CAAC,SAAS,EAAE,OAAO,CAAC,UAAU,CAAC;QAC/B,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC;QACrC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI;YAC9B,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAU,CAAC;YAClD,CAAC,CAAC,EAAE,CAAC;QACP,CAAC,QAAQ,EAAE,EAAE,CAAC;KACf,CAAC;IACF,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;QACrF,KAAK;QACL,KAAK;QACL,SAAS;QACT,KAAK;KACN,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAErB,gFAAgF;IAChF,6EAA6E;IAC7E,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,MAAM,GAAwB,EAAE,CAAC;IACvC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,KAAK,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACtD,IAAI,KAAK,GAAG,KAAK,CAAC;QAClB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5B,IAAI,CAAC,KAAK;gBAAE,SAAS;YACrB,KAAK,GAAG,IAAI,CAAC;YACb,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBAAE,SAAS;YACjC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACnB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnB,IAAI,MAAM,CAAC,MAAM,KAAK,KAAK;gBAAE,MAAM;QACrC,CAAC;QACD,IAAI,CAAC,KAAK;YAAE,MAAM;IACpB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,YAAY,CACzB,OAA8B,EAC9B,KAA8B,EAC9B,OAA6B;IAE7B,MAAM,GAAG,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACzD,MAAM,KAAK,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACtE,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC;IACrD,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5E,MAAM,UAAU,GAAG,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/E,MAAM,QAAQ,GAAG,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IACnF,MAAM,MAAM,GAAG,IAAI,KAAK,YAAY,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACtG,MAAM,OAAO,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC;IAEpE,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,iBAAiB,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IACrE,IAAI,CAAC,QAAQ,CAAC,OAAO;QAAE,OAAO,SAAS,QAAQ,CAAC,MAAM,EAAE,CAAC;IAEzD,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAC3D,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC;QAClC,GAAG,OAAO;QACV,OAAO;QACP,IAAI;QACJ,IAAI;QACJ,2DAA2D;QAC3D,MAAM,EAAE,QAAQ,OAAO,CAAC,MAAM,EAAE;QAChC,WAAW,EAAE,OAAO,CAAC,MAAM;QAC3B,WAAW,EAAE,KAAK;QAClB,OAAO,EAAE,MAAM;QACf,UAAU;QACV,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9D,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACnB,MAAM,QAAQ,GAAG,QAAQ,IAAI,QAAQ,CAAC,OAAO,KAAK,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5F,OAAO,SAAS,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,OAAO,GAAG,QAAQ,EAAE,CAAC;AAC5F,CAAC;AAED,SAAS,QAAQ,CAAC,KAAuB,EAAE,OAA6B;IACtE,IAAI,KAAK,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IAClC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,UAAU,CAAC;IACnD,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC;IACzD,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;AACjC,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,UAAU,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IACxG,MAAM,IAAI,SAAS,CAAC,kDAAkD,CAAC,CAAC;AAC1E,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,iBAAiB,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3C,MAAM,IAAI,SAAS,CAAC,uBAAuB,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,cAAc,CAAC,KAAc,EAAE,KAAa;IACnD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;QAAE,MAAM,IAAI,SAAS,CAAC,GAAG,KAAK,6BAA6B,CAAC,CAAC;IAC3G,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,SAAS,OAAO,CACd,IAAY,EACZ,UAAgE;IAEhE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;AAChG,CAAC"}

package/lib/plugin-runtime/subagent-turn-capability.d.ts

@@ -0,0 +1,32 @@
+import type { AgentCore } from '../core/agent-core.js';
+import type { ZhinAgentPrivate } from '../internal/agent-host.js';
+import type { PluginAILoopHookRegistry } from '../plugin-loop-hooks.js';
+import { type TurnIngress } from '../turn/turn-ingress.js';
+import type { AgentCapabilities, ToolCapability } from './capability-ingress.js';
+export declare const SUBAGENT_TOOL_NAME = "spawn_task";
+/** Sub-agent output handed back to the parent model; the parent writes the user reply. */
+export declare const MAX_SUBAGENT_RESULT_CHARS = 4000;
+export interface SubagentModelSelection {
+    readonly modelId: string;
+    readonly modelCandidates: readonly string[];
+}
+export interface SubagentTurnCapabilityOptions {
+    readonly host: ZhinAgentPrivate;
+    readonly core: AgentCore;
+    readonly parentTurn: TurnIngress;
+    /** The parent's exact, already-authorized generation projection. */
+    readonly capabilities: AgentCapabilities;
+    readonly loopHooks?: PluginAILoopHookRegistry;
+    /** Resolved lazily: the parent's prompt (and model choice) is built after its capability plan. */
+    readonly resolveModel: () => SubagentModelSelection | undefined;
+}
+export { deriveSubagentPolicy, type SubagentPolicyNarrowing } from '../security/policy-narrowing.js';
+/**
+ * `spawn_task` for the plugin-runtime turn path: runs a synchronous child turn
+ * inside the parent turn. The child reuses the parent's origin, principal and
+ * approval/question ports, so approvals reach the same conversation and
+ * requester with typed outcomes, and an unattended parent yields an unattended
+ * child with no interactive ports. Results return to the parent model only.
+ */
+export declare function createSubagentTurnCapability(options: SubagentTurnCapabilityOptions): ToolCapability;
+//# sourceMappingURL=subagent-turn-capability.d.ts.map

package/lib/plugin-runtime/subagent-turn-capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-turn-capability.d.ts","sourceRoot":"","sources":["../../src/plugin-runtime/subagent-turn-capability.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAExE,OAAO,EAAqB,KAAK,WAAW,EAA0B,MAAM,yBAAyB,CAAC;AACtG,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAWjF,eAAO,MAAM,kBAAkB,eAAe,CAAC;AAC/C,0FAA0F;AAC1F,eAAO,MAAM,yBAAyB,OAAQ,CAAC;AAE/C,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC;IACjC,oEAAoE;IACpE,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,wBAAwB,CAAC;IAC9C,kGAAkG;IAClG,QAAQ,CAAC,YAAY,EAAE,MAAM,sBAAsB,GAAG,SAAS,CAAC;CACjE;AAED,OAAO,EAAE,oBAAoB,EAAE,KAAK,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAmBrG;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,6BAA6B,GAAG,cAAc,CA6CnG"}