@snutils/snu 0.1.0

package/dist/server/standalone.js

@@ -0,0 +1,152 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StandaloneBridge = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const crypto = __importStar(require("crypto"));
+const wsBridge_js_1 = require("./wsBridge.js");
+const httpBridge_js_1 = require("./httpBridge.js");
+const dispatcher_js_1 = require("./dispatcher.js");
+class StandaloneBridge {
+    options;
+    wsBridge;
+    httpBridge;
+    token;
+    cwd;
+    writtenPortFiles = [];
+    constructor(options = {}) {
+        this.options = options;
+        this.token = crypto.randomBytes(24).toString('hex');
+        this.cwd = options.cwd || process.cwd();
+    }
+    async start() {
+        // 1. Start WebSocket Bridge on 1978
+        const wsBridge = new wsBridge_js_1.StandaloneWsBridge(this.options.wsPort ?? 1978);
+        const wsPort = await wsBridge.start();
+        this.wsBridge = wsBridge;
+        // 2. Start Dispatcher
+        const dispatcher = new dispatcher_js_1.StandaloneDispatcher({
+            cwd: this.cwd,
+            wsBridge,
+        });
+        // 3. Start HTTP Bridge on 1977
+        const httpBridge = new httpBridge_js_1.StandaloneHttpBridge({
+            port: this.options.httpPort ?? 1977,
+            token: this.token,
+            dispatcher,
+            onYield: async () => {
+                await this.stop();
+                if (this.options.onYield) {
+                    this.options.onYield();
+                }
+            },
+        });
+        const httpPort = await httpBridge.start();
+        this.httpBridge = httpBridge;
+        // 4. Write Port Files
+        this.writePortFiles(httpPort);
+        // 5. Clean up on exit
+        const cleanup = () => {
+            this.cleanPortFiles();
+        };
+        process.once('SIGINT', cleanup);
+        process.once('SIGTERM', cleanup);
+        process.once('exit', cleanup);
+        return { httpPort, wsPort, token: this.token };
+    }
+    writePortFiles(httpPort) {
+        const payload = JSON.stringify({
+            port: httpPort,
+            token: this.token,
+            pid: process.pid,
+            apiVersion: 8,
+            startedAt: Date.now(),
+            hostKind: 'standalone',
+        }, null, 2);
+        // 1. Workspace port file: .vscode/sn-agent-port.json
+        try {
+            const vscodeDir = path.join(this.cwd, '.vscode');
+            if (!fs.existsSync(vscodeDir)) {
+                fs.mkdirSync(vscodeDir, { recursive: true });
+            }
+            const wsPortFile = path.join(vscodeDir, 'sn-agent-port.json');
+            fs.writeFileSync(wsPortFile, payload);
+            this.writtenPortFiles.push(wsPortFile);
+        }
+        catch { }
+        // 2. Global port file: ~/.sn-scriptsync/agent-port.json
+        try {
+            const globalDir = path.join(os.homedir(), '.sn-scriptsync');
+            if (!fs.existsSync(globalDir)) {
+                fs.mkdirSync(globalDir, { recursive: true });
+            }
+            const globalPortFile = path.join(globalDir, 'agent-port.json');
+            fs.writeFileSync(globalPortFile, payload);
+            this.writtenPortFiles.push(globalPortFile);
+        }
+        catch { }
+    }
+    cleanPortFiles() {
+        for (const p of this.writtenPortFiles) {
+            try {
+                if (fs.existsSync(p)) {
+                    const raw = fs.readFileSync(p, 'utf8');
+                    const data = JSON.parse(raw);
+                    // Only remove if this process owns it
+                    if (data.pid === process.pid) {
+                        fs.unlinkSync(p);
+                    }
+                }
+            }
+            catch { }
+        }
+        this.writtenPortFiles = [];
+    }
+    async stop() {
+        this.cleanPortFiles();
+        if (this.httpBridge) {
+            await this.httpBridge.close();
+            this.httpBridge = undefined;
+        }
+        if (this.wsBridge) {
+            await this.wsBridge.close();
+            this.wsBridge = undefined;
+        }
+    }
+}
+exports.StandaloneBridge = StandaloneBridge;
+//# sourceMappingURL=standalone.js.map

package/dist/server/standalone.js.map

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

package/dist/server/wsBridge.d.ts

@@ -0,0 +1,45 @@
+import { PendingRegistry } from './pendingRegistry.js';
+import { HelperCapabilities, InstanceGateSnapshot, SecurityGates } from '../types.js';
+export interface HelperState {
+    tier: 'free' | 'pro' | 'trial' | 'enterprise';
+    proFeatures: boolean;
+    cdp: {
+        available: boolean;
+        reason: string | null;
+    };
+    capabilities: HelperCapabilities;
+    sessionEpoch: string;
+    instanceGates: Map<string, InstanceGateSnapshot>;
+}
+export interface ActiveReview {
+    reviewId: string;
+    nonce: string;
+    payloadHash: string;
+    consumed: boolean;
+    correlationId: string;
+    command: string;
+    params: any;
+    instanceOrigin: string;
+    createdAt: number;
+}
+export declare class StandaloneWsBridge {
+    private port;
+    private pending;
+    private wss?;
+    private activeClient?;
+    private state;
+    private activeReviews;
+    constructor(port?: number, pending?: PendingRegistry);
+    start(): Promise<number>;
+    private resetHelperState;
+    private handleMessage;
+    registerReview(active: Omit<ActiveReview, 'consumed' | 'createdAt'>): void;
+    cancelReview(reviewId: string, reason?: string): void;
+    sendToBrowser(payload: any): void;
+    hasBrowserClient(): boolean;
+    getHelperState(): HelperState;
+    getInstanceGate(instanceUrl?: string, gate?: keyof SecurityGates): import('./policy.js').GateMode;
+    isServerRunning(): boolean;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=wsBridge.d.ts.map

package/dist/server/wsBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wsBridge.d.ts","sourceRoot":"","sources":["../../src/server/wsBridge.ts"],"names":[],"mappings":"AAEA,OAAO,EAA0B,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,aAAa,EAAkB,MAAM,aAAa,CAAC;AAEtG,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,YAAY,CAAC;IAC9C,WAAW,EAAE,OAAO,CAAC;IACrB,GAAG,EAAE;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACnD,YAAY,EAAE,kBAAkB,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,GAAG,CAAC;IACZ,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,kBAAkB;IAc3B,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,OAAO;IAdjB,OAAO,CAAC,GAAG,CAAC,CAAkB;IAC9B,OAAO,CAAC,YAAY,CAAC,CAAY;IACjC,OAAO,CAAC,KAAK,CAOX;IACF,OAAO,CAAC,aAAa,CAAmC;gBAG9C,IAAI,SAAO,EACX,OAAO,GAAE,eAAwC;IAGrD,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAgE9B,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,aAAa;IAuIrB,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,UAAU,GAAG,WAAW,CAAC,GAAG,IAAI;IAQ1E,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAc,GAAG,IAAI;IAc1D,aAAa,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI;IAOjC,gBAAgB,IAAI,OAAO;IAI3B,cAAc,IAAI,WAAW;IAI7B,eAAe,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,aAAa,GAAG,OAAO,aAAa,EAAE,QAAQ;IAYjG,eAAe,IAAI,OAAO;IAIpB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAkB7B"}

package/dist/server/wsBridge.js

@@ -0,0 +1,321 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StandaloneWsBridge = void 0;
+const crypto = __importStar(require("crypto"));
+const ws_1 = require("ws");
+const pendingRegistry_js_1 = require("./pendingRegistry.js");
+class StandaloneWsBridge {
+    port;
+    pending;
+    wss;
+    activeClient;
+    state = {
+        tier: 'free',
+        proFeatures: false,
+        cdp: { available: false, reason: 'E_PRO_REQUIRED' },
+        capabilities: { protocolVersion: 1 },
+        sessionEpoch: '',
+        instanceGates: new Map(),
+    };
+    activeReviews = new Map();
+    constructor(port = 1978, pending = pendingRegistry_js_1.defaultPendingRegistry) {
+        this.port = port;
+        this.pending = pending;
+    }
+    async start() {
+        return new Promise((resolve, reject) => {
+            try {
+                const wss = new ws_1.WebSocketServer({ port: this.port, host: '127.0.0.1' }, () => {
+                    this.wss = wss;
+                    const addr = wss.address();
+                    const actualPort = typeof addr === 'object' && addr ? addr.port : this.port;
+                    this.port = actualPort;
+                    resolve(actualPort);
+                });
+                wss.on('error', (err) => {
+                    reject(err);
+                });
+                wss.on('connection', (ws) => {
+                    if (this.activeClient && this.activeClient !== ws) {
+                        try {
+                            this.activeClient.close(1000, 'Replaced by new connection');
+                        }
+                        catch { }
+                    }
+                    this.activeClient = ws;
+                    this.state.sessionEpoch = crypto.randomUUID();
+                    // Send host hello
+                    try {
+                        ws.send(JSON.stringify({
+                            action: 'hostHello',
+                            protocolVersion: 1,
+                            hostKind: 'standalone',
+                            sessionEpoch: this.state.sessionEpoch,
+                            features: {
+                                commandReview: 1,
+                                rejectionFeedback: 1,
+                                instanceSecurityGates: 1,
+                            },
+                        }));
+                    }
+                    catch { }
+                    ws.on('message', (raw) => {
+                        try {
+                            const msg = JSON.parse(raw.toString('utf8'));
+                            this.handleMessage(ws, msg);
+                        }
+                        catch {
+                            // Ignore malformed frames
+                        }
+                    });
+                    ws.on('close', () => {
+                        if (this.activeClient === ws) {
+                            this.activeClient = undefined;
+                            this.resetHelperState();
+                            this.pending.rejectAll('E_BROWSER_DISCONNECTED', 'Browser helper disconnected');
+                        }
+                    });
+                });
+            }
+            catch (err) {
+                reject(err);
+            }
+        });
+    }
+    resetHelperState() {
+        this.state = {
+            tier: 'free',
+            proFeatures: false,
+            cdp: { available: false, reason: 'E_PRO_REQUIRED' },
+            capabilities: { protocolVersion: 1 },
+            sessionEpoch: '',
+            instanceGates: new Map(),
+        };
+        this.activeReviews.clear();
+    }
+    handleMessage(ws, msg) {
+        if (ws !== this.activeClient)
+            return;
+        // 1. Immutable merge for license / build info
+        if (msg.action === 'helperLicenseInfo' || msg.action === 'helperBuildInfo' || msg.action === 'helperHello') {
+            if (msg.tier)
+                this.state.tier = msg.tier;
+            if (typeof msg.proFeatures === 'boolean')
+                this.state.proFeatures = msg.proFeatures;
+            if (msg.cdp)
+                this.state.cdp = msg.cdp;
+            if (msg.capabilities && typeof msg.capabilities === 'object') {
+                this.state.capabilities = {
+                    ...this.state.capabilities,
+                    ...msg.capabilities,
+                    protocolVersion: msg.capabilities.protocolVersion || 1,
+                };
+            }
+            return;
+        }
+        // 2. Per-Instance Gate Snapshot update
+        if (msg.action === 'helperGatesUpdated') {
+            try {
+                if (!msg.instanceOrigin || typeof msg.instanceOrigin !== 'string' || typeof msg.revision !== 'number')
+                    return;
+                const origin = new URL(msg.instanceOrigin).origin.toLowerCase();
+                const revision = Math.floor(msg.revision);
+                if (!Number.isSafeInteger(revision) || revision < 1)
+                    return;
+                const current = this.state.instanceGates.get(origin);
+                if (current && revision <= current.revision) {
+                    // Discard stale out-of-order revision
+                    return;
+                }
+                const rawGates = msg.gates;
+                if (!rawGates || typeof rawGates !== 'object')
+                    return;
+                const isValidGateVal = (v) => typeof v === 'boolean' || v === 'off' || v === 'approve' || v === 'auto';
+                // Require every field to be a valid gate mode
+                if (!isValidGateVal(rawGates.backgroundScripts) ||
+                    !isValidGateVal(rawGates.deleteRecords) ||
+                    !isValidGateVal(rawGates.createArtifacts) ||
+                    !isValidGateVal(rawGates.browserDebugger) ||
+                    !isValidGateVal(rawGates.restRequest)) {
+                    // Reject malformed / partial gate snapshot
+                    return;
+                }
+                const gates = {
+                    backgroundScripts: rawGates.backgroundScripts,
+                    deleteRecords: rawGates.deleteRecords,
+                    createArtifacts: rawGates.createArtifacts,
+                    browserDebugger: rawGates.browserDebugger,
+                    restRequest: rawGates.restRequest,
+                };
+                this.state.instanceGates.set(origin, {
+                    instanceOrigin: origin,
+                    revision,
+                    receivedAt: Date.now(),
+                    gates,
+                });
+            }
+            catch { }
+            return;
+        }
+        // 3. Two-phase review response from browser helper tab
+        if (msg.action === 'reviewResponse') {
+            const { reviewId, nonce, payloadHash, approved, userFeedback } = msg;
+            const active = this.activeReviews.get(reviewId);
+            if (!active)
+                return;
+            if (active.consumed || active.nonce !== nonce) {
+                // Replay or invalid nonce
+                this.pending.reject(active.correlationId, 'E_REPLAY_DETECTED', 'Replay detected or invalid review nonce', {
+                    reviewId,
+                });
+                this.activeReviews.delete(reviewId);
+                return;
+            }
+            if (active.payloadHash !== payloadHash) {
+                this.pending.reject(active.correlationId, 'E_COMMAND_FAILED', 'Payload hash mismatch during review', {
+                    reviewId,
+                });
+                this.activeReviews.delete(reviewId);
+                return;
+            }
+            // Check if command is still pending (e.g. has not timed out or been cancelled)
+            if (!this.pending.has(active.correlationId)) {
+                this.activeReviews.delete(reviewId);
+                return;
+            }
+            active.consumed = true;
+            if (!approved) {
+                const feedback = typeof userFeedback === 'string' ? userFeedback.slice(0, 1000).trim() : undefined;
+                this.pending.reject(active.correlationId, 'E_USER_REJECTED', feedback ? `Execution rejected by developer: "${feedback}"` : 'Execution rejected by developer in browser helper tab', { userFeedback: feedback, reviewId });
+                this.activeReviews.delete(reviewId);
+                return;
+            }
+            // Approved! Authorize execution on helper
+            try {
+                this.sendToBrowser({
+                    action: 'executeApproved',
+                    reviewId,
+                    nonce,
+                    payloadHash,
+                    agentRequestId: active.correlationId,
+                });
+            }
+            catch (err) {
+                this.pending.reject(active.correlationId, 'E_BROWSER_DISCONNECTED', err?.message || String(err));
+            }
+            return;
+        }
+        // 4. Standard correlated agent responses
+        if (msg.agentRequestId) {
+            if (msg.success === false && msg.code) {
+                this.pending.reject(msg.agentRequestId, msg.code, msg.error || 'Command failed', msg.details);
+            }
+            else {
+                this.pending.resolve(msg.agentRequestId, msg);
+            }
+        }
+    }
+    registerReview(active) {
+        this.activeReviews.set(active.reviewId, {
+            ...active,
+            consumed: false,
+            createdAt: Date.now(),
+        });
+    }
+    cancelReview(reviewId, reason = 'CANCELLED') {
+        const active = this.activeReviews.get(reviewId);
+        if (active) {
+            this.activeReviews.delete(reviewId);
+            try {
+                this.sendToBrowser({
+                    action: 'cancelReview',
+                    reviewId,
+                    reason,
+                });
+            }
+            catch { }
+        }
+    }
+    sendToBrowser(payload) {
+        if (!this.activeClient || this.activeClient.readyState !== ws_1.WebSocket.OPEN) {
+            throw new Error('No browser helper connected. Open the SN Utils helper tab via /token.');
+        }
+        this.activeClient.send(JSON.stringify(payload));
+    }
+    hasBrowserClient() {
+        return !!this.activeClient && this.activeClient.readyState === ws_1.WebSocket.OPEN;
+    }
+    getHelperState() {
+        return this.state;
+    }
+    getInstanceGate(instanceUrl, gate) {
+        if (!instanceUrl || !gate)
+            return 'off';
+        try {
+            const origin = new URL(instanceUrl).origin.toLowerCase();
+            const snap = this.state.instanceGates.get(origin);
+            if (snap) {
+                return snap.gates[gate] ?? 'approve';
+            }
+        }
+        catch { }
+        return 'off';
+    }
+    isServerRunning() {
+        return !!this.wss;
+    }
+    async close() {
+        this.resetHelperState();
+        this.pending.rejectAll('E_SERVER_STOPPED', 'ScriptSync server stopped');
+        if (this.activeClient) {
+            try {
+                this.activeClient.close();
+            }
+            catch { }
+            this.activeClient = undefined;
+        }
+        if (this.wss) {
+            return new Promise((resolve) => {
+                this.wss.close(() => {
+                    this.wss = undefined;
+                    resolve();
+                });
+            });
+        }
+    }
+}
+exports.StandaloneWsBridge = StandaloneWsBridge;
+//# sourceMappingURL=wsBridge.js.map

package/dist/server/wsBridge.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Wire-format and domain interfaces for @snutils/snu
+ */
+import { SecurityGates, CommandPolicy } from './server/policy.js';
+export { SecurityGates, CommandPolicy };
+export interface AgentRequest {
+    id: string;
+    command: string;
+    params?: Record<string, any>;
+    instance?: string;
+    timestamp?: number;
+}
+export interface AgentResponse<T = any> {
+    id: string;
+    command: string;
+    status: 'success' | 'error';
+    result?: T;
+    error?: string;
+    code?: string;
+    timestamp: number;
+    details?: {
+        userFeedback?: string;
+        reviewId?: string;
+        instanceOrigin?: string;
+        expiresIn?: number;
+        [key: string]: any;
+    };
+}
+export interface HelperCapabilities {
+    protocolVersion: number;
+    commandReview?: 1;
+    rejectionFeedback?: 1;
+    instanceSecurityGates?: 1;
+}
+export interface InstanceGateSnapshot {
+    instanceOrigin: string;
+    revision: number;
+    receivedAt: number;
+    gates: SecurityGates;
+}
+export interface ReviewEnvelope {
+    required: true;
+    reviewId: string;
+    nonce: string;
+    payloadHash: string;
+    kind: 'background_script' | 'record_delete' | 'rest_delete' | 'ui_action' | 'bulk_delete';
+    summary: string;
+    targets?: Array<{
+        table: string;
+        sys_id: string;
+        display?: string;
+    }>;
+    script?: string;
+    instanceOrigin: string;
+    client: {
+        name: string;
+        version?: string;
+        hostKind: 'vscode' | 'standalone';
+        pid?: number;
+    };
+}
+export interface StagedWriteResult {
+    staged: true;
+    reviewId: string;
+    message: string;
+}
+export interface AgentPortFile {
+    port: number;
+    token: string;
+    pid: number;
+    apiVersion: number;
+    startedAt: number;
+    extensionVersion?: string;
+}
+export interface HealthResponse {
+    status: 'success';
+    apiVersion: number;
+    hostKind?: 'vscode' | 'standalone';
+    commands: string[];
+    pid: number;
+}
+export interface DiscoveryOptions {
+    portFile?: string;
+    cwd?: string;
+}
+export interface DiscoveryResult {
+    port: number;
+    token: string;
+    pid: number;
+    apiVersion: number;
+    portFilePath: string;
+    isGlobal: boolean;
+}
+export interface MappedCommand {
+    command: string;
+    instance?: string;
+    params: Record<string, any>;
+}
+export interface ToolOptionDefinition {
+    type: 'string' | 'boolean';
+    short?: string;
+    description?: string;
+    default?: any;
+}
+export interface ToolDefinition {
+    name: string;
+    agentCommand: string;
+    description: string;
+    cliCommand: string;
+    cliUsage?: string;
+    cliOptions?: Record<string, ToolOptionDefinition>;
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, any>;
+        required?: string[];
+        anyOf?: Array<{
+            required: string[];
+        }>;
+        additionalProperties?: boolean;
+    };
+    mapInput: (input: Record<string, any>) => MappedCommand;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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