@lssm/example.agent-console 0.0.0-canary-20251223215909 → 0.0.0-canary-20251225044228

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/run.event.ts

@@ -1,6 +1,8 @@
 import { defineEvent, defineSchemaModel } from '@lssm/lib.contracts';
 import { ScalarTypeEnum, defineEnum } from '@lssm/lib.schema';
 
+const OWNERS = ['@agent-console-team'] as const;
+
 /**
  * Payload for run started event.
  */
@@ -26,9 +28,14 @@ const RunStartedPayload = defineSchemaModel({
  * RunStartedEvent - An agent run was started.
  */
 export const RunStartedEvent = defineEvent({
-  name: 'agent.run.started',
-  version: 1,
-  description: 'An agent run was started.',
+  meta: {
+    key: 'agent.run.started',
+    version: 1,
+    description: 'An agent run was started.',
+    stability: 'stable',
+    owners: [...OWNERS],
+    tags: ['run', 'started'],
+  },
   payload: RunStartedPayload,
 });
 
@@ -68,9 +75,14 @@ const RunCompletedPayload = defineSchemaModel({
  * RunCompletedEvent - An agent run completed successfully.
  */
 export const RunCompletedEvent = defineEvent({
-  name: 'agent.run.completed',
-  version: 1,
-  description: 'An agent run completed successfully.',
+  meta: {
+    key: 'agent.run.completed',
+    version: 1,
+    description: 'An agent run completed successfully.',
+    stability: 'stable',
+    owners: [...OWNERS],
+    tags: ['run', 'completed'],
+  },
   payload: RunCompletedPayload,
 });
 
@@ -102,9 +114,14 @@ const RunFailedPayload = defineSchemaModel({
  * RunFailedEvent - An agent run failed.
  */
 export const RunFailedEvent = defineEvent({
-  name: 'agent.run.failed',
-  version: 1,
-  description: 'An agent run encountered an error.',
+  meta: {
+    key: 'agent.run.failed',
+    version: 1,
+    description: 'An agent run encountered an error.',
+    stability: 'stable',
+    owners: [...OWNERS],
+    tags: ['run', 'failed'],
+  },
   payload: RunFailedPayload,
 });
 
@@ -134,9 +151,14 @@ const RunCancelledPayload = defineSchemaModel({
  * RunCancelledEvent - An agent run was cancelled.
  */
 export const RunCancelledEvent = defineEvent({
-  name: 'agent.run.cancelled',
-  version: 1,
-  description: 'An agent run was cancelled by the user.',
+  meta: {
+    key: 'agent.run.cancelled',
+    version: 1,
+    description: 'An agent run was cancelled by the user.',
+    stability: 'stable',
+    owners: [...OWNERS],
+    tags: ['run', 'cancelled'],
+  },
   payload: RunCancelledPayload,
 });
 
@@ -160,9 +182,14 @@ const ToolInvokedPayload = defineSchemaModel({
  * ToolInvokedEvent - A tool was invoked during a run.
  */
 export const ToolInvokedEvent = defineEvent({
-  name: 'agent.run.toolInvoked',
-  version: 1,
-  description: 'A tool was invoked during an agent run.',
+  meta: {
+    key: 'agent.run.toolInvoked',
+    version: 1,
+    description: 'A tool was invoked during an agent run.',
+    stability: 'stable',
+    owners: [...OWNERS],
+    tags: ['run', 'tool', 'invoked'],
+  },
   payload: ToolInvokedPayload,
 });
 
@@ -189,9 +216,14 @@ const ToolCompletedPayload = defineSchemaModel({
  * ToolCompletedEvent - A tool invocation completed.
  */
 export const ToolCompletedEvent = defineEvent({
-  name: 'agent.run.toolCompleted',
-  version: 1,
-  description: 'A tool invocation completed during an agent run.',
+  meta: {
+    key: 'agent.run.toolCompleted',
+    version: 1,
+    description: 'A tool invocation completed during an agent run.',
+    stability: 'stable',
+    owners: [...OWNERS],
+    tags: ['run', 'tool', 'completed'],
+  },
   payload: ToolCompletedPayload,
 });
 
@@ -220,8 +252,13 @@ const MessageGeneratedPayload = defineSchemaModel({
  * MessageGeneratedEvent - Agent generated a message.
  */
 export const MessageGeneratedEvent = defineEvent({
-  name: 'agent.run.messageGenerated',
-  version: 1,
-  description: 'An agent generated a message during a run.',
+  meta: {
+    key: 'agent.run.messageGenerated',
+    version: 1,
+    description: 'An agent generated a message during a run.',
+    stability: 'stable',
+    owners: [...OWNERS],
+    tags: ['run', 'message', 'generated'],
+  },
   payload: MessageGeneratedPayload,
 });

package/src/run/run.operation.ts

@@ -10,14 +10,14 @@ import {
   TimelineDataPointModel,
 } from './run.schema';
 
-const OWNERS = ['agent-console-team'] as const;
+const OWNERS = ['@agent-console-team'] as const;
 
 /**
  * ExecuteAgentCommand - Starts a new agent run.
  */
 export const ExecuteAgentCommand = defineCommand({
   meta: {
-    name: 'agent.run.execute',
+    key: 'agent.run.execute',
     version: 1,
     stability: 'stable',
     owners: [...OWNERS],
@@ -72,8 +72,11 @@ export const ExecuteAgentCommand = defineCommand({
   sideEffects: {
     emits: [
       {
-        name: 'run.started',
+        key: 'run.started',
         version: 1,
+        stability: 'stable',
+        owners: [...OWNERS],
+        tags: ['run', 'started'],
         when: 'Run is queued',
         payload: RunSummaryModel,
       },
@@ -87,7 +90,7 @@ export const ExecuteAgentCommand = defineCommand({
  */
 export const CancelRunCommand = defineCommand({
   meta: {
-    name: 'agent.run.cancel',
+    key: 'agent.run.cancel',
     version: 1,
     stability: 'stable',
     owners: [...OWNERS],
@@ -130,8 +133,11 @@ export const CancelRunCommand = defineCommand({
   sideEffects: {
     emits: [
       {
-        name: 'run.cancelled',
+        key: 'run.cancelled',
         version: 1,
+        stability: 'stable',
+        owners: [...OWNERS],
+        tags: ['run', 'cancelled'],
         when: 'Run is cancelled',
         payload: RunSummaryModel,
       },
@@ -145,7 +151,7 @@ export const CancelRunCommand = defineCommand({
  */
 export const GetRunQuery = defineQuery({
   meta: {
-    name: 'agent.run.get',
+    key: 'agent.run.get',
     version: 1,
     stability: 'stable',
     owners: [...OWNERS],
@@ -181,7 +187,7 @@ export const GetRunQuery = defineQuery({
  */
 export const ListRunsQuery = defineQuery({
   meta: {
-    name: 'agent.run.list',
+    key: 'agent.run.list',
     version: 1,
     stability: 'stable',
     owners: [...OWNERS],
@@ -233,7 +239,7 @@ export const ListRunsQuery = defineQuery({
  */
 export const GetRunStepsQuery = defineQuery({
   meta: {
-    name: 'agent.run.getSteps',
+    key: 'agent.run.getSteps',
     version: 1,
     stability: 'stable',
     owners: [...OWNERS],
@@ -264,7 +270,7 @@ export const GetRunStepsQuery = defineQuery({
  */
 export const GetRunLogsQuery = defineQuery({
   meta: {
-    name: 'agent.run.getLogs',
+    key: 'agent.run.getLogs',
     version: 1,
     stability: 'stable',
     owners: [...OWNERS],
@@ -309,7 +315,7 @@ export const GetRunLogsQuery = defineQuery({
  */
 export const GetRunMetricsQuery = defineQuery({
   meta: {
-    name: 'agent.run.getMetrics',
+    key: 'agent.run.getMetrics',
     version: 1,
     stability: 'stable',
     owners: [...OWNERS],

package/src/run/run.presentation.ts

@@ -1,4 +1,5 @@
 import type { PresentationSpec } from '@lssm/lib.contracts';
+import { StabilityEnum } from '@lssm/lib.contracts';
 import { RunSummaryModel } from './run.schema';
 
 /**
@@ -6,13 +7,17 @@ import { RunSummaryModel } from './run.schema';
  */
 export const RunListPresentation: PresentationSpec = {
   meta: {
-    name: 'agent-console.run.list',
+    key: 'agent-console.run.list',
     version: 1,
+    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',
@@ -29,12 +34,16 @@ export const RunListPresentation: PresentationSpec = {
  */
 export const RunDetailPresentation: PresentationSpec = {
   meta: {
-    name: 'agent-console.run.detail',
+    key: 'agent-console.run.detail',
     version: 1,
+    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',

package/src/tool/tool.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 tool created event.
  */
@@ -29,9 +31,14 @@ const ToolCreatedPayload = defineSchemaModel({
  * ToolCreatedEvent - A new tool was created.
  */
 export const ToolCreatedEvent = defineEvent({
-  name: 'agent.tool.created',
-  version: 1,
-  description: 'A new AI tool was created.',
+  meta: {
+    key: 'agent.tool.created',
+    version: 1,
+    description: 'A new AI tool was created.',
+    stability: 'stable',
+    owners: [...OWNERS],
+    tags: ['tool', 'created'],
+  },
   payload: ToolCreatedPayload,
 });
 
@@ -62,9 +69,14 @@ const ToolUpdatedPayload = defineSchemaModel({
  * ToolUpdatedEvent - A tool was updated.
  */
 export const ToolUpdatedEvent = defineEvent({
-  name: 'agent.tool.updated',
-  version: 1,
-  description: 'An AI tool configuration was updated.',
+  meta: {
+    key: 'agent.tool.updated',
+    version: 1,
+    description: 'An AI tool configuration was updated.',
+    stability: 'stable',
+    owners: [...OWNERS],
+    tags: ['tool', 'updated'],
+  },
   payload: ToolUpdatedPayload,
 });
 
@@ -94,9 +106,14 @@ const ToolStatusChangedPayload = defineSchemaModel({
  * ToolStatusChangedEvent - A tool's status was changed.
  */
 export const ToolStatusChangedEvent = defineEvent({
-  name: 'agent.tool.statusChanged',
-  version: 1,
-  description:
-    'An AI tool status was changed (activated, deprecated, disabled).',
+  meta: {
+    key: 'agent.tool.statusChanged',
+    version: 1,
+    description:
+      'An AI tool status was changed (activated, deprecated, disabled).',
+    stability: 'stable',
+    owners: [...OWNERS],
+    tags: ['tool', 'status'],
+  },
   payload: ToolStatusChangedPayload,
 });

package/src/tool/tool.operation.ts

@@ -8,14 +8,14 @@ import {
   UpdateToolInputModel,
 } from './tool.schema';
 
-const OWNERS = ['agent-console-team'] as const;
+const OWNERS = ['@agent-console-team'] as const;
 
 /**
  * CreateToolCommand - Creates a new tool definition.
  */
 export const CreateToolCommand = defineCommand({
   meta: {
-    name: 'agent.tool.create',
+    key: 'agent.tool.create',
     version: 1,
     stability: 'stable',
     owners: [...OWNERS],
@@ -48,8 +48,11 @@ export const CreateToolCommand = defineCommand({
   sideEffects: {
     emits: [
       {
-        name: 'tool.created',
+        key: 'tool.created',
         version: 1,
+        stability: 'stable',
+        owners: [...OWNERS],
+        tags: ['tool', 'created'],
         when: 'Tool is successfully created',
         payload: ToolSummaryModel,
       },
@@ -63,7 +66,7 @@ export const CreateToolCommand = defineCommand({
  */
 export const UpdateToolCommand = defineCommand({
   meta: {
-    name: 'agent.tool.update',
+    key: 'agent.tool.update',
     version: 1,
     stability: 'stable',
     owners: [...OWNERS],
@@ -96,8 +99,11 @@ export const UpdateToolCommand = defineCommand({
   sideEffects: {
     emits: [
       {
-        name: 'tool.updated',
+        key: 'tool.updated',
         version: 1,
+        stability: 'stable',
+        owners: [...OWNERS],
+        tags: ['tool', 'updated'],
         when: 'Tool is updated',
         payload: ToolSummaryModel,
       },
@@ -111,7 +117,7 @@ export const UpdateToolCommand = defineCommand({
  */
 export const GetToolQuery = defineQuery({
   meta: {
-    name: 'agent.tool.get',
+    key: 'agent.tool.get',
     version: 1,
     stability: 'stable',
     owners: [...OWNERS],
@@ -145,7 +151,7 @@ export const GetToolQuery = defineQuery({
  */
 export const ListToolsQuery = defineQuery({
   meta: {
-    name: 'agent.tool.list',
+    key: 'agent.tool.list',
     version: 1,
     stability: 'stable',
     owners: [...OWNERS],
@@ -194,7 +200,7 @@ export const ListToolsQuery = defineQuery({
  */
 export const TestToolCommand = defineCommand({
   meta: {
-    name: 'agent.tool.test',
+    key: 'agent.tool.test',
     version: 1,
     stability: 'stable',
     owners: [...OWNERS],

package/src/tool/tool.presentation.ts

@@ -1,4 +1,5 @@
 import type { PresentationSpec } from '@lssm/lib.contracts';
+import { StabilityEnum } from '@lssm/lib.contracts';
 import { ToolSummaryModel } from './tool.schema';
 
 /**
@@ -6,13 +7,17 @@ import { ToolSummaryModel } from './tool.schema';
  */
 export const ToolListPresentation: PresentationSpec = {
   meta: {
-    name: 'agent-console.tool.list',
+    key: 'agent-console.tool.list',
     version: 1,
+    title: 'Tool List',
     description:
       'List view of AI tools with category, status, and version info',
+    goal: 'Provide an overview of all available tools for agents.',
+    context: 'Tool management dashboard.',
     domain: 'agent-console',
     owners: ['@agent-console-team'],
     tags: ['tool', 'list', 'dashboard'],
+    stability: StabilityEnum.Experimental,
   },
   source: {
     type: 'component',
@@ -29,13 +34,17 @@ export const ToolListPresentation: PresentationSpec = {
  */
 export const ToolDetailPresentation: PresentationSpec = {
   meta: {
-    name: 'agent-console.tool.detail',
+    key: 'agent-console.tool.detail',
     version: 1,
+    title: 'Tool Details',
     description:
       'Detailed view of an AI tool with configuration and test panel',
+    goal: 'Allow users to inspect and test a specific tool.',
+    context: 'Detailed view of a tool.',
     domain: 'agent-console',
     owners: ['@agent-console-team'],
     tags: ['tool', 'detail'],
+    stability: StabilityEnum.Experimental,
   },
   source: {
     type: 'component',