@agent-os-sdk/client 0.9.26 → 0.9.27

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.
Files changed (209) hide show
  1. package/dist/client/AgentOsClient.d.ts +141 -0
  2. package/dist/client/AgentOsClient.d.ts.map +1 -0
  3. package/{src/client/AgentOsClient.ts → dist/client/AgentOsClient.js} +61 -105
  4. package/dist/client/HttpRequestBuilder.d.ts +50 -0
  5. package/dist/client/HttpRequestBuilder.d.ts.map +1 -0
  6. package/{src/client/HttpRequestBuilder.ts → dist/client/HttpRequestBuilder.js} +9 -41
  7. package/{src/client/OperationContext.ts → dist/client/OperationContext.d.ts} +6 -9
  8. package/dist/client/OperationContext.d.ts.map +1 -0
  9. package/dist/client/OperationContext.js +13 -0
  10. package/dist/client/OperationContextProvider.d.ts +54 -0
  11. package/dist/client/OperationContextProvider.d.ts.map +1 -0
  12. package/{src/client/OperationContextProvider.ts → dist/client/OperationContextProvider.js} +17 -35
  13. package/{src/client/auth.ts → dist/client/auth.d.ts} +29 -65
  14. package/dist/client/auth.d.ts.map +1 -0
  15. package/dist/client/auth.js +38 -0
  16. package/dist/client/config.d.ts +49 -0
  17. package/dist/client/config.d.ts.map +1 -0
  18. package/{src/client/config.ts → dist/client/config.js} +5 -43
  19. package/dist/client/helpers.d.ts +63 -0
  20. package/dist/client/helpers.d.ts.map +1 -0
  21. package/{src/client/helpers.ts → dist/client/helpers.js} +9 -52
  22. package/dist/client/pagination.d.ts +105 -0
  23. package/dist/client/pagination.d.ts.map +1 -0
  24. package/{src/client/pagination.ts → dist/client/pagination.js} +15 -116
  25. package/dist/client/raw.d.ts +277 -0
  26. package/dist/client/raw.d.ts.map +1 -0
  27. package/dist/client/raw.js +337 -0
  28. package/dist/client/retry.d.ts +37 -0
  29. package/dist/client/retry.d.ts.map +1 -0
  30. package/{src/client/retry.ts → dist/client/retry.js} +13 -55
  31. package/dist/client/sanitize.d.ts +19 -0
  32. package/dist/client/sanitize.d.ts.map +1 -0
  33. package/{src/client/sanitize.ts → dist/client/sanitize.js} +4 -7
  34. package/dist/client/timeout.d.ts +26 -0
  35. package/dist/client/timeout.d.ts.map +1 -0
  36. package/{src/client/timeout.ts → dist/client/timeout.js} +10 -18
  37. package/dist/errors/factory.d.ts +22 -0
  38. package/dist/errors/factory.d.ts.map +1 -0
  39. package/{src/errors/factory.ts → dist/errors/factory.js} +18 -57
  40. package/dist/errors/index.d.ts +210 -0
  41. package/dist/errors/index.d.ts.map +1 -0
  42. package/{src/errors/index.ts → dist/errors/index.js} +74 -156
  43. package/{src/generated/client.ts → dist/generated/client.d.ts} +5 -17
  44. package/dist/generated/client.d.ts.map +1 -0
  45. package/dist/generated/client.js +15 -0
  46. package/{src/generated/index.ts → dist/generated/index.d.ts} +1 -1
  47. package/dist/generated/index.d.ts.map +1 -0
  48. package/dist/generated/index.js +1 -0
  49. package/{src/generated/openapi.ts → dist/generated/openapi.d.ts} +1 -1
  50. package/dist/generated/openapi.d.ts.map +1 -0
  51. package/dist/generated/openapi.js +5 -0
  52. package/dist/index.d.ts +69 -0
  53. package/dist/index.d.ts.map +1 -0
  54. package/{src/index.ts → dist/index.js} +13 -63
  55. package/dist/modules/a2a.d.ts +48 -0
  56. package/dist/modules/a2a.d.ts.map +1 -0
  57. package/dist/modules/a2a.js +37 -0
  58. package/dist/modules/agents.d.ts +346 -0
  59. package/dist/modules/agents.d.ts.map +1 -0
  60. package/dist/modules/agents.js +296 -0
  61. package/dist/modules/apiTokens.d.ts +62 -0
  62. package/dist/modules/apiTokens.d.ts.map +1 -0
  63. package/dist/modules/apiTokens.js +56 -0
  64. package/dist/modules/approvals.d.ts +75 -0
  65. package/dist/modules/approvals.d.ts.map +1 -0
  66. package/dist/modules/approvals.js +91 -0
  67. package/dist/modules/audit.d.ts +78 -0
  68. package/dist/modules/audit.d.ts.map +1 -0
  69. package/{src/modules/audit.ts → dist/modules/audit.js} +23 -74
  70. package/{src/modules/auth.ts → dist/modules/auth.d.ts} +6 -11
  71. package/dist/modules/auth.d.ts.map +1 -0
  72. package/dist/modules/auth.js +22 -0
  73. package/dist/modules/builder.d.ts +242 -0
  74. package/dist/modules/builder.d.ts.map +1 -0
  75. package/dist/modules/builder.js +248 -0
  76. package/dist/modules/catalog.d.ts +142 -0
  77. package/dist/modules/catalog.d.ts.map +1 -0
  78. package/dist/modules/catalog.js +136 -0
  79. package/dist/modules/chatwoot.d.ts +59 -0
  80. package/dist/modules/chatwoot.d.ts.map +1 -0
  81. package/dist/modules/chatwoot.js +200 -0
  82. package/dist/modules/checkpoints.d.ts +62 -0
  83. package/dist/modules/checkpoints.d.ts.map +1 -0
  84. package/dist/modules/checkpoints.js +48 -0
  85. package/dist/modules/contracts.d.ts +48 -0
  86. package/dist/modules/contracts.d.ts.map +1 -0
  87. package/dist/modules/contracts.js +25 -0
  88. package/dist/modules/credentials.d.ts +105 -0
  89. package/dist/modules/credentials.d.ts.map +1 -0
  90. package/dist/modules/credentials.js +135 -0
  91. package/dist/modules/crons.d.ts +73 -0
  92. package/dist/modules/crons.d.ts.map +1 -0
  93. package/dist/modules/crons.js +67 -0
  94. package/dist/modules/datasets.d.ts +80 -0
  95. package/dist/modules/datasets.d.ts.map +1 -0
  96. package/dist/modules/datasets.js +91 -0
  97. package/{src/modules/evaluation.ts → dist/modules/evaluation.d.ts} +23 -109
  98. package/dist/modules/evaluation.d.ts.map +1 -0
  99. package/dist/modules/evaluation.js +108 -0
  100. package/dist/modules/files.d.ts +89 -0
  101. package/dist/modules/files.d.ts.map +1 -0
  102. package/dist/modules/files.js +133 -0
  103. package/dist/modules/graphs.d.ts +120 -0
  104. package/dist/modules/graphs.d.ts.map +1 -0
  105. package/dist/modules/graphs.js +69 -0
  106. package/{src/modules/improvements.ts → dist/modules/improvements.d.ts} +8 -27
  107. package/dist/modules/improvements.d.ts.map +1 -0
  108. package/dist/modules/improvements.js +27 -0
  109. package/dist/modules/info.d.ts +76 -0
  110. package/dist/modules/info.d.ts.map +1 -0
  111. package/{src/modules/info.ts → dist/modules/info.js} +16 -66
  112. package/dist/modules/knowledge.d.ts +91 -0
  113. package/dist/modules/knowledge.d.ts.map +1 -0
  114. package/dist/modules/knowledge.js +80 -0
  115. package/{src/modules/me.ts → dist/modules/me.d.ts} +7 -23
  116. package/dist/modules/me.d.ts.map +1 -0
  117. package/dist/modules/me.js +28 -0
  118. package/dist/modules/members.d.ts +124 -0
  119. package/dist/modules/members.d.ts.map +1 -0
  120. package/dist/modules/members.js +142 -0
  121. package/dist/modules/memberships.d.ts +25 -0
  122. package/dist/modules/memberships.d.ts.map +1 -0
  123. package/dist/modules/memberships.js +20 -0
  124. package/{src/modules/metaAgent.ts → dist/modules/metaAgent.d.ts} +8 -44
  125. package/dist/modules/metaAgent.d.ts.map +1 -0
  126. package/dist/modules/metaAgent.js +32 -0
  127. package/dist/modules/metrics.d.ts +20 -0
  128. package/dist/modules/metrics.d.ts.map +1 -0
  129. package/{src/modules/metrics.ts → dist/modules/metrics.js} +7 -14
  130. package/dist/modules/observability.d.ts +19 -0
  131. package/dist/modules/observability.d.ts.map +1 -0
  132. package/dist/modules/observability.js +14 -0
  133. package/dist/modules/playground.d.ts +42 -0
  134. package/dist/modules/playground.d.ts.map +1 -0
  135. package/dist/modules/playground.js +48 -0
  136. package/dist/modules/presets.d.ts +32 -0
  137. package/dist/modules/presets.d.ts.map +1 -0
  138. package/dist/modules/presets.js +199 -0
  139. package/dist/modules/prompts.d.ts +87 -0
  140. package/dist/modules/prompts.d.ts.map +1 -0
  141. package/dist/modules/prompts.js +87 -0
  142. package/dist/modules/roles.d.ts +64 -0
  143. package/dist/modules/roles.d.ts.map +1 -0
  144. package/dist/modules/roles.js +79 -0
  145. package/dist/modules/runs.d.ts +451 -0
  146. package/dist/modules/runs.d.ts.map +1 -0
  147. package/{src/modules/runs.ts → dist/modules/runs.js} +96 -438
  148. package/dist/modules/store.d.ts +37 -0
  149. package/dist/modules/store.d.ts.map +1 -0
  150. package/dist/modules/store.js +48 -0
  151. package/{src/modules/templates.ts → dist/modules/templates.d.ts} +8 -32
  152. package/dist/modules/templates.d.ts.map +1 -0
  153. package/dist/modules/templates.js +26 -0
  154. package/dist/modules/tenants.d.ts +49 -0
  155. package/dist/modules/tenants.d.ts.map +1 -0
  156. package/dist/modules/tenants.js +56 -0
  157. package/dist/modules/threads.d.ts +205 -0
  158. package/dist/modules/threads.d.ts.map +1 -0
  159. package/dist/modules/threads.js +225 -0
  160. package/dist/modules/tools.d.ts +62 -0
  161. package/dist/modules/tools.d.ts.map +1 -0
  162. package/dist/modules/tools.js +45 -0
  163. package/dist/modules/traces.d.ts +89 -0
  164. package/dist/modules/traces.d.ts.map +1 -0
  165. package/dist/modules/traces.js +65 -0
  166. package/{src/modules/triggers.ts → dist/modules/triggers.d.ts} +24 -153
  167. package/dist/modules/triggers.d.ts.map +1 -0
  168. package/dist/modules/triggers.js +176 -0
  169. package/{src/modules/usage.ts → dist/modules/usage.d.ts} +14 -46
  170. package/dist/modules/usage.d.ts.map +1 -0
  171. package/dist/modules/usage.js +43 -0
  172. package/dist/modules/vectorStores.d.ts +100 -0
  173. package/dist/modules/vectorStores.d.ts.map +1 -0
  174. package/dist/modules/vectorStores.js +159 -0
  175. package/dist/modules/workspaces.d.ts +138 -0
  176. package/dist/modules/workspaces.d.ts.map +1 -0
  177. package/dist/modules/workspaces.js +121 -0
  178. package/dist/sse/client.d.ts +140 -0
  179. package/dist/sse/client.d.ts.map +1 -0
  180. package/{src/sse/client.ts → dist/sse/client.js} +24 -100
  181. package/package.json +8 -15
  182. package/src/client/raw.ts +0 -609
  183. package/src/generated/swagger.json +0 -17014
  184. package/src/modules/a2a.ts +0 -64
  185. package/src/modules/agents.ts +0 -604
  186. package/src/modules/apiTokens.ts +0 -101
  187. package/src/modules/approvals.ts +0 -151
  188. package/src/modules/catalog.ts +0 -241
  189. package/src/modules/chatwoot.ts +0 -242
  190. package/src/modules/checkpoints.ts +0 -87
  191. package/src/modules/contracts.ts +0 -80
  192. package/src/modules/credentials.ts +0 -216
  193. package/src/modules/crons.ts +0 -115
  194. package/src/modules/datasets.ts +0 -142
  195. package/src/modules/files.ts +0 -208
  196. package/src/modules/members.ts +0 -199
  197. package/src/modules/memberships.ts +0 -42
  198. package/src/modules/observability.ts +0 -28
  199. package/src/modules/playground.ts +0 -68
  200. package/src/modules/presets.ts +0 -246
  201. package/src/modules/prompts.ts +0 -147
  202. package/src/modules/roles.ts +0 -112
  203. package/src/modules/store.ts +0 -65
  204. package/src/modules/tenants.ts +0 -79
  205. package/src/modules/threads.ts +0 -343
  206. package/src/modules/tools.ts +0 -91
  207. package/src/modules/traces.ts +0 -133
  208. package/src/modules/vectorStores.ts +0 -257
  209. package/src/modules/workspaces.ts +0 -216
@@ -1,46 +1,18 @@
1
1
  /**
2
2
  * Audit Module - Fully Typed
3
3
  */
4
-
5
- import type { RawClient, APIResponse } from "../client/raw.js";
6
-
7
- export interface AuditLogEntry {
8
- id: string;
9
- tenant_id: string;
10
- workspace_id?: string;
11
- actor: string;
12
- actor_type: "user" | "system" | "api_token";
13
- action: string;
14
- resource: string;
15
- resource_id?: string;
16
- metadata?: Record<string, unknown>;
17
- ip_address?: string;
18
- user_agent?: string;
19
- created_at: string;
20
- }
21
-
22
- export interface AuditListResponse {
23
- items: AuditLogEntry[];
24
- total: number;
25
- }
26
-
27
4
  export class AuditModule {
28
- constructor(private client: RawClient, private headers: () => Record<string, string>) { }
29
-
5
+ client;
6
+ headers;
7
+ constructor(client, headers) {
8
+ this.client = client;
9
+ this.headers = headers;
10
+ }
30
11
  /**
31
12
  * List audit log entries.
32
13
  */
33
- async list(params?: {
34
- actor?: string;
35
- action?: string;
36
- resource?: string;
37
- workspace_id?: string;
38
- from?: string;
39
- to?: string;
40
- limit?: number;
41
- offset?: number;
42
- }): Promise<APIResponse<AuditListResponse>> {
43
- const queryParams: any = { ...params };
14
+ async list(params) {
15
+ const queryParams = { ...params };
44
16
  if (params?.limit !== undefined) {
45
17
  queryParams.take = params.limit;
46
18
  delete queryParams.limit;
@@ -49,34 +21,25 @@ export class AuditModule {
49
21
  queryParams.skip = params.offset;
50
22
  delete queryParams.offset;
51
23
  }
52
-
53
- return this.client.GET<AuditListResponse>("/v1/api/audit", {
24
+ return this.client.GET("/v1/api/audit", {
54
25
  params: { query: queryParams },
55
26
  headers: this.headers(),
56
27
  });
57
28
  }
58
-
59
29
  /**
60
30
  * Get a specific audit log entry.
61
31
  */
62
- async get(auditId: string): Promise<APIResponse<AuditLogEntry>> {
63
- return this.client.GET<AuditLogEntry>("/v1/api/audit/{id}", {
32
+ async get(auditId) {
33
+ return this.client.GET("/v1/api/audit/{id}", {
64
34
  params: { path: { id: auditId } },
65
35
  headers: this.headers(),
66
36
  });
67
37
  }
68
-
69
38
  /**
70
39
  * Search audit logs by action pattern.
71
40
  */
72
- async search(params?: {
73
- query?: string;
74
- from?: string;
75
- to?: string;
76
- limit?: number;
77
- offset?: number;
78
- }): Promise<APIResponse<AuditListResponse>> {
79
- const queryParams: any = { ...params };
41
+ async search(params) {
42
+ const queryParams = { ...params };
80
43
  if (params?.limit !== undefined) {
81
44
  queryParams.take = params.limit;
82
45
  delete queryParams.limit;
@@ -85,16 +48,14 @@ export class AuditModule {
85
48
  queryParams.skip = params.offset;
86
49
  delete queryParams.offset;
87
50
  }
88
-
89
- return this.client.GET<AuditListResponse>("/v1/api/audit/search", {
51
+ return this.client.GET("/v1/api/audit/search", {
90
52
  params: { query: queryParams },
91
53
  headers: this.headers(),
92
54
  });
93
55
  }
94
-
95
56
  /**
96
57
  * Iterate through all audit logs with automatic pagination.
97
- *
58
+ *
98
59
  * @example
99
60
  * ```ts
100
61
  * // Get all audit logs for a specific action
@@ -103,41 +64,29 @@ export class AuditModule {
103
64
  * }
104
65
  * ```
105
66
  */
106
- async *iterate(
107
- filters?: {
108
- actor?: string;
109
- action?: string;
110
- resource?: string;
111
- workspace_id?: string;
112
- from?: string;
113
- to?: string;
114
- },
115
- options?: { pageSize?: number; maxItems?: number; signal?: AbortSignal }
116
- ): AsyncGenerator<AuditLogEntry, void, unknown> {
67
+ async *iterate(filters, options) {
117
68
  const pageSize = options?.pageSize ?? 100;
118
69
  const maxItems = options?.maxItems ?? Infinity;
119
70
  let offset = 0;
120
71
  let yielded = 0;
121
72
  let hasMore = true;
122
-
123
73
  while (hasMore && yielded < maxItems) {
124
- if (options?.signal?.aborted) return;
125
-
74
+ if (options?.signal?.aborted)
75
+ return;
126
76
  const response = await this.list({
127
77
  ...filters,
128
78
  limit: Math.min(pageSize, maxItems - yielded),
129
79
  offset,
130
80
  });
131
-
132
- if (response.error) throw response.error;
133
- const data = response.data!;
134
-
81
+ if (response.error)
82
+ throw response.error;
83
+ const data = response.data;
135
84
  for (const entry of data.items) {
136
- if (yielded >= maxItems) return;
85
+ if (yielded >= maxItems)
86
+ return;
137
87
  yield entry;
138
88
  yielded++;
139
89
  }
140
-
141
90
  offset += data.items.length;
142
91
  hasMore = offset < data.total && data.items.length > 0;
143
92
  }
@@ -1,9 +1,7 @@
1
1
  /**
2
2
  * Auth Module - Bootstrap & Identity
3
3
  */
4
-
5
4
  import type { RawClient, APIResponse } from "../client/raw.js";
6
-
7
5
  export interface BootstrapResponse {
8
6
  status: "existing" | "created";
9
7
  tenant_id: string;
@@ -15,19 +13,16 @@ export interface BootstrapResponse {
15
13
  member_id: string;
16
14
  role_name?: string;
17
15
  }
18
-
19
- export class AuthModule {
20
- constructor(private client: RawClient, private headers: () => Record<string, string>) { }
21
-
16
+ export declare class AuthModule {
17
+ private client;
18
+ private headers;
19
+ constructor(client: RawClient, headers: () => Record<string, string>);
22
20
  /**
23
21
  * Bootstrap the authenticated user with a default tenant, workspace, and roles.
24
22
  * Idempotent: returns existing resources if already provisioned.
25
23
  *
26
24
  * @returns 200 if already bootstrapped, 201 if newly created.
27
25
  */
28
- async bootstrap(): Promise<APIResponse<BootstrapResponse>> {
29
- return this.client.POST<BootstrapResponse>("/v1/api/auth/bootstrap", {
30
- headers: this.headers(),
31
- });
32
- }
26
+ bootstrap(): Promise<APIResponse<BootstrapResponse>>;
33
27
  }
28
+ //# sourceMappingURL=auth.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/modules/auth.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/D,MAAM,WAAW,iBAAiB;IAC9B,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,UAAU;IACP,OAAO,CAAC,MAAM;IAAa,OAAO,CAAC,OAAO;gBAAlC,MAAM,EAAE,SAAS,EAAU,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAEpF;;;;;OAKG;IACG,SAAS,IAAI,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;CAK7D"}
@@ -0,0 +1,22 @@
1
+ /**
2
+ * Auth Module - Bootstrap & Identity
3
+ */
4
+ export class AuthModule {
5
+ client;
6
+ headers;
7
+ constructor(client, headers) {
8
+ this.client = client;
9
+ this.headers = headers;
10
+ }
11
+ /**
12
+ * Bootstrap the authenticated user with a default tenant, workspace, and roles.
13
+ * Idempotent: returns existing resources if already provisioned.
14
+ *
15
+ * @returns 200 if already bootstrapped, 201 if newly created.
16
+ */
17
+ async bootstrap() {
18
+ return this.client.POST("/v1/api/auth/bootstrap", {
19
+ headers: this.headers(),
20
+ });
21
+ }
22
+ }
@@ -0,0 +1,242 @@
1
+ /**
2
+ * Builder Module - Meta-Agent for Agent Building
3
+ *
4
+ * Connects to the Control Plane's builder endpoint which proxies to the
5
+ * Data Plane's meta-agent for AI-assisted agent creation.
6
+ * Uses SSE streaming for real-time responses and graph updates.
7
+ *
8
+ * Flow: Frontend → CP:5000/v1/api/builder/{agentId}/chat → DP:8001/v1/internal/builder/{agentId}/chat
9
+ *
10
+ * ALL HTTP goes through rawClient - no direct fetch calls.
11
+ *
12
+ * @example
13
+ * ```ts
14
+ * const client = new AgentOsClient({ ... })
15
+ *
16
+ * // SSE streaming chat
17
+ * for await (const event of client.builder.chat(agentId, {
18
+ * message: "Adicione um nó de pesquisa web",
19
+ * current_graph_spec: { nodes: [...], edges: [...] }
20
+ * })) {
21
+ * if (event.type === 'message') console.log(event.data.text)
22
+ * if (event.type === 'graph_update') applyAction(event.data)
23
+ * }
24
+ *
25
+ * // Sync chat (no streaming)
26
+ * const result = await client.builder.chatSync(agentId, { message: "Mude as instruções" })
27
+ * ```
28
+ */
29
+ import type { RawClient } from "../client/raw.js";
30
+ import type { SSEOptions } from "../sse/client.js";
31
+ export type CatalogVersions = {
32
+ nodes: string;
33
+ tools: string;
34
+ triggers: string;
35
+ };
36
+ export type ChatHistoryMessage = {
37
+ role: 'user' | 'assistant';
38
+ content: string;
39
+ };
40
+ /**
41
+ * Builder chat request.
42
+ *
43
+ * KERNEL-FIRST: Frontend sends INTENTION only.
44
+ * - Graph spec is loaded from artifact storage by CP
45
+ * - Catalogs are loaded from DB by CP
46
+ * - Frontend should NOT send graph_spec or catalogs
47
+ */
48
+ export type BuilderChatRequest = {
49
+ /** Chat message/intention */
50
+ message: string;
51
+ /** Thread ID for conversation continuity */
52
+ thread_id?: string;
53
+ /** Chat history for context (optional, sent from frontend) */
54
+ history?: {
55
+ role: 'user' | 'assistant';
56
+ content: string;
57
+ }[];
58
+ /** Optional ETag for concurrency control */
59
+ base_graph_etag?: string;
60
+ };
61
+ export type HintTargetModel = {
62
+ node_id?: string;
63
+ edge_id?: string;
64
+ panel?: "credentials" | "triggers" | "logs" | "validation" | "deploy" | string;
65
+ action?: "create_credential" | "save_draft" | "publish_version" | string;
66
+ };
67
+ export type HintDataModel = {
68
+ credential_slug?: string;
69
+ reason?: string;
70
+ fields?: string[];
71
+ code?: string;
72
+ path?: string;
73
+ run_id?: string;
74
+ error_code?: string;
75
+ tokens_in?: number;
76
+ tokens_out?: number;
77
+ usd_estimate?: number;
78
+ action_id?: string;
79
+ params?: Record<string, any>;
80
+ };
81
+ export type HintModel = {
82
+ id?: string;
83
+ scope: "graph" | "thread" | "run" | string;
84
+ type: "highlight_node" | "needs_credential" | "missing_config" | "error_marker" | "warning_marker" | "toast" | "run_started" | "node_running" | "node_failed" | "rate_limited" | "cost_estimate" | "action_suggested" | string;
85
+ severity: "info" | "warn" | "error" | "success";
86
+ target?: HintTargetModel;
87
+ message?: string;
88
+ ttl_ms?: number;
89
+ data?: HintDataModel;
90
+ };
91
+ export type GraphUpdateAction = {
92
+ graph_spec: Record<string, unknown>;
93
+ hints?: HintModel[];
94
+ has_errors?: boolean;
95
+ };
96
+ export type BuilderStreamEvent = {
97
+ type: "message";
98
+ data: {
99
+ text: string;
100
+ };
101
+ } | {
102
+ type: "validation";
103
+ data: {
104
+ valid: boolean;
105
+ errors: any[];
106
+ };
107
+ } | {
108
+ type: "graph_update";
109
+ data: {
110
+ graph_spec: Record<string, unknown>;
111
+ hints: HintModel[];
112
+ has_errors?: boolean;
113
+ };
114
+ } | {
115
+ type: "done";
116
+ data: {
117
+ response: string;
118
+ thread_id: string;
119
+ };
120
+ } | {
121
+ type: "error";
122
+ data: {
123
+ error: string;
124
+ };
125
+ };
126
+ export type BuilderChatResponse = {
127
+ response: string;
128
+ graph_spec?: Record<string, unknown>;
129
+ valid: boolean;
130
+ errors: any[];
131
+ thread_id: string;
132
+ hints: HintModel[];
133
+ };
134
+ /** Supported patch operation types */
135
+ export type OpType = "add_node" | "remove_node" | "update_node" | "add_edge" | "remove_edge" | "set_entrypoint" | "rename_node";
136
+ /** A single graph modification operation */
137
+ export type PatchOp = {
138
+ op: OpType;
139
+ node_id?: string;
140
+ kind?: string;
141
+ label?: string;
142
+ data?: Record<string, unknown>;
143
+ set?: Record<string, unknown>;
144
+ from?: string;
145
+ to?: string;
146
+ entrypoint?: string;
147
+ };
148
+ /** A collection of patch operations with deterministic ID */
149
+ export type GraphPatch = {
150
+ patch_id: string;
151
+ ops: PatchOp[];
152
+ description?: string;
153
+ };
154
+ /** Validation error from applying patch */
155
+ export type PatchValidationError = {
156
+ code: string;
157
+ message: string;
158
+ node_id?: string;
159
+ path?: string;
160
+ };
161
+ /** Meta-chat request */
162
+ export type MetaChatRequest = {
163
+ instruction: string;
164
+ };
165
+ /** Meta-chat stream events */
166
+ export type MetaChatStreamEvent = {
167
+ type: "assistant.delta";
168
+ data: {
169
+ text: string;
170
+ };
171
+ } | {
172
+ type: "patch.validation";
173
+ data: {
174
+ valid: boolean;
175
+ errors: PatchValidationError[];
176
+ };
177
+ } | {
178
+ type: "patch.proposed";
179
+ data: GraphPatch;
180
+ } | {
181
+ type: "final";
182
+ data: {
183
+ ok: boolean;
184
+ patch_id: string;
185
+ };
186
+ } | {
187
+ type: "error";
188
+ data: {
189
+ error: string;
190
+ };
191
+ };
192
+ /** Meta-chat sync response */
193
+ export type MetaChatResponse = {
194
+ patch: GraphPatch | null;
195
+ applied_spec: Record<string, unknown> | null;
196
+ valid: boolean;
197
+ errors: PatchValidationError[];
198
+ message: string;
199
+ };
200
+ export declare class BuilderModule {
201
+ private client;
202
+ constructor(client: RawClient);
203
+ /**
204
+ * Stream chat with meta-agent (SSE).
205
+ * Returns async generator of events.
206
+ *
207
+ * Uses rawClient.streamPost() - headers resolved asynchronously.
208
+ */
209
+ chat(agentId: string, request: BuilderChatRequest, options?: SSEOptions): AsyncGenerator<BuilderStreamEvent>;
210
+ /**
211
+ * Sync chat with meta-agent (no streaming).
212
+ *
213
+ * Uses rawClient.POST() - headers resolved asynchronously.
214
+ */
215
+ chatSync(agentId: string, request: BuilderChatRequest): Promise<BuilderChatResponse>;
216
+ /**
217
+ * Convenience method: chat and collect all events.
218
+ */
219
+ chatCollect(agentId: string, request: BuilderChatRequest): Promise<BuilderChatResponse>;
220
+ /**
221
+ * Stream meta-chat with patch-ops architecture (SSE).
222
+ * Returns GraphPatch proposals instead of full graph specs.
223
+ *
224
+ * @example
225
+ * ```ts
226
+ * for await (const event of client.builder.metaChat(agentId, {
227
+ * instruction: "Add a log node after the main agent"
228
+ * })) {
229
+ * if (event.type === 'patch.proposed') {
230
+ * const patch = event.data;
231
+ * console.log(`Proposed ${patch.ops.length} operations`);
232
+ * }
233
+ * }
234
+ * ```
235
+ */
236
+ metaChat(agentId: string, request: MetaChatRequest, options?: SSEOptions): AsyncGenerator<MetaChatStreamEvent>;
237
+ /**
238
+ * Meta-chat and collect the proposed patch.
239
+ */
240
+ metaChatCollect(agentId: string, request: MetaChatRequest): Promise<MetaChatResponse>;
241
+ }
242
+ //# sourceMappingURL=builder.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/modules/builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,kBAAkB,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,MAAM,eAAe,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC7B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC7B,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,OAAO,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5D,4CAA4C;IAC5C,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,aAAa,GAAG,UAAU,GAAG,MAAM,GAAG,YAAY,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC/E,MAAM,CAAC,EAAE,mBAAmB,GAAG,YAAY,GAAG,iBAAiB,GAAG,MAAM,CAAC;CAC5E,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAExB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAGlB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IAGd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACpB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;IAC3C,IAAI,EACF,gBAAgB,GAChB,kBAAkB,GAClB,gBAAgB,GAChB,cAAc,GACd,gBAAgB,GAChB,OAAO,GACP,aAAa,GACb,cAAc,GACd,aAAa,GACb,cAAc,GACd,eAAe,GACf,kBAAkB,GAClB,MAAM,CAAC;IACT,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IAChD,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,aAAa,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC5B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GACxB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,GAAG,EAAE,CAAA;KAAE,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,KAAK,EAAE,SAAS,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GACjH;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAEjD,MAAM,MAAM,mBAAmB,GAAG;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,GAAG,EAAE,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,SAAS,EAAE,CAAC;CACtB,CAAC;AAMF,sCAAsC;AACtC,MAAM,MAAM,MAAM,GACZ,UAAU,GACV,aAAa,GACb,aAAa,GACb,UAAU,GACV,aAAa,GACb,gBAAgB,GAChB,aAAa,CAAC;AAEpB,4CAA4C;AAC5C,MAAM,MAAM,OAAO,GAAG;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,6DAA6D;AAC7D,MAAM,MAAM,UAAU,GAAG;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,OAAO,EAAE,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,2CAA2C;AAC3C,MAAM,MAAM,oBAAoB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,wBAAwB;AACxB,MAAM,MAAM,eAAe,GAAG;IAC1B,WAAW,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,8BAA8B;AAC9B,MAAM,MAAM,mBAAmB,GACzB;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,IAAI,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,oBAAoB,EAAE,CAAA;KAAE,CAAA;CAAE,GACtF;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAEjD,8BAA8B;AAC9B,MAAM,MAAM,gBAAgB,GAAG;IAC3B,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7C,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC;AAGF,qBAAa,aAAa;IACV,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,SAAS;IAErC;;;;;OAKG;IACI,IAAI,CACP,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,kBAAkB,EAC3B,OAAO,CAAC,EAAE,UAAU,GACrB,cAAc,CAAC,kBAAkB,CAAC;IAyDrC;;;;OAIG;IACG,QAAQ,CACV,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,kBAAkB,GAC5B,OAAO,CAAC,mBAAmB,CAAC;IAgB/B;;OAEG;IACG,WAAW,CACb,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,kBAAkB,GAC5B,OAAO,CAAC,mBAAmB,CAAC;IA0C/B;;;;;;;;;;;;;;;OAeG;IACI,QAAQ,CACX,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,eAAe,EACxB,OAAO,CAAC,EAAE,UAAU,GACrB,cAAc,CAAC,mBAAmB,CAAC;IAwDtC;;OAEG;IACG,eAAe,CACjB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,eAAe,GACzB,OAAO,CAAC,gBAAgB,CAAC;CAyB/B"}