pocket-agent 0.1.0

package/dist/defaults/llmPlanner.js.map

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

package/dist/defaults/planBuilder.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Fluent helpers to define steps and build plans with minimal syntax.
+ */
+import type { Plan, StepDefinition, StepType, RetryPolicy } from "../types/plan.js";
+export interface StepBuilderOptions {
+    type?: StepType;
+    retryPolicy?: RetryPolicy;
+}
+/**
+ * Fluent step builder. Chain methods then call .build() to get a StepDefinition.
+ *
+ * @example
+ * step("find_doc", "Find document")
+ *   .objective("Locate the latest contract.")
+ *   .outputs("path")
+ *   .inputsFromContext("customerId")
+ *   .build()
+ */
+export declare function step(id: string, name: string, options?: StepBuilderOptions): StepBuilder;
+declare class StepBuilder {
+    private options;
+    private def;
+    private inputRefs;
+    constructor(id: string, name: string, options?: StepBuilderOptions);
+    objective(text: string): this;
+    outputs(...keys: string[]): this;
+    dependsOn(...stepIds: string[]): this;
+    /** Add input from run context: { source: "runContext", key } */
+    inputsFromContext(...keys: string[]): this;
+    /** Add input from a previous step's output: { source: "stepOutput", stepId, key } */
+    inputsFromStep(stepId: string, key: string): this;
+    type(t: StepType): this;
+    /** Allow these tools for this step (for type "tool"). */
+    tools(...toolNames: string[]): this;
+    completionCriteria(...criteria: string[]): this;
+    retry(maxAttempts: number, strategy?: RetryPolicy["strategy"]): this;
+    build(): StepDefinition;
+}
+export interface BuildPlanOptions {
+    planId?: string;
+    version?: number;
+}
+/**
+ * Build a Plan from a goal and an array of steps (from step().build() or plain StepDefinition).
+ */
+export declare function buildPlan(goal: string, steps: StepDefinition[], options?: BuildPlanOptions): Plan;
+export {};
+//# sourceMappingURL=planBuilder.d.ts.map

package/dist/defaults/planBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planBuilder.d.ts","sourceRoot":"","sources":["../../src/defaults/planBuilder.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAgB,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAQlG,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED;;;;;;;;;GASG;AACH,wBAAgB,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,WAAW,CAE5F;AAED,cAAM,WAAW;IAOb,OAAO,CAAC,OAAO;IANjB,OAAO,CAAC,GAAG,CAAyD;IACpE,OAAO,CAAC,SAAS,CAAsB;gBAGrC,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACJ,OAAO,GAAE,kBAAuB;IAgB1C,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK7B,OAAO,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;IAQhC,SAAS,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI;IAKrC,gEAAgE;IAChE,iBAAiB,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;IAO1C,qFAAqF;IACrF,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAKjD,IAAI,CAAC,CAAC,EAAE,QAAQ,GAAG,IAAI;IAKvB,yDAAyD;IACzD,KAAK,CAAC,GAAG,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAKnC,kBAAkB,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAK/C,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,GAAE,WAAW,CAAC,UAAU,CAAyB,GAAG,IAAI;IAK3F,KAAK,IAAI,cAAc;CAQxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,GAAE,gBAAqB,GAC7B,IAAI,CAQN"}

package/dist/defaults/planBuilder.js

@@ -0,0 +1,105 @@
+/**
+ * Fluent helpers to define steps and build plans with minimal syntax.
+ */
+import { nowISO } from "../utils/time.js";
+const DEFAULT_RETRY = {
+    maxAttempts: 2,
+    strategy: "retry_with_feedback",
+};
+/**
+ * Fluent step builder. Chain methods then call .build() to get a StepDefinition.
+ *
+ * @example
+ * step("find_doc", "Find document")
+ *   .objective("Locate the latest contract.")
+ *   .outputs("path")
+ *   .inputsFromContext("customerId")
+ *   .build()
+ */
+export function step(id, name, options = {}) {
+    return new StepBuilder(id, name, options);
+}
+class StepBuilder {
+    constructor(id, name, options = {}) {
+        this.options = options;
+        this.inputRefs = [];
+        this.def = {
+            id,
+            name,
+            type: options.type ?? "transform",
+            objective: "",
+            dependencies: [],
+            allowedTools: [],
+            inputs: [],
+            outputs: [],
+            completionCriteria: [],
+            retryPolicy: options.retryPolicy ?? DEFAULT_RETRY,
+        };
+    }
+    objective(text) {
+        this.def.objective = text;
+        return this;
+    }
+    outputs(...keys) {
+        this.def.outputs = keys.length ? keys : ["output"];
+        if (!this.def.completionCriteria?.length) {
+            this.def.completionCriteria = this.def.outputs.map((k) => `Output "${k}" is produced.`);
+        }
+        return this;
+    }
+    dependsOn(...stepIds) {
+        this.def.dependencies = stepIds;
+        return this;
+    }
+    /** Add input from run context: { source: "runContext", key } */
+    inputsFromContext(...keys) {
+        for (const key of keys) {
+            this.inputRefs.push({ source: "runContext", key });
+        }
+        return this;
+    }
+    /** Add input from a previous step's output: { source: "stepOutput", stepId, key } */
+    inputsFromStep(stepId, key) {
+        this.inputRefs.push({ source: "stepOutput", stepId, key });
+        return this;
+    }
+    type(t) {
+        this.def.type = t;
+        return this;
+    }
+    /** Allow these tools for this step (for type "tool"). */
+    tools(...toolNames) {
+        this.def.allowedTools = toolNames;
+        return this;
+    }
+    completionCriteria(...criteria) {
+        this.def.completionCriteria = criteria;
+        return this;
+    }
+    retry(maxAttempts, strategy = "retry_with_feedback") {
+        this.def.retryPolicy = { maxAttempts, strategy };
+        return this;
+    }
+    build() {
+        this.def.inputs = this.inputRefs.length ? this.inputRefs : this.def.inputs ?? [];
+        if (!this.def.outputs?.length)
+            this.def.outputs = ["output"];
+        if (!this.def.completionCriteria?.length) {
+            this.def.completionCriteria = this.def.outputs.map((k) => `Output "${k}" is produced.`);
+        }
+        return this.def;
+    }
+}
+/**
+ * Build a Plan from a goal and an array of steps (from step().build() or plain StepDefinition).
+ */
+export function buildPlan(goal, steps, options = {}) {
+    return {
+        id: options.planId ?? "plan-1",
+        version: options.version ?? 1,
+        goal,
+        steps,
+        createdAt: nowISO(),
+    };
+}
+//# sourceMappingURL=planBuilder.js.map

package/dist/defaults/planBuilder.js.map

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

package/dist/defaults/singleStepPlanner.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Default planner that always produces a single step: "answer the goal".
+ * Useful for quick starts and simple QA flows.
+ */
+import type { StepDefinition } from "../types/plan.js";
+import type { Planner } from "../planner/Planner.js";
+/**
+ * Creates a planner that always returns a one-step plan: a single "answer" step that
+ * uses the run context goal. Ideal for quick starts and simple question-answering.
+ */
+export declare function createSingleStepPlanner(): Planner;
+/**
+ * Creates a planner that always returns the given plan (goal is taken from input at createPlan time).
+ * Use with buildPlan(goal, steps) so the goal stays in sync, or pass a plan built once.
+ */
+export declare function createFixedPlanPlanner(fixedSteps: StepDefinition[]): Planner;
+//# sourceMappingURL=singleStepPlanner.d.ts.map

package/dist/defaults/singleStepPlanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"singleStepPlanner.d.ts","sourceRoot":"","sources":["../../src/defaults/singleStepPlanner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAQ,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAiBrD;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,OAAO,CAYjD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,cAAc,EAAE,GAAG,OAAO,CAY5E"}

package/dist/defaults/singleStepPlanner.js

@@ -0,0 +1,52 @@
+/**
+ * Default planner that always produces a single step: "answer the goal".
+ * Useful for quick starts and simple QA flows.
+ */
+import { buildPlan } from "./planBuilder.js";
+const SINGLE_STEP = {
+    id: "answer",
+    name: "Answer",
+    type: "transform",
+    objective: "Answer the user's goal or question clearly and completely.",
+    dependencies: [],
+    allowedTools: [],
+    inputs: [{ source: "runContext", key: "goal" }],
+    outputs: ["answer"],
+    completionCriteria: ["A clear answer is produced."],
+    retryPolicy: { maxAttempts: 2, strategy: "retry_with_feedback" },
+};
+/**
+ * Creates a planner that always returns a one-step plan: a single "answer" step that
+ * uses the run context goal. Ideal for quick starts and simple question-answering.
+ */
+export function createSingleStepPlanner() {
+    return {
+        async createPlan(input) {
+            return buildPlan(input.goal, [SINGLE_STEP]);
+        },
+        async replan(input) {
+            return buildPlan(input.goal, [SINGLE_STEP], {
+                planId: input.currentPlan.id,
+                version: input.currentPlan.version + 1,
+            });
+        },
+    };
+}
+/**
+ * Creates a planner that always returns the given plan (goal is taken from input at createPlan time).
+ * Use with buildPlan(goal, steps) so the goal stays in sync, or pass a plan built once.
+ */
+export function createFixedPlanPlanner(fixedSteps) {
+    return {
+        async createPlan(input) {
+            return buildPlan(input.goal, fixedSteps);
+        },
+        async replan(input) {
+            return buildPlan(input.goal, fixedSteps, {
+                planId: input.currentPlan.id,
+                version: input.currentPlan.version + 1,
+            });
+        },
+    };
+}
+//# sourceMappingURL=singleStepPlanner.js.map

package/dist/defaults/singleStepPlanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"singleStepPlanner.js","sourceRoot":"","sources":["../../src/defaults/singleStepPlanner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,MAAM,WAAW,GAAmB;IAClC,EAAE,EAAE,QAAQ;IACZ,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,WAAW;IACjB,SAAS,EAAE,4DAA4D;IACvE,YAAY,EAAE,EAAE;IAChB,YAAY,EAAE,EAAE;IAChB,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;IAC/C,OAAO,EAAE,CAAC,QAAQ,CAAC;IACnB,kBAAkB,EAAE,CAAC,6BAA6B,CAAC;IACnD,WAAW,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,EAAE,qBAAqB,EAAE;CACjE,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO;QACL,KAAK,CAAC,UAAU,CAAC,KAAmB;YAClC,OAAO,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;QAC9C,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,KAAkB;YAC7B,OAAO,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,CAAC,EAAE;gBAC1C,MAAM,EAAE,KAAK,CAAC,WAAW,CAAC,EAAE;gBAC5B,OAAO,EAAE,KAAK,CAAC,WAAW,CAAC,OAAO,GAAG,CAAC;aACvC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,UAA4B;IACjE,OAAO;QACL,KAAK,CAAC,UAAU,CAAC,KAAmB;YAClC,OAAO,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAC3C,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,KAAkB;YAC7B,OAAO,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE;gBACvC,MAAM,EAAE,KAAK,CAAC,WAAW,CAAC,EAAE;gBAC5B,OAAO,EAAE,KAAK,CAAC,WAAW,CAAC,OAAO,GAAG,CAAC;aACvC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/evaluator/StepEvaluator.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Step evaluator contract (spec §12).
+ */
+import type { EvaluationResult } from "../types/step.js";
+import type { StepEvaluationInput } from "../types/evaluator.js";
+export interface StepEvaluator {
+    evaluate(input: StepEvaluationInput): Promise<EvaluationResult>;
+}
+//# sourceMappingURL=StepEvaluator.d.ts.map

package/dist/evaluator/StepEvaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StepEvaluator.d.ts","sourceRoot":"","sources":["../../src/evaluator/StepEvaluator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACjE"}

package/dist/evaluator/StepEvaluator.js

@@ -0,0 +1,5 @@
+/**
+ * Step evaluator contract (spec §12).
+ */
+export {};
+//# sourceMappingURL=StepEvaluator.js.map

package/dist/evaluator/StepEvaluator.js.map

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

package/dist/events/EventBus.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Run-scoped event bus for execution lifecycle events (spec §16).
+ */
+import type { AgentRunnerEvent, EventName } from "../types/events.js";
+type Handler = (event: AgentRunnerEvent) => void;
+export declare class EventBus {
+    private listeners;
+    on(eventName: EventName, handler: Handler): void;
+    emit(eventName: EventName, payload: Record<string, unknown>): void;
+    removeAllListeners(): void;
+}
+export {};
+//# sourceMappingURL=EventBus.d.ts.map

package/dist/events/EventBus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventBus.d.ts","sourceRoot":"","sources":["../../src/events/EventBus.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAGtE,KAAK,OAAO,GAAG,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAEjD,qBAAa,QAAQ;IACnB,OAAO,CAAC,SAAS,CAAgC;IAEjD,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAMhD,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAgBlE,kBAAkB,IAAI,IAAI;CAG3B"}

package/dist/events/EventBus.js

@@ -0,0 +1,34 @@
+/**
+ * Run-scoped event bus for execution lifecycle events (spec §16).
+ */
+import { nowISO } from "../utils/time.js";
+export class EventBus {
+    constructor() {
+        this.listeners = new Map();
+    }
+    on(eventName, handler) {
+        const list = this.listeners.get(eventName) ?? [];
+        list.push(handler);
+        this.listeners.set(eventName, list);
+    }
+    emit(eventName, payload) {
+        const event = {
+            ...payload,
+            type: eventName,
+            timestamp: nowISO(),
+        };
+        const list = this.listeners.get(eventName) ?? [];
+        for (const h of list) {
+            try {
+                h(event);
+            }
+            catch (_e) {
+                // Don't let one listener break others
+            }
+        }
+    }
+    removeAllListeners() {
+        this.listeners.clear();
+    }
+}
+//# sourceMappingURL=EventBus.js.map

package/dist/events/EventBus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventBus.js","sourceRoot":"","sources":["../../src/events/EventBus.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAI1C,MAAM,OAAO,QAAQ;IAArB;QACU,cAAS,GAAG,IAAI,GAAG,EAAqB,CAAC;IA2BnD,CAAC;IAzBC,EAAE,CAAC,SAAoB,EAAE,OAAgB;QACvC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QACjD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,CAAC,SAAoB,EAAE,OAAgC;QACzD,MAAM,KAAK,GAAG;YACZ,GAAG,OAAO;YACV,IAAI,EAAE,SAAS;YACf,SAAS,EAAE,MAAM,EAAE;SACA,CAAC;QACtB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QACjD,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,IAAI,CAAC;gBACH,CAAC,CAAC,KAAK,CAAC,CAAC;YACX,CAAC;YAAC,OAAO,EAAE,EAAE,CAAC;gBACZ,sCAAsC;YACxC,CAAC;QACH,CAAC;IACH,CAAC;IAED,kBAAkB;QAChB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;CACF"}

package/dist/executor/StepExecutor.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Step executor contract (spec §11).
+ */
+import type { StepAttemptResult } from "../types/step.js";
+import type { StepExecutionInput } from "../types/executor.js";
+export interface StepExecutor {
+    execute(input: StepExecutionInput): Promise<StepAttemptResult>;
+}
+//# sourceMappingURL=StepExecutor.d.ts.map

package/dist/executor/StepExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StepExecutor.d.ts","sourceRoot":"","sources":["../../src/executor/StepExecutor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAChE"}

package/dist/executor/StepExecutor.js

@@ -0,0 +1,5 @@
+/**
+ * Step executor contract (spec §11).
+ */
+export {};
+//# sourceMappingURL=StepExecutor.js.map

package/dist/executor/StepExecutor.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,48 @@
+/**
+ * pocket-agent — Reusable Node.js framework for plan-driven agent execution.
+ * @author sam_thewise
+ */
+export { createAgentRunner } from "./runner/createAgentRunner.js";
+export type { AgentRunner, AgentRunnerConfig, ProviderName, } from "./runner/createAgentRunner.js";
+export type { RunningExecution } from "./runner/RunningExecution.js";
+export { createQuickAgent, createGoalDrivenAgent } from "./quickStart.js";
+export type { QuickAgentConfig, GoalDrivenAgentConfig } from "./quickStart.js";
+export { createLLMPlanner } from "./defaults/llmPlanner.js";
+export type { LLMPlannerOptions } from "./defaults/llmPlanner.js";
+export { step, buildPlan } from "./defaults/planBuilder.js";
+export type { StepBuilderOptions, BuildPlanOptions } from "./defaults/planBuilder.js";
+export { createSingleStepPlanner, createFixedPlanPlanner } from "./defaults/singleStepPlanner.js";
+export { createDefaultExecutor } from "./defaults/defaultExecutor.js";
+export type { DefaultExecutorOptions } from "./defaults/defaultExecutor.js";
+export { createLLMEvaluator } from "./adapters/createLLMEvaluator.js";
+export type { LLMEvaluatorOptions } from "./adapters/createLLMEvaluator.js";
+export { createOpenAIModelAdapter } from "./adapters/models/openai.js";
+export type { OpenAIModelConfig } from "./adapters/models/openai.js";
+export { createAnthropicModelAdapter } from "./adapters/models/anthropic.js";
+export type { AnthropicModelConfig } from "./adapters/models/anthropic.js";
+export { createGeminiModelAdapter } from "./adapters/models/gemini.js";
+export type { GeminiModelConfig } from "./adapters/models/gemini.js";
+export { createOllamaModelAdapter } from "./adapters/models/ollama.js";
+export type { OllamaModelConfig } from "./adapters/models/ollama.js";
+export { ollamaStreamingChat, getOllamaBaseUrl, } from "./adapters/models/ollamaStreaming.js";
+export type { OllamaStreamingOptions, OllamaStreamingResult, } from "./adapters/models/ollamaStreaming.js";
+export { createLmStudioModelAdapter } from "./adapters/models/lmstudio.js";
+export type { LmStudioModelConfig } from "./adapters/models/lmstudio.js";
+export { lmStudioStreamingChat, getLMStudioBaseUrl, } from "./adapters/models/lmStudioStreaming.js";
+export type { LMStudioStreamingOptions, LMStudioStreamingResult, } from "./adapters/models/lmStudioStreaming.js";
+export type { RunTaskInput, RunOptions, RunResult, RunState, RunStatus, } from "./types/run.js";
+export { DEFAULT_RUN_OPTIONS } from "./types/run.js";
+export type { Plan, StepDefinition, StepType, StepInputRef, RetryPolicy, JsonSchemaLike, } from "./types/plan.js";
+export type { StepStatus, StepAttemptResult, StepRunRecord, EvaluationVerdict, EvaluationResult, ArtifactRef, EvidenceRef, StepExecutionError, } from "./types/step.js";
+export type { PlannerInput, ReplanInput, } from "./types/planner.js";
+export type { StepExecutionInput, } from "./types/executor.js";
+export type { StepEvaluationInput, } from "./types/evaluator.js";
+export type { ToolDefinition, ToolAdapter, ToolInvocationContext } from "./types/tools.js";
+export type { ModelAdapter, ModelGenerateInput, ModelGenerateOutput } from "./types/models.js";
+export type { AgentRunnerEvent, EventName, RunStartedEvent, PlanCreatedEvent, PlanRevisedEvent, StepReadyEvent, StepStartedEvent, StepRetryingEvent, StepCompletedEvent, StepBlockedEvent, StepFailedEvent, RunCompletedEvent, RunFailedEvent, } from "./types/events.js";
+export { EVENT_NAMES } from "./types/events.js";
+export { PlanningFailureError, ExecutionFailureError, EvaluationFailureError, RunFailureError, } from "./types/errors.js";
+export type { Planner } from "./planner/Planner.js";
+export type { StepExecutor } from "./executor/StepExecutor.js";
+export type { StepEvaluator } from "./evaluator/StepEvaluator.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,22 @@
+/**
+ * pocket-agent — Reusable Node.js framework for plan-driven agent execution.
+ * @author sam_thewise
+ */
+export { createAgentRunner } from "./runner/createAgentRunner.js";
+export { createQuickAgent, createGoalDrivenAgent } from "./quickStart.js";
+export { createLLMPlanner } from "./defaults/llmPlanner.js";
+export { step, buildPlan } from "./defaults/planBuilder.js";
+export { createSingleStepPlanner, createFixedPlanPlanner } from "./defaults/singleStepPlanner.js";
+export { createDefaultExecutor } from "./defaults/defaultExecutor.js";
+export { createLLMEvaluator } from "./adapters/createLLMEvaluator.js";
+export { createOpenAIModelAdapter } from "./adapters/models/openai.js";
+export { createAnthropicModelAdapter } from "./adapters/models/anthropic.js";
+export { createGeminiModelAdapter } from "./adapters/models/gemini.js";
+export { createOllamaModelAdapter } from "./adapters/models/ollama.js";
+export { ollamaStreamingChat, getOllamaBaseUrl, } from "./adapters/models/ollamaStreaming.js";
+export { createLmStudioModelAdapter } from "./adapters/models/lmstudio.js";
+export { lmStudioStreamingChat, getLMStudioBaseUrl, } from "./adapters/models/lmStudioStreaming.js";
+export { DEFAULT_RUN_OPTIONS } from "./types/run.js";
+export { EVENT_NAMES } from "./types/events.js";
+export { PlanningFailureError, ExecutionFailureError, EvaluationFailureError, RunFailureError, } from "./types/errors.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAQlE,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAE1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAG5D,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAClG,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAGtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAEtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAEvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AAE7E,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAEvE,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAEvE,OAAO,EACL,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,sCAAsC,CAAC;AAK9C,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAE3E,OAAO,EACL,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,wCAAwC,CAAC;AAahD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AA8CrD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,eAAe,GAChB,MAAM,mBAAmB,CAAC"}

package/dist/models/ModelAdapter.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Re-export model types for convenience.
+ */
+export type { ModelAdapter, ModelGenerateInput, ModelGenerateOutput } from "../types/models.js";
+//# sourceMappingURL=ModelAdapter.d.ts.map

package/dist/models/ModelAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModelAdapter.d.ts","sourceRoot":"","sources":["../../src/models/ModelAdapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/models/ModelAdapter.js

@@ -0,0 +1,5 @@
+/**
+ * Re-export model types for convenience.
+ */
+export {};
+//# sourceMappingURL=ModelAdapter.js.map

package/dist/models/ModelAdapter.js.map

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

package/dist/planner/PlanValidator.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Plan validation (spec §10). Validates before execution.
+ */
+import type { Plan } from "../types/plan.js";
+export type ValidationResult = {
+    valid: true;
+} | {
+    valid: false;
+    errors: string[];
+};
+export declare function validatePlan(plan: Plan): ValidationResult;
+/**
+ * Validates the plan and throws PlanningFailureError if invalid.
+ */
+export declare function assertValidPlan(plan: Plan): void;
+//# sourceMappingURL=PlanValidator.d.ts.map

package/dist/planner/PlanValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlanValidator.d.ts","sourceRoot":"","sources":["../../src/planner/PlanValidator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAI7C,MAAM,MAAM,gBAAgB,GACxB;IAAE,KAAK,EAAE,IAAI,CAAA;CAAE,GACf;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAEvC,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,gBAAgB,CAiCzD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAQhD"}

package/dist/planner/PlanValidator.js

@@ -0,0 +1,44 @@
+/**
+ * Plan validation (spec §10). Validates before execution.
+ */
+import { hasCycle } from "../utils/dag.js";
+import { PlanningFailureError } from "../types/errors.js";
+export function validatePlan(plan) {
+    const errors = [];
+    const steps = plan.steps ?? [];
+    const stepIds = new Set();
+    for (const step of steps) {
+        if (stepIds.has(step.id)) {
+            errors.push(`Duplicate step id: ${step.id}`);
+        }
+        stepIds.add(step.id);
+        if (!step.outputs || step.outputs.length === 0) {
+            errors.push(`Step ${step.id}: outputs must be declared`);
+        }
+        if (!step.retryPolicy) {
+            errors.push(`Step ${step.id}: retryPolicy must be present`);
+        }
+        for (const depId of step.dependencies ?? []) {
+            if (!stepIds.has(depId)) {
+                errors.push(`Step ${step.id}: dependency "${depId}" is not a valid step id`);
+            }
+        }
+    }
+    if (hasCycle(steps)) {
+        errors.push("Plan contains a cycle in step dependencies");
+    }
+    if (errors.length > 0) {
+        return { valid: false, errors };
+    }
+    return { valid: true };
+}
+/**
+ * Validates the plan and throws PlanningFailureError if invalid.
+ */
+export function assertValidPlan(plan) {
+    const result = validatePlan(plan);
+    if (!result.valid) {
+        throw new PlanningFailureError(`Invalid plan: ${result.errors.join("; ")}`, result.errors);
+    }
+}
+//# sourceMappingURL=PlanValidator.js.map

package/dist/planner/PlanValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlanValidator.js","sourceRoot":"","sources":["../../src/planner/PlanValidator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAM1D,MAAM,UAAU,YAAY,CAAC,IAAU;IACrC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IAC/B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YACzB,MAAM,CAAC,IAAI,CAAC,sBAAsB,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAErB,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/C,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,EAAE,4BAA4B,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,EAAE,+BAA+B,CAAC,CAAC;QAC9D,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,YAAY,IAAI,EAAE,EAAE,CAAC;YAC5C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxB,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,EAAE,iBAAiB,KAAK,0BAA0B,CAAC,CAAC;YAC/E,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACpB,MAAM,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;IAC5D,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAClC,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAU;IACxC,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,IAAI,oBAAoB,CAC5B,iBAAiB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAC3C,MAAM,CAAC,MAAM,CACd,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/planner/Planner.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Planner contract (spec §10).
+ */
+import type { Plan } from "../types/plan.js";
+import type { PlannerInput, ReplanInput } from "../types/planner.js";
+export interface Planner {
+    createPlan(input: PlannerInput): Promise<Plan>;
+    replan(input: ReplanInput): Promise<Plan>;
+}
+//# sourceMappingURL=Planner.d.ts.map

package/dist/planner/Planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Planner.d.ts","sourceRoot":"","sources":["../../src/planner/Planner.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAErE,MAAM,WAAW,OAAO;IACtB,UAAU,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C"}

package/dist/planner/Planner.js

@@ -0,0 +1,5 @@
+/**
+ * Planner contract (spec §10).
+ */
+export {};
+//# sourceMappingURL=Planner.js.map

package/dist/planner/Planner.js.map

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

package/dist/quickStart.d.ts

@@ -0,0 +1,49 @@
+/**
+ * One-call quick start: create an agent with default single-step plan and
+ * model-based executor. Get running in a few lines, then customize as needed.
+ */
+import type { ProviderName } from "./runner/createAgentRunner.js";
+import type { OpenAIModelConfig } from "./adapters/models/openai.js";
+import type { AnthropicModelConfig } from "./adapters/models/anthropic.js";
+import type { GeminiModelConfig } from "./adapters/models/gemini.js";
+import type { OllamaModelConfig } from "./adapters/models/ollama.js";
+import type { LmStudioModelConfig } from "./adapters/models/lmstudio.js";
+import type { AgentRunner } from "./runner/AgentRunner.js";
+import type { LLMPlannerOptions } from "./defaults/llmPlanner.js";
+export type QuickAgentConfig = {
+    /** Provider (uses env for API keys). */
+    provider: ProviderName;
+    /** Optional model config override. */
+    modelConfig?: OpenAIModelConfig | AnthropicModelConfig | GeminiModelConfig | OllamaModelConfig | LmStudioModelConfig;
+    /** Optional system prompt for the default executor (e.g. "Respond in one sentence."). */
+    systemPrompt?: string;
+};
+export type GoalDrivenAgentConfig = QuickAgentConfig & {
+    /** If true, the LLM generates the plan (steps) from the goal; if false, a single implicit step is used. Default false. */
+    useLLMPlanner?: boolean;
+    /** Options for the LLM planner when useLLMPlanner is true. */
+    llmPlannerOptions?: LLMPlannerOptions;
+};
+/**
+ * Create an agent runner with a single-step plan and model-based executor.
+ * No tools; just set your provider (and API key in env) and run.
+ *
+ * @example
+ * const runner = createQuickAgent({ provider: "openai" });
+ * const run = await runner.run({ goal: "What is 2+2? Explain briefly." });
+ * console.log(run.outputs?.answer);
+ */
+export declare function createQuickAgent(config: QuickAgentConfig): AgentRunner;
+/**
+ * Create an agent runner that works from a goal only: no steps defined by you.
+ * When useLLMPlanner is true, the LLM generates the plan (steps) from the goal;
+ * otherwise a single implicit step is used (same as createQuickAgent).
+ * No tools; uses default executor and evaluator.
+ *
+ * @example
+ * const runner = createGoalDrivenAgent({ provider: "openai", useLLMPlanner: true });
+ * const run = await runner.run({ goal: "Explain quantum computing in 3 steps." });
+ * console.log(run.plan.steps, run.outputs);
+ */
+export declare function createGoalDrivenAgent(config: GoalDrivenAgentConfig): AgentRunner;
+//# sourceMappingURL=quickStart.d.ts.map

package/dist/quickStart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quickStart.d.ts","sourceRoot":"","sources":["../src/quickStart.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAUzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,wCAAwC;IACxC,QAAQ,EAAE,YAAY,CAAC;IACvB,sCAAsC;IACtC,WAAW,CAAC,EACR,iBAAiB,GACjB,oBAAoB,GACpB,iBAAiB,GACjB,iBAAiB,GACjB,mBAAmB,CAAC;IACxB,yFAAyF;IACzF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,gBAAgB,GAAG;IACrD,0HAA0H;IAC1H,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,8DAA8D;IAC9D,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CACvC,CAAC;AAmBF;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,WAAW,CAYtE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,WAAW,CAYhF"}