@oobe-protocol-labs/synapse-client-sdk 1.2.1 → 2.0.0

package/dist/cjs/ai/persistence/redis.js.map

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

package/dist/cjs/ai/persistence/types.d.ts

@@ -0,0 +1,267 @@
+/**
+ * @module ai/persistence/types
+ * @description Core type definitions for the Synapse AI persistence layer.
+ *
+ * Defines the universal {@link PersistenceStore} interface and all associated
+ * data records, configuration objects, and client abstractions.
+ *
+ * The generic client interfaces ({@link RedisLike}, {@link PgLike}) use
+ * dependency-injection: you create the client with your preferred library
+ * (ioredis, node-redis, pg, @vercel/postgres, @neondatabase/serverless, …)
+ * and pass the instance to the adapter constructor.
+ *
+ * @since 1.2.2
+ */
+import type { GatewaySnapshot } from '../gateway/types';
+/**
+ * @description Error thrown by any persistence store operation.
+ * @since 1.2.2
+ */
+export declare class PersistenceError extends Error {
+    /** Machine-readable error code (e.g. `'CONN_FAILED'`, `'QUERY_ERROR'`). */
+    readonly code: string;
+    /** The underlying error from the database driver, if any. */
+    readonly cause?: unknown | undefined;
+    constructor(message: string, 
+    /** Machine-readable error code (e.g. `'CONN_FAILED'`, `'QUERY_ERROR'`). */
+    code: string, 
+    /** The underlying error from the database driver, if any. */
+    cause?: unknown | undefined);
+}
+/**
+ * @description Minimal interface a Redis-compatible client must satisfy.
+ *
+ * Compatible with:
+ * - **ioredis** (`new Redis()`)
+ * - **node-redis v4** (`createClient()`)
+ * - **@upstash/redis** (REST-based)
+ * - Any client exposing the same method signatures
+ *
+ * @since 1.2.2
+ */
+export interface RedisLike {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, ...args: unknown[]): Promise<unknown>;
+    del(key: string): Promise<number>;
+    exists(key: string): Promise<number>;
+    keys(pattern: string): Promise<string[]>;
+    expire(key: string, seconds: number): Promise<number | boolean>;
+    ping(): Promise<string>;
+    quit(): Promise<unknown>;
+}
+/**
+ * @description Minimal interface a PostgreSQL-compatible client must satisfy.
+ *
+ * Compatible with:
+ * - **pg** (`new Pool()` or `new Client()`)
+ * - **@vercel/postgres** (`sql` tagged template or pool)
+ * - **@neondatabase/serverless** (`neon()`)
+ * - Any client exposing a `.query()` method
+ *
+ * @since 1.2.2
+ */
+export interface PgLike {
+    query<T extends Record<string, unknown> = Record<string, unknown>>(text: string, values?: unknown[]): Promise<{
+        rows: T[];
+        rowCount: number | null;
+    }>;
+    /** Optional — some pool implementations don't expose `end()`. */
+    end?(): Promise<void>;
+}
+/**
+ * @description JSON-safe session record for persistence.
+ * All `BigInt` fields are stored as decimal strings.
+ * @since 1.2.2
+ */
+export interface SessionRecord {
+    /** Session unique ID. */
+    id: string;
+    /** Owning agent ID. */
+    agentId: string;
+    /** Lifecycle status (`active`, `settled`, `expired`, …). */
+    status: string;
+    /** Buyer agent ID. */
+    buyer: string;
+    /** Seller agent ID. */
+    seller: string;
+    /** Pricing tier ID. */
+    tierId: string;
+    /** Payment-intent nonce. */
+    intentNonce: string;
+    /** Remaining budget (smallest token unit, as string). */
+    budgetRemaining: string;
+    /** Total budget allocated at session start (as string). */
+    budgetTotal: string;
+    /** Number of calls made. */
+    callsMade: number;
+    /** Calls remaining (−1 = unlimited). */
+    callsRemaining: number;
+    /** Per-method call counts. */
+    methodCounts: Record<string, number>;
+    /** Arbitrary session metadata. */
+    metadata: Record<string, unknown>;
+    /** Unix timestamp of creation (ms). */
+    createdAt: number;
+    /** Unix timestamp of last activity (ms). */
+    lastActivityAt: number;
+    /** Session TTL in seconds. */
+    ttl: number;
+}
+/**
+ * @description JSON-safe payment receipt for persistence.
+ * @since 1.2.2
+ */
+export interface ReceiptRecord {
+    /** Receipt unique ID. */
+    id: string;
+    /** Agent that issued the receipt. */
+    agentId: string;
+    /** Session this receipt belongs to. */
+    sessionId?: string;
+    /** Payment-intent nonce. */
+    intentNonce: string;
+    /** Amount actually charged (smallest unit, as string). */
+    amountCharged: string;
+    /** Total calls billed in this receipt. */
+    callCount: number;
+    /** On-chain tx signature, or `null` for off-chain. */
+    txSignature: string | null;
+    /** Settlement method (`onchain`, `offchain-escrow`, `streaming`). */
+    settlement: string;
+    /** Unix timestamp of settlement (ms). */
+    settledAt: number;
+}
+/**
+ * @description A single metric data point.
+ * @since 1.2.2
+ */
+export interface MetricPoint {
+    /** Unix timestamp (ms). */
+    timestamp: number;
+    /** Numeric value. */
+    value: number;
+    /** Optional labels for grouping/filtering. */
+    labels?: Record<string, string>;
+}
+/** Options for {@link PersistenceStore.set}. */
+export interface SetOptions {
+    /** TTL in seconds (0 or `undefined` = no expiry). */
+    ttl?: number;
+}
+/** Options for list queries (sessions, receipts). */
+export interface ListOptions {
+    /** Max results to return. */
+    limit?: number;
+    /** Offset for pagination. */
+    offset?: number;
+    /** Filter by status (sessions only). */
+    status?: string;
+}
+/** Options for metric queries. */
+export interface MetricQueryOpts {
+    /** Start timestamp (inclusive, ms). */
+    from?: number;
+    /** End timestamp (inclusive, ms). */
+    to?: number;
+    /** Max points to return (most recent first). */
+    limit?: number;
+}
+/** Base configuration shared by all stores. */
+export interface StoreConfig {
+    /**
+     * Key/table prefix. Default: `'synapse'`.
+     * - Redis keys: `{prefix}:agent:{id}`, `{prefix}:session:{agentId}:{id}`, …
+     * - PostgreSQL tables: `{prefix}_agents`, `{prefix}_sessions`, …
+     */
+    keyPrefix?: string;
+}
+/** Configuration for {@link RedisPersistence}. */
+export interface RedisStoreConfig extends StoreConfig {
+    /** Pre-configured Redis-compatible client instance. */
+    client: RedisLike;
+    /** Default TTL in seconds for stored values (0 = no expiry). Default: `0`. */
+    defaultTtl?: number;
+}
+/** Configuration for {@link PostgresPersistence}. */
+export interface PostgresStoreConfig extends StoreConfig {
+    /** Pre-configured PostgreSQL-compatible client/pool instance. */
+    client: PgLike;
+    /** Run schema migrations automatically on `connect()`. Default: `true`. */
+    autoMigrate?: boolean;
+}
+/** Configuration for {@link MemoryStore}. */
+export interface MemoryStoreConfig extends StoreConfig {
+    /** Maximum entries before oldest are evicted (0 = unlimited). Default: `0`. */
+    maxEntries?: number;
+}
+/**
+ * @description Universal persistence store for Synapse AI gateway data.
+ *
+ * Three built-in implementations:
+ * | Store | Best for |
+ * |---|---|
+ * | {@link MemoryStore} | Testing, dev, single-process |
+ * | {@link RedisPersistence} | Sessions, caching, pub/sub, replicas |
+ * | {@link PostgresPersistence} | Long-term analytics, receipts, audit |
+ *
+ * All implementations also satisfy the `PersistenceAdapter` interface
+ * from {@link AgentRegistry}, so they can be used as drop-in replacements:
+ *
+ * ```ts
+ * const store = new RedisPersistence({ client: redis });
+ * const registry = new AgentRegistry({ persistence: store });
+ * ```
+ *
+ * @since 1.2.2
+ */
+export interface PersistenceStore {
+    /** Store identifier (e.g. `'memory'`, `'redis'`, `'postgresql'`). */
+    readonly name: string;
+    /** Establish connection / run migrations. Idempotent. */
+    connect(): Promise<void>;
+    /** Gracefully disconnect from the backing store. */
+    disconnect(): Promise<void>;
+    /** Health check — returns `true` if the store is reachable. */
+    ping(): Promise<boolean>;
+    /** Retrieve a value by key. Returns `null` if not found or expired. */
+    get<T = unknown>(key: string): Promise<T | null>;
+    /** Store a value by key with optional TTL. */
+    set(key: string, value: unknown, opts?: SetOptions): Promise<void>;
+    /** Delete a key. Returns `true` if the key existed. */
+    del(key: string): Promise<boolean>;
+    /** Check if a key exists (and is not expired). */
+    has(key: string): Promise<boolean>;
+    /** Persist an agent's {@link GatewaySnapshot}. */
+    saveAgent(snapshot: GatewaySnapshot): Promise<void>;
+    /** Load an agent snapshot by ID. */
+    loadAgent(agentId: string): Promise<GatewaySnapshot | null>;
+    /** Delete an agent snapshot. Returns `true` if it existed. */
+    deleteAgent(agentId: string): Promise<boolean>;
+    /** List all persisted agent IDs. */
+    listAgents(): Promise<string[]>;
+    /** Persist a session record. */
+    saveSession(record: SessionRecord): Promise<void>;
+    /** Load a session by agent ID + session ID. */
+    loadSession(agentId: string, sessionId: string): Promise<SessionRecord | null>;
+    /** Delete all sessions for an agent. Returns the count deleted. */
+    deleteSessions(agentId: string): Promise<number>;
+    /** List sessions for an agent with optional filtering. */
+    listSessions(agentId: string, opts?: ListOptions): Promise<SessionRecord[]>;
+    /** Persist a payment receipt. */
+    saveReceipt(record: ReceiptRecord): Promise<void>;
+    /** List receipts for an agent with pagination. */
+    listReceipts(agentId: string, opts?: ListOptions): Promise<ReceiptRecord[]>;
+    /** Record a numeric metric data point. */
+    recordMetric(agentId: string, key: string, value: number, labels?: Record<string, string>): Promise<void>;
+    /** Query metric points with optional time range and limit. */
+    queryMetrics(agentId: string, key: string, opts?: MetricQueryOpts): Promise<MetricPoint[]>;
+    /** Alias for `saveAgent()`. Satisfies `PersistenceAdapter.save()`. */
+    save(agentId: string, snapshot: GatewaySnapshot): Promise<void>;
+    /** Alias for `loadAgent()`. Satisfies `PersistenceAdapter.load()`. */
+    load(agentId: string): Promise<GatewaySnapshot | null>;
+    /** Alias for `deleteAgent()`. Satisfies `PersistenceAdapter.delete()`. */
+    delete(agentId: string): Promise<void>;
+    /** Alias for `listAgents()`. Satisfies `PersistenceAdapter.keys()`. */
+    keys(): Promise<string[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/ai/persistence/types.d.ts.map

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

package/dist/cjs/ai/persistence/types.js

@@ -0,0 +1,40 @@
+"use strict";
+/**
+ * @module ai/persistence/types
+ * @description Core type definitions for the Synapse AI persistence layer.
+ *
+ * Defines the universal {@link PersistenceStore} interface and all associated
+ * data records, configuration objects, and client abstractions.
+ *
+ * The generic client interfaces ({@link RedisLike}, {@link PgLike}) use
+ * dependency-injection: you create the client with your preferred library
+ * (ioredis, node-redis, pg, @vercel/postgres, @neondatabase/serverless, …)
+ * and pass the instance to the adapter constructor.
+ *
+ * @since 1.2.2
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PersistenceError = void 0;
+/* ═══════════════════════════════════════════════════════════════
+ *  Error
+ * ═══════════════════════════════════════════════════════════════ */
+/**
+ * @description Error thrown by any persistence store operation.
+ * @since 1.2.2
+ */
+class PersistenceError extends Error {
+    code;
+    cause;
+    constructor(message, 
+    /** Machine-readable error code (e.g. `'CONN_FAILED'`, `'QUERY_ERROR'`). */
+    code, 
+    /** The underlying error from the database driver, if any. */
+    cause) {
+        super(message);
+        this.code = code;
+        this.cause = cause;
+        this.name = 'PersistenceError';
+    }
+}
+exports.PersistenceError = PersistenceError;
+//# sourceMappingURL=types.js.map

package/dist/cjs/ai/persistence/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/ai/persistence/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;AAIH;;qEAEqE;AAErE;;;GAGG;AACH,MAAa,gBAAiB,SAAQ,KAAK;IAIvB;IAEA;IALlB,YACE,OAAe;IACf,2EAA2E;IAC3D,IAAY;IAC5B,6DAA6D;IAC7C,KAAe;QAE/B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,SAAI,GAAJ,IAAI,CAAQ;QAEZ,UAAK,GAAL,KAAK,CAAU;QAG/B,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAXD,4CAWC"}

package/dist/cjs/ai/plugins/blinks/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @module ai/plugins/blinks
+ * @description Blinks Plugin — Solana Actions / Blinks discovery and execution.
+ *
+ * ```ts
+ * import { BlinksPlugin } from '@oobe-protocol-labs/synapse-client-sdk/ai/plugins/blinks';
+ *
+ * const kit = new SynapseAgentKit({ rpcUrl: '...' })
+ *   .use(BlinksPlugin);
+ * ```
+ *
+ * Implements the Solana Actions spec for AI agents:
+ *  - **blinks** (6)  — getAction, executeAction, confirmAction, resolveBlinkUrl,
+ *                       validateActionsJson, buildActionUrl
+ *
+ * @since 2.0.0
+ */
+import type { SynapsePlugin } from '../types';
+export { blinksMethods, allBlinksMethods } from './schemas';
+export declare const BlinksPlugin: SynapsePlugin;
+export default BlinksPlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/ai/plugins/blinks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/ai/plugins/blinks/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,aAAa,EAAiB,MAAM,UAAU,CAAC;AAI7D,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAM5D,eAAO,MAAM,YAAY,EAAE,aAkC1B,CAAC;AAwLF,eAAe,YAAY,CAAC"}

package/dist/cjs/ai/plugins/blinks/index.js

@@ -0,0 +1,202 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BlinksPlugin = exports.allBlinksMethods = exports.blinksMethods = void 0;
+const schemas_1 = require("./schemas");
+var schemas_2 = require("./schemas");
+Object.defineProperty(exports, "blinksMethods", { enumerable: true, get: function () { return schemas_2.blinksMethods; } });
+Object.defineProperty(exports, "allBlinksMethods", { enumerable: true, get: function () { return schemas_2.allBlinksMethods; } });
+/* ═══════════════════════════════════════════════════════════════
+ *  Blinks Plugin
+ * ═══════════════════════════════════════════════════════════════ */
+exports.BlinksPlugin = {
+    meta: {
+        id: 'blinks',
+        name: 'Blinks Plugin',
+        description: 'Solana Actions / Blinks — discover, inspect, execute, and share on-chain actions via URL',
+        version: '2.0.0',
+        tags: ['blinks', 'actions', 'solana-actions', 'dial.to', 'shareable'],
+        mcpResources: [
+            'solana://action/{actionUrl}',
+            'solana://blink/{blinkUrl}',
+        ],
+    },
+    protocols: [
+        {
+            id: 'blinks',
+            name: 'Solana Actions (Blinks)',
+            methods: schemas_1.blinksMethods,
+            requiresClient: false,
+        },
+    ],
+    install(context) {
+        return {
+            executor: async (method, input, _ctx) => {
+                return executeBlinks(method, input);
+            },
+        };
+    },
+};
+/* ═══════════════════════════════════════════════════════════════
+ *  Executor
+ *
+ *  All Blinks methods are HTTP-based (Actions spec uses GET/POST).
+ *  No RPC transport needed — pure HTTP client.
+ * ═══════════════════════════════════════════════════════════════ */
+const ACTIONS_HEADERS = {
+    Accept: 'application/json',
+    'Content-Type': 'application/json',
+};
+async function executeBlinks(method, input) {
+    try {
+        switch (method.name) {
+            /* ── GET Action Metadata ─────────────────────────────────── */
+            case 'getAction': {
+                const url = input.actionUrl;
+                const res = await fetch(url, {
+                    method: 'GET',
+                    headers: ACTIONS_HEADERS,
+                });
+                if (!res.ok) {
+                    return {
+                        error: `Action endpoint returned ${res.status}`,
+                        actionUrl: url,
+                    };
+                }
+                return await res.json();
+            }
+            /* ── POST Execute Action ─────────────────────────────────── */
+            case 'executeAction': {
+                let url = input.actionUrl;
+                // Substitute template parameters: {paramName} → value
+                const params = (input.params ?? {});
+                for (const [key, value] of Object.entries(params)) {
+                    url = url.replace(`{${key}}`, encodeURIComponent(value));
+                }
+                const res = await fetch(url, {
+                    method: 'POST',
+                    headers: ACTIONS_HEADERS,
+                    body: JSON.stringify({ account: input.wallet }),
+                });
+                if (!res.ok) {
+                    const text = await res.text().catch(() => '');
+                    return {
+                        error: `Action POST returned ${res.status}: ${text}`,
+                        actionUrl: url,
+                    };
+                }
+                return await res.json();
+            }
+            /* ── Confirm Action (chain callback) ─────────────────────── */
+            case 'confirmAction': {
+                // Per the Actions spec, some endpoints accept a callback PATCH/POST
+                // with the tx signature for chained actions.
+                const url = input.actionUrl;
+                const res = await fetch(url, {
+                    method: 'POST',
+                    headers: ACTIONS_HEADERS,
+                    body: JSON.stringify({ signature: input.signature }),
+                });
+                if (!res.ok) {
+                    return { error: `Confirm returned ${res.status}`, actionUrl: url };
+                }
+                const data = await res.json();
+                return {
+                    ...data,
+                    confirmed: true,
+                };
+            }
+            /* ── Resolve Blink URL → Action URL ──────────────────────── */
+            case 'resolveBlinkUrl': {
+                const blinkUrl = input.blinkUrl;
+                const url = new URL(blinkUrl);
+                // dial.to format: https://dial.to/?action=solana-action:https://...
+                const actionParam = url.searchParams.get('action');
+                if (actionParam) {
+                    const actionUrl = actionParam.replace(/^solana-action:/, '');
+                    return {
+                        actionUrl,
+                        provider: url.hostname,
+                        isInterstitial: true,
+                    };
+                }
+                // Direct action URL
+                return {
+                    actionUrl: blinkUrl,
+                    provider: url.hostname,
+                    isInterstitial: false,
+                };
+            }
+            /* ── Validate actions.json ───────────────────────────────── */
+            case 'validateActionsJson': {
+                const domain = input.domain;
+                const actionsUrl = `https://${domain.replace(/^https?:\/\//, '')}/actions.json`;
+                const res = await fetch(actionsUrl, {
+                    headers: { Accept: 'application/json' },
+                });
+                if (!res.ok) {
+                    return {
+                        valid: false,
+                        error: `actions.json not found at ${actionsUrl} (HTTP ${res.status})`,
+                    };
+                }
+                const data = (await res.json());
+                const rules = data?.rules;
+                if (!Array.isArray(rules) || rules.length === 0) {
+                    return {
+                        valid: false,
+                        error: 'actions.json found but contains no rules array',
+                    };
+                }
+                return {
+                    valid: true,
+                    rules: rules.map((r) => ({
+                        pathPattern: r.pathPattern ?? r.pathPrefix ?? '',
+                        apiPath: r.apiPath ?? '',
+                    })),
+                };
+            }
+            /* ── Build Action URL ────────────────────────────────────── */
+            case 'buildActionUrl': {
+                let actionUrl = input.baseUrl;
+                const params = (input.params ?? {});
+                // Append query params
+                const urlObj = new URL(actionUrl);
+                for (const [key, value] of Object.entries(params)) {
+                    urlObj.searchParams.set(key, value);
+                }
+                actionUrl = urlObj.toString();
+                const provider = input.blinkProvider ?? 'none';
+                let blinkUrl;
+                if (provider !== 'none') {
+                    switch (provider) {
+                        case 'dial.to':
+                            blinkUrl = `https://dial.to/?action=solana-action:${encodeURIComponent(actionUrl)}`;
+                            break;
+                        case 'phantom':
+                            blinkUrl = `https://phantom.app/ul/browse/${encodeURIComponent(actionUrl)}`;
+                            break;
+                        case 'backpack':
+                            blinkUrl = `https://backpack.app/browse/${encodeURIComponent(actionUrl)}`;
+                            break;
+                    }
+                }
+                return {
+                    actionUrl,
+                    blinkUrl,
+                    shareable: blinkUrl ?? actionUrl,
+                };
+            }
+            default:
+                return { error: `Unknown blinks method: ${method.name}` };
+        }
+    }
+    catch (err) {
+        return {
+            error: String(err),
+            method: method.name,
+            message: 'Blinks operation failed. Check URL accessibility and network connectivity.',
+        };
+    }
+}
+exports.default = exports.BlinksPlugin;
+//# sourceMappingURL=index.js.map

package/dist/cjs/ai/plugins/blinks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/ai/plugins/blinks/index.ts"],"names":[],"mappings":";;;AAmBA,uCAA0C;AAE1C,qCAA4D;AAAnD,wGAAA,aAAa,OAAA;AAAE,2GAAA,gBAAgB,OAAA;AAExC;;qEAEqE;AAExD,QAAA,YAAY,GAAkB;IACzC,IAAI,EAAE;QACJ,EAAE,EAAE,QAAQ;QACZ,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,0FAA0F;QAC5F,OAAO,EAAE,OAAO;QAChB,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,gBAAgB,EAAE,SAAS,EAAE,WAAW,CAAC;QACrE,YAAY,EAAE;YACZ,6BAA6B;YAC7B,2BAA2B;SAC5B;KACF;IAED,SAAS,EAAE;QACT;YACE,EAAE,EAAE,QAAQ;YACZ,IAAI,EAAE,yBAAyB;YAC/B,OAAO,EAAE,uBAAa;YACtB,cAAc,EAAE,KAAK;SACtB;KACF;IAED,OAAO,CAAC,OAAsB;QAC5B,OAAO;YACL,QAAQ,EAAE,KAAK,EACb,MAAsB,EACtB,KAA8B,EAC9B,IAAmB,EACnB,EAAE;gBACF,OAAO,aAAa,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YACtC,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF;;;;;qEAKqE;AAErE,MAAM,eAAe,GAAG;IACtB,MAAM,EAAE,kBAAkB;IAC1B,cAAc,EAAE,kBAAkB;CACnC,CAAC;AAEF,KAAK,UAAU,aAAa,CAC1B,MAAsB,EACtB,KAA8B;IAE9B,IAAI,CAAC;QACH,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,gEAAgE;YAChE,KAAK,WAAW,CAAC,CAAC,CAAC;gBACjB,MAAM,GAAG,GAAG,KAAK,CAAC,SAAmB,CAAC;gBACtC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;oBAC3B,MAAM,EAAE,KAAK;oBACb,OAAO,EAAE,eAAe;iBACzB,CAAC,CAAC;gBACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;oBACZ,OAAO;wBACL,KAAK,EAAE,4BAA4B,GAAG,CAAC,MAAM,EAAE;wBAC/C,SAAS,EAAE,GAAG;qBACf,CAAC;gBACJ,CAAC;gBACD,OAAO,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;YAC1B,CAAC;YAED,gEAAgE;YAChE,KAAK,eAAe,CAAC,CAAC,CAAC;gBACrB,IAAI,GAAG,GAAG,KAAK,CAAC,SAAmB,CAAC;gBAEpC,sDAAsD;gBACtD,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAA2B,CAAC;gBAC9D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;oBAClD,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,GAAG,GAAG,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC3D,CAAC;gBAED,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;oBAC3B,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE,eAAe;oBACxB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;iBAChD,CAAC,CAAC;gBACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;oBACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;oBAC9C,OAAO;wBACL,KAAK,EAAE,wBAAwB,GAAG,CAAC,MAAM,KAAK,IAAI,EAAE;wBACpD,SAAS,EAAE,GAAG;qBACf,CAAC;gBACJ,CAAC;gBACD,OAAO,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;YAC1B,CAAC;YAED,gEAAgE;YAChE,KAAK,eAAe,CAAC,CAAC,CAAC;gBACrB,oEAAoE;gBACpE,6CAA6C;gBAC7C,MAAM,GAAG,GAAG,KAAK,CAAC,SAAmB,CAAC;gBACtC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;oBAC3B,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE,eAAe;oBACxB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC;iBACrD,CAAC,CAAC;gBACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;oBACZ,OAAO,EAAE,KAAK,EAAE,oBAAoB,GAAG,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;gBACrE,CAAC;gBACD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;gBAC9B,OAAO;oBACL,GAAI,IAAY;oBAChB,SAAS,EAAE,IAAI;iBAChB,CAAC;YACJ,CAAC;YAED,gEAAgE;YAChE,KAAK,iBAAiB,CAAC,CAAC,CAAC;gBACvB,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAkB,CAAC;gBAC1C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;gBAE9B,oEAAoE;gBACpE,MAAM,WAAW,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBACnD,IAAI,WAAW,EAAE,CAAC;oBAChB,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;oBAC7D,OAAO;wBACL,SAAS;wBACT,QAAQ,EAAE,GAAG,CAAC,QAAQ;wBACtB,cAAc,EAAE,IAAI;qBACrB,CAAC;gBACJ,CAAC;gBAED,oBAAoB;gBACpB,OAAO;oBACL,SAAS,EAAE,QAAQ;oBACnB,QAAQ,EAAE,GAAG,CAAC,QAAQ;oBACtB,cAAc,EAAE,KAAK;iBACtB,CAAC;YACJ,CAAC;YAED,gEAAgE;YAChE,KAAK,qBAAqB,CAAC,CAAC,CAAC;gBAC3B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAgB,CAAC;gBACtC,MAAM,UAAU,GAAG,WAAW,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,eAAe,CAAC;gBAEhF,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,UAAU,EAAE;oBAClC,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;iBACxC,CAAC,CAAC;gBACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;oBACZ,OAAO;wBACL,KAAK,EAAE,KAAK;wBACZ,KAAK,EAAE,6BAA6B,UAAU,UAAU,GAAG,CAAC,MAAM,GAAG;qBACtE,CAAC;gBACJ,CAAC;gBACD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAQ,CAAC;gBACvC,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,CAAC;gBAC1B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAChD,OAAO;wBACL,KAAK,EAAE,KAAK;wBACZ,KAAK,EAAE,gDAAgD;qBACxD,CAAC;gBACJ,CAAC;gBACD,OAAO;oBACL,KAAK,EAAE,IAAI;oBACX,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;wBAC5B,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,UAAU,IAAI,EAAE;wBAChD,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,EAAE;qBACzB,CAAC,CAAC;iBACJ,CAAC;YACJ,CAAC;YAED,gEAAgE;YAChE,KAAK,gBAAgB,CAAC,CAAC,CAAC;gBACtB,IAAI,SAAS,GAAG,KAAK,CAAC,OAAiB,CAAC;gBACxC,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAA2B,CAAC;gBAE9D,sBAAsB;gBACtB,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;gBAClC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;oBAClD,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;gBACtC,CAAC;gBACD,SAAS,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;gBAE9B,MAAM,QAAQ,GAAI,KAAK,CAAC,aAAwB,IAAI,MAAM,CAAC;gBAC3D,IAAI,QAA4B,CAAC;gBAEjC,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;oBACxB,QAAQ,QAAQ,EAAE,CAAC;wBACjB,KAAK,SAAS;4BACZ,QAAQ,GAAG,yCAAyC,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC;4BACpF,MAAM;wBACR,KAAK,SAAS;4BACZ,QAAQ,GAAG,iCAAiC,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC;4BAC5E,MAAM;wBACR,KAAK,UAAU;4BACb,QAAQ,GAAG,+BAA+B,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC;4BAC1E,MAAM;oBACV,CAAC;gBACH,CAAC;gBAED,OAAO;oBACL,SAAS;oBACT,QAAQ;oBACR,SAAS,EAAE,QAAQ,IAAI,SAAS;iBACjC,CAAC;YACJ,CAAC;YAED;gBACE,OAAO,EAAE,KAAK,EAAE,0BAA0B,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QAC9D,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC;YAClB,MAAM,EAAE,MAAM,CAAC,IAAI;YACnB,OAAO,EAAE,4EAA4E;SACtF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,kBAAe,oBAAY,CAAC"}

package/dist/cjs/ai/plugins/blinks/schemas.d.ts

@@ -0,0 +1,4 @@
+declare const blinksMethods: import("../../tools/protocols/shared").ProtocolMethod[];
+export { blinksMethods };
+export declare const allBlinksMethods: readonly import("../../tools/protocols/shared").ProtocolMethod[];
+//# sourceMappingURL=schemas.d.ts.map

package/dist/cjs/ai/plugins/blinks/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../../../src/ai/plugins/blinks/schemas.ts"],"names":[],"mappings":"AAmBA,QAAA,MAAsC,aAAa,yDAAmC,CAAC;AA0HvF,OAAO,EAAE,aAAa,EAAE,CAAC;AAEzB,eAAO,MAAM,gBAAgB,kEAA8B,CAAC"}