@haikeilabs/agentware 0.1.0

package/dist/middleware/types.d.ts

@@ -0,0 +1,42 @@
+export declare enum MessageType {
+    SYSTEM_PROMPT = "system_prompt",
+    USER_INPUT = "user_input",
+    TOOL_CALL = "tool_call",
+    TOOL_RESULT = "tool_result",
+    REASONING = "reasoning",
+    TEXT_RESPONSE = "text_response",
+    STEP_NUDGE = "step_nudge",
+    PREREQUISITE_NUDGE = "prerequisite_nudge",
+    RETRY_NUDGE = "retry_nudge",
+    CONTEXT_WARNING = "context_warning",
+    SUMMARY = "summary"
+}
+export interface MessageMeta {
+    type: MessageType;
+    step_index?: number;
+    original_type?: MessageType;
+    token_estimate?: number;
+}
+export declare enum Action {
+    ALLOW = "allow",
+    DENY = "deny",
+    FILTER = "filter"
+}
+export interface CallerContext {
+    user_id?: string;
+    session_id?: string;
+    role?: string;
+    source?: string;
+    trusted: boolean;
+    metadata?: Record<string, string>;
+}
+export interface Decision {
+    action: Action;
+    rule: string;
+    reason: string;
+    redacted_args?: Record<string, unknown>;
+    timestamp: Date;
+}
+export declare function createAllowDecision(reason?: string): Decision;
+export declare function createDenyDecision(reason: string): Decision;
+//# sourceMappingURL=types.d.ts.map

package/dist/middleware/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/middleware/types.ts"],"names":[],"mappings":"AAAA,oBAAY,WAAW;IACrB,aAAa,kBAAkB;IAC/B,UAAU,eAAe;IACzB,SAAS,cAAc;IACvB,WAAW,gBAAgB;IAC3B,SAAS,cAAc;IACvB,aAAa,kBAAkB;IAC/B,UAAU,eAAe;IACzB,kBAAkB,uBAAuB;IACzC,WAAW,gBAAgB;IAC3B,eAAe,oBAAoB;IACnC,OAAO,YAAY;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,WAAW,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,WAAW,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,oBAAY,MAAM;IAChB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,MAAM,WAAW;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,wBAAgB,mBAAmB,CAAC,MAAM,SAAY,GAAG,QAAQ,CAOhE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAO3D"}

package/dist/middleware/types.js

@@ -0,0 +1,36 @@
+export var MessageType;
+(function (MessageType) {
+    MessageType["SYSTEM_PROMPT"] = "system_prompt";
+    MessageType["USER_INPUT"] = "user_input";
+    MessageType["TOOL_CALL"] = "tool_call";
+    MessageType["TOOL_RESULT"] = "tool_result";
+    MessageType["REASONING"] = "reasoning";
+    MessageType["TEXT_RESPONSE"] = "text_response";
+    MessageType["STEP_NUDGE"] = "step_nudge";
+    MessageType["PREREQUISITE_NUDGE"] = "prerequisite_nudge";
+    MessageType["RETRY_NUDGE"] = "retry_nudge";
+    MessageType["CONTEXT_WARNING"] = "context_warning";
+    MessageType["SUMMARY"] = "summary";
+})(MessageType || (MessageType = {}));
+export var Action;
+(function (Action) {
+    Action["ALLOW"] = "allow";
+    Action["DENY"] = "deny";
+    Action["FILTER"] = "filter";
+})(Action || (Action = {}));
+export function createAllowDecision(reason = "allowed") {
+    return {
+        action: Action.ALLOW,
+        rule: "default",
+        reason,
+        timestamp: new Date(),
+    };
+}
+export function createDenyDecision(reason) {
+    return {
+        action: Action.DENY,
+        rule: "default",
+        reason,
+        timestamp: new Date(),
+    };
+}

package/dist/prompts/generator.d.ts

@@ -0,0 +1,10 @@
+import type { ToolRegistry } from "../tools/index.js";
+export interface PromptGenerator {
+    generateToolSection(registry: ToolRegistry): string;
+    generateToolSchemas(registry: ToolRegistry): object[];
+}
+export declare class DefaultPromptGenerator implements PromptGenerator {
+    generateToolSection(registry: ToolRegistry): string;
+    generateToolSchemas(registry: ToolRegistry): object[];
+}
+//# sourceMappingURL=generator.d.ts.map

package/dist/prompts/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/prompts/generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,WAAW,eAAe;IAC9B,mBAAmB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAAC;IACpD,mBAAmB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,EAAE,CAAC;CACvD;AAED,qBAAa,sBAAuB,YAAW,eAAe;IAC5D,mBAAmB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM;IAWnD,mBAAmB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,EAAE;CAatD"}

package/dist/prompts/generator.js

@@ -0,0 +1,24 @@
+export class DefaultPromptGenerator {
+    generateToolSection(registry) {
+        const tools = registry.all();
+        if (tools.length === 0)
+            return "";
+        const lines = ["## Available Tools\n"];
+        for (const tool of tools) {
+            lines.push(`- **${tool.name}**: ${tool.description}`);
+        }
+        return lines.join("\n");
+    }
+    generateToolSchemas(registry) {
+        return registry.all().map((tool) => ({
+            type: "function",
+            function: {
+                name: tool.name,
+                description: tool.description,
+                parameters: "inputSchema" in tool
+                    ? tool.inputSchema()
+                    : {},
+            },
+        }));
+    }
+}

package/dist/prompts/index.d.ts

@@ -0,0 +1,2 @@
+export { PromptGenerator, DefaultPromptGenerator } from "./generator.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/prompts/index.js

@@ -0,0 +1 @@
+export { DefaultPromptGenerator } from "./generator.js";

package/dist/toolformat/formatter.d.ts

@@ -0,0 +1,20 @@
+import type { Tool, Result } from "../tools/index.js";
+export interface ParsedToolCall {
+    id: string;
+    name: string;
+    args: Record<string, unknown>;
+    raw: string;
+}
+export interface ToolFormatter {
+    formatToolDefinitions(tools: Tool[]): string;
+    parseToolCalls(response: string): ParsedToolCall[];
+    formatToolResult(name: string, result: Result): string;
+    modelFamily(): string;
+}
+export declare class GenericFormatter implements ToolFormatter {
+    formatToolDefinitions(tools: Tool[]): string;
+    parseToolCalls(_response: string): ParsedToolCall[];
+    formatToolResult(name: string, result: Result): string;
+    modelFamily(): string;
+}
+//# sourceMappingURL=formatter.d.ts.map

package/dist/toolformat/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../src/toolformat/formatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,aAAa;IAC5B,qBAAqB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;IAC7C,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,EAAE,CAAC;IACnD,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACvD,WAAW,IAAI,MAAM,CAAC;CACvB;AAED,qBAAa,gBAAiB,YAAW,aAAa;IACpD,qBAAqB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM;IAU5C,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,EAAE;IAInD,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAMtD,WAAW,IAAI,MAAM;CAGtB"}

package/dist/toolformat/formatter.js

@@ -0,0 +1,22 @@
+export class GenericFormatter {
+    formatToolDefinitions(tools) {
+        if (tools.length === 0)
+            return "No tools available.";
+        const lines = ["Available tools:"];
+        for (const tool of tools) {
+            lines.push(`- ${tool.name}: ${tool.description}`);
+        }
+        return lines.join("\n");
+    }
+    parseToolCalls(_response) {
+        return [];
+    }
+    formatToolResult(name, result) {
+        return result.success
+            ? `Tool ${name} result: ${JSON.stringify(result.data)}`
+            : `Tool ${name} error: ${result.error}`;
+    }
+    modelFamily() {
+        return "generic";
+    }
+}

package/dist/toolformat/index.d.ts

@@ -0,0 +1,2 @@
+export { ToolFormatter, ParsedToolCall, GenericFormatter } from "./formatter.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/toolformat/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/toolformat/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/toolformat/index.js

@@ -0,0 +1 @@
+export { GenericFormatter } from "./formatter.js";

package/dist/tools/async.d.ts

@@ -0,0 +1,42 @@
+/** A sync or async tool handler with host-supplied context and cancellation. */
+export type AsyncToolHandler<Input, Output, Context> = (input: Input, context: Context, signal: AbortSignal) => Output | Promise<Output>;
+/** A wrapped tool handler. Kept separate so host frameworks can preserve schemas. */
+export type WrappedTool<Input, Output, Context> = (input: Input, context: Context, options?: ToolInvocationOptions) => Promise<Output>;
+/** Per-call cancellation and deadline controls. */
+export interface ToolInvocationOptions {
+    readonly signal?: AbortSignal;
+    readonly timeoutMs?: number;
+}
+/** Safe lifecycle metadata; it intentionally excludes tool inputs and context. */
+export interface ToolLifecycleEvent {
+    readonly type: "started" | "succeeded" | "failed" | "aborted" | "timed_out";
+    readonly toolName?: string;
+    readonly durationMs: number;
+}
+/** Best-effort event hook for metrics and tracing. Hook failures never affect a tool call. */
+export type ToolLifecycleHook = (event: ToolLifecycleEvent) => void;
+/** Options fixed when a handler is wrapped. */
+export interface WrapToolOptions {
+    /** An optional safe identifier included in lifecycle events. */
+    readonly name?: string;
+    /** Default per-call deadline. A caller may override it through invocation options. */
+    readonly timeoutMs?: number;
+    /** Receives bounded lifecycle metadata, never raw inputs or context. */
+    readonly onEvent?: ToolLifecycleHook;
+}
+/** Raised when Agentware reaches an invocation deadline. */
+export declare class ToolTimeoutError extends Error {
+    readonly timeoutMs: number;
+    constructor(timeoutMs: number);
+}
+/** Raised when the host cancels an invocation. */
+export declare class ToolAbortedError extends Error {
+    constructor();
+}
+/**
+ * Wrap an existing tool without coupling it to a model framework, transport, or
+ * policy engine. The wrapper propagates host cancellation and an optional
+ * deadline through the handler's AbortSignal.
+ */
+export declare function wrapTool<Input, Output, Context>(handler: AsyncToolHandler<Input, Output, Context>, options?: WrapToolOptions): WrappedTool<Input, Output, Context>;
+//# sourceMappingURL=async.d.ts.map

package/dist/tools/async.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async.d.ts","sourceRoot":"","sources":["../../src/tools/async.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,MAAM,MAAM,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,IAAI,CACrD,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,WAAW,KAChB,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AAE9B,qFAAqF;AACrF,MAAM,MAAM,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,IAAI,CAChD,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,qBAAqB,KAC5B,OAAO,CAAC,MAAM,CAAC,CAAC;AAErB,mDAAmD;AACnD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,kFAAkF;AAClF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;IAC5E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,8FAA8F;AAC9F,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;AAEpE,+CAA+C;AAC/C,MAAM,WAAW,eAAe;IAC9B,gEAAgE;IAChE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,sFAAsF;IACtF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,wEAAwE;IACxE,QAAQ,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAC;CACtC;AAED,4DAA4D;AAC5D,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,SAAS,EAAE,MAAM;CAK9B;AAED,kDAAkD;AAClD,qBAAa,gBAAiB,SAAQ,KAAK;;CAK1C;AAuBD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAC7C,OAAO,EAAE,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EACjD,OAAO,GAAE,eAAoB,GAC5B,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAsDrC"}

package/dist/tools/async.js

@@ -0,0 +1,89 @@
+/** Raised when Agentware reaches an invocation deadline. */
+export class ToolTimeoutError extends Error {
+    timeoutMs;
+    constructor(timeoutMs) {
+        super(`Tool execution timed out after ${timeoutMs}ms`);
+        this.name = "ToolTimeoutError";
+        this.timeoutMs = timeoutMs;
+    }
+}
+/** Raised when the host cancels an invocation. */
+export class ToolAbortedError extends Error {
+    constructor() {
+        super("Tool execution was aborted");
+        this.name = "ToolAbortedError";
+    }
+}
+function validateTimeout(timeoutMs) {
+    if (timeoutMs === undefined)
+        return;
+    if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
+        throw new RangeError("timeoutMs must be a finite positive number");
+    }
+}
+function emit(hook, type, toolName, startedAt) {
+    if (hook === undefined)
+        return;
+    try {
+        hook({ type, ...(toolName === undefined ? {} : { toolName }), durationMs: Date.now() - startedAt });
+    }
+    catch {
+        // Observability must not change the tool's execution result.
+    }
+}
+/**
+ * Wrap an existing tool without coupling it to a model framework, transport, or
+ * policy engine. The wrapper propagates host cancellation and an optional
+ * deadline through the handler's AbortSignal.
+ */
+export function wrapTool(handler, options = {}) {
+    validateTimeout(options.timeoutMs);
+    return async (input, context, invocation = {}) => {
+        validateTimeout(invocation.timeoutMs);
+        const timeoutMs = invocation.timeoutMs ?? options.timeoutMs;
+        const startedAt = Date.now();
+        const controller = new AbortController();
+        const externalSignal = invocation.signal;
+        if (externalSignal?.aborted === true) {
+            emit(options.onEvent, "aborted", options.name, startedAt);
+            throw new ToolAbortedError();
+        }
+        let timer;
+        let rejectInterrupted;
+        const interrupted = new Promise((_, reject) => {
+            rejectInterrupted = reject;
+        });
+        const abort = () => {
+            controller.abort();
+            rejectInterrupted?.(new ToolAbortedError());
+        };
+        externalSignal?.addEventListener("abort", abort, { once: true });
+        if (timeoutMs !== undefined) {
+            timer = setTimeout(() => {
+                controller.abort();
+                rejectInterrupted?.(new ToolTimeoutError(timeoutMs));
+            }, timeoutMs);
+        }
+        emit(options.onEvent, "started", options.name, startedAt);
+        const execution = Promise.resolve().then(() => handler(input, context, controller.signal));
+        try {
+            const result = await Promise.race([execution, interrupted]);
+            emit(options.onEvent, "succeeded", options.name, startedAt);
+            return result;
+        }
+        catch (error) {
+            const type = error instanceof ToolTimeoutError
+                ? "timed_out"
+                : error instanceof ToolAbortedError
+                    ? "aborted"
+                    : "failed";
+            emit(options.onEvent, type, options.name, startedAt);
+            throw error;
+        }
+        finally {
+            if (timer !== undefined)
+                clearTimeout(timer);
+            externalSignal?.removeEventListener("abort", abort);
+        }
+    };
+}

package/dist/tools/index.d.ts

@@ -0,0 +1,5 @@
+export { Tool, BaseTool, Result, ToolExample } from "./tool.js";
+export { ToolRegistry } from "./registry.js";
+export { wrapTool, ToolAbortedError, ToolTimeoutError, } from "./async.js";
+export type { AsyncToolHandler, ToolInvocationOptions, ToolLifecycleEvent, ToolLifecycleHook, WrapToolOptions, WrappedTool, } from "./async.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,WAAW,GACZ,MAAM,YAAY,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,3 @@
+export { BaseTool, Result } from "./tool.js";
+export { ToolRegistry } from "./registry.js";
+export { wrapTool, ToolAbortedError, ToolTimeoutError, } from "./async.js";

package/dist/tools/registry.d.ts

@@ -0,0 +1,11 @@
+import type { Tool } from "./tool.js";
+export declare class ToolRegistry {
+    private tools;
+    register(tool: Tool): void;
+    get(name: string): Tool | undefined;
+    all(): Tool[];
+    names(): string[];
+    schemas(): Record<string, Record<string, unknown>>;
+    clear(): void;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/tools/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAgC;IAE7C,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAI1B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAInC,GAAG,IAAI,IAAI,EAAE;IAMb,KAAK,IAAI,MAAM,EAAE;IAIjB,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAUlD,KAAK,IAAI,IAAI;CAGd"}

package/dist/tools/registry.js

@@ -0,0 +1,27 @@
+export class ToolRegistry {
+    tools = new Map();
+    register(tool) {
+        this.tools.set(tool.name, tool);
+    }
+    get(name) {
+        return this.tools.get(name);
+    }
+    all() {
+        return Array.from(this.tools.values()).sort((a, b) => a.name.localeCompare(b.name));
+    }
+    names() {
+        return Array.from(this.tools.keys()).sort();
+    }
+    schemas() {
+        const schemas = {};
+        for (const [name, tool] of this.tools) {
+            if ("inputSchema" in tool) {
+                schemas[name] = tool.inputSchema();
+            }
+        }
+        return schemas;
+    }
+    clear() {
+        this.tools.clear();
+    }
+}

package/dist/tools/tool.d.ts

@@ -0,0 +1,29 @@
+export interface Tool {
+    readonly name: string;
+    readonly description: string;
+    execute(args: Record<string, unknown>): Result;
+}
+export interface ToolExample {
+    input: Record<string, unknown>;
+    output: string;
+    explanation?: string;
+}
+export interface ExtendedTool extends Tool {
+    inputSchema(): Record<string, unknown>;
+    examples(): ToolExample[];
+}
+export declare class BaseTool implements Tool {
+    readonly name: string;
+    readonly description: string;
+    constructor(name: string, description: string);
+    execute(_args: Record<string, unknown>): Result;
+}
+export declare class Result {
+    success: boolean;
+    data: unknown;
+    error: string | null;
+    timestamp: Date;
+    constructor(success: boolean, data?: unknown, error?: string);
+    toJSON(): object;
+}
+//# sourceMappingURL=tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/tools/tool.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC;CAChD;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAa,SAAQ,IAAI;IACxC,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,QAAQ,IAAI,WAAW,EAAE,CAAC;CAC3B;AAED,qBAAa,QAAS,YAAW,IAAI;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;gBAEjB,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAK7C,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;CAGhD;AAED,qBAAa,MAAM;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAQ;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC5B,SAAS,EAAE,IAAI,CAAC;gBAEJ,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM;IAO5D,MAAM,IAAI,MAAM;CAQjB"}

package/dist/tools/tool.js

@@ -0,0 +1,31 @@
+export class BaseTool {
+    name;
+    description;
+    constructor(name, description) {
+        this.name = name;
+        this.description = description;
+    }
+    execute(_args) {
+        throw new Error("Subclass must implement execute");
+    }
+}
+export class Result {
+    success;
+    data = null;
+    error = null;
+    timestamp;
+    constructor(success, data, error) {
+        this.success = success;
+        this.data = data ?? null;
+        this.error = error ?? null;
+        this.timestamp = new Date();
+    }
+    toJSON() {
+        return {
+            success: this.success,
+            data: this.data,
+            error: this.error,
+            timestamp: this.timestamp.toISOString(),
+        };
+    }
+}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@haikeilabs/agentware",
+  "version": "0.1.0",
+  "description": "Agent middleware and tooling for LLM tool calling",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "prepack": "npm run build",
+    "build": "tsc",
+    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
+    "lint": "eslint src --ext .ts",
+    "format": "prettier --write \"src/**/*.ts\""
+  },
+  "keywords": [
+    "llm",
+    "agent",
+    "tool",
+    "middleware"
+  ],
+  "license": "Apache-2.0",
+  "authors": [
+    {
+      "name": "Pedro Team",
+      "email": "team@pedro.ai"
+    }
+  ],
+  "devDependencies": {
+    "@types/jest": "^29.5.0",
+    "@typescript-eslint/eslint-plugin": "^8.59.0",
+    "@typescript-eslint/parser": "^8.59.0",
+    "eslint": "^8.45.0",
+    "jest": "^29.7.0",
+    "prettier": "^3.0.0",
+    "ts-jest": "^29.1.0",
+    "typescript": "^5.3.0"
+  },
+  "dependencies": {
+    "minimatch": "10.2.3",
+    "zod": "^3.22.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}