qlogicagent 0.3.0 → 0.5.0

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

@@ -1,113 +0,0 @@
-import type { PortableTool } from "../portable-tool.js";
-export declare const MONITOR_TOOL_NAME: "monitor";
-/** The kind of event source the agent can monitor. */
-export type MonitorSource = "process" | "file" | "task" | "custom";
-export type MonitorAction = "start" | "stop" | "list";
-export interface MonitorToolParams {
-    action: MonitorAction;
-    /** Required for start/stop — identifies the monitor instance. */
-    monitorId?: string;
-    /** Required for start — what kind of event source to watch. */
-    source?: MonitorSource;
-    /** Required for start — selector for the target (pid, path, taskId, custom key). */
-    target?: string;
-    /** Optional for start — conditions that should trigger wake-up. */
-    conditions?: MonitorCondition[];
-    /** Optional for start — max time to monitor in seconds before auto-stop. */
-    timeoutSeconds?: number;
-}
-export interface MonitorCondition {
-    /** What to check: exit code, stdout pattern, file modification, task status. */
-    type: "exit" | "output_match" | "file_changed" | "task_status";
-    /** Pattern or value to match (regex for output_match, status name for task_status). */
-    value?: string;
-}
-export declare const MONITOR_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly action: {
-            readonly type: "string";
-            readonly enum: readonly ["start", "stop", "list"];
-            readonly description: "Action to perform: start a new monitor, stop an existing one, or list active monitors.";
-        };
-        readonly monitorId: {
-            readonly type: "string";
-            readonly description: "Identifier for the monitor instance. Required for start/stop.";
-        };
-        readonly source: {
-            readonly type: "string";
-            readonly enum: readonly ["process", "file", "task", "custom"];
-            readonly description: "Type of event source to watch.";
-        };
-        readonly target: {
-            readonly type: "string";
-            readonly description: string;
-        };
-        readonly conditions: {
-            readonly type: "array";
-            readonly items: {
-                readonly type: "object";
-                readonly properties: {
-                    readonly type: {
-                        readonly type: "string";
-                        readonly enum: readonly ["exit", "output_match", "file_changed", "task_status"];
-                    };
-                    readonly value: {
-                        readonly type: "string";
-                    };
-                };
-                readonly required: readonly ["type"];
-            };
-            readonly description: "Conditions that trigger a wake-up notification.";
-        };
-        readonly timeoutSeconds: {
-            readonly type: "number";
-            readonly description: "Auto-stop after this many seconds (default: 3600).";
-            readonly minimum: 1;
-            readonly maximum: 86400;
-        };
-    };
-    readonly required: readonly ["action"];
-};
-/** Info about an active monitor. */
-export interface MonitorInfo {
-    monitorId: string;
-    source: MonitorSource;
-    target: string;
-    conditions: MonitorCondition[];
-    startedAt: number;
-    timeoutSeconds: number;
-    /** Events received so far. */
-    eventCount: number;
-}
-/** Result of monitor operations. */
-export interface MonitorResult {
-    action: MonitorAction;
-    success: boolean;
-    monitorId?: string;
-    monitors?: MonitorInfo[];
-    error?: string;
-}
-/**
- * Runtime dependencies injected by the host.
- *
- * The host is responsible for:
- * 1. Actually watching the event source (polling, inotify, process hooks, etc.)
- * 2. Delivering notifications back to the agent loop (via tick or wake-up)
- * 3. Cleaning up monitors when they time out or are stopped.
- */
-export interface MonitorToolDeps {
-    /** Start monitoring a target. Returns the created monitor info. */
-    startMonitor(params: {
-        monitorId: string;
-        source: MonitorSource;
-        target: string;
-        conditions: MonitorCondition[];
-        timeoutSeconds: number;
-    }): Promise<MonitorResult>;
-    /** Stop an active monitor. */
-    stopMonitor(monitorId: string): Promise<MonitorResult>;
-    /** List all active monitors for this session. */
-    listMonitors(): Promise<MonitorInfo[]>;
-}
-export declare function createMonitorTool(deps: MonitorToolDeps): PortableTool<MonitorToolParams>;

package/dist/types/skills/tools/music-generate-tool.d.ts

@@ -1,55 +0,0 @@
-import type { PortableTool } from "../portable-tool.js";
-export declare const MUSIC_GENERATE_TOOL_NAME: "music_generate";
-export interface MusicGenerateToolParams {
-    prompt: string;
-    purpose?: string;
-    style?: string;
-    lyrics?: string;
-    duration?: number;
-}
-export declare const MUSIC_GENERATE_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly prompt: {
-            readonly type: "string";
-            readonly description: string;
-        };
-        readonly purpose: {
-            readonly type: "string";
-            readonly description: "Intended use: 'background-music', 'ringtone', 'short-video-bgm', 'full-song', 'notification-sound', etc.";
-        };
-        readonly style: {
-            readonly type: "string";
-            readonly description: "Musical style/genre: 'lo-fi', 'pop', 'rock', 'jazz', 'classical', 'electronic', 'ambient', etc.";
-        };
-        readonly lyrics: {
-            readonly type: "string";
-            readonly description: "Optional lyrics for vocal music. Structure with [verse], [chorus], [bridge] tags if desired.";
-        };
-        readonly duration: {
-            readonly type: "number";
-            readonly description: "Duration in seconds (5-300). Infer from purpose: ringtone 15-30s, BGM 30-60s, full song 120-180s.";
-        };
-    };
-    readonly required: readonly ["prompt"];
-};
-export interface MusicGenerateResult {
-    mediaUrls: string[];
-    model?: string;
-    durationMs?: number;
-}
-/** Deps injected by the host runtime for music generation. */
-export interface MusicGenerateToolDeps {
-    /**
-     * Generate music via the configured backend.
-     * The host handles model selection, failover, and storage.
-     */
-    generateMusic(params: {
-        prompt: string;
-        purpose?: string;
-        style?: string;
-        lyrics?: string;
-        duration?: number;
-    }): Promise<MusicGenerateResult>;
-}
-export declare function createMusicGenerateTool(deps: MusicGenerateToolDeps): PortableTool<MusicGenerateToolParams>;

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

@@ -1,53 +0,0 @@
-import type { PortableTool } from "../portable-tool.js";
-export declare const NOTIFY_TOOL_NAME: "notify";
-export interface NotifyToolParams {
-    /** Notification message */
-    message: string;
-    /** Optional title/subject */
-    title?: string;
-    /** Priority level */
-    priority?: "low" | "normal" | "high";
-    /** Target channel override (default: user's primary channel) */
-    channel?: string;
-}
-export declare const NOTIFY_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly message: {
-            readonly type: "string";
-            readonly description: "Notification content to send to the user.";
-        };
-        readonly title: {
-            readonly type: "string";
-            readonly description: "Optional notification title/subject line.";
-        };
-        readonly priority: {
-            readonly type: "string";
-            readonly enum: readonly ["low", "normal", "high"];
-            readonly description: "Notification priority (default: normal). High may trigger sound/vibration.";
-        };
-        readonly channel: {
-            readonly type: "string";
-            readonly description: "Target delivery channel (e.g. 'wechat', 'feishu', 'discord'). Default: user's primary.";
-        };
-    };
-    readonly required: readonly ["message"];
-};
-export interface NotifyResult {
-    delivered: boolean;
-    channel: string;
-    error?: string;
-}
-/**
- * Host-provided notification delivery backend.
- */
-export interface NotifyToolDeps {
-    /** Send notification to user. Host routes to correct platform. */
-    sendNotification(params: {
-        message: string;
-        title?: string;
-        priority?: string;
-        channel?: string;
-    }): Promise<NotifyResult>;
-}
-export declare function createNotifyTool(deps: NotifyToolDeps): PortableTool<NotifyToolParams>;

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

@@ -1,45 +0,0 @@
-import type { PortableTool } from "../portable-tool.js";
-export declare const PATCH_TOOL_NAME: "patch";
-export interface PatchToolParams {
-    /** V4A unified diff or simple find-replace */
-    input: string;
-    /** When true, replace all occurrences in each file (default: false) */
-    replaceAll?: boolean;
-}
-export declare const PATCH_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly input: {
-            readonly type: "string";
-            readonly description: string;
-        };
-        readonly replaceAll: {
-            readonly type: "boolean";
-            readonly description: "Replace all occurrences instead of first only (default: false).";
-        };
-    };
-    readonly required: readonly ["input"];
-};
-export interface PatchResult {
-    filesModified: string[];
-    filesAdded: string[];
-    filesDeleted: string[];
-    strategies: Record<string, string>;
-    errors: string[];
-}
-export interface PatchToolDeps {
-    readFile(path: string): Promise<string>;
-    writeFile(path: string, content: string): Promise<void>;
-    deleteFile(path: string): Promise<void>;
-    fileExists(path: string): Promise<boolean>;
-    resolvePath(input: string): string;
-}
-export type MatchStrategy = "exact" | "line_trimmed" | "whitespace_normalized" | "indentation_flexible" | "escape_normalized" | "trimmed_boundary" | "unicode_normalized" | "block_anchor" | "context_aware";
-interface MatchResult {
-    start: number;
-    end: number;
-    strategy: MatchStrategy;
-}
-declare function fuzzyFind(content: string, search: string, replaceAll: boolean): MatchResult[];
-export declare function createPatchTool(deps: PatchToolDeps): PortableTool<PatchToolParams>;
-export { fuzzyFind, type MatchResult };

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

@@ -1,66 +0,0 @@
-import type { PortableTool } from "../portable-tool.js";
-export declare const PDF_TOOL_NAME: "pdf";
-export interface PdfToolParams {
-    prompt?: string;
-    pdf?: string;
-    pdfs?: string[];
-    pages?: string;
-}
-export declare const PDF_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly prompt: {
-            readonly type: "string";
-            readonly description: "Describe what to analyze or extract from the PDF(s).";
-        };
-        readonly pdf: {
-            readonly type: "string";
-            readonly description: "Single PDF path or URL.";
-        };
-        readonly pdfs: {
-            readonly type: "array";
-            readonly items: {
-                readonly type: "string";
-            };
-            readonly description: "Multiple PDF paths or URLs (up to 10).";
-        };
-        readonly pages: {
-            readonly type: "string";
-            readonly description: "Page range to process, e.g. \"1-5\", \"1,3,5-7\". Defaults to all pages.";
-        };
-    };
-    readonly required: readonly [];
-};
-/** Deps injected by the host runtime for PDF analysis. */
-export interface PdfToolDeps {
-    /**
-     * Extract text and/or page images from a PDF.
-     * The host decides how to load (local FS, HTTP, etc.).
-     */
-    extractPdf(source: string, options?: {
-        pages?: string;
-    }): Promise<{
-        text: string;
-        pageImages?: Array<{
-            page: number;
-            base64: string;
-            mimeType: string;
-        }>;
-    }>;
-    /**
-     * Optional: analyze extracted content via LLM.
-     * If not provided, the tool returns raw extracted text.
-     */
-    analyzePdfContent?(prompt: string, content: {
-        text: string;
-        images?: Array<{
-            base64: string;
-            mimeType: string;
-        }>;
-    }): Promise<{
-        text: string;
-        model?: string;
-        provider?: string;
-    }>;
-}
-export declare function createPdfTool(deps: PdfToolDeps): PortableTool<PdfToolParams>;

package/dist/types/skills/tools/plan-mode-tool.d.ts

@@ -1,59 +0,0 @@
-import type { PortableTool } from "../portable-tool.js";
-export declare const PLAN_MODE_TOOL_NAME: "plan_mode";
-export type PlanModeAction = "enter" | "exit";
-export interface PlanModeToolParams {
-    /** Action: enter or exit plan mode */
-    action: PlanModeAction;
-    /** Plan text (for exit — the finalized plan to present for approval) */
-    plan?: string;
-    /** File path where plan was saved (optional) */
-    planFilePath?: string;
-}
-export declare const PLAN_MODE_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly action: {
-            readonly type: "string";
-            readonly enum: readonly ["enter", "exit"];
-            readonly description: string;
-        };
-        readonly plan: {
-            readonly type: "string";
-            readonly description: string;
-        };
-        readonly planFilePath: {
-            readonly type: "string";
-            readonly description: "Optional file path where the plan was saved for reference.";
-        };
-    };
-    readonly required: readonly ["action"];
-};
-/** Tools allowed during plan mode (read-only + reasoning) */
-export declare const PLAN_MODE_ALLOWED_TOOLS: readonly string[];
-export interface PlanModeState {
-    active: boolean;
-    enteredAt?: string;
-    plan?: string;
-    planFilePath?: string;
-}
-export interface PlanModeResult {
-    success: boolean;
-    state: PlanModeState;
-    allowedTools?: readonly string[];
-    error?: string;
-}
-/**
- * Host-provided plan mode backend.
- * The host is responsible for filtering tool availability based on mode state.
- */
-export interface PlanModeToolDeps {
-    /** Get current plan mode state */
-    getState(): PlanModeState;
-    /** Enter plan mode — host should restrict tool availability */
-    enterPlanMode(): Promise<PlanModeResult>;
-    /** Exit plan mode — host restores full tool availability */
-    exitPlanMode(plan?: string, planFilePath?: string): Promise<PlanModeResult>;
-    /** Check if in agent/sub-agent context (plan mode not allowed in sub-agents) */
-    isAgentContext?(): boolean;
-}
-export declare function createPlanModeTool(deps: PlanModeToolDeps): PortableTool<PlanModeToolParams>;

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

@@ -1,51 +0,0 @@
-import type { PortableTool } from "../portable-tool.js";
-export declare const READ_TOOL_NAME: "read";
-export interface ReadToolParams {
-    path: string;
-    offset?: number;
-    limit?: number;
-}
-export declare const READ_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly path: {
-            readonly type: "string";
-            readonly description: "Absolute path to the file to read.";
-        };
-        readonly offset: {
-            readonly type: "number";
-            readonly description: "Line number to start reading from (1-indexed). Default: 1.";
-        };
-        readonly limit: {
-            readonly type: "number";
-            readonly description: "Maximum number of lines to read. Default/max: 2000.";
-        };
-    };
-    readonly required: readonly ["path"];
-};
-export type ReadResultType = "text" | "image" | "binary_rejected";
-/** Deps injected by the host runtime for file reading. */
-export interface ReadToolDeps {
-    /** Read file content. Return string for text, base64 for images, or rejection. */
-    readFile(path: string): Promise<{
-        type: "text";
-        text: string;
-    } | {
-        type: "image";
-        base64: string;
-        mimeType: string;
-    } | {
-        type: "binary";
-        mimeType: string;
-    }>;
-    /** Resolve a relative path to absolute. */
-    resolvePath(input: string): string;
-    /**
-     * Validate read access for the given path.
-     * Returns null if allowed, or an error message if blocked.
-     * Blocks device paths (/dev/zero, /dev/random, etc.) and
-     * paths outside the allowed workspace.
-     */
-    validatePath?(path: string): string | null;
-}
-export declare function createReadTool(deps: ReadToolDeps): PortableTool<ReadToolParams>;

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

@@ -1,70 +0,0 @@
-import type { PortableTool } from "../portable-tool.js";
-export declare const REPL_TOOL_NAME: "repl";
-export interface ReplToolParams {
-    /** JavaScript code to execute in the persistent VM context */
-    code: string;
-}
-export declare const REPL_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly code: {
-            readonly type: "string";
-            readonly description: string;
-        };
-    };
-    readonly required: readonly ["code"];
-};
-export interface ReplExecResult {
-    output: string;
-    error?: string;
-    duration: number;
-}
-/** Primitive operations injected into the VM context. */
-export interface ReplPrimitives {
-    readFile(path: string): Promise<string>;
-    writeFile(path: string, content: string): Promise<void>;
-    editFile(path: string, edits: Array<{
-        oldText: string;
-        newText: string;
-    }>): Promise<string>;
-    exec(command: string): Promise<{
-        stdout: string;
-        stderr: string;
-        exitCode: number;
-    }>;
-    glob(pattern: string): Promise<string[]>;
-    grep(pattern: string, path?: string): Promise<Array<{
-        file: string;
-        line: number;
-        text: string;
-    }>>;
-}
-/**
- * Host-provided REPL execution backend.
- */
-export interface ReplToolDeps {
-    /**
-     * Execute JavaScript code within a persistent VM context.
-     * The VM is pre-initialized with the primitive functions above.
-     * Each tool invocation reuses the same VM (preserving variable state).
-     */
-    executeInVm(code: string): Promise<ReplExecResult>;
-    /**
-     * Reset the VM context (clear state). Optional hook called on errors.
-     */
-    resetVm?(): void;
-    /**
-     * The host-provided primitives injected into the VM.
-     * When provided, the tool validates that the host has set up all required primitives.
-     */
-    primitives?: ReplPrimitives;
-    /**
-     * Permission check for individual primitive operations.
-     * Called before each primitive executes inside the VM.
-     * Returns null if allowed, or an error message if denied.
-     */
-    checkPermission?(operation: string, args: unknown[]): Promise<string | null>;
-}
-/** Tool names that should be hidden from direct LLM access when REPL is active. */
-export declare const REPL_HIDES_TOOLS: readonly string[];
-export declare function createReplTool(deps: ReplToolDeps): PortableTool<ReplToolParams>;

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

@@ -1,112 +0,0 @@
-import type { PortableTool } from "../portable-tool.js";
-export declare const SEARCH_TOOL_NAME: "search";
-export type SearchMode = "filename" | "content" | "both";
-export interface SearchToolParams {
-    mode: SearchMode;
-    pattern: string;
-    path?: string;
-    fileGlob?: string;
-    contextLines?: number;
-    caseInsensitive?: boolean;
-    headLimit?: number;
-    offset?: number;
-}
-export declare const SEARCH_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly mode: {
-            readonly type: "string";
-            readonly enum: readonly ["filename", "content", "both"];
-            readonly description: string;
-        };
-        readonly pattern: {
-            readonly type: "string";
-            readonly description: string;
-        };
-        readonly path: {
-            readonly type: "string";
-            readonly description: "Directory to search in. Defaults to workdir/cwd if omitted.";
-        };
-        readonly fileGlob: {
-            readonly type: "string";
-            readonly description: string;
-        };
-        readonly contextLines: {
-            readonly type: "number";
-            readonly description: string;
-        };
-        readonly caseInsensitive: {
-            readonly type: "boolean";
-            readonly description: "Case insensitive search (content/both modes). Default: false.";
-        };
-        readonly headLimit: {
-            readonly type: "number";
-            readonly description: string;
-        };
-        readonly offset: {
-            readonly type: "number";
-            readonly description: "Skip first N results before applying headLimit. Default: 0.";
-        };
-    };
-    readonly required: readonly ["mode", "pattern"];
-};
-export interface SearchFileResult {
-    path: string;
-}
-export interface SearchContentResult {
-    path: string;
-    line: number;
-    text: string;
-    contextBefore?: string[];
-    contextAfter?: string[];
-}
-export interface SearchOutput {
-    mode: SearchMode;
-    totalMatches: number;
-    truncated: boolean;
-    fileResults?: SearchFileResult[];
-    contentResults?: SearchContentResult[];
-}
-/** Host-provided search backend. */
-export interface SearchToolDeps {
-    /**
-     * Find files matching a glob pattern.
-     * Returns array of relative file paths.
-     * The host SHOULD auto-exclude VCS directories (.git, .svn, .hg, .bzr)
-     * unless the user explicitly includes them.
-     */
-    glob(pattern: string, options: {
-        cwd: string;
-        limit: number;
-    }): Promise<{
-        files: string[];
-        truncated: boolean;
-    }>;
-    /**
-     * Search file contents using regex.
-     * The implementation may use ripgrep, native grep, or a custom engine.
-     * Returns match records.
-     * The host SHOULD auto-exclude VCS directories (.git, .svn, .hg, .bzr)
-     * and enforce --max-columns 500 to avoid minified file noise.
-     */
-    grep(pattern: string, options: {
-        cwd: string;
-        fileGlob?: string;
-        caseInsensitive?: boolean;
-        contextLines?: number;
-        headLimit?: number;
-        offset?: number;
-    }): Promise<{
-        matches: Array<{
-            path: string;
-            line: number;
-            text: string;
-            contextBefore?: string[];
-            contextAfter?: string[];
-        }>;
-        truncated: boolean;
-    }>;
-    /** Resolve relative path to absolute. If omitted, cwd is used. */
-    resolvePath?(input: string): string;
-}
-export declare function createSearchTool(deps: SearchToolDeps): PortableTool<SearchToolParams>;

package/dist/types/skills/tools/send-message-tool.d.ts

@@ -1,51 +0,0 @@
-import type { PortableTool } from "../portable-tool.js";
-export declare const SEND_MESSAGE_TOOL_NAME: "send_message";
-export interface SendMessageToolParams {
-    /** Target agent name or '*' for broadcast */
-    to: string;
-    /** Message content */
-    message: string;
-    /** Optional short summary for routing/display */
-    summary?: string;
-}
-export declare const SEND_MESSAGE_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly to: {
-            readonly type: "string";
-            readonly description: string;
-        };
-        readonly message: {
-            readonly type: "string";
-            readonly description: "Message content to send to the target agent.";
-        };
-        readonly summary: {
-            readonly type: "string";
-            readonly description: "Optional short summary (for logging/routing).";
-        };
-    };
-    readonly required: readonly ["to", "message"];
-};
-export interface SendMessageResult {
-    success: boolean;
-    recipients?: string[];
-    error?: string;
-}
-/**
- * Host-provided message routing backend.
- * Messages are delivered asynchronously via mailbox pattern.
- */
-export interface SendMessageToolDeps {
-    /** Send message to target agent(s). Returns delivery status. */
-    sendMessage(params: {
-        to: string;
-        message: string;
-        summary?: string;
-        senderId: string;
-    }): Promise<SendMessageResult>;
-    /** Get the current agent's ID */
-    getSenderId(): string;
-    /** List available teammates */
-    listTeammates?(): string[];
-}
-export declare function createSendMessageTool(deps: SendMessageToolDeps): PortableTool<SendMessageToolParams>;