@lssm/example.agent-console 1.41.0 → 1.42.2

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

@@ -1,21 +1,21 @@
-import { defineCommand, defineQuery } from '@lssm/lib.contracts/spec';
+import { defineCommand, defineQuery } from '@lssm/lib.contracts/operations';
 import { defineSchemaModel, ScalarTypeEnum } from '@lssm/lib.schema';
 import { ToolCategoryEnum, ToolStatusEnum } from './tool.enum';
 import {
+  CreateToolInputModel,
   ToolModel,
   ToolSummaryModel,
-  CreateToolInputModel,
   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,14 +48,50 @@ 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,
       },
     ],
     audit: ['tool.created'],
   },
+  acceptance: {
+    scenarios: [
+      {
+        key: 'create-tool-happy-path',
+        given: ['User is authenticated', 'Organization exists'],
+        when: ['User submits valid tool configuration'],
+        then: ['New tool is created', 'ToolCreated event is emitted'],
+      },
+      {
+        key: 'create-tool-slug-conflict',
+        given: ['Tool with same slug exists'],
+        when: ['User submits tool with duplicate slug'],
+        then: ['SLUG_EXISTS error is returned'],
+      },
+    ],
+    examples: [
+      {
+        key: 'create-api-tool',
+        input: {
+          name: 'Weather API',
+          slug: 'weather-api',
+          category: 'api',
+          description: 'Fetches weather data',
+        },
+        output: {
+          id: 'tool-123',
+          name: 'Weather API',
+          slug: 'weather-api',
+          status: 'draft',
+        },
+      },
+    ],
+  },
 });
 
 /**
@@ -63,7 +99,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,14 +132,39 @@ 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,
       },
     ],
     audit: ['tool.updated'],
   },
+  acceptance: {
+    scenarios: [
+      {
+        key: 'update-tool-happy-path',
+        given: ['Tool exists', 'User owns the tool'],
+        when: ['User submits updated configuration'],
+        then: ['Tool is updated', 'ToolUpdated event is emitted'],
+      },
+    ],
+    examples: [
+      {
+        key: 'update-description',
+        input: { toolId: 'tool-123', description: 'Updated weather API tool' },
+        output: {
+          id: 'tool-123',
+          name: 'Weather API',
+          status: 'draft',
+          updatedAt: '2025-01-01T00:00:00Z',
+        },
+      },
+    ],
+  },
 });
 
 /**
@@ -111,7 +172,7 @@ export const UpdateToolCommand = defineCommand({
  */
 export const GetToolQuery = defineQuery({
   meta: {
-    name: 'agent.tool.get',
+    key: 'agent.tool.get',
     version: 1,
     stability: 'stable',
     owners: [...OWNERS],
@@ -138,6 +199,28 @@ export const GetToolQuery = defineQuery({
     },
   },
   policy: { auth: 'user' },
+  acceptance: {
+    scenarios: [
+      {
+        key: 'get-tool-happy-path',
+        given: ['Tool exists'],
+        when: ['User requests tool by ID'],
+        then: ['Tool details are returned'],
+      },
+    ],
+    examples: [
+      {
+        key: 'get-basic',
+        input: { toolId: 'tool-123' },
+        output: {
+          id: 'tool-123',
+          name: 'Weather API',
+          status: 'active',
+          category: 'api',
+        },
+      },
+    ],
+  },
 });
 
 /**
@@ -145,7 +228,7 @@ export const GetToolQuery = defineQuery({
  */
 export const ListToolsQuery = defineQuery({
   meta: {
-    name: 'agent.tool.list',
+    key: 'agent.tool.list',
     version: 1,
     stability: 'stable',
     owners: [...OWNERS],
@@ -187,6 +270,23 @@ export const ListToolsQuery = defineQuery({
     }),
   },
   policy: { auth: 'user' },
+  acceptance: {
+    scenarios: [
+      {
+        key: 'list-tools-happy-path',
+        given: ['Organization has tools'],
+        when: ['User lists tools'],
+        then: ['Paginated list of tools is returned'],
+      },
+    ],
+    examples: [
+      {
+        key: 'list-by-category',
+        input: { organizationId: 'org-123', category: 'api', limit: 10 },
+        output: { items: [], total: 0, hasMore: false },
+      },
+    ],
+  },
 });
 
 /**
@@ -194,7 +294,7 @@ export const ListToolsQuery = defineQuery({
  */
 export const TestToolCommand = defineCommand({
   meta: {
-    name: 'agent.tool.test',
+    key: 'agent.tool.test',
     version: 1,
     stability: 'stable',
     owners: [...OWNERS],
@@ -237,4 +337,27 @@ export const TestToolCommand = defineCommand({
   },
   policy: { auth: 'user' },
   sideEffects: { audit: ['tool.tested'] },
+  acceptance: {
+    scenarios: [
+      {
+        key: 'test-tool-success',
+        given: ['Tool exists', 'Tool is configured correctly'],
+        when: ['User runs test with valid input'],
+        then: ['Tool executes successfully', 'Output is returned'],
+      },
+      {
+        key: 'test-tool-failure',
+        given: ['Tool exists', 'Tool has configuration error'],
+        when: ['User runs test'],
+        then: ['TOOL_EXECUTION_ERROR is returned'],
+      },
+    ],
+    examples: [
+      {
+        key: 'test-weather-api',
+        input: { toolId: 'tool-123', testInput: { city: 'Paris' } },
+        output: { success: true, output: { temperature: 22 }, durationMs: 150 },
+      },
+    ],
+  },
 });

package/src/tool/tool.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 { ToolSummaryModel } from './tool.schema';
 
 /**
  * Presentation for displaying a list of tools.
  */
-export const ToolListPresentation: PresentationDescriptorV2 = {
+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',
@@ -27,15 +32,19 @@ export const ToolListPresentation: PresentationDescriptorV2 = {
 /**
  * Presentation for tool detail view.
  */
-export const ToolDetailPresentation: PresentationDescriptorV2 = {
+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',