qlogicagent 0.2.1 → 0.4.0

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

@@ -1,133 +0,0 @@
-// ============================================================
-// 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,
-                },
-            };
-        },
-    };
-}

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

@@ -1,62 +0,0 @@
-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>;

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

@@ -1,67 +0,0 @@
-// ============================================================
-// 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,
-                },
-            };
-        },
-    };
-}

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

@@ -1,103 +0,0 @@
-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>;

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

@@ -1,187 +0,0 @@
-// ============================================================
-// Instructions Tool — CRUD for project instruction files (.md).
-//
-// Runtime-agnostic: the actual file I/O is injected via deps.
-// Gateway provides InstructionsModule; Hub provides HTTP client;
-// Electron provides IPC bridge.
-//
-// Category: project-management
-// ============================================================
-// ── instructions_list ───────────────────────────────────────
-export const INSTRUCTIONS_LIST_TOOL_NAME = "instructions_list";
-export const INSTRUCTIONS_LIST_SCHEMA = {
-    type: "object",
-    properties: {
-        project_id: {
-            type: "string",
-            description: 'Project ID to list instructions for. Use "default" for the default project.',
-        },
-    },
-    required: ["project_id"],
-};
-export function createInstructionsListTool(deps) {
-    return {
-        name: INSTRUCTIONS_LIST_TOOL_NAME,
-        label: "List Instructions",
-        description: "List all instruction files (.md) in a project's .instructions/ directory. " +
-            "Instructions define agent behavior rules, coding standards, and project context. " +
-            "Returns filename, path, size, and last modified time for each file.",
-        parameters: INSTRUCTIONS_LIST_SCHEMA,
-        isReadOnly: true,
-        isConcurrencySafe: true,
-        searchHint: "list project instructions rules coding standards behavior guidelines",
-        execute: async (_toolCallId, params) => {
-            const files = deps.list(params.project_id);
-            if (files.length === 0) {
-                return {
-                    content: [{ type: "text", text: "No instruction files found for this project." }],
-                    details: { projectId: params.project_id, count: 0 },
-                };
-            }
-            const listing = files
-                .map((f) => `- ${f.filename} (${f.size} bytes, updated ${f.updatedAt})`)
-                .join("\n");
-            return {
-                content: [{ type: "text", text: `Found ${files.length} instruction file(s):\n${listing}` }],
-                details: { projectId: params.project_id, count: files.length, files },
-            };
-        },
-    };
-}
-// ── instructions_read ───────────────────────────────────────
-export const INSTRUCTIONS_READ_TOOL_NAME = "instructions_read";
-export const INSTRUCTIONS_READ_SCHEMA = {
-    type: "object",
-    properties: {
-        project_id: {
-            type: "string",
-            description: 'Project ID. Use "default" for the default project.',
-        },
-        filename: {
-            type: "string",
-            description: 'Instruction file name (e.g. "code-style.md"). Supports sub-paths like "testing/unit-test.md".',
-        },
-    },
-    required: ["project_id", "filename"],
-};
-export function createInstructionsReadTool(deps) {
-    return {
-        name: INSTRUCTIONS_READ_TOOL_NAME,
-        label: "Read Instruction",
-        description: "Read the content of a specific instruction file (.md) from a project. " +
-            "Use instructions_list first to discover available files.",
-        parameters: INSTRUCTIONS_READ_SCHEMA,
-        isReadOnly: true,
-        isConcurrencySafe: true,
-        searchHint: "read instruction file content rules coding standard",
-        execute: async (_toolCallId, params) => {
-            const file = deps.read(params.project_id, params.filename);
-            if (!file) {
-                return {
-                    content: [{ type: "text", text: `Instruction file not found: ${params.filename}` }],
-                    details: { projectId: params.project_id, filename: params.filename, error: "not_found" },
-                };
-            }
-            return {
-                content: [{ type: "text", text: file.content }],
-                details: { projectId: params.project_id, filename: file.filename, size: file.size },
-            };
-        },
-    };
-}
-// ── instructions_write ──────────────────────────────────────
-export const INSTRUCTIONS_WRITE_TOOL_NAME = "instructions_write";
-export const INSTRUCTIONS_WRITE_SCHEMA = {
-    type: "object",
-    properties: {
-        project_id: {
-            type: "string",
-            description: 'Project ID. Use "default" for the default project.',
-        },
-        filename: {
-            type: "string",
-            description: 'Instruction file name ending in .md (e.g. "code-style.md"). Sub-paths like "testing/unit-test.md" are supported.',
-        },
-        content: {
-            type: "string",
-            description: "Markdown content for the instruction file.",
-        },
-    },
-    required: ["project_id", "filename", "content"],
-};
-export function createInstructionsWriteTool(deps) {
-    return {
-        name: INSTRUCTIONS_WRITE_TOOL_NAME,
-        label: "Write Instruction",
-        description: "Create or overwrite an instruction file (.md) in a project. " +
-            "Instructions define agent behavior rules, coding standards, and project context. " +
-            "The file must end in .md. Sub-directories are created automatically.",
-        parameters: INSTRUCTIONS_WRITE_SCHEMA,
-        searchHint: "write create instruction file rules coding standard",
-        execute: async (_toolCallId, params) => {
-            if (!params.filename.endsWith(".md")) {
-                return {
-                    content: [{ type: "text", text: "Filename must end with .md" }],
-                    details: { error: "invalid_filename" },
-                };
-            }
-            if (params.filename.includes("..")) {
-                return {
-                    content: [{ type: "text", text: "Path traversal not allowed" }],
-                    details: { error: "path_traversal" },
-                };
-            }
-            const file = deps.write(params.project_id, params.filename, params.content);
-            return {
-                content: [
-                    { type: "text", text: `Instruction file written: ${file.filename} (${file.size} bytes)` },
-                ],
-                details: { projectId: params.project_id, filename: file.filename, size: file.size },
-            };
-        },
-    };
-}
-// ── instructions_delete ─────────────────────────────────────
-export const INSTRUCTIONS_DELETE_TOOL_NAME = "instructions_delete";
-export const INSTRUCTIONS_DELETE_SCHEMA = {
-    type: "object",
-    properties: {
-        project_id: {
-            type: "string",
-            description: 'Project ID. Use "default" for the default project.',
-        },
-        filename: {
-            type: "string",
-            description: "Instruction file name to delete (e.g. \"code-style.md\").",
-        },
-    },
-    required: ["project_id", "filename"],
-};
-export function createInstructionsDeleteTool(deps) {
-    return {
-        name: INSTRUCTIONS_DELETE_TOOL_NAME,
-        label: "Delete Instruction",
-        description: "Delete an instruction file (.md) from a project. This cannot be undone.",
-        parameters: INSTRUCTIONS_DELETE_SCHEMA,
-        searchHint: "delete remove instruction file",
-        execute: async (_toolCallId, params) => {
-            if (params.filename.includes("..")) {
-                return {
-                    content: [{ type: "text", text: "Path traversal not allowed" }],
-                    details: { error: "path_traversal" },
-                };
-            }
-            const ok = deps.remove(params.project_id, params.filename);
-            if (!ok) {
-                return {
-                    content: [{ type: "text", text: `Instruction file not found: ${params.filename}` }],
-                    details: { projectId: params.project_id, filename: params.filename, error: "not_found" },
-                };
-            }
-            return {
-                content: [{ type: "text", text: `Instruction file deleted: ${params.filename}` }],
-                details: { projectId: params.project_id, filename: params.filename },
-            };
-        },
-    };
-}