@lssm/example.agent-console 0.0.0-canary-20251215234340 → 0.0.0-canary-20251216023757

package/src/{presentations/agent-list.ts → agent/agent.presentation.ts}

@@ -1,19 +1,14 @@
-/**
- * Agent List Presentation Descriptor
- */
 import type { PresentationDescriptorV2 } from '@lssm/lib.contracts';
-import { AgentSummaryModel } from '../contracts/agent';
+import { AgentSummaryModel } from './agent.schema';
 
 /**
  * Presentation for displaying a list of AI agents.
- * Supports both React (DataTable) and Markdown (list) rendering.
  */
 export const AgentListPresentation: PresentationDescriptorV2 = {
   meta: {
     name: 'agent-console.agent.list',
     version: 1,
-    description:
-      'List view of AI agents with status, model provider, and version info',
+    description: 'List view of AI agents with status, model provider, and version info',
     domain: 'agent-console',
     owners: ['agent-console-team'],
     tags: ['agent', 'list', 'dashboard'],
@@ -25,9 +20,7 @@ export const AgentListPresentation: PresentationDescriptorV2 = {
     props: AgentSummaryModel,
   },
   targets: ['react', 'markdown', 'application/json'],
-  policy: {
-    flags: ['agent-console.enabled'],
-  },
+  policy: { flags: ['agent-console.enabled'] },
 };
 
 /**
@@ -37,8 +30,7 @@ export const AgentDetailPresentation: PresentationDescriptorV2 = {
   meta: {
     name: 'agent-console.agent.detail',
     version: 1,
-    description:
-      'Detailed view of an AI agent with configuration, tools, and recent runs',
+    description: 'Detailed view of an AI agent with configuration, tools, and recent runs',
     domain: 'agent-console',
     owners: ['agent-console-team'],
     tags: ['agent', 'detail'],
@@ -49,7 +41,27 @@ export const AgentDetailPresentation: PresentationDescriptorV2 = {
     componentKey: 'AgentDetailView',
   },
   targets: ['react', 'markdown'],
-  policy: {
-    flags: ['agent-console.enabled'],
+  policy: { flags: ['agent-console.enabled'] },
+};
+
+/**
+ * Dashboard presentation for Agent Console - overview of agents, runs, and tools.
+ */
+export const AgentConsoleDashboardPresentation: PresentationDescriptorV2 = {
+  meta: {
+    name: 'agent-console.dashboard',
+    version: 1,
+    description: 'Dashboard overview of AI agents, runs, and tools',
+    domain: 'agent-console',
+    owners: ['agent-console-team'],
+    tags: ['dashboard', 'overview'],
+  },
+  source: {
+    type: 'component',
+    framework: 'react',
+    componentKey: 'AgentConsoleDashboard',
   },
+  targets: ['react', 'markdown'],
+  policy: { flags: ['agent-console.enabled'] },
 };
+

package/src/agent/agent.schema.ts

@@ -0,0 +1,147 @@
+import { defineSchemaModel, ScalarTypeEnum } from '@lssm/lib.schema';
+import { AgentStatusEnum, ModelProviderEnum, ToolChoiceEnum } from './agent.enum';
+
+/**
+ * AI agent configuration schema.
+ */
+export const 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 },
+  },
+});
+
+/**
+ * Summary of an agent for list views.
+ */
+export const 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 },
+  },
+});
+
+/**
+ * Tool reference in agent context.
+ */
+export const 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 },
+  },
+});
+
+/**
+ * Agent with associated tools.
+ */
+export const 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 },
+  },
+});
+
+/**
+ * Input for creating an agent.
+ */
+export const 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 },
+  },
+});
+
+/**
+ * Input for updating an agent.
+ */
+export const 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 },
+  },
+});
+
+

package/src/agent/index.ts

@@ -0,0 +1,65 @@
+/**
+ * Agent domain - AI agent configuration and management.
+ */
+
+// Enums
+export { AgentStatusEnum, ModelProviderEnum, ToolChoiceEnum } from './agent.enum';
+
+// Schema models
+export {
+  AgentModel,
+  AgentSummaryModel,
+  AgentToolRefModel,
+  AgentWithToolsModel,
+  CreateAgentInputModel,
+  UpdateAgentInputModel,
+} from './agent.schema';
+
+// Contracts
+export {
+  CreateAgentCommand,
+  UpdateAgentCommand,
+  GetAgentQuery,
+  ListAgentsQuery,
+  AssignToolToAgentCommand,
+  RemoveToolFromAgentCommand,
+} from './agent.contracts';
+
+// Events
+export {
+  AgentCreatedEvent,
+  AgentUpdatedEvent,
+  AgentToolAssignedEvent,
+  AgentToolRemovedEvent,
+} from './agent.event';
+
+// Entities
+export {
+  AgentStatusEntityEnum,
+  ModelProviderEntityEnum,
+  AgentEntity,
+  AgentToolEntity,
+} from './agent.entity';
+
+// Presentations
+export {
+  AgentListPresentation,
+  AgentDetailPresentation,
+  AgentConsoleDashboardPresentation,
+} from './agent.presentation';
+
+// Handlers
+export {
+  mockListAgentsHandler,
+  mockGetAgentHandler,
+  mockCreateAgentHandler,
+  mockUpdateAgentHandler,
+  type ListAgentsInput,
+  type AgentSummary,
+  type ListAgentsOutput,
+  type GetAgentInput,
+  type AgentToolRef,
+  type AgentWithTools,
+} from './agent.handler';
+
+

package/src/handlers/index.ts

@@ -1,55 +1,28 @@
 /**
- * Mock handlers for agent-console example
- *
- * These handlers provide mock implementations of all contracts
- * for use in demos, tests, and the sandbox environment.
+ * Agent Console Handlers - re-exports from domain modules for backward compatibility.
  */
 
-// Mock data
-export * from './mock-data';
-
-// Agent handlers
+// Agent handlers and types
 export {
-  mockListAgentsHandler,
-  mockGetAgentHandler,
   mockCreateAgentHandler,
-  mockUpdateAgentHandler,
-  type ListAgentsInput,
-  type ListAgentsOutput,
+  mockGetAgentHandler,
+  mockListAgentsHandler,
   type AgentSummary,
-  type GetAgentInput,
-  type AgentWithTools,
-  type AgentToolRef,
-} from './agent.handlers';
+} from '../agent/agent.handler';
 
-// Tool handlers
+// Run handlers and types
+export {
+  mockExecuteAgentHandler,
+  mockGetRunHandler,
+  mockListRunsHandler,
+  type RunSummary,
+} from '../run/run.handler';
+
+// Tool handlers and types
 export {
-  mockListToolsHandler,
-  mockGetToolHandler,
   mockCreateToolHandler,
-  mockTestToolHandler,
-  type ListToolsInput,
-  type ListToolsOutput,
+  mockGetToolHandler,
+  mockListToolsHandler,
   type ToolSummary,
-  type GetToolInput,
-  type Tool,
-} from './tool.handlers';
+} from '../tool/tool.handler';
 
-// Run handlers
-export {
-  mockListRunsHandler,
-  mockGetRunHandler,
-  mockGetRunMetricsHandler,
-  mockExecuteAgentHandler,
-  mockCancelRunHandler,
-  type ListRunsInput,
-  type ListRunsOutput,
-  type RunSummary,
-  type GetRunInput,
-  type Run,
-  type RunStep,
-  type RunLog,
-  type GetRunMetricsInput,
-  type RunMetrics,
-  type TimelineDataPoint,
-} from './run.handlers';

package/src/index.ts

@@ -15,22 +15,13 @@
  * ```
  */
 
-// Entity exports
-export * from './entities';
-
-// Contract exports
-export * from './contracts';
-
-// Event exports
-export * from './events';
-
-// Handler exports (for sandbox/demo use)
-export * from './handlers';
-
-// Presentation exports
-export * from './presentations';
+// Domain exports
+export * from './agent';
+export * from './run';
+export * from './tool';
+export * from './shared';
 
 // Feature spec export
-export * from './feature';
+export * from './agent.feature';
 export { default as example } from './example';
 import './docs';

package/src/presentations/index.ts

@@ -1,48 +1,27 @@
 /**
- * Presentation descriptors for agent-console
- *
- * These define how data can be rendered across different targets (React, Markdown, JSON).
+ * Agent Console Presentations - re-exports from domain modules for backward compatibility.
  */
 
 // Agent presentations
-export { AgentListPresentation, AgentDetailPresentation } from './agent-list';
+export {
+  AgentListPresentation,
+  AgentDetailPresentation,
+  AgentConsoleDashboardPresentation,
+} from '../agent/agent.presentation';
 
 // Run presentations
 export {
   RunListPresentation,
   RunDetailPresentation,
-  RunMetricsPresentation,
-} from './run-list';
+} from '../run/run.presentation';
+// Alias: RunMetricsPresentation -> RunDetailPresentation (for backward compatibility)
+export { RunDetailPresentation as RunMetricsPresentation } from '../run/run.presentation';
 
 // Tool presentations
 export {
-  ToolRegistryPresentation,
+  ToolListPresentation,
   ToolDetailPresentation,
-} from './tool-registry';
+} from '../tool/tool.presentation';
+// Alias: ToolRegistryPresentation -> ToolListPresentation (for backward compatibility)
+export { ToolListPresentation as ToolRegistryPresentation } from '../tool/tool.presentation';
 
-// Dashboard
-export { AgentConsoleDashboardPresentation } from './dashboard';
-
-// Re-export all presentations as an array for easy registration
-import { AgentListPresentation, AgentDetailPresentation } from './agent-list';
-import {
-  RunListPresentation,
-  RunDetailPresentation,
-  RunMetricsPresentation,
-} from './run-list';
-import {
-  ToolRegistryPresentation,
-  ToolDetailPresentation,
-} from './tool-registry';
-import { AgentConsoleDashboardPresentation } from './dashboard';
-
-export const AgentConsolePresentations = [
-  AgentConsoleDashboardPresentation,
-  AgentListPresentation,
-  AgentDetailPresentation,
-  RunListPresentation,
-  RunDetailPresentation,
-  RunMetricsPresentation,
-  ToolRegistryPresentation,
-  ToolDetailPresentation,
-];

package/src/run/index.ts

@@ -0,0 +1,65 @@
+/**
+ * Run domain - Agent execution and monitoring.
+ */
+
+// Enums
+export { RunStatusEnum, RunStepTypeEnum, LogLevelEnum, GranularityEnum } from './run.enum';
+
+// Schema models
+export {
+  RunInputModel,
+  RunStepModel,
+  RunLogModel,
+  RunAgentRefModel,
+  RunModel,
+  RunSummaryModel,
+  TimelineDataPointModel,
+} from './run.schema';
+
+// Contracts
+export {
+  ExecuteAgentCommand,
+  CancelRunCommand,
+  GetRunQuery,
+  ListRunsQuery,
+  GetRunStepsQuery,
+  GetRunLogsQuery,
+  GetRunMetricsQuery,
+} from './run.contracts';
+
+// Events
+export {
+  RunStartedEvent,
+  RunCompletedEvent,
+  RunFailedEvent,
+  RunCancelledEvent,
+  ToolInvokedEvent,
+  ToolCompletedEvent,
+  MessageGeneratedEvent,
+} from './run.event';
+
+// Entities
+export {
+  RunStatusEntityEnum,
+  RunStepTypeEntityEnum,
+  LogLevelEntityEnum,
+  RunEntity,
+  RunStepEntity,
+  RunLogEntity,
+} from './run.entity';
+
+// Presentations
+export { RunListPresentation, RunDetailPresentation } from './run.presentation';
+
+// Handlers
+export {
+  mockListRunsHandler,
+  mockGetRunHandler,
+  mockExecuteAgentHandler,
+  mockCancelRunHandler,
+  type ListRunsInput,
+  type RunSummary,
+  type ListRunsOutput,
+} from './run.handler';
+
+