qlogicagent 0.3.0 → 0.5.0

package/dist/types/skills/tools/cron-tool.d.ts

@@ -1,116 +0,0 @@
-import type { PortableTool } from "../portable-tool.js";
-export declare const CRON_TOOL_NAME: "cron";
-export type CronAction = "create" | "list" | "get" | "update" | "delete" | "pause" | "resume" | "trigger";
-export interface CronToolParams {
-    action: CronAction;
-    /** Job ID (required for get/update/delete/pause/resume/trigger) */
-    jobId?: string;
-    /** Task prompt to execute on schedule */
-    prompt?: string;
-    /** Cron expression or shorthand ('5m', '1h', '0 9 * * *') */
-    schedule?: string;
-    /** Human-readable job name */
-    name?: string;
-    /** Repeat count (null = infinite) */
-    repeat?: number | null;
-    /** Allowed tools for the scheduled task */
-    allowedTools?: string[];
-    /** Whether the job is enabled */
-    enabled?: boolean;
-}
-export declare const CRON_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly action: {
-            readonly type: "string";
-            readonly enum: readonly ["create", "list", "get", "update", "delete", "pause", "resume", "trigger"];
-            readonly description: "CRUD action: create/list/get/update/delete/pause/resume/trigger.";
-        };
-        readonly jobId: {
-            readonly type: "string";
-            readonly description: "Job ID. Required for get/update/delete/pause/resume/trigger.";
-        };
-        readonly prompt: {
-            readonly type: "string";
-            readonly description: "Task prompt to execute on schedule. Required for create.";
-        };
-        readonly schedule: {
-            readonly type: "string";
-            readonly description: string;
-        };
-        readonly name: {
-            readonly type: "string";
-            readonly description: "Human-readable job name.";
-        };
-        readonly repeat: {
-            readonly type: "number";
-            readonly description: "Number of times to repeat (null = infinite). Default: null.";
-        };
-        readonly allowedTools: {
-            readonly type: "array";
-            readonly items: {
-                readonly type: "string";
-            };
-            readonly description: "Tools the scheduled task is allowed to use.";
-        };
-        readonly enabled: {
-            readonly type: "boolean";
-            readonly description: "Whether the job is enabled (for update).";
-        };
-    };
-    readonly required: readonly ["action"];
-};
-export interface CronJob {
-    id: string;
-    name: string;
-    prompt: string;
-    schedule: string;
-    scheduleDisplay: string;
-    state: "scheduled" | "paused";
-    enabled: boolean;
-    repeat: {
-        times: number | null;
-        completed: number;
-    };
-    nextRunAt?: string;
-    lastRunAt?: string;
-    lastStatus?: "success" | "error" | null;
-    allowedTools?: string[];
-}
-export interface CronResult {
-    success: boolean;
-    job?: CronJob;
-    jobs?: CronJob[];
-    error?: string;
-}
-/**
- * Host-provided cron scheduler backend.
- * Jobs are persisted locally and survive restarts.
- */
-export interface CronToolDeps {
-    createJob(params: {
-        prompt: string;
-        schedule: string;
-        name?: string;
-        repeat?: number | null;
-        allowedTools?: string[];
-    }): Promise<CronResult>;
-    listJobs(): Promise<CronResult>;
-    getJob(jobId: string): Promise<CronResult>;
-    updateJob(jobId: string, updates: Partial<{
-        prompt: string;
-        schedule: string;
-        name: string;
-        enabled: boolean;
-        repeat: number | null;
-        allowedTools: string[];
-    }>): Promise<CronResult>;
-    deleteJob(jobId: string): Promise<CronResult>;
-    pauseJob(jobId: string): Promise<CronResult>;
-    resumeJob(jobId: string): Promise<CronResult>;
-    triggerJob(jobId: string): Promise<CronResult>;
-    /** Validate cron schedule expression. Returns error or null. */
-    validateSchedule?(schedule: string): string | null;
-}
-export declare const MAX_CRON_JOBS = 50;
-export declare function createCronTool(deps: CronToolDeps): PortableTool<CronToolParams>;

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

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

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

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

package/dist/types/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/types/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/types/skills/tools/lsp-tool.d.ts

@@ -1,153 +0,0 @@
-import type { PortableTool } from "../portable-tool.js";
-export declare const LSP_TOOL_NAME: "lsp";
-export type LspOperation = "goToDefinition" | "findReferences" | "hover" | "documentSymbol" | "diagnostics" | "completion" | "signatureHelp" | "rename" | "codeAction";
-export interface LspToolParams {
-    /** LSP operation to perform */
-    operation: LspOperation;
-    /** File path (absolute or relative to workspace root) */
-    filePath: string;
-    /** Line number (1-indexed) */
-    line?: number;
-    /** Character position (1-indexed) */
-    character?: number;
-    /** New name (for rename operation) */
-    newName?: string;
-    /** Include context lines around results */
-    includeContext?: boolean;
-}
-export declare const LSP_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly operation: {
-            readonly type: "string";
-            readonly enum: readonly ["goToDefinition", "findReferences", "hover", "documentSymbol", "diagnostics", "completion", "signatureHelp", "rename", "codeAction"];
-            readonly description: string;
-        };
-        readonly filePath: {
-            readonly type: "string";
-            readonly description: "File path. Absolute or relative to workspace root.";
-        };
-        readonly line: {
-            readonly type: "number";
-            readonly description: "Line number (1-indexed). Required for positional operations.";
-        };
-        readonly character: {
-            readonly type: "number";
-            readonly description: "Character position (1-indexed). Required for positional operations.";
-        };
-        readonly newName: {
-            readonly type: "string";
-            readonly description: "New name for rename operation.";
-        };
-        readonly includeContext: {
-            readonly type: "boolean";
-            readonly description: "Include surrounding code context in results (default: true).";
-        };
-    };
-    readonly required: readonly ["operation", "filePath"];
-};
-export interface LspLocation {
-    filePath: string;
-    line: number;
-    character: number;
-    endLine?: number;
-    endCharacter?: number;
-    context?: string;
-}
-export interface LspSymbol {
-    name: string;
-    kind: string;
-    range: {
-        startLine: number;
-        endLine: number;
-    };
-    children?: LspSymbol[];
-}
-export interface LspDiagnostic {
-    message: string;
-    severity: "error" | "warning" | "info" | "hint";
-    line: number;
-    character: number;
-    source?: string;
-    code?: string | number;
-}
-export interface LspHoverInfo {
-    contents: string;
-    range?: {
-        startLine: number;
-        startCharacter: number;
-        endLine: number;
-        endCharacter: number;
-    };
-}
-export interface LspCompletion {
-    label: string;
-    kind: string;
-    detail?: string;
-    insertText?: string;
-}
-export interface LspRenameEdit {
-    filePath: string;
-    edits: Array<{
-        line: number;
-        character: number;
-        endLine: number;
-        endCharacter: number;
-        newText: string;
-    }>;
-}
-export interface LspCodeAction {
-    title: string;
-    kind?: string;
-    isPreferred?: boolean;
-}
-export type LspResult = {
-    type: "locations";
-    locations: LspLocation[];
-} | {
-    type: "symbols";
-    symbols: LspSymbol[];
-} | {
-    type: "diagnostics";
-    diagnostics: LspDiagnostic[];
-} | {
-    type: "hover";
-    hover: LspHoverInfo | null;
-} | {
-    type: "completions";
-    completions: LspCompletion[];
-} | {
-    type: "rename";
-    edits: LspRenameEdit[];
-} | {
-    type: "codeActions";
-    actions: LspCodeAction[];
-} | {
-    type: "signatureHelp";
-    signatures: string[];
-};
-/**
- * Host-provided LSP backend.
- * The host manages language server lifecycle and connections.
- */
-export interface LspToolDeps {
-    /** Execute an LSP operation. Host dispatches to appropriate language server. */
-    executeOperation(params: {
-        operation: LspOperation;
-        filePath: string;
-        line?: number;
-        character?: number;
-        newName?: string;
-        includeContext?: boolean;
-    }): Promise<LspResult>;
-    /** Check if file exists and get its size */
-    statFile?(filePath: string): Promise<{
-        exists: boolean;
-        size: number;
-    } | null>;
-    /** Resolve relative path to absolute */
-    resolvePath(filePath: string): string;
-    /** List supported language IDs (e.g. ['typescript', 'python', 'rust']) */
-    supportedLanguages?(): string[];
-}
-export declare function createLspTool(deps: LspToolDeps): PortableTool<LspToolParams>;