webclaw-shared 0.1.0

package/dist/ref.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @ref encoding utilities for compact snapshot element references.
+ *
+ * Each interactive element in a snapshot is assigned a unique @ref like @e1, @e2, etc.
+ * Refs are scoped to a single snapshot and reset on each new snapshot.
+ */
+/** Generate a ref string from a numeric index (1-based) */
+export declare function encodeRef(index: number): string;
+/** Extract the numeric index from a ref string, or null if invalid */
+export declare function decodeRef(ref: string): number | null;
+/** Check if a string is a valid @ref */
+export declare function isValidRef(ref: string): boolean;
+/** Create a ref counter for generating sequential refs within a snapshot */
+export declare function createRefCounter(): {
+    next(): string;
+    count(): number;
+};
+//# sourceMappingURL=ref.d.ts.map

package/dist/ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref.d.ts","sourceRoot":"","sources":["../src/ref.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,2DAA2D;AAC3D,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAK/C;AAED,sEAAsE;AACtE,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIpD;AAED,wCAAwC;AACxC,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED,4EAA4E;AAC5E,wBAAgB,gBAAgB,IAAI;IAAE,IAAI,IAAI,MAAM,CAAC;IAAC,KAAK,IAAI,MAAM,CAAA;CAAE,CAWtE"}

package/dist/ref.js

@@ -0,0 +1,40 @@
+/**
+ * @ref encoding utilities for compact snapshot element references.
+ *
+ * Each interactive element in a snapshot is assigned a unique @ref like @e1, @e2, etc.
+ * Refs are scoped to a single snapshot and reset on each new snapshot.
+ */
+const REF_PREFIX = '@e';
+const REF_PATTERN = /^@e(\d+)$/;
+/** Generate a ref string from a numeric index (1-based) */
+export function encodeRef(index) {
+    if (index < 1) {
+        throw new Error(`Ref index must be >= 1, got ${index}`);
+    }
+    return `${REF_PREFIX}${index}`;
+}
+/** Extract the numeric index from a ref string, or null if invalid */
+export function decodeRef(ref) {
+    const match = ref.match(REF_PATTERN);
+    if (!match)
+        return null;
+    return parseInt(match[1], 10);
+}
+/** Check if a string is a valid @ref */
+export function isValidRef(ref) {
+    return REF_PATTERN.test(ref);
+}
+/** Create a ref counter for generating sequential refs within a snapshot */
+export function createRefCounter() {
+    let counter = 0;
+    return {
+        next() {
+            counter++;
+            return encodeRef(counter);
+        },
+        count() {
+            return counter;
+        },
+    };
+}
+//# sourceMappingURL=ref.js.map

package/dist/ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref.js","sourceRoot":"","sources":["../src/ref.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,UAAU,GAAG,IAAI,CAAC;AACxB,MAAM,WAAW,GAAG,WAAW,CAAC;AAEhC,2DAA2D;AAC3D,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,+BAA+B,KAAK,EAAE,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,GAAG,UAAU,GAAG,KAAK,EAAE,CAAC;AACjC,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACrC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAChC,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/B,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,gBAAgB;IAC9B,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,OAAO;QACL,IAAI;YACF,OAAO,EAAE,CAAC;YACV,OAAO,SAAS,CAAC,OAAO,CAAC,CAAC;QAC5B,CAAC;QACD,KAAK;YACH,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/schemas.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Zod schemas for message validation.
+ */
+import { z } from 'zod';
+export declare const bridgeMessageSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodEnum<["request", "response", "ack", "error"]>;
+    method: z.ZodString;
+    payload: z.ZodUnknown;
+    timestamp: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    type: "request" | "response" | "ack" | "error";
+    id: string;
+    method: string;
+    timestamp: number;
+    payload?: unknown;
+}, {
+    type: "request" | "response" | "ack" | "error";
+    id: string;
+    method: string;
+    timestamp: number;
+    payload?: unknown;
+}>;
+export declare const bridgeErrorPayloadSchema: z.ZodObject<{
+    code: z.ZodString;
+    message: z.ZodString;
+    details: z.ZodOptional<z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    message: string;
+    details?: unknown;
+}, {
+    code: string;
+    message: string;
+    details?: unknown;
+}>;
+export declare const chunkedMessageSchema: z.ZodObject<{
+    id: z.ZodString;
+    chunkIndex: z.ZodNumber;
+    totalChunks: z.ZodNumber;
+    data: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    chunkIndex: number;
+    totalChunks: number;
+    data: string;
+}, {
+    id: string;
+    chunkIndex: number;
+    totalChunks: number;
+    data: string;
+}>;
+export declare const navigateToSchema: z.ZodObject<{
+    url: z.ZodString;
+    tabId: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    tabId?: number | undefined;
+}, {
+    url: string;
+    tabId?: number | undefined;
+}>;
+export declare const pageSnapshotSchema: z.ZodObject<{
+    tabId: z.ZodOptional<z.ZodNumber>;
+    maxTokens: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    tabId?: number | undefined;
+    maxTokens?: number | undefined;
+}, {
+    tabId?: number | undefined;
+    maxTokens?: number | undefined;
+}>;
+export declare const clickSchema: z.ZodObject<{
+    ref: z.ZodString;
+    snapshotId: z.ZodString;
+    tabId: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    ref: string;
+    snapshotId: string;
+    tabId?: number | undefined;
+}, {
+    ref: string;
+    snapshotId: string;
+    tabId?: number | undefined;
+}>;
+export declare const typeTextSchema: z.ZodObject<{
+    ref: z.ZodString;
+    text: z.ZodString;
+    snapshotId: z.ZodString;
+    clearFirst: z.ZodOptional<z.ZodBoolean>;
+    tabId: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    ref: string;
+    snapshotId: string;
+    text: string;
+    tabId?: number | undefined;
+    clearFirst?: boolean | undefined;
+}, {
+    ref: string;
+    snapshotId: string;
+    text: string;
+    tabId?: number | undefined;
+    clearFirst?: boolean | undefined;
+}>;
+export declare const selectOptionSchema: z.ZodObject<{
+    ref: z.ZodString;
+    value: z.ZodString;
+    snapshotId: z.ZodString;
+    tabId: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    value: string;
+    ref: string;
+    snapshotId: string;
+    tabId?: number | undefined;
+}, {
+    value: string;
+    ref: string;
+    snapshotId: string;
+    tabId?: number | undefined;
+}>;
+export declare const listWebMCPToolsSchema: z.ZodObject<{
+    tabId: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    tabId?: number | undefined;
+}, {
+    tabId?: number | undefined;
+}>;
+export declare const invokeWebMCPToolSchema: z.ZodObject<{
+    toolName: z.ZodString;
+    args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    tabId: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    toolName: string;
+    args: Record<string, unknown>;
+    tabId?: number | undefined;
+}, {
+    toolName: string;
+    args: Record<string, unknown>;
+    tabId?: number | undefined;
+}>;
+export declare const screenshotSchema: z.ZodObject<{
+    tabId: z.ZodOptional<z.ZodNumber>;
+    fullPage: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    tabId?: number | undefined;
+    fullPage?: boolean | undefined;
+}, {
+    tabId?: number | undefined;
+    fullPage?: boolean | undefined;
+}>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;EAM9B,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;EAInC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;EAK/B,CAAC;AAGH,eAAO,MAAM,gBAAgB;;;;;;;;;EAG3B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;EAG7B,CAAC;AAEH,eAAO,MAAM,WAAW;;;;;;;;;;;;EAItB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;EAMzB,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;EAK7B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;EAEhC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;EAIjC,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;EAG3B,CAAC"}

package/dist/schemas.js

@@ -0,0 +1,63 @@
+/**
+ * Zod schemas for message validation.
+ */
+import { z } from 'zod';
+// Bridge message schemas
+export const bridgeMessageSchema = z.object({
+    id: z.string().min(1),
+    type: z.enum(['request', 'response', 'ack', 'error']),
+    method: z.string().min(1),
+    payload: z.unknown(),
+    timestamp: z.number(),
+});
+export const bridgeErrorPayloadSchema = z.object({
+    code: z.string(),
+    message: z.string(),
+    details: z.unknown().optional(),
+});
+export const chunkedMessageSchema = z.object({
+    id: z.string().min(1),
+    chunkIndex: z.number().int().min(0),
+    totalChunks: z.number().int().min(1),
+    data: z.string(),
+});
+// MCP tool parameter schemas
+export const navigateToSchema = z.object({
+    url: z.string().url(),
+    tabId: z.number().int().optional(),
+});
+export const pageSnapshotSchema = z.object({
+    tabId: z.number().int().optional(),
+    maxTokens: z.number().int().positive().optional(),
+});
+export const clickSchema = z.object({
+    ref: z.string().regex(/^@e\d+$/),
+    snapshotId: z.string().min(1),
+    tabId: z.number().int().optional(),
+});
+export const typeTextSchema = z.object({
+    ref: z.string().regex(/^@e\d+$/),
+    text: z.string(),
+    snapshotId: z.string().min(1),
+    clearFirst: z.boolean().optional(),
+    tabId: z.number().int().optional(),
+});
+export const selectOptionSchema = z.object({
+    ref: z.string().regex(/^@e\d+$/),
+    value: z.string(),
+    snapshotId: z.string().min(1),
+    tabId: z.number().int().optional(),
+});
+export const listWebMCPToolsSchema = z.object({
+    tabId: z.number().int().optional(),
+});
+export const invokeWebMCPToolSchema = z.object({
+    toolName: z.string().min(1),
+    args: z.record(z.unknown()),
+    tabId: z.number().int().optional(),
+});
+export const screenshotSchema = z.object({
+    tabId: z.number().int().optional(),
+    fullPage: z.boolean().optional(),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

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

package/dist/snapshot-formatter.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Formats a SnapshotNode tree into the compact text representation.
+ */
+import type { SnapshotNode } from './types/snapshot.js';
+/** Format a snapshot tree into compact text */
+export declare function formatSnapshot(node: SnapshotNode, indent?: number): string;
+/**
+ * Estimate the token count for a string.
+ * Rough approximation: ~4 chars per token for English text.
+ */
+export declare function estimateTokens(text: string): number;
+//# sourceMappingURL=snapshot-formatter.d.ts.map

package/dist/snapshot-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-formatter.d.ts","sourceRoot":"","sources":["../src/snapshot-formatter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,+CAA+C;AAC/C,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,GAAE,MAAU,GAAG,MAAM,CAI7E;AAuDD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/snapshot-formatter.js

@@ -0,0 +1,50 @@
+/** Format a snapshot tree into compact text */
+export function formatSnapshot(node, indent = 0) {
+    const lines = [];
+    formatNode(node, indent, lines);
+    return lines.join('\n');
+}
+function formatNode(node, indent, lines) {
+    const pad = '  '.repeat(indent);
+    let line = `${pad}[`;
+    if (node.ref) {
+        line += `${node.ref} `;
+    }
+    line += node.role;
+    if (node.name) {
+        line += ` "${node.name}"`;
+    }
+    line += ']';
+    if (node.value !== undefined) {
+        line += ` ${node.value}`;
+    }
+    if (node.checked !== undefined) {
+        line += node.checked ? ' (checked)' : ' (unchecked)';
+    }
+    if (node.disabled) {
+        line += ' (disabled)';
+    }
+    if (node.expanded !== undefined) {
+        line += node.expanded ? ' (expanded)' : ' (collapsed)';
+    }
+    if (node.selected !== undefined) {
+        line += node.selected ? ' (selected)' : ' (unselected)';
+    }
+    if (node.pressed !== undefined) {
+        line += node.pressed ? ' (pressed)' : ' (unpressed)';
+    }
+    lines.push(line);
+    if (node.children) {
+        for (const child of node.children) {
+            formatNode(child, indent + 1, lines);
+        }
+    }
+}
+/**
+ * Estimate the token count for a string.
+ * Rough approximation: ~4 chars per token for English text.
+ */
+export function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+//# sourceMappingURL=snapshot-formatter.js.map

package/dist/snapshot-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-formatter.js","sourceRoot":"","sources":["../src/snapshot-formatter.ts"],"names":[],"mappings":"AAKA,+CAA+C;AAC/C,MAAM,UAAU,cAAc,CAAC,IAAkB,EAAE,SAAiB,CAAC;IACnE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAChC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,UAAU,CACjB,IAAkB,EAClB,MAAc,EACd,KAAe;IAEf,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAChC,IAAI,IAAI,GAAG,GAAG,GAAG,GAAG,CAAC;IAErB,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;QACb,IAAI,IAAI,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC;IACzB,CAAC;IAED,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC;IAElB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,IAAI,IAAI,KAAK,IAAI,CAAC,IAAI,GAAG,CAAC;IAC5B,CAAC;IAED,IAAI,IAAI,GAAG,CAAC;IAEZ,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC7B,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAED,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC/B,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,cAAc,CAAC;IACvD,CAAC;IAED,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,IAAI,IAAI,aAAa,CAAC;IACxB,CAAC;IAED,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAChC,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,cAAc,CAAC;IACzD,CAAC;IAED,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAChC,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,eAAe,CAAC;IAC1D,CAAC;IAED,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC/B,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,cAAc,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEjB,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACpC,CAAC"}

package/dist/types/bridge.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Internal message protocol between MCP Server and Chrome Extension.
+ * Messages are sent via Chrome Native Messaging (32-bit length-prefixed JSON).
+ */
+export type BridgeMessageType = 'request' | 'response' | 'ack' | 'error';
+/** Base bridge message */
+export interface BridgeMessage {
+    id: string;
+    type: BridgeMessageType;
+    method: string;
+    payload: unknown;
+    timestamp: number;
+}
+/** Request from MCP Server to Extension */
+export interface BridgeRequest extends BridgeMessage {
+    type: 'request';
+}
+/** Successful response from Extension to MCP Server */
+export interface BridgeResponse extends BridgeMessage {
+    type: 'response';
+}
+/** Acknowledgment of request receipt */
+export interface BridgeAck extends BridgeMessage {
+    type: 'ack';
+}
+/** Error response */
+export interface BridgeError extends BridgeMessage {
+    type: 'error';
+    payload: {
+        code: string;
+        message: string;
+        details?: unknown;
+    };
+}
+/** All bridge method names for type-safe dispatch */
+export type BridgeMethod = 'navigate' | 'snapshot' | 'click' | 'typeText' | 'selectOption' | 'listWebMCPTools' | 'invokeWebMCPTool' | 'screenshot' | 'ping';
+/** Chunked message for large payloads (>1MB Native Messaging limit) */
+export interface ChunkedMessage {
+    id: string;
+    chunkIndex: number;
+    totalChunks: number;
+    data: string;
+}
+//# sourceMappingURL=bridge.d.ts.map

package/dist/types/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../src/types/bridge.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,UAAU,GAAG,KAAK,GAAG,OAAO,CAAC;AAEzE,0BAA0B;AAC1B,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,iBAAiB,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,2CAA2C;AAC3C,MAAM,WAAW,aAAc,SAAQ,aAAa;IAClD,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,uDAAuD;AACvD,MAAM,WAAW,cAAe,SAAQ,aAAa;IACnD,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,wCAAwC;AACxC,MAAM,WAAW,SAAU,SAAQ,aAAa;IAC9C,IAAI,EAAE,KAAK,CAAC;CACb;AAED,qBAAqB;AACrB,MAAM,WAAW,WAAY,SAAQ,aAAa;IAChD,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;CACH;AAED,qDAAqD;AACrD,MAAM,MAAM,YAAY,GACpB,UAAU,GACV,UAAU,GACV,OAAO,GACP,UAAU,GACV,cAAc,GACd,iBAAiB,GACjB,kBAAkB,GAClB,YAAY,GACZ,MAAM,CAAC;AAEX,uEAAuE;AACvE,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/types/bridge.js

@@ -0,0 +1,6 @@
+/**
+ * Internal message protocol between MCP Server and Chrome Extension.
+ * Messages are sent via Chrome Native Messaging (32-bit length-prefixed JSON).
+ */
+export {};
+//# sourceMappingURL=bridge.js.map

package/dist/types/bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../../src/types/bridge.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/types/index.d.ts

@@ -0,0 +1,5 @@
+export * from './webmcp.js';
+export * from './bridge.js';
+export * from './snapshot.js';
+export * from './mcp-tools.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,5 @@
+export * from './webmcp.js';
+export * from './bridge.js';
+export * from './snapshot.js';
+export * from './mcp-tools.js';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC"}

package/dist/types/mcp-tools.d.ts

@@ -0,0 +1,56 @@
+/**
+ * MCP tool definitions for the WebClaw server.
+ */
+/** Parameters for navigate_to tool */
+export interface NavigateToParams {
+    url: string;
+    tabId?: number;
+}
+/** Parameters for page_snapshot tool */
+export interface PageSnapshotParams {
+    tabId?: number;
+    maxTokens?: number;
+}
+/** Parameters for click tool */
+export interface ClickParams {
+    ref: string;
+    snapshotId: string;
+    tabId?: number;
+}
+/** Parameters for type_text tool */
+export interface TypeTextParams {
+    ref: string;
+    text: string;
+    snapshotId: string;
+    clearFirst?: boolean;
+    tabId?: number;
+}
+/** Parameters for select_option tool */
+export interface SelectOptionParams {
+    ref: string;
+    value: string;
+    snapshotId: string;
+    tabId?: number;
+}
+/** Parameters for list_webmcp_tools tool */
+export interface ListWebMCPToolsParams {
+    tabId?: number;
+}
+/** Parameters for invoke_webmcp_tool tool */
+export interface InvokeWebMCPToolParams {
+    toolName: string;
+    args: Record<string, unknown>;
+    tabId?: number;
+}
+/** Parameters for screenshot tool */
+export interface ScreenshotParams {
+    tabId?: number;
+    fullPage?: boolean;
+}
+/** Screenshot result */
+export interface ScreenshotResult {
+    dataUrl: string;
+    width: number;
+    height: number;
+}
+//# sourceMappingURL=mcp-tools.d.ts.map

package/dist/types/mcp-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tools.d.ts","sourceRoot":"","sources":["../../src/types/mcp-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,sCAAsC;AACtC,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wCAAwC;AACxC,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,gCAAgC;AAChC,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,oCAAoC;AACpC,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wCAAwC;AACxC,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,4CAA4C;AAC5C,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,6CAA6C;AAC7C,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qCAAqC;AACrC,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAwB;AACxB,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/types/mcp-tools.js

@@ -0,0 +1,5 @@
+/**
+ * MCP tool definitions for the WebClaw server.
+ */
+export {};
+//# sourceMappingURL=mcp-tools.js.map

package/dist/types/mcp-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tools.js","sourceRoot":"","sources":["../../src/types/mcp-tools.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types/snapshot.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Compact A11y tree snapshot types with @ref support.
+ */
+/** A node in the compact snapshot tree */
+export interface SnapshotNode {
+    role: string;
+    name?: string;
+    ref?: string;
+    value?: string;
+    checked?: boolean;
+    selected?: boolean;
+    disabled?: boolean;
+    expanded?: boolean;
+    pressed?: boolean;
+    children?: SnapshotNode[];
+}
+/** Complete page snapshot */
+export interface PageSnapshot {
+    snapshotId: string;
+    url: string;
+    title: string;
+    tree: SnapshotNode;
+    timestamp: number;
+}
+/** Options for snapshot generation */
+export interface SnapshotOptions {
+    /** Maximum token budget for the snapshot text (default: 4000) */
+    maxTokens?: number;
+    /** Include only interactive elements */
+    interactiveOnly?: boolean;
+}
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/types/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/types/snapshot.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,0CAA0C;AAC1C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;CAC3B;AAED,6BAA6B;AAC7B,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,YAAY,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,sCAAsC;AACtC,MAAM,WAAW,eAAe;IAC9B,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B"}

package/dist/types/snapshot.js

@@ -0,0 +1,5 @@
+/**
+ * Compact A11y tree snapshot types with @ref support.
+ */
+export {};
+//# sourceMappingURL=snapshot.js.map

package/dist/types/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../src/types/snapshot.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types/webmcp.d.ts

@@ -0,0 +1,39 @@
+/**
+ * WebMCP (Web Model Context Protocol) type definitions.
+ * Based on the W3C WebMCP specification (Chrome 146+).
+ */
+/** JSON Schema type for tool input definitions */
+export interface JSONSchema {
+    type?: string;
+    properties?: Record<string, JSONSchema>;
+    required?: string[];
+    items?: JSONSchema;
+    enum?: unknown[];
+    description?: string;
+    default?: unknown;
+    [key: string]: unknown;
+}
+/** Source of a WebMCP tool discovery */
+export type WebMCPToolSource = 'webmcp-native' | 'synthesized-form' | 'synthesized-button' | 'synthesized-link' | 'synthesized-input';
+/** A tool discovered via WebMCP or auto-synthesis */
+export interface WebMCPTool {
+    name: string;
+    description: string;
+    inputSchema: JSONSchema;
+    source: WebMCPToolSource;
+    tabId: number;
+    elementRef?: string;
+}
+/** Result of invoking a WebMCP tool */
+export interface WebMCPToolResult {
+    success: boolean;
+    content?: unknown;
+    error?: string;
+}
+/** WebMCP server declaration from a page */
+export interface WebMCPServerInfo {
+    name: string;
+    version: string;
+    tools: WebMCPTool[];
+}
+//# sourceMappingURL=webmcp.d.ts.map

package/dist/types/webmcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webmcp.d.ts","sourceRoot":"","sources":["../../src/types/webmcp.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,kDAAkD;AAClD,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wCAAwC;AACxC,MAAM,MAAM,gBAAgB,GACxB,eAAe,GACf,kBAAkB,GAClB,oBAAoB,GACpB,kBAAkB,GAClB,mBAAmB,CAAC;AAExB,qDAAqD;AACrD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;IACxB,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,uCAAuC;AACvC,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,4CAA4C;AAC5C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB"}

package/dist/types/webmcp.js

@@ -0,0 +1,6 @@
+/**
+ * WebMCP (Web Model Context Protocol) type definitions.
+ * Based on the W3C WebMCP specification (Chrome 146+).
+ */
+export {};
+//# sourceMappingURL=webmcp.js.map

package/dist/types/webmcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webmcp.js","sourceRoot":"","sources":["../../src/types/webmcp.ts"],"names":[],"mappings":"AAAA;;;GAGG"}