qlogicagent 0.1.0

package/dist/skills/tools/cron-tool.js.map

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

package/dist/skills/tools/edit-tool.d.ts

@@ -0,0 +1,44 @@
+import type { PortableTool } from "../portable-tool.js";
+export declare const EDIT_TOOL_NAME: "edit";
+export interface EditToolParams {
+    path: string;
+    oldText: string;
+    newText: string;
+}
+export declare const EDIT_TOOL_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly path: {
+            readonly type: "string";
+            readonly description: "Path to the file to edit (relative or absolute).";
+        };
+        readonly oldText: {
+            readonly type: "string";
+            readonly description: "Exact text to find and replace (must match exactly, including whitespace).";
+        };
+        readonly newText: {
+            readonly type: "string";
+            readonly description: "New text to replace the old text with.";
+        };
+    };
+    readonly required: readonly ["path", "oldText", "newText"];
+};
+/** Deps injected by the host runtime for file editing. */
+export interface EditToolDeps {
+    /** Read file content as text. */
+    readFile(path: string): Promise<string>;
+    /** Write content back. */
+    writeFile(path: string, content: string): Promise<void>;
+    /** Resolve a relative path to absolute. */
+    resolvePath(input: string): string;
+    /**
+     * Check for concurrent modification before writing.
+     * The host tracks when each file was last read vs last modified on disk.
+     * Returns null if safe to write, or a descriptive warning if the file
+     * has been modified since last read (by user, another tool, or external process).
+     * If not provided, no concurrent modification check is performed.
+     */
+    checkConcurrentModification?(path: string): string | null;
+}
+export declare function createEditTool(deps: EditToolDeps): PortableTool<EditToolParams>;
+//# sourceMappingURL=edit-tool.d.ts.map

package/dist/skills/tools/edit-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-tool.d.ts","sourceRoot":"","sources":["../../../src/skills/tools/edit-tool.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAsB,MAAM,qBAAqB,CAAC;AAE5E,eAAO,MAAM,cAAc,EAAG,MAAe,CAAC;AAE9C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;CAiBnB,CAAC;AAEX,0DAA0D;AAC1D,MAAM,WAAW,YAAY;IAC3B,iCAAiC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,0BAA0B;IAC1B,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,2CAA2C;IAC3C,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACnC;;;;;;OAMG;IACH,2BAA2B,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAC3D;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,YAAY,CAAC,cAAc,CAAC,CAuD/E"}

package/dist/skills/tools/edit-tool.js

@@ -0,0 +1,71 @@
+// ============================================================
+// File Edit Tool — surgical text replacement in files.
+// Category: coding
+// ============================================================
+export const EDIT_TOOL_NAME = "edit";
+export const EDIT_TOOL_SCHEMA = {
+    type: "object",
+    properties: {
+        path: {
+            type: "string",
+            description: "Path to the file to edit (relative or absolute).",
+        },
+        oldText: {
+            type: "string",
+            description: "Exact text to find and replace (must match exactly, including whitespace).",
+        },
+        newText: {
+            type: "string",
+            description: "New text to replace the old text with.",
+        },
+    },
+    required: ["path", "oldText", "newText"],
+};
+export function createEditTool(deps) {
+    return {
+        name: EDIT_TOOL_NAME,
+        label: "Edit File",
+        description: "Edit a file by replacing exact text. The oldText must match exactly (including whitespace). " +
+            "Use this for precise, surgical edits. For multiple edits, call this tool multiple times.",
+        parameters: EDIT_TOOL_SCHEMA,
+        execute: async (_toolCallId, params) => {
+            const resolved = deps.resolvePath(params.path);
+            // Concurrent modification check
+            if (deps.checkConcurrentModification) {
+                const conflict = deps.checkConcurrentModification(resolved);
+                if (conflict) {
+                    return {
+                        content: [{ type: "text", text: `Concurrent modification detected: ${conflict}. Re-read the file first.` }],
+                        details: { type: "edit", path: resolved, success: false, reason: "concurrent_modification" },
+                    };
+                }
+            }
+            const content = await deps.readFile(resolved);
+            const index = content.indexOf(params.oldText);
+            if (index === -1) {
+                return {
+                    content: [{ type: "text", text: `Error: oldText not found in ${resolved}. Ensure it matches exactly.` }],
+                    details: { type: "edit", path: resolved, success: false, reason: "not_found" },
+                };
+            }
+            // Check for multiple matches
+            const secondIndex = content.indexOf(params.oldText, index + 1);
+            if (secondIndex !== -1) {
+                return {
+                    content: [{ type: "text", text: `Error: oldText matches multiple locations in ${resolved}. Include more context to make the match unique.` }],
+                    details: { type: "edit", path: resolved, success: false, reason: "ambiguous" },
+                };
+            }
+            const newContent = content.slice(0, index) + params.newText + content.slice(index + params.oldText.length);
+            await deps.writeFile(resolved, newContent);
+            // Compute first changed line
+            const preLines = content.slice(0, index).split("\n");
+            const firstChangedLine = preLines.length;
+            return {
+                content: [{ type: "text", text: `Edited ${resolved} (line ${firstChangedLine})` }],
+                details: { type: "edit", path: resolved, success: true, firstChangedLine },
+            };
+        },
+    };
+}
+//# sourceMappingURL=edit-tool.js.map

package/dist/skills/tools/edit-tool.js.map

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

package/dist/skills/tools/exec-tool.d.ts

@@ -0,0 +1,103 @@
+import type { PortableTool } from "../portable-tool.js";
+export declare const EXEC_TOOL_NAME: "exec";
+export interface ExecToolParams {
+    command: string;
+    description?: string;
+    workdir?: string;
+    timeout?: number;
+    background?: boolean;
+}
+export declare const EXEC_TOOL_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly command: {
+            readonly type: "string";
+            readonly description: "Shell command to execute. On Windows uses PowerShell, on Unix uses bash.";
+        };
+        readonly description: {
+            readonly type: "string";
+            readonly description: string;
+        };
+        readonly workdir: {
+            readonly type: "string";
+            readonly description: "Working directory for the command.";
+        };
+        readonly timeout: {
+            readonly type: "number";
+            readonly description: "Timeout in seconds (default: 120). Only applies to foreground commands.";
+        };
+        readonly background: {
+            readonly type: "boolean";
+            readonly description: string;
+        };
+    };
+    readonly required: readonly ["command"];
+};
+export interface ExecResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+    timedOut?: boolean;
+}
+export interface BackgroundExecResult {
+    pid: string;
+    started: boolean;
+    hint?: string;
+}
+/**
+ * Deps injected by the host runtime for command execution.
+ * The host is responsible for sandboxing, approval, path restrictions,
+ * and security policies (dangerous command blocking).
+ */
+export interface ExecToolDeps {
+    /**
+     * Execute a shell command in the foreground and return the result.
+     */
+    exec(command: string, options?: {
+        workdir?: string;
+        timeout?: number;
+    }): Promise<ExecResult>;
+    /**
+     * Start a background process and return its ID.
+     * The host manages the process lifecycle.
+     * If not provided, background=true will be rejected.
+     */
+    execBackground?(command: string, options?: {
+        workdir?: string;
+    }): Promise<BackgroundExecResult>;
+    /**
+     * Retrieve partial output from a background process.
+     * If not provided, background output queries are not supported.
+     */
+    getBackgroundOutput?(pid: string): Promise<{
+        stdout: string;
+        stderr: string;
+        running: boolean;
+    }>;
+    /**
+     * Validate a command before execution (skill-guard integration point).
+     * The host MUST implement this to block dangerous commands
+     * (rm -rf /, format, del /f /s /q, etc.).
+     * Returns null/undefined if allowed, or an error message string if blocked.
+     * If not provided, all commands are allowed (UNSAFE — only for tests).
+     */
+    validateCommand?(command: string): Promise<string | null | undefined>;
+    /**
+     * Persist large output to disk and return a reference URI.
+     * Called when stdout+stderr exceeds MAX_OUTPUT_CHARS.
+     * If provided, the tool returns a truncated preview + the persisted URI.
+     * This avoids flooding the LLM context with huge outputs.
+     */
+    persistOutput?(output: string, meta: {
+        command: string;
+        exitCode: number;
+    }): Promise<string>;
+    /**
+     * Interpret a non-zero exit code into a human-readable explanation.
+     * E.g. exit 127 → "command not found", exit 137 → "killed by SIGKILL (OOM?)".
+     * If not provided, raw exit code is shown.
+     */
+    interpretExitCode?(exitCode: number, stderr: string): string | undefined;
+}
+export declare function createExecTool(deps: ExecToolDeps): PortableTool<ExecToolParams>;
+//# sourceMappingURL=exec-tool.d.ts.map

package/dist/skills/tools/exec-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec-tool.d.ts","sourceRoot":"","sources":["../../../src/skills/tools/exec-tool.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAsB,MAAM,qBAAqB,CAAC;AAE5E,eAAO,MAAM,cAAc,EAAG,MAAe,CAAC;AAE9C,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;CAiCnB,CAAC;AAEX,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,IAAI,CACF,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAC/C,OAAO,CAAC,UAAU,CAAC,CAAC;IAEvB;;;;OAIG;IACH,cAAc,CAAC,CACb,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAEjC;;;OAGG;IACH,mBAAmB,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAEjG;;;;;;OAMG;IACH,eAAe,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IAEtE;;;;;OAKG;IACH,aAAa,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE7F;;;;OAIG;IACH,iBAAiB,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CAC1E;AAWD,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,YAAY,CAAC,cAAc,CAAC,CAgG/E"}

package/dist/skills/tools/exec-tool.js

@@ -0,0 +1,134 @@
+// ============================================================
+// Exec Tool — execute shell commands in a sandbox/host env.
+// Reference: claude-code-haha/src/tools/BashTool/BashTool.tsx
+// Category: system
+// ============================================================
+export const EXEC_TOOL_NAME = "exec";
+export const EXEC_TOOL_SCHEMA = {
+    type: "object",
+    properties: {
+        command: {
+            type: "string",
+            description: "Shell command to execute. On Windows uses PowerShell, on Unix uses bash.",
+        },
+        description: {
+            type: "string",
+            description: "Brief human-readable description of what this command does (e.g. \"Install dependencies\", " +
+                "\"Run unit tests\"). Used for UI display. For simple commands keep it 5-10 words; " +
+                "for complex piped/flagged commands add enough context to clarify intent.",
+        },
+        workdir: {
+            type: "string",
+            description: "Working directory for the command.",
+        },
+        timeout: {
+            type: "number",
+            description: "Timeout in seconds (default: 120). Only applies to foreground commands.",
+        },
+        background: {
+            type: "boolean",
+            description: "If true, start the command in the background and return immediately " +
+                "with a process ID. Use getOutput to check on it later. " +
+                "Good for dev servers, watchers, long builds. Default: false.",
+        },
+    },
+    required: ["command"],
+};
+const DEFAULT_TIMEOUT = 120;
+const MAX_OUTPUT_CHARS = 50_000;
+function truncateOutput(text, limit) {
+    if (text.length <= limit)
+        return text;
+    const half = Math.floor(limit / 2) - 50;
+    return `${text.slice(0, half)}\n\n... [truncated ${text.length - limit} chars] ...\n\n${text.slice(-half)}`;
+}
+export function createExecTool(deps) {
+    return {
+        name: EXEC_TOOL_NAME,
+        label: "Execute Command",
+        description: "Execute a shell command. Supports foreground (blocking, returns output) " +
+            "and background (non-blocking, returns pid) modes. " +
+            "On Windows uses PowerShell, on Unix uses bash. " +
+            "Output is truncated if too long.",
+        parameters: EXEC_TOOL_SCHEMA,
+        execute: async (_toolCallId, params) => {
+            // ── Validate command (skill-guard) ──────────────────
+            if (deps.validateCommand) {
+                const blocked = await deps.validateCommand(params.command);
+                if (blocked) {
+                    return {
+                        content: [{ type: "text", text: `Command blocked: ${blocked}` }],
+                        details: { type: "exec", error: "blocked_by_guard", reason: blocked },
+                    };
+                }
+            }
+            // ── Background mode ─────────────────────────────────
+            if (params.background) {
+                if (!deps.execBackground) {
+                    return {
+                        content: [{ type: "text", text: "Background execution is not supported by the current host." }],
+                        details: { type: "exec", error: "background_not_supported" },
+                    };
+                }
+                const bgResult = await deps.execBackground(params.command, {
+                    workdir: params.workdir,
+                });
+                const text = bgResult.started
+                    ? `Background process started (pid: ${bgResult.pid}).${bgResult.hint ? ` ${bgResult.hint}` : ""}\nUse getOutput with this pid to check on it later.`
+                    : `Failed to start background process.`;
+                return {
+                    content: [{ type: "text", text }],
+                    details: {
+                        type: "exec_background",
+                        pid: bgResult.pid,
+                        started: bgResult.started,
+                        description: params.description,
+                    },
+                };
+            }
+            // ── Foreground mode ─────────────────────────────────
+            const timeout = params.timeout ?? DEFAULT_TIMEOUT;
+            const result = await deps.exec(params.command, {
+                workdir: params.workdir,
+                timeout,
+            });
+            const fullOutput = (result.stdout || "") + (result.stderr || "");
+            const parts = [];
+            // Large output persistence
+            let persistedUri;
+            if (fullOutput.length > MAX_OUTPUT_CHARS && deps.persistOutput) {
+                persistedUri = await deps.persistOutput(fullOutput, { command: params.command, exitCode: result.exitCode });
+            }
+            if (result.stdout) {
+                parts.push(persistedUri
+                    ? truncateOutput(result.stdout, MAX_OUTPUT_CHARS / 2)
+                    : truncateOutput(result.stdout, MAX_OUTPUT_CHARS));
+            }
+            if (result.stderr)
+                parts.push(`[stderr]\n${truncateOutput(result.stderr, MAX_OUTPUT_CHARS / 4)}`);
+            if (result.timedOut)
+                parts.push(`[timed out after ${timeout}s]`);
+            if (persistedUri)
+                parts.push(`[full output persisted: ${persistedUri}]`);
+            // Semantic exit code interpretation
+            if (result.exitCode !== 0 && deps.interpretExitCode) {
+                const hint = deps.interpretExitCode(result.exitCode, result.stderr || "");
+                if (hint)
+                    parts.push(`[exit ${result.exitCode}: ${hint}]`);
+            }
+            if (parts.length === 0)
+                parts.push(`(exit code ${result.exitCode}, no output)`);
+            return {
+                content: [{ type: "text", text: parts.join("\n") }],
+                details: {
+                    type: "exec",
+                    exitCode: result.exitCode,
+                    timedOut: result.timedOut ?? false,
+                    description: params.description,
+                    persistedUri,
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=exec-tool.js.map

package/dist/skills/tools/exec-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec-tool.js","sourceRoot":"","sources":["../../../src/skills/tools/exec-tool.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,4DAA4D;AAC5D,8DAA8D;AAC9D,mBAAmB;AACnB,+DAA+D;AAI/D,MAAM,CAAC,MAAM,cAAc,GAAG,MAAe,CAAC;AAU9C,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAE,QAAiB;IACvB,UAAU,EAAE;QACV,OAAO,EAAE;YACP,IAAI,EAAE,QAAiB;YACvB,WAAW,EACT,0EAA0E;SAC7E;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,WAAW,EACT,6FAA6F;gBAC7F,oFAAoF;gBACpF,0EAA0E;SAC7E;QACD,OAAO,EAAE;YACP,IAAI,EAAE,QAAiB;YACvB,WAAW,EAAE,oCAAoC;SAClD;QACD,OAAO,EAAE;YACP,IAAI,EAAE,QAAiB;YACvB,WAAW,EACT,yEAAyE;SAC5E;QACD,UAAU,EAAE;YACV,IAAI,EAAE,SAAkB;YACxB,WAAW,EACT,sEAAsE;gBACtE,yDAAyD;gBACzD,8DAA8D;SACjE;KACF;IACD,QAAQ,EAAE,CAAC,SAAS,CAAU;CACtB,CAAC;AAsEX,MAAM,eAAe,GAAG,GAAG,CAAC;AAC5B,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEhC,SAAS,cAAc,CAAC,IAAY,EAAE,KAAa;IACjD,IAAI,IAAI,CAAC,MAAM,IAAI,KAAK;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;IACxC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,sBAAsB,IAAI,CAAC,MAAM,GAAG,KAAK,kBAAkB,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;AAC9G,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAkB;IAC/C,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,iBAAiB;QACxB,WAAW,EACT,0EAA0E;YAC1E,oDAAoD;YACpD,iDAAiD;YACjD,kCAAkC;QACpC,UAAU,EAAE,gBAAgB;QAE5B,OAAO,EAAE,KAAK,EAAE,WAAmB,EAAE,MAAsB,EAA+B,EAAE;YAC1F,uDAAuD;YACvD,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;gBACzB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBAC3D,IAAI,OAAO,EAAE,CAAC;oBACZ,OAAO;wBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,OAAO,EAAE,EAAE,CAAC;wBAChE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,OAAO,EAAE;qBACtE,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,uDAAuD;YACvD,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;gBACtB,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;oBACzB,OAAO;wBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,4DAA4D,EAAE,CAAC;wBAC/F,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,0BAA0B,EAAE;qBAC7D,CAAC;gBACJ,CAAC;gBACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,EAAE;oBACzD,OAAO,EAAE,MAAM,CAAC,OAAO;iBACxB,CAAC,CAAC;gBACH,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO;oBAC3B,CAAC,CAAC,oCAAoC,QAAQ,CAAC,GAAG,KAAK,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,qDAAqD;oBACpJ,CAAC,CAAC,qCAAqC,CAAC;gBAC1C,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;oBACjC,OAAO,EAAE;wBACP,IAAI,EAAE,iBAAiB;wBACvB,GAAG,EAAE,QAAQ,CAAC,GAAG;wBACjB,OAAO,EAAE,QAAQ,CAAC,OAAO;wBACzB,WAAW,EAAE,MAAM,CAAC,WAAW;qBAChC;iBACF,CAAC;YACJ,CAAC;YAED,uDAAuD;YACvD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,eAAe,CAAC;YAClD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE;gBAC7C,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,OAAO;aACR,CAAC,CAAC;YAEH,MAAM,UAAU,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;YACjE,MAAM,KAAK,GAAa,EAAE,CAAC;YAE3B,2BAA2B;YAC3B,IAAI,YAAgC,CAAC;YACrC,IAAI,UAAU,CAAC,MAAM,GAAG,gBAAgB,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;gBAC/D,YAAY,GAAG,MAAM,IAAI,CAAC,aAAa,CACrC,UAAU,EACV,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CACvD,CAAC;YACJ,CAAC;YAED,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAClB,KAAK,CAAC,IAAI,CAAC,YAAY;oBACrB,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,CAAC,CAAC;oBACrD,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC;YACvD,CAAC;YACD,IAAI,MAAM,CAAC,MAAM;gBAAE,KAAK,CAAC,IAAI,CAAC,aAAa,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;YAClG,IAAI,MAAM,CAAC,QAAQ;gBAAE,KAAK,CAAC,IAAI,CAAC,oBAAoB,OAAO,IAAI,CAAC,CAAC;YACjE,IAAI,YAAY;gBAAE,KAAK,CAAC,IAAI,CAAC,2BAA2B,YAAY,GAAG,CAAC,CAAC;YAEzE,oCAAoC;YACpC,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBACpD,MAAM,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;gBAC1E,IAAI,IAAI;oBAAE,KAAK,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,QAAQ,KAAK,IAAI,GAAG,CAAC,CAAC;YAC7D,CAAC;YAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,cAAc,MAAM,CAAC,QAAQ,cAAc,CAAC,CAAC;YAEhF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnD,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,QAAQ,EAAE,MAAM,CAAC,QAAQ;oBACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,KAAK;oBAClC,WAAW,EAAE,MAAM,CAAC,WAAW;oBAC/B,YAAY;iBACb;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/skills/tools/image-generate-tool.d.ts

@@ -0,0 +1,63 @@
+import type { PortableTool } from "../portable-tool.js";
+export declare const IMAGE_GENERATE_TOOL_NAME: "image_generate";
+export interface ImageGenerateToolParams {
+    prompt: string;
+    purpose?: string;
+    style?: string;
+    size?: string;
+    image_url?: string;
+    n?: number;
+}
+export declare const IMAGE_GENERATE_TOOL_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly prompt: {
+            readonly type: "string";
+            readonly description: "Image generation prompt. Enrich vague requests with style, lighting, composition, color, mood details.";
+        };
+        readonly purpose: {
+            readonly type: "string";
+            readonly description: "Intended use: 'social-media', 'short-video-cover', 'phone-wallpaper', 'avatar', 'poster', etc.";
+        };
+        readonly style: {
+            readonly type: "string";
+            readonly description: "Visual art style: 'photorealistic', 'anime', 'watercolor', 'oil-painting', '3d-render', etc.";
+        };
+        readonly size: {
+            readonly type: "string";
+            readonly description: "Dimensions: e.g. '1024x1792' (portrait), '1792x1024' (landscape), '1024x1024' (square). Default: '1024x1024'.";
+        };
+        readonly image_url: {
+            readonly type: "string";
+            readonly description: "Reference image URL for image-to-image generation (img2img). Character reference sheet or style transfer.";
+        };
+        readonly n: {
+            readonly type: "number";
+            readonly description: "Number of images to generate (1-4). Default: 1.";
+        };
+    };
+    readonly required: readonly ["prompt"];
+};
+export interface ImageGenerateResult {
+    mediaUrls: string[];
+    model?: string;
+    size?: string;
+    durationMs?: number;
+}
+/** Deps injected by the host runtime for image generation. */
+export interface ImageGenerateToolDeps {
+    /**
+     * Generate images via the configured backend (relay, direct API, etc.).
+     * The host handles model selection, failover, watermark, and storage.
+     */
+    generateImage(params: {
+        prompt: string;
+        purpose?: string;
+        style?: string;
+        size?: string;
+        imageUrl?: string;
+        n?: number;
+    }): Promise<ImageGenerateResult>;
+}
+export declare function createImageGenerateTool(deps: ImageGenerateToolDeps): PortableTool<ImageGenerateToolParams>;
+//# sourceMappingURL=image-generate-tool.d.ts.map

package/dist/skills/tools/image-generate-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-generate-tool.d.ts","sourceRoot":"","sources":["../../../src/skills/tools/image-generate-tool.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAsB,MAAM,qBAAqB,CAAC;AAE5E,eAAO,MAAM,wBAAwB,EAAG,gBAAyB,CAAC;AAElE,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ;AAED,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkC7B,CAAC;AAEX,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,8DAA8D;AAC9D,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,aAAa,CAAC,MAAM,EAAE;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,CAAC,CAAC,EAAE,MAAM,CAAC;KACZ,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAClC;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,qBAAqB,GAC1B,YAAY,CAAC,uBAAuB,CAAC,CAmCvC"}

package/dist/skills/tools/image-generate-tool.js

@@ -0,0 +1,68 @@
+// ============================================================
+// Image Generate Tool — generate images via backend adapter.
+// Category: media
+// ============================================================
+export const IMAGE_GENERATE_TOOL_NAME = "image_generate";
+export const IMAGE_GENERATE_TOOL_SCHEMA = {
+    type: "object",
+    properties: {
+        prompt: {
+            type: "string",
+            description: "Image generation prompt. Enrich vague requests with style, lighting, composition, color, mood details.",
+        },
+        purpose: {
+            type: "string",
+            description: "Intended use: 'social-media', 'short-video-cover', 'phone-wallpaper', 'avatar', 'poster', etc.",
+        },
+        style: {
+            type: "string",
+            description: "Visual art style: 'photorealistic', 'anime', 'watercolor', 'oil-painting', '3d-render', etc.",
+        },
+        size: {
+            type: "string",
+            description: "Dimensions: e.g. '1024x1792' (portrait), '1792x1024' (landscape), '1024x1024' (square). Default: '1024x1024'.",
+        },
+        image_url: {
+            type: "string",
+            description: "Reference image URL for image-to-image generation (img2img). Character reference sheet or style transfer.",
+        },
+        n: {
+            type: "number",
+            description: "Number of images to generate (1-4). Default: 1.",
+        },
+    },
+    required: ["prompt"],
+};
+export function createImageGenerateTool(deps) {
+    return {
+        name: IMAGE_GENERATE_TOOL_NAME,
+        label: "Image Generate",
+        description: "Generate images from a text prompt. You MUST enrich vague prompts with details about style, lighting, " +
+            "composition, color, and mood before calling. Supports img2img via image_url reference. " +
+            "All generated images are saved locally and can be viewed immediately.",
+        parameters: IMAGE_GENERATE_TOOL_SCHEMA,
+        execute: async (_toolCallId, params) => {
+            const result = await deps.generateImage({
+                prompt: params.prompt,
+                purpose: params.purpose,
+                style: params.style,
+                size: params.size,
+                imageUrl: params.image_url,
+                n: params.n,
+            });
+            const count = result.mediaUrls.length;
+            const text = `Generated ${count} image${count > 1 ? "s" : ""}${result.model ? ` (model: ${result.model})` : ""}`;
+            return {
+                content: [{ type: "text", text }],
+                details: {
+                    type: "image_generate",
+                    model: result.model,
+                    size: result.size,
+                    durationMs: result.durationMs,
+                    mediaUrls: result.mediaUrls,
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=image-generate-tool.js.map

package/dist/skills/tools/image-generate-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-generate-tool.js","sourceRoot":"","sources":["../../../src/skills/tools/image-generate-tool.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,6DAA6D;AAC7D,kBAAkB;AAClB,+DAA+D;AAI/D,MAAM,CAAC,MAAM,wBAAwB,GAAG,gBAAyB,CAAC;AAWlE,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,IAAI,EAAE,QAAiB;IACvB,UAAU,EAAE;QACV,MAAM,EAAE;YACN,IAAI,EAAE,QAAiB;YACvB,WAAW,EACT,wGAAwG;SAC3G;QACD,OAAO,EAAE;YACP,IAAI,EAAE,QAAiB;YACvB,WAAW,EACT,gGAAgG;SACnG;QACD,KAAK,EAAE;YACL,IAAI,EAAE,QAAiB;YACvB,WAAW,EACT,8FAA8F;SACjG;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAiB;YACvB,WAAW,EACT,+GAA+G;SAClH;QACD,SAAS,EAAE;YACT,IAAI,EAAE,QAAiB;YACvB,WAAW,EACT,2GAA2G;SAC9G;QACD,CAAC,EAAE;YACD,IAAI,EAAE,QAAiB;YACvB,WAAW,EAAE,iDAAiD;SAC/D;KACF;IACD,QAAQ,EAAE,CAAC,QAAQ,CAAU;CACrB,CAAC;AAyBX,MAAM,UAAU,uBAAuB,CACrC,IAA2B;IAE3B,OAAO;QACL,IAAI,EAAE,wBAAwB;QAC9B,KAAK,EAAE,gBAAgB;QACvB,WAAW,EACT,wGAAwG;YACxG,yFAAyF;YACzF,uEAAuE;QACzE,UAAU,EAAE,0BAA0B;QAEtC,OAAO,EAAE,KAAK,EAAE,WAAmB,EAAE,MAA+B,EAA+B,EAAE;YACnG,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC;gBACtC,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,QAAQ,EAAE,MAAM,CAAC,SAAS;gBAC1B,CAAC,EAAE,MAAM,CAAC,CAAC;aACZ,CAAC,CAAC;YAEH,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC;YACtC,MAAM,IAAI,GAAG,aAAa,KAAK,SAAS,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YAEjH,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;gBACjC,OAAO,EAAE;oBACP,IAAI,EAAE,gBAAgB;oBACtB,KAAK,EAAE,MAAM,CAAC,KAAK;oBACnB,IAAI,EAAE,MAAM,CAAC,IAAI;oBACjB,UAAU,EAAE,MAAM,CAAC,UAAU;oBAC7B,SAAS,EAAE,MAAM,CAAC,SAAS;iBAC5B;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/skills/tools/instructions-tool.d.ts

@@ -0,0 +1,104 @@
+import type { PortableTool } from "../portable-tool.js";
+/** A single instruction file entry. */
+export interface InstructionFileInfo {
+    filename: string;
+    path: string;
+    size: number;
+    updatedAt: string;
+}
+/** Full instruction file (with content). */
+export interface InstructionFileContent extends InstructionFileInfo {
+    content: string;
+}
+/** Deps injected by the host runtime for instructions CRUD. */
+export interface InstructionsToolDeps {
+    /** List all instruction files for a project (recursive). */
+    list(projectId: string): InstructionFileInfo[];
+    /** Read a single instruction file. Returns null if not found. */
+    read(projectId: string, filename: string): InstructionFileContent | null;
+    /** Write (create or overwrite) an instruction file. */
+    write(projectId: string, filename: string, content: string): InstructionFileContent;
+    /** Remove an instruction file. Returns true if deleted. */
+    remove(projectId: string, filename: string): boolean;
+}
+export declare const INSTRUCTIONS_LIST_TOOL_NAME: "instructions_list";
+export interface InstructionsListParams {
+    project_id: string;
+}
+export declare const INSTRUCTIONS_LIST_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly project_id: {
+            readonly type: "string";
+            readonly description: "Project ID to list instructions for. Use \"default\" for the default project.";
+        };
+    };
+    readonly required: readonly ["project_id"];
+};
+export declare function createInstructionsListTool(deps: InstructionsToolDeps): PortableTool<InstructionsListParams>;
+export declare const INSTRUCTIONS_READ_TOOL_NAME: "instructions_read";
+export interface InstructionsReadParams {
+    project_id: string;
+    filename: string;
+}
+export declare const INSTRUCTIONS_READ_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly project_id: {
+            readonly type: "string";
+            readonly description: "Project ID. Use \"default\" for the default project.";
+        };
+        readonly filename: {
+            readonly type: "string";
+            readonly description: "Instruction file name (e.g. \"code-style.md\"). Supports sub-paths like \"testing/unit-test.md\".";
+        };
+    };
+    readonly required: readonly ["project_id", "filename"];
+};
+export declare function createInstructionsReadTool(deps: InstructionsToolDeps): PortableTool<InstructionsReadParams>;
+export declare const INSTRUCTIONS_WRITE_TOOL_NAME: "instructions_write";
+export interface InstructionsWriteParams {
+    project_id: string;
+    filename: string;
+    content: string;
+}
+export declare const INSTRUCTIONS_WRITE_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly project_id: {
+            readonly type: "string";
+            readonly description: "Project ID. Use \"default\" for the default project.";
+        };
+        readonly filename: {
+            readonly type: "string";
+            readonly description: "Instruction file name ending in .md (e.g. \"code-style.md\"). Sub-paths like \"testing/unit-test.md\" are supported.";
+        };
+        readonly content: {
+            readonly type: "string";
+            readonly description: "Markdown content for the instruction file.";
+        };
+    };
+    readonly required: readonly ["project_id", "filename", "content"];
+};
+export declare function createInstructionsWriteTool(deps: InstructionsToolDeps): PortableTool<InstructionsWriteParams>;
+export declare const INSTRUCTIONS_DELETE_TOOL_NAME: "instructions_delete";
+export interface InstructionsDeleteParams {
+    project_id: string;
+    filename: string;
+}
+export declare const INSTRUCTIONS_DELETE_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly project_id: {
+            readonly type: "string";
+            readonly description: "Project ID. Use \"default\" for the default project.";
+        };
+        readonly filename: {
+            readonly type: "string";
+            readonly description: "Instruction file name to delete (e.g. \"code-style.md\").";
+        };
+    };
+    readonly required: readonly ["project_id", "filename"];
+};
+export declare function createInstructionsDeleteTool(deps: InstructionsToolDeps): PortableTool<InstructionsDeleteParams>;
+//# sourceMappingURL=instructions-tool.d.ts.map