@agentuity/pi 1.0.36 → 2.0.17

package/dist/client.js

@@ -1,116 +0,0 @@
-/** How long to wait for a response before rejecting the pending promise (ms). */
-const SEND_TIMEOUT_MS = 30_000;
-/** How long to wait for the init message after connecting (ms). */
-const CONNECT_TIMEOUT_MS = 30_000;
-export class HubClient {
-    ws = null;
-    pending = new Map();
-    async connect(url) {
-        // Guard against overlapping connections — old socket handlers would corrupt shared state
-        if (this.ws && this.ws.readyState !== WebSocket.CLOSED) {
-            throw new Error('Already connected or connecting — call close() first');
-        }
-        return new Promise((resolve, reject) => {
-            // Ensure ws:// or wss:// protocol — upgrade http(s) URLs automatically
-            let wsUrl = url;
-            if (wsUrl.startsWith('http://')) {
-                wsUrl = 'ws://' + wsUrl.slice(7);
-            }
-            else if (wsUrl.startsWith('https://')) {
-                wsUrl = 'wss://' + wsUrl.slice(8);
-            }
-            else if (!wsUrl.startsWith('ws://') && !wsUrl.startsWith('wss://')) {
-                wsUrl = 'ws://' + wsUrl;
-            }
-            this.ws = new WebSocket(wsUrl);
-            // Guard against duplicate init messages re-invoking the resolve
-            let initResolved = false;
-            const connectTimer = setTimeout(() => {
-                if (!initResolved) {
-                    reject(new Error(`Hub did not send init message within ${CONNECT_TIMEOUT_MS}ms`));
-                    this.ws?.close();
-                }
-            }, CONNECT_TIMEOUT_MS);
-            this.ws.onmessage = (event) => {
-                let data;
-                try {
-                    const raw = typeof event.data === 'string'
-                        ? event.data
-                        : new TextDecoder().decode(event.data);
-                    data = JSON.parse(raw);
-                }
-                catch {
-                    // Malformed or non-JSON frame — ignore
-                    return;
-                }
-                // First message should be init
-                if (data.type === 'init' && !initResolved) {
-                    initResolved = true;
-                    clearTimeout(connectTimer);
-                    resolve(data);
-                    return;
-                }
-                // Otherwise it's a response to a pending request
-                const response = data;
-                const entry = this.pending.get(response.id);
-                if (entry) {
-                    clearTimeout(entry.timer);
-                    this.pending.delete(response.id);
-                    entry.resolve(response);
-                }
-            };
-            this.ws.onerror = (err) => {
-                // ErrorEvent has a message property; plain Event does not
-                const message = 'message' in err && typeof err.message === 'string'
-                    ? err.message
-                    : `connection to ${wsUrl} failed`;
-                clearTimeout(connectTimer);
-                reject(new Error(`WebSocket error: ${message}`));
-            };
-            this.ws.onclose = () => {
-                clearTimeout(connectTimer);
-                // Reject connect() promise if init was never received
-                if (!initResolved) {
-                    reject(new Error('WebSocket closed before init message received'));
-                }
-                // Reject all pending requests
-                for (const [id, entry] of this.pending) {
-                    clearTimeout(entry.timer);
-                    entry.reject(new Error('WebSocket closed'));
-                    this.pending.delete(id);
-                }
-                this.ws = null;
-            };
-        });
-    }
-    nextId() {
-        return crypto.randomUUID();
-    }
-    async send(request) {
-        if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
-            // Return a default ACK if not connected
-            return { id: request.id, actions: [{ action: 'ACK' }] };
-        }
-        return new Promise((resolve, reject) => {
-            const timer = setTimeout(() => {
-                const entry = this.pending.get(request.id);
-                if (entry) {
-                    this.pending.delete(request.id);
-                    entry.reject(new Error(`Hub response timeout after ${SEND_TIMEOUT_MS}ms for request ${request.id}`));
-                }
-            }, SEND_TIMEOUT_MS);
-            this.pending.set(request.id, { resolve, reject, timer });
-            this.ws.send(JSON.stringify(request));
-        });
-    }
-    close() {
-        if (this.ws) {
-            this.ws.close();
-            this.ws = null;
-        }
-    }
-    get connected() {
-        return this.ws !== null && this.ws.readyState === WebSocket.OPEN;
-    }
-}
-//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/handlers.d.ts

@@ -1,19 +0,0 @@
-import type { HubAction } from './protocol.ts';
-export interface ActionResult {
-    block?: {
-        block: true;
-        reason: string;
-    };
-    returnValue?: unknown;
-}
-/** Minimal UI surface used by action handlers — avoids a hard dep on pi-coding-agent. */
-interface ActionContext {
-    ui?: {
-        notify(message: string, level?: 'info' | 'warning' | 'error'): void;
-        confirm(title: string, message: string): Promise<boolean>;
-        setStatus(key: string, text?: string): void;
-    };
-}
-export declare function processActions(actions: HubAction[], ctx: ActionContext): Promise<ActionResult>;
-export {};
-//# sourceMappingURL=handlers.d.ts.map

package/dist/handlers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../src/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,MAAM,WAAW,YAAY;IAC5B,KAAK,CAAC,EAAE;QAAE,KAAK,EAAE,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,WAAW,CAAC,EAAE,OAAO,CAAC;CAEtB;AAED,yFAAyF;AACzF,UAAU,aAAa;IACtB,EAAE,CAAC,EAAE;QACJ,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,IAAI,CAAC;QACpE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAC1D,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC5C,CAAC;CACF;AAED,wBAAsB,cAAc,CACnC,OAAO,EAAE,SAAS,EAAE,EACpB,GAAG,EAAE,aAAa,GAChB,OAAO,CAAC,YAAY,CAAC,CA6DvB"}

package/dist/handlers.js

@@ -1,57 +0,0 @@
-export async function processActions(actions, ctx) {
-    let result = {};
-    for (const action of actions) {
-        switch (action.action) {
-            case 'ACK':
-                // Terminal: proceed normally
-                result = {};
-                break;
-            case 'BLOCK':
-                // Terminal: block
-                result = { block: { block: true, reason: action.reason } };
-                break;
-            case 'RETURN':
-                // Terminal: return a specific result
-                result = { returnValue: action.result };
-                break;
-            case 'NOTIFY':
-                // Side effect: show notification, continue
-                if (ctx?.ui) {
-                    ctx.ui.notify(action.message, action.level ?? 'info');
-                }
-                break;
-            case 'STATUS':
-                // Side effect: set status, continue
-                if (ctx?.ui) {
-                    ctx.ui.setStatus(action.key, action.text);
-                }
-                break;
-            case 'CONFIRM': {
-                // Gate: if user denies, stop and block
-                if (ctx?.ui) {
-                    const confirmed = await ctx.ui.confirm(action.title, action.message);
-                    if (!confirmed) {
-                        return {
-                            block: {
-                                block: true,
-                                reason: action.deny_reason ?? 'Denied by user',
-                            },
-                        };
-                    }
-                }
-                else {
-                    // No UI available — block by default for safety
-                    result = {
-                        block: {
-                            block: true,
-                            reason: action.deny_reason ?? 'Confirmation required but no UI available',
-                        },
-                    };
-                }
-                break;
-            }
-        }
-    }
-    return result;
-}
-//# sourceMappingURL=handlers.js.map

package/dist/handlers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../src/handlers.ts"],"names":[],"mappings":"AAiBA,MAAM,CAAC,KAAK,UAAU,cAAc,CACnC,OAAoB,EACpB,GAAkB;IAElB,IAAI,MAAM,GAAiB,EAAE,CAAC;IAE9B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,QAAQ,MAAM,CAAC,MAAM,EAAE,CAAC;YACvB,KAAK,KAAK;gBACT,6BAA6B;gBAC7B,MAAM,GAAG,EAAE,CAAC;gBACZ,MAAM;YAEP,KAAK,OAAO;gBACX,kBAAkB;gBAClB,MAAM,GAAG,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC3D,MAAM;YAEP,KAAK,QAAQ;gBACZ,qCAAqC;gBACrC,MAAM,GAAG,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;gBACxC,MAAM;YAEP,KAAK,QAAQ;gBACZ,2CAA2C;gBAC3C,IAAI,GAAG,EAAE,EAAE,EAAE,CAAC;oBACb,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,CAAC;gBACvD,CAAC;gBACD,MAAM;YAEP,KAAK,QAAQ;gBACZ,oCAAoC;gBACpC,IAAI,GAAG,EAAE,EAAE,EAAE,CAAC;oBACb,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;gBAC3C,CAAC;gBACD,MAAM;YAEP,KAAK,SAAS,CAAC,CAAC,CAAC;gBAChB,uCAAuC;gBACvC,IAAI,GAAG,EAAE,EAAE,EAAE,CAAC;oBACb,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;oBACrE,IAAI,CAAC,SAAS,EAAE,CAAC;wBAChB,OAAO;4BACN,KAAK,EAAE;gCACN,KAAK,EAAE,IAAI;gCACX,MAAM,EAAE,MAAM,CAAC,WAAW,IAAI,gBAAgB;6BAC9C;yBACD,CAAC;oBACH,CAAC;gBACF,CAAC;qBAAM,CAAC;oBACP,gDAAgD;oBAChD,MAAM,GAAG;wBACR,KAAK,EAAE;4BACN,KAAK,EAAE,IAAI;4BACX,MAAM,EAAE,MAAM,CAAC,WAAW,IAAI,2CAA2C;yBACzE;qBACD,CAAC;gBACH,CAAC;gBACD,MAAM;YACP,CAAC;QACF,CAAC;IACF,CAAC;IAED,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/protocol.d.ts

@@ -1,68 +0,0 @@
-export interface HubToolDefinition {
-    name: string;
-    label: string;
-    description: string;
-    parameters: Record<string, unknown>;
-}
-export interface HubCommandDefinition {
-    name: string;
-    description: string;
-}
-export interface InitMessage {
-    type: 'init';
-    tools?: HubToolDefinition[];
-    commands?: HubCommandDefinition[];
-}
-export interface EventRequest {
-    id: string;
-    type: 'event';
-    event: string;
-    data: Record<string, unknown>;
-}
-export interface ToolRequest {
-    id: string;
-    type: 'tool';
-    name: string;
-    toolCallId: string;
-    params: Record<string, unknown>;
-}
-export interface CommandRequest {
-    id: string;
-    type: 'command';
-    name: string;
-    args: string;
-}
-export type HubRequest = EventRequest | ToolRequest | CommandRequest;
-export interface AckAction {
-    action: 'ACK';
-}
-export interface BlockAction {
-    action: 'BLOCK';
-    reason: string;
-}
-export interface ConfirmAction {
-    action: 'CONFIRM';
-    title: string;
-    message: string;
-    deny_reason?: string;
-}
-export interface NotifyAction {
-    action: 'NOTIFY';
-    message: string;
-    level?: 'info' | 'warning' | 'error';
-}
-export interface ReturnAction {
-    action: 'RETURN';
-    result: unknown;
-}
-export interface StatusAction {
-    action: 'STATUS';
-    key: string;
-    text?: string;
-}
-export type HubAction = AckAction | BlockAction | ConfirmAction | NotifyAction | ReturnAction | StatusAction;
-export interface HubResponse {
-    id: string;
-    actions: HubAction[];
-}
-//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,oBAAoB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE,oBAAoB,EAAE,CAAC;CAClC;AAID,MAAM,WAAW,YAAY;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,cAAc;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,UAAU,GAAG,YAAY,GAAG,WAAW,GAAG,cAAc,CAAC;AAIrE,MAAM,WAAW,SAAS;IACzB,MAAM,EAAE,KAAK,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC7B,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC5B,MAAM,EAAE,QAAQ,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;CACrC;AAED,MAAM,WAAW,YAAY;IAC5B,MAAM,EAAE,QAAQ,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC5B,MAAM,EAAE,QAAQ,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,SAAS,GAClB,SAAS,GACT,WAAW,GACX,aAAa,GACb,YAAY,GACZ,YAAY,GACZ,YAAY,CAAC;AAIhB,MAAM,WAAW,WAAW;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,SAAS,EAAE,CAAC;CACrB"}

package/dist/protocol.js

@@ -1,3 +0,0 @@
-// ---- Init Message (Server → Client on connect) ----
-export {};
-//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

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

package/src/client.ts

@@ -1,144 +0,0 @@
-import type { InitMessage, HubRequest, HubResponse } from './protocol.ts';
-
-/** How long to wait for a response before rejecting the pending promise (ms). */
-const SEND_TIMEOUT_MS = 30_000;
-
-/** How long to wait for the init message after connecting (ms). */
-const CONNECT_TIMEOUT_MS = 30_000;
-
-export class HubClient {
-	private ws: WebSocket | null = null;
-	private pending = new Map<
-		string,
-		{
-			resolve: (resp: HubResponse) => void;
-			reject: (err: Error) => void;
-			timer: ReturnType<typeof setTimeout>;
-		}
-	>();
-	async connect(url: string): Promise<InitMessage> {
-		// Guard against overlapping connections — old socket handlers would corrupt shared state
-		if (this.ws && this.ws.readyState !== WebSocket.CLOSED) {
-			throw new Error('Already connected or connecting — call close() first');
-		}
-
-		return new Promise((resolve, reject) => {
-			// Ensure ws:// or wss:// protocol — upgrade http(s) URLs automatically
-			let wsUrl = url;
-			if (wsUrl.startsWith('http://')) {
-				wsUrl = 'ws://' + wsUrl.slice(7);
-			} else if (wsUrl.startsWith('https://')) {
-				wsUrl = 'wss://' + wsUrl.slice(8);
-			} else if (!wsUrl.startsWith('ws://') && !wsUrl.startsWith('wss://')) {
-				wsUrl = 'ws://' + wsUrl;
-			}
-
-			this.ws = new WebSocket(wsUrl);
-
-			// Guard against duplicate init messages re-invoking the resolve
-			let initResolved = false;
-
-			const connectTimer = setTimeout(() => {
-				if (!initResolved) {
-					reject(new Error(`Hub did not send init message within ${CONNECT_TIMEOUT_MS}ms`));
-					this.ws?.close();
-				}
-			}, CONNECT_TIMEOUT_MS);
-
-			this.ws.onmessage = (event: MessageEvent) => {
-				let data: Record<string, unknown>;
-				try {
-					const raw =
-						typeof event.data === 'string'
-							? event.data
-							: new TextDecoder().decode(event.data as ArrayBuffer);
-					data = JSON.parse(raw) as Record<string, unknown>;
-				} catch {
-					// Malformed or non-JSON frame — ignore
-					return;
-				}
-
-				// First message should be init
-				if (data.type === 'init' && !initResolved) {
-					initResolved = true;
-					clearTimeout(connectTimer);
-					resolve(data as unknown as InitMessage);
-					return;
-				}
-
-				// Otherwise it's a response to a pending request
-				const response = data as unknown as HubResponse;
-				const entry = this.pending.get(response.id);
-				if (entry) {
-					clearTimeout(entry.timer);
-					this.pending.delete(response.id);
-					entry.resolve(response);
-				}
-			};
-
-			this.ws.onerror = (err: Event) => {
-				// ErrorEvent has a message property; plain Event does not
-				const message =
-					'message' in err && typeof (err as ErrorEvent).message === 'string'
-						? (err as ErrorEvent).message
-						: `connection to ${wsUrl} failed`;
-				clearTimeout(connectTimer);
-				reject(new Error(`WebSocket error: ${message}`));
-			};
-
-			this.ws.onclose = () => {
-				clearTimeout(connectTimer);
-				// Reject connect() promise if init was never received
-				if (!initResolved) {
-					reject(new Error('WebSocket closed before init message received'));
-				}
-				// Reject all pending requests
-				for (const [id, entry] of this.pending) {
-					clearTimeout(entry.timer);
-					entry.reject(new Error('WebSocket closed'));
-					this.pending.delete(id);
-				}
-				this.ws = null;
-			};
-		});
-	}
-
-	nextId(): string {
-		return crypto.randomUUID();
-	}
-
-	async send(request: HubRequest): Promise<HubResponse> {
-		if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
-			// Return a default ACK if not connected
-			return { id: request.id, actions: [{ action: 'ACK' }] };
-		}
-
-		return new Promise<HubResponse>((resolve, reject) => {
-			const timer = setTimeout(() => {
-				const entry = this.pending.get(request.id);
-				if (entry) {
-					this.pending.delete(request.id);
-					entry.reject(
-						new Error(
-							`Hub response timeout after ${SEND_TIMEOUT_MS}ms for request ${request.id}`
-						)
-					);
-				}
-			}, SEND_TIMEOUT_MS);
-
-			this.pending.set(request.id, { resolve, reject, timer });
-			this.ws!.send(JSON.stringify(request));
-		});
-	}
-
-	close(): void {
-		if (this.ws) {
-			this.ws.close();
-			this.ws = null;
-		}
-	}
-
-	get connected(): boolean {
-		return this.ws !== null && this.ws.readyState === WebSocket.OPEN;
-	}
-}

package/src/handlers.ts

@@ -1,82 +0,0 @@
-import type { HubAction } from './protocol.ts';
-
-export interface ActionResult {
-	block?: { block: true; reason: string };
-	returnValue?: unknown;
-	// undefined means ACK (proceed normally)
-}
-
-/** Minimal UI surface used by action handlers — avoids a hard dep on pi-coding-agent. */
-interface ActionContext {
-	ui?: {
-		notify(message: string, level?: 'info' | 'warning' | 'error'): void;
-		confirm(title: string, message: string): Promise<boolean>;
-		setStatus(key: string, text?: string): void;
-	};
-}
-
-export async function processActions(
-	actions: HubAction[],
-	ctx: ActionContext
-): Promise<ActionResult> {
-	let result: ActionResult = {};
-
-	for (const action of actions) {
-		switch (action.action) {
-			case 'ACK':
-				// Terminal: proceed normally
-				result = {};
-				break;
-
-			case 'BLOCK':
-				// Terminal: block
-				result = { block: { block: true, reason: action.reason } };
-				break;
-
-			case 'RETURN':
-				// Terminal: return a specific result
-				result = { returnValue: action.result };
-				break;
-
-			case 'NOTIFY':
-				// Side effect: show notification, continue
-				if (ctx?.ui) {
-					ctx.ui.notify(action.message, action.level ?? 'info');
-				}
-				break;
-
-			case 'STATUS':
-				// Side effect: set status, continue
-				if (ctx?.ui) {
-					ctx.ui.setStatus(action.key, action.text);
-				}
-				break;
-
-			case 'CONFIRM': {
-				// Gate: if user denies, stop and block
-				if (ctx?.ui) {
-					const confirmed = await ctx.ui.confirm(action.title, action.message);
-					if (!confirmed) {
-						return {
-							block: {
-								block: true,
-								reason: action.deny_reason ?? 'Denied by user',
-							},
-						};
-					}
-				} else {
-					// No UI available — block by default for safety
-					result = {
-						block: {
-							block: true,
-							reason: action.deny_reason ?? 'Confirmation required but no UI available',
-						},
-					};
-				}
-				break;
-			}
-		}
-	}
-
-	return result;
-}

package/src/protocol.ts

@@ -1,95 +0,0 @@
-// ---- Init Message (Server → Client on connect) ----
-
-export interface HubToolDefinition {
-	name: string;
-	label: string;
-	description: string;
-	parameters: Record<string, unknown>; // JSON Schema object
-}
-
-export interface HubCommandDefinition {
-	name: string;
-	description: string;
-}
-
-export interface InitMessage {
-	type: 'init';
-	tools?: HubToolDefinition[];
-	commands?: HubCommandDefinition[];
-}
-
-// ---- Request Messages (Client → Server) ----
-
-export interface EventRequest {
-	id: string;
-	type: 'event';
-	event: string;
-	data: Record<string, unknown>;
-}
-
-export interface ToolRequest {
-	id: string;
-	type: 'tool';
-	name: string;
-	toolCallId: string;
-	params: Record<string, unknown>;
-}
-
-export interface CommandRequest {
-	id: string;
-	type: 'command';
-	name: string;
-	args: string;
-}
-
-export type HubRequest = EventRequest | ToolRequest | CommandRequest;
-
-// ---- Actions ----
-
-export interface AckAction {
-	action: 'ACK';
-}
-
-export interface BlockAction {
-	action: 'BLOCK';
-	reason: string;
-}
-
-export interface ConfirmAction {
-	action: 'CONFIRM';
-	title: string;
-	message: string;
-	deny_reason?: string;
-}
-
-export interface NotifyAction {
-	action: 'NOTIFY';
-	message: string;
-	level?: 'info' | 'warning' | 'error';
-}
-
-export interface ReturnAction {
-	action: 'RETURN';
-	result: unknown;
-}
-
-export interface StatusAction {
-	action: 'STATUS';
-	key: string;
-	text?: string; // undefined = clear status
-}
-
-export type HubAction =
-	| AckAction
-	| BlockAction
-	| ConfirmAction
-	| NotifyAction
-	| ReturnAction
-	| StatusAction;
-
-// ---- Response Message (Server → Client) ----
-
-export interface HubResponse {
-	id: string;
-	actions: HubAction[];
-}