@contractspec/example.agent-console 3.7.7 → 3.8.2

package/dist/shared/demo-dashboard-data.d.ts

@@ -0,0 +1,16 @@
+import type { AgentHandlers } from '../handlers/agent.handlers';
+export interface AgentConsoleDashboardData {
+    agents: Awaited<ReturnType<AgentHandlers['listAgents']>>['items'];
+    runs: Awaited<ReturnType<AgentHandlers['listRuns']>>['items'];
+    tools: Awaited<ReturnType<AgentHandlers['listTools']>>['items'];
+    summary: {
+        totalAgents: number;
+        totalRuns: number;
+        totalTools: number;
+    };
+}
+export declare function getAgentConsoleDashboardData(handlers: AgentHandlers, params: {
+    projectId: string;
+    organizationId?: string;
+}): Promise<AgentConsoleDashboardData>;
+export declare function getFallbackAgentConsoleDashboardData(): Promise<AgentConsoleDashboardData>;

package/dist/shared/demo-runtime-seed.d.ts

@@ -0,0 +1,17 @@
+import type { Agent, Run, RunMetrics, Tool } from '../handlers/agent.handlers';
+export declare const AGENT_CONSOLE_DEMO_ORGANIZATION_ID = "demo-org";
+export declare const AGENT_CONSOLE_DEMO_PROJECT_ID = "agent-console-demo";
+export type DemoAgentRecord = Agent & {
+    slug: string;
+};
+export declare function slugify(name: string): string;
+export declare function cloneAgent(agent: DemoAgentRecord): Agent;
+export declare function cloneTool(tool: Tool): Tool;
+export declare function cloneRun(run: Run): Run;
+export declare function createDefaultNow(): () => Date;
+export declare function createSeedState(projectId: string, organizationId: string): {
+    agents: DemoAgentRecord[];
+    tools: Tool[];
+    runs: Run[];
+};
+export declare function summarizeRunMetrics(runs: Run[]): RunMetrics;

package/dist/shared/demo-runtime.d.ts

@@ -0,0 +1,8 @@
+import type { AgentHandlers } from '../handlers/agent.handlers';
+export interface AgentConsoleDemoRuntimeOptions {
+    projectId: string;
+    organizationId?: string;
+    now?: () => Date;
+    idFactory?: (kind: 'agent' | 'run', nextIndex: number) => string;
+}
+export declare function createAgentConsoleDemoHandlers(options: AgentConsoleDemoRuntimeOptions): AgentHandlers;

package/dist/shared/demo-runtime.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/shared/index.d.ts

@@ -1,6 +1,9 @@
 /**
  * Shared utilities and mock data.
  */
+export { type AgentConsoleDashboardData, getAgentConsoleDashboardData, getFallbackAgentConsoleDashboardData, } from './demo-dashboard-data';
+export { createAgentConsoleDemoHandlers } from './demo-runtime';
+export { AGENT_CONSOLE_DEMO_ORGANIZATION_ID, AGENT_CONSOLE_DEMO_PROJECT_ID, } from './demo-runtime-seed';
 export { MOCK_AGENTS } from './mock-agents';
 export { MOCK_RUNS } from './mock-runs';
 export { MOCK_TOOLS } from './mock-tools';

package/dist/shared/index.js

@@ -228,6 +228,7 @@ var MOCK_RUNS = [
   {
     id: "run-1",
     organizationId: "demo-org",
+    projectId: "demo-project",
     agentId: "agent-1",
     agentName: "Customer Support Bot",
     userId: "user-1",
@@ -250,6 +251,7 @@ var MOCK_RUNS = [
   {
     id: "run-2",
     organizationId: "demo-org",
+    projectId: "demo-project",
     agentId: "agent-2",
     agentName: "Code Review Assistant",
     userId: "user-2",
@@ -267,6 +269,7 @@ var MOCK_RUNS = [
   {
     id: "run-3",
     organizationId: "demo-org",
+    projectId: "demo-project",
     agentId: "agent-1",
     agentName: "Customer Support Bot",
     userId: "user-1",
@@ -288,6 +291,7 @@ var MOCK_RUNS = [
   {
     id: "run-4",
     organizationId: "demo-org",
+    projectId: "demo-project",
     agentId: "agent-3",
     agentName: "Data Analyst",
     userId: "user-3",
@@ -309,6 +313,7 @@ var MOCK_RUNS = [
   {
     id: "run-5",
     organizationId: "demo-org",
+    projectId: "demo-project",
     agentId: "agent-2",
     agentName: "Code Review Assistant",
     userId: "user-2",
@@ -328,8 +333,295 @@ var MOCK_RUNS = [
     logs: []
   }
 ];
+
+// src/shared/demo-runtime-seed.ts
+var AGENT_CONSOLE_DEMO_ORGANIZATION_ID = "demo-org";
+var AGENT_CONSOLE_DEMO_PROJECT_ID = "agent-console-demo";
+function slugify(name) {
+  return name.toLowerCase().trim().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+function cloneAgent(agent) {
+  return { ...agent };
+}
+function cloneTool(tool) {
+  return { ...tool };
+}
+function cloneRun(run) {
+  return { ...run };
+}
+function createDefaultNow() {
+  let tick = 0;
+  const base = Date.parse("2026-03-20T09:00:00.000Z");
+  return () => new Date(base + tick++ * 60000);
+}
+function normalizeProvider(provider) {
+  return provider.toLowerCase();
+}
+function normalizeRunStatus(status) {
+  return status === "IN_PROGRESS" ? "RUNNING" : status;
+}
+function createSeedState(projectId, organizationId) {
+  const agents = MOCK_AGENTS.map((agent) => ({
+    id: agent.id,
+    projectId,
+    organizationId,
+    name: agent.name,
+    slug: agent.slug,
+    description: agent.description,
+    modelProvider: normalizeProvider(agent.modelProvider),
+    modelName: agent.modelName,
+    systemPrompt: agent.systemPrompt,
+    temperature: typeof agent.modelConfig?.temperature === "number" ? agent.modelConfig.temperature : 0.4,
+    maxTokens: 8192,
+    status: agent.status,
+    createdAt: agent.createdAt,
+    updatedAt: agent.updatedAt
+  }));
+  const tools = MOCK_TOOLS.map((tool) => ({
+    id: tool.id,
+    projectId,
+    organizationId,
+    name: tool.name,
+    description: tool.description,
+    version: tool.version,
+    category: tool.category,
+    status: tool.status,
+    inputSchema: JSON.stringify(tool.parametersSchema),
+    outputSchema: tool.outputSchema ? JSON.stringify(tool.outputSchema) : undefined,
+    endpoint: typeof tool.implementationConfig?.url === "string" ? tool.implementationConfig.url : undefined,
+    createdAt: tool.createdAt,
+    updatedAt: tool.updatedAt
+  }));
+  const agentNames = new Map(agents.map((agent) => [agent.id, agent.name]));
+  const runs = MOCK_RUNS.map((run) => ({
+    id: run.id,
+    projectId,
+    agentId: run.agentId,
+    agentName: agentNames.get(run.agentId) ?? run.agentName ?? "Unknown agent",
+    status: normalizeRunStatus(run.status),
+    input: JSON.stringify(run.input),
+    output: run.output ? JSON.stringify(run.output) : undefined,
+    totalTokens: run.totalTokens,
+    promptTokens: run.promptTokens,
+    completionTokens: run.completionTokens,
+    estimatedCostUsd: run.estimatedCostUsd ?? 0,
+    durationMs: run.durationMs,
+    errorMessage: run.errorMessage,
+    queuedAt: run.queuedAt,
+    startedAt: run.startedAt,
+    completedAt: run.completedAt
+  }));
+  return { agents, tools, runs };
+}
+function summarizeRunMetrics(runs) {
+  const totalRuns = runs.length;
+  const completedRuns = runs.filter((run) => run.status === "COMPLETED").length;
+  const completedDurations = runs.map((run) => run.durationMs).filter((duration) => typeof duration === "number");
+  return {
+    totalRuns,
+    successRate: totalRuns === 0 ? 0 : completedRuns / totalRuns,
+    averageDurationMs: completedDurations.length === 0 ? 0 : Math.round(completedDurations.reduce((sum, duration) => sum + duration, 0) / completedDurations.length),
+    totalTokens: runs.reduce((sum, run) => sum + run.totalTokens, 0),
+    totalCostUsd: runs.reduce((sum, run) => sum + run.estimatedCostUsd, 0)
+  };
+}
+
+// src/shared/demo-runtime.ts
+function createAgentConsoleDemoHandlers(options) {
+  const projectId = options.projectId;
+  const organizationId = options.organizationId ?? AGENT_CONSOLE_DEMO_ORGANIZATION_ID;
+  const now = options.now ?? createDefaultNow();
+  const state = createSeedState(projectId, organizationId);
+  let agentIndex = state.agents.length + 1;
+  let runIndex = state.runs.length + 1;
+  const nextId = (kind) => {
+    const nextIndex = kind === "agent" ? agentIndex++ : runIndex++;
+    return options.idFactory?.(kind, nextIndex) ?? `${kind}-demo-${nextIndex}`;
+  };
+  return {
+    async listAgents(input) {
+      const filtered = state.agents.filter((agent) => agent.projectId === input.projectId).filter((agent) => !input.organizationId || agent.organizationId === input.organizationId).filter((agent) => !input.status || input.status === "all" || agent.status === input.status).filter((agent) => {
+        if (!input.search)
+          return true;
+        const query = input.search.toLowerCase();
+        return agent.name.toLowerCase().includes(query) || (agent.description ?? "").toLowerCase().includes(query);
+      }).sort((left, right) => right.updatedAt.getTime() - left.updatedAt.getTime());
+      const limit = input.limit ?? 20;
+      const offset = input.offset ?? 0;
+      const items = filtered.slice(offset, offset + limit).map(cloneAgent);
+      return {
+        items,
+        total: filtered.length,
+        hasMore: offset + items.length < filtered.length
+      };
+    },
+    async getAgent(id) {
+      const agent = state.agents.find((item) => item.id === id);
+      return agent ? cloneAgent(agent) : null;
+    },
+    async createAgent(input, context) {
+      const name = input.name.trim();
+      const slug = slugify(name);
+      const duplicate = state.agents.find((agent2) => agent2.projectId === context.projectId && agent2.organizationId === context.organizationId && (agent2.slug === slug || agent2.name.toLowerCase() === name.toLowerCase()));
+      if (duplicate)
+        throw new Error("AGENT_NAME_OR_SLUG_EXISTS");
+      const timestamp = now();
+      const agent = {
+        id: nextId("agent"),
+        projectId: context.projectId,
+        organizationId: context.organizationId,
+        name,
+        slug,
+        description: input.description,
+        modelProvider: input.modelProvider ?? "openai",
+        modelName: input.modelName ?? "gpt-5.4",
+        systemPrompt: input.systemPrompt,
+        temperature: input.temperature ?? 0.4,
+        maxTokens: input.maxTokens ?? 8192,
+        status: "DRAFT",
+        createdAt: timestamp,
+        updatedAt: timestamp
+      };
+      state.agents.unshift(agent);
+      return cloneAgent(agent);
+    },
+    async updateAgent(input) {
+      const agent = state.agents.find((item) => item.id === input.id);
+      if (!agent)
+        throw new Error("AGENT_NOT_FOUND");
+      const nextName = input.name;
+      if (nextName && slugify(nextName) !== agent.slug) {
+        const duplicate = state.agents.find((item) => item.id !== agent.id && item.projectId === agent.projectId && item.organizationId === agent.organizationId && (item.slug === slugify(nextName) || item.name.toLowerCase() === nextName.toLowerCase()));
+        if (duplicate)
+          throw new Error("AGENT_NAME_OR_SLUG_EXISTS");
+        agent.slug = slugify(nextName);
+        agent.name = nextName;
+      }
+      if (input.description !== undefined)
+        agent.description = input.description;
+      if (input.status)
+        agent.status = input.status;
+      agent.updatedAt = now();
+      return cloneAgent(agent);
+    },
+    async executeAgent(input) {
+      const agent = state.agents.find((item) => item.id === input.agentId);
+      if (!agent)
+        throw new Error("AGENT_NOT_FOUND");
+      if (agent.status !== "ACTIVE")
+        throw new Error("AGENT_NOT_ACTIVE");
+      const queuedAt = now();
+      const startedAt = now();
+      const completedAt = now();
+      const durationMs = 2200 + input.message.length * 12;
+      const promptTokens = 600 + input.message.length * 3;
+      const completionTokens = 240 + agent.name.length * 4;
+      const run = {
+        id: nextId("run"),
+        projectId: input.context?.projectId ?? agent.projectId,
+        agentId: agent.id,
+        agentName: agent.name,
+        status: "COMPLETED",
+        input: input.message,
+        output: `Deterministic demo reply from ${agent.name}: ${input.message}`,
+        totalTokens: promptTokens + completionTokens,
+        promptTokens,
+        completionTokens,
+        estimatedCostUsd: Number(((promptTokens + completionTokens) / 1e6).toFixed(4)),
+        durationMs,
+        queuedAt,
+        startedAt,
+        completedAt
+      };
+      state.runs.unshift(run);
+      return cloneRun(run);
+    },
+    async listTools(input) {
+      const filtered = state.tools.filter((tool) => tool.projectId === input.projectId).filter((tool) => !input.organizationId || tool.organizationId === input.organizationId).filter((tool) => !input.category || input.category === "all" || tool.category === input.category).filter((tool) => !input.status || input.status === "all" || tool.status === input.status).filter((tool) => {
+        if (!input.search)
+          return true;
+        const query = input.search.toLowerCase();
+        return tool.name.toLowerCase().includes(query) || (tool.description ?? "").toLowerCase().includes(query);
+      }).sort((left, right) => left.name.localeCompare(right.name));
+      const limit = input.limit ?? 50;
+      const offset = input.offset ?? 0;
+      const items = filtered.slice(offset, offset + limit).map(cloneTool);
+      return {
+        items,
+        total: filtered.length,
+        hasMore: offset + items.length < filtered.length
+      };
+    },
+    async listRuns(input) {
+      const filtered = state.runs.filter((run) => run.projectId === input.projectId).filter((run) => !input.agentId || run.agentId === input.agentId).filter((run) => !input.status || input.status === "all" || run.status === input.status).sort((left, right) => right.queuedAt.getTime() - left.queuedAt.getTime());
+      const limit = input.limit ?? 20;
+      const offset = input.offset ?? 0;
+      const items = filtered.slice(offset, offset + limit).map(cloneRun);
+      return {
+        items,
+        total: filtered.length,
+        hasMore: offset + items.length < filtered.length
+      };
+    },
+    async getRunMetrics(input) {
+      const filtered = state.runs.filter((run) => {
+        if (run.projectId !== input.projectId)
+          return false;
+        if (input.agentId && run.agentId !== input.agentId)
+          return false;
+        if (input.startDate && run.queuedAt < input.startDate)
+          return false;
+        if (input.endDate && run.queuedAt > input.endDate)
+          return false;
+        return true;
+      });
+      return summarizeRunMetrics(filtered);
+    }
+  };
+}
+
+// src/shared/demo-dashboard-data.ts
+async function getAgentConsoleDashboardData(handlers, params) {
+  const organizationId = params.organizationId ?? AGENT_CONSOLE_DEMO_ORGANIZATION_ID;
+  const [agentsResult, runsResult, toolsResult] = await Promise.all([
+    handlers.listAgents({
+      projectId: params.projectId,
+      organizationId,
+      limit: 10
+    }),
+    handlers.listRuns({ projectId: params.projectId, limit: 10 }),
+    handlers.listTools({
+      projectId: params.projectId,
+      organizationId,
+      limit: 10
+    })
+  ]);
+  return {
+    agents: agentsResult.items,
+    runs: runsResult.items,
+    tools: toolsResult.items,
+    summary: {
+      totalAgents: agentsResult.total,
+      totalRuns: runsResult.total,
+      totalTools: toolsResult.total
+    }
+  };
+}
+async function getFallbackAgentConsoleDashboardData() {
+  const handlers = createAgentConsoleDemoHandlers({
+    projectId: AGENT_CONSOLE_DEMO_PROJECT_ID
+  });
+  return getAgentConsoleDashboardData(handlers, {
+    projectId: AGENT_CONSOLE_DEMO_PROJECT_ID
+  });
+}
 export {
+  getFallbackAgentConsoleDashboardData,
+  getAgentConsoleDashboardData,
+  createAgentConsoleDemoHandlers,
   MOCK_TOOLS,
   MOCK_RUNS,
-  MOCK_AGENTS
+  MOCK_AGENTS,
+  AGENT_CONSOLE_DEMO_PROJECT_ID,
+  AGENT_CONSOLE_DEMO_ORGANIZATION_ID
 };

package/dist/shared/mock-runs.d.ts

@@ -4,6 +4,7 @@
 export declare const MOCK_RUNS: ({
     id: string;
     organizationId: string;
+    projectId: string;
     agentId: string;
     agentName: string;
     userId: string;
@@ -34,6 +35,7 @@ export declare const MOCK_RUNS: ({
 } | {
     id: string;
     organizationId: string;
+    projectId: string;
     agentId: string;
     agentName: string;
     userId: string;
@@ -62,6 +64,7 @@ export declare const MOCK_RUNS: ({
 } | {
     id: string;
     organizationId: string;
+    projectId: string;
     agentId: string;
     agentName: string;
     userId: string;
@@ -90,6 +93,7 @@ export declare const MOCK_RUNS: ({
 } | {
     id: string;
     organizationId: string;
+    projectId: string;
     agentId: string;
     agentName: string;
     userId: string;

package/dist/shared/mock-runs.js

@@ -4,6 +4,7 @@ var MOCK_RUNS = [
   {
     id: "run-1",
     organizationId: "demo-org",
+    projectId: "demo-project",
     agentId: "agent-1",
     agentName: "Customer Support Bot",
     userId: "user-1",
@@ -26,6 +27,7 @@ var MOCK_RUNS = [
   {
     id: "run-2",
     organizationId: "demo-org",
+    projectId: "demo-project",
     agentId: "agent-2",
     agentName: "Code Review Assistant",
     userId: "user-2",
@@ -43,6 +45,7 @@ var MOCK_RUNS = [
   {
     id: "run-3",
     organizationId: "demo-org",
+    projectId: "demo-project",
     agentId: "agent-1",
     agentName: "Customer Support Bot",
     userId: "user-1",
@@ -64,6 +67,7 @@ var MOCK_RUNS = [
   {
     id: "run-4",
     organizationId: "demo-org",
+    projectId: "demo-project",
     agentId: "agent-3",
     agentName: "Data Analyst",
     userId: "user-3",
@@ -85,6 +89,7 @@ var MOCK_RUNS = [
   {
     id: "run-5",
     organizationId: "demo-org",
+    projectId: "demo-project",
     agentId: "agent-2",
     agentName: "Code Review Assistant",
     userId: "user-2",