@cubos/agent-sdk 0.0.1136563

package/dist/admin/knowledge-bases.d.ts

@@ -0,0 +1,142 @@
+import type { Transport } from "../http.js";
+import type { Schemas } from "../schemas.js";
+/**
+ * A knowledge base is uploaded documents plus a cited wiki curated from them.
+ * It attaches to a conversation or to a user (the OR of both links) — unlike
+ * MCPs and skills, there is no agent-level link.
+ */
+export declare function knowledgeBasesApi(t: Transport, tenantSlug: string): {
+    list: (signal?: AbortSignal) => Promise<{
+        created_at: string;
+        display_name: string;
+        id: string;
+        pending_count: number;
+        slug: string;
+        updated_at: string;
+    }[]>;
+    get: (slug: string, signal?: AbortSignal) => Promise<{
+        accepts_conversation_sources: boolean;
+        created_at: string;
+        curate_requested: boolean;
+        display_name: string;
+        id: string;
+        last_run: null | import("../generated/schema.js").components["schemas"]["CurationRun"];
+        nap_agent_slug: string | null;
+        nap_last_run_at: string | null;
+        oldest_pending_at: string | null;
+        pending_count: number;
+        routing_prompt: string;
+        slug: string;
+        updated_at: string;
+    }>;
+    create: (input: Schemas["CreateKnowledgeBaseInput"]) => Promise<{
+        accepts_conversation_sources: boolean;
+        created_at: string;
+        curate_requested: boolean;
+        display_name: string;
+        id: string;
+        last_run: null | import("../generated/schema.js").components["schemas"]["CurationRun"];
+        nap_agent_slug: string | null;
+        nap_last_run_at: string | null;
+        oldest_pending_at: string | null;
+        pending_count: number;
+        routing_prompt: string;
+        slug: string;
+        updated_at: string;
+    }>;
+    update: (currentSlug: string, input: Schemas["UpdateKnowledgeBaseInput"]) => Promise<{
+        accepts_conversation_sources: boolean;
+        created_at: string;
+        curate_requested: boolean;
+        display_name: string;
+        id: string;
+        last_run: null | import("../generated/schema.js").components["schemas"]["CurationRun"];
+        nap_agent_slug: string | null;
+        nap_last_run_at: string | null;
+        oldest_pending_at: string | null;
+        pending_count: number;
+        routing_prompt: string;
+        slug: string;
+        updated_at: string;
+    }>;
+    delete: (slug: string) => Promise<void>;
+    /** Wakes the "nap" agent that turns sources into wiki pages. */
+    requestCuration: (slug: string) => Promise<void>;
+    listSources: (slug: string, signal?: AbortSignal) => Promise<{
+        byte_size: number;
+        id: string;
+        integrated_at: string | null;
+        knowledge_base_id: string;
+        mime: string;
+        nap_attempts: number;
+        origin: string;
+        recorded_at: string;
+        retracted_at: string | null;
+        status: string;
+        title: string | null;
+    }[]>;
+    createTextSource: (slug: string, input: Schemas["CreateTextSourceInput"]) => Promise<{
+        byte_size: number;
+        id: string;
+        integrated_at: string | null;
+        knowledge_base_id: string;
+        mime: string;
+        nap_attempts: number;
+        origin: string;
+        recorded_at: string;
+        retracted_at: string | null;
+        status: string;
+        title: string | null;
+    }>;
+    /** Multipart upload of a file's original bytes — the only copy kept. */
+    uploadSource: (slug: string, file: File | Blob, title?: string) => Promise<{
+        byte_size: number;
+        id: string;
+        integrated_at: string | null;
+        knowledge_base_id: string;
+        mime: string;
+        nap_attempts: number;
+        origin: string;
+        recorded_at: string;
+        retracted_at: string | null;
+        status: string;
+        title: string | null;
+    }>;
+    retractSource: (slug: string, sourceId: string) => Promise<void>;
+    /** The raw `Response`, so callers decide how to save the bytes — the
+     * browser's download dance needs the DOM and doesn't belong here. */
+    downloadSource: (slug: string, sourceId: string) => Promise<Response>;
+    listPages: (slug: string, signal?: AbortSignal) => Promise<{
+        revision: number;
+        slug: string;
+        title: string;
+        updated_at: string;
+        updated_by: string;
+    }[]>;
+    getPage: (slug: string, pageSlug: string, signal?: AbortSignal) => Promise<{
+        body_md: string;
+        citations: import("../generated/schema.js").components["schemas"]["PageCitation"][];
+        content_md: string;
+        created_at: string;
+        links: string[];
+        locked_by_run: boolean;
+        revision: number;
+        slug: string;
+        title: string;
+        updated_at: string;
+        updated_by: string;
+    }>;
+    updatePage: (slug: string, pageSlug: string, input: Schemas["UpdatePageInput"]) => Promise<{
+        body_md: string;
+        citations: import("../generated/schema.js").components["schemas"]["PageCitation"][];
+        content_md: string;
+        created_at: string;
+        links: string[];
+        locked_by_run: boolean;
+        revision: number;
+        slug: string;
+        title: string;
+        updated_at: string;
+        updated_by: string;
+    }>;
+};

package/dist/admin/mcps.d.ts

@@ -0,0 +1,134 @@
+import type { Transport } from "../http.js";
+import type { Schemas } from "../schemas.js";
+/**
+ * MCP servers: the executable-tool half of the tool surface. Skills (markdown
+ * for prompt-shaping) are the other half and live in their own module — the two
+ * are complementary, not alternatives, and pairing both for one capability is
+ * normal.
+ */
+export declare function mcpsApi(t: Transport, tenantSlug: string): {
+    list: (signal?: AbortSignal) => Promise<{
+        created_at: string;
+        display_name: string;
+        id: string;
+        last_error: string | null;
+        last_refreshed_at: string | null;
+        slug: string;
+        tool_count: number;
+        transport: import("../generated/schema.js").components["schemas"]["McpTransport"];
+        updated_at: string;
+        url: string;
+    }[]>;
+    get: (slug: string, signal?: AbortSignal) => Promise<{
+        created_at: string;
+        display_name: string;
+        dynamic_tools: boolean;
+        has_headers: boolean;
+        header_names: string[] | null;
+        id: string;
+        last_error: string | null;
+        last_refreshed_at: string | null;
+        skills: import("../generated/schema.js").components["schemas"]["McpSkillSummary"][];
+        slug: string;
+        tools: import("../generated/schema.js").components["schemas"]["McpTool"][];
+        transport: import("../generated/schema.js").components["schemas"]["McpTransport"];
+        updated_at: string;
+        url: string;
+    }>;
+    create: (input: Schemas["CreateMcpInput"]) => Promise<{
+        created_at: string;
+        display_name: string;
+        dynamic_tools: boolean;
+        has_headers: boolean;
+        header_names: string[] | null;
+        id: string;
+        last_error: string | null;
+        last_refreshed_at: string | null;
+        skills: import("../generated/schema.js").components["schemas"]["McpSkillSummary"][];
+        slug: string;
+        tools: import("../generated/schema.js").components["schemas"]["McpTool"][];
+        transport: import("../generated/schema.js").components["schemas"]["McpTransport"];
+        updated_at: string;
+        url: string;
+    }>;
+    update: (currentSlug: string, input: Schemas["UpdateMcpInput"]) => Promise<{
+        created_at: string;
+        display_name: string;
+        dynamic_tools: boolean;
+        has_headers: boolean;
+        header_names: string[] | null;
+        id: string;
+        last_error: string | null;
+        last_refreshed_at: string | null;
+        skills: import("../generated/schema.js").components["schemas"]["McpSkillSummary"][];
+        slug: string;
+        tools: import("../generated/schema.js").components["schemas"]["McpTool"][];
+        transport: import("../generated/schema.js").components["schemas"]["McpTransport"];
+        updated_at: string;
+        url: string;
+    }>;
+    delete: (slug: string) => Promise<void>;
+    /** Re-handshakes the server and re-reads its tool list. */
+    refresh: (slug: string) => Promise<{
+        created_at: string;
+        display_name: string;
+        dynamic_tools: boolean;
+        has_headers: boolean;
+        header_names: string[] | null;
+        id: string;
+        last_error: string | null;
+        last_refreshed_at: string | null;
+        skills: import("../generated/schema.js").components["schemas"]["McpSkillSummary"][];
+        slug: string;
+        tools: import("../generated/schema.js").components["schemas"]["McpTool"][];
+        transport: import("../generated/schema.js").components["schemas"]["McpTransport"];
+        updated_at: string;
+        url: string;
+    }>;
+    updateTool: (slug: string, toolName: string, enabled: boolean) => Promise<{
+        description: string;
+        destructive_hint: boolean | null;
+        discovered_at: string;
+        enabled: boolean;
+        id: string;
+        idempotent_hint: boolean | null;
+        input_schema: Record<string, unknown>;
+        name: string;
+        open_world_hint: boolean | null;
+        output_schema: Record<string, unknown> | null;
+        provider_incompatibilities?: Record<string, unknown>;
+        read_only_hint: boolean | null;
+        title: string | null;
+    }>;
+    getSkill: (slug: string, skillSlug: string, signal?: AbortSignal) => Promise<{
+        created_at: string;
+        description: string;
+        display_name: string;
+        id: string;
+        skill_md: string;
+        slug: string;
+        unlocks_tool_ids: string[];
+        updated_at: string;
+    }>;
+    createSkill: (slug: string, input: Schemas["CreateMcpSkillInput"]) => Promise<{
+        created_at: string;
+        description: string;
+        display_name: string;
+        id: string;
+        skill_md: string;
+        slug: string;
+        unlocks_tool_ids: string[];
+        updated_at: string;
+    }>;
+    updateSkill: (slug: string, currentSkillSlug: string, input: Schemas["UpdateMcpSkillInput"]) => Promise<{
+        created_at: string;
+        description: string;
+        display_name: string;
+        id: string;
+        skill_md: string;
+        slug: string;
+        unlocks_tool_ids: string[];
+        updated_at: string;
+    }>;
+    deleteSkill: (slug: string, skillSlug: string) => Promise<void>;
+};

package/dist/admin/paths.d.ts

@@ -0,0 +1,9 @@
+/** Percent-encodes one path segment. Slugs are `[a-z0-9-]` and ids are UUIDs,
+ * but tenant slugs and model ids come from user input and reach these URLs. */
+export declare const enc: typeof encodeURIComponent;
+export declare const tenantPath: (tenantSlug: string) => string;
+/** Drops a slug rename that isn't one, so the server's uniqueness pre-check
+ * doesn't reject an entity for colliding with itself. */
+export declare function withoutNoopRename<T extends {
+    slug?: string | null;
+}>(input: T, currentSlug: string): T;

package/dist/admin/skills.d.ts

@@ -0,0 +1,43 @@
+import type { Transport } from "../http.js";
+import type { Schemas } from "../schemas.js";
+/** Skills are markdown plus supporting files, for prompt-shaping and knowledge.
+ * Edits replace in place — there are no version snapshots, and live
+ * conversations always see the latest. */
+export declare function skillsApi(t: Transport, tenantSlug: string): {
+    list: (signal?: AbortSignal) => Promise<{
+        created_at: string;
+        description: string;
+        display_name: string;
+        id: string;
+        slug: string;
+        updated_at: string;
+    }[]>;
+    get: (slug: string, signal?: AbortSignal) => Promise<{
+        created_at: string;
+        description: string;
+        display_name: string;
+        id: string;
+        skill_md: string;
+        slug: string;
+        updated_at: string;
+    }>;
+    create: (input: Schemas["CreateSkillInput"]) => Promise<{
+        created_at: string;
+        description: string;
+        display_name: string;
+        id: string;
+        skill_md: string;
+        slug: string;
+        updated_at: string;
+    }>;
+    update: (currentSlug: string, input: Schemas["UpdateSkillInput"]) => Promise<{
+        created_at: string;
+        description: string;
+        display_name: string;
+        id: string;
+        skill_md: string;
+        slug: string;
+        updated_at: string;
+    }>;
+    delete: (slug: string) => Promise<void>;
+};

package/dist/admin/task-templates.d.ts

@@ -0,0 +1,185 @@
+import type { Transport } from "../http.js";
+import type { Schemas } from "../schemas.js";
+/** Task templates are the user-installable triggers that spawn background runs.
+ * `agent_slug` on a template is only the executor — calling one as a tool still
+ * needs an `agent_triggers` grant. */
+export declare function taskTemplatesApi(t: Transport, tenantSlug: string): {
+    list: (signal?: AbortSignal) => Promise<{
+        agent_slug: string;
+        created_at: string;
+        description: string;
+        display_name: string;
+        id: string;
+        schedule_shape: import("../generated/schema.js").components["schemas"]["ScheduleShape"];
+        slug: string;
+        trigger_source: import("../generated/schema.js").components["schemas"]["TriggerSource"];
+        updated_at: string;
+    }[]>;
+    get: (slug: string, signal?: AbortSignal) => Promise<{
+        agent_slug: string;
+        allow_self_cancel: boolean;
+        api_enabled: boolean;
+        created_at: string;
+        description: string;
+        display_name: string;
+        id: string;
+        max_active_runs_per_user: number | null;
+        parameters: import("../generated/schema.js").components["schemas"]["TaskTemplateParam"][];
+        prompt_template: string;
+        schedule_shape: import("../generated/schema.js").components["schemas"]["ScheduleShape"];
+        secret_hint: string | null;
+        secret_rotated_at: string | null;
+        slug: string;
+        tool_choose_cron: boolean;
+        tool_choose_time: boolean;
+        tool_fixed_cron: string | null;
+        tool_fixed_delay_seconds: number | null;
+        tool_max_delay_seconds: number | null;
+        tool_max_runs: number | null;
+        tool_min_delay_seconds: number | null;
+        tool_min_gap_seconds: number | null;
+        trigger_source: import("../generated/schema.js").components["schemas"]["TriggerSource"];
+        updated_at: string;
+    }>;
+    create: (input: Schemas["CreateTaskTemplateInput"]) => Promise<{
+        agent_slug: string;
+        allow_self_cancel: boolean;
+        api_enabled: boolean;
+        created_at: string;
+        description: string;
+        display_name: string;
+        id: string;
+        max_active_runs_per_user: number | null;
+        parameters: import("../generated/schema.js").components["schemas"]["TaskTemplateParam"][];
+        prompt_template: string;
+        schedule_shape: import("../generated/schema.js").components["schemas"]["ScheduleShape"];
+        secret_hint: string | null;
+        secret_rotated_at: string | null;
+        slug: string;
+        tool_choose_cron: boolean;
+        tool_choose_time: boolean;
+        tool_fixed_cron: string | null;
+        tool_fixed_delay_seconds: number | null;
+        tool_max_delay_seconds: number | null;
+        tool_max_runs: number | null;
+        tool_min_delay_seconds: number | null;
+        tool_min_gap_seconds: number | null;
+        trigger_source: import("../generated/schema.js").components["schemas"]["TriggerSource"];
+        updated_at: string;
+    }>;
+    update: (currentSlug: string, input: Schemas["UpdateTaskTemplateInput"]) => Promise<{
+        agent_slug: string;
+        allow_self_cancel: boolean;
+        api_enabled: boolean;
+        created_at: string;
+        description: string;
+        display_name: string;
+        id: string;
+        max_active_runs_per_user: number | null;
+        parameters: import("../generated/schema.js").components["schemas"]["TaskTemplateParam"][];
+        prompt_template: string;
+        schedule_shape: import("../generated/schema.js").components["schemas"]["ScheduleShape"];
+        secret_hint: string | null;
+        secret_rotated_at: string | null;
+        slug: string;
+        tool_choose_cron: boolean;
+        tool_choose_time: boolean;
+        tool_fixed_cron: string | null;
+        tool_fixed_delay_seconds: number | null;
+        tool_max_delay_seconds: number | null;
+        tool_max_runs: number | null;
+        tool_min_delay_seconds: number | null;
+        tool_min_gap_seconds: number | null;
+        trigger_source: import("../generated/schema.js").components["schemas"]["TriggerSource"];
+        updated_at: string;
+    }>;
+    delete: (slug: string) => Promise<void>;
+    /** Mints the shared secret that lets an outside caller schedule this
+     * template without an api_key. Shown once. */
+    createSecret: (slug: string) => Promise<{
+        secret: string;
+        secret_hint: string;
+        secret_rotated_at: string;
+    }>;
+    revokeSecret: (slug: string) => Promise<void>;
+    /** The raw `Response`: this route answers with a plain-text reason for a
+     * refusal (missing param, bad cron, cadence too fast, per-user cap) that is
+     * worth surfacing verbatim rather than mapping to a generic message. */
+    trigger: (slug: string, input: Schemas["ScheduleTaskTemplateInput"]) => Promise<Response>;
+};
+export declare function scheduledRunsApi(t: Transport, tenantSlug: string): {
+    list: (query?: {
+        task_template?: string;
+        user_id?: string;
+        enabled?: boolean;
+    }, signal?: AbortSignal) => Promise<{
+        agent: null | import("../generated/schema.js").components["schemas"]["AgentRef"];
+        allow_self_cancel: boolean;
+        created_at: string;
+        created_via: string;
+        cron_expr: string | null;
+        enabled: boolean;
+        id: string;
+        last_fired_at: string | null;
+        max_runs: number | null;
+        next_fire_at: string | null;
+        run_count: number;
+        task_template: null | import("../generated/schema.js").components["schemas"]["TaskTemplateRef"];
+        timezone: string;
+        until: string | null;
+        updated_at: string;
+        user: import("../generated/schema.js").components["schemas"]["UserRef"];
+    }[]>;
+    get: (id: string, signal?: AbortSignal) => Promise<{
+        agent: null | import("../generated/schema.js").components["schemas"]["AgentRef"];
+        allow_self_cancel: boolean;
+        bound_params: Record<string, unknown>;
+        created_at: string;
+        created_via: string;
+        cron_expr: string | null;
+        enabled: boolean;
+        id: string;
+        last_fired_at: string | null;
+        max_runs: number | null;
+        next_fire_at: string | null;
+        notify_target: Record<string, unknown> | null;
+        prompt_template: string | null;
+        rendered_prompt: string | null;
+        run_count: number;
+        task_template: null | import("../generated/schema.js").components["schemas"]["TaskTemplateRef"];
+        tasks: import("../generated/schema.js").components["schemas"]["RunTask"][];
+        timezone: string;
+        until: string | null;
+        updated_at: string;
+        user: import("../generated/schema.js").components["schemas"]["UserRef"];
+    }>;
+    update: (id: string, input: Schemas["UpdateScheduledRunInput"]) => Promise<{
+        agent: null | import("../generated/schema.js").components["schemas"]["AgentRef"];
+        allow_self_cancel: boolean;
+        bound_params: Record<string, unknown>;
+        created_at: string;
+        created_via: string;
+        cron_expr: string | null;
+        enabled: boolean;
+        id: string;
+        last_fired_at: string | null;
+        max_runs: number | null;
+        next_fire_at: string | null;
+        notify_target: Record<string, unknown> | null;
+        prompt_template: string | null;
+        rendered_prompt: string | null;
+        run_count: number;
+        task_template: null | import("../generated/schema.js").components["schemas"]["TaskTemplateRef"];
+        tasks: import("../generated/schema.js").components["schemas"]["RunTask"][];
+        timezone: string;
+        until: string | null;
+        updated_at: string;
+        user: import("../generated/schema.js").components["schemas"]["UserRef"];
+    }>;
+    cancel: (id: string) => Promise<void>;
+};
+export declare function backgroundTasksApi(t: Transport, tenantSlug: string): {
+    spawn: (input: Schemas["SpawnBackgroundTaskInput"]) => Promise<{
+        conversation_id: string;
+    }>;
+};