@pellux/goodvibes-sdk 0.18.3 → 0.18.11

package/dist/platform/state/project-index.js

@@ -0,0 +1,249 @@
+import { existsSync, mkdirSync, readFileSync, renameSync, statSync, writeFileSync } from 'fs';
+import { join, dirname, sep } from 'path';
+import { logger } from '../utils/logger.js';
+import { summarizeError } from '../utils/error-display.js';
+/**
+ * ProjectIndex — In-memory project file index with token counts.
+ *
+ * Singleton per process. Loaded at startup from disk in the background.
+ * Mutations are debounced: flush happens 5 seconds after last write.
+ *
+ * Disk format: v4 tree (see DiskFormat above).
+ */
+export class ProjectIndex {
+    indexPath;
+    projectRoot;
+    baseDir;
+    files = new Map(); // path -> tokens
+    flushTimer = null;
+    createdAt = new Date().toISOString();
+    loaded = false;
+    constructor(baseDir) {
+        this.projectRoot = baseDir;
+        this.baseDir = this.projectRoot;
+        this.indexPath = join(this.projectRoot, '.goodvibes', 'project-index.json');
+    }
+    // ---------------------------------------------------------------------------
+    // Lifecycle
+    // ---------------------------------------------------------------------------
+    /**
+     * Load the index from disk.
+     * Non-blocking: called at startup, safe to call multiple times.
+     */
+    async load() {
+        if (!existsSync(this.indexPath)) {
+            this.loaded = true;
+            return;
+        }
+        try {
+            const raw = readFileSync(this.indexPath, 'utf-8');
+            const disk = JSON.parse(raw);
+            if (disk.version === 4 && disk.tree) {
+                this.createdAt = disk.created_at ?? this.createdAt;
+                this.files = flattenTree(disk.tree);
+            }
+            this.loaded = true;
+            logger.debug('ProjectIndex: loaded', { files: this.files.size });
+        }
+        catch (err) {
+            logger.debug('ProjectIndex: load failed (non-fatal)', { error: summarizeError(err) });
+            this.loaded = true;
+        }
+    }
+    /**
+     * Flush to disk immediately, bypassing debounce.
+     */
+    async forceFlush() {
+        if (this.flushTimer !== null) {
+            clearTimeout(this.flushTimer);
+            this.flushTimer = null;
+        }
+        await this.flush();
+    }
+    // ---------------------------------------------------------------------------
+    // Query
+    // ---------------------------------------------------------------------------
+    getFiles() {
+        return Array.from(this.files.entries()).map(([path, tokens]) => ({ path, tokens }));
+    }
+    getFile(path) {
+        const normalPath = this.normalizePath(path);
+        const tokens = this.files.get(normalPath);
+        if (tokens === undefined)
+            return null;
+        return { path: normalPath, tokens };
+    }
+    getFilesByPrefix(prefix) {
+        const normalPrefix = this.normalizePath(prefix);
+        const result = [];
+        for (const [path, tokens] of this.files) {
+            if (path.startsWith(normalPrefix)) {
+                result.push({ path, tokens });
+            }
+        }
+        return result;
+    }
+    /** Return count of files by extension (e.g. { ts: 42, json: 5 }). */
+    getTypeCounts() {
+        const counts = {};
+        for (const path of this.files.keys()) {
+            const dot = path.lastIndexOf('.');
+            const ext = dot >= 0 ? path.slice(dot + 1) : 'other';
+            counts[ext] = (counts[ext] ?? 0) + 1;
+        }
+        return counts;
+    }
+    getTotalTokens() {
+        let total = 0;
+        for (const tokens of this.files.values())
+            total += tokens;
+        return total;
+    }
+    // ---------------------------------------------------------------------------
+    // Mutation
+    // ---------------------------------------------------------------------------
+    /**
+     * Insert or update a file entry.
+     * If tokens is not provided, attempts to estimate from disk.
+     */
+    upsertFile(path, tokens) {
+        const normalPath = this.normalizePath(path);
+        const t = tokens ?? this.files.get(normalPath) ?? 0;
+        this.files.set(normalPath, t);
+        this.scheduleFlush();
+    }
+    /**
+     * Touch an existing file entry (update token count from disk if possible).
+     * No-op if file not in index.
+     */
+    touchFile(path) {
+        const normalPath = this.normalizePath(path);
+        if (!this.files.has(normalPath))
+            return;
+        // Update token estimate from file size if readable
+        try {
+            const size = statSync(path).size;
+            const tokens = Math.ceil(size / 4);
+            this.files.set(normalPath, tokens);
+            this.scheduleFlush();
+        }
+        catch {
+            // Non-fatal: leave existing value
+        }
+    }
+    removeFile(path) {
+        const normalPath = this.normalizePath(path);
+        if (this.files.delete(normalPath)) {
+            this.scheduleFlush();
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Private helpers
+    // ---------------------------------------------------------------------------
+    normalizePath(inputPath) {
+        let p = inputPath.split(sep).join('/');
+        // Strip project root prefix for absolute paths
+        const root = this.baseDir.split(sep).join('/');
+        if (p.startsWith(root + '/')) {
+            p = p.slice(root.length + 1);
+        }
+        p = p.replace(/^\.\//, '');
+        return p;
+    }
+    async dispose() {
+        if (this.flushTimer !== null) {
+            clearTimeout(this.flushTimer);
+            this.flushTimer = null;
+        }
+        await this.forceFlush();
+    }
+    scheduleFlush() {
+        if (this.flushTimer !== null)
+            clearTimeout(this.flushTimer);
+        this.flushTimer = setTimeout(() => {
+            this.flushTimer = null;
+            this.flush().catch(err => {
+                logger.debug('ProjectIndex: scheduled flush failed', { error: summarizeError(err) });
+            });
+        }, 5000);
+    }
+    async flush() {
+        try {
+            mkdirSync(dirname(this.indexPath), { recursive: true });
+            const tree = buildTree(this.files);
+            const totalFiles = this.files.size;
+            // Count dirs
+            const dirs = new Set();
+            for (const path of this.files.keys()) {
+                const parts = path.split('/');
+                for (let i = 1; i < parts.length; i++) {
+                    dirs.add(parts.slice(0, i).join('/'));
+                }
+            }
+            const disk = {
+                _format: 'tree: { "directory/": { "file.ext": token_count } }',
+                version: 4,
+                created_at: this.createdAt,
+                updated_at: new Date().toISOString(),
+                project_root: this.projectRoot,
+                stats: {
+                    total_files: totalFiles,
+                    total_dirs: dirs.size,
+                    index_duration_ms: 0,
+                },
+                tree,
+            };
+            const tmpPath = `${this.indexPath}.tmp`;
+            writeFileSync(tmpPath, JSON.stringify(disk) + '\n', 'utf-8');
+            renameSync(tmpPath, this.indexPath);
+        }
+        catch (err) {
+            logger.debug('ProjectIndex: flush failed (non-fatal)', { error: summarizeError(err) });
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Tree serialization helpers
+// ---------------------------------------------------------------------------
+/**
+ * Flatten a v4 tree into a Map<path, tokens>.
+ * Tree: { "src/": { "main.ts": 450 } } -> Map { "src/main.ts" => 450 }
+ */
+function flattenTree(tree, prefix = '') {
+    const result = new Map();
+    for (const [key, value] of Object.entries(tree)) {
+        if (typeof value === 'number') {
+            // File entry
+            result.set(prefix + key, value);
+        }
+        else {
+            // Directory: key ends with '/'
+            const dirName = key.endsWith('/') ? key : key + '/';
+            const nested = flattenTree(value, prefix + dirName);
+            for (const [p, t] of nested)
+                result.set(p, t);
+        }
+    }
+    return result;
+}
+/**
+ * Build a v4 tree from a flat Map<path, tokens>.
+ * "src/main.ts" -> { "src/": { "main.ts": 450 } }
+ */
+function buildTree(files) {
+    const root = {};
+    for (const [path, tokens] of files) {
+        const parts = path.split('/');
+        let node = root;
+        for (let i = 0; i < parts.length - 1; i++) {
+            const dirKey = parts[i] + '/';
+            if (!(dirKey in node)) {
+                node[dirKey] = {};
+            }
+            node = node[dirKey];
+        }
+        const fileName = parts[parts.length - 1];
+        node[fileName] = tokens;
+    }
+    return root;
+}

package/dist/platform/state/sqlite-store.d.ts

@@ -0,0 +1,28 @@
+interface SqlDatabase {
+    run(sql: string, params?: (string | number | Uint8Array | null)[]): void;
+    exec(sql: string, params?: (string | number)[]): Array<{
+        columns: string[];
+        values: unknown[][];
+    }>;
+    export(): Uint8Array;
+    close(): void;
+}
+export declare class SQLiteStore {
+    private db;
+    private readonly dbPath;
+    private initPromise;
+    constructor(dbPath?: string);
+    get isReady(): boolean;
+    init(schema: (db: SqlDatabase) => void): Promise<void>;
+    run(sql: string, params?: (string | number | Uint8Array | null)[]): void;
+    exec(sql: string, params?: (string | number)[]): Array<{
+        columns: string[];
+        values: unknown[][];
+    }>;
+    save(): Promise<boolean>;
+    close(): void;
+    private initialize;
+    private getDb;
+}
+export {};
+//# sourceMappingURL=sqlite-store.d.ts.map

package/dist/platform/state/sqlite-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-store.d.ts","sourceRoot":"","sources":["../../../src/platform/state/sqlite-store.ts"],"names":[],"mappings":"AAKA,UAAU,WAAW;IACnB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC;IACzE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAA;KAAE,CAAC,CAAC;IACnG,MAAM,IAAI,UAAU,CAAC;IACrB,KAAK,IAAI,IAAI,CAAC;CACf;AAYD,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAA4B;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,WAAW,CAA8B;gBAErC,MAAM,CAAC,EAAE,MAAM;IAI3B,IAAI,OAAO,IAAI,OAAO,CAErB;IAEK,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAY5D,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC,EAAE,GAAG,IAAI;IAIxE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAA;KAAE,CAAC;IAI5F,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAkB9B,KAAK,IAAI,IAAI;YAMC,UAAU;IAyBxB,OAAO,CAAC,KAAK;CAMd"}

package/dist/platform/state/sqlite-store.js

@@ -0,0 +1,95 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { logger } from '../utils/logger.js';
+import { summarizeError } from '../utils/error-display.js';
+function isEphemeralDbPath(path) {
+    if (!path)
+        return true;
+    if (path === ':memory:')
+        return true;
+    return /^file:.*(?:^|[?&])mode=memory(?:&|$)/.test(path);
+}
+export class SQLiteStore {
+    db = null;
+    dbPath;
+    initPromise = null;
+    constructor(dbPath) {
+        this.dbPath = dbPath ?? null;
+    }
+    get isReady() {
+        return this.db !== null;
+    }
+    async init(schema) {
+        if (this.db)
+            return;
+        if (this.initPromise)
+            return this.initPromise;
+        this.initPromise = this.initialize(schema);
+        try {
+            await this.initPromise;
+        }
+        finally {
+            this.initPromise = null;
+        }
+    }
+    run(sql, params) {
+        this.getDb().run(sql, params);
+    }
+    exec(sql, params) {
+        return this.getDb().exec(sql, params);
+    }
+    async save() {
+        const dbPath = this.dbPath;
+        if (isEphemeralDbPath(dbPath) || !this.db || !dbPath)
+            return false;
+        try {
+            mkdirSync(dirname(dbPath), { recursive: true });
+            const data = this.db.export();
+            writeFileSync(dbPath, Buffer.from(data));
+            logger.info('SQLiteStore: saved to disk', { path: dbPath });
+            return true;
+        }
+        catch (err) {
+            logger.error('SQLiteStore: failed to save', {
+                error: summarizeError(err),
+            });
+            return false;
+        }
+    }
+    close() {
+        if (!this.db)
+            return;
+        this.db.close();
+        this.db = null;
+    }
+    async initialize(schema) {
+        try {
+            // @ts-ignore — no bundled types for sql.js in this environment
+            const initSqlJs = (await import('sql.js')).default;
+            const SQL = await initSqlJs();
+            const dbPath = this.dbPath;
+            if (dbPath && !isEphemeralDbPath(dbPath) && existsSync(dbPath)) {
+                this.db = new SQL.Database(readFileSync(dbPath));
+                logger.info('SQLiteStore: loaded from disk', { path: dbPath });
+            }
+            else {
+                this.db = new SQL.Database();
+                logger.info('SQLiteStore: initialized in-memory');
+            }
+            schema(this.db);
+        }
+        catch (err) {
+            this.db = null;
+            logger.error('SQLiteStore: failed to initialize', {
+                error: summarizeError(err),
+            });
+            throw err;
+        }
+    }
+    getDb() {
+        if (!this.db) {
+            throw new Error('SQLiteStore: not initialized — call init() first');
+        }
+        return this.db;
+    }
+}

package/dist/platform/state/telemetry.d.ts

@@ -0,0 +1,42 @@
+export interface ToolCallRecord {
+    id: number;
+    tool: string;
+    args: string;
+    result: string;
+    status: 'ok' | 'error';
+    duration_ms: number;
+    tokens: number;
+    timestamp: number;
+}
+export interface TelemetryFilter {
+    tool?: string;
+    status?: 'ok' | 'error';
+    since?: number;
+    until?: number;
+    limit?: number;
+}
+export interface TelemetrySummary {
+    total_calls: number;
+    total_tokens: number;
+    total_errors: number;
+    total_duration_ms: number;
+    by_tool: Record<string, {
+        calls: number;
+        tokens: number;
+        errors: number;
+        avg_duration_ms: number;
+    }>;
+}
+export declare class TelemetryDB {
+    private readonly store;
+    constructor(dbPath?: string);
+    init(): Promise<void>;
+    recordToolCall(tool: string, args: Record<string, unknown>, result: Record<string, unknown>, duration: number, tokens: number): void;
+    query(filter?: TelemetryFilter): ToolCallRecord[];
+    getSummary(): TelemetrySummary;
+    export(format?: 'json' | 'csv'): string;
+    save(): Promise<boolean>;
+    close(): void;
+    get isReady(): boolean;
+}
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/platform/state/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../../src/platform/state/telemetry.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrG;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;gBAExB,MAAM,CAAC,EAAE,MAAM;IAIrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB3B,cAAc,CACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,IAAI;IAiBP,KAAK,CAAC,MAAM,GAAE,eAAoB,GAAG,cAAc,EAAE;IAwCrD,UAAU,IAAI,gBAAgB;IAwC9B,MAAM,CAAC,MAAM,GAAE,MAAM,GAAG,KAAc,GAAG,MAAM;IAczC,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAI9B,KAAK,IAAI,IAAI;IAIb,IAAI,OAAO,IAAI,OAAO,CAErB;CACF"}

package/dist/platform/state/telemetry.js

@@ -0,0 +1,124 @@
+import { SQLiteStore } from './sqlite-store.js';
+export class TelemetryDB {
+    store;
+    constructor(dbPath) {
+        this.store = new SQLiteStore(dbPath);
+    }
+    async init() {
+        await this.store.init((db) => {
+            db.run(`
+        CREATE TABLE IF NOT EXISTS tool_calls (
+          id          INTEGER PRIMARY KEY AUTOINCREMENT,
+          tool        TEXT    NOT NULL,
+          args        TEXT    NOT NULL DEFAULT '{}',
+          result      TEXT    NOT NULL DEFAULT '{}',
+          status      TEXT    NOT NULL DEFAULT 'ok',
+          duration_ms INTEGER NOT NULL DEFAULT 0,
+          tokens      INTEGER NOT NULL DEFAULT 0,
+          timestamp   INTEGER NOT NULL
+        )
+      `);
+            db.run(`CREATE INDEX IF NOT EXISTS idx_tool ON tool_calls(tool)`);
+            db.run(`CREATE INDEX IF NOT EXISTS idx_timestamp ON tool_calls(timestamp)`);
+            db.run(`CREATE INDEX IF NOT EXISTS idx_status ON tool_calls(status)`);
+        });
+    }
+    recordToolCall(tool, args, result, duration, tokens) {
+        const status = (result.success === false || result.error !== undefined) ? 'error' : 'ok';
+        this.store.run(`INSERT INTO tool_calls (tool, args, result, status, duration_ms, tokens, timestamp)
+       VALUES (?, ?, ?, ?, ?, ?, ?)`, [
+            tool,
+            JSON.stringify(args),
+            JSON.stringify(result),
+            status,
+            Math.round(duration),
+            Math.max(0, Math.round(tokens)),
+            Date.now(),
+        ]);
+    }
+    query(filter = {}) {
+        const conditions = [];
+        const params = [];
+        if (filter.tool) {
+            conditions.push('tool = ?');
+            params.push(filter.tool);
+        }
+        if (filter.status) {
+            conditions.push('status = ?');
+            params.push(filter.status);
+        }
+        if (filter.since !== undefined) {
+            conditions.push('timestamp >= ?');
+            params.push(filter.since);
+        }
+        if (filter.until !== undefined) {
+            conditions.push('timestamp <= ?');
+            params.push(filter.until);
+        }
+        const where = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
+        const limit = filter.limit !== undefined ? `LIMIT ${filter.limit}` : '';
+        const sql = `SELECT * FROM tool_calls ${where} ORDER BY timestamp DESC ${limit}`;
+        const result = this.store.exec(sql, params);
+        if (!result.length)
+            return [];
+        const { columns, values } = result[0];
+        return values.map((row) => {
+            const obj = {};
+            columns.forEach((col, i) => {
+                obj[col] = row[i];
+            });
+            // Safe cast: the SQL schema defines exactly the columns that
+            // ToolCallRecord expects, so the shape is guaranteed at the DB level.
+            return obj;
+        });
+    }
+    getSummary() {
+        const totalResult = this.store.exec(`SELECT COUNT(*) as total_calls,
+              COALESCE(SUM(tokens), 0) as total_tokens,
+              COALESCE(SUM(CASE WHEN status='error' THEN 1 ELSE 0 END), 0) as total_errors,
+              COALESCE(SUM(duration_ms), 0) as total_duration_ms
+       FROM tool_calls`);
+        let total_calls = 0, total_tokens = 0, total_errors = 0, total_duration_ms = 0;
+        if (totalResult.length > 0) {
+            const row = totalResult[0].values[0];
+            total_calls = row[0] ?? 0;
+            total_tokens = row[1] ?? 0;
+            total_errors = row[2] ?? 0;
+            total_duration_ms = row[3] ?? 0;
+        }
+        const byToolResult = this.store.exec(`SELECT tool,
+              COUNT(*) as calls,
+              COALESCE(SUM(tokens), 0) as tokens,
+              COALESCE(SUM(CASE WHEN status='error' THEN 1 ELSE 0 END), 0) as errors,
+              COALESCE(AVG(duration_ms), 0) as avg_duration_ms
+       FROM tool_calls
+       GROUP BY tool
+       ORDER BY calls DESC`);
+        const by_tool = {};
+        if (byToolResult.length > 0) {
+            for (const row of byToolResult[0].values) {
+                const [tool, calls, tokens, errors, avg_duration_ms] = row;
+                by_tool[tool] = { calls, tokens, errors, avg_duration_ms: Math.round(avg_duration_ms) };
+            }
+        }
+        return { total_calls, total_tokens, total_errors, total_duration_ms, by_tool };
+    }
+    export(format = 'json') {
+        const records = this.query({});
+        if (format === 'csv') {
+            const header = 'id,tool,status,duration_ms,tokens,timestamp';
+            const rows = records.map((r) => `${r.id},${JSON.stringify(r.tool)},${r.status},${r.duration_ms},${r.tokens},${r.timestamp}`);
+            return [header, ...rows].join('\n');
+        }
+        return JSON.stringify(records, null, 2);
+    }
+    async save() {
+        return this.store.save();
+    }
+    close() {
+        this.store.close();
+    }
+    get isReady() {
+        return this.store.isReady;
+    }
+}

package/dist/platform/tools/agent/schema.d.ts

@@ -0,0 +1,71 @@
+import type { ToolDefinition } from '../../types/tools.js';
+import type { ExecutionIntent } from '../../runtime/execution-intents.js';
+/**
+ * JSON Schema for the agent tool's input.
+ * Manages in-process subagents: spawn, status, cancel, list, templates.
+ */
+export declare const AGENT_TOOL_SCHEMA: ToolDefinition;
+export interface AgentProviderRoutingPolicy {
+    providerSelection?: 'inherit-current' | 'concrete' | 'synthetic';
+    unresolvedModelPolicy?: 'fallback-to-current' | 'fail';
+    providerFailurePolicy?: 'ordered-fallbacks' | 'fail';
+    fallbackModels?: readonly string[];
+}
+/** Input shape for the agent tool. */
+export interface AgentInput {
+    mode: 'spawn' | 'batch-spawn' | 'status' | 'cancel' | 'list' | 'templates' | 'get' | 'budget' | 'plan' | 'wait' | 'message' | 'wrfc-chains' | 'wrfc-history' | 'cohort-status' | 'cohort-report';
+    task?: string;
+    template?: string;
+    model?: string;
+    provider?: string;
+    fallbackModels?: string[];
+    routing?: AgentProviderRoutingPolicy;
+    executionIntent?: ExecutionIntent;
+    reasoningEffort?: 'instant' | 'low' | 'medium' | 'high';
+    tools?: string[];
+    restrictTools?: boolean;
+    context?: string;
+    successCriteria?: string[];
+    requiredEvidence?: string[];
+    writeScope?: string[];
+    executionProtocol?: 'direct' | 'gather-plan-apply';
+    reviewMode?: 'none' | 'wrfc';
+    communicationLane?: 'parent-only' | 'parent-and-children' | 'cohort' | 'direct';
+    parentAgentId?: string;
+    orchestrationGraphId?: string;
+    orchestrationNodeId?: string;
+    parentNodeId?: string;
+    dangerously_disable_wrfc?: boolean;
+    cohort?: string;
+    tasks?: Array<{
+        task: string;
+        template?: string;
+        model?: string;
+        provider?: string;
+        fallbackModels?: string[];
+        routing?: AgentProviderRoutingPolicy;
+        executionIntent?: ExecutionIntent;
+        reasoningEffort?: 'instant' | 'low' | 'medium' | 'high';
+        tools?: string[];
+        restrictTools?: boolean;
+        context?: string;
+        successCriteria?: string[];
+        requiredEvidence?: string[];
+        writeScope?: string[];
+        executionProtocol?: 'direct' | 'gather-plan-apply';
+        reviewMode?: 'none' | 'wrfc';
+        communicationLane?: 'parent-only' | 'parent-and-children' | 'cohort' | 'direct';
+        parentAgentId?: string;
+        orchestrationGraphId?: string;
+        orchestrationNodeId?: string;
+        parentNodeId?: string;
+        dangerously_disable_wrfc?: boolean;
+    }>;
+    agentId?: string;
+    detail?: 'summary' | 'contract' | 'messages' | 'full';
+    timeoutMs?: number;
+    message?: string;
+    kind?: 'directive' | 'status' | 'question' | 'finding' | 'review' | 'handoff' | 'escalation' | 'completion';
+    wrfcId?: string;
+}
+//# sourceMappingURL=schema.d.ts.map

package/dist/platform/tools/agent/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/agent/schema.ts"],"names":[],"mappings":"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"}