@contractspec/example.agent-console 3.8.8 → 3.8.10

package/dist/node/tool/tool.operation.js

@@ -1,482 +1 @@
-// src/tool/tool.enum.ts
-import { defineEnum } from "@contractspec/lib.schema";
-var ToolCategoryEnum = defineEnum("ToolCategory", [
-  "RETRIEVAL",
-  "COMPUTATION",
-  "COMMUNICATION",
-  "INTEGRATION",
-  "UTILITY",
-  "CUSTOM"
-]);
-var ToolStatusEnum = defineEnum("ToolStatus", [
-  "DRAFT",
-  "ACTIVE",
-  "DEPRECATED",
-  "DISABLED"
-]);
-var ImplementationTypeEnum = defineEnum("ImplementationType", [
-  "http",
-  "function",
-  "workflow"
-]);
-
-// src/tool/tool.schema.ts
-import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
-var ToolModel = defineSchemaModel({
-  name: "Tool",
-  description: "AI tool definition",
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    organizationId: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isOptional: false
-    },
-    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
-    slug: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    category: { type: ToolCategoryEnum, isOptional: false },
-    status: { type: ToolStatusEnum, isOptional: false },
-    parametersSchema: { type: ScalarTypeEnum.JSONObject(), isOptional: false },
-    outputSchema: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
-    implementationType: { type: ImplementationTypeEnum, isOptional: false },
-    implementationConfig: {
-      type: ScalarTypeEnum.JSONObject(),
-      isOptional: false
-    },
-    maxInvocationsPerMinute: {
-      type: ScalarTypeEnum.Int_unsecure(),
-      isOptional: true
-    },
-    timeoutMs: {
-      type: ScalarTypeEnum.Int_unsecure(),
-      isOptional: false,
-      defaultValue: 30000
-    },
-    version: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
-    tags: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isArray: true,
-      isOptional: true
-    },
-    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
-    updatedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
-  }
-});
-var ToolSummaryModel = defineSchemaModel({
-  name: "ToolSummary",
-  description: "Summary of a tool for list views",
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
-    slug: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    category: { type: ToolCategoryEnum, isOptional: false },
-    status: { type: ToolStatusEnum, isOptional: false },
-    version: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
-    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
-  }
-});
-var CreateToolInputModel = defineSchemaModel({
-  name: "CreateToolInput",
-  description: "Input for creating a tool",
-  fields: {
-    organizationId: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isOptional: false
-    },
-    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
-    slug: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    category: { type: ToolCategoryEnum, isOptional: true },
-    parametersSchema: { type: ScalarTypeEnum.JSONObject(), isOptional: false },
-    outputSchema: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
-    implementationType: { type: ImplementationTypeEnum, isOptional: false },
-    implementationConfig: {
-      type: ScalarTypeEnum.JSONObject(),
-      isOptional: false
-    },
-    maxInvocationsPerMinute: {
-      type: ScalarTypeEnum.Int_unsecure(),
-      isOptional: true
-    },
-    timeoutMs: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
-    tags: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isArray: true,
-      isOptional: true
-    }
-  }
-});
-var UpdateToolInputModel = defineSchemaModel({
-  name: "UpdateToolInput",
-  description: "Input for updating a tool",
-  fields: {
-    toolId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: true },
-    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    status: { type: ToolStatusEnum, isOptional: true },
-    parametersSchema: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
-    outputSchema: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
-    implementationConfig: {
-      type: ScalarTypeEnum.JSONObject(),
-      isOptional: true
-    },
-    maxInvocationsPerMinute: {
-      type: ScalarTypeEnum.Int_unsecure(),
-      isOptional: true
-    },
-    timeoutMs: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
-    tags: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isArray: true,
-      isOptional: true
-    }
-  }
-});
-
-// src/tool/tool.operation.ts
-import {
-  defineCommand,
-  defineQuery
-} from "@contractspec/lib.contracts-spec/operations";
-import { defineSchemaModel as defineSchemaModel2, ScalarTypeEnum as ScalarTypeEnum2 } from "@contractspec/lib.schema";
-var OWNERS = ["@agent-console-team"];
-var CreateToolCommand = defineCommand({
-  meta: {
-    key: "agent.tool.create",
-    version: "1.0.0",
-    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: defineSchemaModel2({
-      name: "CreateToolOutput",
-      fields: {
-        id: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-        name: { type: ScalarTypeEnum2.NonEmptyString(), isOptional: false },
-        slug: { type: ScalarTypeEnum2.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.0.0",
-        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"
-        }
-      }
-    ]
-  }
-});
-var UpdateToolCommand = defineCommand({
-  meta: {
-    key: "agent.tool.update",
-    version: "1.0.0",
-    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: defineSchemaModel2({
-      name: "UpdateToolOutput",
-      fields: {
-        id: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-        name: { type: ScalarTypeEnum2.NonEmptyString(), isOptional: false },
-        status: { type: ToolStatusEnum, isOptional: false },
-        updatedAt: { type: ScalarTypeEnum2.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.0.0",
-        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"
-        }
-      }
-    ]
-  }
-});
-var GetToolQuery = defineQuery({
-  meta: {
-    key: "agent.tool.get",
-    version: "1.0.0",
-    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: defineSchemaModel2({
-      name: "GetToolInput",
-      fields: {
-        toolId: { type: ScalarTypeEnum2.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"
-        }
-      }
-    ]
-  }
-});
-var ListToolsQuery = defineQuery({
-  meta: {
-    key: "agent.tool.list",
-    version: "1.0.0",
-    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: defineSchemaModel2({
-      name: "ListToolsInput",
-      fields: {
-        organizationId: {
-          type: ScalarTypeEnum2.String_unsecure(),
-          isOptional: false
-        },
-        category: { type: ToolCategoryEnum, isOptional: true },
-        status: { type: ToolStatusEnum, isOptional: true },
-        search: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true },
-        limit: {
-          type: ScalarTypeEnum2.Int_unsecure(),
-          isOptional: true,
-          defaultValue: 20
-        },
-        offset: {
-          type: ScalarTypeEnum2.Int_unsecure(),
-          isOptional: true,
-          defaultValue: 0
-        }
-      }
-    }),
-    output: defineSchemaModel2({
-      name: "ListToolsOutput",
-      fields: {
-        items: { type: ToolSummaryModel, isArray: true, isOptional: false },
-        total: { type: ScalarTypeEnum2.Int_unsecure(), isOptional: false },
-        hasMore: { type: ScalarTypeEnum2.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 }
-      }
-    ]
-  }
-});
-var TestToolCommand = defineCommand({
-  meta: {
-    key: "agent.tool.test",
-    version: "1.0.0",
-    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: defineSchemaModel2({
-      name: "TestToolInput",
-      fields: {
-        toolId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-        testInput: { type: ScalarTypeEnum2.JSONObject(), isOptional: false }
-      }
-    }),
-    output: defineSchemaModel2({
-      name: "TestToolOutput",
-      fields: {
-        success: { type: ScalarTypeEnum2.Boolean(), isOptional: false },
-        output: { type: ScalarTypeEnum2.JSONObject(), isOptional: true },
-        error: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true },
-        durationMs: { type: ScalarTypeEnum2.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 }
-      }
-    ]
-  }
-});
-export {
-  UpdateToolCommand,
-  TestToolCommand,
-  ListToolsQuery,
-  GetToolQuery,
-  CreateToolCommand
-};
+import{defineEnum as B}from"@contractspec/lib.schema";var x=B("ToolCategory",["RETRIEVAL","COMPUTATION","COMMUNICATION","INTEGRATION","UTILITY","CUSTOM"]),q=B("ToolStatus",["DRAFT","ACTIVE","DEPRECATED","DISABLED"]),D=B("ImplementationType",["http","function","workflow"]);import{defineSchemaModel as z,ScalarTypeEnum as j}from"@contractspec/lib.schema";var G=z({name:"Tool",description:"AI tool definition",fields:{id:{type:j.String_unsecure(),isOptional:!1},organizationId:{type:j.String_unsecure(),isOptional:!1},name:{type:j.NonEmptyString(),isOptional:!1},slug:{type:j.String_unsecure(),isOptional:!1},description:{type:j.String_unsecure(),isOptional:!1},category:{type:x,isOptional:!1},status:{type:q,isOptional:!1},parametersSchema:{type:j.JSONObject(),isOptional:!1},outputSchema:{type:j.JSONObject(),isOptional:!0},implementationType:{type:D,isOptional:!1},implementationConfig:{type:j.JSONObject(),isOptional:!1},maxInvocationsPerMinute:{type:j.Int_unsecure(),isOptional:!0},timeoutMs:{type:j.Int_unsecure(),isOptional:!1,defaultValue:30000},version:{type:j.NonEmptyString(),isOptional:!1},tags:{type:j.String_unsecure(),isArray:!0,isOptional:!0},createdAt:{type:j.DateTime(),isOptional:!1},updatedAt:{type:j.DateTime(),isOptional:!1}}}),A=z({name:"ToolSummary",description:"Summary of a tool for list views",fields:{id:{type:j.String_unsecure(),isOptional:!1},name:{type:j.NonEmptyString(),isOptional:!1},slug:{type:j.String_unsecure(),isOptional:!1},description:{type:j.String_unsecure(),isOptional:!1},category:{type:x,isOptional:!1},status:{type:q,isOptional:!1},version:{type:j.NonEmptyString(),isOptional:!1},createdAt:{type:j.DateTime(),isOptional:!1}}}),H=z({name:"CreateToolInput",description:"Input for creating a tool",fields:{organizationId:{type:j.String_unsecure(),isOptional:!1},name:{type:j.NonEmptyString(),isOptional:!1},slug:{type:j.String_unsecure(),isOptional:!1},description:{type:j.String_unsecure(),isOptional:!1},category:{type:x,isOptional:!0},parametersSchema:{type:j.JSONObject(),isOptional:!1},outputSchema:{type:j.JSONObject(),isOptional:!0},implementationType:{type:D,isOptional:!1},implementationConfig:{type:j.JSONObject(),isOptional:!1},maxInvocationsPerMinute:{type:j.Int_unsecure(),isOptional:!0},timeoutMs:{type:j.Int_unsecure(),isOptional:!0},tags:{type:j.String_unsecure(),isArray:!0,isOptional:!0}}}),J=z({name:"UpdateToolInput",description:"Input for updating a tool",fields:{toolId:{type:j.String_unsecure(),isOptional:!1},name:{type:j.NonEmptyString(),isOptional:!0},description:{type:j.String_unsecure(),isOptional:!0},status:{type:q,isOptional:!0},parametersSchema:{type:j.JSONObject(),isOptional:!0},outputSchema:{type:j.JSONObject(),isOptional:!0},implementationConfig:{type:j.JSONObject(),isOptional:!0},maxInvocationsPerMinute:{type:j.Int_unsecure(),isOptional:!0},timeoutMs:{type:j.Int_unsecure(),isOptional:!0},tags:{type:j.String_unsecure(),isArray:!0,isOptional:!0}}});import{defineCommand as F,defineQuery as K}from"@contractspec/lib.contracts-spec/operations";import{defineSchemaModel as v,ScalarTypeEnum as k}from"@contractspec/lib.schema";var w=["@agent-console-team"],Q=F({meta:{key:"agent.tool.create",version:"1.0.0",stability:"stable",owners:[...w],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:H,output:v({name:"CreateToolOutput",fields:{id:{type:k.String_unsecure(),isOptional:!1},name:{type:k.NonEmptyString(),isOptional:!1},slug:{type:k.String_unsecure(),isOptional:!1},status:{type:q,isOptional:!1}}}),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.0.0",stability:"stable",owners:[...w],tags:["tool","created"],when:"Tool is successfully created",payload:A}],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"}}]}}),b=F({meta:{key:"agent.tool.update",version:"1.0.0",stability:"stable",owners:[...w],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:J,output:v({name:"UpdateToolOutput",fields:{id:{type:k.String_unsecure(),isOptional:!1},name:{type:k.NonEmptyString(),isOptional:!1},status:{type:q,isOptional:!1},updatedAt:{type:k.DateTime(),isOptional:!1}}}),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.0.0",stability:"stable",owners:[...w],tags:["tool","updated"],when:"Tool is updated",payload:A}],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"}}]}}),g=K({meta:{key:"agent.tool.get",version:"1.0.0",stability:"stable",owners:[...w],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:v({name:"GetToolInput",fields:{toolId:{type:k.String_unsecure(),isOptional:!1}}}),output:G,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"}}]}}),I=K({meta:{key:"agent.tool.list",version:"1.0.0",stability:"stable",owners:[...w],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:v({name:"ListToolsInput",fields:{organizationId:{type:k.String_unsecure(),isOptional:!1},category:{type:x,isOptional:!0},status:{type:q,isOptional:!0},search:{type:k.String_unsecure(),isOptional:!0},limit:{type:k.Int_unsecure(),isOptional:!0,defaultValue:20},offset:{type:k.Int_unsecure(),isOptional:!0,defaultValue:0}}}),output:v({name:"ListToolsOutput",fields:{items:{type:A,isArray:!0,isOptional:!1},total:{type:k.Int_unsecure(),isOptional:!1},hasMore:{type:k.Boolean(),isOptional:!1}}})},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:!1}}]}}),N=F({meta:{key:"agent.tool.test",version:"1.0.0",stability:"stable",owners:[...w],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:v({name:"TestToolInput",fields:{toolId:{type:k.String_unsecure(),isOptional:!1},testInput:{type:k.JSONObject(),isOptional:!1}}}),output:v({name:"TestToolOutput",fields:{success:{type:k.Boolean(),isOptional:!1},output:{type:k.JSONObject(),isOptional:!0},error:{type:k.String_unsecure(),isOptional:!0},durationMs:{type:k.Int_unsecure(),isOptional:!1}}}),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:!0,output:{temperature:22},durationMs:150}}]}});export{b as UpdateToolCommand,N as TestToolCommand,I as ListToolsQuery,g as GetToolQuery,Q as CreateToolCommand};

package/dist/node/tool/tool.presentation.js

@@ -1,188 +1 @@
-// src/tool/tool.enum.ts
-import { defineEnum } from "@contractspec/lib.schema";
-var ToolCategoryEnum = defineEnum("ToolCategory", [
-  "RETRIEVAL",
-  "COMPUTATION",
-  "COMMUNICATION",
-  "INTEGRATION",
-  "UTILITY",
-  "CUSTOM"
-]);
-var ToolStatusEnum = defineEnum("ToolStatus", [
-  "DRAFT",
-  "ACTIVE",
-  "DEPRECATED",
-  "DISABLED"
-]);
-var ImplementationTypeEnum = defineEnum("ImplementationType", [
-  "http",
-  "function",
-  "workflow"
-]);
-
-// src/tool/tool.schema.ts
-import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
-var ToolModel = defineSchemaModel({
-  name: "Tool",
-  description: "AI tool definition",
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    organizationId: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isOptional: false
-    },
-    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
-    slug: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    category: { type: ToolCategoryEnum, isOptional: false },
-    status: { type: ToolStatusEnum, isOptional: false },
-    parametersSchema: { type: ScalarTypeEnum.JSONObject(), isOptional: false },
-    outputSchema: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
-    implementationType: { type: ImplementationTypeEnum, isOptional: false },
-    implementationConfig: {
-      type: ScalarTypeEnum.JSONObject(),
-      isOptional: false
-    },
-    maxInvocationsPerMinute: {
-      type: ScalarTypeEnum.Int_unsecure(),
-      isOptional: true
-    },
-    timeoutMs: {
-      type: ScalarTypeEnum.Int_unsecure(),
-      isOptional: false,
-      defaultValue: 30000
-    },
-    version: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
-    tags: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isArray: true,
-      isOptional: true
-    },
-    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
-    updatedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
-  }
-});
-var ToolSummaryModel = defineSchemaModel({
-  name: "ToolSummary",
-  description: "Summary of a tool for list views",
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
-    slug: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    category: { type: ToolCategoryEnum, isOptional: false },
-    status: { type: ToolStatusEnum, isOptional: false },
-    version: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
-    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
-  }
-});
-var CreateToolInputModel = defineSchemaModel({
-  name: "CreateToolInput",
-  description: "Input for creating a tool",
-  fields: {
-    organizationId: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isOptional: false
-    },
-    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
-    slug: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    category: { type: ToolCategoryEnum, isOptional: true },
-    parametersSchema: { type: ScalarTypeEnum.JSONObject(), isOptional: false },
-    outputSchema: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
-    implementationType: { type: ImplementationTypeEnum, isOptional: false },
-    implementationConfig: {
-      type: ScalarTypeEnum.JSONObject(),
-      isOptional: false
-    },
-    maxInvocationsPerMinute: {
-      type: ScalarTypeEnum.Int_unsecure(),
-      isOptional: true
-    },
-    timeoutMs: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
-    tags: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isArray: true,
-      isOptional: true
-    }
-  }
-});
-var UpdateToolInputModel = defineSchemaModel({
-  name: "UpdateToolInput",
-  description: "Input for updating a tool",
-  fields: {
-    toolId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: true },
-    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    status: { type: ToolStatusEnum, isOptional: true },
-    parametersSchema: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
-    outputSchema: { type: ScalarTypeEnum.JSONObject(), isOptional: true },
-    implementationConfig: {
-      type: ScalarTypeEnum.JSONObject(),
-      isOptional: true
-    },
-    maxInvocationsPerMinute: {
-      type: ScalarTypeEnum.Int_unsecure(),
-      isOptional: true
-    },
-    timeoutMs: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
-    tags: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isArray: true,
-      isOptional: true
-    }
-  }
-});
-
-// src/tool/tool.presentation.ts
-import {
-  definePresentation,
-  StabilityEnum
-} from "@contractspec/lib.contracts-spec";
-var ToolListPresentation = definePresentation({
-  meta: {
-    key: "agent-console.tool.list",
-    version: "1.0.0",
-    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"] }
-});
-var ToolDetailPresentation = definePresentation({
-  meta: {
-    key: "agent-console.tool.detail",
-    version: "1.0.0",
-    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"] }
-});
-export {
-  ToolListPresentation,
-  ToolDetailPresentation
-};
+import{defineEnum as w}from"@contractspec/lib.schema";var k=w("ToolCategory",["RETRIEVAL","COMPUTATION","COMMUNICATION","INTEGRATION","UTILITY","CUSTOM"]),q=w("ToolStatus",["DRAFT","ACTIVE","DEPRECATED","DISABLED"]),x=w("ImplementationType",["http","function","workflow"]);import{defineSchemaModel as v,ScalarTypeEnum as j}from"@contractspec/lib.schema";var J=v({name:"Tool",description:"AI tool definition",fields:{id:{type:j.String_unsecure(),isOptional:!1},organizationId:{type:j.String_unsecure(),isOptional:!1},name:{type:j.NonEmptyString(),isOptional:!1},slug:{type:j.String_unsecure(),isOptional:!1},description:{type:j.String_unsecure(),isOptional:!1},category:{type:k,isOptional:!1},status:{type:q,isOptional:!1},parametersSchema:{type:j.JSONObject(),isOptional:!1},outputSchema:{type:j.JSONObject(),isOptional:!0},implementationType:{type:x,isOptional:!1},implementationConfig:{type:j.JSONObject(),isOptional:!1},maxInvocationsPerMinute:{type:j.Int_unsecure(),isOptional:!0},timeoutMs:{type:j.Int_unsecure(),isOptional:!1,defaultValue:30000},version:{type:j.NonEmptyString(),isOptional:!1},tags:{type:j.String_unsecure(),isArray:!0,isOptional:!0},createdAt:{type:j.DateTime(),isOptional:!1},updatedAt:{type:j.DateTime(),isOptional:!1}}}),z=v({name:"ToolSummary",description:"Summary of a tool for list views",fields:{id:{type:j.String_unsecure(),isOptional:!1},name:{type:j.NonEmptyString(),isOptional:!1},slug:{type:j.String_unsecure(),isOptional:!1},description:{type:j.String_unsecure(),isOptional:!1},category:{type:k,isOptional:!1},status:{type:q,isOptional:!1},version:{type:j.NonEmptyString(),isOptional:!1},createdAt:{type:j.DateTime(),isOptional:!1}}}),K=v({name:"CreateToolInput",description:"Input for creating a tool",fields:{organizationId:{type:j.String_unsecure(),isOptional:!1},name:{type:j.NonEmptyString(),isOptional:!1},slug:{type:j.String_unsecure(),isOptional:!1},description:{type:j.String_unsecure(),isOptional:!1},category:{type:k,isOptional:!0},parametersSchema:{type:j.JSONObject(),isOptional:!1},outputSchema:{type:j.JSONObject(),isOptional:!0},implementationType:{type:x,isOptional:!1},implementationConfig:{type:j.JSONObject(),isOptional:!1},maxInvocationsPerMinute:{type:j.Int_unsecure(),isOptional:!0},timeoutMs:{type:j.Int_unsecure(),isOptional:!0},tags:{type:j.String_unsecure(),isArray:!0,isOptional:!0}}}),L=v({name:"UpdateToolInput",description:"Input for updating a tool",fields:{toolId:{type:j.String_unsecure(),isOptional:!1},name:{type:j.NonEmptyString(),isOptional:!0},description:{type:j.String_unsecure(),isOptional:!0},status:{type:q,isOptional:!0},parametersSchema:{type:j.JSONObject(),isOptional:!0},outputSchema:{type:j.JSONObject(),isOptional:!0},implementationConfig:{type:j.JSONObject(),isOptional:!0},maxInvocationsPerMinute:{type:j.Int_unsecure(),isOptional:!0},timeoutMs:{type:j.Int_unsecure(),isOptional:!0},tags:{type:j.String_unsecure(),isArray:!0,isOptional:!0}}});import{definePresentation as A,StabilityEnum as B}from"@contractspec/lib.contracts-spec";var R=A({meta:{key:"agent-console.tool.list",version:"1.0.0",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:B.Experimental},source:{type:"component",framework:"react",componentKey:"ToolListView",props:z},targets:["react","markdown","application/json"],policy:{flags:["agent-console.enabled"]}}),U=A({meta:{key:"agent-console.tool.detail",version:"1.0.0",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:B.Experimental},source:{type:"component",framework:"react",componentKey:"ToolDetailView"},targets:["react","markdown"],policy:{flags:["agent-console.enabled"]}});export{R as ToolListPresentation,U as ToolDetailPresentation};