qlogicagent 2.15.2 → 2.15.4

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/plan-mode-tool.d.ts

@@ -1,98 +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;
-    /**
-     * Semantic permissions to request on exit (CC ExitPlanModeV2 parity).
-     * Each entry describes a tool + intent the agent wants permission for.
-     */
-    allowedPrompts?: Array<{
-        tool: string;
-        prompt: 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 allowedPrompts: {
-            readonly type: "array";
-            readonly description: string;
-            readonly items: {
-                readonly type: "object";
-                readonly properties: {
-                    readonly tool: {
-                        readonly type: "string";
-                        readonly description: "Tool name to pre-approve.";
-                    };
-                    readonly prompt: {
-                        readonly type: "string";
-                        readonly description: "Intent description for this permission.";
-                    };
-                };
-                readonly required: readonly ["tool", "prompt"];
-            };
-        };
-    };
-    readonly required: readonly ["action"];
-};
-/** Tools allowed during plan mode (read-only + reasoning + task tracking) */
-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;
-    /**
-     * Request approval for the plan from the user/coordinator.
-     * CC parity: ExitPlanModeV2 triggers an approval dialog on exit.
-     * Returns true if approved, false if rejected.
-     */
-    requestPlanApproval?(plan: string, allowedPrompts?: Array<{
-        tool: string;
-        prompt: string;
-    }>): Promise<boolean>;
-    /**
-     * Persist plan to disk (CC parity: plan is saved to planFilePath).
-     */
-    persistPlan?(plan: string, filePath: string): Promise<void>;
-}
-export declare function createPlanModeTool(deps: PlanModeToolDeps): PortableTool<PlanModeToolParams>;

package/dist/types/skills/tools/structured-output-tool.d.ts

@@ -1,116 +0,0 @@
-import type { PortableTool } from "../portable-tool.js";
-export declare const STRUCTURED_OUTPUT_TOOL_NAME: "structured_output";
-/** Maximum content size for structured output results. */
-export declare const STRUCTURED_OUTPUT_MAX_CHARS = 100000;
-export interface StructuredOutputToolParams {
-    /** The structured data to return. Must conform to the session's output schema. */
-    data: Record<string, unknown>;
-}
-/**
- * Base schema — accepts any object.
- * When used with createConfiguredStructuredOutputTool, the host overrides
- * this with the actual JSON Schema from `response_format.json_schema`.
- */
-export declare const STRUCTURED_OUTPUT_TOOL_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly data: {
-            readonly type: "object";
-            readonly description: string;
-            readonly additionalProperties: true;
-        };
-    };
-    readonly required: readonly ["data"];
-};
-/** Schema validation error detail. */
-export interface SchemaValidationError {
-    path: string;
-    message: string;
-    keyword?: string;
-}
-/** Result of structured output validation. */
-export interface StructuredOutputResult {
-    valid: boolean;
-    errors?: SchemaValidationError[];
-}
-/**
- * Whether the structured output tool should be enabled for this session.
- * CC equivalent: `isSyntheticOutputToolEnabled`.
- */
-export declare function isStructuredOutputEnabled(opts: {
-    isNonInteractiveSession: boolean;
-}): boolean;
-/**
- * Runtime dependencies injected by the host.
- *
- * The host provides:
- * 1. The JSON Schema to validate against (from session config)
- * 2. A validator function (host may use Ajv, Zod, or any validator)
- * 3. An output sink to deliver the validated data
- *
- * The tool is only available in non-interactive (SDK/API) sessions
- * where a `response_format.json_schema` has been specified.
- */
-export interface StructuredOutputToolDeps {
-    /**
-     * Get the JSON Schema that the output must conform to.
-     * Returns undefined if no schema is configured (tool should not be registered).
-     */
-    getOutputSchema(): Record<string, unknown> | undefined;
-    /**
-     * Validate data against the output schema.
-     * Returns { valid: true } or { valid: false, errors: [...] }.
-     */
-    validateOutput(data: Record<string, unknown>): StructuredOutputResult;
-    /**
-     * Deliver the validated output to the caller.
-     * Called only after successful validation.
-     */
-    deliverOutput(data: Record<string, unknown>): Promise<void>;
-}
-/**
- * Create the base structured output tool with DI-based validation.
- * This is the standard factory for runtime integration.
- */
-export declare function createStructuredOutputTool(deps: StructuredOutputToolDeps): PortableTool<StructuredOutputToolParams>;
-/**
- * Result of creating a configured structured output tool.
- * Success: { tool } — ready-to-use tool with compiled schema.
- * Failure: { error } — schema was invalid.
- */
-export type ConfiguredToolResult = {
-    tool: PortableTool<StructuredOutputToolParams>;
-} | {
-    error: string;
-};
-/**
- * Host-provided schema compilation interface.
- * Allows the host to use any validator (Ajv, Zod, custom).
- */
-export interface SchemaCompiler {
-    /**
-     * Validate that the schema itself is a valid JSON Schema.
-     * Returns null if valid, or an error message string if invalid.
-     */
-    validateSchema(schema: Record<string, unknown>): string | null;
-    /**
-     * Compile the schema into a reusable validator function.
-     * Returns a function that validates data and returns StructuredOutputResult.
-     */
-    compile(schema: Record<string, unknown>): (data: Record<string, unknown>) => StructuredOutputResult;
-}
-/**
- * Create a StructuredOutputTool configured with a specific JSON Schema.
- * Mirrors CC's `createSyntheticOutputTool(jsonSchema)`.
- *
- * Features:
- * - Validates the schema itself at creation time
- * - Compiles the validator for reuse (cached via WeakMap)
- * - Overrides the tool's `parameters` with the provided schema (dynamic input)
- * - Returns { tool } on success or { error } if schema is invalid
- *
- * @param jsonSchema  The JSON Schema to validate output against.
- * @param compiler    Schema compiler/validator provided by the host.
- * @param deliver     Output delivery function (called after successful validation).
- */
-export declare function createConfiguredStructuredOutputTool(jsonSchema: Record<string, unknown>, compiler: SchemaCompiler, deliver: (data: Record<string, unknown>) => Promise<void>): ConfiguredToolResult;

package/dist/types/transport/index.d.ts

@@ -1,7 +0,0 @@
-/**
- * Transport layer — ACP Server + Event Emitter.
- */
-export { AcpServer, ACP_ERROR_CODES } from "./acp-server.js";
-export type { AcpRequestHandler, AcpServerConfig } from "./acp-server.js";
-export type { Transport } from "./io-transport.js";
-export { emitAcpUpdate } from "./acp-event-emitter.js";