@contractspec/example.agent-console 3.7.6 → 3.8.2

package/src/shared/mock-tools.ts

@@ -2,144 +2,144 @@
  * Mock tool data for testing and demos.
  */
 export const MOCK_TOOLS = [
-  {
-    id: 'tool-1',
-    organizationId: 'demo-org',
-    name: 'Web Search',
-    slug: 'web-search',
-    description: 'Search the web for real-time information using Brave API.',
-    category: 'RETRIEVAL' as const,
-    status: 'ACTIVE' as const,
-    parametersSchema: {
-      type: 'object',
-      properties: {
-        query: { type: 'string', description: 'Search query' },
-        numResults: { type: 'number', default: 10 },
-      },
-      required: ['query'],
-    },
-    outputSchema: { type: 'array', items: { type: 'object' } },
-    implementationType: 'http' as const,
-    implementationConfig: {
-      url: 'https://api.brave.com/search',
-      method: 'GET',
-    },
-    maxInvocationsPerMinute: 60,
-    timeoutMs: 30000,
-    version: '1.0.0',
-    tags: ['search', 'web'],
-    createdAt: new Date('2024-01-01T00:00:00Z'),
-    updatedAt: new Date('2024-02-15T10:00:00Z'),
-  },
-  {
-    id: 'tool-2',
-    organizationId: 'demo-org',
-    name: 'SQL Query',
-    slug: 'sql-query',
-    description: 'Execute read-only SQL queries against the data warehouse.',
-    category: 'RETRIEVAL' as const,
-    status: 'ACTIVE' as const,
-    parametersSchema: {
-      type: 'object',
-      properties: {
-        query: { type: 'string', description: 'SQL query' },
-        maxRows: { type: 'number', default: 100 },
-      },
-      required: ['query'],
-    },
-    outputSchema: { type: 'object' },
-    implementationType: 'function' as const,
-    implementationConfig: { handler: 'executeSqlQuery' },
-    maxInvocationsPerMinute: 30,
-    timeoutMs: 60000,
-    version: '1.1.0',
-    tags: ['sql', 'database'],
-    createdAt: new Date('2024-01-05T00:00:00Z'),
-    updatedAt: new Date('2024-03-10T14:00:00Z'),
-  },
-  {
-    id: 'tool-3',
-    organizationId: 'demo-org',
-    name: 'Email Sender',
-    slug: 'email-sender',
-    description: 'Send emails via SMTP or API.',
-    category: 'COMMUNICATION' as const,
-    status: 'ACTIVE' as const,
-    parametersSchema: {
-      type: 'object',
-      properties: {
-        to: { type: 'string' },
-        subject: { type: 'string' },
-        body: { type: 'string' },
-      },
-      required: ['to', 'subject', 'body'],
-    },
-    implementationType: 'http' as const,
-    implementationConfig: { url: '/api/send-email', method: 'POST' },
-    maxInvocationsPerMinute: 10,
-    timeoutMs: 30000,
-    version: '1.0.0',
-    tags: ['email', 'communication'],
-    createdAt: new Date('2024-02-01T00:00:00Z'),
-    updatedAt: new Date('2024-02-01T00:00:00Z'),
-  },
-  {
-    id: 'tool-4',
-    organizationId: 'demo-org',
-    name: 'GitHub Integration',
-    slug: 'github-integration',
-    description: 'Interact with GitHub repositories, PRs, and issues.',
-    category: 'INTEGRATION' as const,
-    status: 'ACTIVE' as const,
-    parametersSchema: {
-      type: 'object',
-      properties: {
-        action: {
-          type: 'string',
-          enum: ['list_prs', 'get_pr', 'create_comment'],
-        },
-        repo: { type: 'string' },
-        params: { type: 'object' },
-      },
-      required: ['action', 'repo'],
-    },
-    implementationType: 'http' as const,
-    implementationConfig: { url: 'https://api.github.com', auth: 'token' },
-    maxInvocationsPerMinute: 100,
-    timeoutMs: 15000,
-    version: '2.0.0',
-    tags: ['github', 'integration', 'code'],
-    createdAt: new Date('2024-02-20T00:00:00Z'),
-    updatedAt: new Date('2024-04-01T09:00:00Z'),
-  },
-  {
-    id: 'tool-5',
-    organizationId: 'demo-org',
-    name: 'Calculator',
-    slug: 'calculator',
-    description: 'Perform mathematical calculations.',
-    category: 'COMPUTATION' as const,
-    status: 'ACTIVE' as const,
-    parametersSchema: {
-      type: 'object',
-      properties: {
-        expression: {
-          type: 'string',
-          description: 'Math expression to evaluate',
-        },
-      },
-      required: ['expression'],
-    },
-    outputSchema: {
-      type: 'object',
-      properties: { result: { type: 'number' } },
-    },
-    implementationType: 'function' as const,
-    implementationConfig: { handler: 'evaluateMath' },
-    timeoutMs: 5000,
-    version: '1.0.0',
-    tags: ['math', 'utility'],
-    createdAt: new Date('2024-01-10T00:00:00Z'),
-    updatedAt: new Date('2024-01-10T00:00:00Z'),
-  },
+	{
+		id: 'tool-1',
+		organizationId: 'demo-org',
+		name: 'Web Search',
+		slug: 'web-search',
+		description: 'Search the web for real-time information using Brave API.',
+		category: 'RETRIEVAL' as const,
+		status: 'ACTIVE' as const,
+		parametersSchema: {
+			type: 'object',
+			properties: {
+				query: { type: 'string', description: 'Search query' },
+				numResults: { type: 'number', default: 10 },
+			},
+			required: ['query'],
+		},
+		outputSchema: { type: 'array', items: { type: 'object' } },
+		implementationType: 'http' as const,
+		implementationConfig: {
+			url: 'https://api.brave.com/search',
+			method: 'GET',
+		},
+		maxInvocationsPerMinute: 60,
+		timeoutMs: 30000,
+		version: '1.0.0',
+		tags: ['search', 'web'],
+		createdAt: new Date('2024-01-01T00:00:00Z'),
+		updatedAt: new Date('2024-02-15T10:00:00Z'),
+	},
+	{
+		id: 'tool-2',
+		organizationId: 'demo-org',
+		name: 'SQL Query',
+		slug: 'sql-query',
+		description: 'Execute read-only SQL queries against the data warehouse.',
+		category: 'RETRIEVAL' as const,
+		status: 'ACTIVE' as const,
+		parametersSchema: {
+			type: 'object',
+			properties: {
+				query: { type: 'string', description: 'SQL query' },
+				maxRows: { type: 'number', default: 100 },
+			},
+			required: ['query'],
+		},
+		outputSchema: { type: 'object' },
+		implementationType: 'function' as const,
+		implementationConfig: { handler: 'executeSqlQuery' },
+		maxInvocationsPerMinute: 30,
+		timeoutMs: 60000,
+		version: '1.1.0',
+		tags: ['sql', 'database'],
+		createdAt: new Date('2024-01-05T00:00:00Z'),
+		updatedAt: new Date('2024-03-10T14:00:00Z'),
+	},
+	{
+		id: 'tool-3',
+		organizationId: 'demo-org',
+		name: 'Email Sender',
+		slug: 'email-sender',
+		description: 'Send emails via SMTP or API.',
+		category: 'COMMUNICATION' as const,
+		status: 'ACTIVE' as const,
+		parametersSchema: {
+			type: 'object',
+			properties: {
+				to: { type: 'string' },
+				subject: { type: 'string' },
+				body: { type: 'string' },
+			},
+			required: ['to', 'subject', 'body'],
+		},
+		implementationType: 'http' as const,
+		implementationConfig: { url: '/api/send-email', method: 'POST' },
+		maxInvocationsPerMinute: 10,
+		timeoutMs: 30000,
+		version: '1.0.0',
+		tags: ['email', 'communication'],
+		createdAt: new Date('2024-02-01T00:00:00Z'),
+		updatedAt: new Date('2024-02-01T00:00:00Z'),
+	},
+	{
+		id: 'tool-4',
+		organizationId: 'demo-org',
+		name: 'GitHub Integration',
+		slug: 'github-integration',
+		description: 'Interact with GitHub repositories, PRs, and issues.',
+		category: 'INTEGRATION' as const,
+		status: 'ACTIVE' as const,
+		parametersSchema: {
+			type: 'object',
+			properties: {
+				action: {
+					type: 'string',
+					enum: ['list_prs', 'get_pr', 'create_comment'],
+				},
+				repo: { type: 'string' },
+				params: { type: 'object' },
+			},
+			required: ['action', 'repo'],
+		},
+		implementationType: 'http' as const,
+		implementationConfig: { url: 'https://api.github.com', auth: 'token' },
+		maxInvocationsPerMinute: 100,
+		timeoutMs: 15000,
+		version: '2.0.0',
+		tags: ['github', 'integration', 'code'],
+		createdAt: new Date('2024-02-20T00:00:00Z'),
+		updatedAt: new Date('2024-04-01T09:00:00Z'),
+	},
+	{
+		id: 'tool-5',
+		organizationId: 'demo-org',
+		name: 'Calculator',
+		slug: 'calculator',
+		description: 'Perform mathematical calculations.',
+		category: 'COMPUTATION' as const,
+		status: 'ACTIVE' as const,
+		parametersSchema: {
+			type: 'object',
+			properties: {
+				expression: {
+					type: 'string',
+					description: 'Math expression to evaluate',
+				},
+			},
+			required: ['expression'],
+		},
+		outputSchema: {
+			type: 'object',
+			properties: { result: { type: 'number' } },
+		},
+		implementationType: 'function' as const,
+		implementationConfig: { handler: 'evaluateMath' },
+		timeoutMs: 5000,
+		version: '1.0.0',
+		tags: ['math', 'utility'],
+		createdAt: new Date('2024-01-10T00:00:00Z'),
+		updatedAt: new Date('2024-01-10T00:00:00Z'),
+	},
 ];

package/src/shared/overlay-types.ts

@@ -1,39 +1,39 @@
 export interface OverlayDefinition {
-  overlayId: string;
-  version: string;
-  description: string;
-  appliesTo: Record<string, string>;
-  modifications: OverlayModification[];
+	overlayId: string;
+	version: string;
+	description: string;
+	appliesTo: Record<string, string>;
+	modifications: OverlayModification[];
 }
 
 export type OverlayModification =
-  | HideFieldModification
-  | RenameLabelModification
-  | AddBadgeModification
-  | SetLimitModification;
+	| HideFieldModification
+	| RenameLabelModification
+	| AddBadgeModification
+	| SetLimitModification;
 
 export interface HideFieldModification {
-  type: 'hideField';
-  field: string;
-  reason?: string;
+	type: 'hideField';
+	field: string;
+	reason?: string;
 }
 
 export interface RenameLabelModification {
-  type: 'renameLabel';
-  field: string;
-  newLabel: string;
+	type: 'renameLabel';
+	field: string;
+	newLabel: string;
 }
 
 export interface AddBadgeModification {
-  type: 'addBadge';
-  position: 'header' | 'footer';
-  label: string;
-  variant: 'warning' | 'info' | 'error' | 'success' | 'default';
+	type: 'addBadge';
+	position: 'header' | 'footer';
+	label: string;
+	variant: 'warning' | 'info' | 'error' | 'success' | 'default';
 }
 
 export interface SetLimitModification {
-  type: 'setLimit';
-  field: string;
-  max: number;
-  message: string;
+	type: 'setLimit';
+	field: string;
+	max: number;
+	message: string;
 }

package/src/tool/index.ts

@@ -2,59 +2,54 @@
  * Tool domain - AI tool definitions and management.
  */
 
+// Entities
+export {
+	ImplementationTypeEntityEnum,
+	ToolCategoryEntityEnum,
+	ToolEntity,
+	ToolStatusEntityEnum,
+} from './tool.entity';
 // Enums
 export {
-  ToolCategoryEnum,
-  ToolStatusEnum,
-  ImplementationTypeEnum,
+	ImplementationTypeEnum,
+	ToolCategoryEnum,
+	ToolStatusEnum,
 } from './tool.enum';
-
-// Schema models
-export {
-  ToolModel,
-  ToolSummaryModel,
-  CreateToolInputModel,
-  UpdateToolInputModel,
-} from './tool.schema';
-
-// Contracts
-export {
-  CreateToolCommand,
-  UpdateToolCommand,
-  GetToolQuery,
-  ListToolsQuery,
-  TestToolCommand,
-} from './tool.operation';
-
 // Events
 export {
-  ToolCreatedEvent,
-  ToolUpdatedEvent,
-  ToolStatusChangedEvent,
+	ToolCreatedEvent,
+	ToolStatusChangedEvent,
+	ToolUpdatedEvent,
 } from './tool.event';
-
-// Entities
+// Handlers
 export {
-  ToolCategoryEntityEnum,
-  ToolStatusEntityEnum,
-  ImplementationTypeEntityEnum,
-  ToolEntity,
-} from './tool.entity';
+	type ListToolsInput,
+	type ListToolsOutput,
+	mockCreateToolHandler,
+	mockGetToolHandler,
+	mockListToolsHandler,
+	mockTestToolHandler,
+	mockUpdateToolHandler,
+	type ToolSummary,
+} from './tool.handler';
+// Contracts
+export {
+	CreateToolCommand,
+	GetToolQuery,
+	ListToolsQuery,
+	TestToolCommand,
+	UpdateToolCommand,
+} from './tool.operation';
 
 // Presentations
 export {
-  ToolListPresentation,
-  ToolDetailPresentation,
+	ToolDetailPresentation,
+	ToolListPresentation,
 } from './tool.presentation';
-
-// Handlers
+// Schema models
 export {
-  mockListToolsHandler,
-  mockGetToolHandler,
-  mockCreateToolHandler,
-  mockUpdateToolHandler,
-  mockTestToolHandler,
-  type ListToolsInput,
-  type ToolSummary,
-  type ListToolsOutput,
-} from './tool.handler';
+	CreateToolInputModel,
+	ToolModel,
+	ToolSummaryModel,
+	UpdateToolInputModel,
+} from './tool.schema';

package/src/tool/tool.entity.ts

@@ -1,99 +1,99 @@
 import {
-  defineEntity,
-  defineEntityEnum,
-  field,
-  index,
+	defineEntity,
+	defineEntityEnum,
+	field,
+	index,
 } from '@contractspec/lib.schema';
 
 /**
  * Tool category enum for entities.
  */
 export const ToolCategoryEntityEnum = defineEntityEnum({
-  name: 'ToolCategory',
-  values: [
-    'RETRIEVAL',
-    'COMPUTATION',
-    'COMMUNICATION',
-    'INTEGRATION',
-    'UTILITY',
-    'CUSTOM',
-  ],
-  description: 'Category of tool',
+	name: 'ToolCategory',
+	values: [
+		'RETRIEVAL',
+		'COMPUTATION',
+		'COMMUNICATION',
+		'INTEGRATION',
+		'UTILITY',
+		'CUSTOM',
+	],
+	description: 'Category of tool',
 });
 
 /**
  * Tool status enum for entities.
  */
 export const ToolStatusEntityEnum = defineEntityEnum({
-  name: 'ToolStatus',
-  values: ['DRAFT', 'ACTIVE', 'DEPRECATED', 'DISABLED'],
-  description: 'Status of tool',
+	name: 'ToolStatus',
+	values: ['DRAFT', 'ACTIVE', 'DEPRECATED', 'DISABLED'],
+	description: 'Status of tool',
 });
 
 /**
  * Implementation type enum for entities.
  */
 export const ImplementationTypeEntityEnum = defineEntityEnum({
-  name: 'ImplementationType',
-  values: ['http', 'function', 'workflow'],
-  description: 'How the tool is implemented',
+	name: 'ImplementationType',
+	values: ['http', 'function', 'workflow'],
+	description: 'How the tool is implemented',
 });
 
 /**
  * Tool entity - Represents an AI tool definition.
  */
 export const ToolEntity = defineEntity({
-  name: 'Tool',
-  schema: 'agent_console',
-  description: 'An AI tool that can be used by agents.',
-  fields: {
-    id: field.id(),
-    organizationId: field.string({
-      description: 'Organization that owns this tool',
-    }),
-    name: field.string({ description: 'Tool name' }),
-    slug: field.string({ description: 'URL-safe identifier' }),
-    description: field.string({ description: 'Tool description' }),
-    category: field.enum('ToolCategory', { default: 'CUSTOM' }),
-    status: field.enum('ToolStatus', { default: 'DRAFT' }),
-    parametersSchema: field.json({
-      description: 'JSON Schema for tool parameters',
-    }),
-    outputSchema: field.json({
-      isOptional: true,
-      description: 'JSON Schema for tool output',
-    }),
-    implementationType: field.enum('ImplementationType'),
-    implementationConfig: field.json({
-      description: 'Implementation configuration',
-    }),
-    maxInvocationsPerMinute: field.int({
-      isOptional: true,
-      description: 'Rate limit',
-    }),
-    timeoutMs: field.int({ default: 30000, description: 'Execution timeout' }),
-    version: field.string({ default: '1.0.0', description: 'Tool version' }),
-    tags: field.string({
-      isArray: true,
-      isOptional: true,
-      description: 'Tags for categorization',
-    }),
-    createdAt: field.createdAt(),
-    updatedAt: field.updatedAt(),
-    createdById: field.string({
-      isOptional: true,
-      description: 'User who created this tool',
-    }),
-    agents: field.hasMany('Agent', { description: 'Agents using this tool' }),
-  },
-  indexes: [
-    index.unique(['organizationId', 'slug']),
-    index.on(['organizationId', 'category']),
-    index.on(['organizationId', 'status']),
-  ],
-  enums: [
-    ToolCategoryEntityEnum,
-    ToolStatusEntityEnum,
-    ImplementationTypeEntityEnum,
-  ],
+	name: 'Tool',
+	schema: 'agent_console',
+	description: 'An AI tool that can be used by agents.',
+	fields: {
+		id: field.id(),
+		organizationId: field.string({
+			description: 'Organization that owns this tool',
+		}),
+		name: field.string({ description: 'Tool name' }),
+		slug: field.string({ description: 'URL-safe identifier' }),
+		description: field.string({ description: 'Tool description' }),
+		category: field.enum('ToolCategory', { default: 'CUSTOM' }),
+		status: field.enum('ToolStatus', { default: 'DRAFT' }),
+		parametersSchema: field.json({
+			description: 'JSON Schema for tool parameters',
+		}),
+		outputSchema: field.json({
+			isOptional: true,
+			description: 'JSON Schema for tool output',
+		}),
+		implementationType: field.enum('ImplementationType'),
+		implementationConfig: field.json({
+			description: 'Implementation configuration',
+		}),
+		maxInvocationsPerMinute: field.int({
+			isOptional: true,
+			description: 'Rate limit',
+		}),
+		timeoutMs: field.int({ default: 30000, description: 'Execution timeout' }),
+		version: field.string({ default: '1.0.0', description: 'Tool version' }),
+		tags: field.string({
+			isArray: true,
+			isOptional: true,
+			description: 'Tags for categorization',
+		}),
+		createdAt: field.createdAt(),
+		updatedAt: field.updatedAt(),
+		createdById: field.string({
+			isOptional: true,
+			description: 'User who created this tool',
+		}),
+		agents: field.hasMany('Agent', { description: 'Agents using this tool' }),
+	},
+	indexes: [
+		index.unique(['organizationId', 'slug']),
+		index.on(['organizationId', 'category']),
+		index.on(['organizationId', 'status']),
+	],
+	enums: [
+		ToolCategoryEntityEnum,
+		ToolStatusEntityEnum,
+		ImplementationTypeEntityEnum,
+	],
 });

package/src/tool/tool.enum.ts

@@ -4,29 +4,29 @@ import { defineEnum } from '@contractspec/lib.schema';
  * Tool category enum.
  */
 export const ToolCategoryEnum = defineEnum('ToolCategory', [
-  'RETRIEVAL',
-  'COMPUTATION',
-  'COMMUNICATION',
-  'INTEGRATION',
-  'UTILITY',
-  'CUSTOM',
+	'RETRIEVAL',
+	'COMPUTATION',
+	'COMMUNICATION',
+	'INTEGRATION',
+	'UTILITY',
+	'CUSTOM',
 ]);
 
 /**
  * Tool status enum.
  */
 export const ToolStatusEnum = defineEnum('ToolStatus', [
-  'DRAFT',
-  'ACTIVE',
-  'DEPRECATED',
-  'DISABLED',
+	'DRAFT',
+	'ACTIVE',
+	'DEPRECATED',
+	'DISABLED',
 ]);
 
 /**
  * Implementation type enum.
  */
 export const ImplementationTypeEnum = defineEnum('ImplementationType', [
-  'http',
-  'function',
-  'workflow',
+	'http',
+	'function',
+	'workflow',
 ]);