@contractspec/example.agent-console 3.2.0 → 3.3.0

package/.turbo/turbo-build.log

@@ -3,15 +3,15 @@ $ bun run prebuild && bun run build:bundle && bun run build:types
 $ contractspec-bun-build prebuild
 $ contractspec-bun-build transpile
 [contractspec-bun-build] transpile target=bun root=src entries=66
-Bundled 66 modules in 103ms
+Bundled 66 modules in 87ms
 
   ./agent.capability.js                    442 bytes  (entry point)
   tool/tool.test-spec.js                   1.38 KB    (entry point)
   shared/overlay-types.js                  8 bytes    (entry point)
   run/run.test-spec.js                     1.37 KB    (entry point)
   seeders/index.js                         0.64 KB    (entry point)
-  ./index.js                               200.84 KB  (entry point)
-  ui/index.js                              77.35 KB   (entry point)
+  ./index.js                               202.80 KB  (entry point)
+  ui/index.js                              78.0 KB    (entry point)
   ui/views/index.js                        22.0 KB    (entry point)
   ui/renderers/index.js                    14.75 KB   (entry point)
   ui/renderers/agent-list.markdown.js      1.49 KB    (entry point)
@@ -23,18 +23,18 @@ Bundled 66 modules in 103ms
   ui/modals/index.js                       22.38 KB   (entry point)
   ui/overlays/index.js                     1.46 KB    (entry point)
   ui/overlays/demo-overlays.js             1.46 KB    (entry point)
-  ui/AgentDashboard.js                     62.32 KB   (entry point)
+  ui/AgentDashboard.js                     63.0 KB    (entry point)
   ui/modals/AgentActionsModal.js           12.32 KB   (entry point)
   ui/modals/CreateAgentModal.js            9.99 KB    (entry point)
   ui/AgentRunList.js                       9.39 KB    (entry point)
   ui/views/RunListView.js                  9.33 KB    (entry point)
   ui/AgentToolRegistry.js                  6.99 KB    (entry point)
   ui/views/ToolRegistryView.js             6.92 KB    (entry point)
-  ui/hooks/index.js                        8.61 KB    (entry point)
+  ui/hooks/index.js                        9.30 KB    (entry point)
   ui/hooks/useRunList.js                   1.69 KB    (entry point)
   ui/hooks/useToolList.js                  2.52 KB    (entry point)
   ui/hooks/useAgentList.js                 1.69 KB    (entry point)
-  ui/hooks/useAgentMutations.js            2.50 KB    (entry point)
+  ui/hooks/useAgentMutations.js            3.18 KB    (entry point)
   tool/index.js                            28.61 KB   (entry point)
   tool/tool.entity.js                      2.65 KB    (entry point)
   tool/tool.event.js                       3.25 KB    (entry point)
@@ -56,12 +56,12 @@ Bundled 66 modules in 103ms
   docs/index.js                            3.74 KB    (entry point)
   docs/agent-console.docblock.js           3.74 KB    (entry point)
   ./example.js                             1.25 KB    (entry point)
-  handlers/index.js                        24.39 KB   (entry point)
+  handlers/index.js                        25.34 KB   (entry point)
   tool/tool.handler.js                     6.38 KB    (entry point)
   run/run.handler.js                       7.61 KB    (entry point)
   shared/mock-runs.js                      3.0 KB     (entry point)
-  handlers/agent.handlers.js               8.30 KB    (entry point)
-  ./agent.feature.js                       4.37 KB    (entry point)
+  handlers/agent.handlers.js               9.24 KB    (entry point)
+  ./agent.feature.js                       4.70 KB    (entry point)
   agent/agent.entity.js                    3.92 KB    (entry point)
   agent/agent.handler.js                   8.88 KB    (entry point)
   shared/mock-tools.js                     4.15 KB    (entry point)
@@ -73,15 +73,15 @@ Bundled 66 modules in 103ms
   agent/agent.enum.js                      467 bytes  (entry point)
 
 [contractspec-bun-build] transpile target=node root=src entries=66
-Bundled 66 modules in 130ms
+Bundled 66 modules in 82ms
 
   ./agent.capability.js                    434 bytes  (entry point)
   tool/tool.test-spec.js                   1.38 KB    (entry point)
   shared/overlay-types.js                  0 KB       (entry point)
   run/run.test-spec.js                     1.36 KB    (entry point)
   seeders/index.js                         0.63 KB    (entry point)
-  ./index.js                               200.78 KB  (entry point)
-  ui/index.js                              77.30 KB   (entry point)
+  ./index.js                               202.74 KB  (entry point)
+  ui/index.js                              77.99 KB   (entry point)
   ui/views/index.js                        22.00 KB   (entry point)
   ui/renderers/index.js                    14.73 KB   (entry point)
   ui/renderers/agent-list.markdown.js      1.48 KB    (entry point)
@@ -93,18 +93,18 @@ Bundled 66 modules in 130ms
   ui/modals/index.js                       22.36 KB   (entry point)
   ui/overlays/index.js                     1.45 KB    (entry point)
   ui/overlays/demo-overlays.js             1.45 KB    (entry point)
-  ui/AgentDashboard.js                     62.29 KB   (entry point)
+  ui/AgentDashboard.js                     62.97 KB   (entry point)
   ui/modals/AgentActionsModal.js           12.29 KB   (entry point)
   ui/modals/CreateAgentModal.js            9.99 KB    (entry point)
   ui/AgentRunList.js                       9.38 KB    (entry point)
   ui/views/RunListView.js                  9.32 KB    (entry point)
   ui/AgentToolRegistry.js                  6.97 KB    (entry point)
   ui/views/ToolRegistryView.js             6.91 KB    (entry point)
-  ui/hooks/index.js                        8.60 KB    (entry point)
+  ui/hooks/index.js                        9.29 KB    (entry point)
   ui/hooks/useRunList.js                   1.69 KB    (entry point)
   ui/hooks/useToolList.js                  2.51 KB    (entry point)
   ui/hooks/useAgentList.js                 1.68 KB    (entry point)
-  ui/hooks/useAgentMutations.js            2.49 KB    (entry point)
+  ui/hooks/useAgentMutations.js            3.18 KB    (entry point)
   tool/index.js                            28.60 KB   (entry point)
   tool/tool.entity.js                      2.64 KB    (entry point)
   tool/tool.event.js                       3.24 KB    (entry point)
@@ -126,12 +126,12 @@ Bundled 66 modules in 130ms
   docs/index.js                            3.72 KB    (entry point)
   docs/agent-console.docblock.js           3.72 KB    (entry point)
   ./example.js                             1.24 KB    (entry point)
-  handlers/index.js                        24.39 KB   (entry point)
+  handlers/index.js                        25.33 KB   (entry point)
   tool/tool.handler.js                     6.37 KB    (entry point)
   run/run.handler.js                       7.60 KB    (entry point)
   shared/mock-runs.js                      3.0 KB     (entry point)
-  handlers/agent.handlers.js               8.29 KB    (entry point)
-  ./agent.feature.js                       4.36 KB    (entry point)
+  handlers/agent.handlers.js               9.24 KB    (entry point)
+  ./agent.feature.js                       4.69 KB    (entry point)
   agent/agent.entity.js                    3.92 KB    (entry point)
   agent/agent.handler.js                   8.88 KB    (entry point)
   shared/mock-tools.js                     4.14 KB    (entry point)
@@ -143,15 +143,15 @@ Bundled 66 modules in 130ms
   agent/agent.enum.js                      459 bytes  (entry point)
 
 [contractspec-bun-build] transpile target=browser root=src entries=66
-Bundled 66 modules in 87ms
+Bundled 66 modules in 78ms
 
   ./agent.capability.js                    434 bytes  (entry point)
   tool/tool.test-spec.js                   1.38 KB    (entry point)
   shared/overlay-types.js                  0 KB       (entry point)
   run/run.test-spec.js                     1.36 KB    (entry point)
   seeders/index.js                         0.63 KB    (entry point)
-  ./index.js                               200.78 KB  (entry point)
-  ui/index.js                              77.30 KB   (entry point)
+  ./index.js                               202.74 KB  (entry point)
+  ui/index.js                              77.99 KB   (entry point)
   ui/views/index.js                        22.00 KB   (entry point)
   ui/renderers/index.js                    14.73 KB   (entry point)
   ui/renderers/agent-list.markdown.js      1.48 KB    (entry point)
@@ -163,18 +163,18 @@ Bundled 66 modules in 87ms
   ui/modals/index.js                       22.36 KB   (entry point)
   ui/overlays/index.js                     1.45 KB    (entry point)
   ui/overlays/demo-overlays.js             1.45 KB    (entry point)
-  ui/AgentDashboard.js                     62.29 KB   (entry point)
+  ui/AgentDashboard.js                     62.97 KB   (entry point)
   ui/modals/AgentActionsModal.js           12.29 KB   (entry point)
   ui/modals/CreateAgentModal.js            9.99 KB    (entry point)
   ui/AgentRunList.js                       9.38 KB    (entry point)
   ui/views/RunListView.js                  9.32 KB    (entry point)
   ui/AgentToolRegistry.js                  6.97 KB    (entry point)
   ui/views/ToolRegistryView.js             6.91 KB    (entry point)
-  ui/hooks/index.js                        8.60 KB    (entry point)
+  ui/hooks/index.js                        9.29 KB    (entry point)
   ui/hooks/useRunList.js                   1.69 KB    (entry point)
   ui/hooks/useToolList.js                  2.51 KB    (entry point)
   ui/hooks/useAgentList.js                 1.68 KB    (entry point)
-  ui/hooks/useAgentMutations.js            2.49 KB    (entry point)
+  ui/hooks/useAgentMutations.js            3.18 KB    (entry point)
   tool/index.js                            28.60 KB   (entry point)
   tool/tool.entity.js                      2.64 KB    (entry point)
   tool/tool.event.js                       3.24 KB    (entry point)
@@ -196,12 +196,12 @@ Bundled 66 modules in 87ms
   docs/index.js                            3.72 KB    (entry point)
   docs/agent-console.docblock.js           3.72 KB    (entry point)
   ./example.js                             1.24 KB    (entry point)
-  handlers/index.js                        24.39 KB   (entry point)
+  handlers/index.js                        25.33 KB   (entry point)
   tool/tool.handler.js                     6.37 KB    (entry point)
   run/run.handler.js                       7.60 KB    (entry point)
   shared/mock-runs.js                      3.0 KB     (entry point)
-  handlers/agent.handlers.js               8.29 KB    (entry point)
-  ./agent.feature.js                       4.36 KB    (entry point)
+  handlers/agent.handlers.js               9.24 KB    (entry point)
+  ./agent.feature.js                       4.69 KB    (entry point)
   agent/agent.entity.js                    3.92 KB    (entry point)
   agent/agent.handler.js                   8.88 KB    (entry point)
   shared/mock-tools.js                     4.14 KB    (entry point)

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @contractspec/example.agent-console
 
+## 3.3.0
+
+### Minor Changes
+
+- 890a0da: fix: stability improvements
+
+### Patch Changes
+
+- Updated dependencies [890a0da]
+  - @contractspec/lib.example-shared-ui@3.3.0
+  - @contractspec/lib.runtime-sandbox@2.3.0
+  - @contractspec/lib.contracts-spec@3.3.0
+  - @contractspec/lib.design-system@3.3.0
+  - @contractspec/lib.schema@3.3.0
+
 ## 3.2.0
 
 ### Minor Changes

package/dist/agent.feature.js

@@ -112,7 +112,15 @@ var AgentConsoleFeature = defineFeature({
       { key: "jobs", version: "1.0.0" }
     ],
     provides: [{ key: "agent", version: "1.0.0" }]
-  }
+  },
+  telemetry: [{ key: "agent-console.telemetry", version: "1.0.0" }],
+  jobs: [{ key: "agent-console.job.run-execution", version: "1.0.0" }],
+  docs: [
+    "docs.examples.agent-console.goal",
+    "docs.examples.agent-console.usage",
+    "docs.examples.agent-console.reference",
+    "docs.examples.agent-console.constraints"
+  ]
 });
 export {
   AgentConsoleFeature

package/dist/browser/agent.feature.js

@@ -111,7 +111,15 @@ var AgentConsoleFeature = defineFeature({
       { key: "jobs", version: "1.0.0" }
     ],
     provides: [{ key: "agent", version: "1.0.0" }]
-  }
+  },
+  telemetry: [{ key: "agent-console.telemetry", version: "1.0.0" }],
+  jobs: [{ key: "agent-console.job.run-execution", version: "1.0.0" }],
+  docs: [
+    "docs.examples.agent-console.goal",
+    "docs.examples.agent-console.usage",
+    "docs.examples.agent-console.reference",
+    "docs.examples.agent-console.constraints"
+  ]
 });
 export {
   AgentConsoleFeature

package/dist/browser/handlers/agent.handlers.js

@@ -237,11 +237,28 @@ function createAgentHandlers(db) {
       totalCostUsd: data?.totalCost ?? 0
     };
   }
+  async function executeAgent(input) {
+    const agent = await getAgent(input.agentId);
+    if (!agent)
+      throw new Error("AGENT_NOT_FOUND");
+    if (agent.status !== "ACTIVE")
+      throw new Error("AGENT_NOT_ACTIVE");
+    const id = generateId("run");
+    const now = new Date().toISOString();
+    const pid = input.context?.projectId ?? agent.projectId;
+    await db.execute(`INSERT INTO agent_run (id, projectId, agentId, status, input, totalTokens, promptTokens, completionTokens, estimatedCostUsd, queuedAt)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [id, pid, input.agentId, "QUEUED", input.message, 0, 0, 0, 0, now]);
+    const rows = (await db.query(`SELECT r.*, a.name as agentName FROM agent_run r LEFT JOIN agent_definition a ON r.agentId = a.id WHERE r.id = ?`, [id])).rows;
+    if (!rows[0])
+      throw new Error("Failed to retrieve created run");
+    return rowToRun(rows[0], rows[0].agentName);
+  }
   return {
     listAgents,
     getAgent,
     createAgent,
     updateAgent,
+    executeAgent,
     listTools,
     listRuns,
     getRunMetrics

package/dist/browser/handlers/index.js

@@ -533,11 +533,28 @@ function createAgentHandlers(db) {
       totalCostUsd: data?.totalCost ?? 0
     };
   }
+  async function executeAgent(input) {
+    const agent = await getAgent(input.agentId);
+    if (!agent)
+      throw new Error("AGENT_NOT_FOUND");
+    if (agent.status !== "ACTIVE")
+      throw new Error("AGENT_NOT_ACTIVE");
+    const id = generateId("run");
+    const now = new Date().toISOString();
+    const pid = input.context?.projectId ?? agent.projectId;
+    await db.execute(`INSERT INTO agent_run (id, projectId, agentId, status, input, totalTokens, promptTokens, completionTokens, estimatedCostUsd, queuedAt)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [id, pid, input.agentId, "QUEUED", input.message, 0, 0, 0, 0, now]);
+    const rows = (await db.query(`SELECT r.*, a.name as agentName FROM agent_run r LEFT JOIN agent_definition a ON r.agentId = a.id WHERE r.id = ?`, [id])).rows;
+    if (!rows[0])
+      throw new Error("Failed to retrieve created run");
+    return rowToRun(rows[0], rows[0].agentName);
+  }
   return {
     listAgents,
     getAgent,
     createAgent,
     updateAgent,
+    executeAgent,
     listTools,
     listRuns,
     getRunMetrics

package/dist/browser/index.js

@@ -111,7 +111,15 @@ var AgentConsoleFeature = defineFeature({
       { key: "jobs", version: "1.0.0" }
     ],
     provides: [{ key: "agent", version: "1.0.0" }]
-  }
+  },
+  telemetry: [{ key: "agent-console.telemetry", version: "1.0.0" }],
+  jobs: [{ key: "agent-console.job.run-execution", version: "1.0.0" }],
+  docs: [
+    "docs.examples.agent-console.goal",
+    "docs.examples.agent-console.usage",
+    "docs.examples.agent-console.reference",
+    "docs.examples.agent-console.constraints"
+  ]
 });
 
 // src/agent/agent.entity.ts
@@ -1701,11 +1709,28 @@ function createAgentHandlers(db) {
       totalCostUsd: data?.totalCost ?? 0
     };
   }
+  async function executeAgent(input) {
+    const agent = await getAgent(input.agentId);
+    if (!agent)
+      throw new Error("AGENT_NOT_FOUND");
+    if (agent.status !== "ACTIVE")
+      throw new Error("AGENT_NOT_ACTIVE");
+    const id = generateId("run");
+    const now = new Date().toISOString();
+    const pid = input.context?.projectId ?? agent.projectId;
+    await db.execute(`INSERT INTO agent_run (id, projectId, agentId, status, input, totalTokens, promptTokens, completionTokens, estimatedCostUsd, queuedAt)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [id, pid, input.agentId, "QUEUED", input.message, 0, 0, 0, 0, now]);
+    const rows = (await db.query(`SELECT r.*, a.name as agentName FROM agent_run r LEFT JOIN agent_definition a ON r.agentId = a.id WHERE r.id = ?`, [id])).rows;
+    if (!rows[0])
+      throw new Error("Failed to retrieve created run");
+    return rowToRun(rows[0], rows[0].agentName);
+  }
   return {
     listAgents,
     getAgent,
     createAgent,
     updateAgent,
+    executeAgent,
     listTools,
     listRuns,
     getRunMetrics
@@ -4248,6 +4273,11 @@ function useAgentMutations(options = {}) {
     error: null,
     data: null
   });
+  const [executeState, setExecuteState] = useState4({
+    loading: false,
+    error: null,
+    data: null
+  });
   const createAgent = useCallback4(async (input) => {
     setCreateState({ loading: true, error: null, data: null });
     try {
@@ -4289,10 +4319,23 @@ function useAgentMutations(options = {}) {
     return updateAgent({ id: agentId, status: "ARCHIVED" });
   }, [updateAgent]);
   const executeAgent = useCallback4(async (input) => {
-    console.log("Execute agent:", input);
-    options.onSuccess?.();
-    return null;
-  }, [options]);
+    setExecuteState({ loading: true, error: null, data: null });
+    try {
+      const result = await agent.executeAgent({
+        agentId: input.agentId,
+        message: input.message,
+        context: { projectId, organizationId: "demo-org" }
+      });
+      setExecuteState({ loading: false, error: null, data: result });
+      options.onSuccess?.();
+      return result;
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error("Failed to execute agent");
+      setExecuteState({ loading: false, error, data: null });
+      options.onError?.(error);
+      return null;
+    }
+  }, [agent, projectId, options]);
   return {
     createAgent,
     updateAgent,
@@ -4302,7 +4345,8 @@ function useAgentMutations(options = {}) {
     executeAgent,
     createState,
     updateState,
-    isLoading: createState.loading || updateState.loading
+    executeState,
+    isLoading: createState.loading || updateState.loading || executeState.loading
   };
 }
 

package/dist/browser/ui/AgentDashboard.js

@@ -519,6 +519,11 @@ function useAgentMutations(options = {}) {
     error: null,
     data: null
   });
+  const [executeState, setExecuteState] = useState4({
+    loading: false,
+    error: null,
+    data: null
+  });
   const createAgent = useCallback4(async (input) => {
     setCreateState({ loading: true, error: null, data: null });
     try {
@@ -560,10 +565,23 @@ function useAgentMutations(options = {}) {
     return updateAgent({ id: agentId, status: "ARCHIVED" });
   }, [updateAgent]);
   const executeAgent = useCallback4(async (input) => {
-    console.log("Execute agent:", input);
-    options.onSuccess?.();
-    return null;
-  }, [options]);
+    setExecuteState({ loading: true, error: null, data: null });
+    try {
+      const result = await agent.executeAgent({
+        agentId: input.agentId,
+        message: input.message,
+        context: { projectId, organizationId: "demo-org" }
+      });
+      setExecuteState({ loading: false, error: null, data: result });
+      options.onSuccess?.();
+      return result;
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error("Failed to execute agent");
+      setExecuteState({ loading: false, error, data: null });
+      options.onError?.(error);
+      return null;
+    }
+  }, [agent, projectId, options]);
   return {
     createAgent,
     updateAgent,
@@ -573,7 +591,8 @@ function useAgentMutations(options = {}) {
     executeAgent,
     createState,
     updateState,
-    isLoading: createState.loading || updateState.loading
+    executeState,
+    isLoading: createState.loading || updateState.loading || executeState.loading
   };
 }
 

package/dist/browser/ui/hooks/index.js

@@ -203,6 +203,11 @@ function useAgentMutations(options = {}) {
     error: null,
     data: null
   });
+  const [executeState, setExecuteState] = useState4({
+    loading: false,
+    error: null,
+    data: null
+  });
   const createAgent = useCallback4(async (input) => {
     setCreateState({ loading: true, error: null, data: null });
     try {
@@ -244,10 +249,23 @@ function useAgentMutations(options = {}) {
     return updateAgent({ id: agentId, status: "ARCHIVED" });
   }, [updateAgent]);
   const executeAgent = useCallback4(async (input) => {
-    console.log("Execute agent:", input);
-    options.onSuccess?.();
-    return null;
-  }, [options]);
+    setExecuteState({ loading: true, error: null, data: null });
+    try {
+      const result = await agent.executeAgent({
+        agentId: input.agentId,
+        message: input.message,
+        context: { projectId, organizationId: "demo-org" }
+      });
+      setExecuteState({ loading: false, error: null, data: result });
+      options.onSuccess?.();
+      return result;
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error("Failed to execute agent");
+      setExecuteState({ loading: false, error, data: null });
+      options.onError?.(error);
+      return null;
+    }
+  }, [agent, projectId, options]);
   return {
     createAgent,
     updateAgent,
@@ -257,7 +275,8 @@ function useAgentMutations(options = {}) {
     executeAgent,
     createState,
     updateState,
-    isLoading: createState.loading || updateState.loading
+    executeState,
+    isLoading: createState.loading || updateState.loading || executeState.loading
   };
 }
 

package/dist/browser/ui/hooks/useAgentMutations.js

@@ -14,6 +14,11 @@ function useAgentMutations(options = {}) {
     error: null,
     data: null
   });
+  const [executeState, setExecuteState] = useState({
+    loading: false,
+    error: null,
+    data: null
+  });
   const createAgent = useCallback(async (input) => {
     setCreateState({ loading: true, error: null, data: null });
     try {
@@ -55,10 +60,23 @@ function useAgentMutations(options = {}) {
     return updateAgent({ id: agentId, status: "ARCHIVED" });
   }, [updateAgent]);
   const executeAgent = useCallback(async (input) => {
-    console.log("Execute agent:", input);
-    options.onSuccess?.();
-    return null;
-  }, [options]);
+    setExecuteState({ loading: true, error: null, data: null });
+    try {
+      const result = await agent.executeAgent({
+        agentId: input.agentId,
+        message: input.message,
+        context: { projectId, organizationId: "demo-org" }
+      });
+      setExecuteState({ loading: false, error: null, data: result });
+      options.onSuccess?.();
+      return result;
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error("Failed to execute agent");
+      setExecuteState({ loading: false, error, data: null });
+      options.onError?.(error);
+      return null;
+    }
+  }, [agent, projectId, options]);
   return {
     createAgent,
     updateAgent,
@@ -68,7 +86,8 @@ function useAgentMutations(options = {}) {
     executeAgent,
     createState,
     updateState,
-    isLoading: createState.loading || updateState.loading
+    executeState,
+    isLoading: createState.loading || updateState.loading || executeState.loading
   };
 }
 export {

package/dist/browser/ui/index.js

@@ -519,6 +519,11 @@ function useAgentMutations(options = {}) {
     error: null,
     data: null
   });
+  const [executeState, setExecuteState] = useState4({
+    loading: false,
+    error: null,
+    data: null
+  });
   const createAgent = useCallback4(async (input) => {
     setCreateState({ loading: true, error: null, data: null });
     try {
@@ -560,10 +565,23 @@ function useAgentMutations(options = {}) {
     return updateAgent({ id: agentId, status: "ARCHIVED" });
   }, [updateAgent]);
   const executeAgent = useCallback4(async (input) => {
-    console.log("Execute agent:", input);
-    options.onSuccess?.();
-    return null;
-  }, [options]);
+    setExecuteState({ loading: true, error: null, data: null });
+    try {
+      const result = await agent.executeAgent({
+        agentId: input.agentId,
+        message: input.message,
+        context: { projectId, organizationId: "demo-org" }
+      });
+      setExecuteState({ loading: false, error: null, data: result });
+      options.onSuccess?.();
+      return result;
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error("Failed to execute agent");
+      setExecuteState({ loading: false, error, data: null });
+      options.onError?.(error);
+      return null;
+    }
+  }, [agent, projectId, options]);
   return {
     createAgent,
     updateAgent,
@@ -573,7 +591,8 @@ function useAgentMutations(options = {}) {
     executeAgent,
     createState,
     updateState,
-    isLoading: createState.loading || updateState.loading
+    executeState,
+    isLoading: createState.loading || updateState.loading || executeState.loading
   };
 }
 

package/dist/handlers/agent.handlers.d.ts

@@ -122,6 +122,14 @@ export declare function createAgentHandlers(db: DatabasePort): {
         organizationId: string;
     }) => Promise<Agent>;
     updateAgent: (input: UpdateAgentInput) => Promise<Agent>;
+    executeAgent: (input: {
+        agentId: string;
+        message: string;
+        context?: {
+            projectId: string;
+            organizationId: string;
+        };
+    }) => Promise<Run>;
     listTools: (input: ListToolsInput) => Promise<ListToolsOutput>;
     listRuns: (input: ListRunsInput) => Promise<ListRunsOutput>;
     getRunMetrics: (input: {

package/dist/handlers/agent.handlers.js

@@ -238,11 +238,28 @@ function createAgentHandlers(db) {
       totalCostUsd: data?.totalCost ?? 0
     };
   }
+  async function executeAgent(input) {
+    const agent = await getAgent(input.agentId);
+    if (!agent)
+      throw new Error("AGENT_NOT_FOUND");
+    if (agent.status !== "ACTIVE")
+      throw new Error("AGENT_NOT_ACTIVE");
+    const id = generateId("run");
+    const now = new Date().toISOString();
+    const pid = input.context?.projectId ?? agent.projectId;
+    await db.execute(`INSERT INTO agent_run (id, projectId, agentId, status, input, totalTokens, promptTokens, completionTokens, estimatedCostUsd, queuedAt)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [id, pid, input.agentId, "QUEUED", input.message, 0, 0, 0, 0, now]);
+    const rows = (await db.query(`SELECT r.*, a.name as agentName FROM agent_run r LEFT JOIN agent_definition a ON r.agentId = a.id WHERE r.id = ?`, [id])).rows;
+    if (!rows[0])
+      throw new Error("Failed to retrieve created run");
+    return rowToRun(rows[0], rows[0].agentName);
+  }
   return {
     listAgents,
     getAgent,
     createAgent,
     updateAgent,
+    executeAgent,
     listTools,
     listRuns,
     getRunMetrics

package/dist/handlers/index.js

@@ -534,11 +534,28 @@ function createAgentHandlers(db) {
       totalCostUsd: data?.totalCost ?? 0
     };
   }
+  async function executeAgent(input) {
+    const agent = await getAgent(input.agentId);
+    if (!agent)
+      throw new Error("AGENT_NOT_FOUND");
+    if (agent.status !== "ACTIVE")
+      throw new Error("AGENT_NOT_ACTIVE");
+    const id = generateId("run");
+    const now = new Date().toISOString();
+    const pid = input.context?.projectId ?? agent.projectId;
+    await db.execute(`INSERT INTO agent_run (id, projectId, agentId, status, input, totalTokens, promptTokens, completionTokens, estimatedCostUsd, queuedAt)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [id, pid, input.agentId, "QUEUED", input.message, 0, 0, 0, 0, now]);
+    const rows = (await db.query(`SELECT r.*, a.name as agentName FROM agent_run r LEFT JOIN agent_definition a ON r.agentId = a.id WHERE r.id = ?`, [id])).rows;
+    if (!rows[0])
+      throw new Error("Failed to retrieve created run");
+    return rowToRun(rows[0], rows[0].agentName);
+  }
   return {
     listAgents,
     getAgent,
     createAgent,
     updateAgent,
+    executeAgent,
     listTools,
     listRuns,
     getRunMetrics