@agent-os-sdk/client 0.9.26 → 0.9.28
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.
- package/dist/client/AgentOsClient.d.ts +141 -0
- package/dist/client/AgentOsClient.d.ts.map +1 -0
- package/{src/client/AgentOsClient.ts → dist/client/AgentOsClient.js} +61 -105
- package/dist/client/HttpRequestBuilder.d.ts +50 -0
- package/dist/client/HttpRequestBuilder.d.ts.map +1 -0
- package/{src/client/HttpRequestBuilder.ts → dist/client/HttpRequestBuilder.js} +9 -41
- package/{src/client/OperationContext.ts → dist/client/OperationContext.d.ts} +6 -9
- package/dist/client/OperationContext.d.ts.map +1 -0
- package/dist/client/OperationContext.js +13 -0
- package/dist/client/OperationContextProvider.d.ts +54 -0
- package/dist/client/OperationContextProvider.d.ts.map +1 -0
- package/{src/client/OperationContextProvider.ts → dist/client/OperationContextProvider.js} +17 -35
- package/{src/client/auth.ts → dist/client/auth.d.ts} +29 -65
- package/dist/client/auth.d.ts.map +1 -0
- package/dist/client/auth.js +38 -0
- package/dist/client/config.d.ts +49 -0
- package/dist/client/config.d.ts.map +1 -0
- package/{src/client/config.ts → dist/client/config.js} +5 -43
- package/dist/client/helpers.d.ts +63 -0
- package/dist/client/helpers.d.ts.map +1 -0
- package/{src/client/helpers.ts → dist/client/helpers.js} +9 -52
- package/dist/client/pagination.d.ts +105 -0
- package/dist/client/pagination.d.ts.map +1 -0
- package/{src/client/pagination.ts → dist/client/pagination.js} +15 -116
- package/dist/client/raw.d.ts +277 -0
- package/dist/client/raw.d.ts.map +1 -0
- package/dist/client/raw.js +337 -0
- package/dist/client/retry.d.ts +37 -0
- package/dist/client/retry.d.ts.map +1 -0
- package/{src/client/retry.ts → dist/client/retry.js} +13 -55
- package/dist/client/sanitize.d.ts +19 -0
- package/dist/client/sanitize.d.ts.map +1 -0
- package/{src/client/sanitize.ts → dist/client/sanitize.js} +4 -7
- package/dist/client/timeout.d.ts +26 -0
- package/dist/client/timeout.d.ts.map +1 -0
- package/{src/client/timeout.ts → dist/client/timeout.js} +10 -18
- package/dist/errors/factory.d.ts +22 -0
- package/dist/errors/factory.d.ts.map +1 -0
- package/{src/errors/factory.ts → dist/errors/factory.js} +18 -57
- package/dist/errors/index.d.ts +210 -0
- package/dist/errors/index.d.ts.map +1 -0
- package/{src/errors/index.ts → dist/errors/index.js} +74 -156
- package/{src/generated/client.ts → dist/generated/client.d.ts} +5 -17
- package/dist/generated/client.d.ts.map +1 -0
- package/dist/generated/client.js +15 -0
- package/{src/generated/index.ts → dist/generated/index.d.ts} +1 -1
- package/dist/generated/index.d.ts.map +1 -0
- package/dist/generated/index.js +1 -0
- package/{src/generated/openapi.ts → dist/generated/openapi.d.ts} +1 -1
- package/dist/generated/openapi.d.ts.map +1 -0
- package/dist/generated/openapi.js +5 -0
- package/dist/index.d.ts +69 -0
- package/dist/index.d.ts.map +1 -0
- package/{src/index.ts → dist/index.js} +13 -63
- package/dist/modules/a2a.d.ts +48 -0
- package/dist/modules/a2a.d.ts.map +1 -0
- package/dist/modules/a2a.js +37 -0
- package/dist/modules/agents.d.ts +346 -0
- package/dist/modules/agents.d.ts.map +1 -0
- package/dist/modules/agents.js +296 -0
- package/dist/modules/apiTokens.d.ts +62 -0
- package/dist/modules/apiTokens.d.ts.map +1 -0
- package/dist/modules/apiTokens.js +56 -0
- package/dist/modules/approvals.d.ts +77 -0
- package/dist/modules/approvals.d.ts.map +1 -0
- package/dist/modules/approvals.js +91 -0
- package/dist/modules/audit.d.ts +78 -0
- package/dist/modules/audit.d.ts.map +1 -0
- package/{src/modules/audit.ts → dist/modules/audit.js} +23 -74
- package/{src/modules/auth.ts → dist/modules/auth.d.ts} +6 -11
- package/dist/modules/auth.d.ts.map +1 -0
- package/dist/modules/auth.js +22 -0
- package/dist/modules/builder.d.ts +242 -0
- package/dist/modules/builder.d.ts.map +1 -0
- package/dist/modules/builder.js +248 -0
- package/dist/modules/catalog.d.ts +142 -0
- package/dist/modules/catalog.d.ts.map +1 -0
- package/dist/modules/catalog.js +136 -0
- package/dist/modules/chatwoot.d.ts +59 -0
- package/dist/modules/chatwoot.d.ts.map +1 -0
- package/dist/modules/chatwoot.js +200 -0
- package/dist/modules/checkpoints.d.ts +62 -0
- package/dist/modules/checkpoints.d.ts.map +1 -0
- package/dist/modules/checkpoints.js +48 -0
- package/dist/modules/contracts.d.ts +48 -0
- package/dist/modules/contracts.d.ts.map +1 -0
- package/dist/modules/contracts.js +25 -0
- package/dist/modules/credentials.d.ts +105 -0
- package/dist/modules/credentials.d.ts.map +1 -0
- package/dist/modules/credentials.js +135 -0
- package/dist/modules/crons.d.ts +73 -0
- package/dist/modules/crons.d.ts.map +1 -0
- package/dist/modules/crons.js +67 -0
- package/dist/modules/datasets.d.ts +80 -0
- package/dist/modules/datasets.d.ts.map +1 -0
- package/dist/modules/datasets.js +91 -0
- package/{src/modules/evaluation.ts → dist/modules/evaluation.d.ts} +23 -109
- package/dist/modules/evaluation.d.ts.map +1 -0
- package/dist/modules/evaluation.js +108 -0
- package/dist/modules/files.d.ts +89 -0
- package/dist/modules/files.d.ts.map +1 -0
- package/dist/modules/files.js +133 -0
- package/dist/modules/graphs.d.ts +120 -0
- package/dist/modules/graphs.d.ts.map +1 -0
- package/dist/modules/graphs.js +69 -0
- package/{src/modules/improvements.ts → dist/modules/improvements.d.ts} +8 -27
- package/dist/modules/improvements.d.ts.map +1 -0
- package/dist/modules/improvements.js +27 -0
- package/dist/modules/info.d.ts +76 -0
- package/dist/modules/info.d.ts.map +1 -0
- package/{src/modules/info.ts → dist/modules/info.js} +16 -66
- package/dist/modules/knowledge.d.ts +91 -0
- package/dist/modules/knowledge.d.ts.map +1 -0
- package/dist/modules/knowledge.js +80 -0
- package/{src/modules/me.ts → dist/modules/me.d.ts} +7 -23
- package/dist/modules/me.d.ts.map +1 -0
- package/dist/modules/me.js +28 -0
- package/dist/modules/members.d.ts +124 -0
- package/dist/modules/members.d.ts.map +1 -0
- package/dist/modules/members.js +142 -0
- package/dist/modules/memberships.d.ts +25 -0
- package/dist/modules/memberships.d.ts.map +1 -0
- package/dist/modules/memberships.js +20 -0
- package/{src/modules/metaAgent.ts → dist/modules/metaAgent.d.ts} +8 -44
- package/dist/modules/metaAgent.d.ts.map +1 -0
- package/dist/modules/metaAgent.js +32 -0
- package/dist/modules/metrics.d.ts +20 -0
- package/dist/modules/metrics.d.ts.map +1 -0
- package/{src/modules/metrics.ts → dist/modules/metrics.js} +7 -14
- package/dist/modules/observability.d.ts +19 -0
- package/dist/modules/observability.d.ts.map +1 -0
- package/dist/modules/observability.js +14 -0
- package/dist/modules/playground.d.ts +42 -0
- package/dist/modules/playground.d.ts.map +1 -0
- package/dist/modules/playground.js +48 -0
- package/dist/modules/presets.d.ts +32 -0
- package/dist/modules/presets.d.ts.map +1 -0
- package/dist/modules/presets.js +199 -0
- package/dist/modules/prompts.d.ts +87 -0
- package/dist/modules/prompts.d.ts.map +1 -0
- package/dist/modules/prompts.js +87 -0
- package/dist/modules/roles.d.ts +64 -0
- package/dist/modules/roles.d.ts.map +1 -0
- package/dist/modules/roles.js +79 -0
- package/dist/modules/runs.d.ts +451 -0
- package/dist/modules/runs.d.ts.map +1 -0
- package/{src/modules/runs.ts → dist/modules/runs.js} +96 -438
- package/dist/modules/store.d.ts +37 -0
- package/dist/modules/store.d.ts.map +1 -0
- package/dist/modules/store.js +48 -0
- package/{src/modules/templates.ts → dist/modules/templates.d.ts} +8 -32
- package/dist/modules/templates.d.ts.map +1 -0
- package/dist/modules/templates.js +26 -0
- package/dist/modules/tenants.d.ts +49 -0
- package/dist/modules/tenants.d.ts.map +1 -0
- package/dist/modules/tenants.js +56 -0
- package/dist/modules/threads.d.ts +205 -0
- package/dist/modules/threads.d.ts.map +1 -0
- package/dist/modules/threads.js +225 -0
- package/dist/modules/tools.d.ts +62 -0
- package/dist/modules/tools.d.ts.map +1 -0
- package/dist/modules/tools.js +45 -0
- package/dist/modules/traces.d.ts +89 -0
- package/dist/modules/traces.d.ts.map +1 -0
- package/dist/modules/traces.js +65 -0
- package/{src/modules/triggers.ts → dist/modules/triggers.d.ts} +24 -153
- package/dist/modules/triggers.d.ts.map +1 -0
- package/dist/modules/triggers.js +176 -0
- package/{src/modules/usage.ts → dist/modules/usage.d.ts} +14 -46
- package/dist/modules/usage.d.ts.map +1 -0
- package/dist/modules/usage.js +43 -0
- package/dist/modules/vectorStores.d.ts +100 -0
- package/dist/modules/vectorStores.d.ts.map +1 -0
- package/dist/modules/vectorStores.js +159 -0
- package/dist/modules/workspaces.d.ts +138 -0
- package/dist/modules/workspaces.d.ts.map +1 -0
- package/dist/modules/workspaces.js +121 -0
- package/dist/sse/client.d.ts +140 -0
- package/dist/sse/client.d.ts.map +1 -0
- package/{src/sse/client.ts → dist/sse/client.js} +24 -100
- package/package.json +8 -15
- package/src/client/raw.ts +0 -609
- package/src/generated/swagger.json +0 -17014
- package/src/modules/a2a.ts +0 -64
- package/src/modules/agents.ts +0 -604
- package/src/modules/apiTokens.ts +0 -101
- package/src/modules/approvals.ts +0 -151
- package/src/modules/catalog.ts +0 -241
- package/src/modules/chatwoot.ts +0 -242
- package/src/modules/checkpoints.ts +0 -87
- package/src/modules/contracts.ts +0 -80
- package/src/modules/credentials.ts +0 -216
- package/src/modules/crons.ts +0 -115
- package/src/modules/datasets.ts +0 -142
- package/src/modules/files.ts +0 -208
- package/src/modules/members.ts +0 -199
- package/src/modules/memberships.ts +0 -42
- package/src/modules/observability.ts +0 -28
- package/src/modules/playground.ts +0 -68
- package/src/modules/presets.ts +0 -246
- package/src/modules/prompts.ts +0 -147
- package/src/modules/roles.ts +0 -112
- package/src/modules/store.ts +0 -65
- package/src/modules/tenants.ts +0 -79
- package/src/modules/threads.ts +0 -343
- package/src/modules/tools.ts +0 -91
- package/src/modules/traces.ts +0 -133
- package/src/modules/vectorStores.ts +0 -257
- 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
|
-
|
|
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
|
-
|
|
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
|
|
63
|
-
return this.client.GET
|
|
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
|
-
|
|
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)
|
|
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
|
-
|
|
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)
|
|
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
|
-
|
|
20
|
-
|
|
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
|
-
|
|
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":"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"}
|