@contractspec/example.agent-console 3.7.6 → 3.7.7

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 (175) hide show
  1. package/.turbo/turbo-build.log +18 -18
  2. package/AGENTS.md +50 -31
  3. package/README.md +69 -77
  4. package/dist/agent/agent.event.js +1 -1
  5. package/dist/agent/agent.operation.js +1 -1
  6. package/dist/agent/index.d.ts +5 -5
  7. package/dist/agent/index.js +1 -1
  8. package/dist/browser/agent/agent.event.js +1 -1
  9. package/dist/browser/agent/agent.operation.js +1 -1
  10. package/dist/browser/agent/index.js +1 -1
  11. package/dist/browser/index.js +2145 -2145
  12. package/dist/browser/presentations/index.js +4 -4
  13. package/dist/browser/run/index.js +536 -536
  14. package/dist/browser/run/run.event.js +2 -2
  15. package/dist/browser/run/run.presentation.js +2 -2
  16. package/dist/browser/tool/index.js +260 -260
  17. package/dist/browser/tool/tool.event.js +1 -1
  18. package/dist/browser/tool/tool.presentation.js +2 -2
  19. package/dist/browser/ui/AgentDashboard.js +956 -956
  20. package/dist/browser/ui/AgentRunList.js +16 -16
  21. package/dist/browser/ui/AgentToolRegistry.js +9 -9
  22. package/dist/browser/ui/hooks/index.js +153 -153
  23. package/dist/browser/ui/hooks/useAgentList.js +1 -1
  24. package/dist/browser/ui/hooks/useAgentMutations.js +1 -1
  25. package/dist/browser/ui/hooks/useRunList.js +1 -1
  26. package/dist/browser/ui/hooks/useToolList.js +1 -1
  27. package/dist/browser/ui/index.js +1222 -1222
  28. package/dist/browser/ui/modals/AgentActionsModal.js +13 -13
  29. package/dist/browser/ui/modals/CreateAgentModal.js +15 -15
  30. package/dist/browser/ui/modals/index.js +297 -297
  31. package/dist/browser/ui/renderers/agent-list.renderer.js +7 -7
  32. package/dist/browser/ui/renderers/index.js +157 -157
  33. package/dist/browser/ui/views/AgentListView.js +7 -7
  34. package/dist/browser/ui/views/RunListView.js +16 -16
  35. package/dist/browser/ui/views/ToolRegistryView.js +9 -9
  36. package/dist/browser/ui/views/index.js +97 -97
  37. package/dist/handlers/index.d.ts +1 -1
  38. package/dist/index.d.ts +4 -4
  39. package/dist/index.js +2145 -2145
  40. package/dist/node/agent/agent.event.js +1 -1
  41. package/dist/node/agent/agent.operation.js +1 -1
  42. package/dist/node/agent/index.js +1 -1
  43. package/dist/node/index.js +2145 -2145
  44. package/dist/node/presentations/index.js +4 -4
  45. package/dist/node/run/index.js +536 -536
  46. package/dist/node/run/run.event.js +2 -2
  47. package/dist/node/run/run.presentation.js +2 -2
  48. package/dist/node/tool/index.js +260 -260
  49. package/dist/node/tool/tool.event.js +1 -1
  50. package/dist/node/tool/tool.presentation.js +2 -2
  51. package/dist/node/ui/AgentDashboard.js +956 -956
  52. package/dist/node/ui/AgentRunList.js +16 -16
  53. package/dist/node/ui/AgentToolRegistry.js +9 -9
  54. package/dist/node/ui/hooks/index.js +153 -153
  55. package/dist/node/ui/hooks/useAgentList.js +1 -1
  56. package/dist/node/ui/hooks/useAgentMutations.js +1 -1
  57. package/dist/node/ui/hooks/useRunList.js +1 -1
  58. package/dist/node/ui/hooks/useToolList.js +1 -1
  59. package/dist/node/ui/index.js +1222 -1222
  60. package/dist/node/ui/modals/AgentActionsModal.js +13 -13
  61. package/dist/node/ui/modals/CreateAgentModal.js +15 -15
  62. package/dist/node/ui/modals/index.js +297 -297
  63. package/dist/node/ui/renderers/agent-list.renderer.js +7 -7
  64. package/dist/node/ui/renderers/index.js +157 -157
  65. package/dist/node/ui/views/AgentListView.js +7 -7
  66. package/dist/node/ui/views/RunListView.js +16 -16
  67. package/dist/node/ui/views/ToolRegistryView.js +9 -9
  68. package/dist/node/ui/views/index.js +97 -97
  69. package/dist/presentations/index.d.ts +3 -5
  70. package/dist/presentations/index.js +4 -4
  71. package/dist/run/index.d.ts +7 -7
  72. package/dist/run/index.js +536 -536
  73. package/dist/run/run.event.js +2 -2
  74. package/dist/run/run.handler.d.ts +3 -0
  75. package/dist/run/run.presentation.js +2 -2
  76. package/dist/shared/index.d.ts +1 -1
  77. package/dist/tool/index.d.ts +7 -7
  78. package/dist/tool/index.js +260 -260
  79. package/dist/tool/tool.event.js +1 -1
  80. package/dist/tool/tool.handler.d.ts +1 -1
  81. package/dist/tool/tool.presentation.js +2 -2
  82. package/dist/ui/AgentDashboard.js +956 -956
  83. package/dist/ui/AgentRunList.js +16 -16
  84. package/dist/ui/AgentToolRegistry.js +9 -9
  85. package/dist/ui/hooks/index.d.ts +4 -4
  86. package/dist/ui/hooks/index.js +153 -153
  87. package/dist/ui/hooks/useAgentList.d.ts +5 -0
  88. package/dist/ui/hooks/useAgentList.js +1 -1
  89. package/dist/ui/hooks/useAgentMutations.d.ts +9 -2
  90. package/dist/ui/hooks/useAgentMutations.js +1 -1
  91. package/dist/ui/hooks/useRunList.d.ts +5 -0
  92. package/dist/ui/hooks/useRunList.js +1 -1
  93. package/dist/ui/hooks/useToolList.d.ts +5 -0
  94. package/dist/ui/hooks/useToolList.js +1 -1
  95. package/dist/ui/index.d.ts +3 -3
  96. package/dist/ui/index.js +1222 -1222
  97. package/dist/ui/modals/AgentActionsModal.js +13 -13
  98. package/dist/ui/modals/CreateAgentModal.js +15 -15
  99. package/dist/ui/modals/index.d.ts +1 -1
  100. package/dist/ui/modals/index.js +297 -297
  101. package/dist/ui/renderers/agent-list.markdown.d.ts +5 -0
  102. package/dist/ui/renderers/agent-list.renderer.js +7 -7
  103. package/dist/ui/renderers/dashboard.markdown.d.ts +5 -0
  104. package/dist/ui/renderers/index.d.ts +2 -2
  105. package/dist/ui/renderers/index.js +157 -157
  106. package/dist/ui/renderers/run-list.markdown.d.ts +5 -0
  107. package/dist/ui/renderers/tool-registry.markdown.d.ts +5 -0
  108. package/dist/ui/views/AgentListView.js +7 -7
  109. package/dist/ui/views/RunListView.js +16 -16
  110. package/dist/ui/views/ToolRegistryView.js +9 -9
  111. package/dist/ui/views/index.js +97 -97
  112. package/package.json +6 -6
  113. package/src/agent/agent.entity.ts +111 -111
  114. package/src/agent/agent.enum.ts +12 -12
  115. package/src/agent/agent.event.ts +91 -91
  116. package/src/agent/agent.handler.ts +123 -123
  117. package/src/agent/agent.operation.ts +400 -400
  118. package/src/agent/agent.presentation.ts +62 -62
  119. package/src/agent/agent.schema.ts +175 -175
  120. package/src/agent/agent.test-spec.ts +48 -48
  121. package/src/agent/index.ts +46 -51
  122. package/src/agent.capability.ts +11 -11
  123. package/src/agent.feature.ts +131 -131
  124. package/src/docs/agent-console.docblock.ts +42 -42
  125. package/src/example.ts +35 -35
  126. package/src/handlers/agent.handlers.ts +522 -521
  127. package/src/handlers/index.ts +12 -12
  128. package/src/index.ts +8 -9
  129. package/src/presentations/index.ts +11 -13
  130. package/src/run/index.ts +49 -54
  131. package/src/run/run.entity.ts +137 -137
  132. package/src/run/run.enum.ts +18 -18
  133. package/src/run/run.event.ts +174 -174
  134. package/src/run/run.handler.ts +92 -91
  135. package/src/run/run.operation.ts +474 -474
  136. package/src/run/run.presentation.ts +42 -42
  137. package/src/run/run.schema.ts +126 -126
  138. package/src/run/run.test-spec.ts +48 -48
  139. package/src/seeders/index.ts +21 -21
  140. package/src/shared/index.ts +1 -1
  141. package/src/shared/mock-agents.ts +76 -76
  142. package/src/shared/mock-runs.ts +102 -102
  143. package/src/shared/mock-tools.ts +140 -140
  144. package/src/shared/overlay-types.ts +23 -23
  145. package/src/tool/index.ts +39 -44
  146. package/src/tool/tool.entity.ts +73 -73
  147. package/src/tool/tool.enum.ts +13 -13
  148. package/src/tool/tool.event.ts +80 -80
  149. package/src/tool/tool.handler.ts +102 -102
  150. package/src/tool/tool.operation.ts +328 -328
  151. package/src/tool/tool.presentation.ts +43 -43
  152. package/src/tool/tool.schema.ts +106 -106
  153. package/src/tool/tool.test-spec.ts +48 -48
  154. package/src/ui/AgentDashboard.tsx +348 -348
  155. package/src/ui/hooks/index.ts +7 -7
  156. package/src/ui/hooks/useAgentList.ts +57 -56
  157. package/src/ui/hooks/useAgentMutations.ts +160 -159
  158. package/src/ui/hooks/useRunList.ts +58 -57
  159. package/src/ui/hooks/useToolList.ts +102 -101
  160. package/src/ui/index.ts +6 -9
  161. package/src/ui/modals/AgentActionsModal.tsx +262 -262
  162. package/src/ui/modals/CreateAgentModal.tsx +232 -232
  163. package/src/ui/modals/index.ts +1 -1
  164. package/src/ui/overlays/demo-overlays.ts +52 -52
  165. package/src/ui/renderers/agent-list.markdown.ts +61 -60
  166. package/src/ui/renderers/agent-list.renderer.tsx +14 -14
  167. package/src/ui/renderers/dashboard.markdown.ts +140 -139
  168. package/src/ui/renderers/index.ts +3 -4
  169. package/src/ui/renderers/run-list.markdown.ts +48 -47
  170. package/src/ui/renderers/tool-registry.markdown.ts +66 -65
  171. package/src/ui/views/AgentListView.tsx +90 -90
  172. package/src/ui/views/RunListView.tsx +141 -141
  173. package/src/ui/views/ToolRegistryView.tsx +113 -113
  174. package/tsconfig.json +7 -8
  175. package/tsdown.config.js +7 -3
@@ -1,138 +1,139 @@
1
1
  /**
2
2
  * Mock handlers for Run contracts.
3
3
  */
4
- import { MOCK_RUNS } from '../shared/mock-runs';
4
+
5
5
  import { MOCK_AGENTS } from '../shared/mock-agents';
6
+ import { MOCK_RUNS } from '../shared/mock-runs';
6
7
 
7
8
  export interface ListRunsInput {
8
- organizationId?: string;
9
- agentId?: string;
10
- userId?: string;
11
- sessionId?: string;
12
- status?:
13
- | 'QUEUED'
14
- | 'IN_PROGRESS'
15
- | 'COMPLETED'
16
- | 'FAILED'
17
- | 'CANCELLED'
18
- | 'EXPIRED';
19
- startDate?: Date;
20
- endDate?: Date;
21
- limit?: number;
22
- offset?: number;
9
+ organizationId?: string;
10
+ agentId?: string;
11
+ userId?: string;
12
+ sessionId?: string;
13
+ status?:
14
+ | 'QUEUED'
15
+ | 'IN_PROGRESS'
16
+ | 'COMPLETED'
17
+ | 'FAILED'
18
+ | 'CANCELLED'
19
+ | 'EXPIRED';
20
+ startDate?: Date;
21
+ endDate?: Date;
22
+ limit?: number;
23
+ offset?: number;
23
24
  }
24
25
 
25
26
  export interface RunSummary {
26
- id: string;
27
- agentId: string;
28
- agentName: string;
29
- status:
30
- | 'QUEUED'
31
- | 'IN_PROGRESS'
32
- | 'COMPLETED'
33
- | 'FAILED'
34
- | 'CANCELLED'
35
- | 'EXPIRED';
36
- totalTokens: number;
37
- durationMs?: number;
38
- estimatedCostUsd?: number;
39
- queuedAt: Date;
40
- completedAt?: Date;
27
+ id: string;
28
+ agentId: string;
29
+ agentName: string;
30
+ status:
31
+ | 'QUEUED'
32
+ | 'IN_PROGRESS'
33
+ | 'COMPLETED'
34
+ | 'FAILED'
35
+ | 'CANCELLED'
36
+ | 'EXPIRED';
37
+ totalTokens: number;
38
+ durationMs?: number;
39
+ estimatedCostUsd?: number;
40
+ queuedAt: Date;
41
+ completedAt?: Date;
41
42
  }
42
43
 
43
44
  export interface ListRunsOutput {
44
- items: RunSummary[];
45
- total: number;
46
- hasMore: boolean;
45
+ items: RunSummary[];
46
+ total: number;
47
+ hasMore: boolean;
47
48
  }
48
49
 
49
50
  /**
50
51
  * Mock handler for ListRunsQuery.
51
52
  */
52
53
  export async function mockListRunsHandler(
53
- input: ListRunsInput
54
+ input: ListRunsInput
54
55
  ): Promise<ListRunsOutput> {
55
- const { agentId, status, limit = 20, offset = 0 } = input;
56
+ const { agentId, status, limit = 20, offset = 0 } = input;
56
57
 
57
- let filtered = [...MOCK_RUNS];
58
- if (agentId) filtered = filtered.filter((r) => r.agentId === agentId);
59
- if (status) filtered = filtered.filter((r) => r.status === status);
58
+ let filtered = [...MOCK_RUNS];
59
+ if (agentId) filtered = filtered.filter((r) => r.agentId === agentId);
60
+ if (status) filtered = filtered.filter((r) => r.status === status);
60
61
 
61
- const total = filtered.length;
62
- const items = filtered.slice(offset, offset + limit).map((r) => {
63
- const agent = MOCK_AGENTS.find((a) => a.id === r.agentId);
64
- return {
65
- id: r.id,
66
- agentId: r.agentId,
67
- agentName: agent?.name ?? 'Unknown',
68
- status: r.status,
69
- totalTokens: r.totalTokens,
70
- durationMs: r.durationMs,
71
- estimatedCostUsd: r.estimatedCostUsd,
72
- queuedAt: r.queuedAt,
73
- completedAt: r.completedAt,
74
- };
75
- });
62
+ const total = filtered.length;
63
+ const items = filtered.slice(offset, offset + limit).map((r) => {
64
+ const agent = MOCK_AGENTS.find((a) => a.id === r.agentId);
65
+ return {
66
+ id: r.id,
67
+ agentId: r.agentId,
68
+ agentName: agent?.name ?? 'Unknown',
69
+ status: r.status,
70
+ totalTokens: r.totalTokens,
71
+ durationMs: r.durationMs,
72
+ estimatedCostUsd: r.estimatedCostUsd,
73
+ queuedAt: r.queuedAt,
74
+ completedAt: r.completedAt,
75
+ };
76
+ });
76
77
 
77
- return { items, total, hasMore: offset + limit < total };
78
+ return { items, total, hasMore: offset + limit < total };
78
79
  }
79
80
 
80
81
  /**
81
82
  * Mock handler for GetRunQuery.
82
83
  */
83
84
  export async function mockGetRunHandler(input: {
84
- runId: string;
85
- includeSteps?: boolean;
86
- includeLogs?: boolean;
85
+ runId: string;
86
+ includeSteps?: boolean;
87
+ includeLogs?: boolean;
87
88
  }) {
88
- const run = MOCK_RUNS.find((r) => r.id === input.runId);
89
- if (!run) throw new Error('RUN_NOT_FOUND');
89
+ const run = MOCK_RUNS.find((r) => r.id === input.runId);
90
+ if (!run) throw new Error('RUN_NOT_FOUND');
90
91
 
91
- const agent = MOCK_AGENTS.find((a) => a.id === run.agentId);
92
- return {
93
- ...run,
94
- agent: agent
95
- ? {
96
- id: agent.id,
97
- name: agent.name,
98
- modelProvider: agent.modelProvider,
99
- modelName: agent.modelName,
100
- }
101
- : undefined,
102
- steps: input.includeSteps ? run.steps : undefined,
103
- logs: input.includeLogs ? run.logs : undefined,
104
- };
92
+ const agent = MOCK_AGENTS.find((a) => a.id === run.agentId);
93
+ return {
94
+ ...run,
95
+ agent: agent
96
+ ? {
97
+ id: agent.id,
98
+ name: agent.name,
99
+ modelProvider: agent.modelProvider,
100
+ modelName: agent.modelName,
101
+ }
102
+ : undefined,
103
+ steps: input.includeSteps ? run.steps : undefined,
104
+ logs: input.includeLogs ? run.logs : undefined,
105
+ };
105
106
  }
106
107
 
107
108
  /**
108
109
  * Mock handler for ExecuteAgentCommand.
109
110
  */
110
111
  export async function mockExecuteAgentHandler(input: {
111
- agentId: string;
112
- input: { message: string; context?: Record<string, unknown> };
112
+ agentId: string;
113
+ input: { message: string; context?: Record<string, unknown> };
113
114
  }) {
114
- const agent = MOCK_AGENTS.find((a) => a.id === input.agentId);
115
- if (!agent) throw new Error('AGENT_NOT_FOUND');
116
- if (agent.status !== 'ACTIVE') throw new Error('AGENT_NOT_ACTIVE');
115
+ const agent = MOCK_AGENTS.find((a) => a.id === input.agentId);
116
+ if (!agent) throw new Error('AGENT_NOT_FOUND');
117
+ if (agent.status !== 'ACTIVE') throw new Error('AGENT_NOT_ACTIVE');
117
118
 
118
- return {
119
- runId: `run-${Date.now()}`,
120
- status: 'QUEUED' as const,
121
- estimatedWaitMs: 500,
122
- };
119
+ return {
120
+ runId: `run-${Date.now()}`,
121
+ status: 'QUEUED' as const,
122
+ estimatedWaitMs: 500,
123
+ };
123
124
  }
124
125
 
125
126
  /**
126
127
  * Mock handler for CancelRunCommand.
127
128
  */
128
129
  export async function mockCancelRunHandler(input: {
129
- runId: string;
130
- reason?: string;
130
+ runId: string;
131
+ reason?: string;
131
132
  }) {
132
- const run = MOCK_RUNS.find((r) => r.id === input.runId);
133
- if (!run) throw new Error('RUN_NOT_FOUND');
134
- if (!['QUEUED', 'IN_PROGRESS'].includes(run.status))
135
- throw new Error('RUN_NOT_CANCELLABLE');
133
+ const run = MOCK_RUNS.find((r) => r.id === input.runId);
134
+ if (!run) throw new Error('RUN_NOT_FOUND');
135
+ if (!['QUEUED', 'IN_PROGRESS'].includes(run.status))
136
+ throw new Error('RUN_NOT_CANCELLABLE');
136
137
 
137
- return { success: true, status: 'CANCELLED' as const };
138
+ return { success: true, status: 'CANCELLED' as const };
138
139
  }