@zhin.js/agent 1.1.3 → 1.1.6

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

@@ -0,0 +1,240 @@
+import * as fs from 'node:fs/promises';
+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 '../builtin/file-edit-quote-utils.js';
+/** 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.',
+            inputSchema: objectSchema({
+                file_path: { type: 'string', description: 'Path relative to the authorized workspace' },
+                offset: { type: 'number', description: 'Zero-based first line' },
+                limit: { type: 'number', description: 'Maximum lines to return' },
+            }, ['file_path']),
+            approval: 'never',
+            execute: readFile,
+        })),
+        feature('write_file', defineAgentTool({
+            description: 'Create or replace a UTF-8 file inside the authorized workspace.',
+            inputSchema: objectSchema({
+                file_path: { type: 'string', description: 'Path relative to the authorized workspace' },
+                content: { type: 'string', description: 'Complete file content' },
+            }, ['file_path', 'content']),
+            approval: 'on-risk',
+            execute: writeFile,
+        })),
+        feature('edit_file', defineAgentTool({
+            description: 'Replace one unique text occurrence in a file inside the authorized workspace.',
+            inputSchema: objectSchema({
+                file_path: { type: 'string', description: 'Path relative to the authorized workspace' },
+                old_string: { type: 'string', description: 'Unique text to replace' },
+                new_string: { type: 'string', description: 'Replacement text' },
+            }, ['file_path', 'old_string', 'new_string']),
+            approval: 'on-risk',
+            execute: editFile,
+        })),
+        feature('list_dir', defineAgentTool({
+            description: 'List entries in a directory inside the authorized workspace.',
+            inputSchema: objectSchema({ path: { type: 'string', description: 'Directory path' } }, ['path']),
+            approval: 'never',
+            execute: listDir,
+        })),
+        feature('glob', defineAgentTool({
+            description: 'Find up to 100 files matching a glob pattern inside the authorized workspace.',
+            inputSchema: objectSchema({
+                pattern: { type: 'string', description: 'Glob pattern such as **/*.ts' },
+                cwd: { type: 'string', description: 'Search directory inside the workspace' },
+            }, ['pattern']),
+            approval: 'never',
+            execute: globFiles,
+        })),
+        feature('grep', defineAgentTool({
+            description: 'Search UTF-8 files by regular expression inside the authorized workspace.',
+            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' },
+            }, ['pattern']),
+            approval: 'never',
+            execute: grepFiles,
+        })),
+    ]);
+}
+function feature(name, definition) {
+    return Object.freeze({ feature: toolFeatureId, name, definition });
+}
+async function readFile(input, context) {
+    const target = authorizedAbsolutePath(input.file_path, context);
+    context.signal.throwIfAborted();
+    const stat = await fs.stat(target);
+    if (stat.size > MAX_READ_FILE_SIZE) {
+        throw new Error(`File exceeds the ${MAX_READ_FILE_SIZE} byte read limit`);
+    }
+    if (isImageFile(target))
+        throw new Error('Use analyze_media for image files');
+    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}`;
+}
+async function writeFile(input, context) {
+    const target = authorizedAbsolutePath(input.file_path, context);
+    const content = requiredString(input.content, 'content', true);
+    context.signal.throwIfAborted();
+    await fs.mkdir(path.dirname(target), { recursive: true });
+    await fs.writeFile(target, content, { encoding: 'utf8', signal: context.signal });
+    return `Wrote ${Buffer.byteLength(content)} bytes to ${target}`;
+}
+async function editFile(input, context) {
+    const target = authorizedAbsolutePath(input.file_path, context);
+    const oldString = requiredString(input.old_string, 'old_string', true);
+    const newString = requiredString(input.new_string, 'new_string', true);
+    context.signal.throwIfAborted();
+    const stat = await fs.stat(target);
+    if (stat.size > MAX_EDIT_FILE_SIZE)
+        throw new Error(`File exceeds the ${MAX_EDIT_FILE_SIZE} byte edit limit`);
+    const content = await fs.readFile(target, { encoding: 'utf8', signal: context.signal });
+    const match = findActualStringInFile(content, oldString);
+    if (!match)
+        throw new Error('old_string not found in file');
+    if (match.count !== 1)
+        throw new Error(`old_string appears ${match.count} times; provide unique context`);
+    const replacement = match.wasNormalized
+        ? preserveQuoteStyleInEdit(oldString, match.actual, newString)
+        : newString;
+    const current = await fs.stat(target);
+    if (isFileStale(stat.mtimeMs, current.mtimeMs))
+        throw new Error('File changed during edit; read it again');
+    await fs.writeFile(target, content.replace(match.actual, replacement), { encoding: 'utf8', signal: context.signal });
+    return `Edited ${target}`;
+}
+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');
+}
+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)) {
+        const relative = slash(path.relative(root, file));
+        if (matcher.test(relative))
+            matches.push(relative);
+        if (matches.length >= 100)
+            break;
+    }
+    return matches.length === 0
+        ? `No files matching '${pattern}'`
+        : `Found ${matches.length} files:\n${matches.join('\n')}`;
+}
+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);
+    const include = typeof input.include === 'string' && input.include.trim()
+        ? globMatcher(input.include)
+        : undefined;
+    const limit = Math.max(1, nonNegativeInteger(input.limit, 50));
+    const stat = await fs.stat(root);
+    const files = stat.isDirectory() ? walkFiles(root, context.signal) : singleFile(root);
+    const matches = [];
+    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 {
+            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 (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;
+    }
+}
+async function* singleFile(file) {
+    yield file;
+}
+function authorizedAbsolutePath(value, context) {
+    const target = requiredString(value ?? context.policy.filesystem?.workspaceRoot, 'path');
+    const workspaceRoot = context.policy.filesystem?.workspaceRoot;
+    if (!workspaceRoot || !path.isAbsolute(target))
+        throw new Error('File input was not authorized by TurnToolRuntime');
+    const relative = path.relative(workspaceRoot, target);
+    if (relative === '..' || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative)) {
+        throw new Error('File input is outside the authorized workspace');
+    }
+    return target;
+}
+function requiredString(value, name, allowEmpty = false) {
+    if (typeof value !== 'string' || (!allowEmpty && !value.trim()))
+        throw new TypeError(`${name} is required`);
+    return value;
+}
+function nonNegativeInteger(value, fallback) {
+    return typeof value === 'number' && Number.isFinite(value) && value >= 0 ? Math.floor(value) : fallback;
+}
+function isImageFile(file) {
+    return new Set(['.png', '.jpg', '.jpeg', '.gif', '.webp', '.bmp', '.svg', '.ico'])
+        .has(path.extname(file).toLowerCase());
+}
+function globMatcher(pattern) {
+    let source = '^';
+    for (let index = 0; index < pattern.length; index += 1) {
+        const character = pattern[index];
+        if (character === '*' && pattern[index + 1] === '*') {
+            source += '.*';
+            index += 1;
+        }
+        else if (character === '*')
+            source += '[^/]*';
+        else if (character === '?')
+            source += '[^/]';
+        else
+            source += character.replace(/[|\\{}()[\]^$+?.]/g, '\\$&');
+    }
+    return new RegExp(`${source}$`);
+}
+function slash(value) {
+    return value.split(path.sep).join('/');
+}
+function objectSchema(properties, required) {
+    return Object.freeze({ type: 'object', properties: Object.freeze(properties), required: Object.freeze([...required]) });
+}
+//# sourceMappingURL=native-file-tools.js.map

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

@@ -0,0 +1 @@
+{"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-interaction-tools.d.ts

@@ -0,0 +1,8 @@
+import { toolFeatureId, type AgentToolDefinition } from '@zhin.js/tool';
+export interface NativeInteractionToolFeature {
+    readonly feature: typeof toolFeatureId;
+    readonly name: string;
+    readonly definition: Readonly<AgentToolDefinition<Record<string, unknown>, string>>;
+}
+export declare function createNativeInteractionToolFeatures(): readonly NativeInteractionToolFeature[];
+//# sourceMappingURL=native-interaction-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"native-interaction-tools.d.ts","sourceRoot":"","sources":["../../src/plugin-runtime/native-interaction-tools.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,aAAa,EACb,KAAK,mBAAmB,EAIzB,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,4BAA4B;IAC3C,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,wBAAgB,mCAAmC,IAAI,SAAS,4BAA4B,EAAE,CAqB7F"}

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

@@ -0,0 +1,72 @@
+import { randomUUID } from 'node:crypto';
+import { defineAgentTool, toolFeatureId, } from '@zhin.js/tool';
+export function createNativeInteractionToolFeatures() {
+    return Object.freeze([Object.freeze({
+            feature: toolFeatureId,
+            name: 'ask_user',
+            definition: defineAgentTool({
+                description: 'Ask the authenticated user a text, number, confirmation, or multiple-choice question and wait for the canonical reply.',
+                inputSchema: Object.freeze({
+                    type: 'object',
+                    properties: Object.freeze({
+                        question: Object.freeze({ type: 'string' }),
+                        type: Object.freeze({ type: 'string', enum: Object.freeze(['text', 'number', 'confirm', 'pick']) }),
+                        options: Object.freeze({ type: 'array', items: Object.freeze({ type: 'string' }) }),
+                        default_value: Object.freeze({ type: 'string' }),
+                        timeout: Object.freeze({ type: 'number', description: 'Timeout in seconds (1-300)' }),
+                    }),
+                    required: Object.freeze(['question']),
+                }),
+                approval: 'never',
+                execute: askUser,
+            }),
+        })]);
+}
+async function askUser(input, context) {
+    if (!context.question)
+        throw new Error('QuestionPort is unavailable for this Turn');
+    const question = requiredText(input.question, 'question', 4_000);
+    const type = questionType(input.type);
+    const options = type === 'pick' ? questionOptions(input.options) : undefined;
+    const timeoutSeconds = typeof input.timeout === 'number' && Number.isFinite(input.timeout)
+        ? Math.max(1, Math.min(300, Math.floor(input.timeout)))
+        : 120;
+    const answer = await context.question.ask({
+        requestId: `${context.turnId}:${randomUUID()}`,
+        question,
+        type,
+        ...(options ? { options } : {}),
+        ...(typeof input.default_value === 'string' ? { defaultValue: input.default_value } : {}),
+        timeoutMs: timeoutSeconds * 1_000,
+        signal: context.signal,
+    });
+    return formatAnswer(answer);
+}
+function questionType(value) {
+    if (value === undefined)
+        return 'text';
+    if (value === 'text' || value === 'number' || value === 'confirm' || value === 'pick')
+        return value;
+    throw new TypeError('type must be text, number, confirm, or pick');
+}
+function questionOptions(value) {
+    if (!Array.isArray(value) || value.length < 2 || value.length > 20) {
+        throw new TypeError('pick requires 2-20 options');
+    }
+    return Object.freeze(value.map((option, index) => requiredText(option, `options[${index}]`, 500)));
+}
+function requiredText(value, name, maximum) {
+    if (typeof value !== 'string' || !value.trim())
+        throw new TypeError(`${name} is required`);
+    if (value.length > maximum)
+        throw new TypeError(`${name} exceeds ${maximum} characters`);
+    return value.trim();
+}
+function formatAnswer(answer) {
+    if (answer.type === 'confirm')
+        return answer.value ? 'yes' : 'no';
+    if (answer.type === 'number')
+        return String(answer.value);
+    return answer.value;
+}
+//# sourceMappingURL=native-interaction-tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"native-interaction-tools.js","sourceRoot":"","sources":["../../src/plugin-runtime/native-interaction-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,eAAe,EACf,aAAa,GAKd,MAAM,eAAe,CAAC;AAQvB,MAAM,UAAU,mCAAmC;IACjD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;YAClC,OAAO,EAAE,aAAa;YACtB,IAAI,EAAE,UAAU;YAChB,UAAU,EAAE,eAAe,CAAC;gBAC1B,WAAW,EAAE,wHAAwH;gBACrI,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC;oBACzB,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC;wBACxB,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;wBAC3C,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;wBACnG,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;wBACnF,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;wBAChD,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE,CAAC;qBACtF,CAAC;oBACF,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC;iBACtC,CAAC;gBACF,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC,CAAC,CAAC;AACP,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,KAA8B,EAAE,OAA6B;IAClF,IAAI,CAAC,OAAO,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IACpF,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;IACjE,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7E,MAAM,cAAc,GAAG,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC;QACxF,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QACvD,CAAC,CAAC,GAAG,CAAC;IACR,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;QACxC,SAAS,EAAE,GAAG,OAAO,CAAC,MAAM,IAAI,UAAU,EAAE,EAAE;QAC9C,QAAQ;QACR,IAAI;QACJ,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/B,GAAG,CAAC,OAAO,KAAK,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzF,SAAS,EAAE,cAAc,GAAG,KAAK;QACjC,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;IACH,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IACvC,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IACpG,MAAM,IAAI,SAAS,CAAC,6CAA6C,CAAC,CAAC;AACrE,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACnE,MAAM,IAAI,SAAS,CAAC,4BAA4B,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,WAAW,KAAK,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;AACrG,CAAC;AAED,SAAS,YAAY,CAAC,KAAc,EAAE,IAAY,EAAE,OAAe;IACjE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;QAAE,MAAM,IAAI,SAAS,CAAC,GAAG,IAAI,cAAc,CAAC,CAAC;IAC3F,IAAI,KAAK,CAAC,MAAM,GAAG,OAAO;QAAE,MAAM,IAAI,SAAS,CAAC,GAAG,IAAI,YAAY,OAAO,aAAa,CAAC,CAAC;IACzF,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,SAAS,YAAY,CAAC,MAA0B;IAC9C,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAClE,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1D,OAAO,MAAM,CAAC,KAAK,CAAC;AACtB,CAAC"}

package/lib/plugin-runtime/native-todo-tools.d.ts

@@ -0,0 +1,26 @@
+import { toolFeatureId, type AgentToolDefinition } from '@zhin.js/tool';
+export type TodoStatus = 'pending' | 'in-progress' | 'done';
+export interface TodoItem {
+    readonly title: string;
+    readonly detail?: string;
+    readonly status: TodoStatus;
+}
+export interface TodoStore {
+    read(sessionKey: string, signal: AbortSignal): Promise<readonly TodoItem[]>;
+    replace(sessionKey: string, items: readonly TodoItem[], signal: AbortSignal): Promise<void>;
+}
+export interface NativeTodoToolFeature {
+    readonly feature: typeof toolFeatureId;
+    readonly name: string;
+    readonly definition: Readonly<AgentToolDefinition<Record<string, unknown>, string>>;
+}
+/** Crash-safe, session-addressed task-plan store. Callers never provide filesystem paths. */
+export declare class FileTodoStore implements TodoStore {
+    #private;
+    private readonly root;
+    constructor(root: string);
+    read(sessionKey: string, signal: AbortSignal): Promise<readonly TodoItem[]>;
+    replace(sessionKey: string, items: readonly TodoItem[], signal: AbortSignal): Promise<void>;
+}
+export declare function createNativeTodoToolFeatures(store: TodoStore): readonly NativeTodoToolFeature[];
+//# sourceMappingURL=native-todo-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"native-todo-tools.d.ts","sourceRoot":"","sources":["../../src/plugin-runtime/native-todo-tools.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,aAAa,EACb,KAAK,mBAAmB,EAEzB,MAAM,eAAe,CAAC;AAEvB,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,MAAM,CAAC;AAE5D,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC7B;AAQD,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,QAAQ,EAAE,CAAC,CAAC;IAC5E,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,QAAQ,EAAE,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7F;AAED,MAAM,WAAW,qBAAqB;IACpC,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,6FAA6F;AAC7F,qBAAa,aAAc,YAAW,SAAS;;IAGjC,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,MAAM;IAEnC,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,QAAQ,EAAE,CAAC;IAajF,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,QAAQ,EAAE,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAkC5F;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,qBAAqB,EAAE,CAiC/F"}

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

@@ -0,0 +1,152 @@
+import { createHash, randomUUID } from 'node:crypto';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { defineAgentTool, toolFeatureId, } from '@zhin.js/tool';
+/** Crash-safe, session-addressed task-plan store. Callers never provide filesystem paths. */
+export class FileTodoStore {
+    root;
+    #tails = new Map();
+    constructor(root) {
+        this.root = root;
+    }
+    async read(sessionKey, signal) {
+        signal.throwIfAborted();
+        await this.#tails.get(sessionKey);
+        try {
+            const raw = await fs.readFile(this.#file(sessionKey), { encoding: 'utf8', signal });
+            const document = parseDocument(raw, sessionKey);
+            return Object.freeze(document.items.map((item) => Object.freeze({ ...item })));
+        }
+        catch (error) {
+            if (isNotFound(error))
+                return Object.freeze([]);
+            throw error;
+        }
+    }
+    replace(sessionKey, items, signal) {
+        const previous = this.#tails.get(sessionKey) ?? Promise.resolve();
+        const operation = previous.catch(() => undefined).then(async () => {
+            signal.throwIfAborted();
+            await fs.mkdir(this.root, { recursive: true });
+            const target = this.#file(sessionKey);
+            const temporary = `${target}.${randomUUID()}.tmp`;
+            const document = Object.freeze({
+                sessionKey,
+                updatedAt: new Date().toISOString(),
+                items: Object.freeze(items.map((item) => Object.freeze({ ...item }))),
+            });
+            try {
+                await fs.writeFile(temporary, `${JSON.stringify(document, null, 2)}\n`, {
+                    encoding: 'utf8', signal, mode: 0o600,
+                });
+                signal.throwIfAborted();
+                await fs.rename(temporary, target);
+            }
+            catch (error) {
+                await fs.rm(temporary, { force: true }).catch(() => undefined);
+                throw error;
+            }
+        });
+        const settled = operation.finally(() => {
+            if (this.#tails.get(sessionKey) === settled)
+                this.#tails.delete(sessionKey);
+        });
+        this.#tails.set(sessionKey, settled);
+        return settled;
+    }
+    #file(sessionKey) {
+        const digest = createHash('sha256').update(sessionKey).digest('hex');
+        return path.join(this.root, `${digest}.json`);
+    }
+}
+export function createNativeTodoToolFeatures(store) {
+    return Object.freeze([
+        feature('todo_read', defineAgentTool({
+            description: 'Read the task plan owned by the current canonical session.',
+            inputSchema: Object.freeze({ type: 'object', properties: Object.freeze({}), required: Object.freeze([]) }),
+            approval: 'never',
+            execute: async (_input, context) => formatTodos(await store.read(context.sessionKey, context.signal)),
+        })),
+        feature('todo_write', defineAgentTool({
+            description: 'Atomically replace the task plan owned by the current canonical session.',
+            inputSchema: Object.freeze({
+                type: 'object',
+                properties: Object.freeze({
+                    items: Object.freeze({
+                        type: 'array',
+                        maxItems: 100,
+                        items: Object.freeze({
+                            type: 'object',
+                            properties: Object.freeze({
+                                title: Object.freeze({ type: 'string' }),
+                                detail: Object.freeze({ type: 'string' }),
+                                status: Object.freeze({ type: 'string', enum: Object.freeze(['pending', 'in-progress', 'done']) }),
+                            }),
+                            required: Object.freeze(['title', 'status']),
+                        }),
+                    }),
+                }),
+                required: Object.freeze(['items']),
+            }),
+            approval: 'never',
+            execute: async (input, context) => writeTodos(input, context, store),
+        })),
+    ]);
+}
+async function writeTodos(input, context, store) {
+    const items = parseItems(input.items);
+    await store.replace(context.sessionKey, items, context.signal);
+    const done = items.filter((item) => item.status === 'done').length;
+    return `Tasks updated (${done}/${items.length} done)`;
+}
+function parseItems(value) {
+    if (!Array.isArray(value))
+        throw new TypeError('items must be an array');
+    if (value.length > 100)
+        throw new TypeError('items cannot contain more than 100 tasks');
+    return Object.freeze(value.map((raw, index) => {
+        if (!raw || typeof raw !== 'object')
+            throw new TypeError(`items[${index}] must be an object`);
+        const item = raw;
+        const title = boundedText(item.title, `items[${index}].title`, 500, false);
+        const detail = item.detail === undefined ? undefined : boundedText(item.detail, `items[${index}].detail`, 4_000, true);
+        if (item.status !== 'pending' && item.status !== 'in-progress' && item.status !== 'done') {
+            throw new TypeError(`items[${index}].status is invalid`);
+        }
+        return Object.freeze({ title, ...(detail !== undefined ? { detail } : {}), status: item.status });
+    }));
+}
+function parseDocument(raw, expectedSessionKey) {
+    const value = JSON.parse(raw);
+    if (value.sessionKey !== expectedSessionKey)
+        throw new Error('TODO document session identity mismatch');
+    return Object.freeze({
+        sessionKey: expectedSessionKey,
+        updatedAt: typeof value.updatedAt === 'string' ? value.updatedAt : '',
+        items: parseItems(value.items),
+    });
+}
+function formatTodos(items) {
+    if (items.length === 0)
+        return 'No tasks found. Use todo_write to create a plan.';
+    const done = items.filter((item) => item.status === 'done').length;
+    const lines = items.map((item, index) => {
+        const status = item.status === 'done' ? '✅' : item.status === 'in-progress' ? '🔄' : '⬜';
+        return `${status} ${index + 1}. ${item.title}${item.detail ? ` — ${item.detail}` : ''}`;
+    });
+    return `Tasks (${done}/${items.length} done):\n${lines.join('\n')}`;
+}
+function boundedText(value, name, maximum, allowEmpty) {
+    if (typeof value !== 'string' || (!allowEmpty && !value.trim()))
+        throw new TypeError(`${name} is required`);
+    if (value.length > maximum)
+        throw new TypeError(`${name} exceeds ${maximum} characters`);
+    return value;
+}
+function feature(name, definition) {
+    return Object.freeze({ feature: toolFeatureId, name, definition });
+}
+function isNotFound(error) {
+    return Boolean(error && typeof error === 'object' && 'code' in error && error.code === 'ENOENT');
+}
+//# sourceMappingURL=native-todo-tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"native-todo-tools.js","sourceRoot":"","sources":["../../src/plugin-runtime/native-todo-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EACL,eAAe,EACf,aAAa,GAGd,MAAM,eAAe,CAAC;AA2BvB,6FAA6F;AAC7F,MAAM,OAAO,aAAa;IAGK;IAFpB,MAAM,GAAG,IAAI,GAAG,EAAyB,CAAC;IAEnD,YAA6B,IAAY;QAAZ,SAAI,GAAJ,IAAI,CAAQ;IAAG,CAAC;IAE7C,KAAK,CAAC,IAAI,CAAC,UAAkB,EAAE,MAAmB;QAChD,MAAM,CAAC,cAAc,EAAE,CAAC;QACxB,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAClC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YACpF,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;YAChD,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACjF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,UAAU,CAAC,KAAK,CAAC;gBAAE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAChD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,CAAC,UAAkB,EAAE,KAA0B,EAAE,MAAmB;QACzE,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QAClE,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;YAChE,MAAM,CAAC,cAAc,EAAE,CAAC;YACxB,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YACtC,MAAM,SAAS,GAAG,GAAG,MAAM,IAAI,UAAU,EAAE,MAAM,CAAC;YAClD,MAAM,QAAQ,GAAiB,MAAM,CAAC,MAAM,CAAC;gBAC3C,UAAU;gBACV,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;aACtE,CAAC,CAAC;YACH,IAAI,CAAC;gBACH,MAAM,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;oBACtE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK;iBACtC,CAAC,CAAC;gBACH,MAAM,CAAC,cAAc,EAAE,CAAC;gBACxB,MAAM,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YACrC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBAC/D,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE;YACrC,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,OAAO;gBAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC9E,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACrC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,UAAkB;QACtB,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACrE,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,MAAM,OAAO,CAAC,CAAC;IAChD,CAAC;CACF;AAED,MAAM,UAAU,4BAA4B,CAAC,KAAgB;IAC3D,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,OAAO,CAAC,WAAW,EAAE,eAAe,CAAC;YACnC,WAAW,EAAE,4DAA4D;YACzE,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;YAC1G,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;SACtG,CAAC,CAAC;QACH,OAAO,CAAC,YAAY,EAAE,eAAe,CAAC;YACpC,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;wBACnB,IAAI,EAAE,OAAO;wBACb,QAAQ,EAAE,GAAG;wBACb,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;4BACnB,IAAI,EAAE,QAAQ;4BACd,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC;gCACxB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;gCACxC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;gCACzC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;6BACnG,CAAC;4BACF,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;yBAC7C,CAAC;qBACH,CAAC;iBACH,CAAC;gBACF,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC;aACnC,CAAC;YACF,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC;SACrE,CAAC,CAAC;KACJ,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,UAAU,CACvB,KAA8B,EAC9B,OAA6B,EAC7B,KAAgB;IAEhB,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/D,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,MAAM,CAAC;IACnE,OAAO,kBAAkB,IAAI,IAAI,KAAK,CAAC,MAAM,QAAQ,CAAC;AACxD,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,wBAAwB,CAAC,CAAC;IACzE,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG;QAAE,MAAM,IAAI,SAAS,CAAC,0CAA0C,CAAC,CAAC;IACxF,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QAC5C,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,MAAM,IAAI,SAAS,CAAC,SAAS,KAAK,qBAAqB,CAAC,CAAC;QAC9F,MAAM,IAAI,GAAG,GAA8B,CAAC;QAC5C,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,KAAK,SAAS,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QAC3E,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,KAAK,UAAU,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QACvH,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,aAAa,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YACzF,MAAM,IAAI,SAAS,CAAC,SAAS,KAAK,qBAAqB,CAAC,CAAC;QAC3D,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACpG,CAAC,CAAC,CAAC,CAAC;AACN,CAAC;AAED,SAAS,aAAa,CAAC,GAAW,EAAE,kBAA0B;IAC5D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA0B,CAAC;IACvD,IAAI,KAAK,CAAC,UAAU,KAAK,kBAAkB;QAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IACxG,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,UAAU,EAAE,kBAAkB;QAC9B,SAAS,EAAE,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE;QACrE,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC;KAC/B,CAAC,CAAC;AACL,CAAC;AAED,SAAS,WAAW,CAAC,KAA0B;IAC7C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,kDAAkD,CAAC;IAClF,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,MAAM,CAAC;IACnE,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QACtC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;QACzF,OAAO,GAAG,MAAM,IAAI,KAAK,GAAG,CAAC,KAAK,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAC1F,CAAC,CAAC,CAAC;IACH,OAAO,UAAU,IAAI,IAAI,KAAK,CAAC,MAAM,YAAY,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACtE,CAAC;AAED,SAAS,WAAW,CAAC,KAAc,EAAE,IAAY,EAAE,OAAe,EAAE,UAAmB;IACrF,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,GAAG,IAAI,cAAc,CAAC,CAAC;IAC5G,IAAI,KAAK,CAAC,MAAM,GAAG,OAAO;QAAE,MAAM,IAAI,SAAS,CAAC,GAAG,IAAI,YAAY,OAAO,aAAa,CAAC,CAAC;IACzF,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,OAAO,CACd,IAAY,EACZ,UAA0E;IAE1E,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;AACrE,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,OAAO,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;AACnG,CAAC"}

package/lib/plugin-runtime/native-web-tools.d.ts

@@ -0,0 +1,10 @@
+import { toolFeatureId, type AgentToolDefinition } from '@zhin.js/tool';
+import { type NetworkTransport } from '../security/turn-network-client.js';
+export interface NativeWebToolFeature {
+    readonly feature: typeof toolFeatureId;
+    readonly name: string;
+    readonly definition: Readonly<AgentToolDefinition<Record<string, unknown>, string>>;
+}
+/** Native generation ToolFeatures backed by the Turn-scoped network module. */
+export declare function createNativeWebToolFeatures(transport?: NetworkTransport): readonly NativeWebToolFeature[];
+//# sourceMappingURL=native-web-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"native-web-tools.d.ts","sourceRoot":"","sources":["../../src/plugin-runtime/native-web-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,aAAa,EACb,KAAK,mBAAmB,EAEzB,MAAM,eAAe,CAAC;AASvB,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,oCAAoC,CAAC;AAE5C,MAAM,WAAW,oBAAoB;IACnC,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,+EAA+E;AAC/E,wBAAgB,2BAA2B,CACzC,SAAS,GAAE,gBAA6C,GACvD,SAAS,oBAAoB,EAAE,CAwBjC"}