@unclick/mcp-server 0.3.20 → 0.3.22

package/dist/__tests__/reliability.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=reliability.test.d.ts.map

package/dist/__tests__/reliability.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reliability.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/reliability.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/reliability.test.js

@@ -0,0 +1,126 @@
+import { describe, expect, it } from "vitest";
+import { createDispatchId, createHeartbeat, createReclaimSignal, createTimeBucket, decideStaleLease, } from "../reliability.js";
+describe("reliability helpers", () => {
+    it("creates a stable dispatch ID from sorted payload data", () => {
+        const first = createDispatchId({
+            source: "fishbowl",
+            targetAgentId: "bailey",
+            taskRef: "chip-123",
+            timeBucket: "2026-04-30T11:00:00.000Z",
+            payload: { b: 2, a: 1 },
+        });
+        const second = createDispatchId({
+            source: "fishbowl",
+            targetAgentId: "bailey",
+            taskRef: "chip-123",
+            timeBucket: "2026-04-30T11:00:00.000Z",
+            payload: { a: 1, b: 2 },
+        });
+        expect(first).toBe(second);
+        expect(first).toMatch(/^dispatch_[a-f0-9]{32}$/);
+    });
+    it("creates different dispatch IDs when the task changes", () => {
+        const first = createDispatchId({
+            source: "fishbowl",
+            targetAgentId: "bailey",
+            taskRef: "chip-123",
+        });
+        const second = createDispatchId({
+            source: "fishbowl",
+            targetAgentId: "bailey",
+            taskRef: "chip-124",
+        });
+        expect(first).not.toBe(second);
+    });
+    it("buckets dispatch time into stable windows", () => {
+        expect(createTimeBucket(new Date("2026-04-30T11:00:04.999Z"), 5)).toBe("2026-04-30T11:00:00.000Z");
+        expect(createTimeBucket(new Date("2026-04-30T11:00:05.000Z"), 5)).toBe("2026-04-30T11:00:05.000Z");
+    });
+    it("detects expired leases", () => {
+        const decision = decideStaleLease({
+            status: "leased",
+            leaseExpiresAt: "2026-04-30T11:00:00.000Z",
+        }, new Date("2026-04-30T11:00:12.300Z"));
+        expect(decision).toEqual({
+            isStale: true,
+            reason: "lease_expired",
+            staleSeconds: 12,
+        });
+    });
+    it("does not mark active or non-leased work as stale", () => {
+        expect(decideStaleLease({
+            status: "leased",
+            leaseExpiresAt: "2026-04-30T11:00:12.000Z",
+        }, new Date("2026-04-30T11:00:10.000Z"))).toMatchObject({ isStale: false, reason: "lease_active" });
+        expect(decideStaleLease({
+            status: "queued",
+            leaseExpiresAt: "2026-04-30T11:00:00.000Z",
+        }, new Date("2026-04-30T11:00:10.000Z"))).toMatchObject({ isStale: false, reason: "not_leased" });
+    });
+    it("creates compact heartbeat metadata", () => {
+        const heartbeat = createHeartbeat({
+            apiKeyHash: "hash_123",
+            agentId: "bailey",
+            dispatchId: "dispatch_abc",
+            state: "working",
+            currentTask: "write WakePass PRD",
+            nextAction: "open PR",
+            etaMinutes: 4,
+            createdAt: new Date("2026-04-30T11:00:00.000Z"),
+            lastRealActionAt: new Date("2026-04-30T10:59:30.000Z"),
+        });
+        expect(heartbeat).toEqual({
+            apiKeyHash: "hash_123",
+            agentId: "bailey",
+            dispatchId: "dispatch_abc",
+            state: "working",
+            currentTask: "write WakePass PRD",
+            nextAction: "open PR",
+            etaMinutes: 4,
+            createdAt: "2026-04-30T11:00:00.000Z",
+            lastRealActionAt: "2026-04-30T10:59:30.000Z",
+        });
+    });
+    it("marks missing-ack handoffs as a WakePass reliability miss", () => {
+        const signal = createReclaimSignal({
+            dispatchId: "dispatch_ack",
+            source: "fishbowl",
+            targetAgentId: "plex",
+            taskRef: "todo-123",
+            payload: { ack_required: true, handoff_message_id: "msg-abc" },
+        }, 95);
+        expect(signal).toEqual({
+            action: "handoff_ack_missing",
+            summary: "WakePass reliability miss: no ACK arrived before reclaim for plex",
+            payload: {
+                dispatch_id: "dispatch_ack",
+                source: "fishbowl",
+                target_agent_id: "plex",
+                task_ref: "todo-123",
+                stale_seconds: 95,
+                ack_required: true,
+                handoff_message_id: "msg-abc",
+            },
+        });
+    });
+    it("marks non-ack reclaim as a generic stale dispatch", () => {
+        const signal = createReclaimSignal({
+            dispatchId: "dispatch_generic",
+            source: "connectors",
+            targetAgentId: "bailey",
+            taskRef: "conn-42",
+            payload: { route: "oauth-health" },
+        }, 12);
+        expect(signal.action).toBe("stale_dispatch_reclaimed");
+        expect(signal.summary).toBe("Reclaimed stale connectors dispatch for bailey");
+        expect(signal.payload).toMatchObject({
+            dispatch_id: "dispatch_generic",
+            source: "connectors",
+            target_agent_id: "bailey",
+            task_ref: "conn-42",
+            stale_seconds: 12,
+            route: "oauth-health",
+        });
+    });
+});
+//# sourceMappingURL=reliability.test.js.map

package/dist/__tests__/reliability.test.js.map

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

package/dist/reliability.d.ts

@@ -0,0 +1,69 @@
+export type DispatchSource = "fishbowl" | "connectors" | "wakepass" | "testpass" | "uxpass" | "flowpass" | "securitypass" | "manual";
+export type DispatchStatus = "queued" | "leased" | "completed" | "failed" | "stale" | "cancelled";
+export type HeartbeatState = "idle" | "received" | "accepted" | "working" | "blocked" | "completed";
+export interface AgentDispatch {
+    apiKeyHash: string;
+    dispatchId: string;
+    source: DispatchSource;
+    targetAgentId: string;
+    taskRef?: string;
+    status: DispatchStatus;
+    leaseOwner?: string;
+    leaseExpiresAt?: string;
+    lastRealActionAt?: string;
+    createdAt: string;
+    updatedAt: string;
+    payload?: Record<string, unknown>;
+}
+export interface AgentHeartbeat {
+    apiKeyHash: string;
+    agentId: string;
+    dispatchId?: string;
+    state: HeartbeatState;
+    currentTask?: string;
+    nextAction?: string;
+    etaMinutes?: number;
+    blocker?: string;
+    lastRealActionAt?: string;
+    createdAt: string;
+}
+export interface DispatchIdInput {
+    source: DispatchSource;
+    targetAgentId: string;
+    taskRef?: string;
+    promptHash?: string;
+    timeBucket?: string;
+    payload?: Record<string, unknown>;
+}
+export interface ReclaimSignalDescriptor {
+    action: "stale_dispatch_reclaimed" | "handoff_ack_missing";
+    summary: string;
+    payload: Record<string, unknown>;
+}
+export interface StaleLeaseInput {
+    status: DispatchStatus;
+    leaseExpiresAt?: string | null;
+    lastRealActionAt?: string | null;
+}
+export interface StaleLeaseDecision {
+    isStale: boolean;
+    reason: "not_leased" | "missing_lease_expiry" | "lease_active" | "lease_expired";
+    staleSeconds: number;
+}
+export declare function createDispatchId(input: DispatchIdInput): string;
+export declare function createTimeBucket(date: Date, bucketSeconds?: number): string;
+export declare function decideStaleLease(input: StaleLeaseInput, now?: Date): StaleLeaseDecision;
+export declare function createHeartbeat(params: {
+    apiKeyHash: string;
+    agentId: string;
+    state: HeartbeatState;
+    createdAt?: Date;
+    dispatchId?: string;
+    currentTask?: string;
+    nextAction?: string;
+    etaMinutes?: number;
+    blocker?: string;
+    lastRealActionAt?: Date;
+}): AgentHeartbeat;
+export declare function createReclaimSignal(dispatch: Pick<AgentDispatch, "dispatchId" | "source" | "targetAgentId" | "taskRef" | "payload">, staleSeconds: number): ReclaimSignalDescriptor;
+//# sourceMappingURL=reliability.d.ts.map

package/dist/reliability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reliability.d.ts","sourceRoot":"","sources":["../src/reliability.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,cAAc,GACtB,UAAU,GACV,YAAY,GACZ,UAAU,GACV,UAAU,GACV,QAAQ,GACR,UAAU,GACV,cAAc,GACd,QAAQ,CAAC;AAEb,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,QAAQ,GACR,WAAW,GACX,QAAQ,GACR,OAAO,GACP,WAAW,CAAC;AAEhB,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,UAAU,GACV,UAAU,GACV,SAAS,GACT,SAAS,GACT,WAAW,CAAC;AAEhB,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,cAAc,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,cAAc,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,cAAc,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,cAAc,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,0BAA0B,GAAG,qBAAqB,CAAC;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,cAAc,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,YAAY,GAAG,sBAAsB,GAAG,cAAc,GAAG,eAAe,CAAC;IACjF,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAO/D;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,aAAa,SAAI,GAAG,MAAM,CAQtE;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,eAAe,EACtB,GAAG,OAAa,GACf,kBAAkB,CAwBpB;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,cAAc,CAAC;IACtB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,IAAI,CAAC;CACzB,GAAG,cAAc,CAkBjB;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,YAAY,GAAG,QAAQ,GAAG,eAAe,GAAG,SAAS,GAAG,SAAS,CAAC,EAChG,YAAY,EAAE,MAAM,GACnB,uBAAuB,CAmCzB"}

package/dist/reliability.js

@@ -0,0 +1,106 @@
+import { createHash } from "node:crypto";
+export function createDispatchId(input) {
+    const hash = createHash("sha256")
+        .update(stableStringify(input))
+        .digest("hex")
+        .slice(0, 32);
+    return `dispatch_${hash}`;
+}
+export function createTimeBucket(date, bucketSeconds = 5) {
+    if (!Number.isFinite(bucketSeconds) || bucketSeconds <= 0) {
+        throw new Error("bucketSeconds must be a positive number");
+    }
+    const bucketMs = bucketSeconds * 1000;
+    const bucketStart = Math.floor(date.getTime() / bucketMs) * bucketMs;
+    return new Date(bucketStart).toISOString();
+}
+export function decideStaleLease(input, now = new Date()) {
+    if (input.status !== "leased") {
+        return { isStale: false, reason: "not_leased", staleSeconds: 0 };
+    }
+    if (!input.leaseExpiresAt) {
+        return { isStale: false, reason: "missing_lease_expiry", staleSeconds: 0 };
+    }
+    const leaseExpiresAtMs = Date.parse(input.leaseExpiresAt);
+    if (Number.isNaN(leaseExpiresAtMs)) {
+        return { isStale: false, reason: "missing_lease_expiry", staleSeconds: 0 };
+    }
+    const staleMs = now.getTime() - leaseExpiresAtMs;
+    if (staleMs <= 0) {
+        return { isStale: false, reason: "lease_active", staleSeconds: 0 };
+    }
+    return {
+        isStale: true,
+        reason: "lease_expired",
+        staleSeconds: Math.floor(staleMs / 1000),
+    };
+}
+export function createHeartbeat(params) {
+    const heartbeat = {
+        apiKeyHash: params.apiKeyHash,
+        agentId: params.agentId,
+        state: params.state,
+        createdAt: (params.createdAt ?? new Date()).toISOString(),
+    };
+    if (params.dispatchId)
+        heartbeat.dispatchId = params.dispatchId;
+    if (params.currentTask)
+        heartbeat.currentTask = params.currentTask;
+    if (params.nextAction)
+        heartbeat.nextAction = params.nextAction;
+    if (typeof params.etaMinutes === "number")
+        heartbeat.etaMinutes = params.etaMinutes;
+    if (params.blocker)
+        heartbeat.blocker = params.blocker;
+    if (params.lastRealActionAt) {
+        heartbeat.lastRealActionAt = params.lastRealActionAt.toISOString();
+    }
+    return heartbeat;
+}
+export function createReclaimSignal(dispatch, staleSeconds) {
+    const payload = dispatch.payload ?? {};
+    const expectsAck = payload.ack_required === true ||
+        payload.require_ack === true ||
+        typeof payload.handoff_message_id === "string" ||
+        typeof payload.handoff_thread_id === "string";
+    if (expectsAck) {
+        return {
+            action: "handoff_ack_missing",
+            summary: `WakePass reliability miss: no ACK arrived before reclaim for ${dispatch.targetAgentId}`,
+            payload: {
+                dispatch_id: dispatch.dispatchId,
+                source: dispatch.source,
+                target_agent_id: dispatch.targetAgentId,
+                task_ref: dispatch.taskRef ?? null,
+                stale_seconds: staleSeconds,
+                ...payload,
+            },
+        };
+    }
+    return {
+        action: "stale_dispatch_reclaimed",
+        summary: `Reclaimed stale ${dispatch.source} dispatch for ${dispatch.targetAgentId}`,
+        payload: {
+            dispatch_id: dispatch.dispatchId,
+            source: dispatch.source,
+            target_agent_id: dispatch.targetAgentId,
+            task_ref: dispatch.taskRef ?? null,
+            stale_seconds: staleSeconds,
+            ...payload,
+        },
+    };
+}
+function stableStringify(value) {
+    if (value === null || typeof value !== "object") {
+        return JSON.stringify(value);
+    }
+    if (Array.isArray(value)) {
+        return `[${value.map((item) => stableStringify(item)).join(",")}]`;
+    }
+    const record = value;
+    const keys = Object.keys(record).sort();
+    return `{${keys
+        .map((key) => `${JSON.stringify(key)}:${stableStringify(record[key])}`)
+        .join(",")}}`;
+}
+//# sourceMappingURL=reliability.js.map

package/dist/reliability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reliability.js","sourceRoot":"","sources":["../src/reliability.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAmFzC,MAAM,UAAU,gBAAgB,CAAC,KAAsB;IACrD,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC;SAC9B,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;SAC9B,MAAM,CAAC,KAAK,CAAC;SACb,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEhB,OAAO,YAAY,IAAI,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAU,EAAE,aAAa,GAAG,CAAC;IAC5D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,aAAa,IAAI,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,QAAQ,GAAG,aAAa,GAAG,IAAI,CAAC;IACtC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC,GAAG,QAAQ,CAAC;IACrE,OAAO,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,KAAsB,EACtB,GAAG,GAAG,IAAI,IAAI,EAAE;IAEhB,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;IACnE,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC;QAC1B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,sBAAsB,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;IAC7E,CAAC;IAED,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAC1D,IAAI,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACnC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,sBAAsB,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;IAC7E,CAAC;IAED,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,gBAAgB,CAAC;IACjD,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;QACjB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;IACrE,CAAC;IAED,OAAO;QACL,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,eAAe;QACvB,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;KACzC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAW/B;IACC,MAAM,SAAS,GAAmB;QAChC,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,SAAS,EAAE,CAAC,MAAM,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE;KAC1D,CAAC;IAEF,IAAI,MAAM,CAAC,UAAU;QAAE,SAAS,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IAChE,IAAI,MAAM,CAAC,WAAW;QAAE,SAAS,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IACnE,IAAI,MAAM,CAAC,UAAU;QAAE,SAAS,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IAChE,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ;QAAE,SAAS,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACpF,IAAI,MAAM,CAAC,OAAO;QAAE,SAAS,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IACvD,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC5B,SAAS,CAAC,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,CAAC,WAAW,EAAE,CAAC;IACrE,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,QAAgG,EAChG,YAAoB;IAEpB,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC;IACvC,MAAM,UAAU,GACd,OAAO,CAAC,YAAY,KAAK,IAAI;QAC7B,OAAO,CAAC,WAAW,KAAK,IAAI;QAC5B,OAAO,OAAO,CAAC,kBAAkB,KAAK,QAAQ;QAC9C,OAAO,OAAO,CAAC,iBAAiB,KAAK,QAAQ,CAAC;IAEhD,IAAI,UAAU,EAAE,CAAC;QACf,OAAO;YACL,MAAM,EAAE,qBAAqB;YAC7B,OAAO,EAAE,gEAAgE,QAAQ,CAAC,aAAa,EAAE;YACjG,OAAO,EAAE;gBACP,WAAW,EAAE,QAAQ,CAAC,UAAU;gBAChC,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,eAAe,EAAE,QAAQ,CAAC,aAAa;gBACvC,QAAQ,EAAE,QAAQ,CAAC,OAAO,IAAI,IAAI;gBAClC,aAAa,EAAE,YAAY;gBAC3B,GAAG,OAAO;aACX;SACF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,MAAM,EAAE,0BAA0B;QAClC,OAAO,EAAE,mBAAmB,QAAQ,CAAC,MAAM,iBAAiB,QAAQ,CAAC,aAAa,EAAE;QACpF,OAAO,EAAE;YACP,WAAW,EAAE,QAAQ,CAAC,UAAU;YAChC,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,eAAe,EAAE,QAAQ,CAAC,aAAa;YACvC,QAAQ,EAAE,QAAQ,CAAC,OAAO,IAAI,IAAI;YAClC,aAAa,EAAE,YAAY;YAC3B,GAAG,OAAO;SACX;KACF,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACrE,CAAC;IAED,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IACxC,OAAO,IAAI,IAAI;SACZ,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;SACtE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;AAClB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unclick/mcp-server",
-  "version": "0.3.20",
+  "version": "0.3.22",
   "mcpName": "io.github.malamutemayhem/unclick-mcp-server",
   "description": "MCP server for the UnClick tool marketplace — lets AI agents discover and use every UnClick tool",
   "type": "module",