@lssm/example.agent-console 1.41.0 → 1.42.2

package/src/agent/agent.event.ts

@@ -1,6 +1,8 @@
 import { defineEvent, defineSchemaModel } from '@lssm/lib.contracts';
 import { ScalarTypeEnum } from '@lssm/lib.schema';
 
+const OWNERS = ['@agent-console-team'] as const;
+
 /**
  * Payload for agent created event.
  */
@@ -30,9 +32,14 @@ const AgentCreatedPayload = defineSchemaModel({
  * AgentCreatedEvent - A new agent was created.
  */
 export const AgentCreatedEvent = defineEvent({
-  name: 'agent.agent.created',
-  version: 1,
-  description: 'A new AI agent was configured.',
+  meta: {
+    key: 'agent-console.agent.created',
+    version: 1,
+    description: 'A new AI agent was configured.',
+    stability: 'stable',
+    owners: [...OWNERS],
+    tags: ['agent', 'created'],
+  },
   payload: AgentCreatedPayload,
 });
 
@@ -63,9 +70,14 @@ const AgentUpdatedPayload = defineSchemaModel({
  * AgentUpdatedEvent - An agent was updated.
  */
 export const AgentUpdatedEvent = defineEvent({
-  name: 'agent.agent.updated',
-  version: 1,
-  description: 'An AI agent configuration was updated.',
+  meta: {
+    key: 'agent-console.agent.updated',
+    version: 1,
+    description: 'An AI agent configuration was updated.',
+    stability: 'stable',
+    owners: [...OWNERS],
+    tags: ['agent', 'updated'],
+  },
   payload: AgentUpdatedPayload,
 });
 
@@ -88,9 +100,14 @@ const AgentToolAssignedPayload = defineSchemaModel({
  * AgentToolAssignedEvent - A tool was assigned to an agent.
  */
 export const AgentToolAssignedEvent = defineEvent({
-  name: 'agent.agent.toolAssigned',
-  version: 1,
-  description: 'A tool was assigned to an agent.',
+  meta: {
+    key: 'agent-console.agent.toolAssigned',
+    version: 1,
+    description: 'A tool was assigned to an agent.',
+    stability: 'stable',
+    owners: [...OWNERS],
+    tags: ['agent', 'tool', 'assigned'],
+  },
   payload: AgentToolAssignedPayload,
 });
 
@@ -113,8 +130,13 @@ const AgentToolRemovedPayload = defineSchemaModel({
  * AgentToolRemovedEvent - A tool was removed from an agent.
  */
 export const AgentToolRemovedEvent = defineEvent({
-  name: 'agent.agent.toolRemoved',
-  version: 1,
-  description: 'A tool was removed from an agent.',
+  meta: {
+    key: 'agent-console.agent.toolRemoved',
+    version: 1,
+    description: 'A tool was removed from an agent.',
+    stability: 'stable',
+    owners: [...OWNERS],
+    tags: ['agent', 'tool', 'removed'],
+  },
   payload: AgentToolRemovedPayload,
 });

package/src/agent/{agent.contracts.ts → agent.operation.ts}

@@ -1,4 +1,4 @@
-import { defineCommand, defineQuery } from '@lssm/lib.contracts/spec';
+import { defineCommand, defineQuery } from '@lssm/lib.contracts/operations';
 import { defineSchemaModel, ScalarTypeEnum } from '@lssm/lib.schema';
 import { AgentStatusEnum, ModelProviderEnum } from './agent.enum';
 import {
@@ -16,7 +16,7 @@ const OWNERS = ['@agent-console-team'] as const;
  */
 export const CreateAgentCommand = defineCommand({
   meta: {
-    name: 'agent.agent.create',
+    key: 'agent-console.agent.create',
     version: 1,
     stability: 'stable',
     owners: [...OWNERS],
@@ -53,11 +53,47 @@ export const CreateAgentCommand = defineCommand({
         // name: 'agent.created',
         // version: 1,
         // payload: AgentSummaryModel,
-        ref: AgentCreatedEvent,
+        ref: AgentCreatedEvent.meta,
         when: 'Agent is successfully created',
       },
     ],
-    audit: ['agent.created'],
+    audit: ['agent-console.agent.created'],
+  },
+  acceptance: {
+    scenarios: [
+      {
+        key: 'create-agent-happy-path',
+        given: ['User is authenticated', 'Organization exists'],
+        when: ['User submits valid agent configuration'],
+        then: [
+          'New agent is created with DRAFT status',
+          'AgentCreated event is emitted',
+        ],
+      },
+      {
+        key: 'create-agent-slug-conflict',
+        given: ['User is authenticated', 'Agent with same slug exists'],
+        when: ['User submits agent with duplicate slug'],
+        then: ['SLUG_EXISTS error is returned with 409 status'],
+      },
+    ],
+    examples: [
+      {
+        key: 'basic-create',
+        input: {
+          name: 'Support Assistant',
+          slug: 'support-assistant',
+          modelProvider: 'openai',
+          modelId: 'gpt-4',
+        },
+        output: {
+          id: 'agent-123',
+          name: 'Support Assistant',
+          slug: 'support-assistant',
+          status: 'draft',
+        },
+      },
+    ],
   },
 });
 
@@ -66,7 +102,7 @@ export const CreateAgentCommand = defineCommand({
  */
 export const UpdateAgentCommand = defineCommand({
   meta: {
-    name: 'agent.agent.update',
+    key: 'agent-console.agent.update',
     version: 1,
     stability: 'stable',
     owners: [...OWNERS],
@@ -99,14 +135,49 @@ export const UpdateAgentCommand = defineCommand({
   sideEffects: {
     emits: [
       {
-        name: 'agent.updated',
+        key: 'agent.updated',
         version: 1,
+        stability: 'stable',
+        owners: [...OWNERS],
+        tags: ['agent', 'updated'],
         when: 'Agent is updated',
         payload: AgentSummaryModel,
       },
     ],
     audit: ['agent.updated'],
   },
+  acceptance: {
+    scenarios: [
+      {
+        key: 'update-agent-happy-path',
+        given: ['Agent exists', 'User owns the agent'],
+        when: ['User submits updated configuration'],
+        then: ['Agent is updated', 'AgentUpdated event is emitted'],
+      },
+      {
+        key: 'update-agent-not-found',
+        given: ['Agent does not exist'],
+        when: ['User attempts to update'],
+        then: ['AGENT_NOT_FOUND error is returned'],
+      },
+    ],
+    examples: [
+      {
+        key: 'update-name',
+        input: {
+          agentId: 'agent-123',
+          name: 'Updated Assistant',
+          systemPrompt: 'You are a helpful assistant.',
+        },
+        output: {
+          id: 'agent-123',
+          name: 'Updated Assistant',
+          status: 'draft',
+          updatedAt: '2025-01-01T00:00:00Z',
+        },
+      },
+    ],
+  },
 });
 
 /**
@@ -114,7 +185,7 @@ export const UpdateAgentCommand = defineCommand({
  */
 export const GetAgentQuery = defineQuery({
   meta: {
-    name: 'agent.agent.get',
+    key: 'agent-console.agent.get',
     version: 1,
     stability: 'stable',
     owners: [...OWNERS],
@@ -142,6 +213,34 @@ export const GetAgentQuery = defineQuery({
     },
   },
   policy: { auth: 'user' },
+  acceptance: {
+    scenarios: [
+      {
+        key: 'get-agent-happy-path',
+        given: ['Agent exists'],
+        when: ['User requests agent by ID'],
+        then: ['Agent details are returned'],
+      },
+      {
+        key: 'get-agent-with-tools',
+        given: ['Agent exists with assigned tools'],
+        when: ['User requests agent with includeTools=true'],
+        then: ['Agent details with tools list are returned'],
+      },
+    ],
+    examples: [
+      {
+        key: 'get-basic',
+        input: { agentId: 'agent-123', includeTools: false },
+        output: {
+          id: 'agent-123',
+          name: 'Support Assistant',
+          status: 'active',
+          tools: [],
+        },
+      },
+    ],
+  },
 });
 
 /**
@@ -149,7 +248,7 @@ export const GetAgentQuery = defineQuery({
  */
 export const ListAgentsQuery = defineQuery({
   meta: {
-    name: 'agent.agent.list',
+    key: 'agent-console.agent.list',
     version: 1,
     stability: 'stable',
     owners: [...OWNERS],
@@ -191,6 +290,29 @@ export const ListAgentsQuery = defineQuery({
     }),
   },
   policy: { auth: 'user' },
+  acceptance: {
+    scenarios: [
+      {
+        key: 'list-agents-happy-path',
+        given: ['Organization has agents'],
+        when: ['User lists agents'],
+        then: ['Paginated list of agents is returned'],
+      },
+      {
+        key: 'list-agents-filter-by-status',
+        given: ['Organization has agents with mixed statuses'],
+        when: ['User filters by status=active'],
+        then: ['Only active agents are returned'],
+      },
+    ],
+    examples: [
+      {
+        key: 'list-basic',
+        input: { organizationId: 'org-123', limit: 10, offset: 0 },
+        output: { items: [], total: 0, hasMore: false },
+      },
+    ],
+  },
 });
 
 /**
@@ -198,7 +320,7 @@ export const ListAgentsQuery = defineQuery({
  */
 export const AssignToolToAgentCommand = defineCommand({
   meta: {
-    name: 'agent.agent.assignTool',
+    key: 'agent-console.agent.assignTool',
     version: 1,
     stability: 'stable',
     owners: [...OWNERS],
@@ -239,6 +361,33 @@ export const AssignToolToAgentCommand = defineCommand({
   },
   policy: { auth: 'user' },
   sideEffects: { audit: ['agent.tool.assigned'] },
+  acceptance: {
+    scenarios: [
+      {
+        key: 'assign-tool-happy-path',
+        given: ['Agent exists', 'Tool exists and is not assigned'],
+        when: ['User assigns tool to agent'],
+        then: ['Tool is assigned', 'Assignment ID is returned'],
+      },
+      {
+        key: 'assign-tool-already-assigned',
+        given: ['Tool is already assigned to agent'],
+        when: ['User attempts to assign again'],
+        then: ['TOOL_ALREADY_ASSIGNED error is returned'],
+      },
+    ],
+    examples: [
+      {
+        key: 'assign-basic',
+        input: { agentId: 'agent-123', toolId: 'tool-456' },
+        output: {
+          agentToolId: 'at-789',
+          agentId: 'agent-123',
+          toolId: 'tool-456',
+        },
+      },
+    ],
+  },
 });
 
 /**
@@ -246,7 +395,7 @@ export const AssignToolToAgentCommand = defineCommand({
  */
 export const RemoveToolFromAgentCommand = defineCommand({
   meta: {
-    name: 'agent.agent.removeTool',
+    key: 'agent-console.agent.removeTool',
     version: 1,
     stability: 'stable',
     owners: [...OWNERS],
@@ -272,4 +421,21 @@ export const RemoveToolFromAgentCommand = defineCommand({
   },
   policy: { auth: 'user' },
   sideEffects: { audit: ['agent.tool.removed'] },
+  acceptance: {
+    scenarios: [
+      {
+        key: 'remove-tool-happy-path',
+        given: ['Agent exists', 'Tool is assigned to agent'],
+        when: ['User removes tool from agent'],
+        then: ['Tool is unassigned', 'Success is returned'],
+      },
+    ],
+    examples: [
+      {
+        key: 'remove-basic',
+        input: { agentId: 'agent-123', toolId: 'tool-456' },
+        output: { success: true },
+      },
+    ],
+  },
 });

package/src/agent/agent.presentation.ts

@@ -1,18 +1,23 @@
-import type { PresentationDescriptorV2 } from '@lssm/lib.contracts';
+import type { PresentationSpec } from '@lssm/lib.contracts';
+import { StabilityEnum } from '@lssm/lib.contracts';
 import { AgentSummaryModel } from './agent.schema';
 
 /**
  * Presentation for displaying a list of AI agents.
  */
-export const AgentListPresentation: PresentationDescriptorV2 = {
+export const AgentListPresentation: PresentationSpec = {
   meta: {
-    name: 'agent-console.agent.list',
+    key: 'agent-console.agent.list',
     version: 1,
+    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',
@@ -27,15 +32,19 @@ export const AgentListPresentation: PresentationDescriptorV2 = {
 /**
  * Presentation for agent detail view.
  */
-export const AgentDetailPresentation: PresentationDescriptorV2 = {
+export const AgentDetailPresentation: PresentationSpec = {
   meta: {
-    name: 'agent-console.agent.detail',
+    key: 'agent-console.agent.detail',
     version: 1,
+    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',
@@ -49,14 +58,18 @@ export const AgentDetailPresentation: PresentationDescriptorV2 = {
 /**
  * Dashboard presentation for Agent Console - overview of agents, runs, and tools.
  */
-export const AgentConsoleDashboardPresentation: PresentationDescriptorV2 = {
+export const AgentConsoleDashboardPresentation: PresentationSpec = {
   meta: {
-    name: 'agent-console.dashboard',
+    key: 'agent-console.dashboard',
     version: 1,
+    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',

package/src/agent/index.ts

@@ -27,7 +27,7 @@ export {
   ListAgentsQuery,
   AssignToolToAgentCommand,
   RemoveToolFromAgentCommand,
-} from './agent.contracts';
+} from './agent.operation';
 
 // Events
 export {

package/src/agent.feature.ts

@@ -12,122 +12,123 @@ import type { FeatureModuleSpec } from '@lssm/lib.contracts';
 export const AgentConsoleFeature: FeatureModuleSpec = {
   meta: {
     key: 'agent-console',
+    version: 1,
     title: 'AI Agent Console',
     description: 'AI agent orchestration with tools, runs, and logs management',
     domain: 'ai-ops',
     owners: ['@agent-console-team'],
     tags: ['ai', 'agents', 'orchestration'],
-    stability: 'experimental',
+    stability: 'stable',
   },
 
   // All contract operations included in this feature
   operations: [
     // Agent operations
-    { name: 'agent.agent.create', version: 1 },
-    { name: 'agent.agent.update', version: 1 },
-    { name: 'agent.agent.get', version: 1 },
-    { name: 'agent.agent.list', version: 1 },
-    { name: 'agent.agent.assignTool', version: 1 },
-    { name: 'agent.agent.removeTool', version: 1 },
+    { key: 'agent-console.agent.create', version: 1 },
+    { key: 'agent-console.agent.update', version: 1 },
+    { key: 'agent-console.agent.get', version: 1 },
+    { key: 'agent-console.agent.list', version: 1 },
+    { key: 'agent-console.agent.assignTool', version: 1 },
+    { key: 'agent-console.agent.removeTool', version: 1 },
 
     // Tool operations
-    { name: 'agent.tool.create', version: 1 },
-    { name: 'agent.tool.update', version: 1 },
-    { name: 'agent.tool.get', version: 1 },
-    { name: 'agent.tool.list', version: 1 },
-    { name: 'agent.tool.test', version: 1 },
+    { key: 'agent.tool.create', version: 1 },
+    { key: 'agent.tool.update', version: 1 },
+    { key: 'agent.tool.get', version: 1 },
+    { key: 'agent.tool.list', version: 1 },
+    { key: 'agent.tool.test', version: 1 },
 
     // Run operations
-    { name: 'agent.run.execute', version: 1 },
-    { name: 'agent.run.cancel', version: 1 },
-    { name: 'agent.run.get', version: 1 },
-    { name: 'agent.run.list', version: 1 },
-    { name: 'agent.run.getSteps', version: 1 },
-    { name: 'agent.run.getLogs', version: 1 },
-    { name: 'agent.run.getMetrics', version: 1 },
+    { key: 'agent.run.execute', version: 1 },
+    { key: 'agent.run.cancel', version: 1 },
+    { key: 'agent.run.get', version: 1 },
+    { key: 'agent.run.list', version: 1 },
+    { key: 'agent.run.getSteps', version: 1 },
+    { key: 'agent.run.getLogs', version: 1 },
+    { key: 'agent.run.getMetrics', version: 1 },
   ],
 
   // Events emitted by this feature
   events: [
     // Agent events
-    { name: 'agent.agent.created', version: 1 },
-    { name: 'agent.agent.updated', version: 1 },
-    { name: 'agent.agent.toolAssigned', version: 1 },
-    { name: 'agent.agent.toolRemoved', version: 1 },
+    { key: 'agent-console.agent.created', version: 1 },
+    { key: 'agent-console.agent.updated', version: 1 },
+    { key: 'agent-console.agent.toolAssigned', version: 1 },
+    { key: 'agent-console.agent.toolRemoved', version: 1 },
 
     // Tool events
-    { name: 'agent.tool.created', version: 1 },
-    { name: 'agent.tool.updated', version: 1 },
-    { name: 'agent.tool.statusChanged', version: 1 },
+    { key: 'agent.tool.created', version: 1 },
+    { key: 'agent.tool.updated', version: 1 },
+    { key: 'agent.tool.statusChanged', version: 1 },
 
     // Run events
-    { name: 'agent.run.started', version: 1 },
-    { name: 'agent.run.completed', version: 1 },
-    { name: 'agent.run.failed', version: 1 },
-    { name: 'agent.run.cancelled', version: 1 },
-    { name: 'agent.run.toolInvoked', version: 1 },
-    { name: 'agent.run.toolCompleted', version: 1 },
-    { name: 'agent.run.messageGenerated', version: 1 },
+    { key: 'agent.run.started', version: 1 },
+    { key: 'agent.run.completed', version: 1 },
+    { key: 'agent.run.failed', version: 1 },
+    { key: 'agent.run.cancelled', version: 1 },
+    { key: 'agent.run.toolInvoked', version: 1 },
+    { key: 'agent.run.toolCompleted', version: 1 },
+    { key: 'agent.run.messageGenerated', version: 1 },
   ],
 
   // Presentations associated with this feature
   presentations: [
-    { name: 'agent-console.dashboard', version: 1 },
-    { name: 'agent-console.agent.list', version: 1 },
-    { name: 'agent-console.agent.detail', version: 1 },
-    { name: 'agent-console.run.list', version: 1 },
-    { name: 'agent-console.run.detail', version: 1 },
-    { name: 'agent-console.tool.list', version: 1 },
-    { name: 'agent-console.tool.detail', version: 1 },
+    { key: 'agent-console.dashboard', version: 1 },
+    { key: 'agent-console.agent.list', version: 1 },
+    { key: 'agent-console.agent.detail', version: 1 },
+    { key: 'agent-console.run.list', version: 1 },
+    { key: 'agent-console.run.detail', version: 1 },
+    { key: 'agent-console.tool.list', version: 1 },
+    { key: 'agent-console.tool.detail', version: 1 },
   ],
 
   // Link operations to their primary presentations
   opToPresentation: [
     {
-      op: { name: 'agent.agent.list', version: 1 },
-      pres: { name: 'agent-console.agent.list', version: 1 },
+      op: { key: 'agent-console.agent.list', version: 1 },
+      pres: { key: 'agent-console.agent.list', version: 1 },
     },
     {
-      op: { name: 'agent.agent.get', version: 1 },
-      pres: { name: 'agent-console.agent.detail', version: 1 },
+      op: { key: 'agent-console.agent.get', version: 1 },
+      pres: { key: 'agent-console.agent.detail', version: 1 },
     },
     {
-      op: { name: 'agent.run.list', version: 1 },
-      pres: { name: 'agent-console.run.list', version: 1 },
+      op: { key: 'agent.run.list', version: 1 },
+      pres: { key: 'agent-console.run.list', version: 1 },
     },
     {
-      op: { name: 'agent.run.get', version: 1 },
-      pres: { name: 'agent-console.run.detail', version: 1 },
+      op: { key: 'agent.run.get', version: 1 },
+      pres: { key: 'agent-console.run.detail', version: 1 },
     },
     {
-      op: { name: 'agent.tool.list', version: 1 },
-      pres: { name: 'agent-console.tool.list', version: 1 },
+      op: { key: 'agent.tool.list', version: 1 },
+      pres: { key: 'agent-console.tool.list', version: 1 },
     },
     {
-      op: { name: 'agent.tool.get', version: 1 },
-      pres: { name: 'agent-console.tool.detail', version: 1 },
+      op: { key: 'agent.tool.get', version: 1 },
+      pres: { key: 'agent-console.tool.detail', version: 1 },
     },
   ],
 
   // Target requirements for multi-surface rendering
   presentationsTargets: [
     {
-      name: 'agent-console.dashboard',
+      key: 'agent-console.dashboard',
       version: 1,
       targets: ['react', 'markdown'],
     },
     {
-      name: 'agent-console.agent.list',
+      key: 'agent-console.agent.list',
       version: 1,
       targets: ['react', 'markdown', 'application/json'],
     },
     {
-      name: 'agent-console.run.list',
+      key: 'agent-console.run.list',
       version: 1,
       targets: ['react', 'markdown', 'application/json'],
     },
     {
-      name: 'agent-console.tool.list',
+      key: 'agent-console.tool.list',
       version: 1,
       targets: ['react', 'markdown', 'application/json'],
     },
@@ -140,5 +141,6 @@ export const AgentConsoleFeature: FeatureModuleSpec = {
       { key: 'audit-trail', version: 1 },
       { key: 'jobs', version: 1 },
     ],
+    provides: [{ key: 'agent', version: 1 }],
   },
 };

package/src/run/index.ts

@@ -30,7 +30,7 @@ export {
   GetRunStepsQuery,
   GetRunLogsQuery,
   GetRunMetricsQuery,
-} from './run.contracts';
+} from './run.operation';
 
 // Events
 export {

package/src/run/run.entity.ts

@@ -1,9 +1,4 @@
-import {
-  defineEntity,
-  defineEntityEnum,
-  field,
-  index,
-} from '@lssm/lib.schema/entity';
+import { defineEntity, defineEntityEnum, field, index } from '@lssm/lib.schema';
 
 /**
  * Run status enum for entities.