@contractspec/example.agent-console 3.7.6 → 3.8.2

package/src/tool/tool.event.ts

@@ -1,5 +1,5 @@
 import { defineEvent } from '@contractspec/lib.contracts-spec';
-import { ScalarTypeEnum, defineSchemaModel } from '@contractspec/lib.schema';
+import { defineSchemaModel, ScalarTypeEnum } from '@contractspec/lib.schema';
 
 const OWNERS = ['@agent-console-team'] as const;
 
@@ -7,113 +7,113 @@ const OWNERS = ['@agent-console-team'] as const;
  * Payload for tool created event.
  */
 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 },
-  },
+	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({
-  meta: {
-    key: 'agent.tool.created',
-    version: '1.0.0',
-    description: 'A new AI tool was created.',
-    stability: 'stable',
-    owners: [...OWNERS],
-    tags: ['tool', 'created'],
-  },
-  payload: ToolCreatedPayload,
+	meta: {
+		key: 'agent.tool.created',
+		version: '1.0.0',
+		description: 'A new AI tool was created.',
+		stability: 'stable',
+		owners: [...OWNERS],
+		tags: ['tool', 'created'],
+	},
+	payload: ToolCreatedPayload,
 });
 
 /**
  * Payload for tool updated event.
  */
 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 },
-  },
+	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({
-  meta: {
-    key: 'agent.tool.updated',
-    version: '1.0.0',
-    description: 'An AI tool configuration was updated.',
-    stability: 'stable',
-    owners: [...OWNERS],
-    tags: ['tool', 'updated'],
-  },
-  payload: ToolUpdatedPayload,
+	meta: {
+		key: 'agent.tool.updated',
+		version: '1.0.0',
+		description: 'An AI tool configuration was updated.',
+		stability: 'stable',
+		owners: [...OWNERS],
+		tags: ['tool', 'updated'],
+	},
+	payload: ToolUpdatedPayload,
 });
 
 /**
  * Payload for tool status changed event.
  */
 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 },
-  },
+	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({
-  meta: {
-    key: 'agent.tool.statusChanged',
-    version: '1.0.0',
-    description:
-      'An AI tool status was changed (activated, deprecated, disabled).',
-    stability: 'stable',
-    owners: [...OWNERS],
-    tags: ['tool', 'status'],
-  },
-  payload: ToolStatusChangedPayload,
+	meta: {
+		key: 'agent.tool.statusChanged',
+		version: '1.0.0',
+		description:
+			'An AI tool status was changed (activated, deprecated, disabled).',
+		stability: 'stable',
+		owners: [...OWNERS],
+		tags: ['tool', 'status'],
+	},
+	payload: ToolStatusChangedPayload,
 });

package/src/tool/tool.handler.ts

@@ -1,154 +1,171 @@
 /**
  * Mock handlers for Tool contracts.
  */
+
 import { MOCK_TOOLS } from '../shared/mock-tools';
+import {
+	CreateToolCommand,
+	GetToolQuery,
+	ListToolsQuery,
+	TestToolCommand,
+	UpdateToolCommand,
+} from './tool.operation';
+
+const TOOL_HANDLER_CONTRACTS = [
+	CreateToolCommand,
+	GetToolQuery,
+	ListToolsQuery,
+	TestToolCommand,
+	UpdateToolCommand,
+] as const;
+void TOOL_HANDLER_CONTRACTS;
+
+let nextMockToolId = MOCK_TOOLS.length + 1;
 
 export interface ListToolsInput {
-  organizationId: string;
-  category?:
-    | 'RETRIEVAL'
-    | 'COMPUTATION'
-    | 'COMMUNICATION'
-    | 'INTEGRATION'
-    | 'UTILITY'
-    | 'CUSTOM';
-  status?: 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'DISABLED';
-  search?: string;
-  limit?: number;
-  offset?: number;
+	organizationId: string;
+	category?:
+		| 'RETRIEVAL'
+		| 'COMPUTATION'
+		| 'COMMUNICATION'
+		| 'INTEGRATION'
+		| 'UTILITY'
+		| 'CUSTOM';
+	status?: 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'DISABLED';
+	search?: string;
+	limit?: number;
+	offset?: number;
 }
 
 export interface ToolSummary {
-  id: string;
-  name: string;
-  slug: string;
-  description: string;
-  category:
-    | 'RETRIEVAL'
-    | 'COMPUTATION'
-    | 'COMMUNICATION'
-    | 'INTEGRATION'
-    | 'UTILITY'
-    | 'CUSTOM';
-  status: 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'DISABLED';
-  version: string;
-  createdAt: Date;
+	id: string;
+	name: string;
+	slug: string;
+	description: string;
+	category:
+		| 'RETRIEVAL'
+		| 'COMPUTATION'
+		| 'COMMUNICATION'
+		| 'INTEGRATION'
+		| 'UTILITY'
+		| 'CUSTOM';
+	status: 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'DISABLED';
+	version: string;
+	createdAt: Date;
 }
 
 export interface ListToolsOutput {
-  items: ToolSummary[];
-  total: number;
-  hasMore: boolean;
+	items: ToolSummary[];
+	total: number;
+	hasMore: boolean;
 }
 
 /**
  * Mock handler for ListToolsQuery.
  */
 export async function mockListToolsHandler(
-  input: ListToolsInput
+	input: ListToolsInput
 ): Promise<ListToolsOutput> {
-  const {
-    organizationId,
-    category,
-    status,
-    search,
-    limit = 20,
-    offset = 0,
-  } = input;
-
-  let filtered = MOCK_TOOLS.filter((t) => t.organizationId === organizationId);
-  if (category) filtered = filtered.filter((t) => t.category === category);
-  if (status) filtered = filtered.filter((t) => t.status === status);
-  if (search) {
-    const q = search.toLowerCase();
-    filtered = filtered.filter(
-      (t) =>
-        t.name.toLowerCase().includes(q) ||
-        t.description.toLowerCase().includes(q)
-    );
-  }
-
-  const total = filtered.length;
-  const items = filtered.slice(offset, offset + limit).map((t) => ({
-    id: t.id,
-    name: t.name,
-    slug: t.slug,
-    description: t.description,
-    category: t.category,
-    status: t.status,
-    version: t.version,
-    createdAt: t.createdAt,
-  }));
-
-  return { items, total, hasMore: offset + limit < total };
+	const {
+		organizationId,
+		category,
+		status,
+		search,
+		limit = 20,
+		offset = 0,
+	} = input;
+
+	let filtered = MOCK_TOOLS.filter((t) => t.organizationId === organizationId);
+	if (category) filtered = filtered.filter((t) => t.category === category);
+	if (status) filtered = filtered.filter((t) => t.status === status);
+	if (search) {
+		const q = search.toLowerCase();
+		filtered = filtered.filter(
+			(t) =>
+				t.name.toLowerCase().includes(q) ||
+				t.description.toLowerCase().includes(q)
+		);
+	}
+
+	const total = filtered.length;
+	const items = filtered.slice(offset, offset + limit).map((t) => ({
+		id: t.id,
+		name: t.name,
+		slug: t.slug,
+		description: t.description,
+		category: t.category,
+		status: t.status,
+		version: t.version,
+		createdAt: t.createdAt,
+	}));
+
+	return { items, total, hasMore: offset + limit < total };
 }
 
 /**
  * Mock handler for GetToolQuery.
  */
 export async function mockGetToolHandler(input: { toolId: string }) {
-  const tool = MOCK_TOOLS.find((t) => t.id === input.toolId);
-  if (!tool) throw new Error('TOOL_NOT_FOUND');
-  return tool;
+	const tool = MOCK_TOOLS.find((t) => t.id === input.toolId);
+	if (!tool) throw new Error('TOOL_NOT_FOUND');
+	return tool;
 }
 
 /**
  * Mock handler for CreateToolCommand.
  */
 export async function mockCreateToolHandler(input: {
-  organizationId: string;
-  name: string;
-  slug: string;
-  description: string;
-  implementationType: 'http' | 'function' | 'workflow';
+	organizationId: string;
+	name: string;
+	slug: string;
+	description: string;
+	implementationType: 'http' | 'function' | 'workflow';
 }) {
-  const exists = MOCK_TOOLS.some(
-    (t) => t.organizationId === input.organizationId && t.slug === input.slug
-  );
-  if (exists) throw new Error('SLUG_EXISTS');
-  return {
-    id: `tool-${Date.now()}`,
-    name: input.name,
-    slug: input.slug,
-    status: 'DRAFT' as const,
-  };
+	const exists = MOCK_TOOLS.some(
+		(t) => t.organizationId === input.organizationId && t.slug === input.slug
+	);
+	if (exists) throw new Error('SLUG_EXISTS');
+	return {
+		id: `tool-${nextMockToolId++}`,
+		name: input.name,
+		slug: input.slug,
+		status: 'DRAFT' as const,
+	};
 }
 
 /**
  * Mock handler for UpdateToolCommand.
  */
 export async function mockUpdateToolHandler(input: {
-  toolId: string;
-  name?: string;
-  status?: 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'DISABLED';
+	toolId: string;
+	name?: string;
+	status?: 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'DISABLED';
 }) {
-  const tool = MOCK_TOOLS.find((t) => t.id === input.toolId);
-  if (!tool) throw new Error('TOOL_NOT_FOUND');
-  return {
-    id: tool.id,
-    name: input.name ?? tool.name,
-    status: input.status ?? tool.status,
-    updatedAt: new Date(),
-  };
+	const tool = MOCK_TOOLS.find((t) => t.id === input.toolId);
+	if (!tool) throw new Error('TOOL_NOT_FOUND');
+	return {
+		id: tool.id,
+		name: input.name ?? tool.name,
+		status: input.status ?? tool.status,
+		updatedAt: new Date(),
+	};
 }
 
 /**
  * Mock handler for TestToolCommand.
  */
 export async function mockTestToolHandler(input: {
-  toolId: string;
-  testInput: Record<string, unknown>;
+	toolId: string;
+	testInput: Record<string, unknown>;
 }) {
-  const tool = MOCK_TOOLS.find((t) => t.id === input.toolId);
-  if (!tool) throw new Error('TOOL_NOT_FOUND');
-
-  // Simulate tool execution
-  const startTime = Date.now();
-  await new Promise((resolve) => setTimeout(resolve, 100));
-
-  return {
-    success: true,
-    output: { result: 'Test successful', input: input.testInput },
-    durationMs: Date.now() - startTime,
-  };
+	const tool = MOCK_TOOLS.find((t) => t.id === input.toolId);
+	if (!tool) throw new Error('TOOL_NOT_FOUND');
+
+	await new Promise((resolve) => setTimeout(resolve, 100));
+
+	return {
+		success: true,
+		output: { result: 'Test successful', input: input.testInput },
+		durationMs: 100,
+	};
 }