@proveanything/smartlinks 1.16.7 → 1.17.4

package/dist/api/ai.d.ts

@@ -1,4 +1,4 @@
-import type { ContentPart, FunctionCall, ToolCall, ChatMessage, ToolDefinition, ResponseTool, ResponseInputItem, ResponsesRequest, ResponsesResult, ResponsesStreamEvent, ChatCompletionRequest, ChatCompletionChoice, ChatCompletionResponse, ChatCompletionChunk, AIModel, AIModelListParams, AIModelListResponse, DocumentChunk, IndexDocumentRequest, IndexDocumentResponse, ConfigureAssistantRequest, ConfigureAssistantResponse, PublicChatRequest, PublicChatResponse, Session, RateLimitStatus, SessionStatistics, VoiceSessionRequest, VoiceSessionResponse, EphemeralTokenRequest, EphemeralTokenResponse, TranscriptionResponse, TTSRequest, GeneratePodcastRequest, PodcastScript, GeneratePodcastResponse, PodcastStatus, AIGenerateContentRequest, AIGenerateImageRequest, AISearchPhotosRequest, AISearchPhotosPhoto } from "../types/ai";
+import type { ContentPart, FunctionCall, ToolCall, ChatMessage, ToolDefinition, ResponseTool, ResponseInputItem, ResponsesRequest, ResponsesResult, ResponsesStreamEvent, ChatCompletionRequest, ChatCompletionChoice, ChatCompletionResponse, ChatCompletionChunk, AIModel, AIModelListParams, AIModelListResponse, AgentRunRequest, AgentRunResult, AgentToolsQuery, AgentToolsResponse, SkillsListResponse, CatalogResponse, DocumentChunk, IndexDocumentRequest, IndexDocumentResponse, ConfigureAssistantRequest, ConfigureAssistantResponse, PublicChatRequest, PublicChatResponse, Session, RateLimitStatus, SessionStatistics, VoiceSessionRequest, VoiceSessionResponse, EphemeralTokenRequest, EphemeralTokenResponse, TranscriptionResponse, TTSRequest, GeneratePodcastRequest, PodcastScript, GeneratePodcastResponse, PodcastStatus, AIGenerateContentRequest, AIGenerateImageRequest, AISearchPhotosRequest, AISearchPhotosPhoto } from "../types/ai";
 export type { ContentPart, FunctionCall, ToolCall, ChatMessage, ToolDefinition, ResponseTool, ResponseInputItem, ResponsesRequest, ResponsesResult, ResponsesStreamEvent, ChatCompletionRequest, ChatCompletionChoice, ChatCompletionResponse, ChatCompletionChunk, AIModel, AIModelListParams, AIModelListResponse, DocumentChunk, IndexDocumentRequest, IndexDocumentResponse, ConfigureAssistantRequest, ConfigureAssistantResponse, PublicChatRequest, PublicChatResponse, Session, RateLimitStatus, SessionStatistics, VoiceSessionRequest, VoiceSessionResponse, EphemeralTokenRequest, EphemeralTokenResponse, TranscriptionResponse, TTSRequest, GeneratePodcastRequest, PodcastScript, GeneratePodcastResponse, PodcastStatus, AIGenerateContentRequest, AIGenerateImageRequest, AISearchPhotosRequest, AISearchPhotosPhoto, };
 declare namespace aiInternal {
     namespace chat {
@@ -21,6 +21,30 @@ declare namespace aiInternal {
             function create(collectionId: string, request: ChatCompletionRequest): Promise<ChatCompletionResponse | AsyncIterable<ChatCompletionChunk>>;
         }
     }
+    namespace agent {
+        /**
+         * Run the server-side AI agent loop once: assembles the tool set, runs the
+         * model, executes tool calls, and returns the final text + the tool trace.
+         * POST /admin/collection/:collectionId/ai/agent/run
+         */
+        function run(collectionId: string, body: AgentRunRequest): Promise<AgentRunResult>;
+        /**
+         * List the tools the agent can use (optionally scoped by capability / name).
+         * GET /admin/collection/:collectionId/ai/agent/tools
+         */
+        function listTools(collectionId: string, query?: AgentToolsQuery): Promise<AgentToolsResponse>;
+    }
+    namespace skills {
+        /** List the skills apps can invoke (name, description, input/output schema). */
+        function list(collectionId: string): Promise<SkillsListResponse>;
+        /**
+         * Invoke a skill by name with structured input — the app-facing verb; no
+         * prompt-shaping. POST /admin/collection/:collectionId/ai/skills/:name/run
+         */
+        function run<T = any>(collectionId: string, name: string, input?: Record<string, any>): Promise<T>;
+    }
+    /** The full self-describing catalog (tools + skills). GET /ai/catalog */
+    function catalog(collectionId: string): Promise<CatalogResponse>;
     namespace models {
         /**
          * List available AI models
@@ -181,6 +205,15 @@ export declare const ai: {
         listen: typeof aiInternal.voice.listen;
         speak: typeof aiInternal.voice.speak;
     };
+    agent: {
+        run: typeof aiInternal.agent.run;
+        listTools: typeof aiInternal.agent.listTools;
+    };
+    skills: {
+        list: typeof aiInternal.skills.list;
+        run: typeof aiInternal.skills.run;
+    };
+    catalog: typeof aiInternal.catalog;
     generateContent: typeof aiInternal.generateContent;
     generateImage: typeof aiInternal.generateImage;
     searchPhotos: typeof aiInternal.searchPhotos;

package/dist/api/ai.js

@@ -59,6 +59,61 @@ var aiInternal;
         })(completions = chat.completions || (chat.completions = {}));
     })(chat = aiInternal.chat || (aiInternal.chat = {}));
     // ============================================================================
+    // Agent API (server-side tool-registry loop)
+    // ============================================================================
+    let agent;
+    (function (agent) {
+        /**
+         * Run the server-side AI agent loop once: assembles the tool set, runs the
+         * model, executes tool calls, and returns the final text + the tool trace.
+         * POST /admin/collection/:collectionId/ai/agent/run
+         */
+        async function run(collectionId, body) {
+            const path = `/admin/collection/${encodeURIComponent(collectionId)}/ai/agent/run`;
+            return post(path, body);
+        }
+        agent.run = run;
+        /**
+         * List the tools the agent can use (optionally scoped by capability / name).
+         * GET /admin/collection/:collectionId/ai/agent/tools
+         */
+        async function listTools(collectionId, query = {}) {
+            const search = new URLSearchParams();
+            for (const [k, v] of Object.entries(query)) {
+                if (v)
+                    search.set(k, String(v));
+            }
+            const qs = search.toString();
+            const path = `/admin/collection/${encodeURIComponent(collectionId)}/ai/agent/tools${qs ? `?${qs}` : ''}`;
+            return request(path);
+        }
+        agent.listTools = listTools;
+    })(agent = aiInternal.agent || (aiInternal.agent = {}));
+    // ============================================================================
+    // Skills + Catalog (app-facing discovery)
+    // ============================================================================
+    let skills;
+    (function (skills) {
+        /** List the skills apps can invoke (name, description, input/output schema). */
+        async function list(collectionId) {
+            return request(`/admin/collection/${encodeURIComponent(collectionId)}/ai/skills`);
+        }
+        skills.list = list;
+        /**
+         * Invoke a skill by name with structured input — the app-facing verb; no
+         * prompt-shaping. POST /admin/collection/:collectionId/ai/skills/:name/run
+         */
+        async function run(collectionId, name, input = {}) {
+            return post(`/admin/collection/${encodeURIComponent(collectionId)}/ai/skills/${encodeURIComponent(name)}/run`, input);
+        }
+        skills.run = run;
+    })(skills = aiInternal.skills || (aiInternal.skills = {}));
+    /** The full self-describing catalog (tools + skills). GET /ai/catalog */
+    async function catalog(collectionId) {
+        return request(`/admin/collection/${encodeURIComponent(collectionId)}/ai/catalog`);
+    }
+    aiInternal.catalog = catalog;
+    // ============================================================================
     // Models API
     // ============================================================================
     let models;
@@ -377,6 +432,15 @@ export const ai = {
         listen: aiInternal.voice.listen,
         speak: aiInternal.voice.speak,
     },
+    agent: {
+        run: aiInternal.agent.run,
+        listTools: aiInternal.agent.listTools,
+    },
+    skills: {
+        list: aiInternal.skills.list,
+        run: aiInternal.skills.run,
+    },
+    catalog: aiInternal.catalog,
     generateContent: aiInternal.generateContent,
     generateImage: aiInternal.generateImage,
     searchPhotos: aiInternal.searchPhotos,

package/dist/api/index.d.ts

@@ -37,6 +37,9 @@ export { containers } from "./containers";
 export { lots } from "./lots";
 export { loyalty } from "./loyalty";
 export { translations } from "./translations";
+export { integrations } from "./integrations";
+export { secrets } from "./secrets";
+export { research } from "./research";
 export { config } from "./config";
 export { http } from "./http";
 export { navigation } from "./navigation";

package/dist/api/index.js

@@ -40,6 +40,9 @@ export { containers } from "./containers";
 export { lots } from "./lots";
 export { loyalty } from "./loyalty";
 export { translations } from "./translations";
+export { integrations } from "./integrations";
+export { secrets } from "./secrets";
+export { research } from "./research";
 export { config } from "./config";
 export { http } from "./http";
 export { navigation } from "./navigation";

package/dist/api/integrations.d.ts

@@ -0,0 +1,28 @@
+import type { IntegrationFlow, CreateFlowInput, UpdateFlowInput, ListFlowsQuery, FlowList, RunFlowInput, RunFlowResult, RunFlowSummary, RunFlowEnqueued } from "../types/integrations";
+export declare namespace integrations {
+    /** List flows in a collection. GET /integrations/flows */
+    function listFlows(collectionId: string, query?: ListFlowsQuery): Promise<FlowList>;
+    /** Create a flow. POST /integrations/flows */
+    function createFlow(collectionId: string, input: CreateFlowInput): Promise<IntegrationFlow>;
+    /** Get one flow. GET /integrations/flows/:id */
+    function getFlow(collectionId: string, id: string): Promise<IntegrationFlow>;
+    /** Update whitelisted fields. PUT /integrations/flows/:id */
+    function updateFlow(collectionId: string, id: string, input: UpdateFlowInput): Promise<IntegrationFlow>;
+    /** Soft-delete a flow. DELETE /integrations/flows/:id */
+    function deleteFlow(collectionId: string, id: string): Promise<{
+        deleted: boolean;
+    }>;
+    /**
+     * Run a flow now. POST /integrations/flows/:id/run
+     *   - inline (default): resolves and returns the run summary.
+     *   - options.async: enqueue on the worker, returns { enqueued: true }.
+     * Pass options.entityId to run for a single source entity.
+     */
+    function runFlow(collectionId: string, id: string, options?: RunFlowInput & {
+        async?: boolean;
+    }): Promise<RunFlowResult>;
+    /** Type guard: the run executed inline and returned a summary. */
+    function isRunSummary(r: RunFlowResult): r is RunFlowSummary;
+    /** Type guard: the run was enqueued (async). */
+    function isRunEnqueued(r: RunFlowResult): r is RunFlowEnqueued;
+}

package/dist/api/integrations.js

@@ -0,0 +1,82 @@
+// src/api/integrations.ts
+//
+// Integration flow management + execution. Flows model input/output pipelines
+// (inbound: fetch external -> write entity; outbound: read entity -> transform ->
+// send). Credentials live in the secret store (see the `secrets` namespace); a flow
+// only carries an opaque credentialRef in config.connection.auth.
+//
+// Endpoints: /admin/collection/:collectionId/integrations/flows
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+import { request, post, put, del } from "../http";
+function enc(v) { return encodeURIComponent(v); }
+function encodeQuery(params = {}) {
+    const search = new URLSearchParams();
+    for (const [key, value] of Object.entries(params)) {
+        if (value === undefined || value === null || value === "")
+            continue;
+        search.set(key, typeof value === "boolean" ? (value ? "true" : "false") : String(value));
+    }
+    const qs = search.toString();
+    return qs ? `?${qs}` : "";
+}
+export var integrations;
+(function (integrations) {
+    const base = (collectionId) => `/admin/collection/${enc(collectionId)}/integrations/flows`;
+    /** List flows in a collection. GET /integrations/flows */
+    async function listFlows(collectionId, query = {}) {
+        return request(`${base(collectionId)}${encodeQuery(query)}`);
+    }
+    integrations.listFlows = listFlows;
+    /** Create a flow. POST /integrations/flows */
+    async function createFlow(collectionId, input) {
+        return post(base(collectionId), input);
+    }
+    integrations.createFlow = createFlow;
+    /** Get one flow. GET /integrations/flows/:id */
+    async function getFlow(collectionId, id) {
+        return request(`${base(collectionId)}/${enc(id)}`);
+    }
+    integrations.getFlow = getFlow;
+    /** Update whitelisted fields. PUT /integrations/flows/:id */
+    async function updateFlow(collectionId, id, input) {
+        return put(`${base(collectionId)}/${enc(id)}`, input);
+    }
+    integrations.updateFlow = updateFlow;
+    /** Soft-delete a flow. DELETE /integrations/flows/:id */
+    async function deleteFlow(collectionId, id) {
+        return del(`${base(collectionId)}/${enc(id)}`);
+    }
+    integrations.deleteFlow = deleteFlow;
+    /**
+     * Run a flow now. POST /integrations/flows/:id/run
+     *   - inline (default): resolves and returns the run summary.
+     *   - options.async: enqueue on the worker, returns { enqueued: true }.
+     * Pass options.entityId to run for a single source entity.
+     */
+    async function runFlow(collectionId, id, options = {}) {
+        const { async: runAsync } = options, body = __rest(options, ["async"]);
+        const qs = runAsync ? "?async=true" : "";
+        return post(`${base(collectionId)}/${enc(id)}/run${qs}`, body);
+    }
+    integrations.runFlow = runFlow;
+    /** Type guard: the run executed inline and returned a summary. */
+    function isRunSummary(r) {
+        return r.status !== undefined;
+    }
+    integrations.isRunSummary = isRunSummary;
+    /** Type guard: the run was enqueued (async). */
+    function isRunEnqueued(r) {
+        return r.enqueued === true;
+    }
+    integrations.isRunEnqueued = isRunEnqueued;
+})(integrations || (integrations = {}));

package/dist/api/research.d.ts

@@ -0,0 +1,9 @@
+import type { ResearchFetchRequest, ResearchFetchResult } from "../types/research";
+export declare namespace research {
+    /**
+     * Fetch + extract a web page: clean markdown, page metadata, and any schema.org
+     * JSON-LD (filtered by `type` when given). Firecrawl-primary, cached per collection.
+     * POST /admin/collection/:collectionId/research/fetch
+     */
+    function fetch(collectionId: string, body: ResearchFetchRequest): Promise<ResearchFetchResult>;
+}

package/dist/api/research.js

@@ -0,0 +1,21 @@
+// src/api/research.ts
+//
+// Web research — the direct (deterministic, non-agent) fetch+extract capability.
+// Apps that just want a page's content/structured data call this rather than the AI
+// agent loop (e.g. the Recipes app fetching a recipe's schema.org JSON-LD from a URL).
+//
+// Endpoints: /admin/collection/:collectionId/research
+import { post } from "../http";
+export var research;
+(function (research) {
+    /**
+     * Fetch + extract a web page: clean markdown, page metadata, and any schema.org
+     * JSON-LD (filtered by `type` when given). Firecrawl-primary, cached per collection.
+     * POST /admin/collection/:collectionId/research/fetch
+     */
+    async function fetch(collectionId, body) {
+        const path = `/admin/collection/${encodeURIComponent(collectionId)}/research/fetch`;
+        return post(path, body);
+    }
+    research.fetch = fetch;
+})(research || (research = {}));

package/dist/api/secrets.d.ts

@@ -0,0 +1,15 @@
+import type { SecretMeta, SecretList, SetSecretInput, SetSecretResult, ListSecretsQuery } from "../types/integrations";
+export declare namespace secrets {
+    /** List secrets as refs + masked hints + metadata (never values). GET /secrets */
+    function list(collectionId: string, query?: ListSecretsQuery): Promise<SecretList>;
+    /** Create a secret. POST /secrets → { ref, hint }. Store the ref on a flow. */
+    function set(collectionId: string, input: SetSecretInput): Promise<SetSecretResult>;
+    /** Metadata for one secret (never the value). GET /secrets/:ref */
+    function get(collectionId: string, ref: string): Promise<SecretMeta>;
+    /** Rotate/update a secret's value (and optionally name/purpose). PUT /secrets/:ref → { ref, hint } */
+    function rotate(collectionId: string, ref: string, input: SetSecretInput): Promise<SetSecretResult>;
+    /** Soft-delete a secret. DELETE /secrets/:ref */
+    function remove(collectionId: string, ref: string): Promise<{
+        deleted: boolean;
+    }>;
+}

package/dist/api/secrets.js

@@ -0,0 +1,52 @@
+// src/api/secrets.ts
+//
+// Sealed-secret store — the credentials that back integration flows and other
+// server-side handlers. WRITE-ONLY from the client: you can set, rotate, list
+// (refs + masked hints + metadata) and delete, but a value NEVER comes back over the
+// API. It is sealed at rest and resolved server-side only, at execution time.
+//
+// Typical use: `set` a credential, take the returned `ref`, and put it on a flow's
+// config.connection.auth.credentialRef.
+//
+// Endpoints: /admin/collection/:collectionId/secrets
+import { request, post, put, del } from "../http";
+function enc(v) { return encodeURIComponent(v); }
+function encodeQuery(params = {}) {
+    const search = new URLSearchParams();
+    for (const [key, value] of Object.entries(params)) {
+        if (value === undefined || value === null || value === "")
+            continue;
+        search.set(key, String(value));
+    }
+    const qs = search.toString();
+    return qs ? `?${qs}` : "";
+}
+export var secrets;
+(function (secrets) {
+    const base = (collectionId) => `/admin/collection/${enc(collectionId)}/secrets`;
+    /** List secrets as refs + masked hints + metadata (never values). GET /secrets */
+    async function list(collectionId, query = {}) {
+        return request(`${base(collectionId)}${encodeQuery(query)}`);
+    }
+    secrets.list = list;
+    /** Create a secret. POST /secrets → { ref, hint }. Store the ref on a flow. */
+    async function set(collectionId, input) {
+        return post(base(collectionId), input);
+    }
+    secrets.set = set;
+    /** Metadata for one secret (never the value). GET /secrets/:ref */
+    async function get(collectionId, ref) {
+        return request(`${base(collectionId)}/${enc(ref)}`);
+    }
+    secrets.get = get;
+    /** Rotate/update a secret's value (and optionally name/purpose). PUT /secrets/:ref → { ref, hint } */
+    async function rotate(collectionId, ref, input) {
+        return put(`${base(collectionId)}/${enc(ref)}`, input);
+    }
+    secrets.rotate = rotate;
+    /** Soft-delete a secret. DELETE /secrets/:ref */
+    async function remove(collectionId, ref) {
+        return del(`${base(collectionId)}/${enc(ref)}`);
+    }
+    secrets.remove = remove;
+})(secrets || (secrets = {}));