agentera 3.0.0-dev.20 → 3.0.0-dev.21

package/dist/state/planRetrieval.js

@@ -0,0 +1,314 @@
+import { createHash, createHmac, timingSafeEqual } from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import { deflateRawSync, inflateRawSync } from "node:zlib";
+import YAML from "yaml";
+import { loadYamlMapping } from "../core/yaml.js";
+import { discoverPlanArtifacts, planCatalogEntry, planDocumentParts } from "../cli/planArtifacts.js";
+import { canonicalRecordJson } from "./archiveDiscovery.js";
+import { StateRetrievalFailure } from "./directRetrieval.js";
+import { PLAN_ID } from "./planIdentity.js";
+const CURSOR_VERSION = 1;
+const ORDER = "created_desc_then_plan_id_asc";
+const MAX_LIST_BYTES = 32_768;
+function hash(value) {
+    return createHash("sha256").update(canonicalRecordJson(value), "utf8").digest("hex");
+}
+function fail(exitCode, className, message, verb, details = {}) {
+    const list = verb === "list";
+    return new StateRetrievalFailure({
+        schemaVersion: "agentera.stateFailure.v1",
+        status: "fail",
+        error: {
+            class: className,
+            message,
+            syntax: list
+                ? "agentera state plan list [--limit N] [--cursor TOKEN] --format json"
+                : "agentera state plan get --plan PLAN_ID --format json",
+            example: list
+                ? "agentera state plan list --limit 20 --format json"
+                : "agentera state plan get --plan plan:123e4567-e89b-42d3-a456-426614174000 --format json",
+            recovery: details.recovery ?? "Correct the command using one of the valid forms and retry; no state was changed.",
+            valid_values: list
+                ? ["list", "--limit 1..100", "--cursor TOKEN", "--format text|json|yaml"]
+                : ["get", "--plan PLAN_ID", "--format text|json|yaml"],
+            ...details,
+        },
+    }, exitCode);
+}
+function logicalPlans(discovery) {
+    const byId = new Map();
+    for (const identity of discovery.identities) {
+        const values = byId.get(identity.stableId) ?? [];
+        values.push(identity);
+        byId.set(identity.stableId, values);
+    }
+    return [...byId.entries()].map(([stableId, identities]) => {
+        const ordered = [...identities].sort((left, right) => {
+            const leftActive = left.artifact.path === discovery.activePath ? 0 : 1;
+            const rightActive = right.artifact.path === discovery.activePath ? 0 : 1;
+            return leftActive - rightActive || left.artifact.path.localeCompare(right.artifact.path);
+        });
+        const paths = [...new Set(ordered.map((value) => value.artifact.path))].sort();
+        return {
+            stableId,
+            artifact: ordered[0].artifact,
+            identity: ordered[0],
+            paths,
+            active: paths.includes(discovery.activePath),
+            archived: paths.some((candidate) => candidate !== discovery.activePath),
+        };
+    }).sort((left, right) => {
+        const created = planDocumentParts(right.artifact.data).created.localeCompare(planDocumentParts(left.artifact.data).created);
+        return created || left.stableId.localeCompare(right.stableId);
+    });
+}
+function catalogEntry(plan) {
+    const entry = planCatalogEntry(plan.artifact, plan.active ? plan.artifact.path : "", plan.identity);
+    entry.detail_availability = plan.identity.ambiguous ? "unavailable" : "full";
+    entry.active = plan.active;
+    entry.archived = plan.archived;
+    entry.provenance = {
+        storage: plan.active && plan.archived ? "active_and_archive_files" : plan.active ? "active_plan_file" : "immutable_plan_archive",
+        lifecycle_positions: [...(plan.active ? ["active"] : []), ...(plan.archived ? ["archived"] : [])],
+        paths: plan.paths,
+        ...(plan.paths.length > 1 ? { mirrored_paths: plan.paths } : { path: plan.paths[0] }),
+    };
+    entry.retrieval = { get: `agentera state plan get --plan ${plan.stableId} --format json` };
+    return entry;
+}
+function refs(plans) {
+    return plans.map((plan) => ({ stable_id: plan.stableId, paths: plan.paths, canonical_hash: hash(plan.identity.canonicalJson) }));
+}
+function snapshotId(candidateRefs) {
+    return hash({ collection: "plan.plans", order: ORDER, candidates: candidateRefs });
+}
+function cursorKey(projectRoot) {
+    return createHash("sha256").update(`agentera-plan-cursor\0${path.resolve(projectRoot)}`, "utf8").digest();
+}
+function sign(payload, projectRoot) {
+    return createHmac("sha256", cursorKey(projectRoot)).update(canonicalRecordJson(payload), "utf8").digest("hex");
+}
+function encodeCursor(payload, projectRoot) {
+    const bytes = Buffer.from(JSON.stringify({ ...payload, signature: sign(payload, projectRoot) }), "utf8");
+    return deflateRawSync(bytes).toString("base64url");
+}
+function parseCursor(token, projectRoot) {
+    const invalid = (message) => {
+        throw fail(2, "cursor_invalid", message, "list", {
+            recovery: "Copy response.next_cursor exactly, or omit --cursor to establish a new plan-catalog snapshot.",
+            details: { cursor: "opaque; do not parse or construct cursor tokens" },
+        });
+    };
+    if (!token || token.length > 100_000 || !/^[A-Za-z0-9_-]+$/.test(token))
+        invalid("cursor is not a valid opaque token");
+    let decoded;
+    try {
+        const compressed = Buffer.from(token, "base64url");
+        if (compressed.toString("base64url") !== token)
+            invalid("cursor is not a canonical opaque token");
+        decoded = JSON.parse(inflateRawSync(compressed, { maxOutputLength: 1_000_000 }).toString("utf8"));
+    }
+    catch {
+        invalid("cursor is not a valid opaque token");
+    }
+    if (decoded === null || typeof decoded !== "object" || Array.isArray(decoded))
+        invalid("cursor payload is invalid");
+    const record = decoded;
+    const { signature, ...unsigned } = record;
+    if (typeof signature !== "string" || !/^[0-9a-f]{64}$/.test(signature))
+        invalid("cursor signature is invalid");
+    const expected = sign(unsigned, projectRoot);
+    if (!timingSafeEqual(Buffer.from(signature), Buffer.from(expected)))
+        invalid("cursor signature is invalid");
+    if (unsigned.version !== CURSOR_VERSION || unsigned.collection !== "plan.plans" || unsigned.order !== ORDER)
+        invalid("cursor is bound to a different collection or order");
+    if (!Number.isSafeInteger(unsigned.after) || Number(unsigned.after) < 1 || !Array.isArray(unsigned.candidate_ids) || !Array.isArray(unsigned.diagnostics))
+        invalid("cursor payload is invalid");
+    if (unsigned.candidate_ids.some((candidate) => typeof candidate !== "string" || !PLAN_ID.test(candidate)))
+        invalid("cursor candidate snapshot is invalid");
+    if (typeof unsigned.snapshot_id !== "string" || !/^[0-9a-f]{64}$/.test(unsigned.snapshot_id) || typeof unsigned.diagnostic_hash !== "string" || !/^[0-9a-f]{64}$/.test(unsigned.diagnostic_hash))
+        invalid("cursor snapshot is invalid");
+    return unsigned;
+}
+function plansFromSnapshot(discovery, payload) {
+    if (hash(discovery.diagnostics) !== payload.diagnostic_hash) {
+        throw fail(1, "cursor_snapshot_unavailable", "the plan catalog diagnostics changed and the snapshot cannot be resumed exactly", "list", {
+            recovery: "Start a new plan listing without --cursor to establish the current snapshot.",
+            details: { snapshot_id: payload.snapshot_id },
+        });
+    }
+    const current = logicalPlans(discovery);
+    const plans = payload.candidate_ids.map((stableId) => {
+        const match = current.find((candidate) => candidate.stableId === stableId);
+        if (!match) {
+            throw fail(1, "cursor_snapshot_unavailable", "the plan catalog snapshot changed and cannot be resumed exactly", "list", {
+                recovery: "Start a new plan listing without --cursor to establish the current snapshot.",
+                details: { snapshot_id: payload.snapshot_id },
+            });
+        }
+        return match;
+    });
+    if (snapshotId(refs(plans)) !== payload.snapshot_id) {
+        throw fail(1, "cursor_snapshot_unavailable", "the plan catalog snapshot changed and cannot be resumed exactly", "list", {
+            recovery: "Start a new plan listing without --cursor to establish the current snapshot.",
+            details: { snapshot_id: payload.snapshot_id },
+        });
+    }
+    return plans;
+}
+function baseList(plans, selected, diagnostics, snapshotRefs) {
+    const degraded = diagnostics.length > 0 || plans.some((plan) => !plan.identity.persisted || plan.identity.ambiguous);
+    return {
+        schemaVersion: "agentera.stateRetrieval.v1",
+        command: "state plan list",
+        status: degraded ? "degraded" : "ok",
+        entries: selected.map(catalogEntry),
+        counts: { total: plans.length, returned: selected.length, remaining: plans.length - selected.length, omitted: plans.length - selected.length },
+        order: ORDER,
+        filters: {},
+        snapshot: { id: snapshotId(snapshotRefs), candidate_count: plans.length, has_more: plans.length > selected.length },
+        source: { artifact: "plan", storage: "active_plan_file_and_immutable_plan_archive_files", compatibility_diagnostics: diagnostics },
+        source_contract: {
+            authority: "references/artifacts/state-storage-authority.yaml",
+            complete_for_plan_list_retrieval: true,
+            storage_ownership: "active_plan_file_and_immutable_plan_archive_files",
+        },
+        retrieval: { get: "agentera state plan get --plan PLAN_ID --format json" },
+        omitted: false,
+        omitted_count: 0,
+        omission_reason: null,
+    };
+}
+function withPage(plans, diagnostics, start, retained, projectRoot, reason) {
+    const snapshotRefs = refs(plans);
+    const selected = plans.slice(start, start + retained);
+    const remaining = Math.max(0, plans.length - start - selected.length);
+    const response = baseList(plans, selected, diagnostics, snapshotRefs);
+    response.counts = { total: plans.length, returned: selected.length, remaining, omitted: remaining };
+    response.snapshot = { ...response.snapshot, has_more: remaining > 0 };
+    if (remaining > 0 && selected.length > 0) {
+        const token = encodeCursor({
+            version: CURSOR_VERSION,
+            collection: "plan.plans",
+            order: ORDER,
+            snapshot_id: snapshotId(snapshotRefs),
+            candidate_ids: plans.map((plan) => plan.stableId),
+            diagnostics,
+            diagnostic_hash: hash(diagnostics),
+            after: start + selected.length,
+        }, projectRoot);
+        response.next_cursor = token;
+        response.omitted = true;
+        response.omitted_count = remaining;
+        response.omission_reason = reason;
+        response.retrieval = {
+            continue: `agentera state plan list --cursor ${token} --format json`,
+            get: "agentera state plan get --plan PLAN_ID --format json",
+        };
+    }
+    return response;
+}
+function serializedListBytes(response, format) {
+    const text = format === "json"
+        ? JSON.stringify(response, null, 2) + "\n"
+        : YAML.stringify(response, { sortMapEntries: false });
+    return Buffer.byteLength(text, "utf8");
+}
+export function listPlans(projectRoot, activePath, options) {
+    if (!Number.isSafeInteger(options.limit) || options.limit < 1 || options.limit > 100) {
+        throw fail(2, "invalid_request", "plan list limit must be an integer from 1 through 100", "list", { valid_values: ["1..100"] });
+    }
+    const discovery = discoverPlanArtifacts(activePath);
+    const parsed = options.cursor ? parseCursor(options.cursor, projectRoot) : undefined;
+    const plans = parsed ? plansFromSnapshot(discovery, parsed) : logicalPlans(discovery);
+    const diagnostics = parsed?.diagnostics ?? discovery.diagnostics;
+    const start = parsed?.after ?? 0;
+    if (start > plans.length)
+        throw fail(2, "cursor_invalid", "cursor position is outside its plan snapshot", "list");
+    const requested = Math.min(options.limit, plans.length - start);
+    let response = withPage(plans, diagnostics, start, requested, projectRoot, "page_limit");
+    if (options.format === "json" || options.format === "yaml") {
+        for (let retained = requested; retained > 0 && serializedListBytes(response, options.format) > MAX_LIST_BYTES; retained -= 1) {
+            response = withPage(plans, diagnostics, start, retained - 1, projectRoot, "serialized_output_byte_budget");
+        }
+        if (serializedListBytes(response, options.format) > MAX_LIST_BYTES || (plans.length > start && response.entries.length === 0)) {
+            throw fail(1, "unsupported_state", `one plan cannot fit within the ${MAX_LIST_BYTES}-byte ${options.format.toUpperCase()} list budget`, "list", {
+                recovery: "Fetch a plan directly with agentera state plan get --plan PLAN_ID --format json.",
+            });
+        }
+    }
+    return response;
+}
+function invalidCandidates(discovery, selectedPlan) {
+    const paths = [...discovery.invalidArchivePaths];
+    if (!discovery.active)
+        paths.push(discovery.activePath);
+    return paths.filter((candidatePath) => {
+        if (!fs.existsSync(candidatePath))
+            return false;
+        try {
+            const value = loadYamlMapping(fs.readFileSync(candidatePath, "utf8"));
+            const header = value.header;
+            return header !== null && typeof header === "object" && !Array.isArray(header) && header.id === selectedPlan;
+        }
+        catch {
+            return false;
+        }
+    }).sort();
+}
+export function getPlan(activePath, selectedPlan) {
+    if (!PLAN_ID.test(selectedPlan)) {
+        throw fail(2, "invalid_request", `invalid plan identity '${selectedPlan}'`, "get", {
+            valid_values: ["plan:<lowercase-rfc9562-uuid>", "legacy-plan:<64-lowercase-hex-digest>"],
+        });
+    }
+    const discovery = discoverPlanArtifacts(activePath);
+    const matches = logicalPlans(discovery).filter((plan) => plan.stableId === selectedPlan);
+    const invalid = invalidCandidates(discovery, selectedPlan);
+    if (matches.length > 0 && (matches[0].identity.ambiguous || invalid.length > 0)) {
+        const paths = [...new Set([...matches[0].paths, ...invalid])].sort();
+        throw fail(1, "ambiguous", `plan identity '${selectedPlan}' resolves to multiple incompatible candidates`, "get", {
+            stable_id: selectedPlan,
+            recovery: "Repair the identity collision; Agentera will not choose a plan by path, mtime, or discovery order.",
+            details: { candidate_paths: paths },
+        });
+    }
+    if (invalid.length > 0) {
+        const selectedDiagnostics = discovery.diagnostics.filter((diagnostic) => invalid.includes(diagnostic.path));
+        throw fail(1, "corrupt", `plan '${selectedPlan}' exists but cannot be read safely`, "get", {
+            stable_id: selectedPlan,
+            recovery: "Repair the selected plan archive, then retry the exact get command.",
+            details: { candidate_paths: invalid, diagnostics: selectedDiagnostics },
+        });
+    }
+    const plan = matches[0];
+    if (!plan) {
+        throw fail(1, "not_found", `plan '${selectedPlan}' was not found`, "get", {
+            stable_id: selectedPlan,
+            recovery: "List active and archived plan identities with agentera state plan list --format json, then retry.",
+            details: { compatibility_diagnostics: discovery.diagnostics },
+        });
+    }
+    const entry = catalogEntry(plan);
+    return {
+        schemaVersion: "agentera.stateRetrieval.v1",
+        command: "state plan get",
+        status: plan.identity.persisted ? "ok" : "degraded",
+        entry,
+        plan: plan.artifact.data,
+        source: {
+            artifact: "plan",
+            plan_id: selectedPlan,
+            compatibility_diagnostics: discovery.diagnostics,
+            provenance: (entry.provenance ?? {}),
+        },
+        source_contract: {
+            authority: "references/artifacts/state-storage-authority.yaml",
+            complete_for_plan_retrieval: true,
+            detail: "full_plan_document",
+            storage_ownership: "owning_active_or_archived_plan_file",
+        },
+    };
+}
+//# sourceMappingURL=planRetrieval.js.map

package/dist/state/planRetrieval.js.map

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

package/dist/state/planTaskRetrieval.js

@@ -0,0 +1,285 @@
+import { createHash, createHmac, timingSafeEqual } from "node:crypto";
+import path from "node:path";
+import YAML from "yaml";
+import { canonicalRecordJson } from "./archiveDiscovery.js";
+import { StateRetrievalFailure } from "./directRetrieval.js";
+import { PLAN_ID } from "./planIdentity.js";
+import { discoverPlanArtifacts, planDocumentParts } from "../cli/planArtifacts.js";
+const CURSOR_VERSION = 1;
+const ORDER = "task_number_asc";
+const MAX_LIST_BYTES = 32_768;
+function hash(value) {
+    return createHash("sha256").update(canonicalRecordJson(value), "utf8").digest("hex");
+}
+function fail(exitCode, className, message, verb, details = {}) {
+    const syntax = verb === "list"
+        ? "agentera state plan tasks list [--plan PLAN_ID] [--limit N] [--cursor TOKEN] --format json"
+        : "agentera state plan tasks get [--plan PLAN_ID] --task N --format json";
+    const example = verb === "list"
+        ? "agentera state plan tasks list --limit 20 --format json"
+        : "agentera state plan tasks get --task 1 --format json";
+    return new StateRetrievalFailure({
+        schemaVersion: "agentera.stateFailure.v1",
+        status: "fail",
+        error: {
+            class: className,
+            message,
+            syntax,
+            example,
+            recovery: details.recovery ?? "Correct the command using one of the valid forms and retry; no state was changed.",
+            valid_values: verb === "list"
+                ? ["list", "--plan PLAN_ID", "--limit 1..100", "--cursor TOKEN", "--format text|json|yaml"]
+                : ["get", "--task N", "--plan PLAN_ID", "--format text|json|yaml"],
+            ...details,
+        },
+    }, exitCode);
+}
+function activePlan(activePath, selectedPlan, verb) {
+    if (selectedPlan !== undefined && !PLAN_ID.test(selectedPlan)) {
+        throw fail(2, "invalid_request", `invalid plan identity '${selectedPlan}'`, verb, {
+            valid_values: ["plan:<lowercase-rfc9562-uuid>", "legacy-plan:<64-lowercase-hex-digest>"],
+        });
+    }
+    const discovery = discoverPlanArtifacts(activePath);
+    if (!discovery.active) {
+        const diagnostic = discovery.diagnostics.find((entry) => entry.path === activePath && entry.category !== "legacy");
+        if (diagnostic) {
+            throw fail(1, "corrupt", `active plan cannot be read: ${diagnostic.message}`, verb, {
+                recovery: "Repair the active file-based plan, then retry; archived plan retrieval is a separate command family.",
+                details: { path: activePath, category: diagnostic.category },
+            });
+        }
+        throw fail(1, "not_found", "no active file-based plan exists", verb, {
+            recovery: "Create or restore an active plan, then retry the plan task command.",
+            details: { path: activePath },
+        });
+    }
+    const artifact = discovery.active;
+    const parts = planDocumentParts(artifact.data);
+    const identity = discovery.identities.find((candidate) => candidate.artifact.path === artifact.path);
+    if (!identity) {
+        throw fail(1, "corrupt", "active plan header.id is not a valid plan identity", verb, {
+            recovery: "Repair the persisted active-plan identity before listing or fetching its tasks.",
+            details: { path: artifact.path, plan_id: parts.header.id ?? null },
+        });
+    }
+    const planId = identity.stableId;
+    if (identity.ambiguous) {
+        throw fail(1, "ambiguous", `plan identity '${planId}' resolves to different plan documents`, verb, {
+            stable_id: planId,
+            recovery: "Repair the identity collision; Agentera will not choose a plan by path, mtime, or discovery order.",
+            details: { candidate_paths: identity.provenancePaths },
+        });
+    }
+    if (selectedPlan !== undefined && selectedPlan !== planId) {
+        throw fail(1, "not_found", `active plan '${selectedPlan}' was not found`, verb, {
+            stable_id: selectedPlan,
+            recovery: `Use the active plan '${planId}', or omit --plan; archived plan retrieval is not part of this command.`,
+        });
+    }
+    const seen = new Set();
+    const tasks = parts.tasks.map((record) => {
+        const number = record.number;
+        if (!Number.isSafeInteger(number) || Number(number) < 1 || seen.has(Number(number))) {
+            throw fail(1, "corrupt", "active plan tasks require unique positive integer numbers", verb, {
+                recovery: "Repair duplicate or invalid task numbers in the active plan, then retry.",
+                details: { path: artifact.path, task_number: number ?? null },
+            });
+        }
+        seen.add(Number(number));
+        return { number: Number(number), record };
+    }).sort((left, right) => left.number - right.number);
+    return {
+        artifact,
+        planId,
+        compatibility: identity.persisted ? "complete" : "degraded",
+        tasks,
+        provenancePaths: identity.provenancePaths,
+    };
+}
+function snapshotId(planId, tasks) {
+    return hash({ collection: "plan.tasks", plan_id: planId, order: ORDER, tasks });
+}
+function cursorKey(projectRoot) {
+    return createHash("sha256").update(`agentera-plan-task-cursor\0${path.resolve(projectRoot)}`, "utf8").digest();
+}
+function sign(payload, projectRoot) {
+    return createHmac("sha256", cursorKey(projectRoot)).update(canonicalRecordJson(payload), "utf8").digest("hex");
+}
+function encodeCursor(payload, projectRoot) {
+    return Buffer.from(JSON.stringify({ ...payload, signature: sign(payload, projectRoot) }), "utf8").toString("base64url");
+}
+function parseCursor(token, projectRoot, selectedPlan) {
+    const invalid = (message) => {
+        throw fail(2, "cursor_invalid", message, "list", {
+            recovery: "Copy response.next_cursor exactly, or omit --cursor to establish a new active-plan snapshot.",
+            details: { cursor: "opaque; do not parse or construct cursor tokens" },
+        });
+    };
+    if (!token || token.length > 100_000 || !/^[A-Za-z0-9_-]+$/.test(token))
+        invalid("cursor is not a valid opaque token");
+    let decoded;
+    try {
+        const bytes = Buffer.from(token, "base64url");
+        if (bytes.toString("base64url") !== token)
+            invalid("cursor is not a canonical opaque token");
+        decoded = JSON.parse(bytes.toString("utf8"));
+    }
+    catch {
+        invalid("cursor is not a valid opaque token");
+    }
+    if (decoded === null || typeof decoded !== "object" || Array.isArray(decoded))
+        invalid("cursor payload is invalid");
+    const signed = decoded;
+    const signature = signed.signature;
+    const payload = { ...signed };
+    delete payload.signature;
+    if (typeof signature !== "string" || !/^[0-9a-f]{64}$/.test(signature))
+        invalid("cursor signature is missing or malformed");
+    const signatureString = signature;
+    const expected = sign(payload, projectRoot);
+    if (!timingSafeEqual(Buffer.from(signatureString, "hex"), Buffer.from(expected, "hex")))
+        invalid("cursor signature is invalid");
+    const parsed = payload;
+    if (parsed.version !== CURSOR_VERSION || parsed.collection !== "plan.tasks" || !PLAN_ID.test(parsed.plan_id) ||
+        parsed.order !== ORDER || !/^[0-9a-f]{64}$/.test(parsed.snapshot_id) ||
+        !Number.isSafeInteger(parsed.candidate_count) || parsed.candidate_count < 1 ||
+        !Number.isSafeInteger(parsed.candidate_max) || parsed.candidate_max < 1 ||
+        !Number.isSafeInteger(parsed.after) || parsed.after < 1 || parsed.after > parsed.candidate_max)
+        invalid("cursor is bound to a different plan task list or has an invalid payload");
+    if (selectedPlan !== undefined && parsed.plan_id !== selectedPlan) {
+        invalid("cursor is bound to a different explicit plan selector");
+    }
+    return parsed;
+}
+function taskEntry(plan, task) {
+    const get = `agentera state plan tasks get --task ${task.number} --format json`;
+    return {
+        stable_id: `${plan.planId}/task:${task.number}`,
+        addressable: true,
+        task_number: task.number,
+        detail_availability: "full",
+        compatibility: plan.compatibility,
+        provenance: {
+            storage: "active_plan_file",
+            path: plan.artifact.path,
+            lifecycle_position: "active",
+            plan_id: plan.planId,
+            ...(plan.provenancePaths.length > 1 ? { mirrored_paths: plan.provenancePaths } : {}),
+        },
+        retrieval: { get },
+        record: task.record,
+    };
+}
+function baseList(plan, snapshotTasks, pageTasks, projectRoot) {
+    const snapshot = snapshotId(plan.planId, snapshotTasks);
+    const entries = pageTasks.map((task) => taskEntry(plan, task));
+    return {
+        schemaVersion: "agentera.stateRetrieval.v1",
+        command: "state plan tasks list",
+        status: plan.compatibility === "complete" ? "ok" : "degraded",
+        entries,
+        counts: { total: snapshotTasks.length, returned: entries.length, remaining: 0, omitted: 0 },
+        order: ORDER,
+        filters: { plan: plan.planId },
+        snapshot: { id: snapshot, candidate_count: snapshotTasks.length, has_more: false },
+        source: { artifact: "plan", active: true, path: plan.artifact.path, plan_id: plan.planId, storage: "active_plan_file" },
+        source_contract: {
+            authority: "references/artifacts/state-storage-authority.yaml",
+            complete_for_plan_task_retrieval: true,
+            storage_ownership: "owning_active_plan_file",
+            cursor: "opaque_snapshot_cursor",
+        },
+        retrieval: { get: "agentera state plan tasks get --task N --format json" },
+    };
+}
+function withPage(plan, snapshotTasks, candidates, retained, projectRoot, reason) {
+    const selected = candidates.slice(0, retained);
+    const remaining = candidates.length - selected.length;
+    const response = baseList(plan, snapshotTasks, selected, projectRoot);
+    response.counts = { total: snapshotTasks.length, returned: selected.length, remaining, omitted: remaining };
+    response.snapshot = { ...response.snapshot, has_more: remaining > 0 };
+    if (remaining > 0 && selected.length > 0) {
+        const last = selected.at(-1);
+        const token = encodeCursor({
+            version: CURSOR_VERSION,
+            collection: "plan.tasks",
+            plan_id: plan.planId,
+            order: ORDER,
+            snapshot_id: snapshotId(plan.planId, snapshotTasks),
+            candidate_count: snapshotTasks.length,
+            candidate_max: snapshotTasks.at(-1).number,
+            after: last.number,
+        }, projectRoot);
+        response.next_cursor = token;
+        response.omitted = true;
+        response.omitted_count = remaining;
+        response.omission_reason = reason;
+        response.retrieval = {
+            continue: `agentera state plan tasks list --cursor ${token} --format json`,
+            get: "agentera state plan tasks get --task N --format json",
+        };
+    }
+    return response;
+}
+export function listPlanTasks(projectRoot, activePath, options) {
+    if (!Number.isSafeInteger(options.limit) || options.limit < 1 || options.limit > 100) {
+        throw fail(2, "invalid_request", "task list limit must be an integer from 1 through 100", "list", {
+            valid_values: ["1..100"],
+        });
+    }
+    const parsed = options.cursor ? parseCursor(options.cursor, projectRoot, options.plan) : undefined;
+    const plan = activePlan(activePath, options.plan, "list");
+    if (parsed && parsed.plan_id !== plan.planId) {
+        throw fail(1, "cursor_snapshot_unavailable", "the cursor plan identity is no longer the active plan snapshot", "list", {
+            recovery: "Start a new task listing without --cursor to establish the current active-plan snapshot.",
+            details: { cursor_plan_id: parsed.plan_id, current_plan_id: plan.planId },
+        });
+    }
+    const snapshotTasks = parsed ? plan.tasks.filter((task) => task.number <= parsed.candidate_max) : plan.tasks;
+    if (parsed && (snapshotTasks.length !== parsed.candidate_count || snapshotId(plan.planId, snapshotTasks) !== parsed.snapshot_id)) {
+        throw fail(1, "cursor_snapshot_unavailable", "the active plan task snapshot changed and cannot be resumed exactly", "list", {
+            recovery: "Start a new task listing without --cursor to establish the current active-plan snapshot.",
+            details: { snapshot_id: parsed.snapshot_id, current_snapshot_id: snapshotId(plan.planId, snapshotTasks) },
+        });
+    }
+    const candidates = snapshotTasks.filter((task) => task.number > (parsed?.after ?? 0));
+    const requested = Math.min(options.limit, candidates.length);
+    let response = withPage(plan, snapshotTasks, candidates, requested, projectRoot, "page_limit");
+    if (options.format === "json" || options.format === "yaml") {
+        const serializedBytes = (value) => Buffer.byteLength(options.format === "yaml" ? YAML.stringify(value) : JSON.stringify(value, null, 2) + "\n", "utf8");
+        for (let retained = requested; retained > 0 && serializedBytes(response) > MAX_LIST_BYTES; retained -= 1) {
+            response = withPage(plan, snapshotTasks, candidates, retained - 1, projectRoot, "serialized_output_byte_budget");
+        }
+        if (serializedBytes(response) > MAX_LIST_BYTES || (candidates.length > 0 && response.entries.length === 0)) {
+            throw fail(1, "unsupported_state", `one task cannot fit within the ${MAX_LIST_BYTES}-byte ${options.format.toUpperCase()} list budget`, "list", {
+                recovery: "Fetch the task directly with agentera state plan tasks get --task N --format json.",
+            });
+        }
+    }
+    return response;
+}
+export function getPlanTask(projectRoot, activePath, taskNumber, selectedPlan) {
+    const plan = activePlan(activePath, selectedPlan, "get");
+    const task = plan.tasks.find((candidate) => candidate.number === taskNumber);
+    if (!task) {
+        throw fail(1, "not_found", `task ${taskNumber} was not found in active plan '${plan.planId}'`, "get", {
+            stable_id: `${plan.planId}/task:${taskNumber}`,
+            entry_number: taskNumber,
+            recovery: "List valid active-plan task numbers with agentera state plan tasks list --format json, then retry.",
+        });
+    }
+    return {
+        schemaVersion: "agentera.stateRetrieval.v1",
+        command: "state plan tasks get",
+        status: "ok",
+        entry: taskEntry(plan, task),
+        source: { artifact: "plan", active: true, path: plan.artifact.path, plan_id: plan.planId, storage: "active_plan_file" },
+        source_contract: {
+            authority: "references/artifacts/state-storage-authority.yaml",
+            complete_for_plan_task_retrieval: true,
+            storage_ownership: "owning_active_plan_file",
+        },
+    };
+}
+//# sourceMappingURL=planTaskRetrieval.js.map