@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.
Files changed (134) hide show
  1. package/LICENSE.md +6 -4
  2. package/README.md +15 -105
  3. package/dist/__tests__/fixtures/agent-learning-index.d.ts +11 -0
  4. package/dist/__tests__/fixtures/agent-learning-index.d.ts.map +1 -0
  5. package/dist/__tests__/fixtures/signal-management.d.ts +69 -0
  6. package/dist/__tests__/fixtures/signal-management.d.ts.map +1 -0
  7. package/dist/agent-learning.d.ts +230 -0
  8. package/dist/agent-learning.d.ts.map +1 -0
  9. package/dist/client.d.ts +455 -177
  10. package/dist/client.d.ts.map +1 -1
  11. package/dist/index.cjs +9288 -6139
  12. package/dist/index.cjs.map +1 -1
  13. package/dist/index.d.ts +10 -0
  14. package/dist/index.d.ts.map +1 -1
  15. package/dist/index.js +9257 -6134
  16. package/dist/index.js.map +1 -1
  17. package/dist/observability/collector.d.ts +45 -0
  18. package/dist/observability/collector.d.ts.map +1 -0
  19. package/dist/observability/index.d.ts +14 -0
  20. package/dist/observability/index.d.ts.map +1 -0
  21. package/dist/observability/types.d.ts +27 -0
  22. package/dist/observability/types.d.ts.map +1 -0
  23. package/dist/resources/a2a.d.ts +30 -3
  24. package/dist/resources/a2a.d.ts.map +1 -1
  25. package/dist/resources/agent-builder.d.ts +26 -52
  26. package/dist/resources/agent-builder.d.ts.map +1 -1
  27. package/dist/resources/agent-controller.d.ts +344 -0
  28. package/dist/resources/agent-controller.d.ts.map +1 -0
  29. package/dist/resources/agent.d.ts +215 -42
  30. package/dist/resources/agent.d.ts.map +1 -1
  31. package/dist/resources/base.d.ts.map +1 -1
  32. package/dist/resources/channels.d.ts +23 -31
  33. package/dist/resources/channels.d.ts.map +1 -1
  34. package/dist/resources/conversations.d.ts +6 -3
  35. package/dist/resources/conversations.d.ts.map +1 -1
  36. package/dist/resources/dynamic-workflow.d.ts +18 -0
  37. package/dist/resources/dynamic-workflow.d.ts.map +1 -0
  38. package/dist/resources/index.d.ts +2 -0
  39. package/dist/resources/index.d.ts.map +1 -1
  40. package/dist/resources/mcp-tool.d.ts +9 -6
  41. package/dist/resources/mcp-tool.d.ts.map +1 -1
  42. package/dist/resources/memory-thread.d.ts +45 -16
  43. package/dist/resources/memory-thread.d.ts.map +1 -1
  44. package/dist/resources/observability-route-types.d.ts +115 -0
  45. package/dist/resources/observability-route-types.d.ts.map +1 -0
  46. package/dist/resources/observability.d.ts +165 -3
  47. package/dist/resources/observability.d.ts.map +1 -1
  48. package/dist/resources/processor-provider.d.ts.map +1 -1
  49. package/dist/resources/processor.d.ts.map +1 -1
  50. package/dist/resources/responses.d.ts +5 -2
  51. package/dist/resources/responses.d.ts.map +1 -1
  52. package/dist/resources/run.d.ts +36 -50
  53. package/dist/resources/run.d.ts.map +1 -1
  54. package/dist/resources/stored-agent.d.ts +30 -1
  55. package/dist/resources/stored-agent.d.ts.map +1 -1
  56. package/dist/resources/stored-mcp-client.d.ts.map +1 -1
  57. package/dist/resources/stored-prompt-block.d.ts.map +1 -1
  58. package/dist/resources/stored-scorer.d.ts.map +1 -1
  59. package/dist/resources/stored-skill.d.ts +11 -1
  60. package/dist/resources/stored-skill.d.ts.map +1 -1
  61. package/dist/resources/tool-provider.d.ts +63 -10
  62. package/dist/resources/tool-provider.d.ts.map +1 -1
  63. package/dist/resources/tool.d.ts +6 -4
  64. package/dist/resources/tool.d.ts.map +1 -1
  65. package/dist/resources/vector.d.ts +5 -10
  66. package/dist/resources/vector.d.ts.map +1 -1
  67. package/dist/resources/workflow.d.ts +8 -10
  68. package/dist/resources/workflow.d.ts.map +1 -1
  69. package/dist/resources/workspace.d.ts +39 -1
  70. package/dist/resources/workspace.d.ts.map +1 -1
  71. package/dist/route-types.generated.d.ts +21036 -0
  72. package/dist/route-types.generated.d.ts.map +1 -0
  73. package/dist/tools.d.ts +2 -5
  74. package/dist/tools.d.ts.map +1 -1
  75. package/dist/types.d.ts +863 -1334
  76. package/dist/types.d.ts.map +1 -1
  77. package/dist/utils/ai-sdk-v4/data-stream-parts.d.ts +89 -0
  78. package/dist/utils/ai-sdk-v4/data-stream-parts.d.ts.map +1 -0
  79. package/dist/utils/ai-sdk-v4/fix-json.d.ts +2 -0
  80. package/dist/utils/ai-sdk-v4/fix-json.d.ts.map +1 -0
  81. package/dist/utils/ai-sdk-v4/index.d.ts +5 -0
  82. package/dist/utils/ai-sdk-v4/index.d.ts.map +1 -0
  83. package/dist/utils/ai-sdk-v4/parse-partial-json.d.ts +6 -0
  84. package/dist/utils/ai-sdk-v4/parse-partial-json.d.ts.map +1 -0
  85. package/dist/utils/ai-sdk-v4/process-data-stream.d.ts +53 -0
  86. package/dist/utils/ai-sdk-v4/process-data-stream.d.ts.map +1 -0
  87. package/dist/utils/ai-sdk-v4/types.d.ts +93 -0
  88. package/dist/utils/ai-sdk-v4/types.d.ts.map +1 -0
  89. package/dist/utils/client-tool-model-output.d.ts +16 -0
  90. package/dist/utils/client-tool-model-output.d.ts.map +1 -0
  91. package/dist/utils/index.d.ts +34 -0
  92. package/dist/utils/index.d.ts.map +1 -1
  93. package/dist/utils/process-a2a-stream.d.ts +2 -2
  94. package/dist/utils/process-a2a-stream.d.ts.map +1 -1
  95. package/dist/utils/process-mastra-stream.d.ts +6 -4
  96. package/dist/utils/process-mastra-stream.d.ts.map +1 -1
  97. package/dist/utils/sse-event-splitter.d.ts +3 -0
  98. package/dist/utils/sse-event-splitter.d.ts.map +1 -0
  99. package/dist/utils/stream-transforms.d.ts +9 -0
  100. package/dist/utils/stream-transforms.d.ts.map +1 -0
  101. package/dist/utils/verify-agent-card-signature.d.ts +21 -0
  102. package/dist/utils/verify-agent-card-signature.d.ts.map +1 -0
  103. package/dist/utils/zod-to-json-schema.d.ts +2 -1
  104. package/dist/utils/zod-to-json-schema.d.ts.map +1 -1
  105. package/package.json +22 -20
  106. package/CHANGELOG.md +0 -8359
  107. package/dist/_types/@ai-sdk_ui-utils/dist/index.d.ts +0 -820
  108. package/dist/_types/@internal_ai-sdk-v5/dist/index.d.ts +0 -9034
  109. package/dist/docs/SKILL.md +0 -48
  110. package/dist/docs/assets/SOURCE_MAP.json +0 -11
  111. package/dist/docs/references/docs-editor-overview.md +0 -290
  112. package/dist/docs/references/docs-server-auth-auth0.md +0 -260
  113. package/dist/docs/references/docs-server-auth-clerk.md +0 -152
  114. package/dist/docs/references/docs-server-auth-firebase.md +0 -292
  115. package/dist/docs/references/docs-server-auth-jwt.md +0 -114
  116. package/dist/docs/references/docs-server-auth-supabase.md +0 -137
  117. package/dist/docs/references/docs-server-auth-workos.md +0 -226
  118. package/dist/docs/references/docs-server-mastra-client.md +0 -260
  119. package/dist/docs/references/reference-ai-sdk-to-ai-sdk-messages.md +0 -95
  120. package/dist/docs/references/reference-ai-sdk-to-ai-sdk-stream.md +0 -280
  121. package/dist/docs/references/reference-ai-sdk-to-ai-sdk-v4-messages.md +0 -79
  122. package/dist/docs/references/reference-ai-sdk-to-ai-sdk-v5-messages.md +0 -76
  123. package/dist/docs/references/reference-client-js-agents.md +0 -608
  124. package/dist/docs/references/reference-client-js-conversations.md +0 -135
  125. package/dist/docs/references/reference-client-js-error-handling.md +0 -16
  126. package/dist/docs/references/reference-client-js-logs.md +0 -24
  127. package/dist/docs/references/reference-client-js-mastra-client.md +0 -90
  128. package/dist/docs/references/reference-client-js-memory.md +0 -221
  129. package/dist/docs/references/reference-client-js-observability.md +0 -72
  130. package/dist/docs/references/reference-client-js-responses.md +0 -213
  131. package/dist/docs/references/reference-client-js-telemetry.md +0 -20
  132. package/dist/docs/references/reference-client-js-tools.md +0 -44
  133. package/dist/docs/references/reference-client-js-vectors.md +0 -79
  134. 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 "ee/" within this
3
+ - All content that resides under any directory named `ee/` within this
4
4
  repository, including but not limited to:
5
- - `packages/core/src/auth/ee/`
6
- - `packages/server/src/server/auth/ee/`
7
- is licensed under the license defined in `ee/LICENSE`.
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
- # Mastra Client
1
+ # @mastra/client-js
2
2
 
3
- JavaScript/TypeScript client library for the [Mastra AI](https://mastra.ai) framework. This client provides a simple interface to interact with Mastra AI's APIs for agents, vectors, memory, tools, and workflows.
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
- ## Quick Start
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
- // Initialize the client
17
- const client = new MastraClient({
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
- The client can be configured with several options:
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
- ## Available Methods
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
- The client includes built-in retry logic for failed requests:
27
+ - [@mastra/client-js documentation](https://mastra.ai/reference/client-js/mastra-client)
113
28
 
114
- - Automatically retries failed requests with exponential backoff
115
- - Configurable retry count and backoff timing
116
- - Throws error after max retries reached
29
+ ## Changelog
117
30
 
118
- ## Internal Implementation
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
- The client uses the native `fetch` API internally for making HTTP requests. All requests are automatically handled with:
33
+ ## Support
121
34
 
122
- - JSON serialization/deserialization
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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"}