@cubos/agent-sdk 0.0.1141710 → 0.0.1142284

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -7,13 +7,13 @@ export declare function agentsApi(t: Transport, tenantSlug: string): {
7
7
  description: string;
8
8
  display_name: string;
9
9
  feature_code_execution: boolean;
10
+ feature_filesystem: boolean;
10
11
  feature_guardrail: boolean;
11
12
  feature_structured_memory: boolean;
12
13
  feature_subagent: boolean;
13
14
  feature_task_planning: boolean;
14
15
  feature_user_notes: boolean;
15
16
  feature_web_search: boolean;
16
- feature_workspace: boolean;
17
17
  id: string;
18
18
  model: import("../generated/schema.js").components["schemas"]["AiProviderModel"];
19
19
  slug: string;
@@ -33,6 +33,7 @@ export declare function agentsApi(t: Transport, tenantSlug: string): {
33
33
  embedding_model_dimensions: number | null;
34
34
  error_fallback_message: string | null;
35
35
  feature_code_execution: boolean;
36
+ feature_filesystem: boolean;
36
37
  feature_guardrail: boolean;
37
38
  feature_proactive_memory: boolean;
38
39
  feature_structured_memory: boolean;
@@ -40,7 +41,8 @@ export declare function agentsApi(t: Transport, tenantSlug: string): {
40
41
  feature_task_planning: boolean;
41
42
  feature_user_notes: boolean;
42
43
  feature_web_search: boolean;
43
- feature_workspace: boolean;
44
+ feature_workspace?: boolean;
45
+ filesystem_ttl_turns: number | null;
44
46
  guardrail_model: null | import("../generated/schema.js").components["schemas"]["AiProviderModel"];
45
47
  guardrail_prompt: string | null;
46
48
  guardrail_reasoning_level: string | null;
@@ -59,6 +61,7 @@ export declare function agentsApi(t: Transport, tenantSlug: string): {
59
61
  updated_at: string;
60
62
  vision_model: null | import("../generated/schema.js").components["schemas"]["AiProviderModel"];
61
63
  websearch_model: null | import("../generated/schema.js").components["schemas"]["AiProviderModel"];
64
+ workspace_ttl_turns: number | null;
62
65
  }>;
63
66
  create: (input: Schemas["CreateAgentInput"]) => Promise<{
64
67
  agents_md: string;
@@ -74,6 +77,7 @@ export declare function agentsApi(t: Transport, tenantSlug: string): {
74
77
  embedding_model_dimensions: number | null;
75
78
  error_fallback_message: string | null;
76
79
  feature_code_execution: boolean;
80
+ feature_filesystem: boolean;
77
81
  feature_guardrail: boolean;
78
82
  feature_proactive_memory: boolean;
79
83
  feature_structured_memory: boolean;
@@ -81,7 +85,8 @@ export declare function agentsApi(t: Transport, tenantSlug: string): {
81
85
  feature_task_planning: boolean;
82
86
  feature_user_notes: boolean;
83
87
  feature_web_search: boolean;
84
- feature_workspace: boolean;
88
+ feature_workspace?: boolean;
89
+ filesystem_ttl_turns: number | null;
85
90
  guardrail_model: null | import("../generated/schema.js").components["schemas"]["AiProviderModel"];
86
91
  guardrail_prompt: string | null;
87
92
  guardrail_reasoning_level: string | null;
@@ -100,6 +105,7 @@ export declare function agentsApi(t: Transport, tenantSlug: string): {
100
105
  updated_at: string;
101
106
  vision_model: null | import("../generated/schema.js").components["schemas"]["AiProviderModel"];
102
107
  websearch_model: null | import("../generated/schema.js").components["schemas"]["AiProviderModel"];
108
+ workspace_ttl_turns: number | null;
103
109
  }>;
104
110
  update: (currentSlug: string, input: Schemas["UpdateAgentInput"]) => Promise<{
105
111
  agents_md: string;
@@ -115,6 +121,7 @@ export declare function agentsApi(t: Transport, tenantSlug: string): {
115
121
  embedding_model_dimensions: number | null;
116
122
  error_fallback_message: string | null;
117
123
  feature_code_execution: boolean;
124
+ feature_filesystem: boolean;
118
125
  feature_guardrail: boolean;
119
126
  feature_proactive_memory: boolean;
120
127
  feature_structured_memory: boolean;
@@ -122,7 +129,8 @@ export declare function agentsApi(t: Transport, tenantSlug: string): {
122
129
  feature_task_planning: boolean;
123
130
  feature_user_notes: boolean;
124
131
  feature_web_search: boolean;
125
- feature_workspace: boolean;
132
+ feature_workspace?: boolean;
133
+ filesystem_ttl_turns: number | null;
126
134
  guardrail_model: null | import("../generated/schema.js").components["schemas"]["AiProviderModel"];
127
135
  guardrail_prompt: string | null;
128
136
  guardrail_reasoning_level: string | null;
@@ -141,6 +149,7 @@ export declare function agentsApi(t: Transport, tenantSlug: string): {
141
149
  updated_at: string;
142
150
  vision_model: null | import("../generated/schema.js").components["schemas"]["AiProviderModel"];
143
151
  websearch_model: null | import("../generated/schema.js").components["schemas"]["AiProviderModel"];
152
+ workspace_ttl_turns: number | null;
144
153
  }>;
145
154
  delete: (slug: string) => Promise<void>;
146
155
  countTokens: (slug: string, input: Schemas["DraftAgentConfig"], signal?: AbortSignal) => Promise<{
@@ -2,7 +2,7 @@ import type { Transport } from "../http.js";
2
2
  import type { Schemas } from "../schemas.js";
3
3
  /**
4
4
  * The operator's view of conversations: the raw event log, sub-agent trees,
5
- * workspace files and cost — everything an admin console renders.
5
+ * filesystem files and cost — everything an admin console renders.
6
6
  *
7
7
  * This is deliberately *not* the curated `Conversation`/`Message` surface an
8
8
  * end-user app will get from the browser-safe client. These shapes come
@@ -385,32 +385,32 @@ export declare function conversationsAdminApi(t: Transport, tenantSlug: string):
385
385
  }[]>;
386
386
  addSkill: (id: string, skillSlug: string) => Promise<void>;
387
387
  removeSkill: (id: string, skillSlug: string) => Promise<void>;
388
- /** One directory, never recursive. `atSeq` browses the workspace as it
388
+ /** One directory, never recursive. `atSeq` browses the filesystem as it
389
389
  * stood at a given event, reaching history the agent no longer sees;
390
390
  * without it you get the live tree, which is what the agent would be shown
391
- * next turn — empty once the workspace has expired. */
392
- workspaceDir: (id: string, atSeq?: number, path?: string, signal?: AbortSignal) => Promise<{
393
- entries: import("../generated/schema.js").components["schemas"]["WorkspaceEntryDto"][];
391
+ * next turn — empty once the filesystem has expired. */
392
+ filesystemDir: (id: string, atSeq?: number, path?: string, signal?: AbortSignal) => Promise<{
393
+ entries: import("../generated/schema.js").components["schemas"]["FilesystemEntryDto"][];
394
394
  path: string;
395
395
  root_event_id: string | null;
396
396
  root_seq: number | null;
397
397
  }>;
398
398
  /** Raw `Response`: the file's bytes, with the server's own filename in
399
399
  * `Content-Disposition`. */
400
- workspaceFile: (id: string, query: {
400
+ filesystemFile: (id: string, query: {
401
401
  path: string;
402
402
  at_seq?: number;
403
403
  }) => Promise<Response>;
404
404
  /** Create or replace one file. Starts no turn — the agent is told about it
405
405
  * as part of its next request, so send a message if you want an answer. */
406
- workspaceWrite: (id: string, path: string, file: Blob, filename?: string) => Promise<{
406
+ filesystemWrite: (id: string, path: string, file: Blob, filename?: string) => Promise<{
407
407
  paths: string[];
408
408
  root_event_id: string | null;
409
409
  }>;
410
410
  /** Write several files as **one** snapshot: the agent sees the upload as a
411
411
  * single change rather than as N, and no reader ever observes half of it.
412
412
  * Positional `path` parts pair with the files by index. */
413
- workspaceWriteMany: (id: string, files: Array<{
413
+ filesystemWriteMany: (id: string, files: Array<{
414
414
  path: string;
415
415
  file: Blob;
416
416
  filename?: string;
@@ -420,11 +420,11 @@ export declare function conversationsAdminApi(t: Transport, tenantSlug: string):
420
420
  }>;
421
421
  /** Remove a file, or a directory with everything under it. History keeps
422
422
  * resolving through `atSeq`. */
423
- workspaceDelete: (id: string, path: string) => Promise<{
423
+ filesystemDelete: (id: string, path: string) => Promise<{
424
424
  paths: string[];
425
425
  root_event_id: string | null;
426
426
  }>;
427
- workspaceMove: (id: string, from: string, to: string) => Promise<{
427
+ filesystemMove: (id: string, from: string, to: string) => Promise<{
428
428
  paths: string[];
429
429
  root_event_id: string | null;
430
430
  }>;
package/dist/client.d.ts CHANGED
@@ -2,7 +2,7 @@ import { type ConversationCache } from "./cache.js";
2
2
  import { type ClientTool, type ClientToolsSession, type ServeClientToolsOptions } from "./client-tools.js";
3
3
  import { type TokenSource } from "./http.js";
4
4
  import { type FetchLike } from "./sse.js";
5
- import type { Activity, ClientToolCall, Conversation, ConversationEvent, CreateConversationOptions, EnabledComponents, EventPage, Identity, ListConversationsOptions, Message, MessagePage, Page, PlanSnapshot, Todo, ToolActivity, WorkspaceDir } from "./types.js";
5
+ import type { Activity, ClientToolCall, Conversation, ConversationEvent, CreateConversationOptions, EnabledComponents, EventPage, FilesystemDir, Identity, ListConversationsOptions, Message, MessagePage, Page, PlanSnapshot, Todo, ToolActivity } from "./types.js";
6
6
  interface CommonClientOptions {
7
7
  /** Where the Cubos Agent core is reachable, e.g. `https://agent.acme.com`.
8
8
  * Pass `""` for a same-origin deployment. */
@@ -332,12 +332,12 @@ export declare class AgentClient {
332
332
  fetchAttachment(conversationId: string, messageId: string, attachmentId?: string, signal?: AbortSignal): Promise<Blob>;
333
333
  /**
334
334
  * Lists **one** directory of the conversation's files — never recursive, so a
335
- * workspace with thousands of files is still one small response. `path`
335
+ * filesystem with thousands of files is still one small response. `path`
336
336
  * defaults to the root.
337
337
  *
338
338
  * With no `atSeq` you see exactly what the agent would be shown on its next
339
339
  * turn, which is also the tree a write starts from — including empty, once a
340
- * workspace has gone untouched for long enough to expire. `atSeq` is how you
340
+ * filesystem has gone untouched for long enough to expire. `atSeq` is how you
341
341
  * reach a past snapshot, expiry and all.
342
342
  *
343
343
  * None of the write methods below starts a turn. A file arriving is not a
@@ -349,7 +349,7 @@ export declare class AgentClient {
349
349
  path?: string;
350
350
  atSeq?: number;
351
351
  signal?: AbortSignal;
352
- }): Promise<WorkspaceDir>;
352
+ }): Promise<FilesystemDir>;
353
353
  /**
354
354
  * One file's bytes, as a `Blob`. Bytes rather than a URL for the same reason
355
355
  * as `fetchAttachment`: the token travels in a header, so an `<a href>` at