@almadar/agent 2.0.0 → 2.0.2

package/dist/tools/combine-schemas.d.ts

@@ -0,0 +1,154 @@
+/**
+ * Construct Combined Schema Tool
+ *
+ * Deterministically combines generated orbitals into a single OrbitalSchema
+ * without LLM involvement.
+ *
+ * @packageDocumentation
+ */
+import { z } from 'zod';
+/**
+ * Create the construct_combined_schema tool.
+ */
+export declare function createCombineSchemasTool(workDir?: string): import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+    orbitals: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        entity: z.ZodObject<{
+            name: z.ZodString;
+            collection: z.ZodOptional<z.ZodString>;
+            fields: z.ZodArray<z.ZodAny, "many">;
+            timestamps: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            fields: any[];
+            collection?: string | undefined;
+            timestamps?: boolean | undefined;
+        }, {
+            name: string;
+            fields: any[];
+            collection?: string | undefined;
+            timestamps?: boolean | undefined;
+        }>;
+        traits: z.ZodArray<z.ZodAny, "many">;
+        pages: z.ZodArray<z.ZodAny, "many">;
+        emits: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        listens: z.ZodOptional<z.ZodArray<z.ZodAny, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        pages: any[];
+        traits: any[];
+        name: string;
+        entity: {
+            name: string;
+            fields: any[];
+            collection?: string | undefined;
+            timestamps?: boolean | undefined;
+        };
+        description?: string | undefined;
+        emits?: string[] | undefined;
+        listens?: any[] | undefined;
+    }, {
+        pages: any[];
+        traits: any[];
+        name: string;
+        entity: {
+            name: string;
+            fields: any[];
+            collection?: string | undefined;
+            timestamps?: boolean | undefined;
+        };
+        description?: string | undefined;
+        emits?: string[] | undefined;
+        listens?: any[] | undefined;
+    }>, "many">>;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+    theme: z.ZodOptional<z.ZodString>;
+    defaultRoute: z.ZodOptional<z.ZodString>;
+    validate: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    validate: boolean;
+    version?: string | undefined;
+    name?: string | undefined;
+    description?: string | undefined;
+    theme?: string | undefined;
+    orbitals?: {
+        pages: any[];
+        traits: any[];
+        name: string;
+        entity: {
+            name: string;
+            fields: any[];
+            collection?: string | undefined;
+            timestamps?: boolean | undefined;
+        };
+        description?: string | undefined;
+        emits?: string[] | undefined;
+        listens?: any[] | undefined;
+    }[] | undefined;
+    defaultRoute?: string | undefined;
+}, {
+    version?: string | undefined;
+    name?: string | undefined;
+    description?: string | undefined;
+    validate?: boolean | undefined;
+    theme?: string | undefined;
+    orbitals?: {
+        pages: any[];
+        traits: any[];
+        name: string;
+        entity: {
+            name: string;
+            fields: any[];
+            collection?: string | undefined;
+            timestamps?: boolean | undefined;
+        };
+        description?: string | undefined;
+        emits?: string[] | undefined;
+        listens?: any[] | undefined;
+    }[] | undefined;
+    defaultRoute?: string | undefined;
+}>, {
+    validate: boolean;
+    version?: string | undefined;
+    name?: string | undefined;
+    description?: string | undefined;
+    theme?: string | undefined;
+    orbitals?: {
+        pages: any[];
+        traits: any[];
+        name: string;
+        entity: {
+            name: string;
+            fields: any[];
+            collection?: string | undefined;
+            timestamps?: boolean | undefined;
+        };
+        description?: string | undefined;
+        emits?: string[] | undefined;
+        listens?: any[] | undefined;
+    }[] | undefined;
+    defaultRoute?: string | undefined;
+}, {
+    version?: string | undefined;
+    name?: string | undefined;
+    description?: string | undefined;
+    validate?: boolean | undefined;
+    theme?: string | undefined;
+    orbitals?: {
+        pages: any[];
+        traits: any[];
+        name: string;
+        entity: {
+            name: string;
+            fields: any[];
+            collection?: string | undefined;
+            timestamps?: boolean | undefined;
+        };
+        description?: string | undefined;
+        emits?: string[] | undefined;
+        listens?: any[] | undefined;
+    }[] | undefined;
+    defaultRoute?: string | undefined;
+}, string, "construct_combined_schema">;

package/dist/tools/composition.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Tool Composition & Chaining - Phase 3.3
+ *
+ * Composable tool workflows with parallel execution, error handling,
+ * and conditional branching.
+ *
+ * @packageDocumentation
+ */
+export type ToolStepStatus = 'pending' | 'running' | 'success' | 'error' | 'skipped';
+export interface ToolStep {
+    id: string;
+    name: string;
+    tool: string;
+    input: Record<string, unknown> | ((context: WorkflowContext) => Record<string, unknown>);
+    condition?: (context: WorkflowContext) => boolean;
+    dependsOn?: string[];
+    status: ToolStepStatus;
+    output?: unknown;
+    error?: string;
+    startTime?: number;
+    endTime?: number;
+}
+export interface WorkflowContext {
+    workflowId: string;
+    inputs: Record<string, unknown>;
+    outputs: Record<string, unknown>;
+    stepResults: Map<string, {
+        success: boolean;
+        output?: unknown;
+        error?: string;
+    }>;
+    metadata: {
+        startTime: number;
+        stepsCompleted: number;
+        stepsFailed: number;
+    };
+}
+export interface WorkflowDefinition {
+    name: string;
+    description: string;
+    inputs: Record<string, {
+        type: string;
+        required: boolean;
+        default?: unknown;
+    }>;
+    steps: ToolStep[];
+    onError?: 'stop' | 'continue' | 'retry';
+    maxRetries?: number;
+}
+export interface WorkflowExecutionResult {
+    success: boolean;
+    workflowId: string;
+    context: WorkflowContext;
+    steps: ToolStep[];
+    durationMs: number;
+    error?: string;
+}
+export interface ParallelExecutionResult {
+    stepId: string;
+    success: boolean;
+    output?: unknown;
+    error?: string;
+    durationMs: number;
+}
+export interface ToolExecutor {
+    execute(tool: string, input: Record<string, unknown>): Promise<unknown>;
+}
+export declare class WorkflowEngine {
+    private executor;
+    private workflows;
+    constructor(executor: ToolExecutor);
+    /**
+     * Register a workflow definition
+     */
+    registerWorkflow(definition: WorkflowDefinition): void;
+    /**
+     * Execute a workflow by name
+     */
+    executeWorkflow(workflowName: string, inputs: Record<string, unknown>): Promise<WorkflowExecutionResult>;
+    /**
+     * Execute a workflow definition directly
+     */
+    runWorkflow(definition: WorkflowDefinition, inputs: Record<string, unknown>): Promise<WorkflowExecutionResult>;
+    /**
+     * Execute independent steps in parallel
+     */
+    executeParallel(steps: Array<{
+        id: string;
+        tool: string;
+        input: Record<string, unknown>;
+    }>, context: WorkflowContext): Promise<ParallelExecutionResult[]>;
+    /**
+     * Create a workflow builder for fluent API
+     */
+    createWorkflow(name: string, description: string): WorkflowBuilder;
+    private executeStep;
+    private resolveDependencies;
+}
+export declare class WorkflowBuilder {
+    private engine;
+    private definition;
+    constructor(engine: WorkflowEngine, name: string, description: string);
+    input(name: string, type: string, required?: boolean, defaultValue?: unknown): this;
+    step(id: string, tool: string, input: Record<string, unknown> | ((context: WorkflowContext) => Record<string, unknown>), options?: {
+        dependsOn?: string[];
+        condition?: (context: WorkflowContext) => boolean;
+    }): this;
+    parallel(steps: Array<{
+        id: string;
+        tool: string;
+        input: Record<string, unknown>;
+    }>): this;
+    onError(policy: 'stop' | 'continue' | 'retry'): this;
+    retry(maxRetries: number): this;
+    build(): WorkflowDefinition;
+    execute(inputs: Record<string, unknown>): Promise<WorkflowExecutionResult>;
+}
+export declare function createSchemaGenerationWorkflow(engine: WorkflowEngine): WorkflowDefinition;
+export declare function createWorkflowEngine(executor: ToolExecutor): WorkflowEngine;