@contractspec/example.agent-console 1.44.0

package/dist/tool/tool.operation.js

@@ -0,0 +1,406 @@
+import { ToolCategoryEnum, ToolStatusEnum } from "./tool.enum.js";
+import { CreateToolInputModel, ToolModel, ToolSummaryModel, UpdateToolInputModel } from "./tool.schema.js";
+import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineCommand, defineQuery } from "@contractspec/lib.contracts/operations";
+
+//#region src/tool/tool.operation.ts
+const OWNERS = ["@agent-console-team"];
+/**
+* CreateToolCommand - Creates a new tool definition.
+*/
+const CreateToolCommand = defineCommand({
+	meta: {
+		key: "agent.tool.create",
+		version: 1,
+		stability: "stable",
+		owners: [...OWNERS],
+		tags: ["tool", "create"],
+		description: "Creates a new AI tool definition.",
+		goal: "Allow users to define new tools that agents can use.",
+		context: "Called from the tool builder UI when creating a new tool."
+	},
+	io: {
+		input: CreateToolInputModel,
+		output: defineSchemaModel({
+			name: "CreateToolOutput",
+			fields: {
+				id: {
+					type: ScalarTypeEnum.String_unsecure(),
+					isOptional: false
+				},
+				name: {
+					type: ScalarTypeEnum.NonEmptyString(),
+					isOptional: false
+				},
+				slug: {
+					type: ScalarTypeEnum.String_unsecure(),
+					isOptional: false
+				},
+				status: {
+					type: ToolStatusEnum,
+					isOptional: false
+				}
+			}
+		}),
+		errors: { SLUG_EXISTS: {
+			description: "A tool with this slug already exists in the organization",
+			http: 409,
+			gqlCode: "SLUG_EXISTS",
+			when: "Slug is already taken"
+		} }
+	},
+	policy: { auth: "user" },
+	sideEffects: {
+		emits: [{
+			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"
+			}
+		}]
+	}
+});
+/**
+* UpdateToolCommand - Updates an existing tool.
+*/
+const UpdateToolCommand = defineCommand({
+	meta: {
+		key: "agent.tool.update",
+		version: 1,
+		stability: "stable",
+		owners: [...OWNERS],
+		tags: ["tool", "update"],
+		description: "Updates an existing AI tool definition.",
+		goal: "Allow users to modify tool settings and configuration.",
+		context: "Called from the tool settings UI."
+	},
+	io: {
+		input: UpdateToolInputModel,
+		output: defineSchemaModel({
+			name: "UpdateToolOutput",
+			fields: {
+				id: {
+					type: ScalarTypeEnum.String_unsecure(),
+					isOptional: false
+				},
+				name: {
+					type: ScalarTypeEnum.NonEmptyString(),
+					isOptional: false
+				},
+				status: {
+					type: ToolStatusEnum,
+					isOptional: false
+				},
+				updatedAt: {
+					type: ScalarTypeEnum.DateTime(),
+					isOptional: false
+				}
+			}
+		}),
+		errors: { TOOL_NOT_FOUND: {
+			description: "The specified tool does not exist",
+			http: 404,
+			gqlCode: "TOOL_NOT_FOUND",
+			when: "Tool ID is invalid"
+		} }
+	},
+	policy: { auth: "user" },
+	sideEffects: {
+		emits: [{
+			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"
+			}
+		}]
+	}
+});
+/**
+* GetToolQuery - Retrieves a tool by ID.
+*/
+const GetToolQuery = defineQuery({
+	meta: {
+		key: "agent.tool.get",
+		version: 1,
+		stability: "stable",
+		owners: [...OWNERS],
+		tags: ["tool", "get"],
+		description: "Retrieves a tool by its ID.",
+		goal: "View detailed tool configuration.",
+		context: "Called when viewing tool details or editing."
+	},
+	io: {
+		input: defineSchemaModel({
+			name: "GetToolInput",
+			fields: { toolId: {
+				type: ScalarTypeEnum.String_unsecure(),
+				isOptional: false
+			} }
+		}),
+		output: ToolModel,
+		errors: { TOOL_NOT_FOUND: {
+			description: "The specified tool does not exist",
+			http: 404,
+			gqlCode: "TOOL_NOT_FOUND",
+			when: "Tool ID is invalid"
+		} }
+	},
+	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"
+			}
+		}]
+	}
+});
+/**
+* ListToolsQuery - Lists tools for an organization.
+*/
+const ListToolsQuery = defineQuery({
+	meta: {
+		key: "agent.tool.list",
+		version: 1,
+		stability: "stable",
+		owners: [...OWNERS],
+		tags: ["tool", "list"],
+		description: "Lists tools for an organization with optional filtering.",
+		goal: "Browse and search available tools.",
+		context: "Tool list/dashboard view."
+	},
+	io: {
+		input: defineSchemaModel({
+			name: "ListToolsInput",
+			fields: {
+				organizationId: {
+					type: ScalarTypeEnum.String_unsecure(),
+					isOptional: false
+				},
+				category: {
+					type: ToolCategoryEnum,
+					isOptional: true
+				},
+				status: {
+					type: ToolStatusEnum,
+					isOptional: true
+				},
+				search: {
+					type: ScalarTypeEnum.String_unsecure(),
+					isOptional: true
+				},
+				limit: {
+					type: ScalarTypeEnum.Int_unsecure(),
+					isOptional: true,
+					defaultValue: 20
+				},
+				offset: {
+					type: ScalarTypeEnum.Int_unsecure(),
+					isOptional: true,
+					defaultValue: 0
+				}
+			}
+		}),
+		output: defineSchemaModel({
+			name: "ListToolsOutput",
+			fields: {
+				items: {
+					type: ToolSummaryModel,
+					isArray: true,
+					isOptional: false
+				},
+				total: {
+					type: ScalarTypeEnum.Int_unsecure(),
+					isOptional: false
+				},
+				hasMore: {
+					type: ScalarTypeEnum.Boolean(),
+					isOptional: false
+				}
+			}
+		})
+	},
+	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
+			}
+		}]
+	}
+});
+/**
+* TestToolCommand - Tests a tool with sample input.
+*/
+const TestToolCommand = defineCommand({
+	meta: {
+		key: "agent.tool.test",
+		version: 1,
+		stability: "stable",
+		owners: [...OWNERS],
+		tags: ["tool", "test"],
+		description: "Tests a tool with sample input to verify it works correctly.",
+		goal: "Validate tool configuration before deployment.",
+		context: "Tool builder UI - test panel."
+	},
+	io: {
+		input: defineSchemaModel({
+			name: "TestToolInput",
+			fields: {
+				toolId: {
+					type: ScalarTypeEnum.String_unsecure(),
+					isOptional: false
+				},
+				testInput: {
+					type: ScalarTypeEnum.JSONObject(),
+					isOptional: false
+				}
+			}
+		}),
+		output: defineSchemaModel({
+			name: "TestToolOutput",
+			fields: {
+				success: {
+					type: ScalarTypeEnum.Boolean(),
+					isOptional: false
+				},
+				output: {
+					type: ScalarTypeEnum.JSONObject(),
+					isOptional: true
+				},
+				error: {
+					type: ScalarTypeEnum.String_unsecure(),
+					isOptional: true
+				},
+				durationMs: {
+					type: ScalarTypeEnum.Int_unsecure(),
+					isOptional: false
+				}
+			}
+		}),
+		errors: {
+			TOOL_NOT_FOUND: {
+				description: "The specified tool does not exist",
+				http: 404,
+				gqlCode: "TOOL_NOT_FOUND",
+				when: "Tool ID is invalid"
+			},
+			TOOL_EXECUTION_ERROR: {
+				description: "Tool execution failed",
+				http: 500,
+				gqlCode: "TOOL_EXECUTION_ERROR",
+				when: "Tool returns an error"
+			}
+		}
+	},
+	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
+			}
+		}]
+	}
+});
+
+//#endregion
+export { CreateToolCommand, GetToolQuery, ListToolsQuery, TestToolCommand, UpdateToolCommand };
+//# sourceMappingURL=tool.operation.js.map

package/dist/tool/tool.operation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.operation.js","names":[],"sources":["../../src/tool/tool.operation.ts"],"sourcesContent":["import {\n  defineCommand,\n  defineQuery,\n} from '@contractspec/lib.contracts/operations';\nimport { defineSchemaModel, ScalarTypeEnum } from '@contractspec/lib.schema';\nimport { ToolCategoryEnum, ToolStatusEnum } from './tool.enum';\nimport {\n  CreateToolInputModel,\n  ToolModel,\n  ToolSummaryModel,\n  UpdateToolInputModel,\n} from './tool.schema';\n\nconst OWNERS = ['@agent-console-team'] as const;\n\n/**\n * CreateToolCommand - Creates a new tool definition.\n */\nexport const CreateToolCommand = defineCommand({\n  meta: {\n    key: 'agent.tool.create',\n    version: 1,\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['tool', 'create'],\n    description: 'Creates a new AI tool definition.',\n    goal: 'Allow users to define new tools that agents can use.',\n    context: 'Called from the tool builder UI when creating a new tool.',\n  },\n  io: {\n    input: CreateToolInputModel,\n    output: defineSchemaModel({\n      name: 'CreateToolOutput',\n      fields: {\n        id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n        name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },\n        slug: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n        status: { type: ToolStatusEnum, isOptional: false },\n      },\n    }),\n    errors: {\n      SLUG_EXISTS: {\n        description: 'A tool with this slug already exists in the organization',\n        http: 409,\n        gqlCode: 'SLUG_EXISTS',\n        when: 'Slug is already taken',\n      },\n    },\n  },\n  policy: { auth: 'user' },\n  sideEffects: {\n    emits: [\n      {\n        key: 'tool.created',\n        version: 1,\n        stability: 'stable',\n        owners: [...OWNERS],\n        tags: ['tool', 'created'],\n        when: 'Tool is successfully created',\n        payload: ToolSummaryModel,\n      },\n    ],\n    audit: ['tool.created'],\n  },\n  acceptance: {\n    scenarios: [\n      {\n        key: 'create-tool-happy-path',\n        given: ['User is authenticated', 'Organization exists'],\n        when: ['User submits valid tool configuration'],\n        then: ['New tool is created', 'ToolCreated event is emitted'],\n      },\n      {\n        key: 'create-tool-slug-conflict',\n        given: ['Tool with same slug exists'],\n        when: ['User submits tool with duplicate slug'],\n        then: ['SLUG_EXISTS error is returned'],\n      },\n    ],\n    examples: [\n      {\n        key: 'create-api-tool',\n        input: {\n          name: 'Weather API',\n          slug: 'weather-api',\n          category: 'api',\n          description: 'Fetches weather data',\n        },\n        output: {\n          id: 'tool-123',\n          name: 'Weather API',\n          slug: 'weather-api',\n          status: 'draft',\n        },\n      },\n    ],\n  },\n});\n\n/**\n * UpdateToolCommand - Updates an existing tool.\n */\nexport const UpdateToolCommand = defineCommand({\n  meta: {\n    key: 'agent.tool.update',\n    version: 1,\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['tool', 'update'],\n    description: 'Updates an existing AI tool definition.',\n    goal: 'Allow users to modify tool settings and configuration.',\n    context: 'Called from the tool settings UI.',\n  },\n  io: {\n    input: UpdateToolInputModel,\n    output: defineSchemaModel({\n      name: 'UpdateToolOutput',\n      fields: {\n        id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n        name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },\n        status: { type: ToolStatusEnum, isOptional: false },\n        updatedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n      },\n    }),\n    errors: {\n      TOOL_NOT_FOUND: {\n        description: 'The specified tool does not exist',\n        http: 404,\n        gqlCode: 'TOOL_NOT_FOUND',\n        when: 'Tool ID is invalid',\n      },\n    },\n  },\n  policy: { auth: 'user' },\n  sideEffects: {\n    emits: [\n      {\n        key: 'tool.updated',\n        version: 1,\n        stability: 'stable',\n        owners: [...OWNERS],\n        tags: ['tool', 'updated'],\n        when: 'Tool is updated',\n        payload: ToolSummaryModel,\n      },\n    ],\n    audit: ['tool.updated'],\n  },\n  acceptance: {\n    scenarios: [\n      {\n        key: 'update-tool-happy-path',\n        given: ['Tool exists', 'User owns the tool'],\n        when: ['User submits updated configuration'],\n        then: ['Tool is updated', 'ToolUpdated event is emitted'],\n      },\n    ],\n    examples: [\n      {\n        key: 'update-description',\n        input: { toolId: 'tool-123', description: 'Updated weather API tool' },\n        output: {\n          id: 'tool-123',\n          name: 'Weather API',\n          status: 'draft',\n          updatedAt: '2025-01-01T00:00:00Z',\n        },\n      },\n    ],\n  },\n});\n\n/**\n * GetToolQuery - Retrieves a tool by ID.\n */\nexport const GetToolQuery = defineQuery({\n  meta: {\n    key: 'agent.tool.get',\n    version: 1,\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['tool', 'get'],\n    description: 'Retrieves a tool by its ID.',\n    goal: 'View detailed tool configuration.',\n    context: 'Called when viewing tool details or editing.',\n  },\n  io: {\n    input: defineSchemaModel({\n      name: 'GetToolInput',\n      fields: {\n        toolId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n      },\n    }),\n    output: ToolModel,\n    errors: {\n      TOOL_NOT_FOUND: {\n        description: 'The specified tool does not exist',\n        http: 404,\n        gqlCode: 'TOOL_NOT_FOUND',\n        when: 'Tool ID is invalid',\n      },\n    },\n  },\n  policy: { auth: 'user' },\n  acceptance: {\n    scenarios: [\n      {\n        key: 'get-tool-happy-path',\n        given: ['Tool exists'],\n        when: ['User requests tool by ID'],\n        then: ['Tool details are returned'],\n      },\n    ],\n    examples: [\n      {\n        key: 'get-basic',\n        input: { toolId: 'tool-123' },\n        output: {\n          id: 'tool-123',\n          name: 'Weather API',\n          status: 'active',\n          category: 'api',\n        },\n      },\n    ],\n  },\n});\n\n/**\n * ListToolsQuery - Lists tools for an organization.\n */\nexport const ListToolsQuery = defineQuery({\n  meta: {\n    key: 'agent.tool.list',\n    version: 1,\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['tool', 'list'],\n    description: 'Lists tools for an organization with optional filtering.',\n    goal: 'Browse and search available tools.',\n    context: 'Tool list/dashboard view.',\n  },\n  io: {\n    input: defineSchemaModel({\n      name: 'ListToolsInput',\n      fields: {\n        organizationId: {\n          type: ScalarTypeEnum.String_unsecure(),\n          isOptional: false,\n        },\n        category: { type: ToolCategoryEnum, isOptional: true },\n        status: { type: ToolStatusEnum, isOptional: true },\n        search: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n        limit: {\n          type: ScalarTypeEnum.Int_unsecure(),\n          isOptional: true,\n          defaultValue: 20,\n        },\n        offset: {\n          type: ScalarTypeEnum.Int_unsecure(),\n          isOptional: true,\n          defaultValue: 0,\n        },\n      },\n    }),\n    output: defineSchemaModel({\n      name: 'ListToolsOutput',\n      fields: {\n        items: { type: ToolSummaryModel, isArray: true, isOptional: false },\n        total: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },\n        hasMore: { type: ScalarTypeEnum.Boolean(), isOptional: false },\n      },\n    }),\n  },\n  policy: { auth: 'user' },\n  acceptance: {\n    scenarios: [\n      {\n        key: 'list-tools-happy-path',\n        given: ['Organization has tools'],\n        when: ['User lists tools'],\n        then: ['Paginated list of tools is returned'],\n      },\n    ],\n    examples: [\n      {\n        key: 'list-by-category',\n        input: { organizationId: 'org-123', category: 'api', limit: 10 },\n        output: { items: [], total: 0, hasMore: false },\n      },\n    ],\n  },\n});\n\n/**\n * TestToolCommand - Tests a tool with sample input.\n */\nexport const TestToolCommand = defineCommand({\n  meta: {\n    key: 'agent.tool.test',\n    version: 1,\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['tool', 'test'],\n    description: 'Tests a tool with sample input to verify it works correctly.',\n    goal: 'Validate tool configuration before deployment.',\n    context: 'Tool builder UI - test panel.',\n  },\n  io: {\n    input: defineSchemaModel({\n      name: 'TestToolInput',\n      fields: {\n        toolId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n        testInput: { type: ScalarTypeEnum.JSONObject(), isOptional: false },\n      },\n    }),\n    output: defineSchemaModel({\n      name: 'TestToolOutput',\n      fields: {\n        success: { type: ScalarTypeEnum.Boolean(), isOptional: false },\n        output: { type: ScalarTypeEnum.JSONObject(), isOptional: true },\n        error: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n        durationMs: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },\n      },\n    }),\n    errors: {\n      TOOL_NOT_FOUND: {\n        description: 'The specified tool does not exist',\n        http: 404,\n        gqlCode: 'TOOL_NOT_FOUND',\n        when: 'Tool ID is invalid',\n      },\n      TOOL_EXECUTION_ERROR: {\n        description: 'Tool execution failed',\n        http: 500,\n        gqlCode: 'TOOL_EXECUTION_ERROR',\n        when: 'Tool returns an error',\n      },\n    },\n  },\n  policy: { auth: 'user' },\n  sideEffects: { audit: ['tool.tested'] },\n  acceptance: {\n    scenarios: [\n      {\n        key: 'test-tool-success',\n        given: ['Tool exists', 'Tool is configured correctly'],\n        when: ['User runs test with valid input'],\n        then: ['Tool executes successfully', 'Output is returned'],\n      },\n      {\n        key: 'test-tool-failure',\n        given: ['Tool exists', 'Tool has configuration error'],\n        when: ['User runs test'],\n        then: ['TOOL_EXECUTION_ERROR is returned'],\n      },\n    ],\n    examples: [\n      {\n        key: 'test-weather-api',\n        input: { toolId: 'tool-123', testInput: { city: 'Paris' } },\n        output: { success: true, output: { temperature: 22 }, durationMs: 150 },\n      },\n    ],\n  },\n});\n"],"mappings":"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"}

package/dist/tool/tool.presentation.d.ts

@@ -0,0 +1,15 @@
+import { PresentationSpec } from "@contractspec/lib.contracts";
+
+//#region src/tool/tool.presentation.d.ts
+
+/**
+ * Presentation for displaying a list of tools.
+ */
+declare const ToolListPresentation: PresentationSpec;
+/**
+ * Presentation for tool detail view.
+ */
+declare const ToolDetailPresentation: PresentationSpec;
+//#endregion
+export { ToolDetailPresentation, ToolListPresentation };
+//# sourceMappingURL=tool.presentation.d.ts.map

package/dist/tool/tool.presentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.presentation.d.ts","names":[],"sources":["../../src/tool/tool.presentation.ts"],"sourcesContent":[],"mappings":";;;;;;AAOA;AA2Ba,cA3BA,oBA2BwB,EA3BF,gBAgDlC;;;;cArBY,wBAAwB"}

package/dist/tool/tool.presentation.js

@@ -0,0 +1,65 @@
+import { ToolSummaryModel } from "./tool.schema.js";
+import { StabilityEnum } from "@contractspec/lib.contracts";
+
+//#region src/tool/tool.presentation.ts
+/**
+* Presentation for displaying a list of tools.
+*/
+const ToolListPresentation = {
+	meta: {
+		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",
+		framework: "react",
+		componentKey: "ToolListView",
+		props: ToolSummaryModel
+	},
+	targets: [
+		"react",
+		"markdown",
+		"application/json"
+	],
+	policy: { flags: ["agent-console.enabled"] }
+};
+/**
+* Presentation for tool detail view.
+*/
+const ToolDetailPresentation = {
+	meta: {
+		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",
+		framework: "react",
+		componentKey: "ToolDetailView"
+	},
+	targets: ["react", "markdown"],
+	policy: { flags: ["agent-console.enabled"] }
+};
+
+//#endregion
+export { ToolDetailPresentation, ToolListPresentation };
+//# sourceMappingURL=tool.presentation.js.map

package/dist/tool/tool.presentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.presentation.js","names":["ToolListPresentation: PresentationSpec","ToolDetailPresentation: PresentationSpec"],"sources":["../../src/tool/tool.presentation.ts"],"sourcesContent":["import type { PresentationSpec } from '@contractspec/lib.contracts';\nimport { StabilityEnum } from '@contractspec/lib.contracts';\nimport { ToolSummaryModel } from './tool.schema';\n\n/**\n * Presentation for displaying a list of tools.\n */\nexport const ToolListPresentation: PresentationSpec = {\n  meta: {\n    key: 'agent-console.tool.list',\n    version: 1,\n    title: 'Tool List',\n    description:\n      'List view of AI tools with category, status, and version info',\n    goal: 'Provide an overview of all available tools for agents.',\n    context: 'Tool management dashboard.',\n    domain: 'agent-console',\n    owners: ['@agent-console-team'],\n    tags: ['tool', 'list', 'dashboard'],\n    stability: StabilityEnum.Experimental,\n  },\n  source: {\n    type: 'component',\n    framework: 'react',\n    componentKey: 'ToolListView',\n    props: ToolSummaryModel,\n  },\n  targets: ['react', 'markdown', 'application/json'],\n  policy: { flags: ['agent-console.enabled'] },\n};\n\n/**\n * Presentation for tool detail view.\n */\nexport const ToolDetailPresentation: PresentationSpec = {\n  meta: {\n    key: 'agent-console.tool.detail',\n    version: 1,\n    title: 'Tool Details',\n    description:\n      'Detailed view of an AI tool with configuration and test panel',\n    goal: 'Allow users to inspect and test a specific tool.',\n    context: 'Detailed view of a tool.',\n    domain: 'agent-console',\n    owners: ['@agent-console-team'],\n    tags: ['tool', 'detail'],\n    stability: StabilityEnum.Experimental,\n  },\n  source: {\n    type: 'component',\n    framework: 'react',\n    componentKey: 'ToolDetailView',\n  },\n  targets: ['react', 'markdown'],\n  policy: { flags: ['agent-console.enabled'] },\n};\n"],"mappings":";;;;;;;AAOA,MAAaA,uBAAyC;CACpD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,MAAM;EACN,SAAS;EACT,QAAQ;EACR,QAAQ,CAAC,sBAAsB;EAC/B,MAAM;GAAC;GAAQ;GAAQ;GAAY;EACnC,WAAW,cAAc;EAC1B;CACD,QAAQ;EACN,MAAM;EACN,WAAW;EACX,cAAc;EACd,OAAO;EACR;CACD,SAAS;EAAC;EAAS;EAAY;EAAmB;CAClD,QAAQ,EAAE,OAAO,CAAC,wBAAwB,EAAE;CAC7C;;;;AAKD,MAAaC,yBAA2C;CACtD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,MAAM;EACN,SAAS;EACT,QAAQ;EACR,QAAQ,CAAC,sBAAsB;EAC/B,MAAM,CAAC,QAAQ,SAAS;EACxB,WAAW,cAAc;EAC1B;CACD,QAAQ;EACN,MAAM;EACN,WAAW;EACX,cAAc;EACf;CACD,SAAS,CAAC,SAAS,WAAW;CAC9B,QAAQ,EAAE,OAAO,CAAC,wBAAwB,EAAE;CAC7C"}