qlogicagent 2.20.6 → 2.20.8

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 ["file"];
-            readonly description: "Type of event source to watch. Currently only \"file\" is supported.";
-        };
-        readonly target: {
-            readonly type: "string";
-            readonly description: "Selector for the monitored target. For file: a path or glob pattern.";
-        };
-        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,80 +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;
-    is_instrumental?: boolean;
-    cover_audio_url?: string;
-    audio_format?: string;
-}
-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 is_instrumental: {
-            readonly type: "boolean";
-            readonly description: "Set true for pure instrumental music without vocals. Defaults to true when no lyrics are provided.";
-        };
-        readonly cover_audio_url: {
-            readonly type: "string";
-            readonly description: string;
-        };
-        readonly audio_format: {
-            readonly type: "string";
-            readonly enum: readonly ["mp3", "wav", "flac"];
-            readonly description: "Output audio format. Defaults to mp3.";
-        };
-    };
-    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;
-        isInstrumental?: boolean;
-        audioUrl?: string;
-        audioFormat?: string;
-    }): Promise<MusicGenerateResult>;
-    /**
-     * Optional: auto-generate lyrics from a prompt (MiniMax Lyrics Generation API).
-     * When provided, the tool will auto-call this when no lyrics are supplied
-     * and the song is not marked as instrumental.
-     */
-    generateLyrics?: (prompt: string) => Promise<string>;
-}
-export declare function createMusicGenerateTool(deps: MusicGenerateToolDeps): PortableTool<MusicGenerateToolParams>;

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

@@ -1,15 +0,0 @@
-import type { PortableTool } from "../portable-tool.js";
-export type NotebookEditMode = "replace" | "insert" | "delete";
-export interface NotebookEditParams {
-    /** Absolute path to the .ipynb file */
-    notebook_path: string;
-    /** Cell number (1-based) to operate on */
-    cell_number: number;
-    /** New cell source content (required for replace/insert) */
-    new_source?: string;
-    /** Cell type for insert (default: "code") */
-    cell_type?: "code" | "markdown";
-    /** Edit mode (default: "replace") */
-    edit_mode?: NotebookEditMode;
-}
-export declare function createNotebookEditTool(): PortableTool<NotebookEditParams>;

package/dist/types/skills/tools/preview-browser-tool.d.ts

@@ -1,136 +0,0 @@
-import type { PortableTool } from "../portable-tool.js";
-import { type PreviewBrowserDriveResult, type PreviewBrowserToolParams } from "../../host-contract/index.js";
-export { PREVIEW_BROWSER_ACTIONS } from "../../host-contract/index.js";
-export type { PreviewBrowserAction, PreviewBrowserDriveResult, PreviewBrowserToolParams, } from "../../host-contract/index.js";
-export declare const PREVIEW_BROWSER_TOOL_NAME: "preview_browser";
-export interface PreviewBrowserToolDeps {
-    /**
-     * Drive the host-side preview view for one action. The host renders/executes it and
-     * returns text and/or a screenshot. If the host is not connected or the action fails,
-     * it returns `{ error }` (never silently empty). `signal` aborts an in-flight action.
-     */
-    drive(params: PreviewBrowserToolParams, signal?: AbortSignal): Promise<PreviewBrowserDriveResult>;
-}
-export declare const PREVIEW_BROWSER_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly action: {
-            readonly type: "string";
-            readonly enum: readonly ["navigate", "snapshot", "click", "type", "screenshot", "console", "network"];
-            readonly description: string;
-        };
-        readonly url: {
-            readonly type: "string";
-            readonly description: "URL to open. Required for action 'navigate'.";
-        };
-        readonly ref: {
-            readonly type: "string";
-            readonly description: "aria-ref of the target element, taken from a prior 'snapshot'. Required for 'click' and 'type'.";
-        };
-        readonly text: {
-            readonly type: "string";
-            readonly description: "Text to type into the element. Required for action 'type'.";
-        };
-        readonly submit: {
-            readonly type: "boolean";
-            readonly description: "For 'type': press Enter after typing to submit. Default false.";
-        };
-        readonly viewId: {
-            readonly type: "string";
-            readonly description: string;
-        };
-    };
-    readonly required: readonly ["action"];
-    readonly oneOf: readonly [{
-        readonly type: "object";
-        readonly properties: {
-            readonly action: {
-                readonly type: "string";
-                readonly const: "navigate";
-            };
-            readonly url: {
-                readonly type: "string";
-                readonly description: "URL to open.";
-            };
-            readonly viewId: {
-                type: "string";
-                description: string;
-            };
-        };
-        readonly required: readonly ["action", "url"];
-        readonly additionalProperties: false;
-    }, {
-        readonly type: "object";
-        readonly properties: {
-            readonly action: {
-                readonly type: "string";
-                readonly const: "snapshot";
-            };
-            readonly viewId: {
-                type: "string";
-                description: string;
-            };
-        };
-        readonly required: readonly ["action"];
-        readonly additionalProperties: false;
-    }, {
-        readonly type: "object";
-        readonly properties: {
-            readonly action: {
-                readonly type: "string";
-                readonly const: "click";
-            };
-            readonly ref: {
-                readonly type: "string";
-                readonly description: "aria-ref of the target element.";
-            };
-            readonly viewId: {
-                type: "string";
-                description: string;
-            };
-        };
-        readonly required: readonly ["action", "ref"];
-        readonly additionalProperties: false;
-    }, {
-        readonly type: "object";
-        readonly properties: {
-            readonly action: {
-                readonly type: "string";
-                readonly const: "type";
-            };
-            readonly ref: {
-                readonly type: "string";
-                readonly description: "aria-ref of the target element.";
-            };
-            readonly text: {
-                readonly type: "string";
-                readonly description: "Text to type into the element.";
-            };
-            readonly submit: {
-                readonly type: "boolean";
-                readonly description: "Press Enter after typing. Default false.";
-            };
-            readonly viewId: {
-                type: "string";
-                description: string;
-            };
-        };
-        readonly required: readonly ["action", "ref", "text"];
-        readonly additionalProperties: false;
-    }, ...{
-        type: "object";
-        properties: {
-            action: {
-                type: "string";
-                const: "screenshot" | "console" | "network";
-            };
-            viewId: {
-                type: "string";
-                description: string;
-            };
-        };
-        required: readonly ["action"];
-        additionalProperties: false;
-    }[]];
-};
-export declare function createPreviewBrowserTool(deps: PreviewBrowserToolDeps): PortableTool<PreviewBrowserToolParams>;

package/dist/types/skills/tools/repo-map-tool.d.ts

@@ -1,52 +0,0 @@
-import type { PortableTool } from "../portable-tool.js";
-export declare const REPO_MAP_TOOL_NAME: "repo_map";
-export type RepoMapRefreshMode = "full" | "incremental";
-export type RepoMapSymbolKind = "class" | "function" | "interface" | "type" | "enum" | "constant";
-export interface RepoMapSymbol {
-    kind: RepoMapSymbolKind;
-    name: string;
-    line: number;
-}
-export interface RepoMapFile {
-    path: string;
-    symbols: RepoMapSymbol[];
-    /** Conservative import/module specifiers; a lightweight navigation graph, not compiler resolution. */
-    dependencies?: string[];
-}
-export interface RepoMapMetadata {
-    mode: RepoMapRefreshMode;
-    scannedFiles: number;
-    changedFiles: number;
-    generation: number;
-    totalFiles: number;
-    matchedFiles: number;
-    truncated: boolean;
-    partial?: boolean;
-    stale?: boolean;
-    warning?: string;
-}
-export interface RepoMapResult {
-    files: RepoMapFile[];
-    metadata: RepoMapMetadata;
-}
-export interface RepoMapQuery {
-    query?: string;
-    path?: string;
-    maxFiles?: number;
-    forceFull?: boolean;
-}
-export interface RepoMapService {
-    getMap(query?: RepoMapQuery): Promise<RepoMapResult>;
-}
-export interface RepoMapToolParams {
-    query?: string;
-    path?: string;
-    maxFiles?: number;
-    refresh?: boolean;
-}
-export interface RepoMapToolDeps {
-    workspaceRoot: string;
-    repoMap: RepoMapService;
-    maxResultChars?: number;
-}
-export declare function createRepoMapTool(deps: RepoMapToolDeps): PortableTool<RepoMapToolParams>;

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

@@ -1,142 +0,0 @@
-import type { PortableTool } from "../portable-tool.js";
-import type { WorkspaceSkill } from "../skill-system/skill-types.js";
-export declare const SKILL_VIEW_TOOL_NAME: "skill_view";
-export declare const SKILLS_LIST_TOOL_NAME: "skills_list";
-export declare const SKILL_MANAGE_TOOL_NAME: "skill_manage";
-export type SkillManageAction = "create" | "edit" | "patch" | "delete" | "promote";
-export interface SkillViewParams {
-    name: string;
-    args?: string;
-    filePath?: string;
-}
-export interface SkillsListParams {
-    category?: string;
-}
-export interface SkillManageParams {
-    action: SkillManageAction;
-    name: string;
-    category?: string;
-    content?: string;
-    filePath?: string;
-    fileContent?: string;
-    oldString?: string;
-    newString?: string;
-}
-export declare const SKILL_VIEW_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly name: {
-            readonly type: "string";
-            readonly description: "The skill to use. For a matching workflow, call skill_view before read/search/exec/MCP. Calling skill_view(name='X') loads that skill and you follow its instructions in THIS turn - that single call is all you need to USE a skill.";
-        };
-        readonly args: {
-            readonly type: "string";
-            readonly description: "Optional context/arguments to pass to the skill.";
-        };
-        readonly filePath: {
-            readonly type: "string";
-            readonly description: "Optional path of a supporting file inside the skill folder to read instead of running the skill (e.g. a reference doc or script). When omitted, the skill is loaded and run.";
-        };
-    };
-    readonly required: readonly ["name"];
-};
-export declare const SKILLS_LIST_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly category: {
-            readonly type: "string";
-            readonly description: "Optional category filter.";
-        };
-    };
-    readonly required: readonly [];
-};
-export declare const SKILL_MANAGE_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly action: {
-            readonly type: "string";
-            readonly enum: readonly ["create", "edit", "patch", "delete", "promote"];
-            readonly description: string;
-        };
-        readonly name: {
-            readonly type: "string";
-            readonly description: "The skill name to author or manage.";
-        };
-        readonly category: {
-            readonly type: "string";
-            readonly description: "Classification for create/edit — pick the ONE best-fitting label from: efficiency, dev, writing, data, search, automation, knowledge, lifestyle. Drives the skill card's color/tag on the plugins page.";
-        };
-        readonly content: {
-            readonly type: "string";
-            readonly description: "Full SKILL.md content for create/edit actions.";
-        };
-        readonly filePath: {
-            readonly type: "string";
-            readonly description: "Path of a file inside the skill folder to write with fileContent (create/edit). SKILL.md itself always goes through 'content'.";
-        };
-        readonly fileContent: {
-            readonly type: "string";
-            readonly description: "Supporting file content. With filePath, writes that file inside the skill folder.";
-        };
-        readonly oldString: {
-            readonly type: "string";
-            readonly description: "Text to find for the patch action.";
-        };
-        readonly newString: {
-            readonly type: "string";
-            readonly description: "Replacement text for the patch action.";
-        };
-    };
-    readonly required: readonly ["action", "name"];
-};
-export interface SkillListItem {
-    name: string;
-    description: string;
-    version?: string;
-    category?: string;
-    /** Where the skill lives: "global" (user-level) or "project" (cwd-level). */
-    scope?: "global" | "project" | "plugin" | "config";
-}
-export interface SkillListOutput {
-    skills: SkillListItem[];
-    categories: string[];
-}
-export interface SkillViewOutput {
-    name: string;
-    content: string;
-    skillDir?: string;
-    referenceFiles?: string[];
-}
-export interface SkillManageResult {
-    success: boolean;
-    message: string;
-    path?: string;
-}
-export interface SkillToolDeps {
-    /** List all available skills (Layer 0 metadata). */
-    listSkills(): Promise<WorkspaceSkill[]>;
-    /** List skills with full detail (for skills_list). */
-    listSkillsFull(category?: string): Promise<SkillListOutput>;
-    /** Read skill content (Layer 1 instructions). */
-    readSkillContent(name: string): Promise<string | null>;
-    /** View skill with optional file path. */
-    viewSkill(name: string, filePath?: string): Promise<SkillViewOutput | null>;
-    /** Run a skill — returns its instructions for the main model to follow inline (mainstream, no sub-turn). */
-    runSkillInvocation(skillName: string, skillContent: string, userArgs: string | undefined, skillDir: string | undefined, signal?: AbortSignal): Promise<string>;
-    /** Manage skill (create/edit/patch/delete). */
-    manageSkill(params: {
-        action: string;
-        name: string;
-        category?: string;
-        content?: string;
-        filePath?: string;
-        fileContent?: string;
-        oldString?: string;
-        newString?: string;
-    }): Promise<SkillManageResult>;
-    /** Promote a project-level skill to user/global level. Returns success message. */
-    promoteSkill?(name: string): Promise<SkillManageResult>;
-}
-export declare function createSkillViewTool(deps: SkillToolDeps): PortableTool<SkillViewParams>;
-export declare function createSkillsListTool(deps: SkillToolDeps): PortableTool<SkillsListParams>;
-export declare function createSkillManageTool(deps: SkillToolDeps): PortableTool<SkillManageParams>;

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

@@ -1,49 +0,0 @@
-import type { PortableTool } from "../portable-tool.js";
-export declare const SLEEP_TOOL_NAME: "sleep";
-export interface SleepToolParams {
-    /** Duration to sleep in seconds (1–3600). */
-    duration: number;
-    /** Reason for sleeping — helps the runtime decide whether to interrupt. */
-    reason?: string;
-}
-export declare const SLEEP_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly duration: {
-            readonly type: "number";
-            readonly description: "Duration to sleep in seconds (1–3600). Prefer short sleeps (10–60s) to stay responsive.";
-            readonly minimum: 1;
-            readonly maximum: 3600;
-        };
-        readonly reason: {
-            readonly type: "string";
-            readonly description: string;
-        };
-    };
-    readonly required: readonly ["duration"];
-};
-/** The result returned after a sleep completes or is interrupted. */
-export interface SleepResult {
-    /** Actual time slept in seconds (may be less if interrupted). */
-    sleptSeconds: number;
-    /** Whether the sleep was interrupted before completing. */
-    interrupted: boolean;
-    /** The event that caused the interruption (undefined if not interrupted). */
-    interruptReason?: string;
-}
-/**
- * Runtime dependencies injected by the host.
- *
- * The sleep mechanism is host-provided — the tool itself does NOT call
- * setTimeout. The host decides how to implement the wait (timer, event loop
- * integration, tick prompt scheduling, etc.).
- */
-export interface SleepToolDeps {
-    /**
-     * Perform the actual sleep. Must resolve after `durationMs` or when
-     * interrupted (whichever is first). The AbortSignal fires if the user
-     * or the system requests an interrupt.
-     */
-    sleep(durationMs: number, signal: AbortSignal): Promise<SleepResult>;
-}
-export declare function createSleepTool(deps: SleepToolDeps): PortableTool<SleepToolParams>;

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

@@ -1,33 +0,0 @@
-import type { PortableTool } from "../portable-tool.js";
-export declare const STT_TOOL_NAME: "stt";
-export interface SttToolParams {
-    audio_url: string;
-    language?: string;
-}
-export declare const STT_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly audio_url: {
-            readonly type: "string";
-            readonly description: string;
-        };
-        readonly language: {
-            readonly type: "string";
-            readonly description: "Language hint for transcription: 'zh' (Chinese), 'en' (English), or auto-detect if omitted.";
-        };
-    };
-    readonly required: readonly ["audio_url"];
-};
-export interface SttResult {
-    transcription: string;
-    model?: string;
-    durationMs?: number;
-}
-/** Deps injected by the host runtime for STT. */
-export interface SttToolDeps {
-    speechToText(params: {
-        audioUrl: string;
-        language?: string;
-    }): Promise<SttResult>;
-}
-export declare function createSttTool(deps: SttToolDeps): PortableTool<SttToolParams>;

package/dist/types/skills/tools/subagent-decision-tool.d.ts

@@ -1,15 +0,0 @@
-import type { PortableTool } from "../portable-tool.js";
-export declare const SUBAGENT_DECISION_TOOL_NAME: "subagent_decision";
-export type SubagentDecision = "adopted" | "partially_adopted" | "rejected";
-export interface SubagentDecisionToolParams {
-    subagentId: string;
-    decision: SubagentDecision;
-    summary?: string;
-}
-export interface SubagentDecisionToolDeps {
-    readonly currentTurnId?: string;
-    readonly currentSessionId?: string;
-    getActiveProjectRoot?(): string;
-    sendNotification(method: string, params: Record<string, unknown>): void;
-}
-export declare function createSubagentDecisionTool(deps: SubagentDecisionToolDeps): PortableTool<SubagentDecisionToolParams>;