qlogicagent 0.1.0

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

@@ -0,0 +1,75 @@
+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>;
+//# sourceMappingURL=brief-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"brief-tool.d.ts","sourceRoot":"","sources":["../../../src/skills/tools/brief-tool.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,YAAY,EAAsB,MAAM,qBAAqB,CAAC;AAE5E,eAAO,MAAM,eAAe,EAAG,mBAA4B,CAAC;AAE5D,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,WAAW,CAAC;AAExD,MAAM,WAAW,eAAe;IAC9B,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,kBAAkB,CAAC;CAC7B;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;CAyBpB,CAAC;AAEX,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,eAAe,EAAE,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,2CAA2C;IAC3C,cAAc,CAAC,MAAM,EAAE;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,MAAM,EAAE,kBAAkB,CAAC;KAC5B,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEjC,oFAAoF;IACpF,kBAAkB,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,eAAe,EAAE,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtF;AAED,2DAA2D;AAC3D,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,WAAW,EAAE,OAAO,CAAC;IACrB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,YAAY,CAAC,eAAe,CAAC,CAiElF"}

package/dist/skills/tools/brief-tool.js

@@ -0,0 +1,96 @@
+// ============================================================
+// Brief Tool — "SendUserMessage" equivalent from Claude Code.
+//
+// In brief/chat mode, agent output is not directly visible to
+// the user. Only messages sent through this tool are displayed.
+// This enables clean separation of internal reasoning vs
+// user-facing communication.
+//
+// Reference: claude-code-haha/src/tools/BriefTool/BriefTool.ts
+// Category: interaction
+// ============================================================
+export const BRIEF_TOOL_NAME = "send_user_message";
+export const BRIEF_TOOL_SCHEMA = {
+    type: "object",
+    properties: {
+        message: {
+            type: "string",
+            description: "The message to send to the user. Supports Markdown formatting. " +
+                "This is the ONLY way to communicate with the user in brief/chat mode.",
+            minLength: 1,
+        },
+        attachments: {
+            type: "array",
+            description: "Optional file paths to attach (images, documents, etc.).",
+            items: { type: "string" },
+            maxItems: 10,
+        },
+        status: {
+            type: "string",
+            enum: ["normal", "proactive"],
+            description: "Message status. Use 'proactive' when providing unsolicited information " +
+                "(e.g., monitoring alerts, task completion notifications).",
+        },
+    },
+    required: ["message"],
+};
+export function createBriefTool(deps) {
+    return {
+        name: BRIEF_TOOL_NAME,
+        label: "Send User Message",
+        description: "Send a message to the user. In brief/chat mode this is the ONLY way " +
+            "your messages are visible. Supports Markdown and file attachments. " +
+            "Use 'proactive' status for unsolicited updates (monitoring alerts, " +
+            "task completions). Keep messages concise and useful.",
+        parameters: BRIEF_TOOL_SCHEMA,
+        isConcurrencySafe: true,
+        isReadOnly: true,
+        searchHint: "send message user brief chat communicate display output",
+        execute: async (_toolCallId, params) => {
+            if (!params.message || params.message.trim().length === 0) {
+                return {
+                    content: [{ type: "text", text: "Error: message cannot be empty." }],
+                    details: { type: "brief", error: "empty_message" },
+                };
+            }
+            // Resolve attachments if provided
+            let resolvedAttachments;
+            if (params.attachments && params.attachments.length > 0) {
+                if (deps.resolveAttachments) {
+                    const resolved = await deps.resolveAttachments(params.attachments);
+                    if ("error" in resolved) {
+                        return {
+                            content: [{ type: "text", text: `Attachment error: ${resolved.error}` }],
+                            details: { type: "brief", error: "attachment_resolution_failed" },
+                        };
+                    }
+                    resolvedAttachments = resolved;
+                }
+            }
+            const status = params.status || "normal";
+            const result = await deps.deliverMessage({
+                message: params.message.trim(),
+                attachments: params.attachments,
+                status,
+            });
+            if (!result.delivered) {
+                return {
+                    content: [{ type: "text", text: `Message delivery failed: ${result.error || "unknown error"}` }],
+                    details: { type: "brief", delivered: false, error: result.error },
+                };
+            }
+            // Minimal confirmation — avoids re-echoing message in context (saves tokens)
+            return {
+                content: [{ type: "text", text: "Message delivered to user." }],
+                details: {
+                    type: "brief",
+                    delivered: true,
+                    status,
+                    hasAttachments: (resolvedAttachments?.length ?? 0) > 0,
+                    sentAt: result.sentAt,
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=brief-tool.js.map

package/dist/skills/tools/brief-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brief-tool.js","sourceRoot":"","sources":["../../../src/skills/tools/brief-tool.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,8DAA8D;AAC9D,EAAE;AACF,8DAA8D;AAC9D,gEAAgE;AAChE,yDAAyD;AACzD,6BAA6B;AAC7B,EAAE;AACF,+DAA+D;AAC/D,wBAAwB;AACxB,+DAA+D;AAI/D,MAAM,CAAC,MAAM,eAAe,GAAG,mBAA4B,CAAC;AAwB5D,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,QAAiB;IACvB,UAAU,EAAE;QACV,OAAO,EAAE;YACP,IAAI,EAAE,QAAiB;YACvB,WAAW,EACT,iEAAiE;gBACjE,uEAAuE;YACzE,SAAS,EAAE,CAAC;SACb;QACD,WAAW,EAAE;YACX,IAAI,EAAE,OAAgB;YACtB,WAAW,EAAE,0DAA0D;YACvE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;YAClC,QAAQ,EAAE,EAAE;SACb;QACD,MAAM,EAAE;YACN,IAAI,EAAE,QAAiB;YACvB,IAAI,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC;YAC7B,WAAW,EACT,yEAAyE;gBACzE,2DAA2D;SAC9D;KACF;IACD,QAAQ,EAAE,CAAC,SAAS,CAAU;CACtB,CAAC;AAgCX,MAAM,UAAU,eAAe,CAAC,IAAmB;IACjD,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EACT,sEAAsE;YACtE,qEAAqE;YACrE,qEAAqE;YACrE,sDAAsD;QACxD,UAAU,EAAE,iBAAiB;QAC7B,iBAAiB,EAAE,IAAI;QACvB,UAAU,EAAE,IAAI;QAChB,UAAU,EAAE,yDAAyD;QAErE,OAAO,EAAE,KAAK,EAAE,WAAmB,EAAE,MAAuB,EAA+B,EAAE;YAC3F,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1D,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iCAAiC,EAAE,CAAC;oBACpE,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE;iBACnD,CAAC;YACJ,CAAC;YAED,kCAAkC;YAClC,IAAI,mBAAkD,CAAC;YACvD,IAAI,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxD,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;oBAC5B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;oBACnE,IAAI,OAAO,IAAI,QAAQ,EAAE,CAAC;wBACxB,OAAO;4BACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC;4BACxE,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,8BAA8B,EAAE;yBAClE,CAAC;oBACJ,CAAC;oBACD,mBAAmB,GAAG,QAAQ,CAAC;gBACjC,CAAC;YACH,CAAC;YAED,MAAM,MAAM,GAAuB,MAAM,CAAC,MAAM,IAAI,QAAQ,CAAC;YAE7D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC;gBACvC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE;gBAC9B,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,MAAM;aACP,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;gBACtB,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,4BAA4B,MAAM,CAAC,KAAK,IAAI,eAAe,EAAE,EAAE,CAAC;oBAChG,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE;iBAClE,CAAC;YACJ,CAAC;YAED,6EAA6E;YAC7E,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,4BAA4B,EAAE,CAAC;gBAC/D,OAAO,EAAE;oBACP,IAAI,EAAE,OAAO;oBACb,SAAS,EAAE,IAAI;oBACf,MAAM;oBACN,cAAc,EAAE,CAAC,mBAAmB,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC;oBACtD,MAAM,EAAE,MAAM,CAAC,MAAM;iBACtB;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,115 @@
+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>;
+//# sourceMappingURL=browser-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"browser-tool.d.ts","sourceRoot":"","sources":["../../../src/skills/tools/browser-tool.ts"],"names":[],"mappings":"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"}

package/dist/skills/tools/browser-tool.js

@@ -0,0 +1,156 @@
+// ============================================================
+// Browser Tool — CDP-based browser automation.
+// Reference: hermes-agent-main/tools/browser_tool.py
+//            hermes-agent-main/tools/browser_cdp_tool.py
+// Category: web
+// ============================================================
+export const BROWSER_TOOL_NAME = "browser";
+export const BROWSER_TOOL_SCHEMA = {
+    type: "object",
+    properties: {
+        action: {
+            type: "string",
+            enum: ["navigate", "click", "type", "scroll", "snapshot", "screenshot", "console", "cdp"],
+            description: "Browser action: navigate (go to URL), click (element by ref), type (text into element), " +
+                "scroll (direction), snapshot (accessibility tree), screenshot (visual capture), " +
+                "console (eval JS / read logs), cdp (raw CDP command).",
+        },
+        url: {
+            type: "string",
+            description: "URL to navigate to. Required for 'navigate' action.",
+        },
+        ref: {
+            type: "string",
+            description: 'Element reference like "@e5" from a previous snapshot. Required for click/type.',
+        },
+        text: {
+            type: "string",
+            description: "Text to type into the referenced element. Required for 'type' action.",
+        },
+        direction: {
+            type: "string",
+            enum: ["up", "down", "left", "right"],
+            description: "Scroll direction. Required for 'scroll' action.",
+        },
+        method: {
+            type: "string",
+            description: "CDP method name (e.g. 'Page.reload'). Required for 'cdp' action.",
+        },
+        params: {
+            type: "object",
+            description: "Parameters for the CDP method. Optional for 'cdp' action.",
+        },
+        expression: {
+            type: "string",
+            description: "JavaScript expression to evaluate. Used with 'console' action.",
+        },
+        full: {
+            type: "boolean",
+            description: "Include full accessibility tree (default: compact). Used with 'snapshot'.",
+        },
+    },
+    required: ["action"],
+};
+export function createBrowserTool(deps) {
+    return {
+        name: BROWSER_TOOL_NAME,
+        label: "Browser",
+        description: "Control a headless browser via Chrome DevTools Protocol. " +
+            "Actions: navigate (URL), click/type (element refs from snapshot), " +
+            "scroll, snapshot (accessibility tree), screenshot (visual), " +
+            "console (JS eval/logs), cdp (raw CDP commands). " +
+            "Use snapshot to get element refs before click/type.",
+        parameters: BROWSER_TOOL_SCHEMA,
+        execute: async (_toolCallId, params) => {
+            switch (params.action) {
+                case "navigate": {
+                    if (!params.url) {
+                        return { content: [{ type: "text", text: "Error: url is required for navigate action." }], details: { type: "browser", error: "missing_url" } };
+                    }
+                    const blocked = deps.validateUrl(params.url);
+                    if (blocked) {
+                        return { content: [{ type: "text", text: `Blocked: ${blocked}` }], details: { type: "browser", error: "url_blocked" } };
+                    }
+                    const nav = await deps.navigate(params.url);
+                    const lines = [`Navigated to: ${nav.snapshot.url}`, `Title: ${nav.snapshot.title}`, "", `Elements: ${nav.snapshot.elements.length}`];
+                    if (nav.snapshot.elements.length <= 30) {
+                        for (const e of nav.snapshot.elements) {
+                            lines.push(`  ${e.ref} [${e.role}] ${e.name}${e.text ? `: "${e.text}"` : ""}`);
+                        }
+                    }
+                    else {
+                        lines.push("(use snapshot action for full element list)");
+                    }
+                    return { content: [{ type: "text", text: lines.join("\n") }], details: { type: "browser", action: "navigate", url: params.url } };
+                }
+                case "click": {
+                    if (!params.ref) {
+                        return { content: [{ type: "text", text: "Error: ref is required for click (e.g. '@e5')." }], details: { type: "browser", error: "missing_ref" } };
+                    }
+                    const click = await deps.click(params.ref);
+                    if (!click.success) {
+                        return { content: [{ type: "text", text: `Click failed: ${click.error || "unknown"}` }], details: { type: "browser", error: "click_failed" } };
+                    }
+                    return { content: [{ type: "text", text: `Clicked ${params.ref}` }], details: { type: "browser", action: "click", ref: params.ref } };
+                }
+                case "type": {
+                    if (!params.ref || !params.text) {
+                        return { content: [{ type: "text", text: "Error: ref and text are required for type action." }], details: { type: "browser", error: "missing_params" } };
+                    }
+                    const typed = await deps.type(params.ref, params.text);
+                    if (!typed.success) {
+                        return { content: [{ type: "text", text: `Type failed: ${typed.error || "unknown"}` }], details: { type: "browser", error: "type_failed" } };
+                    }
+                    return { content: [{ type: "text", text: `Typed "${params.text}" into ${params.ref}` }], details: { type: "browser", action: "type", ref: params.ref } };
+                }
+                case "scroll": {
+                    if (!params.direction) {
+                        return { content: [{ type: "text", text: "Error: direction is required for scroll." }], details: { type: "browser", error: "missing_direction" } };
+                    }
+                    await deps.scroll(params.direction);
+                    return { content: [{ type: "text", text: `Scrolled ${params.direction}` }], details: { type: "browser", action: "scroll", direction: params.direction } };
+                }
+                case "snapshot": {
+                    const snap = await deps.snapshot(params.full);
+                    const lines = [`URL: ${snap.url}`, `Title: ${snap.title}`, "", `Accessibility tree (${snap.elements.length} elements):`, ""];
+                    for (const e of snap.elements) {
+                        lines.push(`${e.ref} [${e.role}] ${e.name}${e.text ? ` — "${e.text}"` : ""}`);
+                    }
+                    return { content: [{ type: "text", text: lines.join("\n") }], details: { type: "browser", action: "snapshot", elementCount: snap.elements.length } };
+                }
+                case "screenshot": {
+                    const shot = await deps.screenshot();
+                    return {
+                        content: [{ type: "image", data: shot.base64, mimeType: shot.mimeType }],
+                        details: { type: "browser", action: "screenshot", width: shot.width, height: shot.height },
+                    };
+                }
+                case "console": {
+                    const c = await deps.consoleEval(params.expression);
+                    const lines = [];
+                    if (c.result !== undefined)
+                        lines.push(`Result: ${c.result}`);
+                    if (c.messages?.length) {
+                        lines.push("Console messages:");
+                        c.messages.forEach((m) => lines.push(`  ${m}`));
+                    }
+                    if (c.errors?.length) {
+                        lines.push("JS errors:");
+                        c.errors.forEach((e) => lines.push(`  ${e}`));
+                    }
+                    return { content: [{ type: "text", text: lines.join("\n") || "(no output)" }], details: { type: "browser", action: "console" } };
+                }
+                case "cdp": {
+                    if (!params.method) {
+                        return { content: [{ type: "text", text: "Error: method is required for cdp action." }], details: { type: "browser", error: "missing_method" } };
+                    }
+                    const result = await deps.cdp(params.method, params.params);
+                    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }], details: { type: "browser", action: "cdp", method: params.method } };
+                }
+                default:
+                    return { content: [{ type: "text", text: `Error: unknown action "${params.action}".` }], details: { type: "browser", error: "unknown_action" } };
+            }
+        },
+    };
+}
+//# sourceMappingURL=browser-tool.js.map

package/dist/skills/tools/browser-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-tool.js","sourceRoot":"","sources":["../../../src/skills/tools/browser-tool.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,67 @@
+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>;
+//# sourceMappingURL=checkpoint-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-tool.d.ts","sourceRoot":"","sources":["../../../src/skills/tools/checkpoint-tool.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAsB,MAAM,qBAAqB,CAAC;AAE5E,eAAO,MAAM,oBAAoB,EAAG,YAAqB,CAAC;AAE1D,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAEtE,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,gBAAgB,CAAC;IACzB,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;CAyBzB,CAAC;AAEX,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,uDAAuD;IACvD,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC9D,qCAAqC;IACrC,eAAe,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC7C,mEAAmE;IACnE,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACrF,uDAAuD;IACvD,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACjE;AAID,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,GAAG,YAAY,CAAC,oBAAoB,CAAC,CA2EjG"}