@contractspec/example.agent-console 3.7.5 → 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 (176) hide show
  1. package/.turbo/turbo-build.log +18 -18
  2. package/AGENTS.md +50 -31
  3. package/CHANGELOG.md +12 -0
  4. package/README.md +69 -77
  5. package/dist/agent/agent.event.js +1 -1
  6. package/dist/agent/agent.operation.js +1 -1
  7. package/dist/agent/index.d.ts +5 -5
  8. package/dist/agent/index.js +1 -1
  9. package/dist/browser/agent/agent.event.js +1 -1
  10. package/dist/browser/agent/agent.operation.js +1 -1
  11. package/dist/browser/agent/index.js +1 -1
  12. package/dist/browser/index.js +2145 -2145
  13. package/dist/browser/presentations/index.js +4 -4
  14. package/dist/browser/run/index.js +536 -536
  15. package/dist/browser/run/run.event.js +2 -2
  16. package/dist/browser/run/run.presentation.js +2 -2
  17. package/dist/browser/tool/index.js +260 -260
  18. package/dist/browser/tool/tool.event.js +1 -1
  19. package/dist/browser/tool/tool.presentation.js +2 -2
  20. package/dist/browser/ui/AgentDashboard.js +956 -956
  21. package/dist/browser/ui/AgentRunList.js +16 -16
  22. package/dist/browser/ui/AgentToolRegistry.js +9 -9
  23. package/dist/browser/ui/hooks/index.js +153 -153
  24. package/dist/browser/ui/hooks/useAgentList.js +1 -1
  25. package/dist/browser/ui/hooks/useAgentMutations.js +1 -1
  26. package/dist/browser/ui/hooks/useRunList.js +1 -1
  27. package/dist/browser/ui/hooks/useToolList.js +1 -1
  28. package/dist/browser/ui/index.js +1222 -1222
  29. package/dist/browser/ui/modals/AgentActionsModal.js +13 -13
  30. package/dist/browser/ui/modals/CreateAgentModal.js +15 -15
  31. package/dist/browser/ui/modals/index.js +297 -297
  32. package/dist/browser/ui/renderers/agent-list.renderer.js +7 -7
  33. package/dist/browser/ui/renderers/index.js +157 -157
  34. package/dist/browser/ui/views/AgentListView.js +7 -7
  35. package/dist/browser/ui/views/RunListView.js +16 -16
  36. package/dist/browser/ui/views/ToolRegistryView.js +9 -9
  37. package/dist/browser/ui/views/index.js +97 -97
  38. package/dist/handlers/index.d.ts +1 -1
  39. package/dist/index.d.ts +4 -4
  40. package/dist/index.js +2145 -2145
  41. package/dist/node/agent/agent.event.js +1 -1
  42. package/dist/node/agent/agent.operation.js +1 -1
  43. package/dist/node/agent/index.js +1 -1
  44. package/dist/node/index.js +2145 -2145
  45. package/dist/node/presentations/index.js +4 -4
  46. package/dist/node/run/index.js +536 -536
  47. package/dist/node/run/run.event.js +2 -2
  48. package/dist/node/run/run.presentation.js +2 -2
  49. package/dist/node/tool/index.js +260 -260
  50. package/dist/node/tool/tool.event.js +1 -1
  51. package/dist/node/tool/tool.presentation.js +2 -2
  52. package/dist/node/ui/AgentDashboard.js +956 -956
  53. package/dist/node/ui/AgentRunList.js +16 -16
  54. package/dist/node/ui/AgentToolRegistry.js +9 -9
  55. package/dist/node/ui/hooks/index.js +153 -153
  56. package/dist/node/ui/hooks/useAgentList.js +1 -1
  57. package/dist/node/ui/hooks/useAgentMutations.js +1 -1
  58. package/dist/node/ui/hooks/useRunList.js +1 -1
  59. package/dist/node/ui/hooks/useToolList.js +1 -1
  60. package/dist/node/ui/index.js +1222 -1222
  61. package/dist/node/ui/modals/AgentActionsModal.js +13 -13
  62. package/dist/node/ui/modals/CreateAgentModal.js +15 -15
  63. package/dist/node/ui/modals/index.js +297 -297
  64. package/dist/node/ui/renderers/agent-list.renderer.js +7 -7
  65. package/dist/node/ui/renderers/index.js +157 -157
  66. package/dist/node/ui/views/AgentListView.js +7 -7
  67. package/dist/node/ui/views/RunListView.js +16 -16
  68. package/dist/node/ui/views/ToolRegistryView.js +9 -9
  69. package/dist/node/ui/views/index.js +97 -97
  70. package/dist/presentations/index.d.ts +3 -5
  71. package/dist/presentations/index.js +4 -4
  72. package/dist/run/index.d.ts +7 -7
  73. package/dist/run/index.js +536 -536
  74. package/dist/run/run.event.js +2 -2
  75. package/dist/run/run.handler.d.ts +3 -0
  76. package/dist/run/run.presentation.js +2 -2
  77. package/dist/shared/index.d.ts +1 -1
  78. package/dist/tool/index.d.ts +7 -7
  79. package/dist/tool/index.js +260 -260
  80. package/dist/tool/tool.event.js +1 -1
  81. package/dist/tool/tool.handler.d.ts +1 -1
  82. package/dist/tool/tool.presentation.js +2 -2
  83. package/dist/ui/AgentDashboard.js +956 -956
  84. package/dist/ui/AgentRunList.js +16 -16
  85. package/dist/ui/AgentToolRegistry.js +9 -9
  86. package/dist/ui/hooks/index.d.ts +4 -4
  87. package/dist/ui/hooks/index.js +153 -153
  88. package/dist/ui/hooks/useAgentList.d.ts +5 -0
  89. package/dist/ui/hooks/useAgentList.js +1 -1
  90. package/dist/ui/hooks/useAgentMutations.d.ts +9 -2
  91. package/dist/ui/hooks/useAgentMutations.js +1 -1
  92. package/dist/ui/hooks/useRunList.d.ts +5 -0
  93. package/dist/ui/hooks/useRunList.js +1 -1
  94. package/dist/ui/hooks/useToolList.d.ts +5 -0
  95. package/dist/ui/hooks/useToolList.js +1 -1
  96. package/dist/ui/index.d.ts +3 -3
  97. package/dist/ui/index.js +1222 -1222
  98. package/dist/ui/modals/AgentActionsModal.js +13 -13
  99. package/dist/ui/modals/CreateAgentModal.js +15 -15
  100. package/dist/ui/modals/index.d.ts +1 -1
  101. package/dist/ui/modals/index.js +297 -297
  102. package/dist/ui/renderers/agent-list.markdown.d.ts +5 -0
  103. package/dist/ui/renderers/agent-list.renderer.js +7 -7
  104. package/dist/ui/renderers/dashboard.markdown.d.ts +5 -0
  105. package/dist/ui/renderers/index.d.ts +2 -2
  106. package/dist/ui/renderers/index.js +157 -157
  107. package/dist/ui/renderers/run-list.markdown.d.ts +5 -0
  108. package/dist/ui/renderers/tool-registry.markdown.d.ts +5 -0
  109. package/dist/ui/views/AgentListView.js +7 -7
  110. package/dist/ui/views/RunListView.js +16 -16
  111. package/dist/ui/views/ToolRegistryView.js +9 -9
  112. package/dist/ui/views/index.js +97 -97
  113. package/package.json +10 -10
  114. package/src/agent/agent.entity.ts +111 -111
  115. package/src/agent/agent.enum.ts +12 -12
  116. package/src/agent/agent.event.ts +91 -91
  117. package/src/agent/agent.handler.ts +123 -123
  118. package/src/agent/agent.operation.ts +400 -400
  119. package/src/agent/agent.presentation.ts +62 -62
  120. package/src/agent/agent.schema.ts +175 -175
  121. package/src/agent/agent.test-spec.ts +48 -48
  122. package/src/agent/index.ts +46 -51
  123. package/src/agent.capability.ts +11 -11
  124. package/src/agent.feature.ts +131 -131
  125. package/src/docs/agent-console.docblock.ts +42 -42
  126. package/src/example.ts +35 -35
  127. package/src/handlers/agent.handlers.ts +522 -521
  128. package/src/handlers/index.ts +12 -12
  129. package/src/index.ts +8 -9
  130. package/src/presentations/index.ts +11 -13
  131. package/src/run/index.ts +49 -54
  132. package/src/run/run.entity.ts +137 -137
  133. package/src/run/run.enum.ts +18 -18
  134. package/src/run/run.event.ts +174 -174
  135. package/src/run/run.handler.ts +92 -91
  136. package/src/run/run.operation.ts +474 -474
  137. package/src/run/run.presentation.ts +42 -42
  138. package/src/run/run.schema.ts +126 -126
  139. package/src/run/run.test-spec.ts +48 -48
  140. package/src/seeders/index.ts +21 -21
  141. package/src/shared/index.ts +1 -1
  142. package/src/shared/mock-agents.ts +76 -76
  143. package/src/shared/mock-runs.ts +102 -102
  144. package/src/shared/mock-tools.ts +140 -140
  145. package/src/shared/overlay-types.ts +23 -23
  146. package/src/tool/index.ts +39 -44
  147. package/src/tool/tool.entity.ts +73 -73
  148. package/src/tool/tool.enum.ts +13 -13
  149. package/src/tool/tool.event.ts +80 -80
  150. package/src/tool/tool.handler.ts +102 -102
  151. package/src/tool/tool.operation.ts +328 -328
  152. package/src/tool/tool.presentation.ts +43 -43
  153. package/src/tool/tool.schema.ts +106 -106
  154. package/src/tool/tool.test-spec.ts +48 -48
  155. package/src/ui/AgentDashboard.tsx +348 -348
  156. package/src/ui/hooks/index.ts +7 -7
  157. package/src/ui/hooks/useAgentList.ts +57 -56
  158. package/src/ui/hooks/useAgentMutations.ts +160 -159
  159. package/src/ui/hooks/useRunList.ts +58 -57
  160. package/src/ui/hooks/useToolList.ts +102 -101
  161. package/src/ui/index.ts +6 -9
  162. package/src/ui/modals/AgentActionsModal.tsx +262 -262
  163. package/src/ui/modals/CreateAgentModal.tsx +232 -232
  164. package/src/ui/modals/index.ts +1 -1
  165. package/src/ui/overlays/demo-overlays.ts +52 -52
  166. package/src/ui/renderers/agent-list.markdown.ts +61 -60
  167. package/src/ui/renderers/agent-list.renderer.tsx +14 -14
  168. package/src/ui/renderers/dashboard.markdown.ts +140 -139
  169. package/src/ui/renderers/index.ts +3 -4
  170. package/src/ui/renderers/run-list.markdown.ts +48 -47
  171. package/src/ui/renderers/tool-registry.markdown.ts +66 -65
  172. package/src/ui/views/AgentListView.tsx +90 -90
  173. package/src/ui/views/RunListView.tsx +141 -141
  174. package/src/ui/views/ToolRegistryView.tsx +113 -113
  175. package/tsconfig.json +7 -8
  176. 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
  }