@contractspec/example.agent-console 1.56.1 → 1.58.0

package/dist/browser/run/run.presentation.js

@@ -0,0 +1,220 @@
+// src/run/run.enum.ts
+import { defineEnum } from "@contractspec/lib.schema";
+var RunStatusEnum = defineEnum("RunStatus", [
+  "QUEUED",
+  "IN_PROGRESS",
+  "COMPLETED",
+  "FAILED",
+  "CANCELLED",
+  "EXPIRED"
+]);
+var RunStepTypeEnum = defineEnum("RunStepType", [
+  "MESSAGE_CREATION",
+  "TOOL_CALL",
+  "TOOL_RESULT",
+  "ERROR"
+]);
+var LogLevelEnum = defineEnum("LogLevel", [
+  "DEBUG",
+  "INFO",
+  "WARN",
+  "ERROR"
+]);
+var GranularityEnum = defineEnum("Granularity", [
+  "hour",
+  "day",
+  "week",
+  "month"
+]);
+
+// src/run/run.schema.ts
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
+var RunInputModel = defineSchemaModel({
+  name: "RunInput",
+  description: "Input data for agent execution",
+  fields: {
+    message: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    context: { type: ScalarTypeEnum.JSONObject(), isOptional: true }
+  }
+});
+var RunStepModel = defineSchemaModel({
+  name: "RunStep",
+  description: "Individual step within a run",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    stepNumber: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    type: { type: RunStepTypeEnum, isOptional: false },
+    toolId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    toolName: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    input: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
+    output: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
+    status: { type: RunStatusEnum, isOptional: false },
+    errorMessage: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    tokensUsed: {
+      type: ScalarTypeEnum.Int_unsecure(),
+      isOptional: false,
+      defaultValue: 0
+    },
+    durationMs: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+    startedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+    completedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true }
+  }
+});
+var RunLogModel = defineSchemaModel({
+  name: "RunLog",
+  description: "Execution log entry",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    stepId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    level: { type: LogLevelEnum, isOptional: false },
+    message: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    data: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
+    source: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    traceId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    spanId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    timestamp: { type: ScalarTypeEnum.DateTime(), isOptional: false }
+  }
+});
+var RunAgentRefModel = defineSchemaModel({
+  name: "RunAgentRef",
+  description: "Agent reference in a run",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    modelProvider: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false
+    },
+    modelName: { type: ScalarTypeEnum.String_unsecure(), isOptional: false }
+  }
+});
+var RunModel = defineSchemaModel({
+  name: "Run",
+  description: "Agent execution instance",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    organizationId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false
+    },
+    agentId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    userId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    sessionId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    input: { type: ScalarTypeEnum.JSONObject(), isOptional: false },
+    output: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
+    status: { type: RunStatusEnum, isOptional: false },
+    errorMessage: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    errorCode: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    totalTokens: {
+      type: ScalarTypeEnum.Int_unsecure(),
+      isOptional: false,
+      defaultValue: 0
+    },
+    promptTokens: {
+      type: ScalarTypeEnum.Int_unsecure(),
+      isOptional: false,
+      defaultValue: 0
+    },
+    completionTokens: {
+      type: ScalarTypeEnum.Int_unsecure(),
+      isOptional: false,
+      defaultValue: 0
+    },
+    totalIterations: {
+      type: ScalarTypeEnum.Int_unsecure(),
+      isOptional: false,
+      defaultValue: 0
+    },
+    durationMs: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+    estimatedCostUsd: {
+      type: ScalarTypeEnum.Float_unsecure(),
+      isOptional: true
+    },
+    queuedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+    startedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },
+    completedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },
+    metadata: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
+    steps: { type: RunStepModel, isArray: true, isOptional: true },
+    logs: { type: RunLogModel, isArray: true, isOptional: true },
+    agent: { type: RunAgentRefModel, isOptional: true }
+  }
+});
+var RunSummaryModel = defineSchemaModel({
+  name: "RunSummary",
+  description: "Summary of a run for list views",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    agentId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    agentName: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    status: { type: RunStatusEnum, isOptional: false },
+    totalTokens: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    durationMs: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+    estimatedCostUsd: {
+      type: ScalarTypeEnum.Float_unsecure(),
+      isOptional: true
+    },
+    queuedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+    completedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true }
+  }
+});
+var TimelineDataPointModel = defineSchemaModel({
+  name: "TimelineDataPoint",
+  description: "Timeline data point for metrics",
+  fields: {
+    period: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    runs: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    tokens: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    costUsd: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false },
+    avgDurationMs: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false }
+  }
+});
+
+// src/run/run.presentation.ts
+import { StabilityEnum, definePresentation } from "@contractspec/lib.contracts";
+var RunListPresentation = definePresentation({
+  meta: {
+    key: "agent-console.run.list",
+    version: "1.0.0",
+    title: "Run List",
+    description: "List view of agent runs with status, tokens, and duration info",
+    goal: "Provide an overview of agent execution history and performance.",
+    context: "Run history dashboard.",
+    domain: "agent-console",
+    owners: ["@agent-console-team"],
+    tags: ["run", "list", "dashboard"],
+    stability: StabilityEnum.Experimental
+  },
+  source: {
+    type: "component",
+    framework: "react",
+    componentKey: "RunListView",
+    props: RunSummaryModel
+  },
+  targets: ["react", "markdown", "application/json"],
+  policy: { flags: ["agent-console.enabled"] }
+});
+var RunDetailPresentation = definePresentation({
+  meta: {
+    key: "agent-console.run.detail",
+    version: "1.0.0",
+    title: "Run Details",
+    description: "Detailed view of an agent run with steps, logs, and metrics",
+    goal: "Allow users to inspect and debug a specific agent run.",
+    context: "Detailed view of an agent run.",
+    domain: "agent-console",
+    owners: ["@agent-console-team"],
+    tags: ["run", "detail"],
+    stability: StabilityEnum.Experimental
+  },
+  source: {
+    type: "component",
+    framework: "react",
+    componentKey: "RunDetailView"
+  },
+  targets: ["react", "markdown"],
+  policy: { flags: ["agent-console.enabled"] }
+});
+export {
+  RunListPresentation,
+  RunDetailPresentation
+};

package/dist/browser/run/run.schema.js

@@ -0,0 +1,179 @@
+// src/run/run.enum.ts
+import { defineEnum } from "@contractspec/lib.schema";
+var RunStatusEnum = defineEnum("RunStatus", [
+  "QUEUED",
+  "IN_PROGRESS",
+  "COMPLETED",
+  "FAILED",
+  "CANCELLED",
+  "EXPIRED"
+]);
+var RunStepTypeEnum = defineEnum("RunStepType", [
+  "MESSAGE_CREATION",
+  "TOOL_CALL",
+  "TOOL_RESULT",
+  "ERROR"
+]);
+var LogLevelEnum = defineEnum("LogLevel", [
+  "DEBUG",
+  "INFO",
+  "WARN",
+  "ERROR"
+]);
+var GranularityEnum = defineEnum("Granularity", [
+  "hour",
+  "day",
+  "week",
+  "month"
+]);
+
+// src/run/run.schema.ts
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
+var RunInputModel = defineSchemaModel({
+  name: "RunInput",
+  description: "Input data for agent execution",
+  fields: {
+    message: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    context: { type: ScalarTypeEnum.JSONObject(), isOptional: true }
+  }
+});
+var RunStepModel = defineSchemaModel({
+  name: "RunStep",
+  description: "Individual step within a run",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    stepNumber: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    type: { type: RunStepTypeEnum, isOptional: false },
+    toolId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    toolName: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    input: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
+    output: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
+    status: { type: RunStatusEnum, isOptional: false },
+    errorMessage: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    tokensUsed: {
+      type: ScalarTypeEnum.Int_unsecure(),
+      isOptional: false,
+      defaultValue: 0
+    },
+    durationMs: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+    startedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+    completedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true }
+  }
+});
+var RunLogModel = defineSchemaModel({
+  name: "RunLog",
+  description: "Execution log entry",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    stepId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    level: { type: LogLevelEnum, isOptional: false },
+    message: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    data: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
+    source: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    traceId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    spanId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    timestamp: { type: ScalarTypeEnum.DateTime(), isOptional: false }
+  }
+});
+var RunAgentRefModel = defineSchemaModel({
+  name: "RunAgentRef",
+  description: "Agent reference in a run",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    modelProvider: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false
+    },
+    modelName: { type: ScalarTypeEnum.String_unsecure(), isOptional: false }
+  }
+});
+var RunModel = defineSchemaModel({
+  name: "Run",
+  description: "Agent execution instance",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    organizationId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false
+    },
+    agentId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    userId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    sessionId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    input: { type: ScalarTypeEnum.JSONObject(), isOptional: false },
+    output: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
+    status: { type: RunStatusEnum, isOptional: false },
+    errorMessage: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    errorCode: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    totalTokens: {
+      type: ScalarTypeEnum.Int_unsecure(),
+      isOptional: false,
+      defaultValue: 0
+    },
+    promptTokens: {
+      type: ScalarTypeEnum.Int_unsecure(),
+      isOptional: false,
+      defaultValue: 0
+    },
+    completionTokens: {
+      type: ScalarTypeEnum.Int_unsecure(),
+      isOptional: false,
+      defaultValue: 0
+    },
+    totalIterations: {
+      type: ScalarTypeEnum.Int_unsecure(),
+      isOptional: false,
+      defaultValue: 0
+    },
+    durationMs: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+    estimatedCostUsd: {
+      type: ScalarTypeEnum.Float_unsecure(),
+      isOptional: true
+    },
+    queuedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+    startedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },
+    completedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },
+    metadata: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
+    steps: { type: RunStepModel, isArray: true, isOptional: true },
+    logs: { type: RunLogModel, isArray: true, isOptional: true },
+    agent: { type: RunAgentRefModel, isOptional: true }
+  }
+});
+var RunSummaryModel = defineSchemaModel({
+  name: "RunSummary",
+  description: "Summary of a run for list views",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    agentId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    agentName: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    status: { type: RunStatusEnum, isOptional: false },
+    totalTokens: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    durationMs: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+    estimatedCostUsd: {
+      type: ScalarTypeEnum.Float_unsecure(),
+      isOptional: true
+    },
+    queuedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+    completedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true }
+  }
+});
+var TimelineDataPointModel = defineSchemaModel({
+  name: "TimelineDataPoint",
+  description: "Timeline data point for metrics",
+  fields: {
+    period: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    runs: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    tokens: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    costUsd: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false },
+    avgDurationMs: { type: ScalarTypeEnum.Float_unsecure(), isOptional: false }
+  }
+});
+export {
+  TimelineDataPointModel,
+  RunSummaryModel,
+  RunStepModel,
+  RunModel,
+  RunLogModel,
+  RunInputModel,
+  RunAgentRefModel
+};

package/dist/browser/run/run.test-spec.js

@@ -0,0 +1,58 @@
+// src/run/run.test-spec.ts
+import { defineTestSpec } from "@contractspec/lib.contracts";
+var runListTest = defineTestSpec({
+  meta: {
+    key: "test.agent.run.list",
+    version: "1.0.0",
+    owners: ["@agent-console-team"],
+    description: "Test for listing runs",
+    stability: "stable",
+    tags: ["test"]
+  },
+  target: {
+    type: "operation",
+    operation: { key: "agent.run.list", version: "1.0.0" }
+  },
+  scenarios: [
+    {
+      key: "success",
+      when: { operation: { key: "agent.run.list" } },
+      then: [{ type: "expectOutput", match: {} }]
+    },
+    {
+      key: "error",
+      when: { operation: { key: "agent.run.list" } },
+      then: [{ type: "expectError" }]
+    }
+  ]
+});
+var runGetTest = defineTestSpec({
+  meta: {
+    key: "test.agent.run.get",
+    version: "1.0.0",
+    owners: ["@agent-console-team"],
+    description: "Test for getting run",
+    stability: "stable",
+    tags: ["test"]
+  },
+  target: {
+    type: "operation",
+    operation: { key: "agent.run.get", version: "1.0.0" }
+  },
+  scenarios: [
+    {
+      key: "success",
+      when: { operation: { key: "agent.run.get" } },
+      then: [{ type: "expectOutput", match: {} }]
+    },
+    {
+      key: "error",
+      when: { operation: { key: "agent.run.get" } },
+      then: [{ type: "expectError" }]
+    }
+  ]
+});
+export {
+  runListTest,
+  runGetTest
+};

package/dist/browser/seeders/index.js

@@ -0,0 +1,21 @@
+// src/seeders/index.ts
+async function seedAgentConsole(params) {
+  const { projectId, db } = params;
+  const existing = await db.query(`SELECT COUNT(*) as count FROM agent_definition WHERE "projectId" = $1`, [projectId]);
+  if (existing.rows[0]?.count > 0)
+    return;
+  await db.execute(`INSERT INTO agent_definition (id, "projectId", "organizationId", name, description, "modelProvider", "modelName", status)
+     VALUES ($1, $2, $3, $4, $5, $6, $7, $8)`, [
+    "agent_1",
+    projectId,
+    "org_demo",
+    "Demo Agent",
+    "A demo AI agent",
+    "openai",
+    "gpt-4",
+    "ACTIVE"
+  ]);
+}
+export {
+  seedAgentConsole
+};