@contractspec/example.agent-console 3.1.1 → 3.3.0

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

package/dist/index.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"
+  ]
 });
 
 // src/agent/agent.entity.ts
@@ -1702,11 +1710,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
@@ -4249,6 +4274,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 {
@@ -4290,10 +4320,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,
@@ -4303,7 +4346,8 @@ function useAgentMutations(options = {}) {
     executeAgent,
     createState,
     updateState,
-    isLoading: createState.loading || updateState.loading
+    executeState,
+    isLoading: createState.loading || updateState.loading || executeState.loading
   };
 }
 

package/dist/node/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/node/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/node/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/node/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/node/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/node/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/node/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/node/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/ui/AgentDashboard.js

@@ -520,6 +520,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 {
@@ -561,10 +566,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,
@@ -574,7 +592,8 @@ function useAgentMutations(options = {}) {
     executeAgent,
     createState,
     updateState,
-    isLoading: createState.loading || updateState.loading
+    executeState,
+    isLoading: createState.loading || updateState.loading || executeState.loading
   };
 }
 

package/dist/ui/hooks/index.js

@@ -204,6 +204,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 {
@@ -245,10 +250,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,
@@ -258,7 +276,8 @@ function useAgentMutations(options = {}) {
     executeAgent,
     createState,
     updateState,
-    isLoading: createState.loading || updateState.loading
+    executeState,
+    isLoading: createState.loading || updateState.loading || executeState.loading
   };
 }
 

package/dist/ui/hooks/useAgentMutations.d.ts

@@ -1,4 +1,4 @@
-import type { Agent, CreateAgentInput, UpdateAgentInput } from '../../handlers/agent.handlers';
+import type { Agent, Run, CreateAgentInput, UpdateAgentInput } from '../../handlers/agent.handlers';
 export interface MutationState<T> {
     loading: boolean;
     error: Error | null;
@@ -17,9 +17,10 @@ export declare function useAgentMutations(options?: UseAgentMutationsOptions): {
     executeAgent: (input: {
         agentId: string;
         message: string;
-    }) => Promise<null>;
+    }) => Promise<Run | null>;
     createState: MutationState<Agent>;
     updateState: MutationState<Agent>;
+    executeState: MutationState<Run>;
     isLoading: boolean;
 };
-export type { CreateAgentInput, UpdateAgentInput, Agent };
+export type { CreateAgentInput, UpdateAgentInput, Agent, Run };

package/dist/ui/hooks/useAgentMutations.js

@@ -15,6 +15,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 {
@@ -56,10 +61,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,
@@ -69,7 +87,8 @@ function useAgentMutations(options = {}) {
     executeAgent,
     createState,
     updateState,
-    isLoading: createState.loading || updateState.loading
+    executeState,
+    isLoading: createState.loading || updateState.loading || executeState.loading
   };
 }
 export {