@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
@@ -3,12 +3,13 @@
3
3
  *
4
4
  * Uses runtime-local database-backed handlers.
5
5
  */
6
- import { useCallback, useEffect, useMemo, useState } from 'react';
6
+
7
7
  import { useTemplateRuntime } from '@contractspec/lib.example-shared-ui';
8
+ import { useCallback, useEffect, useMemo, useState } from 'react';
8
9
  import type {
9
- ListToolsOutput as RuntimeListToolsOutput,
10
- Tool as RuntimeTool,
11
- AgentHandlers,
10
+ AgentHandlers,
11
+ ListToolsOutput as RuntimeListToolsOutput,
12
+ Tool as RuntimeTool,
12
13
  } from '../../handlers/agent.handlers';
13
14
 
14
15
  // Re-export types for convenience
@@ -19,104 +20,104 @@ export type ToolCategory = Tool['category'];
19
20
  export type ToolStatus = Tool['status'];
20
21
 
21
22
  export interface UseToolListOptions {
22
- search?: string;
23
- category?: ToolCategory;
24
- status?: ToolStatus | 'all';
25
- limit?: number;
23
+ search?: string;
24
+ category?: ToolCategory;
25
+ status?: ToolStatus | 'all';
26
+ limit?: number;
26
27
  }
27
28
 
28
29
  export function useToolList(options: UseToolListOptions = {}) {
29
- const { handlers, projectId } = useTemplateRuntime<{
30
- agent: AgentHandlers;
31
- }>();
32
- const { agent } = handlers;
33
-
34
- const [data, setData] = useState<ListToolsOutput | null>(null);
35
- const [loading, setLoading] = useState(true);
36
- const [error, setError] = useState<Error | null>(null);
37
- const [page, setPage] = useState(1);
38
-
39
- const fetchData = useCallback(async () => {
40
- setLoading(true);
41
- setError(null);
42
-
43
- try {
44
- const result = await agent.listTools({
45
- projectId,
46
- search: options.search,
47
- category: options.category,
48
- status: options.status === 'all' ? undefined : options.status,
49
- limit: options.limit ?? 50,
50
- offset: (page - 1) * (options.limit ?? 50),
51
- });
52
- setData(result);
53
- } catch (err) {
54
- setError(err instanceof Error ? err : new Error('Unknown error'));
55
- } finally {
56
- setLoading(false);
57
- }
58
- }, [
59
- agent,
60
- projectId,
61
- options.search,
62
- options.category,
63
- options.status,
64
- options.limit,
65
- page,
66
- ]);
67
-
68
- useEffect(() => {
69
- fetchData();
70
- }, [fetchData]);
71
-
72
- // Calculate stats and grouping
73
- const { stats, groupedByCategory, categoryStats } = useMemo(() => {
74
- if (!data) return { stats: null, groupedByCategory: {}, categoryStats: [] };
75
- const items = data.items;
76
-
77
- const active = items.filter((t) => t.status === 'ACTIVE').length;
78
- const deprecated = items.filter((t) => t.status === 'DEPRECATED').length;
79
- const disabled = items.filter((t) => t.status === 'DISABLED').length;
80
-
81
- // Group by category
82
- const grouped: Record<string, Tool[]> = {};
83
- const byCategory: Record<string, number> = {};
84
-
85
- items.forEach((t) => {
86
- const cat = t.category;
87
- if (!grouped[cat]) grouped[cat] = [];
88
- grouped[cat].push(t);
89
- byCategory[cat] = (byCategory[cat] || 0) + 1;
90
- });
91
-
92
- // Category stats sorted by count
93
- const catStats = Object.entries(byCategory)
94
- .map(([category, count]) => ({ category, count }))
95
- .sort((a, b) => b.count - a.count);
96
-
97
- return {
98
- stats: {
99
- total: data.total,
100
- active,
101
- deprecated,
102
- disabled,
103
- topCategories: catStats.slice(0, 5),
104
- },
105
- groupedByCategory: grouped,
106
- categoryStats: catStats,
107
- };
108
- }, [data]);
109
-
110
- return {
111
- data,
112
- loading,
113
- error,
114
- stats,
115
- groupedByCategory,
116
- categoryStats,
117
- page,
118
- refetch: fetchData,
119
- nextPage: () => setPage((p) => p + 1),
120
- prevPage: () => page > 1 && setPage((p) => p - 1),
121
- };
30
+ const { handlers, projectId } = useTemplateRuntime<{
31
+ agent: AgentHandlers;
32
+ }>();
33
+ const { agent } = handlers;
34
+
35
+ const [data, setData] = useState<ListToolsOutput | null>(null);
36
+ const [loading, setLoading] = useState(true);
37
+ const [error, setError] = useState<Error | null>(null);
38
+ const [page, setPage] = useState(1);
39
+
40
+ const fetchData = useCallback(async () => {
41
+ setLoading(true);
42
+ setError(null);
43
+
44
+ try {
45
+ const result = await agent.listTools({
46
+ projectId,
47
+ search: options.search,
48
+ category: options.category,
49
+ status: options.status === 'all' ? undefined : options.status,
50
+ limit: options.limit ?? 50,
51
+ offset: (page - 1) * (options.limit ?? 50),
52
+ });
53
+ setData(result);
54
+ } catch (err) {
55
+ setError(err instanceof Error ? err : new Error('Unknown error'));
56
+ } finally {
57
+ setLoading(false);
58
+ }
59
+ }, [
60
+ agent,
61
+ projectId,
62
+ options.search,
63
+ options.category,
64
+ options.status,
65
+ options.limit,
66
+ page,
67
+ ]);
68
+
69
+ useEffect(() => {
70
+ fetchData();
71
+ }, [fetchData]);
72
+
73
+ // Calculate stats and grouping
74
+ const { stats, groupedByCategory, categoryStats } = useMemo(() => {
75
+ if (!data) return { stats: null, groupedByCategory: {}, categoryStats: [] };
76
+ const items = data.items;
77
+
78
+ const active = items.filter((t) => t.status === 'ACTIVE').length;
79
+ const deprecated = items.filter((t) => t.status === 'DEPRECATED').length;
80
+ const disabled = items.filter((t) => t.status === 'DISABLED').length;
81
+
82
+ // Group by category
83
+ const grouped: Record<string, Tool[]> = {};
84
+ const byCategory: Record<string, number> = {};
85
+
86
+ items.forEach((t) => {
87
+ const cat = t.category;
88
+ if (!grouped[cat]) grouped[cat] = [];
89
+ grouped[cat].push(t);
90
+ byCategory[cat] = (byCategory[cat] || 0) + 1;
91
+ });
92
+
93
+ // Category stats sorted by count
94
+ const catStats = Object.entries(byCategory)
95
+ .map(([category, count]) => ({ category, count }))
96
+ .sort((a, b) => b.count - a.count);
97
+
98
+ return {
99
+ stats: {
100
+ total: data.total,
101
+ active,
102
+ deprecated,
103
+ disabled,
104
+ topCategories: catStats.slice(0, 5),
105
+ },
106
+ groupedByCategory: grouped,
107
+ categoryStats: catStats,
108
+ };
109
+ }, [data]);
110
+
111
+ return {
112
+ data,
113
+ loading,
114
+ error,
115
+ stats,
116
+ groupedByCategory,
117
+ categoryStats,
118
+ page,
119
+ refetch: fetchData,
120
+ nextPage: () => setPage((p) => p + 1),
121
+ prevPage: () => page > 1 && setPage((p) => p - 1),
122
+ };
122
123
  }
package/src/ui/index.ts CHANGED
@@ -4,18 +4,15 @@ export * from './AgentDashboard';
4
4
  // Backward-compatible exports
5
5
  export * from './AgentRunList';
6
6
  export * from './AgentToolRegistry';
7
-
8
- // View components
9
- export * from './views';
7
+ // Data hooks
8
+ export * from './hooks';
10
9
 
11
10
  // Modals
12
11
  export * from './modals';
13
-
14
- // Data hooks
15
- export * from './hooks';
12
+ // Overlays
13
+ export * from './overlays';
16
14
 
17
15
  // Renderers
18
16
  export * from './renderers';
19
-
20
- // Overlays
21
- export * from './overlays';
17
+ // View components
18
+ export * from './views';