@bluewombat/slot-kit 0.1.0

package/dist/finish.js

@@ -0,0 +1,67 @@
+import { readResult } from "./agent.js";
+import { emitFailure } from "./emit.js";
+/**
+ * Failures no further Attempt can fix: the CLI is not usable as invoked.
+ * Everything else is the agent's work failing, which is what Attempts are for.
+ */
+const BLOCKING = [
+    /not (logged in|authenticated)|please (log ?in|sign ?in)|\blogin\b|unauthori[sz]ed|forbidden/i,
+    /failed to authenticate|authentication failed|oauth|session expired|token expired/i,
+    /invalid api key|missing api key|api key not/i,
+    /credit balance|usage limit reached/i,
+    /unknown (option|argument|flag|command)|unrecogni[sz]ed (option|argument)|^usage:/im,
+    /unknown model|unsupported model|no such model/i,
+];
+/**
+ * How a finished run reads: what to answer, and the report to answer it with.
+ *
+ * Separate from `finishRun` because the classification is the part worth
+ * checking, and `finishRun` ends the process.
+ */
+export function failureOf(run, bin, name) {
+    if (run.error !== undefined) {
+        return {
+            outcome: "fail-blocking",
+            report: `Could not start ${name} at ${bin}: ${run.error.message}`,
+        };
+    }
+    const detail = failureDetail(run, readResult(run.stdout), name);
+    return {
+        outcome: BLOCKING.some((pattern) => pattern.test(detail)) ? "fail-blocking" : "fail-retryable",
+        report: detail,
+    };
+}
+/**
+ * Answer the Builder contract for a finished run, then leave.
+ *
+ * Every agent Builder ends here so they classify the same way: exit 0 is a
+ * completed pass, and everything else is `fail-blocking` when the CLI itself is
+ * unusable, `fail-retryable` when the agent failed at the work.
+ */
+export function finishRun({ run, bin, name }) {
+    if (run.error === undefined && run.code === 0 && readResult(run.stdout)?.is_error !== true) {
+        process.exit(0);
+    }
+    const failure = failureOf(run, bin, name);
+    emitFailure(failure.outcome, failure.report);
+    process.exit(1);
+}
+function failureDetail(run, result, name) {
+    if (result !== undefined) {
+        for (const field of ["error", "message", "result"]) {
+            const value = result[field];
+            if (typeof value === "string" && value.trim().length > 0) {
+                return value.trim().slice(-2000);
+            }
+        }
+    }
+    const output = run.output.trim();
+    if (output.length > 0) {
+        return output.slice(-2000);
+    }
+    if (run.signal !== null && run.signal !== undefined) {
+        return `${name} was killed by ${run.signal}.`;
+    }
+    return `${name} exited ${run.code} without output.`;
+}
+//# sourceMappingURL=finish.js.map

package/dist/finish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"finish.js","sourceRoot":"","sources":["../src/finish.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC;;;GAGG;AACH,MAAM,QAAQ,GAAG;IACf,8FAA8F;IAC9F,mFAAmF;IACnF,8CAA8C;IAC9C,qCAAqC;IACrC,oFAAoF;IACpF,gDAAgD;CACjD,CAAC;AAIF;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CACvB,GAAa,EACb,GAAW,EACX,IAAY;IAEZ,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO;YACL,OAAO,EAAE,eAAe;YACxB,MAAM,EAAE,mBAAmB,IAAI,OAAO,GAAG,KAAK,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE;SAClE,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,EAAE,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC;IAChE,OAAO;QACL,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,gBAAgB;QAC9F,MAAM,EAAE,MAAM;KACf,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAe;IACvD,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,QAAQ,KAAK,IAAI,EAAE,CAAC;QAC3F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IAC1C,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,SAAS,aAAa,CACpB,GAAa,EACb,MAA2C,EAC3C,IAAY;IAEZ,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,KAAK,MAAM,KAAK,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,CAAC;YACnD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzD,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;IACH,CAAC;IACD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACjC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,KAAK,IAAI,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACpD,OAAO,GAAG,IAAI,kBAAkB,GAAG,CAAC,MAAM,GAAG,CAAC;IAChD,CAAC;IACD,OAAO,GAAG,IAAI,WAAW,GAAG,CAAC,IAAI,kBAAkB,CAAC;AACtD,CAAC"}

package/dist/glob.d.ts

@@ -0,0 +1,3 @@
+/** Path glob: `*` one segment, `**` any depth. */
+export declare function pathMatchesGlob(path: string, pattern: string): boolean;
+//# sourceMappingURL=glob.d.ts.map

package/dist/glob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.d.ts","sourceRoot":"","sources":["../src/glob.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAkCtE"}

package/dist/glob.js

@@ -0,0 +1,37 @@
+/** Path glob: `*` one segment, `**` any depth. */
+export function pathMatchesGlob(path, pattern) {
+    const posix = path.replaceAll("\\", "/");
+    let source = "^";
+    const spec = pattern.replaceAll("\\", "/");
+    for (let i = 0; i < spec.length;) {
+        if (spec.startsWith("**/", i)) {
+            source += "(?:.*/)?";
+            i += 3;
+            continue;
+        }
+        if (spec.startsWith("**", i) && i + 2 === spec.length) {
+            source += ".*";
+            i += 2;
+            continue;
+        }
+        const char = spec[i];
+        if (char === undefined) {
+            break;
+        }
+        if (char === "*") {
+            source += "[^/]*";
+            i += 1;
+            continue;
+        }
+        if (char === "?") {
+            source += "[^/]";
+            i += 1;
+            continue;
+        }
+        source += char.replace(/[.+^${}()|[\]\\]/g, "\\$&");
+        i += 1;
+    }
+    source += "$";
+    return new RegExp(source).test(posix);
+}
+//# sourceMappingURL=glob.js.map

package/dist/glob.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.js","sourceRoot":"","sources":["../src/glob.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,OAAe;IAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACzC,IAAI,MAAM,GAAG,GAAG,CAAC;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,GAAI,CAAC;QAClC,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,UAAU,CAAC;YACrB,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;YACtD,MAAM,IAAI,IAAI,CAAC;YACf,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM;QACR,CAAC;QACD,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,MAAM,IAAI,OAAO,CAAC;YAClB,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,MAAM,IAAI,MAAM,CAAC;YACjB,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QACD,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;QACpD,CAAC,IAAI,CAAC,CAAC;IACT,CAAC;IACD,MAAM,IAAI,GAAG,CAAC;IACd,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACxC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * What a slot needs to answer the Transformer that spawned it.
+ *
+ * A slot is an opaque command: Implementer spawns a Builder and its Gates,
+ * FeatureBreakdown spawns a Planner, and each one reads argv and writes one
+ * JSON line on stdout. Nothing here is required to fill a slot — a shell script
+ * that prints the right line is a Gate. This is the plumbing that every slot
+ * written in Node would otherwise write again.
+ */
+export type { AgentInvocation, AgentRun, SerializedRun } from "./agent.js";
+export { deserializeRun, findExecutable, readResult, runAgent, serializeRun } from "./agent.js";
+export { BUILDER_FLAGS, GATE_FLAGS, MESSAGE_FLAGS, ownArgv, PLANNER_FLAGS, PUBLISHER_FLAGS, REFRESHER_FLAGS, splitRunner, stageOf, take, } from "./argv.js";
+export type { Failure, Verdict, Write } from "./emit.js";
+export { emitFailure, emitMessage, emitPlan, emitPublication, emitPublishRefusal, emitRefreshed, emitRefreshRefusal, emitRefusal, emitVerdict, } from "./emit.js";
+export type { FinishedRun } from "./finish.js";
+export { failureOf, finishRun } from "./finish.js";
+export { pathMatchesGlob } from "./glob.js";
+export type { OptionRule, OptionSpec, OptionValues, ParsedOptions } from "./options.js";
+export { listOption, parseOptions, textOption } from "./options.js";
+export type { CheckedPlan, PlanSubtask } from "./plan.js";
+export { checkPlan } from "./plan.js";
+export type { ReadTemplate, Rendered, TranscriptSubject } from "./prompt.js";
+export { AGENT_OPTIONS, PROMPT_RULES, readAgentPrompt, readTemplate, renderPrompt, transcriptFor, } from "./prompt.js";
+export type { AgentAbout, ParsedRole, SpawnedAgent, TranscriptExtras } from "./role.js";
+export { fillPrompt, loadPrompt, loadRules, parseRole, ROLE_OPTIONS, spawnFilled, transcriptArgs, } from "./role.js";
+export type { Transcript, TranscriptPart, TranscriptSpec } from "./transcript.js";
+export { openTranscript, TRANSCRIPT_PARTS } from "./transcript.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":"AAAA;;;;;;;;GAQG;AAEH,YAAY,EAAE,eAAe,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAChG,OAAO,EACL,aAAa,EACb,UAAU,EACV,aAAa,EACb,OAAO,EACP,aAAa,EACb,eAAe,EACf,eAAe,EACf,WAAW,EACX,OAAO,EACP,IAAI,GACL,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EACL,WAAW,EACX,WAAW,EACX,QAAQ,EACR,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,kBAAkB,EAClB,WAAW,EACX,WAAW,GACZ,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACxF,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACpE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC7E,OAAO,EACL,aAAa,EACb,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACxF,OAAO,EACL,UAAU,EACV,UAAU,EACV,SAAS,EACT,SAAS,EACT,YAAY,EACZ,WAAW,EACX,cAAc,GACf,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+/**
+ * What a slot needs to answer the Transformer that spawned it.
+ *
+ * A slot is an opaque command: Implementer spawns a Builder and its Gates,
+ * FeatureBreakdown spawns a Planner, and each one reads argv and writes one
+ * JSON line on stdout. Nothing here is required to fill a slot — a shell script
+ * that prints the right line is a Gate. This is the plumbing that every slot
+ * written in Node would otherwise write again.
+ */
+export { deserializeRun, findExecutable, readResult, runAgent, serializeRun } from "./agent.js";
+export { BUILDER_FLAGS, GATE_FLAGS, MESSAGE_FLAGS, ownArgv, PLANNER_FLAGS, PUBLISHER_FLAGS, REFRESHER_FLAGS, splitRunner, stageOf, take, } from "./argv.js";
+export { emitFailure, emitMessage, emitPlan, emitPublication, emitPublishRefusal, emitRefreshed, emitRefreshRefusal, emitRefusal, emitVerdict, } from "./emit.js";
+export { failureOf, finishRun } from "./finish.js";
+export { pathMatchesGlob } from "./glob.js";
+export { listOption, parseOptions, textOption } from "./options.js";
+export { checkPlan } from "./plan.js";
+export { AGENT_OPTIONS, PROMPT_RULES, readAgentPrompt, readTemplate, renderPrompt, transcriptFor, } from "./prompt.js";
+export { fillPrompt, loadPrompt, loadRules, parseRole, ROLE_OPTIONS, spawnFilled, transcriptArgs, } from "./role.js";
+export { openTranscript, TRANSCRIPT_PARTS } from "./transcript.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;;;;;;;;GAQG;AAGH,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAChG,OAAO,EACL,aAAa,EACb,UAAU,EACV,aAAa,EACb,OAAO,EACP,aAAa,EACb,eAAe,EACf,eAAe,EACf,WAAW,EACX,OAAO,EACP,IAAI,GACL,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,WAAW,EACX,WAAW,EACX,QAAQ,EACR,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,kBAAkB,EAClB,WAAW,EACX,WAAW,GACZ,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAEpE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EACL,aAAa,EACb,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,UAAU,EACV,UAAU,EACV,SAAS,EACT,SAAS,EACT,YAAY,EACZ,WAAW,EACX,cAAc,GACf,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/options.d.ts

@@ -0,0 +1,36 @@
+export type OptionRule = {
+    /** Collect every occurrence instead of keeping the last. */
+    many?: boolean | undefined;
+    /** Takes no value: its presence is the value. */
+    flag?: boolean | undefined;
+    /** The only values accepted. */
+    choices?: readonly string[] | undefined;
+    /** Used when the Project gave none. */
+    fallback?: string | undefined;
+};
+/** Keyed by the flag as written, e.g. `"--model"`. */
+export type OptionSpec = Record<string, OptionRule>;
+/** Keyed by the flag in camel case, e.g. `model` for `--model`. */
+export type OptionValues = Record<string, string | string[] | boolean | undefined>;
+export type ParsedOptions = {
+    ok: true;
+    values: OptionValues;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * Read a slot's own options from a spec of flags.
+ *
+ * `{ many: true }` collects a repeatable flag, `{ choices }` validates, and a
+ * flag not in the spec is refused rather than passed on: an option meant for
+ * the agent CLI that lands here is a config mistake, and a silent one costs a
+ * whole run. Keys are the flag name in camel case, and `name` is how the slot
+ * calls itself in that refusal.
+ */
+export declare function parseOptions(tokens: readonly string[], spec: OptionSpec, name: string): ParsedOptions;
+/** The value of a one-shot flag, or nothing: a `many` or `flag` option is not text. */
+export declare function textOption(values: OptionValues, key: string): string | undefined;
+/** Every value of a `many` flag; empty for anything else. */
+export declare function listOption(values: OptionValues, key: string): string[];
+//# sourceMappingURL=options.d.ts.map

package/dist/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG;IACvB,4DAA4D;IAC5D,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,iDAAiD;IACjD,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,gCAAgC;IAChC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACxC,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B,CAAC;AAEF,sDAAsD;AACtD,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAEpD,mEAAmE;AACnE,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;AAEnF,MAAM,MAAM,aAAa,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/F;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,MAAM,GACX,aAAa,CAwCf;AAaD,uFAAuF;AACvF,wBAAgB,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGhF;AAED,6DAA6D;AAC7D,wBAAgB,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAGtE"}

package/dist/options.js

@@ -0,0 +1,72 @@
+/**
+ * Read a slot's own options from a spec of flags.
+ *
+ * `{ many: true }` collects a repeatable flag, `{ choices }` validates, and a
+ * flag not in the spec is refused rather than passed on: an option meant for
+ * the agent CLI that lands here is a config mistake, and a silent one costs a
+ * whole run. Keys are the flag name in camel case, and `name` is how the slot
+ * calls itself in that refusal.
+ */
+export function parseOptions(tokens, spec, name) {
+    const values = {};
+    for (const [flag, rule] of Object.entries(spec)) {
+        if (rule.many === true) {
+            values[optionKey(flag)] = [];
+        }
+        else if (rule.fallback !== undefined) {
+            values[optionKey(flag)] = rule.fallback;
+        }
+    }
+    for (let i = 0; i < tokens.length; i++) {
+        const token = tokens[i];
+        if (token === undefined) {
+            continue;
+        }
+        const rule = spec[token];
+        if (rule === undefined) {
+            return { ok: false, reason: `The ${name} does not take "${token}".` };
+        }
+        if (rule.flag === true) {
+            values[optionKey(token)] = true;
+            continue;
+        }
+        const value = tokens[i + 1];
+        if (value === undefined) {
+            return { ok: false, reason: `The ${name} needs a value after ${token}.` };
+        }
+        i += 1;
+        if (rule.choices !== undefined && !rule.choices.includes(value)) {
+            return { ok: false, reason: `${token} is ${orList(rule.choices)}, not "${value}".` };
+        }
+        if (rule.many === true) {
+            const collected = values[optionKey(token)];
+            if (Array.isArray(collected)) {
+                collected.push(value);
+            }
+        }
+        else {
+            values[optionKey(token)] = value;
+        }
+    }
+    return { ok: true, values };
+}
+function optionKey(flag) {
+    return flag.slice(2).replace(/-([a-z])/g, (_, letter) => letter.toUpperCase());
+}
+function orList(choices) {
+    if (choices.length < 2) {
+        return `${choices[0]}`;
+    }
+    return `${choices.slice(0, -1).join(", ")} or ${choices.at(-1)}`;
+}
+/** The value of a one-shot flag, or nothing: a `many` or `flag` option is not text. */
+export function textOption(values, key) {
+    const value = values[key];
+    return typeof value === "string" ? value : undefined;
+}
+/** Every value of a `many` flag; empty for anything else. */
+export function listOption(values, key) {
+    const value = values[key];
+    return Array.isArray(value) ? value : [];
+}
+//# sourceMappingURL=options.js.map

package/dist/options.js.map

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

package/dist/plan.d.ts

@@ -0,0 +1,23 @@
+export type PlanSubtask = {
+    id: string;
+    intention: string;
+    definition_of_done: string;
+    depends_on: string[];
+};
+export type CheckedPlan = {
+    ok: true;
+    subtasks: PlanSubtask[];
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * Whether this is a Plan the rest of the system can act on — and, when it is,
+ * the subtasks typed as one.
+ *
+ * Checked here rather than trusted, because a Planner that hands back a broken
+ * graph has failed at its one job, and the failure should read as this slot's,
+ * not as a refusal of the feature.
+ */
+export declare function checkPlan(subtasks: unknown, maxUnits?: number): CheckedPlan;
+//# sourceMappingURL=plan.d.ts.map

package/dist/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../src/plan.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,WAAW,EAAE,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhG;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,WAAW,CAkD3E"}

package/dist/plan.js

@@ -0,0 +1,94 @@
+/**
+ * Whether this is a Plan the rest of the system can act on — and, when it is,
+ * the subtasks typed as one.
+ *
+ * Checked here rather than trusted, because a Planner that hands back a broken
+ * graph has failed at its one job, and the failure should read as this slot's,
+ * not as a refusal of the feature.
+ */
+export function checkPlan(subtasks, maxUnits) {
+    if (!Array.isArray(subtasks) || subtasks.length === 0) {
+        return { ok: false, reason: "The plan has no subtasks." };
+    }
+    if (maxUnits !== undefined && Number.isInteger(maxUnits) && subtasks.length > maxUnits) {
+        return {
+            ok: false,
+            reason: `The plan has ${subtasks.length} subtasks, over the ${maxUnits} allowed.`,
+        };
+    }
+    const ids = new Set();
+    for (const subtask of subtasks) {
+        if (subtask === null || typeof subtask !== "object") {
+            return { ok: false, reason: "A subtask is not an object." };
+        }
+        const record = subtask;
+        for (const field of ["id", "intention", "definition_of_done"]) {
+            const value = record[field];
+            if (typeof value !== "string" || value.trim().length === 0) {
+                return { ok: false, reason: `A subtask has no "${field}".` };
+            }
+        }
+        const id = record.id;
+        if (ids.has(id)) {
+            return { ok: false, reason: `Two subtasks share the id "${id}".` };
+        }
+        ids.add(id);
+        if (!Array.isArray(record.depends_on)) {
+            return { ok: false, reason: `Subtask "${id}" has no depends_on list.` };
+        }
+    }
+    const plan = subtasks;
+    for (const subtask of plan) {
+        for (const dependency of subtask.depends_on) {
+            if (dependency === subtask.id) {
+                return { ok: false, reason: `Subtask "${subtask.id}" depends on itself.` };
+            }
+            if (!ids.has(dependency)) {
+                return {
+                    ok: false,
+                    reason: `Subtask "${subtask.id}" depends on "${dependency}", which is not in the plan.`,
+                };
+            }
+        }
+    }
+    const cycle = findCycle(plan);
+    if (cycle !== undefined) {
+        return { ok: false, reason: `The plan has a cycle: ${cycle.join(" → ")}.` };
+    }
+    return { ok: true, subtasks: plan };
+}
+/** Depth-first, so the answer names the loop rather than only reporting one. */
+function findCycle(subtasks) {
+    const edges = new Map(subtasks.map((subtask) => [subtask.id, subtask.depends_on]));
+    const done = new Set();
+    const path = [];
+    const open = new Set();
+    const walk = (id) => {
+        if (done.has(id)) {
+            return undefined;
+        }
+        if (open.has(id)) {
+            return [...path.slice(path.indexOf(id)), id];
+        }
+        open.add(id);
+        path.push(id);
+        for (const next of edges.get(id) ?? []) {
+            const found = walk(next);
+            if (found !== undefined) {
+                return found;
+            }
+        }
+        path.pop();
+        open.delete(id);
+        done.add(id);
+        return undefined;
+    };
+    for (const subtask of subtasks) {
+        const found = walk(subtask.id);
+        if (found !== undefined) {
+            return found;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=plan.js.map

package/dist/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../src/plan.ts"],"names":[],"mappings":"AASA;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,QAAiB,EAAE,QAAiB;IAC5D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,2BAA2B,EAAE,CAAC;IAC5D,CAAC;IACD,IAAI,QAAQ,KAAK,SAAS,IAAI,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;QACvF,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,gBAAgB,QAAQ,CAAC,MAAM,uBAAuB,QAAQ,WAAW;SAClF,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,OAAO,IAAI,QAAqB,EAAE,CAAC;QAC5C,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YACpD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,6BAA6B,EAAE,CAAC;QAC9D,CAAC;QACD,MAAM,MAAM,GAAG,OAAkC,CAAC;QAClD,KAAK,MAAM,KAAK,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,oBAAoB,CAAC,EAAE,CAAC;YAC9D,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC3D,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,qBAAqB,KAAK,IAAI,EAAE,CAAC;YAC/D,CAAC;QACH,CAAC;QACD,MAAM,EAAE,GAAG,MAAM,CAAC,EAAY,CAAC;QAC/B,IAAI,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAChB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,8BAA8B,EAAE,IAAI,EAAE,CAAC;QACrE,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACZ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;YACtC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,2BAA2B,EAAE,CAAC;QAC1E,CAAC;IACH,CAAC;IACD,MAAM,IAAI,GAAG,QAAyB,CAAC;IACvC,KAAK,MAAM,OAAO,IAAI,IAAI,EAAE,CAAC;QAC3B,KAAK,MAAM,UAAU,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YAC5C,IAAI,UAAU,KAAK,OAAO,CAAC,EAAE,EAAE,CAAC;gBAC9B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,OAAO,CAAC,EAAE,sBAAsB,EAAE,CAAC;YAC7E,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBACzB,OAAO;oBACL,EAAE,EAAE,KAAK;oBACT,MAAM,EAAE,YAAY,OAAO,CAAC,EAAE,iBAAiB,UAAU,8BAA8B;iBACxF,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IACD,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,yBAAyB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;IAC9E,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AACtC,CAAC;AAED,gFAAgF;AAChF,SAAS,SAAS,CAAC,QAAgC;IACjD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACnF,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,MAAM,IAAI,GAAG,CAAC,EAAU,EAAwB,EAAE;QAChD,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACjB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/C,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACb,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACd,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC;YACvC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;YACzB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QACD,IAAI,CAAC,GAAG,EAAE,CAAC;QACX,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAChB,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACb,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC;IAEF,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC/B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/prompt.d.ts

@@ -0,0 +1,64 @@
+import { type OptionSpec, type OptionValues } from "./options.js";
+import { type Transcript } from "./transcript.js";
+/**
+ * The bounds of a Builder slot: what `{{rules}}` says unless the Project writes
+ * its own.
+ *
+ * The last three are not a matter of taste. The checks that run after the agent
+ * read the working tree of this one directory, so an agent that commits,
+ * stashes or writes elsewhere produces nothing they can see, and the pass is
+ * refused for having done nothing. A Project that replaces these keeps that
+ * obligation whether or not it repeats the words.
+ */
+export declare const PROMPT_RULES: string;
+export type Rendered = {
+    ok: true;
+    prompt: string;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * Fill a prompt template from a map of names the caller owns.
+ *
+ * An unknown name is refused rather than dropped: a typo that silently removes
+ * the task is a run spent on nothing. `required` names must appear in the
+ * template; an empty value still counts as placed. Blank lines an emptied
+ * placeholder leaves are collapsed.
+ */
+export declare function renderPrompt(template: string, values: Record<string, string>, required?: readonly string[]): Rendered;
+export type ReadTemplate = {
+    ok: true;
+    value: string;
+} | {
+    ok: false;
+    reason: string;
+};
+/** The file at `path`, or `fallback` when there is no path. */
+export declare function readTemplate(path: string | undefined, fallback: string, what?: string): ReadTemplate;
+/**
+ * Options every vendor agent CLI takes: the prompt is already filled, and
+ * nothing here is a placeholder.
+ */
+export declare const AGENT_OPTIONS: OptionSpec;
+/**
+ * The already-filled prompt an agent CLI was handed. `--prompt` and
+ * `--prompt-file` are the same text, two ways in; both, or neither, is a
+ * mistake. Nothing here interpolates.
+ */
+export declare function readAgentPrompt(options: OptionValues): {
+    ok: true;
+    prompt: string;
+} | {
+    ok: false;
+    reason: string;
+};
+export type TranscriptSubject = {
+    slot?: string | undefined;
+    bin?: string | undefined;
+    args?: readonly string[] | undefined;
+    prompt?: string | undefined;
+};
+/** The turn's transcript, filed under what this Task belongs to. */
+export declare function transcriptFor(argv: readonly string[], options: OptionValues, about: TranscriptSubject): Transcript;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,YAAY,EAAc,MAAM,cAAc,CAAC;AAC9E,OAAO,EAAoC,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEpF;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,QAab,CAAC;AAIb,MAAM,MAAM,QAAQ,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpF;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,QAAQ,GAAE,SAAS,MAAM,EAAO,GAC/B,QAAQ,CAyBV;AAED,MAAM,MAAM,YAAY,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvF,+DAA+D;AAC/D,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,QAAQ,EAAE,MAAM,EAChB,IAAI,SAAoB,GACvB,YAAY,CAqBd;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,UAY3B,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,YAAY,GACpB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAoB9D;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B,CAAC;AAEF,oEAAoE;AACpE,wBAAgB,aAAa,CAC3B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,iBAAiB,GACvB,UAAU,CAUZ"}

package/dist/prompt.js

@@ -0,0 +1,142 @@
+import { readFileSync } from "node:fs";
+import { take } from "./argv.js";
+import { textOption } from "./options.js";
+import { openTranscript, TRANSCRIPT_PARTS } from "./transcript.js";
+/**
+ * The bounds of a Builder slot: what `{{rules}}` says unless the Project writes
+ * its own.
+ *
+ * The last three are not a matter of taste. The checks that run after the agent
+ * read the working tree of this one directory, so an agent that commits,
+ * stashes or writes elsewhere produces nothing they can see, and the pass is
+ * refused for having done nothing. A Project that replaces these keeps that
+ * obligation whether or not it repeats the words.
+ */
+export const PROMPT_RULES = [
+    "- Work only inside this directory. Do not read or edit anything outside it.",
+    "- Follow the conventions already in this repository: its structure, its naming,",
+    "  its tests. Read the code around what you touch before you write.",
+    "- Change only what the task needs.",
+    "- If the project has checks of its own, run them and leave them passing.",
+    "- Nobody is watching this run and nobody will answer a question. Where the task",
+    "  is ambiguous, take the reading most consistent with the existing code, and say",
+    "  which one you took in your final message.",
+    "- Leave your work uncommitted in the working tree: do not commit, branch, stash,",
+    "  or reset. The changed files in this directory are the deliverable, and they are",
+    "  read back from here exactly as you leave them.",
+    "- Do not push, do not open a pull request, do not touch a remote.",
+].join("\n");
+const PLACEHOLDER = /\{\{\s*([a-z_]+)\s*\}\}/g;
+/**
+ * Fill a prompt template from a map of names the caller owns.
+ *
+ * An unknown name is refused rather than dropped: a typo that silently removes
+ * the task is a run spent on nothing. `required` names must appear in the
+ * template; an empty value still counts as placed. Blank lines an emptied
+ * placeholder leaves are collapsed.
+ */
+export function renderPrompt(template, values, required = []) {
+    const unknown = new Set();
+    const seen = new Set();
+    const filled = template.replace(PLACEHOLDER, (match, name) => {
+        const value = values[name];
+        if (value === undefined) {
+            unknown.add(name);
+            return match;
+        }
+        seen.add(name);
+        return value;
+    });
+    if (unknown.size > 0) {
+        return {
+            ok: false,
+            reason: `The prompt template uses {{${[...unknown].join("}}, {{")}}}, which is not a placeholder. Known: {{${Object.keys(values).join("}}, {{")}}}.`,
+        };
+    }
+    for (const name of required) {
+        if (!seen.has(name)) {
+            return { ok: false, reason: `The prompt template must place {{${name}}} somewhere.` };
+        }
+    }
+    return { ok: true, prompt: `${filled.replace(/\n{3,}/g, "\n\n").trim()}\n` };
+}
+/** The file at `path`, or `fallback` when there is no path. */
+export function readTemplate(path, fallback, what = "prompt template") {
+    if (path === undefined) {
+        return { ok: true, value: fallback };
+    }
+    let text;
+    try {
+        text = readFileSync(path, "utf8");
+    }
+    catch (error) {
+        return {
+            ok: false,
+            reason: `Cannot read the ${what} at ${path}: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+    // An empty file is a truncated one far more often than it is a deliberate
+    // silence, and a template with nothing in it wastes a whole run. A producing
+    // template must place `{{rules}}`; a Project that wants other rules writes
+    // them in a `--rules-file`.
+    if (text.trim().length === 0) {
+        return { ok: false, reason: `The ${what} at ${path} is empty.` };
+    }
+    return { ok: true, value: text };
+}
+/**
+ * Options every vendor agent CLI takes: the prompt is already filled, and
+ * nothing here is a placeholder.
+ */
+export const AGENT_OPTIONS = {
+    "--bin": {},
+    "--model": {},
+    "--output-format": { choices: ["json", "text", "stream-json"], fallback: "json" },
+    "--prompt": {},
+    "--prompt-file": {},
+    "--transcript-dir": {},
+    "--transcript-part": { many: true, choices: TRANSCRIPT_PARTS },
+    "--agent-arg": { many: true },
+    "--id": {},
+    "--attempt": {},
+    "--context": {},
+};
+/**
+ * The already-filled prompt an agent CLI was handed. `--prompt` and
+ * `--prompt-file` are the same text, two ways in; both, or neither, is a
+ * mistake. Nothing here interpolates.
+ */
+export function readAgentPrompt(options) {
+    const inline = textOption(options, "prompt");
+    const fromFile = textOption(options, "promptFile");
+    if (inline !== undefined && fromFile !== undefined) {
+        return { ok: false, reason: "Pass --prompt or --prompt-file, not both." };
+    }
+    if (inline !== undefined) {
+        if (inline.trim().length === 0) {
+            return { ok: false, reason: "The --prompt is empty." };
+        }
+        return { ok: true, prompt: inline };
+    }
+    if (fromFile === undefined) {
+        return { ok: false, reason: "The agent command needs --prompt or --prompt-file." };
+    }
+    const loaded = readTemplate(fromFile, "");
+    if (!loaded.ok) {
+        return loaded;
+    }
+    return { ok: true, prompt: loaded.value };
+}
+/** The turn's transcript, filed under what this Task belongs to. */
+export function transcriptFor(argv, options, about) {
+    const parts = options.transcriptPart;
+    return openTranscript({
+        dir: textOption(options, "transcriptDir"),
+        ...(Array.isArray(parts) && parts.length > 0 ? { parts } : {}),
+        context: take(argv, "--context"),
+        id: take(argv, "--id"),
+        attempt: take(argv, "--attempt"),
+        ...about,
+    });
+}
+//# sourceMappingURL=prompt.js.map