qlogicagent 2.20.6 → 2.20.7

package/dist/types/skills/memory/memory-tool.d.ts

@@ -1,87 +0,0 @@
-import type { MemoryProvider, MemorySearchResult, MemoryToolLocalProvider, ProjectMemoryStore } from "../../runtime/ports/index.js";
-export declare const MEMORY_TOOL_NAME: "memory";
-export declare const MEMORY_TOOL_LABEL = "Memory";
-export declare const MEMORY_TOOL_ACTIONS: readonly ["add", "replace", "remove", "create_file", "write_file", "read_file", "delete_file", "list_files", "search", "remember", "temporal", "feedback"];
-export type MemoryToolAction = (typeof MEMORY_TOOL_ACTIONS)[number];
-export declare const MEMORY_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly action: {
-            readonly type: "string";
-            readonly enum: string[];
-            readonly description: string;
-        };
-        readonly content: {
-            readonly type: "string";
-            readonly description: string;
-        };
-        readonly old_text: {
-            readonly type: "string";
-            readonly description: "For 'replace'/'remove': the exact text to find in INDEX.md.";
-        };
-        readonly new_text: {
-            readonly type: "string";
-            readonly description: "For 'replace': the replacement text.";
-        };
-        readonly file: {
-            readonly type: "string";
-            readonly description: "Filename for file operations (e.g. 'project-notes.md', 'lesson-esbuild.md'). Must be kebab-case .md.";
-        };
-        readonly query: {
-            readonly type: "string";
-            readonly description: "For 'search'/'temporal': natural language query to find relevant memories.";
-        };
-        readonly days: {
-            readonly type: "number";
-            readonly description: "For 'temporal': look back N days from today (default: 7).";
-        };
-        readonly memory_ids: {
-            readonly type: "array";
-            readonly items: {
-                readonly type: "string";
-            };
-            readonly description: "For 'feedback': IDs of memories to give feedback on.";
-        };
-        readonly signal: {
-            readonly type: "string";
-            readonly enum: readonly ["useful", "irrelevant", "outdated", "wrong"];
-            readonly description: "For 'feedback': the feedback signal to apply.";
-        };
-        readonly category: {
-            readonly type: "string";
-            readonly enum: string[];
-            readonly description: "For 'remember': categorize the memory (helps with future recall precision).";
-        };
-    };
-    readonly required: readonly ["action"];
-};
-export declare const MEMORY_TOOL_DESCRIPTION: string;
-export declare function isMemoryContentSafe(text: string): boolean;
-export interface MemoryToolParams {
-    action: MemoryToolAction;
-    content?: string;
-    old_text?: string;
-    new_text?: string;
-    file?: string;
-    query?: string;
-    days?: number;
-    memory_ids?: string[];
-    signal?: "useful" | "irrelevant" | "outdated" | "wrong";
-    category?: string;
-}
-export interface MemoryToolResult {
-    ok: boolean;
-    message: string;
-    action: string;
-    results?: MemorySearchResult[];
-}
-export interface MemoryToolExecutorDeps {
-    memdir: ProjectMemoryStore;
-    provider?: MemoryProvider;
-    /** Runtime memory provider for temporal/feedback (typed narrow for advanced ops). */
-    localProvider?: MemoryToolLocalProvider;
-    userId: string;
-    /** Owning foreground session for user-visible memory mutations. */
-    sessionId?: string;
-}
-export declare function executeMemoryTool(params: MemoryToolParams, deps: MemoryToolExecutorDeps): Promise<MemoryToolResult>;

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

@@ -1,66 +0,0 @@
-import type { PortableTool } from "../portable-tool.js";
-export declare const CHECKPOINT_TOOL_NAME: "checkpoint";
-export type CheckpointAction = "create" | "list" | "restore" | "diff";
-export interface CheckpointToolParams {
-    action: CheckpointAction;
-    /** Checkpoint ID (for restore/diff) */
-    checkpointId?: string;
-    /** Optional message for create */
-    message?: string;
-    /** File paths to restore (partial restore). If empty, restores all. */
-    paths?: string[];
-}
-export declare const CHECKPOINT_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly action: {
-            readonly type: "string";
-            readonly enum: readonly ["create", "list", "restore", "diff"];
-            readonly description: string;
-        };
-        readonly checkpointId: {
-            readonly type: "string";
-            readonly description: "Checkpoint ID. Required for restore and diff.";
-        };
-        readonly message: {
-            readonly type: "string";
-            readonly description: "Optional descriptive message for the checkpoint.";
-        };
-        readonly paths: {
-            readonly type: "array";
-            readonly items: {
-                readonly type: "string";
-            };
-            readonly description: "File paths to restore (partial restore). Omit to restore everything.";
-        };
-    };
-    readonly required: readonly ["action"];
-};
-export interface Checkpoint {
-    id: string;
-    message: string;
-    timestamp: string;
-    fileCount: number;
-}
-export interface CheckpointResult {
-    success: boolean;
-    checkpoint?: Checkpoint;
-    checkpoints?: Checkpoint[];
-    diff?: string;
-    error?: string;
-}
-/**
- * Host-provided checkpoint backend.
- * Uses shadow git repos (isolated from user project) for snapshots.
- */
-export interface CheckpointToolDeps {
-    /** Create a snapshot of the current workspace state */
-    createCheckpoint(message?: string): Promise<CheckpointResult>;
-    /** List all available checkpoints */
-    listCheckpoints(): Promise<CheckpointResult>;
-    /** Restore workspace to a checkpoint state (optionally partial) */
-    restoreCheckpoint(checkpointId: string, paths?: string[]): Promise<CheckpointResult>;
-    /** Show diff between current state and a checkpoint */
-    diffCheckpoint(checkpointId: string): Promise<CheckpointResult>;
-}
-export declare function createCheckpointTool(deps: CheckpointToolDeps): PortableTool<CheckpointToolParams>;

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

@@ -1,61 +0,0 @@
-import type { PortableTool } from "../portable-tool.js";
-export declare const CONFIG_TOOL_NAME: "config";
-export type ConfigAction = "get" | "set" | "list" | "reset";
-export interface ConfigToolParams {
-    /** Config action */
-    action: ConfigAction;
-    /** Setting key path (e.g. "model", "language", "theme") */
-    key?: string;
-    /** Value to set (for 'set' action) */
-    value?: string | boolean | number;
-}
-export declare const CONFIG_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly action: {
-            readonly type: "string";
-            readonly enum: readonly ["get", "set", "list", "reset"];
-            readonly description: string;
-        };
-        readonly key: {
-            readonly type: "string";
-            readonly description: string;
-        };
-        readonly value: {
-            readonly description: "Value to set. Type must match the tunable (numeric strings are coerced). Required for 'set'.";
-        };
-    };
-    readonly required: readonly ["action"];
-};
-export interface ConfigSetting {
-    key: string;
-    value: unknown;
-    type: "string" | "boolean" | "number" | "enum";
-    description: string;
-    options?: string[];
-    readOnly?: boolean;
-}
-export interface ConfigResult {
-    success: boolean;
-    setting?: ConfigSetting;
-    settings?: ConfigSetting[];
-    previousValue?: unknown;
-    error?: string;
-}
-/**
- * Host-provided config backend.
- * Manages persistent agent settings with safety guardrails.
- */
-export interface ConfigToolDeps {
-    /** Get a single config value */
-    getConfig(key: string): Promise<ConfigResult>;
-    /** Set a config value (respects readonly/whitelist) */
-    setConfig(key: string, value: unknown): Promise<ConfigResult>;
-    /** List all available config settings */
-    listConfig(): Promise<ConfigResult>;
-    /** Reset a setting to default */
-    resetConfig(key: string): Promise<ConfigResult>;
-    /** Check if a key is supported/valid */
-    isValidKey?(key: string): boolean;
-}
-export declare function createConfigTool(deps: ConfigToolDeps): PortableTool<ConfigToolParams>;

package/dist/types/skills/tools/file-management-tool.d.ts

@@ -1,90 +0,0 @@
-import type { PortableTool } from "../portable-tool.js";
-export declare const FILE_UPLOAD_TOOL_NAME: "file_upload";
-export interface FileUploadToolParams {
-    file_path: string;
-    purpose?: string;
-}
-export declare const FILE_UPLOAD_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly file_path: {
-            readonly type: "string";
-            readonly description: string;
-        };
-        readonly purpose: {
-            readonly type: "string";
-            readonly description: string;
-        };
-    };
-    readonly required: readonly ["file_path"];
-};
-export interface FileUploadResult {
-    fileId: string;
-    url?: string;
-    filename: string;
-    bytes: number;
-    provider: string;
-}
-export interface FileUploadToolDeps {
-    uploadFile(params: {
-        filePath: string;
-        purpose?: string;
-    }): Promise<FileUploadResult>;
-}
-export declare function createFileUploadTool(deps: FileUploadToolDeps): PortableTool<FileUploadToolParams>;
-export declare const FILE_QUERY_TOOL_NAME: "file_query";
-export interface FileQueryToolParams {
-    file_id?: string;
-    limit?: number;
-}
-export declare const FILE_QUERY_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly file_id: {
-            readonly type: "string";
-            readonly description: "Query a specific file by ID. If omitted, lists recent uploaded files.";
-        };
-        readonly limit: {
-            readonly type: "number";
-            readonly description: "Max number of files to list when file_id is omitted. Default: 10, max: 100.";
-        };
-    };
-    readonly required: readonly [];
-};
-export interface FileInfo {
-    id: string;
-    filename: string;
-    bytes: number;
-    status: string;
-    createdAt?: string;
-    url?: string;
-}
-export interface FileQueryToolDeps {
-    queryFile(params: {
-        fileId: string;
-    }): Promise<FileInfo>;
-    listFiles(params: {
-        limit?: number;
-    }): Promise<FileInfo[]>;
-}
-export declare function createFileQueryTool(deps: FileQueryToolDeps): PortableTool<FileQueryToolParams>;
-export declare const FILE_DELETE_TOOL_NAME: "file_delete";
-export interface FileDeleteToolParams {
-    file_id: string;
-}
-export declare const FILE_DELETE_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly file_id: {
-            readonly type: "string";
-            readonly description: "ID of the uploaded file to delete.";
-        };
-    };
-    readonly required: readonly ["file_id"];
-};
-export interface FileDeleteToolDeps {
-    deleteFile(params: {
-        fileId: string;
-    }): Promise<void>;
-}
-export declare function createFileDeleteTool(deps: FileDeleteToolDeps): PortableTool<FileDeleteToolParams>;

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

@@ -1,98 +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;
-    output_path?: string;
-    output_paths?: string[];
-    n?: number;
-    quality?: string;
-    seed?: 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: string;
-        };
-        readonly image_url: {
-            readonly type: "string";
-            readonly description: string;
-        };
-        readonly output_path: {
-            readonly type: "string";
-            readonly description: "Optional absolute or workspace-relative path where the generated image should be saved. Use only for a single generated image.";
-        };
-        readonly output_paths: {
-            readonly type: "array";
-            readonly items: {
-                readonly type: "string";
-            };
-            readonly description: "Optional absolute or workspace-relative paths where generated images should be saved. Must match the number of generated images.";
-        };
-        readonly n: {
-            readonly type: "number";
-            readonly description: "Number of images to generate (1-4). Default: 1.";
-        };
-        readonly quality: {
-            readonly type: "string";
-            readonly description: "Image quality level: 'auto', 'high', 'low', 'hd'. Provider-specific.";
-        };
-        readonly seed: {
-            readonly type: "number";
-            readonly description: "Random seed for reproducible generation. Same seed + prompt = same result.";
-        };
-    };
-    readonly required: readonly ["prompt"];
-};
-export interface ImageGenerateResult {
-    mediaUrls: string[];
-    model?: string;
-    size?: string;
-    durationMs?: number;
-}
-export interface SavedGeneratedImage {
-    remoteUrl: string;
-    localPath: string;
-    bytes: number;
-    mimeType: string;
-    headerHex?: string;
-}
-/** 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;
-        quality?: string;
-        seed?: number;
-    }): Promise<ImageGenerateResult>;
-    saveGeneratedImages?(params: {
-        mediaUrls: string[];
-        outputPaths: string[];
-    }): Promise<SavedGeneratedImage[]>;
-}
-export declare function createImageGenerateTool(deps: ImageGenerateToolDeps): PortableTool<ImageGenerateToolParams>;

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

@@ -1,65 +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 | Promise<InstructionFileContent>;
-    /** Remove an instruction file. Returns true if deleted. */
-    remove(projectId: string, filename: string): boolean | Promise<boolean>;
-}
-export declare const INSTRUCTIONS_TOOL_NAME: "instructions";
-export type InstructionsAction = "list" | "read" | "write" | "edit" | "delete";
-export interface InstructionsToolParams {
-    action: InstructionsAction;
-    project_id: string;
-    filename?: string;
-    content?: string;
-    old_text?: string;
-    new_text?: string;
-}
-export declare const INSTRUCTIONS_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly action: {
-            readonly type: "string";
-            readonly enum: readonly ["list", "read", "write", "edit", "delete"];
-            readonly description: "Operation: list all files, read a file, write (create/overwrite), edit (partial replace), or delete a file.";
-        };
-        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\"). Required for read/write/delete. Sub-paths like \"testing/unit-test.md\" are supported.";
-        };
-        readonly content: {
-            readonly type: "string";
-            readonly description: "Markdown content for the instruction file. Required for write action.";
-        };
-        readonly old_text: {
-            readonly type: "string";
-            readonly description: "Required for edit action: the exact existing text to find and replace (must appear exactly once).";
-        };
-        readonly new_text: {
-            readonly type: "string";
-            readonly description: "Required for edit action: the replacement text.";
-        };
-    };
-    readonly required: readonly ["action", "project_id"];
-};
-export declare function createInstructionsTool(deps: InstructionsToolDeps): PortableTool<InstructionsToolParams>;

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;
-    }, signal?: AbortSignal): 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>;

package/dist/types/skills/tools/media-cancel-tool.d.ts

@@ -1,30 +0,0 @@
-import type { PortableTool } from "../portable-tool.js";
-export declare const MEDIA_CANCEL_TOOL_NAME: "media_cancel";
-export interface MediaCancelToolParams {
-    task_id: string;
-    provider?: string;
-}
-export declare const MEDIA_CANCEL_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly task_id: {
-            readonly type: "string";
-            readonly description: "The task ID of the media generation to cancel (returned in previous generation results).";
-        };
-        readonly provider: {
-            readonly type: "string";
-            readonly description: "Provider name (e.g. 'doubao', 'zhipu'). If omitted, auto-detects from task context.";
-        };
-    };
-    readonly required: readonly ["task_id"];
-};
-export interface MediaCancelToolDeps {
-    cancelTask(params: {
-        taskId: string;
-        provider?: string;
-    }): Promise<{
-        ok: boolean;
-        message: string;
-    }>;
-}
-export declare function createMediaCancelTool(deps: MediaCancelToolDeps): PortableTool<MediaCancelToolParams>;

package/dist/types/skills/tools/media-understand-tool.d.ts

@@ -1,28 +0,0 @@
-import type { PortableTool } from "../portable-tool.js";
-export declare const IMAGE_UNDERSTAND_TOOL_NAME: "image_understand";
-export declare const VIDEO_UNDERSTAND_TOOL_NAME: "video_understand";
-export interface MediaUnderstandToolParams {
-    query?: string;
-    /** The URL field name varies per tool (image_url / video_url), so it's read via the index. */
-    [key: string]: unknown;
-}
-/** What the injected backend returns for one understanding call. */
-export interface MediaUnderstandOutcome {
-    /** The model's answer/description (empty ⇔ nothing usable came back — see `failure`). */
-    text: string;
-    /** Why `text` is empty: "fetch_failed" (medium never reached the model) / "stream_error" /
-     * "empty_output" (model saw it, said nothing) / "no_model" (purpose unbound). undefined ⇔ success. */
-    failure?: string;
-    /** Input tokens billed, if known (diagnostic — a near-zero value on a media request corroborates fetch_failed). */
-    promptTokens?: number;
-    /** The resolved understanding model id, for the tool details. */
-    model?: string;
-}
-export interface MediaUnderstandToolDeps {
-    understand(params: {
-        url: string;
-        query?: string;
-    }): Promise<MediaUnderstandOutcome>;
-}
-export declare function createImageUnderstandTool(deps: MediaUnderstandToolDeps): PortableTool<MediaUnderstandToolParams>;
-export declare function createVideoUnderstandTool(deps: MediaUnderstandToolDeps): PortableTool<MediaUnderstandToolParams>;