qlogicagent 0.3.0 → 0.4.0

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

@@ -1,16 +0,0 @@
-import type { PortableTool } from "./portable-tool.js";
-export declare const THINK_TOOL_NAME: "think";
-export interface ThinkToolParams {
-    thought: string;
-}
-export declare const THINK_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly thought: {
-            readonly type: "string";
-            readonly description: string;
-        };
-    };
-    readonly required: readonly ["thought"];
-};
-export declare function createThinkTool(): PortableTool<ThinkToolParams>;

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

@@ -1,63 +0,0 @@
-import type { TodoItem } from "../contracts/todo.js";
-import type { PortableTool } from "./portable-tool.js";
-export declare const TODO_TOOL_NAME: "todo";
-export interface TodoToolParams {
-    todoList: TodoItem[];
-}
-export declare const TODO_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly todoList: {
-            readonly type: "array";
-            readonly description: string;
-            readonly items: {
-                readonly type: "object";
-                readonly properties: {
-                    readonly id: {
-                        readonly type: "number";
-                        readonly description: "Unique numeric id (sequential from 1).";
-                    };
-                    readonly title: {
-                        readonly type: "string";
-                        readonly description: "Concise action-oriented label (3-7 words). Displayed in UI.";
-                    };
-                    readonly status: {
-                        readonly type: "string";
-                        readonly enum: readonly ["not-started", "in-progress", "completed"];
-                        readonly description: "not-started | in-progress (max 1) | completed";
-                    };
-                };
-                readonly required: readonly ["id", "title", "status"];
-            };
-        };
-    };
-    readonly required: readonly ["todoList"];
-};
-/**
- * Configuration for todo tool behavior (CC-aligned features).
- */
-export interface TodoToolOptions {
-    /**
-     * Unique agent/session identifier for per-agent todo isolation.
-     * When provided, different agents have independent todo lists.
-     */
-    agentId?: string;
-    /**
-     * Whether verification nudge is enabled.
-     * When all items are completed (≥3 items, none matching /verif/i),
-     * the tool signals that a verification sub-agent should be spawned.
-     */
-    enableVerificationNudge?: boolean;
-    /**
-     * Whether to auto-clear the list when all items are completed.
-     * Matches CC behavior: allDone → newTodos = [].
-     */
-    autoClearOnComplete?: boolean;
-}
-/**
- * Create a stateful todo tool instance.
- *
- * Each call returns a tool with its own session-local list.
- * Multiple instances can exist for different sessions/agents.
- */
-export declare function createTodoTool(options?: TodoToolOptions): PortableTool<TodoToolParams>;

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

@@ -1,91 +0,0 @@
-import type { PortableTool } from "../portable-tool.js";
-export declare const AGENT_TOOL_NAME: "agent";
-/**
- * Built-in agent types (CC-aligned registry).
- * The LLM selects which agent to fork based on the task.
- */
-export type BuiltInAgentType = "general" | "explore" | "plan" | "code" | "research" | "verify";
-export declare const BUILT_IN_AGENT_TYPES: BuiltInAgentType[];
-export interface AgentToolParams {
-    /** Built-in agent type to invoke. */
-    agent: BuiltInAgentType;
-    /** Detailed task prompt for the sub-agent. */
-    prompt: string;
-    /** Short description of the task (3-7 words). Used for status display. */
-    description?: string;
-    /** Max turns override (default varies by agent type). */
-    maxTurns?: number;
-    /** Run in background (returns task_id immediately). */
-    background?: boolean;
-}
-export declare const AGENT_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly agent: {
-            readonly type: "string";
-            readonly enum: readonly ["general", "explore", "plan", "code", "research", "verify"];
-            readonly description: string;
-        };
-        readonly prompt: {
-            readonly type: "string";
-            readonly description: string;
-        };
-        readonly description: {
-            readonly type: "string";
-            readonly description: "Short description (3-7 words) for status tracking.";
-        };
-        readonly maxTurns: {
-            readonly type: "number";
-            readonly description: "Max turns for the sub-agent. Defaults: general=200, explore=50, plan=80, code=200, research=30, verify=40.";
-        };
-        readonly background: {
-            readonly type: "boolean";
-            readonly description: "If true, runs in background and returns a task_id. Poll with task tool. Default: false.";
-        };
-    };
-    readonly required: readonly ["agent", "prompt"];
-    readonly additionalProperties: false;
-};
-export interface AgentResult {
-    agentId: string;
-    status: "completed" | "running" | "failed";
-    output?: string;
-    error?: string;
-    maxTurnsReached?: boolean;
-    tokensUsed?: number;
-}
-/**
- * Host-provided fork execution backend (CC-aligned).
- *
- * Key properties of the fork mechanism:
- * 1. Child shares parent's message prefix (prompt cache hit)
- * 2. Child uses byte-identical prefix via placeholder results
- * 3. Child has independent tool context (isolation)
- * 4. Results flow back via in-memory streaming (not DB)
- * 5. Fork depth tracked in-memory (max 4 layers)
- */
-export interface AgentToolDeps {
-    /**
-     * Fork and run a sub-agent.
-     * The implementation must:
-     * - Share parent's rendered system prompt (byte-identical for cache)
-     * - Inherit parent's tool pool (filtered by agent definition)
-     * - Track fork depth (reject if > MAX_FORK_DEPTH)
-     * - Return output via in-memory streaming backflow
-     */
-    forkAgent(params: {
-        agent: BuiltInAgentType;
-        prompt: string;
-        description?: string;
-        maxTurns?: number;
-        background?: boolean;
-        abortSignal?: AbortSignal;
-    }): Promise<AgentResult>;
-    /** Abort signal from the parent turn. */
-    abortSignal?: AbortSignal;
-    /** Current fork depth (0 = root). Used for depth guard. */
-    currentForkDepth?: number;
-}
-/** Maximum fork depth for in-memory agents. */
-export declare const MAX_FORK_DEPTH = 4;
-export declare function createAgentTool(deps: AgentToolDeps): PortableTool<AgentToolParams>;

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

@@ -1,29 +0,0 @@
-import type { PortableTool } from "../portable-tool.js";
-export declare const APPLY_PATCH_TOOL_NAME: "apply_patch";
-export interface ApplyPatchToolParams {
-    input: string;
-}
-export declare const APPLY_PATCH_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly input: {
-            readonly type: "string";
-            readonly description: "Patch content using the *** Begin Patch / *** End Patch format.";
-        };
-    };
-    readonly required: readonly ["input"];
-};
-export interface ApplyPatchSummary {
-    added: string[];
-    modified: string[];
-    deleted: string[];
-}
-/** Deps injected by the host runtime for file patching. */
-export interface ApplyPatchToolDeps {
-    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 declare function createApplyPatchTool(deps: ApplyPatchToolDeps): PortableTool<ApplyPatchToolParams>;

package/dist/types/skills/tools/ask-user-tool.d.ts

@@ -1,80 +0,0 @@
-import type { PortableTool } from "../portable-tool.js";
-export declare const ASK_USER_TOOL_NAME: "ask_user";
-export interface AskUserOption {
-    label: string;
-    description?: string;
-}
-export interface AskUserQuestion {
-    question: string;
-    header: string;
-    options?: AskUserOption[];
-    multiSelect?: boolean;
-}
-export interface AskUserToolParams {
-    questions: AskUserQuestion[];
-}
-export declare const ASK_USER_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly questions: {
-            readonly type: "array";
-            readonly minItems: 1;
-            readonly maxItems: 4;
-            readonly description: "1-4 clarifying questions to ask the user.";
-            readonly items: {
-                readonly type: "object";
-                readonly properties: {
-                    readonly question: {
-                        readonly type: "string";
-                        readonly description: "The question text. Should end with '?'.";
-                    };
-                    readonly header: {
-                        readonly type: "string";
-                        readonly description: "Short identifier/tag for this question (max 50 chars).";
-                    };
-                    readonly options: {
-                        readonly type: "array";
-                        readonly description: "2-4 options for the user to choose from. Omit for free text.";
-                        readonly items: {
-                            readonly type: "object";
-                            readonly properties: {
-                                readonly label: {
-                                    readonly type: "string";
-                                    readonly description: "Display label (1-5 words).";
-                                };
-                                readonly description: {
-                                    readonly type: "string";
-                                    readonly description: "Brief explanation of this option.";
-                                };
-                            };
-                            readonly required: readonly ["label"];
-                        };
-                    };
-                    readonly multiSelect: {
-                        readonly type: "boolean";
-                        readonly description: "Allow selecting multiple options (default: false).";
-                    };
-                };
-                readonly required: readonly ["question", "header"];
-            };
-        };
-    };
-    readonly required: readonly ["questions"];
-};
-export interface AskUserAnswer {
-    question: string;
-    answer: string;
-}
-/**
- * Host-provided user interaction backend.
- * The host renders the questions in the UI and collects answers.
- */
-export interface AskUserToolDeps {
-    /**
-     * Present questions to the user and collect answers.
-     * Returns a map of question text → answer text.
-     * If the user declines, returns null.
-     */
-    askUser(questions: AskUserQuestion[]): Promise<Record<string, string> | null>;
-}
-export declare function createAskUserTool(deps: AskUserToolDeps): PortableTool<AskUserToolParams>;

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

@@ -1,74 +0,0 @@
-import type { PortableTool } from "../portable-tool.js";
-export declare const BRIEF_TOOL_NAME: "send_user_message";
-export type BriefMessageStatus = "normal" | "proactive";
-export interface BriefAttachment {
-    /** Absolute or workspace-relative path */
-    path: string;
-    /** Size in bytes (filled by host) */
-    size?: number;
-    /** Whether the file is an image */
-    isImage?: boolean;
-    /** Upload UUID (host may upload for web preview) */
-    fileUuid?: string;
-}
-export interface BriefToolParams {
-    /** Markdown-formatted message to display to the user */
-    message: string;
-    /** File attachments to include with the message */
-    attachments?: string[];
-    /** Message status — 'proactive' for unsolicited updates */
-    status?: BriefMessageStatus;
-}
-export declare const BRIEF_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly message: {
-            readonly type: "string";
-            readonly description: string;
-            readonly minLength: 1;
-        };
-        readonly attachments: {
-            readonly type: "array";
-            readonly description: "Optional file paths to attach (images, documents, etc.).";
-            readonly items: {
-                readonly type: "string";
-            };
-            readonly maxItems: 10;
-        };
-        readonly status: {
-            readonly type: "string";
-            readonly enum: readonly ["normal", "proactive"];
-            readonly description: string;
-        };
-    };
-    readonly required: readonly ["message"];
-};
-export interface BriefDeliveryResult {
-    delivered: boolean;
-    attachments?: BriefAttachment[];
-    sentAt?: string;
-    error?: string;
-}
-/**
- * Host-provided message delivery backend.
- */
-export interface BriefToolDeps {
-    /** Deliver the message to the user's UI */
-    deliverMessage(params: {
-        message: string;
-        attachments?: string[];
-        status: BriefMessageStatus;
-    }): Promise<BriefDeliveryResult>;
-    /** Validate and resolve attachment paths. Returns resolved attachments or error. */
-    resolveAttachments?(paths: string[]): Promise<BriefAttachment[] | {
-        error: string;
-    }>;
-}
-/** Check if brief mode is active (host determines this) */
-export interface BriefModeConfig {
-    /** Whether the agent is in brief/chat mode */
-    isBriefMode: boolean;
-    /** Whether the user opted in via UI/CLI */
-    userOptIn?: boolean;
-}
-export declare function createBriefTool(deps: BriefToolDeps): PortableTool<BriefToolParams>;

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

@@ -1,114 +0,0 @@
-import type { PortableTool } from "../portable-tool.js";
-export declare const BROWSER_TOOL_NAME: "browser";
-export type BrowserAction = "navigate" | "click" | "type" | "scroll" | "snapshot" | "screenshot" | "console" | "cdp";
-export interface BrowserToolParams {
-    /** Browser action to perform */
-    action: BrowserAction;
-    /** URL for navigate action */
-    url?: string;
-    /** Element reference (e.g. "@e5") for click/type actions */
-    ref?: string;
-    /** Text to type */
-    text?: string;
-    /** Scroll direction */
-    direction?: "up" | "down" | "left" | "right";
-    /** CDP method name for raw cdp action */
-    method?: string;
-    /** CDP params object */
-    params?: Record<string, unknown>;
-    /** JavaScript expression for console eval */
-    expression?: string;
-    /** Whether to include full accessibility tree */
-    full?: boolean;
-}
-export declare const BROWSER_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly action: {
-            readonly type: "string";
-            readonly enum: readonly ["navigate", "click", "type", "scroll", "snapshot", "screenshot", "console", "cdp"];
-            readonly description: string;
-        };
-        readonly url: {
-            readonly type: "string";
-            readonly description: "URL to navigate to. Required for 'navigate' action.";
-        };
-        readonly ref: {
-            readonly type: "string";
-            readonly description: "Element reference like \"@e5\" from a previous snapshot. Required for click/type.";
-        };
-        readonly text: {
-            readonly type: "string";
-            readonly description: "Text to type into the referenced element. Required for 'type' action.";
-        };
-        readonly direction: {
-            readonly type: "string";
-            readonly enum: readonly ["up", "down", "left", "right"];
-            readonly description: "Scroll direction. Required for 'scroll' action.";
-        };
-        readonly method: {
-            readonly type: "string";
-            readonly description: "CDP method name (e.g. 'Page.reload'). Required for 'cdp' action.";
-        };
-        readonly params: {
-            readonly type: "object";
-            readonly description: "Parameters for the CDP method. Optional for 'cdp' action.";
-        };
-        readonly expression: {
-            readonly type: "string";
-            readonly description: "JavaScript expression to evaluate. Used with 'console' action.";
-        };
-        readonly full: {
-            readonly type: "boolean";
-            readonly description: "Include full accessibility tree (default: compact). Used with 'snapshot'.";
-        };
-    };
-    readonly required: readonly ["action"];
-};
-export interface BrowserSnapshot {
-    elements: Array<{
-        ref: string;
-        role: string;
-        name: string;
-        text?: string;
-    }>;
-    url: string;
-    title: string;
-}
-export interface BrowserScreenshot {
-    base64: string;
-    mimeType: string;
-    width: number;
-    height: number;
-}
-/**
- * Host-provided browser automation backend.
- * The host manages Chrome/Chromium lifecycle and CDP connections.
- */
-export interface BrowserToolDeps {
-    navigate(url: string): Promise<{
-        snapshot: BrowserSnapshot;
-    }>;
-    click(ref: string): Promise<{
-        success: boolean;
-        error?: string;
-    }>;
-    type(ref: string, text: string): Promise<{
-        success: boolean;
-        error?: string;
-    }>;
-    scroll(direction: "up" | "down" | "left" | "right"): Promise<{
-        success: boolean;
-    }>;
-    snapshot(full?: boolean): Promise<BrowserSnapshot>;
-    screenshot(): Promise<BrowserScreenshot>;
-    consoleEval(expression?: string): Promise<{
-        result?: string;
-        messages?: string[];
-        errors?: string[];
-    }>;
-    cdp(method: string, params?: Record<string, unknown>): Promise<Record<string, unknown>>;
-    /** Validate URL safety (SSRF prevention). Returns error message if blocked, null if safe. */
-    validateUrl(url: string): string | null;
-}
-export declare function createBrowserTool(deps: BrowserToolDeps): PortableTool<BrowserToolParams>;

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,63 +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 depends on the setting. Required for 'set' action.";
-        };
-    };
-    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;
-}
-/** Keys that cannot be modified by LLM (security-critical) */
-export declare const CONFIG_READONLY_KEYS: readonly 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>;