pulseed 0.1.5 → 0.2.0

package/dist/tools/builtin/list-dir.js

@@ -0,0 +1,89 @@
+import { z } from "zod";
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+export const ListDirInputSchema = z.object({
+    path: z.string().min(1),
+    recursive: z.boolean().default(false),
+    maxDepth: z.number().default(2),
+    includeHidden: z.boolean().default(false),
+});
+export class ListDirTool {
+    metadata = {
+        name: "list_dir",
+        aliases: ["ls", "listdir", "readdir"],
+        permissionLevel: "read_only",
+        isReadOnly: true,
+        isDestructive: false,
+        shouldDefer: false,
+        alwaysLoad: false,
+        maxConcurrency: 0,
+        maxOutputChars: 8000,
+        tags: ["filesystem", "observation"],
+    };
+    inputSchema = ListDirInputSchema;
+    description(context) {
+        const cwd = context?.cwd ?? process.cwd();
+        return `List files and directories. Current directory: ${cwd}. Supports recursive traversal with depth limit.`;
+    }
+    async call(input, _context) {
+        const startTime = Date.now();
+        try {
+            const entries = await listDir(input.path, input.recursive, input.maxDepth, input.includeHidden, 0);
+            return {
+                success: true,
+                data: entries,
+                summary: `Listed ${entries.length} entries in ${input.path}`,
+                durationMs: Date.now() - startTime,
+                artifacts: [input.path],
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                data: [],
+                summary: `list_dir failed: ${err.message}`,
+                error: err.message,
+                durationMs: Date.now() - startTime,
+            };
+        }
+    }
+    async checkPermissions() {
+        return { status: "allowed" };
+    }
+    isConcurrencySafe() {
+        return true;
+    }
+}
+async function listDir(dirPath, recursive, maxDepth, includeHidden, depth) {
+    const rawEntries = await fs.readdir(dirPath, { withFileTypes: true });
+    const results = [];
+    for (const dirent of rawEntries) {
+        if (!includeHidden && dirent.name.startsWith(".")) {
+            continue;
+        }
+        const entry = await toDirEntry(dirPath, dirent);
+        results.push(entry);
+        if (recursive && entry.type === "dir" && depth < maxDepth - 1) {
+            const subEntries = await listDir(path.join(dirPath, dirent.name), recursive, maxDepth, includeHidden, depth + 1);
+            results.push(...subEntries.map((e) => ({ ...e, name: path.join(dirent.name, e.name) })));
+        }
+    }
+    return results;
+}
+async function toDirEntry(dirPath, dirent) {
+    if (dirent.isSymbolicLink()) {
+        return { name: dirent.name, type: "symlink" };
+    }
+    if (dirent.isDirectory()) {
+        return { name: dirent.name, type: "dir" };
+    }
+    // file — get size
+    try {
+        const stat = await fs.stat(path.join(dirPath, dirent.name));
+        return { name: dirent.name, type: "file", size: stat.size };
+    }
+    catch {
+        return { name: dirent.name, type: "file" };
+    }
+}
+//# sourceMappingURL=list-dir.js.map

package/dist/tools/builtin/list-dir.js.map

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

package/dist/tools/builtin/process-status 2.d.ts

@@ -0,0 +1,61 @@
+import { z } from "zod";
+import type { ITool, ToolResult, ToolCallContext, PermissionCheckResult, ToolMetadata } from "../types.js";
+export declare const ProcessStatusInputSchema: z.ZodEffects<z.ZodObject<{
+    port: z.ZodOptional<z.ZodNumber>;
+    processName: z.ZodOptional<z.ZodString>;
+    pid: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    pid?: number | undefined;
+    port?: number | undefined;
+    processName?: string | undefined;
+}, {
+    pid?: number | undefined;
+    port?: number | undefined;
+    processName?: string | undefined;
+}>, {
+    pid?: number | undefined;
+    port?: number | undefined;
+    processName?: string | undefined;
+}, {
+    pid?: number | undefined;
+    port?: number | undefined;
+    processName?: string | undefined;
+}>;
+export type ProcessStatusInput = z.infer<typeof ProcessStatusInputSchema>;
+export interface ProcessStatusOutput {
+    alive: boolean;
+    details?: string;
+    pid?: number;
+}
+export declare class ProcessStatusTool implements ITool<ProcessStatusInput, ProcessStatusOutput> {
+    readonly metadata: ToolMetadata;
+    readonly inputSchema: z.ZodEffects<z.ZodObject<{
+        port: z.ZodOptional<z.ZodNumber>;
+        processName: z.ZodOptional<z.ZodString>;
+        pid: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        pid?: number | undefined;
+        port?: number | undefined;
+        processName?: string | undefined;
+    }, {
+        pid?: number | undefined;
+        port?: number | undefined;
+        processName?: string | undefined;
+    }>, {
+        pid?: number | undefined;
+        port?: number | undefined;
+        processName?: string | undefined;
+    }, {
+        pid?: number | undefined;
+        port?: number | undefined;
+        processName?: string | undefined;
+    }>;
+    description(): string;
+    call(input: ProcessStatusInput, context: ToolCallContext): Promise<ToolResult>;
+    private _checkPid;
+    private _checkPort;
+    private _checkProcessName;
+    checkPermissions(_input: ProcessStatusInput): Promise<PermissionCheckResult>;
+    isConcurrencySafe(_input: ProcessStatusInput): boolean;
+}
+//# sourceMappingURL=process-status%202.d.ts.map

package/dist/tools/builtin/process-status 2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-status 2.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/process-status 2.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3G,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;EAOpC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,iBAAkB,YAAW,KAAK,CAAC,kBAAkB,EAAE,mBAAmB,CAAC;IACtF,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAW7B;IAEF,QAAQ,CAAC,WAAW;;;;;;;;;;;;;;;;;;;;OAA4B;IAEhD,WAAW,IAAI,MAAM;IAIf,IAAI,CAAC,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;YAgCtE,SAAS;YAaT,UAAU;YAwCV,iBAAiB;IAsCzB,gBAAgB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAIlF,iBAAiB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO;CAGvD"}

package/dist/tools/builtin/process-status 2.js

@@ -0,0 +1,145 @@
+import { z } from "zod";
+import { execFileNoThrow } from "../../base/utils/execFileNoThrow.js";
+export const ProcessStatusInputSchema = z.object({
+    port: z.number().int().min(1).max(65535).optional(),
+    processName: z.string().min(1).optional(),
+    pid: z.number().int().min(1).optional(),
+}).refine((d) => d.port !== undefined || d.processName !== undefined || d.pid !== undefined, { message: "At least one of port, processName, or pid is required" });
+export class ProcessStatusTool {
+    metadata = {
+        name: "process-status",
+        aliases: ["proc-status", "ps-check"],
+        permissionLevel: "read_metrics",
+        isReadOnly: true,
+        isDestructive: false,
+        shouldDefer: false,
+        alwaysLoad: false,
+        maxConcurrency: 5,
+        maxOutputChars: 4000,
+        tags: ["observe", "process", "port"],
+    };
+    inputSchema = ProcessStatusInputSchema;
+    description() {
+        return "Check if a process is alive by port, process name, or PID. Returns alive status and details.";
+    }
+    async call(input, context) {
+        const startTime = Date.now();
+        try {
+            if (input.pid !== undefined) {
+                return await this._checkPid(input.pid, startTime);
+            }
+            if (input.port !== undefined) {
+                return await this._checkPort(input.port, startTime);
+            }
+            if (input.processName !== undefined) {
+                return await this._checkProcessName(input.processName, startTime);
+            }
+            // Unreachable due to Zod refinement, but satisfies TS
+            return {
+                success: false,
+                data: { alive: false },
+                summary: "No query parameter provided",
+                error: "No query parameter provided",
+                durationMs: Date.now() - startTime,
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                data: { alive: false },
+                summary: `ProcessStatusTool error: ${err.message}`,
+                error: err.message,
+                durationMs: Date.now() - startTime,
+            };
+        }
+    }
+    async _checkPid(pid, startTime) {
+        // kill -0 checks if process is alive without sending a signal
+        const result = await execFileNoThrow("kill", ["-0", String(pid)], { timeoutMs: 5000 });
+        const alive = result.exitCode === 0;
+        const output = { alive, pid };
+        return {
+            success: true,
+            data: output,
+            summary: alive ? `PID ${pid} is alive` : `PID ${pid} is not running`,
+            durationMs: Date.now() - startTime,
+        };
+    }
+    async _checkPort(port, startTime) {
+        const isWindows = process.platform === "win32";
+        let result;
+        if (isWindows) {
+            result = await execFileNoThrow("netstat", ["-ano"], { timeoutMs: 5000 });
+            const lines = result.stdout.split("\n").filter((l) => l.includes(`:${port} `));
+            const alive = lines.length > 0;
+            const output = { alive, details: lines.slice(0, 5).join("\n") || undefined };
+            return {
+                success: true,
+                data: output,
+                summary: alive ? `Port ${port} is in use` : `Port ${port} is free`,
+                durationMs: Date.now() - startTime,
+            };
+        }
+        // macOS / Linux: lsof -i :PORT
+        result = await execFileNoThrow("lsof", ["-i", `:${port}`, "-n", "-P"], { timeoutMs: 5000 });
+        const alive = result.exitCode === 0 && result.stdout.trim().length > 0;
+        const details = result.stdout.trim() || undefined;
+        // Extract first PID from lsof output (second column of data rows)
+        let pid;
+        const lines = result.stdout.split("\n").filter(Boolean);
+        if (lines.length > 1) {
+            const cols = lines[1].trim().split(/\s+/);
+            const parsed = parseInt(cols[1], 10);
+            if (!isNaN(parsed))
+                pid = parsed;
+        }
+        const output = { alive, details, pid };
+        return {
+            success: true,
+            data: output,
+            summary: alive ? `Port ${port} is in use${pid ? ` (PID ${pid})` : ""}` : `Port ${port} is free`,
+            durationMs: Date.now() - startTime,
+        };
+    }
+    async _checkProcessName(name, startTime) {
+        const isWindows = process.platform === "win32";
+        let result;
+        if (isWindows) {
+            result = await execFileNoThrow("tasklist", ["/FI", `IMAGENAME eq ${name}`], { timeoutMs: 5000 });
+            const alive = result.stdout.includes(name);
+            const output = { alive, details: result.stdout.trim() || undefined };
+            return {
+                success: true,
+                data: output,
+                summary: alive ? `Process "${name}" is running` : `Process "${name}" is not running`,
+                durationMs: Date.now() - startTime,
+            };
+        }
+        // macOS / Linux: pgrep -la <name>
+        result = await execFileNoThrow("pgrep", ["-la", name], { timeoutMs: 5000 });
+        const alive = result.exitCode === 0 && result.stdout.trim().length > 0;
+        const details = result.stdout.trim() || undefined;
+        // Extract first PID
+        let pid;
+        if (details) {
+            const firstLine = details.split("\n")[0];
+            const parsed = parseInt(firstLine.trim().split(/\s+/)[0], 10);
+            if (!isNaN(parsed))
+                pid = parsed;
+        }
+        const output = { alive, details, pid };
+        return {
+            success: true,
+            data: output,
+            summary: alive ? `Process "${name}" is running${pid ? ` (PID ${pid})` : ""}` : `Process "${name}" is not running`,
+            durationMs: Date.now() - startTime,
+        };
+    }
+    async checkPermissions(_input) {
+        return { status: "allowed" };
+    }
+    isConcurrencySafe(_input) {
+        return true;
+    }
+}
+//# sourceMappingURL=process-status%202.js.map

package/dist/tools/builtin/process-status 2.js.map

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

package/dist/tools/builtin/process-status.d.ts

@@ -0,0 +1,61 @@
+import { z } from "zod";
+import type { ITool, ToolResult, ToolCallContext, PermissionCheckResult, ToolMetadata } from "../types.js";
+export declare const ProcessStatusInputSchema: z.ZodEffects<z.ZodObject<{
+    port: z.ZodOptional<z.ZodNumber>;
+    processName: z.ZodOptional<z.ZodString>;
+    pid: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    pid?: number | undefined;
+    port?: number | undefined;
+    processName?: string | undefined;
+}, {
+    pid?: number | undefined;
+    port?: number | undefined;
+    processName?: string | undefined;
+}>, {
+    pid?: number | undefined;
+    port?: number | undefined;
+    processName?: string | undefined;
+}, {
+    pid?: number | undefined;
+    port?: number | undefined;
+    processName?: string | undefined;
+}>;
+export type ProcessStatusInput = z.infer<typeof ProcessStatusInputSchema>;
+export interface ProcessStatusOutput {
+    alive: boolean;
+    details?: string;
+    pid?: number;
+}
+export declare class ProcessStatusTool implements ITool<ProcessStatusInput, ProcessStatusOutput> {
+    readonly metadata: ToolMetadata;
+    readonly inputSchema: z.ZodEffects<z.ZodObject<{
+        port: z.ZodOptional<z.ZodNumber>;
+        processName: z.ZodOptional<z.ZodString>;
+        pid: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        pid?: number | undefined;
+        port?: number | undefined;
+        processName?: string | undefined;
+    }, {
+        pid?: number | undefined;
+        port?: number | undefined;
+        processName?: string | undefined;
+    }>, {
+        pid?: number | undefined;
+        port?: number | undefined;
+        processName?: string | undefined;
+    }, {
+        pid?: number | undefined;
+        port?: number | undefined;
+        processName?: string | undefined;
+    }>;
+    description(): string;
+    call(input: ProcessStatusInput, context: ToolCallContext): Promise<ToolResult>;
+    private _checkPid;
+    private _checkPort;
+    private _checkProcessName;
+    checkPermissions(_input: ProcessStatusInput): Promise<PermissionCheckResult>;
+    isConcurrencySafe(_input: ProcessStatusInput): boolean;
+}
+//# sourceMappingURL=process-status.d.ts.map

package/dist/tools/builtin/process-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-status.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/process-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3G,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;EAOpC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,iBAAkB,YAAW,KAAK,CAAC,kBAAkB,EAAE,mBAAmB,CAAC;IACtF,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAW7B;IAEF,QAAQ,CAAC,WAAW;;;;;;;;;;;;;;;;;;;;OAA4B;IAEhD,WAAW,IAAI,MAAM;IAIf,IAAI,CAAC,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;YAgCtE,SAAS;YAaT,UAAU;YAwCV,iBAAiB;IAsCzB,gBAAgB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAIlF,iBAAiB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO;CAGvD"}

package/dist/tools/builtin/process-status.js

@@ -0,0 +1,145 @@
+import { z } from "zod";
+import { execFileNoThrow } from "../../base/utils/execFileNoThrow.js";
+export const ProcessStatusInputSchema = z.object({
+    port: z.number().int().min(1).max(65535).optional(),
+    processName: z.string().min(1).optional(),
+    pid: z.number().int().min(1).optional(),
+}).refine((d) => d.port !== undefined || d.processName !== undefined || d.pid !== undefined, { message: "At least one of port, processName, or pid is required" });
+export class ProcessStatusTool {
+    metadata = {
+        name: "process-status",
+        aliases: ["proc-status", "ps-check"],
+        permissionLevel: "read_metrics",
+        isReadOnly: true,
+        isDestructive: false,
+        shouldDefer: false,
+        alwaysLoad: false,
+        maxConcurrency: 5,
+        maxOutputChars: 4000,
+        tags: ["observe", "process", "port"],
+    };
+    inputSchema = ProcessStatusInputSchema;
+    description() {
+        return "Check if a process is alive by port, process name, or PID. Returns alive status and details.";
+    }
+    async call(input, context) {
+        const startTime = Date.now();
+        try {
+            if (input.pid !== undefined) {
+                return await this._checkPid(input.pid, startTime);
+            }
+            if (input.port !== undefined) {
+                return await this._checkPort(input.port, startTime);
+            }
+            if (input.processName !== undefined) {
+                return await this._checkProcessName(input.processName, startTime);
+            }
+            // Unreachable due to Zod refinement, but satisfies TS
+            return {
+                success: false,
+                data: { alive: false },
+                summary: "No query parameter provided",
+                error: "No query parameter provided",
+                durationMs: Date.now() - startTime,
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                data: { alive: false },
+                summary: `ProcessStatusTool error: ${err.message}`,
+                error: err.message,
+                durationMs: Date.now() - startTime,
+            };
+        }
+    }
+    async _checkPid(pid, startTime) {
+        // kill -0 checks if process is alive without sending a signal
+        const result = await execFileNoThrow("kill", ["-0", String(pid)], { timeoutMs: 5000 });
+        const alive = result.exitCode === 0;
+        const output = { alive, pid };
+        return {
+            success: true,
+            data: output,
+            summary: alive ? `PID ${pid} is alive` : `PID ${pid} is not running`,
+            durationMs: Date.now() - startTime,
+        };
+    }
+    async _checkPort(port, startTime) {
+        const isWindows = process.platform === "win32";
+        let result;
+        if (isWindows) {
+            result = await execFileNoThrow("netstat", ["-ano"], { timeoutMs: 5000 });
+            const lines = result.stdout.split("\n").filter((l) => l.includes(`:${port} `));
+            const alive = lines.length > 0;
+            const output = { alive, details: lines.slice(0, 5).join("\n") || undefined };
+            return {
+                success: true,
+                data: output,
+                summary: alive ? `Port ${port} is in use` : `Port ${port} is free`,
+                durationMs: Date.now() - startTime,
+            };
+        }
+        // macOS / Linux: lsof -i :PORT
+        result = await execFileNoThrow("lsof", ["-i", `:${port}`, "-n", "-P"], { timeoutMs: 5000 });
+        const alive = result.exitCode === 0 && result.stdout.trim().length > 0;
+        const details = result.stdout.trim() || undefined;
+        // Extract first PID from lsof output (second column of data rows)
+        let pid;
+        const lines = result.stdout.split("\n").filter(Boolean);
+        if (lines.length > 1) {
+            const cols = lines[1].trim().split(/\s+/);
+            const parsed = parseInt(cols[1], 10);
+            if (!isNaN(parsed))
+                pid = parsed;
+        }
+        const output = { alive, details, pid };
+        return {
+            success: true,
+            data: output,
+            summary: alive ? `Port ${port} is in use${pid ? ` (PID ${pid})` : ""}` : `Port ${port} is free`,
+            durationMs: Date.now() - startTime,
+        };
+    }
+    async _checkProcessName(name, startTime) {
+        const isWindows = process.platform === "win32";
+        let result;
+        if (isWindows) {
+            result = await execFileNoThrow("tasklist", ["/FI", `IMAGENAME eq ${name}`], { timeoutMs: 5000 });
+            const alive = result.stdout.includes(name);
+            const output = { alive, details: result.stdout.trim() || undefined };
+            return {
+                success: true,
+                data: output,
+                summary: alive ? `Process "${name}" is running` : `Process "${name}" is not running`,
+                durationMs: Date.now() - startTime,
+            };
+        }
+        // macOS / Linux: pgrep -la <name>
+        result = await execFileNoThrow("pgrep", ["-la", name], { timeoutMs: 5000 });
+        const alive = result.exitCode === 0 && result.stdout.trim().length > 0;
+        const details = result.stdout.trim() || undefined;
+        // Extract first PID
+        let pid;
+        if (details) {
+            const firstLine = details.split("\n")[0];
+            const parsed = parseInt(firstLine.trim().split(/\s+/)[0], 10);
+            if (!isNaN(parsed))
+                pid = parsed;
+        }
+        const output = { alive, details, pid };
+        return {
+            success: true,
+            data: output,
+            summary: alive ? `Process "${name}" is running${pid ? ` (PID ${pid})` : ""}` : `Process "${name}" is not running`,
+            durationMs: Date.now() - startTime,
+        };
+    }
+    async checkPermissions(_input) {
+        return { status: "allowed" };
+    }
+    isConcurrencySafe(_input) {
+        return true;
+    }
+}
+//# sourceMappingURL=process-status.js.map

package/dist/tools/builtin/process-status.js.map

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

package/dist/tools/builtin/progress-history 2.d.ts

@@ -0,0 +1,57 @@
+import { z } from "zod";
+import type { ITool, ToolResult, ToolCallContext, PermissionCheckResult, ToolMetadata, ToolDescriptionContext } from "../types.js";
+import type { StateManager } from "../../base/state/state-manager.js";
+export declare const ProgressHistoryInputSchema: z.ZodObject<{
+    goalId: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+    dimensionName: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    goalId: string;
+    limit: number;
+    dimensionName?: string | undefined;
+}, {
+    goalId: string;
+    dimensionName?: string | undefined;
+    limit?: number | undefined;
+}>;
+export type ProgressHistoryInput = z.infer<typeof ProgressHistoryInputSchema>;
+export type TrendLabel = "improving" | "stagnating" | "declining" | "insufficient_data";
+export interface HistoryDimensionSnapshot {
+    name: string;
+    value: number;
+    confidence: number;
+    gap: number;
+}
+export interface HistoryPoint {
+    iteration: number;
+    timestamp: string;
+    dimensions: HistoryDimensionSnapshot[];
+}
+export interface ProgressHistoryOutput {
+    goalId: string;
+    history: HistoryPoint[];
+    trend: TrendLabel;
+}
+export declare class ProgressHistoryTool implements ITool<ProgressHistoryInput, ProgressHistoryOutput> {
+    private readonly stateManager;
+    readonly metadata: ToolMetadata;
+    readonly inputSchema: z.ZodObject<{
+        goalId: z.ZodString;
+        limit: z.ZodDefault<z.ZodNumber>;
+        dimensionName: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        goalId: string;
+        limit: number;
+        dimensionName?: string | undefined;
+    }, {
+        goalId: string;
+        dimensionName?: string | undefined;
+        limit?: number | undefined;
+    }>;
+    constructor(stateManager: StateManager);
+    description(_context?: ToolDescriptionContext): string;
+    call(input: ProgressHistoryInput, _context: ToolCallContext): Promise<ToolResult>;
+    checkPermissions(): Promise<PermissionCheckResult>;
+    isConcurrencySafe(): boolean;
+}
+//# sourceMappingURL=progress-history%202.d.ts.map

package/dist/tools/builtin/progress-history 2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-history 2.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/progress-history 2.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EACV,KAAK,EACL,UAAU,EACV,eAAe,EACf,qBAAqB,EACrB,YAAY,EACZ,sBAAsB,EACvB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAGtE,eAAO,MAAM,0BAA0B;;;;;;;;;;;;EAIrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,MAAM,MAAM,UAAU,GAClB,WAAW,GACX,YAAY,GACZ,WAAW,GACX,mBAAmB,CAAC;AAExB,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,wBAAwB,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,KAAK,EAAE,UAAU,CAAC;CACnB;AAsGD,qBAAa,mBACX,YAAW,KAAK,CAAC,oBAAoB,EAAE,qBAAqB,CAAC;IAiBjD,OAAO,CAAC,QAAQ,CAAC,YAAY;IAfzC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAW7B;IAEF,QAAQ,CAAC,WAAW;;;;;;;;;;;;OAA8B;gBAErB,YAAY,EAAE,YAAY;IAEvD,WAAW,CAAC,QAAQ,CAAC,EAAE,sBAAsB,GAAG,MAAM;IAIhD,IAAI,CACR,KAAK,EAAE,oBAAoB,EAC3B,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,UAAU,CAAC;IAmChB,gBAAgB,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAIxD,iBAAiB,IAAI,OAAO;CAG7B"}