@cubos/agent-sdk 0.0.1143127 → 0.0.1143463

package/dist/admin/mcps.d.ts

@@ -23,6 +23,8 @@ export declare function mcpsApi(t: Transport, tenantSlug: string): {
         created_at: string;
         display_name: string;
         dynamic_tools: boolean;
+        graphql_eligible?: boolean;
+        graphql_enabled: boolean;
         has_headers: boolean;
         header_names: string[] | null;
         id: string;
@@ -39,6 +41,8 @@ export declare function mcpsApi(t: Transport, tenantSlug: string): {
         created_at: string;
         display_name: string;
         dynamic_tools: boolean;
+        graphql_eligible?: boolean;
+        graphql_enabled: boolean;
         has_headers: boolean;
         header_names: string[] | null;
         id: string;
@@ -55,6 +59,8 @@ export declare function mcpsApi(t: Transport, tenantSlug: string): {
         created_at: string;
         display_name: string;
         dynamic_tools: boolean;
+        graphql_eligible?: boolean;
+        graphql_enabled: boolean;
         has_headers: boolean;
         header_names: string[] | null;
         id: string;
@@ -73,6 +79,8 @@ export declare function mcpsApi(t: Transport, tenantSlug: string): {
         created_at: string;
         display_name: string;
         dynamic_tools: boolean;
+        graphql_eligible?: boolean;
+        graphql_enabled: boolean;
         has_headers: boolean;
         header_names: string[] | null;
         id: string;

package/dist/generated/schema.d.ts

@@ -5195,7 +5195,7 @@ export interface paths {
         };
         /**
          * List a filesystem directory
-         * @description Lists one directory of the conversation's virtual filesystem — a single level, never recursive. The filesystem is a content-addressed tree projected from the event log; every file mutation is a browsable snapshot. Pass `at_seq` to view the tree as it stood at a given event (the latest snapshot at or before it), which reaches history the agent can no longer see. Without `at_seq` you get the live tree — exactly what the agent would be shown on its next turn, so it comes back empty once the filesystem has expired after enough idle turns, which is also the tree a write would start from. `path` defaults to the root `/`. An empty list with null `root_event_id` means no files exist there.
+         * @description Lists one directory of the conversation's virtual filesystem — a single level, never recursive. The filesystem is a content-addressed tree projected from the event log; every file mutation is a browsable snapshot. Pass `at_seq` to view the tree as it stood at a given event (the latest snapshot at or before it), which reaches history the agent can no longer see. Without `at_seq` you get the live tree — exactly what the agent would be shown on its next turn, so it comes back empty once the filesystem has expired after enough idle turns, which is also the tree a write would start from. `path` defaults to the root `/`. An empty list with null `root_event_id` means no files exist there. 410 when the directory is in the tree but its listing was reclaimed from the blob store (bucket lifecycle) — permanent, not a retry.
          */
         get: {
             parameters: {
@@ -5248,6 +5248,12 @@ export interface paths {
                     };
                     content?: never;
                 };
+                410: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
             };
         };
         put?: never;
@@ -5267,7 +5273,7 @@ export interface paths {
         };
         /**
          * Download a filesystem file
-         * @description Streams the bytes of one file from the conversation's virtual filesystem as an attachment. Pass `at_seq` to download the file as it stood at a given event, which reaches history the agent can no longer see; without it you read the live tree, which 404s once the filesystem has expired after enough idle turns. `Content-Type` is the stored mime (inferred from the extension for entries that predate it); the `Content-Disposition` filename is the entry name.
+         * @description Streams the bytes of one file from the conversation's virtual filesystem as an attachment. Pass `at_seq` to download the file as it stood at a given event, which reaches history the agent can no longer see; without it you read the live tree, which 404s once the filesystem has expired after enough idle turns. 410 when the file is still in the tree but its bytes were reclaimed from the blob store (bucket lifecycle) — permanent, not a retry. `Content-Type` is the stored mime (inferred from the extension for entries that predate it); the `Content-Disposition` filename is the entry name.
          */
         get: {
             parameters: {
@@ -5319,6 +5325,12 @@ export interface paths {
                     };
                     content?: never;
                 };
+                410: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
             };
         };
         /**
@@ -6405,6 +6417,12 @@ export interface paths {
                     };
                     content?: never;
                 };
+                410: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
             };
         };
         put?: never;
@@ -6476,6 +6494,12 @@ export interface paths {
                     };
                     content?: never;
                 };
+                410: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
             };
         };
         /**
@@ -7984,7 +8008,9 @@ export interface paths {
                     headers: {
                         [name: string]: unknown;
                     };
-                    content?: never;
+                    content: {
+                        "application/json": components["schemas"]["McpCreateError"];
+                    };
                 };
                 401: {
                     headers: {
@@ -12236,6 +12262,12 @@ export interface components {
         CreateMcpInput: {
             display_name: string;
             dynamic_tools?: boolean;
+            /**
+             * @description Rejected with `400` unless the probe leaves the MCP `graphql_eligible`:
+             *     enabled read-only tools with output schemas, at least one of which
+             *     takes an id another one returns.
+             */
+            graphql_enabled?: boolean;
             /**
              * @description Extra HTTP headers sent on every request to this MCP server, as a JSON
              *     object **encoded in a string** — NOT raw `Name: value` header lines.
@@ -12460,6 +12492,14 @@ export interface components {
             feature_task_planning: boolean;
             feature_user_notes: boolean;
             feature_web_search: boolean;
+            /**
+             * Format: int32
+             * @description Mirrors `agents.filesystem_ttl_turns`. Only the file tools' description
+             *     depends on it — the note says whether the tree persists or after how
+             *     many idle turns it resets — so the preview counts the same sentence the
+             *     agent would be shown.
+             */
+            filesystem_ttl_turns?: number | null;
             identity_md?: string | null;
             /**
              * Format: uuid
@@ -12756,6 +12796,21 @@ export interface components {
              *     turn instead of relying on the cached `mcp_tools` snapshot.
              */
             dynamic_tools: boolean;
+            /**
+             * @description Computed, never stored: whether the enabled tools would give that
+             *     schema at least one traversal — some read-only tool's result carries
+             *     the named id another read-only tool takes. Without one a query is the
+             *     direct call with the whole schema as prompt overhead, so the flag is
+             *     refused. Recomputed on every read because a refresh can change it.
+             *     Defaulted so the CLI can decode responses from pre-field servers.
+             */
+            graphql_eligible?: boolean;
+            /**
+             * @description When true, the agent also gets a synthesized `{slug}__graphql` tool that
+             *     queries this MCP's read-only tools through one GraphQL schema derived
+             *     from their output schemas. Can only be turned on while `graphql_eligible`.
+             */
+            graphql_enabled: boolean;
             /** @description Whether the headers field has a value (plaintext is never returned). */
             has_headers: boolean;
             /**
@@ -13674,6 +13729,11 @@ export interface components {
         UpdateMcpInput: {
             display_name?: string | null;
             dynamic_tools?: boolean | null;
+            /**
+             * @description Turning this on is rejected with `400` unless the MCP currently has at
+             *     least one enabled read-only tool that advertises an output schema.
+             */
+            graphql_enabled?: boolean | null;
             /**
              * @description A JSON object encoded in a string (same wire format as on create) that
              *     PATCHes the stored header set: a string value replaces that header, a

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cubos/agent-sdk",
-  "version": "0.0.1143127",
+  "version": "0.0.1143463",
   "type": "module",
   "description": "Client for the Cubos Agent conversation API. Runs anywhere fetch does.",
   "license": "SEE LICENSE IN LICENSE",