@agenticforge/skills 1.1.0 → 1.1.1

package/dist/types/tools/src/Tool.d.ts

@@ -1,74 +0,0 @@
-import "reflect-metadata";
-import { z, type ZodType } from "zod";
-import type { ToolParameter } from "./types";
-export type { ToolParameter };
-export interface OpenAIFunctionSchema {
-    type: "function";
-    function: {
-        name: string;
-        description: string;
-        parameters: Record<string, unknown>;
-    };
-}
-export interface ToolActionMeta {
-    key: string;
-    description: string;
-    method: string;
-}
-/**
- * Decorator that registers a method as a named tool action.
- * Usage: @toolAction("action_key", "Description")
- */
-export declare function toolAction(key: string, description: string): (target: object, propertyKey: string, _descriptor: PropertyDescriptor) => void;
-export declare abstract class Tool {
-    readonly name: string;
-    readonly description: string;
-    readonly expandable: boolean;
-    constructor(name: string, description: string, expandable?: boolean);
-    abstract run(parameters: Record<string, unknown>): Promise<string> | string;
-    abstract getParameters(): ToolParameter[];
-    /**
-     * Validate that required parameters are present and have basic types.
-     * Returns true if valid.
-     */
-    validateParameters(parameters: Record<string, unknown>): boolean;
-    /**
-     * Validate and coerce parameters, returning a Result object.
-     */
-    validateAndNormalizeParameters(parameters: Record<string, unknown>): {
-        success: true;
-        data: Record<string, unknown>;
-    } | {
-        success: false;
-        error: string;
-    };
-    /**
-     * Convert this Tool to an OpenAI function-calling schema.
-     */
-    toOpenAISchema(): OpenAIFunctionSchema;
-    /**
-     * Return a formatted description of all available tool actions (for system prompt).
-     */
-    describe(): string;
-}
-export interface FunctionTool<TArgs = Record<string, unknown>> {
-    name: string;
-    description: string;
-    func: (args: TArgs) => string | Promise<string>;
-    schema?: ZodType<TArgs>;
-}
-/**
- * Convenience factory for creating type-safe function tools.
- *
- * ```ts
- * const myTool = defineFunctionTool({
- *   name: "myTool",
- *   description: "...",
- *   schema: z.object({ input: z.string() }),
- *   func: ({ input }) => input.toUpperCase(),
- * });
- * ```
- */
-export declare function defineFunctionTool<TArgs extends Record<string, unknown>>(options: FunctionTool<TArgs>): FunctionTool<TArgs>;
-export { z };
-//# sourceMappingURL=Tool.d.ts.map

package/dist/types/tools/src/Tool.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Tool.d.ts","sourceRoot":"","sources":["../../../../../tools/src/Tool.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAC,CAAC,EAAE,KAAK,OAAO,EAAC,MAAM,KAAK,CAAC;AACpC,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,SAAS,CAAC;AAE3C,YAAY,EAAC,aAAa,EAAC,CAAC;AAM5B,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACrC,CAAC;CACH;AAQD,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,IAEvD,QAAQ,MAAM,EACd,aAAa,MAAM,EACnB,aAAa,kBAAkB,KAC9B,IAAI,CAMR;AAMD,8BAAsB,IAAI;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;gBAEjB,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,UAAQ;IAMjE,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM;IAC3E,QAAQ,CAAC,aAAa,IAAI,aAAa,EAAE;IAEzC;;;OAGG;IACH,kBAAkB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IAUhE;;OAEG;IACH,8BAA8B,CAC5B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC;QAAC,OAAO,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAC,GAAG;QAAC,OAAO,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC;IAwBnF;;OAEG;IACH,cAAc,IAAI,oBAAoB;IA8BtC;;OAEG;IACH,QAAQ,IAAI,MAAM;CAUnB;AAcD,MAAM,WAAW,YAAY,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtE,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,GAC3B,YAAY,CAAC,KAAK,CAAC,CAErB;AAED,OAAO,EAAC,CAAC,EAAC,CAAC"}

package/dist/types/tools/src/ToolChain.d.ts

@@ -1,47 +0,0 @@
-import { ToolRegistry } from "./ToolRegistry";
-export interface ToolChainStep {
-    /** Name of the tool/function to call */
-    toolName: string;
-    /** Input template string; use {variableName} to reference context variables */
-    inputTemplate: string;
-    /** Key under which the step output is stored in context */
-    outputKey: string;
-}
-/**
- * A sequential chain of tool steps.
- * Each step can reference outputs of prior steps via `{key}` placeholders.
- *
- * ```ts
- * const chain = new ToolChain("my_chain", "Does X then Y");
- * chain.addStep("search", "{input}", "search_result");
- * chain.addStep("summarize", "{search_result}", "summary");
- * ```
- */
-export declare class ToolChain {
-    readonly name: string;
-    readonly description: string;
-    private readonly steps;
-    constructor(name: string, description: string);
-    addStep(toolName: string, inputTemplate: string, outputKey: string): this;
-    getSteps(): ToolChainStep[];
-    /**
-     * Execute the chain against a registry.
-     * @param registry  ToolRegistry that holds the referenced tools.
-     * @param input     Initial `{input}` value.
-     * @returns         The value stored under the last step's outputKey.
-     */
-    execute(registry: ToolRegistry, input: string): Promise<string>;
-}
-/**
- * Manages multiple named ToolChains and executes them against a shared registry.
- */
-export declare class ToolChainManager {
-    private readonly chains;
-    private readonly registry;
-    constructor(registry: ToolRegistry);
-    registerChain(chain: ToolChain): void;
-    getChain(name: string): ToolChain | undefined;
-    listChains(): string[];
-    executeChain(chainName: string, input: string): Promise<string>;
-}
-//# sourceMappingURL=ToolChain.d.ts.map

package/dist/types/tools/src/ToolChain.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ToolChain.d.ts","sourceRoot":"","sources":["../../../../../tools/src/ToolChain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAM5C,MAAM,WAAW,aAAa;IAC5B,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,aAAa,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD;;;;;;;;;GASG;AACH,qBAAa,SAAS;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;gBAEjC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAK7C,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAKzE,QAAQ,IAAI,aAAa,EAAE;IAI3B;;;;;OAKG;IACG,OAAO,CAAC,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAatE;AAMD;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IACvD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;gBAE5B,QAAQ,EAAE,YAAY;IAIlC,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAIrC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI7C,UAAU,IAAI,MAAM,EAAE;IAIhB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAKtE"}

package/dist/types/tools/src/ToolRegistry.d.ts

@@ -1,22 +0,0 @@
-import { Tool, type FunctionTool, type OpenAIFunctionSchema } from "./Tool";
-/**
- * Central registry that manages Tool instances and raw FunctionTools.
- * Supports registration, lookup, and execution.
- */
-export declare class ToolRegistry {
-    private readonly tools;
-    private readonly functions;
-    registerTool(tool: Tool): void;
-    unregisterTool(name: string): boolean;
-    registerFunction<TArgs extends Record<string, unknown>>(name: string, description: string, func: (args: TArgs) => string | Promise<string>, schema?: FunctionTool<TArgs>["schema"]): void;
-    unregisterFunction(name: string): boolean;
-    getTool(name: string): Tool | undefined;
-    getFunction(name: string): FunctionTool<Record<string, unknown>> | undefined;
-    getAllTools(): Tool[];
-    listTools(): string[];
-    hasTool(name: string): boolean;
-    execute(name: string, parameters: Record<string, unknown>): Promise<string>;
-    getAvailableTools(): string;
-    getOpenAISchemas(): Array<OpenAIFunctionSchema | Record<string, unknown>>;
-}
-//# sourceMappingURL=ToolRegistry.d.ts.map

package/dist/types/tools/src/ToolRegistry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ToolRegistry.d.ts","sourceRoot":"","sources":["../../../../../tools/src/ToolRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAE,KAAK,YAAY,EAAE,KAAK,oBAAoB,EAAC,MAAM,QAAQ,CAAC;AAE1E;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;IACjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4D;IAMtF,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAI9B,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIrC,gBAAgB,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpD,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,EAC/C,MAAM,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,GACrC,IAAI;IASP,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQzC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIvC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS;IAI5E,WAAW,IAAI,IAAI,EAAE;IAIrB,SAAS,IAAI,MAAM,EAAE;IAOrB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQxB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAkBjF,iBAAiB,IAAI,MAAM;IAe3B,gBAAgB,IAAI,KAAK,CAAC,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAyB1E"}

package/dist/types/tools/src/index.d.ts

@@ -1,6 +0,0 @@
-export * from "./Tool";
-export * from "./ToolChain";
-export * from "./ToolRegistry";
-export * from "./AsyncToolExecutor";
-export * from "./types";
-//# sourceMappingURL=index.d.ts.map

package/dist/types/tools/src/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../tools/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC"}

package/dist/types/tools/src/types.d.ts

@@ -1,13 +0,0 @@
-export interface ToolParameter {
-    name: string;
-    type: string;
-    description: string;
-    required: boolean;
-    default: unknown;
-}
-export interface ToolResult {
-    success: boolean;
-    output: string;
-    error?: string;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/types/tools/src/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../tools/src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}