@flomatai/core 0.1.0

package/dist/state/file-store.js

@@ -0,0 +1,92 @@
+/**
+ * File-based StateStore — persists data as JSON files.
+ * Good for development and small-scale use. No external dependencies.
+ */
+import { existsSync } from 'fs';
+import { readFile, writeFile, mkdir } from 'fs/promises';
+import { join, dirname } from 'path';
+export class FileStore {
+    dataFile;
+    data = { cache: {}, runs: {}, checkpoints: {} };
+    constructor(dataDir = '.flomatai') {
+        this.dataFile = join(dataDir, 'store.json');
+    }
+    async init() {
+        await mkdir(dirname(this.dataFile), { recursive: true });
+        if (existsSync(this.dataFile)) {
+            try {
+                const raw = await readFile(this.dataFile, 'utf-8');
+                this.data = JSON.parse(raw);
+            }
+            catch {
+                this.data = { cache: {}, runs: {}, checkpoints: {} };
+            }
+        }
+    }
+    async close() {
+        await this.flush();
+    }
+    async flush() {
+        await mkdir(dirname(this.dataFile), { recursive: true });
+        await writeFile(this.dataFile, JSON.stringify(this.data, null, 2), 'utf-8');
+    }
+    async get(key) {
+        const entry = this.data.cache[key];
+        if (!entry)
+            return null;
+        if (entry.expiresAt !== null && Date.now() > entry.expiresAt) {
+            delete this.data.cache[key];
+            return null;
+        }
+        return entry.value;
+    }
+    async set(key, value, ttlSeconds) {
+        this.data.cache[key] = {
+            value,
+            expiresAt: ttlSeconds ? Date.now() + ttlSeconds * 1000 : null,
+        };
+        await this.flush();
+    }
+    async delete(key) {
+        delete this.data.cache[key];
+        await this.flush();
+    }
+    async has(key) {
+        const v = await this.get(key);
+        return v !== null;
+    }
+    async saveRun(run) {
+        this.data.runs[run.id] = { ...run };
+        await this.flush();
+    }
+    async getRun(runId) {
+        return this.data.runs[runId] ?? null;
+    }
+    async listRuns(filter) {
+        let runs = Object.values(this.data.runs).sort((a, b) => new Date(b.startedAt).getTime() - new Date(a.startedAt).getTime());
+        if (filter?.pipelineName) {
+            runs = runs.filter((r) => r.pipelineName === filter.pipelineName);
+        }
+        if (filter?.status) {
+            runs = runs.filter((r) => r.status === filter.status);
+        }
+        const offset = filter?.offset ?? 0;
+        const limit = filter?.limit ?? 50;
+        return runs.slice(offset, offset + limit);
+    }
+    async saveCheckpoint(runId, stepName, data) {
+        this.data.checkpoints[`${runId}::${stepName}`] = data;
+        await this.flush();
+    }
+    async getCheckpoint(runId, stepName) {
+        return this.data.checkpoints[`${runId}::${stepName}`] ?? null;
+    }
+    async clearCheckpoints(runId) {
+        for (const key of Object.keys(this.data.checkpoints)) {
+            if (key.startsWith(`${runId}::`))
+                delete this.data.checkpoints[key];
+        }
+        await this.flush();
+    }
+}
+//# sourceMappingURL=file-store.js.map

package/dist/state/file-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-store.js","sourceRoot":"","sources":["../../src/state/file-store.ts"],"names":[],"mappings":"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"}

package/dist/state/memory-store.d.ts

@@ -0,0 +1,24 @@
+/**
+ * In-memory StateStore — useful for testing and single-run pipelines.
+ * No persistence; data is lost on process exit.
+ */
+import type { StateStore, RunFilter } from './types.js';
+import type { PipelineRun } from '../types.js';
+export declare class MemoryStore implements StateStore {
+    private cache;
+    private runs;
+    private checkpoints;
+    init(): Promise<void>;
+    close(): Promise<void>;
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T, ttlSeconds?: number): Promise<void>;
+    delete(key: string): Promise<void>;
+    has(key: string): Promise<boolean>;
+    saveRun(run: PipelineRun): Promise<void>;
+    getRun(runId: string): Promise<PipelineRun | null>;
+    listRuns(filter?: RunFilter): Promise<PipelineRun[]>;
+    saveCheckpoint(runId: string, stepName: string, data: unknown): Promise<void>;
+    getCheckpoint(runId: string, stepName: string): Promise<unknown | null>;
+    clearCheckpoints(runId: string): Promise<void>;
+}
+//# sourceMappingURL=memory-store.d.ts.map

package/dist/state/memory-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.d.ts","sourceRoot":"","sources":["../../src/state/memory-store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAO/C,qBAAa,WAAY,YAAW,UAAU;IAC5C,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,IAAI,CAAkC;IAC9C,OAAO,CAAC,WAAW,CAA8B;IAE3C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IACrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAEtB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAUtC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOjE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKlC,OAAO,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAIlD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAapD,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7E,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAIvE,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAKrD"}

package/dist/state/memory-store.js

@@ -0,0 +1,65 @@
+/**
+ * In-memory StateStore — useful for testing and single-run pipelines.
+ * No persistence; data is lost on process exit.
+ */
+export class MemoryStore {
+    cache = new Map();
+    runs = new Map();
+    checkpoints = new Map(); // key: `${runId}::${stepName}`
+    async init() { }
+    async close() { }
+    async get(key) {
+        const entry = this.cache.get(key);
+        if (!entry)
+            return null;
+        if (entry.expiresAt !== null && Date.now() > entry.expiresAt) {
+            this.cache.delete(key);
+            return null;
+        }
+        return entry.value;
+    }
+    async set(key, value, ttlSeconds) {
+        this.cache.set(key, {
+            value,
+            expiresAt: ttlSeconds ? Date.now() + ttlSeconds * 1000 : null,
+        });
+    }
+    async delete(key) {
+        this.cache.delete(key);
+    }
+    async has(key) {
+        const v = await this.get(key);
+        return v !== null;
+    }
+    async saveRun(run) {
+        this.runs.set(run.id, { ...run });
+    }
+    async getRun(runId) {
+        return this.runs.get(runId) ?? null;
+    }
+    async listRuns(filter) {
+        let runs = [...this.runs.values()].reverse(); // newest first
+        if (filter?.pipelineName) {
+            runs = runs.filter((r) => r.pipelineName === filter.pipelineName);
+        }
+        if (filter?.status) {
+            runs = runs.filter((r) => r.status === filter.status);
+        }
+        const offset = filter?.offset ?? 0;
+        const limit = filter?.limit ?? 50;
+        return runs.slice(offset, offset + limit);
+    }
+    async saveCheckpoint(runId, stepName, data) {
+        this.checkpoints.set(`${runId}::${stepName}`, data);
+    }
+    async getCheckpoint(runId, stepName) {
+        return this.checkpoints.get(`${runId}::${stepName}`) ?? null;
+    }
+    async clearCheckpoints(runId) {
+        for (const key of this.checkpoints.keys()) {
+            if (key.startsWith(`${runId}::`))
+                this.checkpoints.delete(key);
+        }
+    }
+}
+//# sourceMappingURL=memory-store.js.map

package/dist/state/memory-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.js","sourceRoot":"","sources":["../../src/state/memory-store.ts"],"names":[],"mappings":"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"}

package/dist/state/types.d.ts

@@ -0,0 +1,40 @@
+/**
+ * StateStore — pluggable persistence interface.
+ *
+ * Adapters: @flomatai/state-file (default), @flomatai/state-sqlite,
+ *           @flomatai/state-redis, @flomatai/state-postgres
+ */
+import type { PipelineRun } from '../types.js';
+export interface StateStore {
+    /** Initialize the store (open connections, create tables, etc.). */
+    init(): Promise<void>;
+    /** Tear down the store (close connections). */
+    close(): Promise<void>;
+    /** Get a value by key. Returns null if not found or expired. */
+    get<T>(key: string): Promise<T | null>;
+    /** Set a value with optional TTL (seconds). */
+    set<T>(key: string, value: T, ttlSeconds?: number): Promise<void>;
+    /** Delete a key. */
+    delete(key: string): Promise<void>;
+    /** Check if a key exists. */
+    has(key: string): Promise<boolean>;
+    /** Persist a pipeline run (upsert by run.id). */
+    saveRun(run: PipelineRun): Promise<void>;
+    /** Retrieve a run by ID. */
+    getRun(runId: string): Promise<PipelineRun | null>;
+    /** List runs, newest first. */
+    listRuns(filter?: RunFilter): Promise<PipelineRun[]>;
+    /** Save a step checkpoint so a failed run can be resumed. */
+    saveCheckpoint(runId: string, stepName: string, data: unknown): Promise<void>;
+    /** Get a step checkpoint. */
+    getCheckpoint(runId: string, stepName: string): Promise<unknown | null>;
+    /** Clear all checkpoints for a run (after successful completion). */
+    clearCheckpoints(runId: string): Promise<void>;
+}
+export interface RunFilter {
+    pipelineName?: string;
+    status?: string;
+    limit?: number;
+    offset?: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/state/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI/C,MAAM,WAAW,UAAU;IACzB,oEAAoE;IACpE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,+CAA+C;IAC/C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAIvB,gEAAgE;IAChE,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACvC,+CAA+C;IAC/C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,oBAAoB;IACpB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,6BAA6B;IAC7B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAInC,iDAAiD;IACjD,OAAO,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,4BAA4B;IAC5B,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACnD,+BAA+B;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAIrD,6DAA6D;IAC7D,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9E,6BAA6B;IAC7B,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACxE,qEAAqE;IACrE,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,SAAS;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/state/types.js

@@ -0,0 +1,8 @@
+/**
+ * StateStore — pluggable persistence interface.
+ *
+ * Adapters: @flomatai/state-file (default), @flomatai/state-sqlite,
+ *           @flomatai/state-redis, @flomatai/state-postgres
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/state/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/state/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/strategies/custom.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Custom strategy — user provides their own strategy function.
+ * Maximum flexibility.
+ */
+import type { Skill } from '../skill.js';
+import type { Strategy, AgentContext, AgentResult, CustomStrategyFn } from './types.js';
+export declare class CustomStrategy implements Strategy {
+    private fn;
+    constructor(fn: CustomStrategyFn);
+    execute(skills: Skill[], input: unknown, ctx: AgentContext): Promise<AgentResult>;
+}
+//# sourceMappingURL=custom.d.ts.map

package/dist/strategies/custom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom.d.ts","sourceRoot":"","sources":["../../src/strategies/custom.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EACV,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB,qBAAa,cAAe,YAAW,QAAQ;IACjC,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,gBAAgB;IAElC,OAAO,CACX,MAAM,EAAE,KAAK,EAAE,EACf,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,WAAW,CAAC;CAGxB"}

package/dist/strategies/custom.js

@@ -0,0 +1,14 @@
+/**
+ * Custom strategy — user provides their own strategy function.
+ * Maximum flexibility.
+ */
+export class CustomStrategy {
+    fn;
+    constructor(fn) {
+        this.fn = fn;
+    }
+    async execute(skills, input, ctx) {
+        return this.fn(skills, input, ctx);
+    }
+}
+//# sourceMappingURL=custom.js.map

package/dist/strategies/custom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom.js","sourceRoot":"","sources":["../../src/strategies/custom.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,MAAM,OAAO,cAAc;IACL;IAApB,YAAoB,EAAoB;QAApB,OAAE,GAAF,EAAE,CAAkB;IAAG,CAAC;IAE5C,KAAK,CAAC,OAAO,CACX,MAAe,EACf,KAAc,EACd,GAAiB;QAEjB,OAAO,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;IACrC,CAAC;CACF"}

package/dist/strategies/plan-and-execute.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Plan-and-Execute strategy — LLM creates a plan upfront, then executes it.
+ *
+ * 1. LLM receives goal + skill catalog → produces ordered execution plan
+ * 2. Each planned step is executed
+ * 3. Optional: re-plan after each step based on actual outputs
+ */
+import type { Skill } from '../skill.js';
+import type { Strategy, AgentContext, AgentResult } from './types.js';
+export interface PlanAndExecuteOptions {
+    /** Re-plan after each step based on actual output (default: false). */
+    replanAfterEachStep?: boolean;
+    /** Max number of re-plans allowed (default: 3). */
+    maxReplans?: number;
+    /** Custom planning prompt override. Receives skill catalog + goal. */
+    planPromptTemplate?: string;
+}
+export declare class PlanAndExecuteStrategy implements Strategy {
+    private options;
+    constructor(options?: PlanAndExecuteOptions);
+    execute(skills: Skill[], input: unknown, ctx: AgentContext): Promise<AgentResult>;
+    private createPlan;
+    private replan;
+    private topologicalSort;
+    private resolveStepInput;
+}
+//# sourceMappingURL=plan-and-execute.d.ts.map

package/dist/strategies/plan-and-execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-and-execute.d.ts","sourceRoot":"","sources":["../../src/strategies/plan-and-execute.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAmB,MAAM,YAAY,CAAC;AAevF,MAAM,WAAW,qBAAqB;IACpC,uEAAuE;IACvE,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,qBAAa,sBAAuB,YAAW,QAAQ;IACzC,OAAO,CAAC,OAAO;gBAAP,OAAO,GAAE,qBAA0B;IAEjD,OAAO,CACX,MAAM,EAAE,KAAK,EAAE,EACf,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,WAAW,CAAC;YAmFT,UAAU;YAiEV,MAAM;IA0CpB,OAAO,CAAC,eAAe;IAoBvB,OAAO,CAAC,gBAAgB;CAiBzB"}

package/dist/strategies/plan-and-execute.js

@@ -0,0 +1,195 @@
+/**
+ * Plan-and-Execute strategy — LLM creates a plan upfront, then executes it.
+ *
+ * 1. LLM receives goal + skill catalog → produces ordered execution plan
+ * 2. Each planned step is executed
+ * 3. Optional: re-plan after each step based on actual outputs
+ */
+export class PlanAndExecuteStrategy {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async execute(skills, input, ctx) {
+        const trace = [];
+        const startMs = Date.now();
+        const results = new Map();
+        let replanCount = 0;
+        const maxReplans = this.options.maxReplans ?? 3;
+        // ── Phase 1: Plan ──────────────────────────────────────────────────────
+        let plan = await this.createPlan(skills, input, results, ctx);
+        trace.push({
+            type: 'plan',
+            content: plan,
+            timestamp: new Date().toISOString(),
+        });
+        ctx.logger.debug(`[plan-and-execute] Plan created: ${plan.steps.length} steps`);
+        // ── Phase 2: Execute ───────────────────────────────────────────────────
+        const sortedSteps = this.topologicalSort(plan.steps);
+        for (const planStep of sortedSteps) {
+            if (ctx.abortSignal.aborted)
+                throw new Error(`Agent "${ctx.agentName}" aborted`);
+            const skill = skills.find((s) => s.meta.name === planStep.skill);
+            if (!skill) {
+                ctx.logger.warn(`[plan-and-execute] Skill "${planStep.skill}" not found — skipping`);
+                continue;
+            }
+            // Derive input from previous results
+            const stepInput = this.resolveStepInput(planStep, input, results);
+            ctx.logger.debug(`[plan-and-execute] Executing step "${planStep.step_name}" with skill "${planStep.skill}"`);
+            const t0 = Date.now();
+            const output = await skill.execute(stepInput, ctx.toSkillContext());
+            const durationMs = Date.now() - t0;
+            results.set(planStep.step_name, output);
+            trace.push({
+                type: 'action',
+                skill: planStep.skill,
+                input: stepInput,
+                output,
+                timestamp: new Date().toISOString(),
+                content: { step: planStep.step_name, durationMs },
+            });
+            // Optional re-plan
+            if (this.options.replanAfterEachStep && replanCount < maxReplans) {
+                const newPlan = await this.replan(skills, input, results, plan, ctx);
+                if (JSON.stringify(newPlan.steps) !== JSON.stringify(plan.steps)) {
+                    plan = newPlan;
+                    replanCount++;
+                    trace.push({
+                        type: 'replan',
+                        content: { plan, replanCount },
+                        timestamp: new Date().toISOString(),
+                    });
+                    ctx.logger.debug(`[plan-and-execute] Replanned (${replanCount}/${maxReplans})`);
+                }
+            }
+        }
+        const finalOutput = results.size === 1
+            ? results.values().next().value
+            : Object.fromEntries(results);
+        trace.push({ type: 'finish', output: finalOutput, timestamp: new Date().toISOString() });
+        return {
+            output: finalOutput,
+            trace,
+            tokensUsed: ctx.totalTokens,
+            durationMs: Date.now() - startMs,
+        };
+    }
+    async createPlan(skills, input, existingResults, ctx) {
+        const skillCatalog = skills.map((s) => ({
+            name: s.meta.name,
+            description: s.meta.description,
+            tags: s.meta.tags ?? [],
+        }));
+        const completedStr = existingResults.size > 0
+            ? `\nALREADY COMPLETED: ${[...existingResults.keys()].join(', ')}`
+            : '';
+        const prompt = this.options.planPromptTemplate ??
+            `You are a planning agent. Create an execution plan to achieve the goal.
+
+ROLE: ${ctx.agentRole}
+
+AVAILABLE SKILLS:
+${JSON.stringify(skillCatalog, null, 2)}
+
+GOAL INPUT:
+${JSON.stringify(input, null, 2).substring(0, 3000)}
+${completedStr}
+
+Rules:
+- Only include skills that are necessary
+- You may use the same skill multiple times with different step_names
+- depends_on must reference step_names defined earlier in the plan
+- Keep input_description concise — it will be used to build the actual input
+
+Respond with ONLY valid JSON:
+{
+  "reasoning": "why this plan",
+  "steps": [
+    {
+      "step_name": "unique-step-id",
+      "skill": "skill-name",
+      "input_description": "what input to pass and where to get it from",
+      "expected_output": "what this produces",
+      "depends_on": ["step-name"]
+    }
+  ]
+}`;
+        const response = await ctx.llm.chat([{ role: 'user', content: prompt }], { temperature: 0.1, responseFormat: 'json' });
+        ctx.addTokens(response.usage.totalTokens);
+        try {
+            return JSON.parse(response.content);
+        }
+        catch {
+            const match = response.content.match(/\{[\s\S]*\}/);
+            if (!match)
+                throw new Error(`Plan-and-execute failed to produce valid JSON plan`);
+            return JSON.parse(match[0]);
+        }
+    }
+    async replan(skills, input, results, currentPlan, ctx) {
+        const completedStr = [...results.entries()]
+            .map(([k, v]) => `${k}: ${JSON.stringify(v).substring(0, 200)}`)
+            .join('\n');
+        const prompt = `You are re-planning based on actual results.
+
+ROLE: ${ctx.agentRole}
+
+ORIGINAL GOAL: ${JSON.stringify(input).substring(0, 1000)}
+
+ORIGINAL PLAN:
+${JSON.stringify(currentPlan.steps.map((s) => s.step_name), null, 2)}
+
+COMPLETED STEPS AND OUTPUTS:
+${completedStr}
+
+AVAILABLE SKILLS:
+${skills.map((s) => `${s.meta.name}: ${s.meta.description}`).join('\n')}
+
+Do you need to adjust the remaining plan? Produce a complete updated plan (include completed steps too).
+Respond with ONLY valid JSON using the same format as the original plan.`;
+        const response = await ctx.llm.chat([{ role: 'user', content: prompt }], { temperature: 0.1, responseFormat: 'json' });
+        ctx.addTokens(response.usage.totalTokens);
+        try {
+            return JSON.parse(response.content);
+        }
+        catch {
+            return currentPlan; // keep original on parse failure
+        }
+    }
+    topologicalSort(steps) {
+        const nameToStep = new Map(steps.map((s) => [s.step_name, s]));
+        const sorted = [];
+        const visited = new Set();
+        const visit = (name) => {
+            if (visited.has(name))
+                return;
+            const step = nameToStep.get(name);
+            if (!step)
+                return;
+            for (const dep of step.depends_on) {
+                visit(dep);
+            }
+            visited.add(name);
+            sorted.push(step);
+        };
+        for (const step of steps)
+            visit(step.step_name);
+        return sorted;
+    }
+    resolveStepInput(step, originalInput, results) {
+        // If there are dependencies, merge their outputs
+        if (step.depends_on.length === 0)
+            return originalInput;
+        if (step.depends_on.length === 1) {
+            return results.get(step.depends_on[0]) ?? originalInput;
+        }
+        // Multiple dependencies: merge all into one object
+        const merged = { _original: originalInput };
+        for (const dep of step.depends_on) {
+            merged[dep] = results.get(dep);
+        }
+        return merged;
+    }
+}
+//# sourceMappingURL=plan-and-execute.js.map

package/dist/strategies/plan-and-execute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-and-execute.js","sourceRoot":"","sources":["../../src/strategies/plan-and-execute.ts"],"names":[],"mappings":"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"}

package/dist/strategies/react.d.ts

@@ -0,0 +1,27 @@
+/**
+ * ReAct strategy — iterative Reasoning + Acting loop.
+ *
+ * Each iteration:
+ *   1. THINK — LLM reasons about what to do next
+ *   2. ACT   — execute the chosen skill
+ *   3. OBSERVE — feed output back to LLM
+ *   4. Repeat until LLM decides to FINISH
+ */
+import type { Skill } from '../skill.js';
+import type { Strategy, AgentContext, AgentResult } from './types.js';
+export interface ReActOptions {
+    /** Maximum reasoning iterations before hard stop (default: 10). */
+    maxIterations?: number;
+    /** Reflect and self-correct every N steps (0 = disabled, default: 0). */
+    reflectionInterval?: number;
+    /** Custom system prompt additions. */
+    systemPromptSuffix?: string;
+}
+export declare class ReActStrategy implements Strategy {
+    private options;
+    constructor(options?: ReActOptions);
+    execute(skills: Skill[], input: unknown, ctx: AgentContext): Promise<AgentResult>;
+    private think;
+    private reflect;
+}
+//# sourceMappingURL=react.d.ts.map

package/dist/strategies/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../src/strategies/react.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EACV,QAAQ,EACR,YAAY,EACZ,WAAW,EAEZ,MAAM,YAAY,CAAC;AAUpB,MAAM,WAAW,YAAY;IAC3B,mEAAmE;IACnE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yEAAyE;IACzE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,sCAAsC;IACtC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,qBAAa,aAAc,YAAW,QAAQ;IAChC,OAAO,CAAC,OAAO;gBAAP,OAAO,GAAE,YAAiB;IAExC,OAAO,CACX,MAAM,EAAE,KAAK,EAAE,EACf,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,WAAW,CAAC;YAuGT,KAAK;YAyEL,OAAO;CAoBtB"}