@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
@@ -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';