@mastra/client-js 0.0.0-studio-cli-20260504022012 → 0.0.0-sugared-octave-20261030170102
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/LICENSE.md +6 -4
- package/README.md +15 -105
- package/dist/__tests__/fixtures/agent-learning-index.d.ts +11 -0
- package/dist/__tests__/fixtures/agent-learning-index.d.ts.map +1 -0
- package/dist/__tests__/fixtures/signal-management.d.ts +69 -0
- package/dist/__tests__/fixtures/signal-management.d.ts.map +1 -0
- package/dist/agent-learning.d.ts +230 -0
- package/dist/agent-learning.d.ts.map +1 -0
- package/dist/client.d.ts +455 -177
- package/dist/client.d.ts.map +1 -1
- package/dist/index.cjs +9288 -6139
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.ts +10 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +9257 -6134
- package/dist/index.js.map +1 -1
- package/dist/observability/collector.d.ts +45 -0
- package/dist/observability/collector.d.ts.map +1 -0
- package/dist/observability/index.d.ts +14 -0
- package/dist/observability/index.d.ts.map +1 -0
- package/dist/observability/types.d.ts +27 -0
- package/dist/observability/types.d.ts.map +1 -0
- package/dist/resources/a2a.d.ts +30 -3
- package/dist/resources/a2a.d.ts.map +1 -1
- package/dist/resources/agent-builder.d.ts +26 -52
- package/dist/resources/agent-builder.d.ts.map +1 -1
- package/dist/resources/agent-controller.d.ts +344 -0
- package/dist/resources/agent-controller.d.ts.map +1 -0
- package/dist/resources/agent.d.ts +215 -42
- package/dist/resources/agent.d.ts.map +1 -1
- package/dist/resources/base.d.ts.map +1 -1
- package/dist/resources/channels.d.ts +23 -31
- package/dist/resources/channels.d.ts.map +1 -1
- package/dist/resources/conversations.d.ts +6 -3
- package/dist/resources/conversations.d.ts.map +1 -1
- package/dist/resources/dynamic-workflow.d.ts +18 -0
- package/dist/resources/dynamic-workflow.d.ts.map +1 -0
- package/dist/resources/index.d.ts +2 -0
- package/dist/resources/index.d.ts.map +1 -1
- package/dist/resources/mcp-tool.d.ts +9 -6
- package/dist/resources/mcp-tool.d.ts.map +1 -1
- package/dist/resources/memory-thread.d.ts +45 -16
- package/dist/resources/memory-thread.d.ts.map +1 -1
- package/dist/resources/observability-route-types.d.ts +115 -0
- package/dist/resources/observability-route-types.d.ts.map +1 -0
- package/dist/resources/observability.d.ts +165 -3
- package/dist/resources/observability.d.ts.map +1 -1
- package/dist/resources/processor-provider.d.ts.map +1 -1
- package/dist/resources/processor.d.ts.map +1 -1
- package/dist/resources/responses.d.ts +5 -2
- package/dist/resources/responses.d.ts.map +1 -1
- package/dist/resources/run.d.ts +36 -50
- package/dist/resources/run.d.ts.map +1 -1
- package/dist/resources/stored-agent.d.ts +30 -1
- package/dist/resources/stored-agent.d.ts.map +1 -1
- package/dist/resources/stored-mcp-client.d.ts.map +1 -1
- package/dist/resources/stored-prompt-block.d.ts.map +1 -1
- package/dist/resources/stored-scorer.d.ts.map +1 -1
- package/dist/resources/stored-skill.d.ts +11 -1
- package/dist/resources/stored-skill.d.ts.map +1 -1
- package/dist/resources/tool-provider.d.ts +63 -10
- package/dist/resources/tool-provider.d.ts.map +1 -1
- package/dist/resources/tool.d.ts +6 -4
- package/dist/resources/tool.d.ts.map +1 -1
- package/dist/resources/vector.d.ts +5 -10
- package/dist/resources/vector.d.ts.map +1 -1
- package/dist/resources/workflow.d.ts +8 -10
- package/dist/resources/workflow.d.ts.map +1 -1
- package/dist/resources/workspace.d.ts +39 -1
- package/dist/resources/workspace.d.ts.map +1 -1
- package/dist/route-types.generated.d.ts +21036 -0
- package/dist/route-types.generated.d.ts.map +1 -0
- package/dist/tools.d.ts +2 -5
- package/dist/tools.d.ts.map +1 -1
- package/dist/types.d.ts +863 -1334
- package/dist/types.d.ts.map +1 -1
- package/dist/utils/ai-sdk-v4/data-stream-parts.d.ts +89 -0
- package/dist/utils/ai-sdk-v4/data-stream-parts.d.ts.map +1 -0
- package/dist/utils/ai-sdk-v4/fix-json.d.ts +2 -0
- package/dist/utils/ai-sdk-v4/fix-json.d.ts.map +1 -0
- package/dist/utils/ai-sdk-v4/index.d.ts +5 -0
- package/dist/utils/ai-sdk-v4/index.d.ts.map +1 -0
- package/dist/utils/ai-sdk-v4/parse-partial-json.d.ts +6 -0
- package/dist/utils/ai-sdk-v4/parse-partial-json.d.ts.map +1 -0
- package/dist/utils/ai-sdk-v4/process-data-stream.d.ts +53 -0
- package/dist/utils/ai-sdk-v4/process-data-stream.d.ts.map +1 -0
- package/dist/utils/ai-sdk-v4/types.d.ts +93 -0
- package/dist/utils/ai-sdk-v4/types.d.ts.map +1 -0
- package/dist/utils/client-tool-model-output.d.ts +16 -0
- package/dist/utils/client-tool-model-output.d.ts.map +1 -0
- package/dist/utils/index.d.ts +34 -0
- package/dist/utils/index.d.ts.map +1 -1
- package/dist/utils/process-a2a-stream.d.ts +2 -2
- package/dist/utils/process-a2a-stream.d.ts.map +1 -1
- package/dist/utils/process-mastra-stream.d.ts +6 -4
- package/dist/utils/process-mastra-stream.d.ts.map +1 -1
- package/dist/utils/sse-event-splitter.d.ts +3 -0
- package/dist/utils/sse-event-splitter.d.ts.map +1 -0
- package/dist/utils/stream-transforms.d.ts +9 -0
- package/dist/utils/stream-transforms.d.ts.map +1 -0
- package/dist/utils/verify-agent-card-signature.d.ts +21 -0
- package/dist/utils/verify-agent-card-signature.d.ts.map +1 -0
- package/dist/utils/zod-to-json-schema.d.ts +2 -1
- package/dist/utils/zod-to-json-schema.d.ts.map +1 -1
- package/package.json +22 -20
- package/CHANGELOG.md +0 -8359
- package/dist/_types/@ai-sdk_ui-utils/dist/index.d.ts +0 -820
- package/dist/_types/@internal_ai-sdk-v5/dist/index.d.ts +0 -9034
- package/dist/docs/SKILL.md +0 -48
- package/dist/docs/assets/SOURCE_MAP.json +0 -11
- package/dist/docs/references/docs-editor-overview.md +0 -290
- package/dist/docs/references/docs-server-auth-auth0.md +0 -260
- package/dist/docs/references/docs-server-auth-clerk.md +0 -152
- package/dist/docs/references/docs-server-auth-firebase.md +0 -292
- package/dist/docs/references/docs-server-auth-jwt.md +0 -114
- package/dist/docs/references/docs-server-auth-supabase.md +0 -137
- package/dist/docs/references/docs-server-auth-workos.md +0 -226
- package/dist/docs/references/docs-server-mastra-client.md +0 -260
- package/dist/docs/references/reference-ai-sdk-to-ai-sdk-messages.md +0 -95
- package/dist/docs/references/reference-ai-sdk-to-ai-sdk-stream.md +0 -280
- package/dist/docs/references/reference-ai-sdk-to-ai-sdk-v4-messages.md +0 -79
- package/dist/docs/references/reference-ai-sdk-to-ai-sdk-v5-messages.md +0 -76
- package/dist/docs/references/reference-client-js-agents.md +0 -608
- package/dist/docs/references/reference-client-js-conversations.md +0 -135
- package/dist/docs/references/reference-client-js-error-handling.md +0 -16
- package/dist/docs/references/reference-client-js-logs.md +0 -24
- package/dist/docs/references/reference-client-js-mastra-client.md +0 -90
- package/dist/docs/references/reference-client-js-memory.md +0 -221
- package/dist/docs/references/reference-client-js-observability.md +0 -72
- package/dist/docs/references/reference-client-js-responses.md +0 -213
- package/dist/docs/references/reference-client-js-telemetry.md +0 -20
- package/dist/docs/references/reference-client-js-tools.md +0 -44
- package/dist/docs/references/reference-client-js-vectors.md +0 -79
- package/dist/docs/references/reference-client-js-workflows.md +0 -260
package/LICENSE.md
CHANGED
|
@@ -1,10 +1,12 @@
|
|
|
1
1
|
Portions of this software are licensed as follows:
|
|
2
2
|
|
|
3
|
-
- All content that resides under any directory named
|
|
3
|
+
- All content that resides under any directory named `ee/` within this
|
|
4
4
|
repository, including but not limited to:
|
|
5
|
-
-
|
|
6
|
-
-
|
|
7
|
-
|
|
5
|
+
- `@mastra/core/auth/ee`
|
|
6
|
+
- `@mastra/core/agent-builder/ee`
|
|
7
|
+
- `@mastra/editor/ee`
|
|
8
|
+
|
|
9
|
+
is licensed under the license defined in [`ee/LICENSE`](https://github.com/mastra-ai/mastra/blob/main/ee/LICENSE).
|
|
8
10
|
|
|
9
11
|
- All third-party components incorporated into the Mastra Software are
|
|
10
12
|
licensed under the original license provided by the owner of the
|
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
#
|
|
1
|
+
# @mastra/client-js
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
`@mastra/client-js` is the typed JavaScript client for a running Mastra server. Use it from browser or server applications to call agents, workflows, tools, memory, and vector APIs without constructing HTTP requests directly.
|
|
4
4
|
|
|
5
5
|
## Installation
|
|
6
6
|
|
|
@@ -8,118 +8,28 @@ JavaScript/TypeScript client library for the [Mastra AI](https://mastra.ai) fram
|
|
|
8
8
|
npm install @mastra/client-js
|
|
9
9
|
```
|
|
10
10
|
|
|
11
|
-
##
|
|
11
|
+
## Usage
|
|
12
|
+
|
|
13
|
+
Point the client at a running Mastra server.
|
|
12
14
|
|
|
13
15
|
```typescript
|
|
14
16
|
import { MastraClient } from '@mastra/client-js';
|
|
15
17
|
|
|
16
|
-
|
|
17
|
-
const
|
|
18
|
-
baseUrl: 'http://localhost:4111', // Your Mastra API endpoint
|
|
19
|
-
});
|
|
20
|
-
|
|
21
|
-
// Example: Working with an Agent
|
|
22
|
-
async function main() {
|
|
23
|
-
// Get an agent instance
|
|
24
|
-
const agent = client.getAgent('your-agent-id');
|
|
25
|
-
|
|
26
|
-
// Generate a response
|
|
27
|
-
const response = await agent.generate([{ role: 'user', content: "What's the weather like today?" }]);
|
|
28
|
-
|
|
29
|
-
console.log(response);
|
|
30
|
-
}
|
|
31
|
-
```
|
|
32
|
-
|
|
33
|
-
## Client Configuration
|
|
18
|
+
const client = new MastraClient({ baseUrl: 'http://localhost:4111' });
|
|
19
|
+
const agent = client.getAgent('assistant');
|
|
34
20
|
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
```typescript
|
|
38
|
-
const client = new MastraClient({
|
|
39
|
-
baseUrl: string; // Base URL for the Mastra API
|
|
40
|
-
retries?: number; // Number of retry attempts (default: 3)
|
|
41
|
-
backoffMs?: number; // Initial backoff time in ms (default: 300)
|
|
42
|
-
maxBackoffMs?: number; // Maximum backoff time in ms (default: 5000)
|
|
43
|
-
headers?: Record<string, string>; // Custom headers
|
|
44
|
-
});
|
|
21
|
+
const response = await agent.generate('Summarize my open support tickets.');
|
|
22
|
+
console.log(response.text);
|
|
45
23
|
```
|
|
46
24
|
|
|
47
|
-
##
|
|
48
|
-
|
|
49
|
-
### Agents
|
|
50
|
-
|
|
51
|
-
- `listAgents()`: Get all available agents
|
|
52
|
-
- `getAgent(agentId)`: Get a specific agent instance
|
|
53
|
-
- `agent.details()`: Get agent details
|
|
54
|
-
- `agent.generate(params)`: Generate a response
|
|
55
|
-
- `agent.generateLegacy(params)`: Legacy API for generating a response (V1 models)
|
|
56
|
-
- `agent.stream(params)`: Stream a response
|
|
57
|
-
- `agent.streamLegacy(params)`: Legacy API for streaming a response (V1 models)
|
|
58
|
-
- `agent.getTool(toolId)`: Get agent tool details
|
|
59
|
-
- `agent.evals()`: Get agent evaluations
|
|
60
|
-
- `agent.liveEvals()`: Get live evaluations
|
|
61
|
-
|
|
62
|
-
### Memory
|
|
63
|
-
|
|
64
|
-
- `listMemoryThreads(params)`: Get memory threads
|
|
65
|
-
- `createMemoryThread(params)`: Create a new memory thread
|
|
66
|
-
- `getMemoryThread({ threadId, agentId })`: Get a memory thread instance
|
|
67
|
-
- `saveMessageToMemory(params)`: Save messages to memory
|
|
68
|
-
- `getMemoryStatus()`: Get memory system status
|
|
69
|
-
- `getWorkingMemory({ agentId, threadId, resourceId? })`: Get working memory for a thread
|
|
70
|
-
- `updateWorkingMemory({ agentId, threadId, workingMemory, resourceId? })`: Update working memory for a thread
|
|
71
|
-
|
|
72
|
-
### Tools
|
|
73
|
-
|
|
74
|
-
- `listTools()`: Get all available tools
|
|
75
|
-
- `getTool(toolId)`: Get a tool instance
|
|
76
|
-
- `tool.details()`: Get tool details
|
|
77
|
-
- `tool.execute(params)`: Execute the tool
|
|
78
|
-
|
|
79
|
-
### Workflows
|
|
80
|
-
|
|
81
|
-
- `listWorkflows()`: Get all workflows
|
|
82
|
-
- `getWorkflow(workflowId)`: Get a workflow instance
|
|
83
|
-
- `workflow.details()`: Get workflow details
|
|
84
|
-
- `workflow.createRun()`: Create workflow run
|
|
85
|
-
- `workflow.startAsync(params)`: Execute the workflow and wait for execution results
|
|
86
|
-
- `workflow.resumeAsync(params)`: Resume suspended workflow step async
|
|
87
|
-
- `workflow.start({runId, triggerData})`: Start a workflow run sync
|
|
88
|
-
- `workflow.resume(params)`: Resume the workflow run sync
|
|
89
|
-
|
|
90
|
-
### Vectors
|
|
91
|
-
|
|
92
|
-
- `getVector(vectorName)`: Get a vector instance
|
|
93
|
-
- `vector.details(indexName)`: Get vector index details
|
|
94
|
-
- `vector.delete(indexName)`: Delete a vector index
|
|
95
|
-
- `vector.getIndexes()`: Get all indexes
|
|
96
|
-
- `vector.createIndex(params)`: Create a new index
|
|
97
|
-
- `vector.upsert(params)`: Upsert vectors
|
|
98
|
-
- `vector.query(params)`: Query vectors
|
|
99
|
-
|
|
100
|
-
### Logs
|
|
101
|
-
|
|
102
|
-
- `listLogs(params)`: Get system logs
|
|
103
|
-
- `getLog(params)`: Get specific log entry
|
|
104
|
-
- `listLogTransports()`: Get configured Log transports
|
|
105
|
-
|
|
106
|
-
### Telemetry
|
|
107
|
-
|
|
108
|
-
- `getTelemetry(params)`: Get telemetry data
|
|
109
|
-
|
|
110
|
-
## Error Handling
|
|
25
|
+
## Documentation
|
|
111
26
|
|
|
112
|
-
|
|
27
|
+
- [@mastra/client-js documentation](https://mastra.ai/reference/client-js/mastra-client)
|
|
113
28
|
|
|
114
|
-
|
|
115
|
-
- Configurable retry count and backoff timing
|
|
116
|
-
- Throws error after max retries reached
|
|
29
|
+
## Changelog
|
|
117
30
|
|
|
118
|
-
|
|
31
|
+
See the [package changelog](https://github.com/mastra-ai/mastra/blob/main/client-sdks/client-js/CHANGELOG.md) for version history and release notes.
|
|
119
32
|
|
|
120
|
-
|
|
33
|
+
## Support
|
|
121
34
|
|
|
122
|
-
-
|
|
123
|
-
- Retry logic with exponential backoff
|
|
124
|
-
- Custom header management
|
|
125
|
-
- Error handling
|
|
35
|
+
We have an [open community Discord](https://discord.gg/mastra-ai). Come and say hello and let us know if you have any questions or need any help getting things running.
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
export declare const enrichedThemeLearningEntity: {
|
|
2
|
+
entityId: string;
|
|
3
|
+
entityType: string;
|
|
4
|
+
availableSignals: string[];
|
|
5
|
+
traceCount: number;
|
|
6
|
+
readySignalCount: number;
|
|
7
|
+
enabledSignalCount: number;
|
|
8
|
+
status: 'processing';
|
|
9
|
+
updatedAt: string;
|
|
10
|
+
};
|
|
11
|
+
//# sourceMappingURL=agent-learning-index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"agent-learning-index.d.ts","sourceRoot":"","sources":["../../../src/__tests__/fixtures/agent-learning-index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,2BAA2B;IACtC,QAAQ;IACR,UAAU;IACV,gBAAgB;IAChB,UAAU;IACV,gBAAgB;IAChB,kBAAkB;IAClB,MAAM,EAAE,YAAY;IACpB,SAAS;CACV,CAAC"}
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
export declare const customSignalDefinitionFixture: {
|
|
2
|
+
id: string;
|
|
3
|
+
name: string;
|
|
4
|
+
displayLabel: string;
|
|
5
|
+
description: string;
|
|
6
|
+
taskPrompt: string;
|
|
7
|
+
version: number;
|
|
8
|
+
status: "active";
|
|
9
|
+
enabled: false;
|
|
10
|
+
createdAt: string;
|
|
11
|
+
updatedAt: string;
|
|
12
|
+
};
|
|
13
|
+
export declare const archivedSignalDefinitionFixture: {
|
|
14
|
+
description: string;
|
|
15
|
+
taskPrompt: string;
|
|
16
|
+
version: number;
|
|
17
|
+
enabled: false;
|
|
18
|
+
createdAt: string;
|
|
19
|
+
updatedAt: string;
|
|
20
|
+
id: string;
|
|
21
|
+
name: string;
|
|
22
|
+
displayLabel: string;
|
|
23
|
+
status: "archived";
|
|
24
|
+
};
|
|
25
|
+
export declare const signalManagementListFixture: {
|
|
26
|
+
definitions: ({
|
|
27
|
+
id: string;
|
|
28
|
+
name: string;
|
|
29
|
+
displayLabel: string;
|
|
30
|
+
description: string;
|
|
31
|
+
taskPrompt: string;
|
|
32
|
+
version: number;
|
|
33
|
+
status: "active";
|
|
34
|
+
enabled: false;
|
|
35
|
+
createdAt: string;
|
|
36
|
+
updatedAt: string;
|
|
37
|
+
} | {
|
|
38
|
+
description: string;
|
|
39
|
+
taskPrompt: string;
|
|
40
|
+
version: number;
|
|
41
|
+
enabled: false;
|
|
42
|
+
createdAt: string;
|
|
43
|
+
updatedAt: string;
|
|
44
|
+
id: string;
|
|
45
|
+
name: string;
|
|
46
|
+
displayLabel: string;
|
|
47
|
+
status: "archived";
|
|
48
|
+
})[];
|
|
49
|
+
limits: {
|
|
50
|
+
maxDefinitionsPerOrganization: number;
|
|
51
|
+
};
|
|
52
|
+
};
|
|
53
|
+
export declare const createSignalDefinitionInputFixture: {
|
|
54
|
+
name: string;
|
|
55
|
+
displayLabel: string;
|
|
56
|
+
description: string;
|
|
57
|
+
taskPrompt: string;
|
|
58
|
+
};
|
|
59
|
+
export declare const updateSignalDefinitionInputFixture: {
|
|
60
|
+
displayLabel: string;
|
|
61
|
+
description: string;
|
|
62
|
+
taskPrompt: string;
|
|
63
|
+
};
|
|
64
|
+
export declare const projectSignalSettingFixture: {
|
|
65
|
+
projectId: string;
|
|
66
|
+
signalDefinitionId: string;
|
|
67
|
+
enabled: true;
|
|
68
|
+
};
|
|
69
|
+
//# sourceMappingURL=signal-management.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"signal-management.d.ts","sourceRoot":"","sources":["../../../src/__tests__/fixtures/signal-management.ts"],"names":[],"mappings":"AA+BA,eAAO,MAAM,6BAA6B;;;;;;;;;;;CAWF,CAAC;AAEzC,eAAO,MAAM,+BAA+B;;;;;;;;;;;CAMJ,CAAC;AAEzC,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;QAE5B,6BAA6B;;CACG,CAAC;AAE7C,eAAO,MAAM,kCAAkC;;;;;CAKI,CAAC;AAEpD,eAAO,MAAM,kCAAkC;;;;CAII,CAAC;AAEpD,eAAO,MAAM,2BAA2B;;;;CAII,CAAC"}
|
|
@@ -0,0 +1,230 @@
|
|
|
1
|
+
export type BuiltInTraceSignalName = 'goal' | 'sentiment' | 'behavior' | 'outcome';
|
|
2
|
+
export type TraceSignalName = string;
|
|
3
|
+
export type EntityLearningProgressStatus = 'collecting' | 'processing' | 'ready';
|
|
4
|
+
export interface SignalCatalogEntry {
|
|
5
|
+
name: string;
|
|
6
|
+
label: string;
|
|
7
|
+
description: string;
|
|
8
|
+
order: number;
|
|
9
|
+
builtIn: boolean;
|
|
10
|
+
enabled: boolean;
|
|
11
|
+
status: EntityLearningProgressStatus;
|
|
12
|
+
}
|
|
13
|
+
export interface EntityLearningProgressResponse {
|
|
14
|
+
status: EntityLearningProgressStatus;
|
|
15
|
+
traceCount: number;
|
|
16
|
+
signals: Record<string, {
|
|
17
|
+
generated: number;
|
|
18
|
+
embedded: number;
|
|
19
|
+
}>;
|
|
20
|
+
availableSignals: TraceSignalName[];
|
|
21
|
+
signalCatalog?: SignalCatalogEntry[];
|
|
22
|
+
}
|
|
23
|
+
export interface TraceSignalDefinition {
|
|
24
|
+
id: string;
|
|
25
|
+
name: string;
|
|
26
|
+
displayLabel: string;
|
|
27
|
+
description: string;
|
|
28
|
+
taskPrompt: string;
|
|
29
|
+
version: number;
|
|
30
|
+
status: 'active' | 'archived';
|
|
31
|
+
enabled: boolean | null;
|
|
32
|
+
createdAt: string;
|
|
33
|
+
updatedAt: string;
|
|
34
|
+
}
|
|
35
|
+
export interface TraceSignalManagementListResponse {
|
|
36
|
+
definitions: TraceSignalDefinition[];
|
|
37
|
+
limits: {
|
|
38
|
+
maxDefinitionsPerOrganization: number;
|
|
39
|
+
};
|
|
40
|
+
}
|
|
41
|
+
export interface CreateTraceSignalDefinitionInput {
|
|
42
|
+
name: string;
|
|
43
|
+
displayLabel: string;
|
|
44
|
+
description: string;
|
|
45
|
+
taskPrompt: string;
|
|
46
|
+
}
|
|
47
|
+
export type UpdateTraceSignalDefinitionInput = Omit<CreateTraceSignalDefinitionInput, 'name'>;
|
|
48
|
+
export interface ProjectTraceSignalSetting {
|
|
49
|
+
projectId: string;
|
|
50
|
+
signalDefinitionId: string;
|
|
51
|
+
enabled: boolean;
|
|
52
|
+
}
|
|
53
|
+
export interface ThemeLearningEntity {
|
|
54
|
+
entityId: string;
|
|
55
|
+
entityType: string;
|
|
56
|
+
availableSignals: TraceSignalName[];
|
|
57
|
+
signalCatalog?: SignalCatalogEntry[];
|
|
58
|
+
traceCount?: number;
|
|
59
|
+
readySignalCount?: number;
|
|
60
|
+
enabledSignalCount?: number;
|
|
61
|
+
status?: EntityLearningProgressStatus;
|
|
62
|
+
updatedAt?: string;
|
|
63
|
+
latestWindow?: {
|
|
64
|
+
startedAt: string;
|
|
65
|
+
endedAt: string;
|
|
66
|
+
};
|
|
67
|
+
}
|
|
68
|
+
export interface ThemeSnapshot {
|
|
69
|
+
snapshotId: string;
|
|
70
|
+
ordinal: number;
|
|
71
|
+
total: number;
|
|
72
|
+
/** When this snapshot became the current cross-signal state. Drives time-axis placement. */
|
|
73
|
+
cutoffAt?: string;
|
|
74
|
+
startedAt: string;
|
|
75
|
+
endedAt: string;
|
|
76
|
+
traceCount: number;
|
|
77
|
+
}
|
|
78
|
+
export type ThemeNode = {
|
|
79
|
+
nodeId: string;
|
|
80
|
+
kind: 'theme';
|
|
81
|
+
themeId: string;
|
|
82
|
+
label: string;
|
|
83
|
+
description?: string;
|
|
84
|
+
traceCount: number;
|
|
85
|
+
stageShare: number;
|
|
86
|
+
} | {
|
|
87
|
+
nodeId: string;
|
|
88
|
+
kind: 'noise' | 'other';
|
|
89
|
+
label: string;
|
|
90
|
+
description?: string;
|
|
91
|
+
traceCount: number;
|
|
92
|
+
stageShare: number;
|
|
93
|
+
};
|
|
94
|
+
export interface ThemeFlowResponse {
|
|
95
|
+
snapshot: ThemeSnapshot;
|
|
96
|
+
stages: Array<{
|
|
97
|
+
signalName: TraceSignalName;
|
|
98
|
+
traceCount: number;
|
|
99
|
+
nodes: ThemeNode[];
|
|
100
|
+
}>;
|
|
101
|
+
links: Array<{
|
|
102
|
+
sourceNodeId: string;
|
|
103
|
+
targetNodeId: string;
|
|
104
|
+
traceCount: number;
|
|
105
|
+
sourceShare: number;
|
|
106
|
+
targetShare: number;
|
|
107
|
+
}>;
|
|
108
|
+
}
|
|
109
|
+
export type ThemeSnapshotLandmarkReason = 'range_start' | 'range_end' | 'time_sample';
|
|
110
|
+
export interface ThemeSnapshotsResponse {
|
|
111
|
+
snapshots: Array<ThemeSnapshot & {
|
|
112
|
+
availableSignals: TraceSignalName[];
|
|
113
|
+
reason?: ThemeSnapshotLandmarkReason;
|
|
114
|
+
}>;
|
|
115
|
+
signalCatalog?: SignalCatalogEntry[];
|
|
116
|
+
nextCursor?: string;
|
|
117
|
+
totalSnapshots?: number;
|
|
118
|
+
}
|
|
119
|
+
export interface ThemeEntitiesResponse {
|
|
120
|
+
entities: ThemeLearningEntity[];
|
|
121
|
+
}
|
|
122
|
+
export interface ThemePathTheme {
|
|
123
|
+
signalName: TraceSignalName;
|
|
124
|
+
themeId: string;
|
|
125
|
+
label: string;
|
|
126
|
+
description?: string;
|
|
127
|
+
}
|
|
128
|
+
export interface ThemePathsResponse {
|
|
129
|
+
snapshot: ThemeSnapshot;
|
|
130
|
+
signals: TraceSignalName[];
|
|
131
|
+
themes: Record<string, ThemePathTheme>;
|
|
132
|
+
paths: Array<{
|
|
133
|
+
traceId: string;
|
|
134
|
+
assignments: Record<string, string>;
|
|
135
|
+
}>;
|
|
136
|
+
nextOffset?: number;
|
|
137
|
+
}
|
|
138
|
+
export type ActiveThemeState = 'birth' | 'continue' | 'split' | 'merge' | 'resurrection';
|
|
139
|
+
export type ThemeHistoryState = ActiveThemeState | 'death';
|
|
140
|
+
export interface ThemeTrend {
|
|
141
|
+
popularity: number;
|
|
142
|
+
signalScore: number;
|
|
143
|
+
strength: 'none' | 'weak' | 'strong';
|
|
144
|
+
}
|
|
145
|
+
export interface SnapshotTheme {
|
|
146
|
+
themeId: string;
|
|
147
|
+
label: string;
|
|
148
|
+
description?: string;
|
|
149
|
+
state: ActiveThemeState;
|
|
150
|
+
traceCount: number;
|
|
151
|
+
coverage: number;
|
|
152
|
+
trend?: ThemeTrend;
|
|
153
|
+
}
|
|
154
|
+
export interface ThemesResponse {
|
|
155
|
+
snapshot: ThemeSnapshot;
|
|
156
|
+
signalName: TraceSignalName;
|
|
157
|
+
themes: SnapshotTheme[];
|
|
158
|
+
noise: {
|
|
159
|
+
traceCount: number;
|
|
160
|
+
coverage: number;
|
|
161
|
+
};
|
|
162
|
+
}
|
|
163
|
+
export interface ThemeDetailResponse {
|
|
164
|
+
snapshot: ThemeSnapshot;
|
|
165
|
+
theme?: SnapshotTheme & {
|
|
166
|
+
signalName: TraceSignalName;
|
|
167
|
+
};
|
|
168
|
+
}
|
|
169
|
+
export interface ThemeExample {
|
|
170
|
+
traceId: string;
|
|
171
|
+
extractedTraceId: string;
|
|
172
|
+
signalText: string;
|
|
173
|
+
traceStartedAt?: string;
|
|
174
|
+
}
|
|
175
|
+
export interface ThemeExamplesResponse {
|
|
176
|
+
examples: ThemeExample[];
|
|
177
|
+
nextOffset?: number;
|
|
178
|
+
}
|
|
179
|
+
export type NoiseExamplesResponse = ThemeExamplesResponse;
|
|
180
|
+
export interface ThemeHistoryResponse {
|
|
181
|
+
theme: {
|
|
182
|
+
themeId: string;
|
|
183
|
+
signalName: TraceSignalName;
|
|
184
|
+
label: string;
|
|
185
|
+
description?: string;
|
|
186
|
+
};
|
|
187
|
+
points: Array<{
|
|
188
|
+
snapshotId: string;
|
|
189
|
+
startedAt: string;
|
|
190
|
+
endedAt: string;
|
|
191
|
+
state: ThemeHistoryState;
|
|
192
|
+
traceCount: number;
|
|
193
|
+
coverage: number;
|
|
194
|
+
trend?: ThemeTrend;
|
|
195
|
+
}>;
|
|
196
|
+
relationships: Array<{
|
|
197
|
+
snapshotId: string;
|
|
198
|
+
kind: 'split-from' | 'split-into' | 'merged-from' | 'merged-into';
|
|
199
|
+
relatedTheme: {
|
|
200
|
+
themeId: string;
|
|
201
|
+
label: string;
|
|
202
|
+
};
|
|
203
|
+
}>;
|
|
204
|
+
nextCursor?: string;
|
|
205
|
+
}
|
|
206
|
+
export interface NoiseResponse {
|
|
207
|
+
snapshot: ThemeSnapshot;
|
|
208
|
+
noise: {
|
|
209
|
+
signalName: TraceSignalName;
|
|
210
|
+
traceCount: number;
|
|
211
|
+
coverage: number;
|
|
212
|
+
};
|
|
213
|
+
}
|
|
214
|
+
export interface TraceInsightSummary {
|
|
215
|
+
version: string;
|
|
216
|
+
summary: string;
|
|
217
|
+
observations: string[];
|
|
218
|
+
currentTask?: string;
|
|
219
|
+
degenerate?: boolean;
|
|
220
|
+
createdAt: string;
|
|
221
|
+
}
|
|
222
|
+
export interface TraceInsightResponse {
|
|
223
|
+
traceId: string;
|
|
224
|
+
summary?: TraceInsightSummary;
|
|
225
|
+
signals: Array<{
|
|
226
|
+
signalName: TraceSignalName;
|
|
227
|
+
signalText: string;
|
|
228
|
+
}>;
|
|
229
|
+
}
|
|
230
|
+
//# sourceMappingURL=agent-learning.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"agent-learning.d.ts","sourceRoot":"","sources":["../src/agent-learning.ts"],"names":[],"mappings":"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"}
|