@agenteer/stdlib 1.0.0-rc.1

package/dist/meta/repair_loop.d.ts

@@ -0,0 +1,90 @@
+/**
+ * `@agenteer/node-repair-loop` — meta-node that drives a validate →
+ * repair → validate cycle via ReplaceMe (sub-plan 03 §14).
+ *
+ * **ReplaceMe-first.** Per master plan ratified resolutions, the retry
+ * mechanism is data-driven convergence: each repair pass returns
+ * `replace_me` with a successor carrying the narrowed target. A bounded
+ * `max_iterations` ceiling exists only as a runaway backstop.
+ *
+ * Shape of one iteration:
+ *   1. Run the target node (via `SpawnChildren`).
+ *   2. Run the validator against the target's output.
+ *   3. If validator.verdict === "pass" → Output(final).
+ *      If validator.verdict === "fail" and iter < ceiling →
+ *        ReplaceMe(self with target_input augmented by the failing issues).
+ *      Otherwise → Failed("repair_exhausted").
+ *
+ * This is the node that earns the framework's "self-obsolescence"
+ * pillar — it's where ReplaceMe pays rent in day-to-day workflows.
+ */
+import { z } from "zod";
+import { type Node } from "@agenteer/core";
+declare const InputSchema: z.ZodObject<{
+    target_manifest_id: z.ZodString;
+    target_input: z.ZodUnknown;
+    validator_manifest_id: z.ZodString;
+    validator_input: z.ZodOptional<z.ZodUnknown>;
+    max_iterations: z.ZodDefault<z.ZodNumber>;
+    iteration: z.ZodDefault<z.ZodNumber>;
+    emit_as: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const OutputSchema: z.ZodObject<{
+    verdict: z.ZodEnum<{
+        pass: "pass";
+        fail: "fail";
+    }>;
+    iterations: z.ZodNumber;
+    final_output: z.ZodUnknown;
+    last_issues: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodOptional<z.ZodString>;
+        message: z.ZodString;
+        code: z.ZodOptional<z.ZodString>;
+        severity: z.ZodOptional<z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+        }>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+type Input = z.input<typeof InputSchema>;
+type Output = z.infer<typeof OutputSchema>;
+export declare function repairLoopFactory(): Node<Input, Output>;
+export declare const repairLoopManifest: {
+    manifest_version: 1;
+    id: string;
+    version: string;
+    name: string;
+    description: string;
+    required_actions: string[];
+    required_capabilities: {
+        tool_use: boolean;
+        vision: boolean;
+        structured_output: "any" | "native" | "text_parse";
+        min_context_tokens?: number | undefined;
+    };
+    dynamic_actions: boolean;
+    side_effects: {
+        writes_fs: boolean;
+        network: boolean;
+        mutates_ctx: boolean;
+        emits_ctx_variants: string[];
+        reads_ctx_variants: string[];
+    };
+    determinism: "deterministic" | "stochastic";
+    tags: string[];
+    author: string;
+    license: string;
+    input_schema?: unknown;
+    output_schema?: unknown;
+    dynamic_action_spec?: string | undefined;
+    homepage?: string | undefined;
+    repository?: string | undefined;
+    planner_hints?: {
+        cost_tier?: "cheap" | "medium" | "expensive" | undefined;
+        latency_tier?: "medium" | "fast" | "slow" | undefined;
+        typical_use?: string | undefined;
+    } | undefined;
+    sha256?: string | undefined;
+};
+export {};
+//# sourceMappingURL=repair_loop.d.ts.map

package/dist/meta/repair_loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repair_loop.d.ts","sourceRoot":"","sources":["../../src/meta/repair_loop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAGL,KAAK,IAAI,EAKV,MAAM,gBAAgB,CAAC;AAsBxB,QAAA,MAAM,WAAW;;;;;;;;iBAYf,CAAC;AAEH,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;iBAchB,CAAC;AAEH,KAAK,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AACzC,KAAK,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAK3C,wBAAgB,iBAAiB,IAAI,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAiKvD;AAED,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAW,CAAC"}

package/dist/meta/repair_loop.js

@@ -0,0 +1,230 @@
+/**
+ * `@agenteer/node-repair-loop` — meta-node that drives a validate →
+ * repair → validate cycle via ReplaceMe (sub-plan 03 §14).
+ *
+ * **ReplaceMe-first.** Per master plan ratified resolutions, the retry
+ * mechanism is data-driven convergence: each repair pass returns
+ * `replace_me` with a successor carrying the narrowed target. A bounded
+ * `max_iterations` ceiling exists only as a runaway backstop.
+ *
+ * Shape of one iteration:
+ *   1. Run the target node (via `SpawnChildren`).
+ *   2. Run the validator against the target's output.
+ *   3. If validator.verdict === "pass" → Output(final).
+ *      If validator.verdict === "fail" and iter < ceiling →
+ *        ReplaceMe(self with target_input augmented by the failing issues).
+ *      Otherwise → Failed("repair_exhausted").
+ *
+ * This is the node that earns the framework's "self-obsolescence"
+ * pillar — it's where ReplaceMe pays rent in day-to-day workflows.
+ */
+import { z } from "zod";
+import { asArtifact, makeManifest, } from "@agenteer/core";
+import { ValidatorOutputSchema } from "../shared/index.js";
+const MANIFEST = makeManifest({
+    id: "@agenteer/node-repair-loop",
+    name: "repair_loop",
+    description: "ReplaceMe-first validate/repair loop. Max-iterations is a runaway backstop; progress is data-driven.",
+    determinism: "stochastic",
+    required_actions: [],
+    dynamic_actions: true,
+    // We spawn whichever target + validator the caller names.
+    dynamic_action_spec: "spawn:${input.target_manifest_id}, spawn:${input.validator_manifest_id}",
+    tags: ["meta"],
+    side_effects: {
+        writes_fs: false,
+        network: false,
+        mutates_ctx: true,
+        emits_ctx_variants: ["artifact.repair_loop.result"],
+    },
+});
+const InputSchema = z.object({
+    target_manifest_id: z.string().min(1),
+    target_input: z.unknown(),
+    validator_manifest_id: z.string().min(1),
+    validator_input: z.unknown().optional(),
+    max_iterations: z.number().int().min(1).max(32).default(4),
+    iteration: z.number().int().min(0).default(0),
+    /**
+     * Optional ctx tag: final result is emitted as an Artifact under this
+     * name so downstream nodes can read it via ctx.
+     */
+    emit_as: z.string().optional(),
+});
+const OutputSchema = z.object({
+    verdict: z.enum(["pass", "fail"]),
+    iterations: z.number().int().nonnegative(),
+    final_output: z.unknown(),
+    last_issues: z
+        .array(z.object({
+        path: z.string().optional(),
+        message: z.string(),
+        code: z.string().optional(),
+        severity: z.enum(["error", "warning"]).optional(),
+    }))
+        .optional(),
+});
+const TARGET_CORRELATION = "repair.target";
+const VALIDATOR_CORRELATION = "repair.validator";
+export function repairLoopFactory() {
+    return {
+        manifest: MANIFEST,
+        inputSchema: InputSchema,
+        outputSchema: OutputSchema,
+        ctx: [],
+        model: null,
+        async execute(input) {
+            const i = input.original;
+            const iter = i.iteration ?? 0;
+            const maxIter = i.max_iterations ?? 4;
+            if (!input.children) {
+                // No children yet → we're on entry; spawn the target.
+                return {
+                    kind: "spawn_children",
+                    join: { mode: "all" },
+                    children: [
+                        {
+                            manifest_id: i.target_manifest_id,
+                            input: i.target_input,
+                            correlation: TARGET_CORRELATION,
+                        },
+                    ],
+                };
+            }
+            // Re-entry. Two shapes to handle:
+            //   (a) only target-result present → spawn validator
+            //   (b) target + validator present → decide
+            const target = input.children.find((c) => c.correlation === TARGET_CORRELATION);
+            const validator = input.children.find((c) => c.correlation === VALIDATOR_CORRELATION);
+            if (!target) {
+                return {
+                    kind: "failed",
+                    reason: "repair_loop: no target child on re-entry",
+                    retryable: false,
+                    evidence: { verdict: "fail" },
+                };
+            }
+            if (target.result.kind !== "output") {
+                return {
+                    kind: "failed",
+                    reason: `repair_loop: target failed (${target.result.reason ?? target.result.kind})`,
+                    retryable: false,
+                    details: { target: target.result },
+                    evidence: { verdict: "fail" },
+                };
+            }
+            const targetOutput = target.result.value;
+            if (!validator) {
+                // Spawn the validator with the target's output merged in.
+                const validatorInput = buildValidatorInput(i.validator_input, targetOutput);
+                return {
+                    kind: "spawn_children",
+                    join: { mode: "all" },
+                    children: [
+                        {
+                            manifest_id: i.target_manifest_id,
+                            input: i.target_input,
+                            correlation: TARGET_CORRELATION,
+                        },
+                        {
+                            manifest_id: i.validator_manifest_id,
+                            input: validatorInput,
+                            correlation: VALIDATOR_CORRELATION,
+                        },
+                    ],
+                };
+            }
+            // Validator present — interpret.
+            if (validator.result.kind !== "output") {
+                return {
+                    kind: "failed",
+                    reason: `repair_loop: validator failed (${validator.result.reason ?? validator.result.kind})`,
+                    retryable: false,
+                    evidence: { verdict: "fail" },
+                };
+            }
+            const vParsed = ValidatorOutputSchema.safeParse(validator.result.value);
+            if (!vParsed.success) {
+                return {
+                    kind: "failed",
+                    reason: `repair_loop: validator output not a ValidatorOutput shape`,
+                    retryable: false,
+                    details: { issues: vParsed.error.issues },
+                    evidence: { verdict: "fail" },
+                };
+            }
+            const vout = vParsed.data;
+            if (vout.verdict === "pass") {
+                const base = {
+                    verdict: "pass",
+                    iterations: iter,
+                    final_output: targetOutput,
+                };
+                const patch = i.emit_as
+                    ? {
+                        set: {
+                            [i.emit_as]: asArtifact({ verdict: "pass", iterations: iter, output: targetOutput }, { media_type: "application/json" }),
+                        },
+                    }
+                    : undefined;
+                return {
+                    kind: "output",
+                    value: base,
+                    ...(patch ? { ctx_patch: patch } : {}),
+                    evidence: { verdict: "pass" },
+                };
+            }
+            // Validator failed.
+            if (iter + 1 >= maxIter) {
+                return {
+                    kind: "output",
+                    value: {
+                        verdict: "fail",
+                        iterations: iter + 1,
+                        final_output: targetOutput,
+                        last_issues: vout.issues,
+                    },
+                    evidence: { verdict: "fail" },
+                };
+            }
+            // Repair step: ReplaceMe self with `iteration + 1`, feeding the
+            // validator's issues back into target_input as a hint.
+            const successor = {
+                manifest_id: MANIFEST.id,
+                // Runtime preserves the frame's correlation on ReplaceMe; this
+                // value is only used for lineage tracking on the successor's
+                // own spawn event.
+                correlation: `repair-iter-${iter + 1}`,
+                input: {
+                    ...i,
+                    iteration: iter + 1,
+                    target_input: {
+                        ...(typeof i.target_input === "object" && i.target_input !== null
+                            ? i.target_input
+                            : { original: i.target_input }),
+                        prior_issues: vout.issues,
+                        prior_iteration: iter,
+                    },
+                },
+            };
+            return {
+                kind: "replace_me",
+                reason: `repair_iteration:${iter + 1}:${vout.issues.length}_issues`,
+                successor,
+            };
+        },
+    };
+}
+export const repairLoopManifest = MANIFEST;
+function buildValidatorInput(baseValidatorInput, targetOutput) {
+    // If the caller didn't specify, pass the target output through as
+    // `candidate` — a reasonable default for validators that inspect output.
+    if (baseValidatorInput === undefined || baseValidatorInput === null) {
+        return { candidate: targetOutput };
+    }
+    if (typeof baseValidatorInput === "object") {
+        return { ...baseValidatorInput, candidate: targetOutput };
+    }
+    return baseValidatorInput;
+}
+//# sourceMappingURL=repair_loop.js.map

package/dist/meta/repair_loop.js.map

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

package/dist/planner/default_planner.d.ts

@@ -0,0 +1,88 @@
+/**
+ * `@agenteer/node-default-planner` — LLM-driven plan composer (sub-plan 03 §17).
+ *
+ * **Returns a plan as DATA**, not as `SpawnChildren` (master plan ratified
+ * resolution). This enables:
+ *   - Replay: a plan is a value you can serialize, review, and diff.
+ *   - Human approval: pair with `approval_gate` to require sign-off before exec.
+ *   - Judge review: `judge_with_stripped_ctx` can score the plan.
+ *   - Swapping planners: another node consumes the plan and spawns.
+ *
+ * The node emits the plan as an Artifact via `ctx.set(asArtifact(...))`
+ * (uses R3-A) so downstream nodes see it via their context slice.
+ */
+import { z } from "zod";
+import { type Node } from "@agenteer/core";
+declare const InputSchema: z.ZodObject<{
+    goal: z.ZodString;
+    available_manifests: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodString;
+        required_actions: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    model_id: z.ZodString;
+    emit_as: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+declare const OutputSchema: z.ZodObject<{
+    plan: z.ZodObject<{
+        goal: z.ZodString;
+        steps: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            manifest_id: z.ZodString;
+            input: z.ZodUnknown;
+            rationale: z.ZodOptional<z.ZodString>;
+            depends_on: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            attenuate: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+        notes: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    model: z.ZodString;
+    method: z.ZodEnum<{
+        native: "native";
+        text_parse: "text_parse";
+        mock: "mock";
+    }>;
+}, z.core.$strip>;
+type Input = z.input<typeof InputSchema>;
+type Output = z.infer<typeof OutputSchema>;
+export declare function defaultPlannerFactory(): Node<Input, Output>;
+export declare const defaultPlannerManifest: {
+    manifest_version: 1;
+    id: string;
+    version: string;
+    name: string;
+    description: string;
+    required_actions: string[];
+    required_capabilities: {
+        tool_use: boolean;
+        vision: boolean;
+        structured_output: "any" | "native" | "text_parse";
+        min_context_tokens?: number | undefined;
+    };
+    dynamic_actions: boolean;
+    side_effects: {
+        writes_fs: boolean;
+        network: boolean;
+        mutates_ctx: boolean;
+        emits_ctx_variants: string[];
+        reads_ctx_variants: string[];
+    };
+    determinism: "deterministic" | "stochastic";
+    tags: string[];
+    author: string;
+    license: string;
+    input_schema?: unknown;
+    output_schema?: unknown;
+    dynamic_action_spec?: string | undefined;
+    homepage?: string | undefined;
+    repository?: string | undefined;
+    planner_hints?: {
+        cost_tier?: "cheap" | "medium" | "expensive" | undefined;
+        latency_tier?: "medium" | "fast" | "slow" | undefined;
+        typical_use?: string | undefined;
+    } | undefined;
+    sha256?: string | undefined;
+};
+export {};
+//# sourceMappingURL=default_planner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"default_planner.d.ts","sourceRoot":"","sources":["../../src/planner/default_planner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAGL,KAAK,IAAI,EAKV,MAAM,gBAAgB,CAAC;AAmCxB,QAAA,MAAM,WAAW;;;;;;;;;;iBAqBf,CAAC;AAEH,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;iBAIhB,CAAC;AAEH,KAAK,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AACzC,KAAK,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAE3C,wBAAgB,qBAAqB,IAAI,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CA8D3D;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAW,CAAC"}

package/dist/planner/default_planner.js

@@ -0,0 +1,156 @@
+/**
+ * `@agenteer/node-default-planner` — LLM-driven plan composer (sub-plan 03 §17).
+ *
+ * **Returns a plan as DATA**, not as `SpawnChildren` (master plan ratified
+ * resolution). This enables:
+ *   - Replay: a plan is a value you can serialize, review, and diff.
+ *   - Human approval: pair with `approval_gate` to require sign-off before exec.
+ *   - Judge review: `judge_with_stripped_ctx` can score the plan.
+ *   - Swapping planners: another node consumes the plan and spawns.
+ *
+ * The node emits the plan as an Artifact via `ctx.set(asArtifact(...))`
+ * (uses R3-A) so downstream nodes see it via their context slice.
+ */
+import { z } from "zod";
+import { asArtifact, makeManifest, } from "@agenteer/core";
+const MANIFEST = makeManifest({
+    id: "@agenteer/node-default-planner",
+    name: "default_planner",
+    description: "LLM-driven planner. Returns a plan (as data + ctx artifact); does NOT spawn the plan itself.",
+    determinism: "stochastic",
+    required_actions: [],
+    dynamic_actions: true,
+    dynamic_action_spec: "model:${input.model_id}",
+    tags: ["meta", "planner"],
+    side_effects: {
+        writes_fs: false,
+        network: true,
+        mutates_ctx: true,
+        emits_ctx_variants: ["artifact.plan"],
+    },
+});
+const PlanStepSchema = z.object({
+    id: z.string().min(1),
+    manifest_id: z.string().min(1),
+    input: z.unknown(),
+    rationale: z.string().optional(),
+    depends_on: z.array(z.string()).default([]),
+    attenuate: z.array(z.string()).optional(),
+});
+const PlanSchema = z.object({
+    goal: z.string(),
+    steps: z.array(PlanStepSchema).min(1),
+    notes: z.string().optional(),
+});
+const InputSchema = z.object({
+    goal: z.string().min(1),
+    /**
+     * Manifests the planner is allowed to include. Structural filter —
+     * the planner picks from this set and only this set. No semantic
+     * "free-for-all"; matches the "planner filters structurally first"
+     * invariant.
+     */
+    available_manifests: z
+        .array(z.object({
+        id: z.string().min(1),
+        name: z.string(),
+        description: z.string(),
+        required_actions: z.array(z.string()).default([]),
+    }))
+        .min(1),
+    model_id: z.string().min(1),
+    /** Tag under which the plan is emitted to ctx (default: "plan"). */
+    emit_as: z.string().default("plan"),
+});
+const OutputSchema = z.object({
+    plan: PlanSchema,
+    model: z.string(),
+    method: z.enum(["native", "text_parse", "mock"]),
+});
+export function defaultPlannerFactory() {
+    return {
+        manifest: MANIFEST,
+        inputSchema: InputSchema,
+        outputSchema: OutputSchema,
+        ctx: [],
+        model: null,
+        async execute(input, handle) {
+            const i = input.original;
+            const emitAs = i.emit_as ?? "plan";
+            const systemPrompt = buildSystemPrompt();
+            const userPrompt = buildUserPrompt(i);
+            try {
+                const res = await handle.callModel({
+                    model_id: i.model_id,
+                    prompt: userPrompt,
+                    system: systemPrompt,
+                    schema: PlanSchema,
+                });
+                const plan = res.value;
+                // Defensive: reject plans whose steps reference manifests outside
+                // the allowed set. The kernel would refuse at spawn anyway, but
+                // we fail fast here so the planner sees feedback as a `Failed`
+                // that a repair_loop can digest.
+                const allowed = new Set(i.available_manifests.map((m) => m.id));
+                const illegal = plan.steps.filter((s) => !allowed.has(s.manifest_id));
+                if (illegal.length > 0) {
+                    return {
+                        kind: "failed",
+                        reason: `planner chose manifests outside available_manifests: ${illegal.map((s) => s.manifest_id).join(", ")}`,
+                        retryable: true,
+                        evidence: { verdict: "fail" },
+                    };
+                }
+                return {
+                    kind: "output",
+                    value: { plan, model: res.model, method: res.method },
+                    ctx_patch: {
+                        set: {
+                            [emitAs]: asArtifact(plan, {
+                                media_type: "application/json",
+                                schema_ref: "@agenteer/default_planner.plan.v1",
+                            }),
+                        },
+                    },
+                    evidence: { verdict: "pass" },
+                };
+            }
+            catch (err) {
+                const reason = err instanceof Error ? err.message : String(err);
+                return {
+                    kind: "failed",
+                    reason,
+                    retryable: /timeout|rate.?limit|5\d\d|structured_output_exhausted/i.test(reason),
+                    evidence: { verdict: "fail" },
+                };
+            }
+        },
+    };
+}
+export const defaultPlannerManifest = MANIFEST;
+function buildSystemPrompt() {
+    return [
+        "You are a software-engineering planner.",
+        "You produce a JSON plan whose steps can be executed by the given manifests.",
+        "Constraints:",
+        "- Every step.manifest_id MUST be drawn from the provided `available_manifests` list.",
+        "- Every step.id is unique within the plan.",
+        "- `depends_on` references earlier step ids only; no cycles.",
+        "- `input` must match what the named manifest expects.",
+        "- Keep plans minimal — no speculative steps.",
+    ].join("\n");
+}
+function buildUserPrompt(input) {
+    const catalog = input.available_manifests
+        .map((m) => `- ${m.id} (${m.name}): ${m.description}`)
+        .join("\n");
+    return [
+        `Goal: ${input.goal}`,
+        ``,
+        `Available manifests:`,
+        catalog,
+        ``,
+        `Return JSON matching: { goal, steps: [{ id, manifest_id, input, rationale?, depends_on[] }], notes? }`,
+    ].join("\n");
+}
+//# sourceMappingURL=default_planner.js.map

package/dist/planner/default_planner.js.map

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

package/dist/primitives/file_read.d.ts

@@ -0,0 +1,60 @@
+/**
+ * `@agenteer/node-file-read` — permissioned filesystem read (sub-plan 03 §3).
+ *
+ * Deterministic. Declares `fs.read:*`; actual scope attenuation happens at
+ * spawn time. At dispatch the permission kernel synthesizes the concrete
+ * `fs.read:<path>` capability and checks against `granted`.
+ */
+import { z } from "zod";
+import { type Node } from "@agenteer/core";
+declare const InputSchema: z.ZodObject<{
+    path: z.ZodString;
+    emit_as: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const OutputSchema: z.ZodObject<{
+    path: z.ZodString;
+    content: z.ZodString;
+    bytes: z.ZodNumber;
+}, z.core.$strip>;
+type Input = z.infer<typeof InputSchema>;
+type Output = z.infer<typeof OutputSchema>;
+export declare function fileReadFactory(): Node<Input, Output>;
+export declare const fileReadManifest: {
+    manifest_version: 1;
+    id: string;
+    version: string;
+    name: string;
+    description: string;
+    required_actions: string[];
+    required_capabilities: {
+        tool_use: boolean;
+        vision: boolean;
+        structured_output: "any" | "native" | "text_parse";
+        min_context_tokens?: number | undefined;
+    };
+    dynamic_actions: boolean;
+    side_effects: {
+        writes_fs: boolean;
+        network: boolean;
+        mutates_ctx: boolean;
+        emits_ctx_variants: string[];
+        reads_ctx_variants: string[];
+    };
+    determinism: "deterministic" | "stochastic";
+    tags: string[];
+    author: string;
+    license: string;
+    input_schema?: unknown;
+    output_schema?: unknown;
+    dynamic_action_spec?: string | undefined;
+    homepage?: string | undefined;
+    repository?: string | undefined;
+    planner_hints?: {
+        cost_tier?: "cheap" | "medium" | "expensive" | undefined;
+        latency_tier?: "medium" | "fast" | "slow" | undefined;
+        typical_use?: string | undefined;
+    } | undefined;
+    sha256?: string | undefined;
+};
+export {};
+//# sourceMappingURL=file_read.d.ts.map

package/dist/primitives/file_read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file_read.d.ts","sourceRoot":"","sources":["../../src/primitives/file_read.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAEL,KAAK,IAAI,EAKV,MAAM,gBAAgB,CAAC;AAqBxB,QAAA,MAAM,WAAW;;;iBAIf,CAAC;AAEH,QAAA,MAAM,YAAY;;;;iBAIhB,CAAC;AAEH,KAAK,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AACzC,KAAK,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAE3C,wBAAgB,eAAe,IAAI,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CA2BrD;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAW,CAAC"}