@contractspec/example.agent-console 1.57.0 → 1.59.0

package/dist/node/agent/agent.presentation.js

@@ -0,0 +1,279 @@
+// src/agent/agent.enum.ts
+import { defineEnum } from "@contractspec/lib.schema";
+var AgentStatusEnum = defineEnum("AgentStatus", [
+  "DRAFT",
+  "ACTIVE",
+  "PAUSED",
+  "ARCHIVED"
+]);
+var ModelProviderEnum = defineEnum("ModelProvider", [
+  "OPENAI",
+  "ANTHROPIC",
+  "GOOGLE",
+  "MISTRAL",
+  "CUSTOM"
+]);
+var ToolChoiceEnum = defineEnum("ToolChoice", [
+  "auto",
+  "required",
+  "none"
+]);
+
+// src/agent/agent.schema.ts
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
+var AgentModel = defineSchemaModel({
+  name: "Agent",
+  description: "AI agent configuration",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    organizationId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false
+    },
+    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    slug: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    status: { type: AgentStatusEnum, isOptional: false },
+    modelProvider: { type: ModelProviderEnum, isOptional: false },
+    modelName: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    modelConfig: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
+    systemPrompt: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    userPromptTemplate: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: true
+    },
+    toolIds: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isArray: true,
+      isOptional: true
+    },
+    toolChoice: {
+      type: ToolChoiceEnum,
+      isOptional: false,
+      defaultValue: "auto"
+    },
+    maxIterations: {
+      type: ScalarTypeEnum.Int_unsecure(),
+      isOptional: false,
+      defaultValue: 10
+    },
+    maxTokensPerRun: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+    timeoutMs: {
+      type: ScalarTypeEnum.Int_unsecure(),
+      isOptional: false,
+      defaultValue: 120000
+    },
+    version: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    tags: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isArray: true,
+      isOptional: true
+    },
+    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+    updatedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
+  }
+});
+var AgentSummaryModel = defineSchemaModel({
+  name: "AgentSummary",
+  description: "Summary of an agent for list views",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    slug: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    status: { type: AgentStatusEnum, isOptional: false },
+    modelProvider: { type: ModelProviderEnum, isOptional: false },
+    modelName: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    version: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
+  }
+});
+var AgentToolRefModel = defineSchemaModel({
+  name: "AgentToolRef",
+  description: "Tool reference in agent context",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    slug: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    category: { type: ScalarTypeEnum.String_unsecure(), isOptional: false }
+  }
+});
+var AgentWithToolsModel = defineSchemaModel({
+  name: "AgentWithTools",
+  description: "Agent with associated tools",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    organizationId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false
+    },
+    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    slug: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    status: { type: AgentStatusEnum, isOptional: false },
+    modelProvider: { type: ModelProviderEnum, isOptional: false },
+    modelName: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    modelConfig: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
+    systemPrompt: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    userPromptTemplate: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: true
+    },
+    toolIds: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isArray: true,
+      isOptional: true
+    },
+    toolChoice: { type: ToolChoiceEnum, isOptional: false },
+    maxIterations: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    maxTokensPerRun: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+    timeoutMs: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    version: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    tags: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isArray: true,
+      isOptional: true
+    },
+    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+    updatedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+    tools: { type: AgentToolRefModel, isArray: true, isOptional: true }
+  }
+});
+var CreateAgentInputModel = defineSchemaModel({
+  name: "CreateAgentInput",
+  description: "Input for creating an agent",
+  fields: {
+    organizationId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false
+    },
+    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    slug: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    modelProvider: { type: ModelProviderEnum, isOptional: false },
+    modelName: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    modelConfig: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
+    systemPrompt: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    userPromptTemplate: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: true
+    },
+    toolIds: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isArray: true,
+      isOptional: true
+    },
+    toolChoice: { type: ToolChoiceEnum, isOptional: true },
+    maxIterations: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+    maxTokensPerRun: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+    timeoutMs: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+    tags: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isArray: true,
+      isOptional: true
+    }
+  }
+});
+var UpdateAgentInputModel = defineSchemaModel({
+  name: "UpdateAgentInput",
+  description: "Input for updating an agent",
+  fields: {
+    agentId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: true },
+    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    status: { type: AgentStatusEnum, isOptional: true },
+    modelConfig: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
+    systemPrompt: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    userPromptTemplate: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: true
+    },
+    toolIds: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isArray: true,
+      isOptional: true
+    },
+    toolChoice: { type: ToolChoiceEnum, isOptional: true },
+    maxIterations: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+    maxTokensPerRun: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+    timeoutMs: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+    tags: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isArray: true,
+      isOptional: true
+    }
+  }
+});
+
+// src/agent/agent.presentation.ts
+import { definePresentation, StabilityEnum } from "@contractspec/lib.contracts";
+var AgentListPresentation = definePresentation({
+  meta: {
+    key: "agent-console.agent.viewList",
+    version: "1.0.0",
+    title: "Agent List",
+    description: "List view of AI agents with status, model provider, and version info",
+    goal: "Provide an overview of all agents in an organization.",
+    context: "Main landing page for agent management.",
+    domain: "agent-console",
+    owners: ["@agent-console-team"],
+    tags: ["agent", "list", "dashboard"],
+    stability: StabilityEnum.Experimental
+  },
+  source: {
+    type: "component",
+    framework: "react",
+    componentKey: "AgentListView",
+    props: AgentSummaryModel
+  },
+  targets: ["react", "markdown", "application/json"],
+  policy: { flags: ["agent-console.enabled"] }
+});
+var AgentDetailPresentation = definePresentation({
+  meta: {
+    key: "agent-console.agent.detail",
+    version: "1.0.0",
+    title: "Agent Details",
+    description: "Detailed view of an AI agent with configuration, tools, and recent runs",
+    goal: "Allow users to inspect and configure a specific agent.",
+    context: "Detailed view of an agent.",
+    domain: "agent-console",
+    owners: ["@agent-console-team"],
+    tags: ["agent", "detail"],
+    stability: StabilityEnum.Experimental
+  },
+  source: {
+    type: "component",
+    framework: "react",
+    componentKey: "AgentDetailView"
+  },
+  targets: ["react", "markdown"],
+  policy: { flags: ["agent-console.enabled"] }
+});
+var AgentConsoleDashboardPresentation = definePresentation({
+  meta: {
+    key: "agent-console.dashboard",
+    version: "1.0.0",
+    title: "Agent Console Dashboard",
+    description: "Dashboard overview of AI agents, runs, and tools",
+    goal: "Provide a high-level overview of the AI platform health and usage.",
+    context: "Root dashboard of the Agent Console.",
+    domain: "agent-console",
+    owners: ["@agent-console-team"],
+    tags: ["dashboard", "overview"],
+    stability: StabilityEnum.Experimental
+  },
+  source: {
+    type: "component",
+    framework: "react",
+    componentKey: "AgentConsoleDashboard"
+  },
+  targets: ["react", "markdown"],
+  policy: { flags: ["agent-console.enabled"] }
+});
+export {
+  AgentListPresentation,
+  AgentDetailPresentation,
+  AgentConsoleDashboardPresentation
+};

package/dist/node/agent/agent.schema.js

@@ -0,0 +1,215 @@
+// src/agent/agent.enum.ts
+import { defineEnum } from "@contractspec/lib.schema";
+var AgentStatusEnum = defineEnum("AgentStatus", [
+  "DRAFT",
+  "ACTIVE",
+  "PAUSED",
+  "ARCHIVED"
+]);
+var ModelProviderEnum = defineEnum("ModelProvider", [
+  "OPENAI",
+  "ANTHROPIC",
+  "GOOGLE",
+  "MISTRAL",
+  "CUSTOM"
+]);
+var ToolChoiceEnum = defineEnum("ToolChoice", [
+  "auto",
+  "required",
+  "none"
+]);
+
+// src/agent/agent.schema.ts
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
+var AgentModel = defineSchemaModel({
+  name: "Agent",
+  description: "AI agent configuration",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    organizationId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false
+    },
+    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    slug: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    status: { type: AgentStatusEnum, isOptional: false },
+    modelProvider: { type: ModelProviderEnum, isOptional: false },
+    modelName: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    modelConfig: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
+    systemPrompt: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    userPromptTemplate: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: true
+    },
+    toolIds: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isArray: true,
+      isOptional: true
+    },
+    toolChoice: {
+      type: ToolChoiceEnum,
+      isOptional: false,
+      defaultValue: "auto"
+    },
+    maxIterations: {
+      type: ScalarTypeEnum.Int_unsecure(),
+      isOptional: false,
+      defaultValue: 10
+    },
+    maxTokensPerRun: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+    timeoutMs: {
+      type: ScalarTypeEnum.Int_unsecure(),
+      isOptional: false,
+      defaultValue: 120000
+    },
+    version: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    tags: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isArray: true,
+      isOptional: true
+    },
+    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+    updatedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
+  }
+});
+var AgentSummaryModel = defineSchemaModel({
+  name: "AgentSummary",
+  description: "Summary of an agent for list views",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    slug: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    status: { type: AgentStatusEnum, isOptional: false },
+    modelProvider: { type: ModelProviderEnum, isOptional: false },
+    modelName: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    version: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
+  }
+});
+var AgentToolRefModel = defineSchemaModel({
+  name: "AgentToolRef",
+  description: "Tool reference in agent context",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    slug: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    category: { type: ScalarTypeEnum.String_unsecure(), isOptional: false }
+  }
+});
+var AgentWithToolsModel = defineSchemaModel({
+  name: "AgentWithTools",
+  description: "Agent with associated tools",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    organizationId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false
+    },
+    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    slug: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    status: { type: AgentStatusEnum, isOptional: false },
+    modelProvider: { type: ModelProviderEnum, isOptional: false },
+    modelName: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    modelConfig: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
+    systemPrompt: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    userPromptTemplate: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: true
+    },
+    toolIds: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isArray: true,
+      isOptional: true
+    },
+    toolChoice: { type: ToolChoiceEnum, isOptional: false },
+    maxIterations: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    maxTokensPerRun: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+    timeoutMs: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    version: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    tags: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isArray: true,
+      isOptional: true
+    },
+    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+    updatedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+    tools: { type: AgentToolRefModel, isArray: true, isOptional: true }
+  }
+});
+var CreateAgentInputModel = defineSchemaModel({
+  name: "CreateAgentInput",
+  description: "Input for creating an agent",
+  fields: {
+    organizationId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false
+    },
+    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    slug: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    modelProvider: { type: ModelProviderEnum, isOptional: false },
+    modelName: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    modelConfig: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
+    systemPrompt: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    userPromptTemplate: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: true
+    },
+    toolIds: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isArray: true,
+      isOptional: true
+    },
+    toolChoice: { type: ToolChoiceEnum, isOptional: true },
+    maxIterations: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+    maxTokensPerRun: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+    timeoutMs: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+    tags: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isArray: true,
+      isOptional: true
+    }
+  }
+});
+var UpdateAgentInputModel = defineSchemaModel({
+  name: "UpdateAgentInput",
+  description: "Input for updating an agent",
+  fields: {
+    agentId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: true },
+    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    status: { type: AgentStatusEnum, isOptional: true },
+    modelConfig: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
+    systemPrompt: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    userPromptTemplate: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: true
+    },
+    toolIds: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isArray: true,
+      isOptional: true
+    },
+    toolChoice: { type: ToolChoiceEnum, isOptional: true },
+    maxIterations: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+    maxTokensPerRun: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+    timeoutMs: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+    tags: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isArray: true,
+      isOptional: true
+    }
+  }
+});
+export {
+  UpdateAgentInputModel,
+  CreateAgentInputModel,
+  AgentWithToolsModel,
+  AgentToolRefModel,
+  AgentSummaryModel,
+  AgentModel
+};

package/dist/node/agent/agent.test-spec.js

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