@lssm/example.agent-console 0.0.0-canary-20251206160926

package/src/events.ts

@@ -0,0 +1,419 @@
+import { defineEvent, defineSchemaModel } from '@lssm/lib.contracts';
+import { ScalarTypeEnum, defineEnum } from '@lssm/lib.schema';
+
+// ============================================
+// Tool Events
+// ============================================
+
+export const ToolCreatedPayload = defineSchemaModel({
+  name: 'ToolCreatedPayload',
+  description: 'Payload for tool created event',
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    organizationId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false,
+    },
+    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    slug: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    category: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    implementationType: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false,
+    },
+    createdById: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+  },
+});
+
+/**
+ * ToolCreatedEvent - A new tool was created
+ */
+export const ToolCreatedEvent = defineEvent({
+  name: 'agent.tool.created',
+  version: 1,
+  description: 'A new AI tool was created.',
+  payload: ToolCreatedPayload,
+});
+
+export const ToolUpdatedPayload = defineSchemaModel({
+  name: 'ToolUpdatedPayload',
+  description: 'Payload for tool updated event',
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    organizationId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false,
+    },
+    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    status: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    updatedFields: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isArray: true,
+      isOptional: false,
+    },
+    updatedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+  },
+});
+
+/**
+ * ToolUpdatedEvent - A tool was updated
+ */
+export const ToolUpdatedEvent = defineEvent({
+  name: 'agent.tool.updated',
+  version: 1,
+  description: 'An AI tool configuration was updated.',
+  payload: ToolUpdatedPayload,
+});
+
+export const ToolStatusChangedPayload = defineSchemaModel({
+  name: 'ToolStatusChangedPayload',
+  description: 'Payload for tool status changed event',
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    organizationId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false,
+    },
+    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    previousStatus: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false,
+    },
+    newStatus: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    changedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+  },
+});
+
+/**
+ * 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).',
+  payload: ToolStatusChangedPayload,
+});
+
+// ============================================
+// Agent Events
+// ============================================
+
+export const AgentCreatedPayload = defineSchemaModel({
+  name: 'AgentCreatedPayload',
+  description: 'Payload for agent created event',
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    organizationId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false,
+    },
+    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    slug: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    modelProvider: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false,
+    },
+    modelName: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    toolCount: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    createdById: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+  },
+});
+
+/**
+ * AgentCreatedEvent - A new agent was created
+ */
+export const AgentCreatedEvent = defineEvent({
+  name: 'agent.agent.created',
+  version: 1,
+  description: 'A new AI agent was configured.',
+  payload: AgentCreatedPayload,
+});
+
+export const AgentUpdatedPayload = defineSchemaModel({
+  name: 'AgentUpdatedPayload',
+  description: 'Payload for agent updated event',
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    organizationId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false,
+    },
+    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    status: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    updatedFields: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isArray: true,
+      isOptional: false,
+    },
+    updatedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+  },
+});
+
+/**
+ * AgentUpdatedEvent - An agent was updated
+ */
+export const AgentUpdatedEvent = defineEvent({
+  name: 'agent.agent.updated',
+  version: 1,
+  description: 'An AI agent configuration was updated.',
+  payload: AgentUpdatedPayload,
+});
+
+export const AgentToolAssignedPayload = defineSchemaModel({
+  name: 'AgentToolAssignedPayload',
+  description: 'Payload for agent tool assigned event',
+  fields: {
+    agentId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    toolId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    agentName: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    toolName: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    assignedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+  },
+});
+
+/**
+ * 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.',
+  payload: AgentToolAssignedPayload,
+});
+
+export const AgentToolRemovedPayload = defineSchemaModel({
+  name: 'AgentToolRemovedPayload',
+  description: 'Payload for agent tool removed event',
+  fields: {
+    agentId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    toolId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    agentName: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    toolName: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    removedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+  },
+});
+
+/**
+ * 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.',
+  payload: AgentToolRemovedPayload,
+});
+
+// ============================================
+// Run Events
+// ============================================
+
+export const RunStartedPayload = defineSchemaModel({
+  name: 'RunStartedPayload',
+  description: 'Payload for run started event',
+  fields: {
+    runId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    organizationId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false,
+    },
+    agentId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    agentName: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    userId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    sessionId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    input: { type: ScalarTypeEnum.JSONObject(), isOptional: false },
+    startedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+  },
+});
+
+/**
+ * RunStartedEvent - An agent run was started
+ */
+export const RunStartedEvent = defineEvent({
+  name: 'agent.run.started',
+  version: 1,
+  description: 'An agent run was started.',
+  payload: RunStartedPayload,
+});
+
+export const RunCompletedPayload = defineSchemaModel({
+  name: 'RunCompletedPayload',
+  description: 'Payload for run completed event',
+  fields: {
+    runId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    organizationId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false,
+    },
+    agentId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    agentName: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    userId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    output: { type: ScalarTypeEnum.JSONObject(), isOptional: false },
+    totalTokens: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    promptTokens: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    completionTokens: {
+      type: ScalarTypeEnum.Int_unsecure(),
+      isOptional: false,
+    },
+    totalIterations: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    durationMs: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    estimatedCostUsd: {
+      type: ScalarTypeEnum.Float_unsecure(),
+      isOptional: true,
+    },
+    completedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+  },
+});
+
+/**
+ * RunCompletedEvent - An agent run completed successfully
+ */
+export const RunCompletedEvent = defineEvent({
+  name: 'agent.run.completed',
+  version: 1,
+  description: 'An agent run completed successfully.',
+  payload: RunCompletedPayload,
+});
+
+export const RunFailedPayload = defineSchemaModel({
+  name: 'RunFailedPayload',
+  description: 'Payload for run failed event',
+  fields: {
+    runId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    organizationId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false,
+    },
+    agentId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    agentName: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    userId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    errorMessage: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    errorCode: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    totalTokens: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    totalIterations: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    durationMs: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+    failedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+  },
+});
+
+/**
+ * RunFailedEvent - An agent run failed
+ */
+export const RunFailedEvent = defineEvent({
+  name: 'agent.run.failed',
+  version: 1,
+  description: 'An agent run encountered an error.',
+  payload: RunFailedPayload,
+});
+
+export const RunCancelledPayload = defineSchemaModel({
+  name: 'RunCancelledPayload',
+  description: 'Payload for run cancelled event',
+  fields: {
+    runId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    organizationId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false,
+    },
+    agentId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    userId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    cancelledBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    reason: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    totalTokens: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    totalIterations: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    cancelledAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+  },
+});
+
+/**
+ * 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.',
+  payload: RunCancelledPayload,
+});
+
+// ============================================
+// Step Events
+// ============================================
+
+export const ToolInvokedPayload = defineSchemaModel({
+  name: 'ToolInvokedPayload',
+  description: 'Payload for tool invoked event',
+  fields: {
+    runId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    stepId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    toolId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    toolName: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    input: { type: ScalarTypeEnum.JSONObject(), isOptional: false },
+    invokedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+  },
+});
+
+/**
+ * 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.',
+  payload: ToolInvokedPayload,
+});
+
+export const ToolCompletedPayload = defineSchemaModel({
+  name: 'ToolCompletedPayload',
+  description: 'Payload for tool completed event',
+  fields: {
+    runId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    stepId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    toolId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    toolName: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    success: { type: ScalarTypeEnum.Boolean(), isOptional: false },
+    output: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
+    errorMessage: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    durationMs: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    completedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+  },
+});
+
+/**
+ * ToolCompletedEvent - A tool invocation completed
+ */
+export const ToolCompletedEvent = defineEvent({
+  name: 'agent.run.toolCompleted',
+  version: 1,
+  description: 'A tool invocation completed during an agent run.',
+  payload: ToolCompletedPayload,
+});
+
+export const MessageTypeEnum = defineEnum('MessageType', [
+  'assistant',
+  'system',
+]);
+
+export const MessageGeneratedPayload = defineSchemaModel({
+  name: 'MessageGeneratedPayload',
+  description: 'Payload for message generated event',
+  fields: {
+    runId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    stepId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    messageType: { type: MessageTypeEnum, isOptional: false },
+    content: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    tokensUsed: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    generatedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+  },
+});
+
+/**
+ * MessageGeneratedEvent - Agent generated a message
+ */
+export const MessageGeneratedEvent = defineEvent({
+  name: 'agent.run.messageGenerated',
+  version: 1,
+  description: 'An agent generated a message during a run.',
+  payload: MessageGeneratedPayload,
+});

package/src/feature.ts

@@ -0,0 +1,144 @@
+/**
+ * Agent Console Feature Module Specification
+ *
+ * Defines the feature module for agent orchestration capabilities.
+ */
+import type { FeatureModuleSpec } from '@lssm/lib.contracts';
+
+/**
+ * Agent Console feature module that bundles all agent, tool, and run
+ * operations, events, and presentations into an installable feature.
+ */
+export const AgentConsoleFeature: FeatureModuleSpec = {
+  meta: {
+    key: 'agent-console',
+    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',
+  },
+
+  // 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 },
+
+    // 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 },
+
+    // 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 },
+  ],
+
+  // Events emitted by this feature
+  events: [
+    // Agent events
+    { name: 'agent.created', version: 1 },
+    { name: 'agent.updated', version: 1 },
+    { name: 'agent.deleted', version: 1 },
+
+    // Tool events
+    { name: 'tool.created', version: 1 },
+    { name: 'tool.updated', version: 1 },
+
+    // Run events
+    { name: 'run.started', version: 1 },
+    { name: 'run.completed', version: 1 },
+    { name: 'run.failed', version: 1 },
+    { name: 'run.cancelled', 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.run.metrics', version: 1 },
+    { name: 'agent-console.tool.registry', version: 1 },
+    { name: '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: { name: 'agent.agent.get', version: 1 },
+      pres: { name: 'agent-console.agent.detail', version: 1 },
+    },
+    {
+      op: { name: 'agent.run.list', version: 1 },
+      pres: { name: 'agent-console.run.list', version: 1 },
+    },
+    {
+      op: { name: 'agent.run.get', version: 1 },
+      pres: { name: 'agent-console.run.detail', version: 1 },
+    },
+    {
+      op: { name: 'agent.run.getMetrics', version: 1 },
+      pres: { name: 'agent-console.run.metrics', version: 1 },
+    },
+    {
+      op: { name: 'agent.tool.list', version: 1 },
+      pres: { name: 'agent-console.tool.registry', version: 1 },
+    },
+    {
+      op: { name: 'agent.tool.get', version: 1 },
+      pres: { name: 'agent-console.tool.detail', version: 1 },
+    },
+  ],
+
+  // Target requirements for multi-surface rendering
+  presentationsTargets: [
+    {
+      name: 'agent-console.dashboard',
+      version: 1,
+      targets: ['react', 'markdown'],
+    },
+    {
+      name: 'agent-console.agent.list',
+      version: 1,
+      targets: ['react', 'markdown', 'application/json'],
+    },
+    {
+      name: 'agent-console.run.list',
+      version: 1,
+      targets: ['react', 'markdown', 'application/json'],
+    },
+    {
+      name: 'agent-console.tool.registry',
+      version: 1,
+      targets: ['react', 'markdown', 'application/json'],
+    },
+  ],
+
+  // Capability requirements
+  capabilities: {
+    requires: [
+      { key: 'identity', version: 1 },
+      { key: 'audit-trail', version: 1 },
+      { key: 'jobs', version: 1 },
+    ],
+  },
+};