@hearsay-tools/squawk 0.0.0-stage → 0.17.0-dev.5682

package/dist/workflows/run/run-skills.d.ts

@@ -0,0 +1,114 @@
+import type { ContentBlock } from '../../core/agent-runner.ts';
+import type { Skill } from '../../skills.ts';
+import { atStepOpen } from './launch-read-resolver.ts';
+import type { ActiveRun } from '../active-run.ts';
+import type { RunModuleContext } from './types.ts';
+/** A live team record view. Shared catalog records remain owned by discovery. */
+export declare class SkillTeamView {
+    #private;
+    constructor(skill: Skill);
+    get repo(): string;
+    get ref(): string;
+    get path(): string;
+    get dir(): boolean;
+    get commit(): string | undefined;
+}
+/** Each getter reads the shared entry, without granting writes to that entry. */
+export declare class SkillView {
+    #private;
+    constructor(skill: Skill);
+    get name(): string;
+    get description(): string | undefined;
+    get interactive(): true | undefined;
+    get body(): string;
+    get path(): string;
+    get source(): Skill['source'];
+    get team(): SkillTeamView | undefined;
+}
+export declare class SkillsGroup {
+    #private;
+    constructor();
+    /** Registry snapshot used to expand `/skill` follow-ups before a backend can
+     *  mistake them for its own slash commands (hearsay-tools/cezarion#676). Only `RunSkills.loadRunSkills` writes it,
+     *  and only `RunSkills.enabledSkills` reads it. */
+    get catalog(): readonly SkillView[] | undefined;
+    /** The install a live `/name` started after its message went out (hearsay-tools/cezarion#1408); tests await it. */
+    get liveSkillProvisioning(): Promise<void> | undefined;
+}
+export declare function createSkillsGroup(): SkillsGroup;
+export type SkillReadPhase = 'step-open' | 'continue' | 'live-input';
+interface RunSkillsHost {
+    builtinSkills(): Skill[];
+    workerExecutionStopped(runId: string): boolean;
+    isCurrentState(runId: string, state: ActiveRun): boolean;
+    flushAgentInputs(runId: string): void;
+}
+export declare class RunSkills {
+    private readonly context;
+    private readonly host;
+    constructor(context: RunModuleContext, host: RunSkillsHost);
+    /** Every skill lookup in this manager goes through here, so the built-ins reach all of them. */
+    discoverSkills(phase?: 'task-head' | 'continue'): Promise<Skill[]>;
+    /**
+     * Load the run's skill registry: the ONLY writer of `state.skills.catalog` (hearsay-tools/cezarion#1806).
+     * `execute` and `runContinuation` both call it, once the run is registered and after the awaits
+     * that precede its first prompt. `'throw'` lets a failed discovery fail the run, as a fresh run
+     * always did; `'ignore'` keeps the registry the run already has, or none, because discovery must
+     * never break a Continue (open-mercato/cezar#811). An empty registry expands no `/skill` (it is not an error).
+     */
+    loadRunSkills(state: ActiveRun, onFailure: 'throw' | 'ignore'): Promise<void>;
+    /**
+     * The run's skill registry minus the project's off-list as it is now (hearsay-tools/cezarion#1494): the ONLY reader of
+     * `state.skills.catalog`. The registry is discovered when the run starts or continues, so a team skill
+     * switched off since then is still in `state.skills.catalog`; every prompt a step, a Continue or a live
+     * `/name` builds reads this instead. A caller that already read the off-list passes it as
+     * `disabled`, so that both see one list. A team source disabled since then
+     * (hearsay-tools/cezarion#279) drops its skills here too.
+     */
+    enabledSkills(state: ActiveRun, disabled?: ReturnType<typeof atStepOpen.disabledSkills>, phase?: SkillReadPhase): Skill[];
+    /**
+     * A live `/name` message already carries the skill's body, and `sendMessage` answers
+     * synchronously, so its files and companions install after the message went out (hearsay-tools/cezarion#1408).
+     * When anything new landed, or a team skill's files went to a cache copy the message could not
+     * name, one durable agent input says what and where. Whether a runner's native lookup sees a skill
+     * added mid-session is not relied on: that input is the delivery for every runner. Nothing
+     * new: no input. A run that stopped, or moved to another session, gets none.
+     */
+    provisionLiveSlashSkill(runId: string, state: ActiveRun, blocks: ContentBlock[]): void;
+    /**
+     * Provision the step skill and leading registry slash skill for start, Continue, recovery and
+     * live input, and at a step's start every registry skill its prompt names as a typed `/name`
+     * (hearsay-tools/cezarion#1672). Native slashes that are not registry skills install nothing.
+     *
+     * The run's OWN task worktree gets every root and the companions their bodies name
+     * (`provisionSkills`): links to local and global skills, generated `SKILL.md` files, and marked
+     * team copies, in `.claude/skills`, `.agents/skills` and `.cursor/skills`, recorded in the
+     * worktree's git dir and kept out of git by a worktree-local `.gitignore`. The project's
+     * off-list (`disabledTeamSkills`) is read fresh on every pass and applied to the saved
+     * registry, the roots and the team list alike: a team skill switched off for the project is
+     * never installed, not even for a skill that runs it, and a switch-off made after the run
+     * started holds for the next step, a live `/name` and Continue. Copies a pass installed before
+     * the switch stay in the worktree until the task ends: cezar removes nothing mid-task.
+     *
+     * Any other cwd — worktree off, a non-git project, a Continue whose worktree is gone — is the
+     * main checkout or unknown, where those directories are LOCAL skills to `discoverSkills` that
+     * would shadow the team source for every later run. A selected or leading-slash directory team
+     * root gets a per-commit cache copy there instead, and nothing else is installed: a skill only
+     * the prompt names gets nothing there, like a companion. So does a worktree where no copy of
+     * it landed, such as one whose three agent dirs all link out of it; one that took only some
+     * copies names the first that landed, since the runner's own dir may be the one skipped.
+     * Returns the step-start notes and, per team root, the directory its prompt must name.
+     */
+    provisionRunSkills(runId: string, state: ActiveRun, wanted: {
+        stepSkill?: string | undefined;
+        slash?: string | undefined;
+        prompt?: string;
+    }, phase?: SkillReadPhase): Promise<{
+        notes: string[];
+        filesDir: Map<string, string>;
+        installed: string[];
+    }>;
+    /** `cwd` is the run's recorded task worktree, and not the project root. Unresolvable means no. */
+    private isOwnTaskWorktree;
+}
+export {};

package/dist/workflows/run/run-skills.js

@@ -0,0 +1,233 @@
+import { randomUUID } from 'node:crypto';
+import { realpathSync } from 'node:fs';
+import { relative } from 'node:path';
+import { enqueueAgentInput } from '../../delegation/input.js';
+import { materializeSkillToCache, TEAM_SKILL_AGENT_DIRS } from '../../skills-remote.js';
+import { MAX_SKILL_CLOSURE, namesSkillCommand, provisionSkills } from '../../skills-provision.js';
+import { atStepOpen, atTaskHead, atContinue, atLiveInput } from './launch-read-resolver.js';
+import { leadingSlashSkillName } from './prompts.js';
+/** A live team record view. Shared catalog records remain owned by discovery. */
+export class SkillTeamView {
+    #skill;
+    constructor(skill) { this.#skill = skill; Object.freeze(this); }
+    get repo() { return this.#skill.team.repo; }
+    get ref() { return this.#skill.team.ref; }
+    get path() { return this.#skill.team.path; }
+    get dir() { return this.#skill.team.dir; }
+    get commit() { return this.#skill.team.commit; }
+}
+/** Each getter reads the shared entry, without granting writes to that entry. */
+export class SkillView {
+    #skill;
+    #team;
+    constructor(skill) {
+        this.#skill = skill;
+        this.#team = new SkillTeamView(skill);
+        Object.freeze(this);
+    }
+    get name() { return this.#skill.name; }
+    get description() { return this.#skill.description; }
+    get interactive() { return this.#skill.interactive; }
+    get body() { return this.#skill.body; }
+    get path() { return this.#skill.path; }
+    get source() { return this.#skill.source; }
+    get team() { return this.#skill.team ? this.#team : undefined; }
+}
+let skillsWrites;
+export class SkillsGroup {
+    #catalog;
+    #liveSkillProvisioning;
+    constructor() { Object.freeze(this); }
+    /** Registry snapshot used to expand `/skill` follow-ups before a backend can
+     *  mistake them for its own slash commands (hearsay-tools/cezarion#676). Only `RunSkills.loadRunSkills` writes it,
+     *  and only `RunSkills.enabledSkills` reads it. */
+    get catalog() { return this.#catalog; }
+    /** The install a live `/name` started after its message went out (hearsay-tools/cezarion#1408); tests await it. */
+    get liveSkillProvisioning() { return this.#liveSkillProvisioning; }
+    static {
+        skillsWrites = {
+            catalog(group, catalog) { group.#catalog = Object.freeze(catalog.map((skill) => new SkillView(skill))); },
+            provisioning(group, pending) { group.#liveSkillProvisioning = pending; },
+        };
+    }
+}
+for (const type of [SkillTeamView, SkillView, SkillsGroup]) {
+    Object.freeze(type.prototype);
+    Object.freeze(type);
+}
+export function createSkillsGroup() { return new SkillsGroup(); }
+const skillReads = (phase) => phase === 'continue' ? atContinue : phase === 'live-input' ? atLiveInput : atStepOpen;
+export class RunSkills {
+    context;
+    host;
+    constructor(context, host) {
+        this.context = context;
+        this.host = host;
+    }
+    /** Every skill lookup in this manager goes through here, so the built-ins reach all of them. */
+    discoverSkills(phase = 'task-head') {
+        return (phase === 'continue' ? atContinue : atTaskHead).registry(this.context.repoRoot, this.host.builtinSkills(), this.context.home);
+    }
+    /**
+     * Load the run's skill registry: the ONLY writer of `state.skills.catalog` (hearsay-tools/cezarion#1806).
+     * `execute` and `runContinuation` both call it, once the run is registered and after the awaits
+     * that precede its first prompt. `'throw'` lets a failed discovery fail the run, as a fresh run
+     * always did; `'ignore'` keeps the registry the run already has, or none, because discovery must
+     * never break a Continue (open-mercato/cezar#811). An empty registry expands no `/skill` (it is not an error).
+     */
+    async loadRunSkills(state, onFailure) {
+        // Only a rejected discovery is a failure to ignore; a synchronous throw escaped the old
+        // `.catch` too, and still fails the caller.
+        const discovery = this.discoverSkills(onFailure === 'ignore' ? 'continue' : 'task-head');
+        try {
+            skillsWrites.catalog(state.skills, await discovery);
+        }
+        catch (error) {
+            if (onFailure === 'throw')
+                throw error;
+        }
+    }
+    /**
+     * The run's skill registry minus the project's off-list as it is now (hearsay-tools/cezarion#1494): the ONLY reader of
+     * `state.skills.catalog`. The registry is discovered when the run starts or continues, so a team skill
+     * switched off since then is still in `state.skills.catalog`; every prompt a step, a Continue or a live
+     * `/name` builds reads this instead. A caller that already read the off-list passes it as
+     * `disabled`, so that both see one list. A team source disabled since then
+     * (hearsay-tools/cezarion#279) drops its skills here too.
+     */
+    enabledSkills(state, disabled, phase = 'step-open') {
+        const reads = skillReads(phase);
+        const off = disabled === undefined ? reads.disabledSkills(reads.projectUiStateSync(this.context.repoRoot)) : disabled;
+        return reads.enabledSkills(state, this.context.repoRoot, off);
+    }
+    /**
+     * A live `/name` message already carries the skill's body, and `sendMessage` answers
+     * synchronously, so its files and companions install after the message went out (hearsay-tools/cezarion#1408).
+     * When anything new landed, or a team skill's files went to a cache copy the message could not
+     * name, one durable agent input says what and where. Whether a runner's native lookup sees a skill
+     * added mid-session is not relied on: that input is the delivery for every runner. Nothing
+     * new: no input. A run that stopped, or moved to another session, gets none.
+     */
+    provisionLiveSlashSkill(runId, state, blocks) {
+        const first = blocks.find((block) => block.type === 'text');
+        const name = first?.type === 'text' ? leadingSlashSkillName(first.text) : undefined;
+        if (!name)
+            return;
+        const session = state.liveSession.session;
+        skillsWrites.provisioning(state.skills, (async () => {
+            const { filesDir, installed } = await this.provisionRunSkills(runId, state, { slash: name }, 'live-input');
+            const dir = filesDir.get(name);
+            if (installed.length === 0 && !dir)
+                return;
+            if (state.liveSession.cancelled || !this.host.isCurrentState(runId, state) || state.liveSession.session !== session)
+                return;
+            const text = [
+                ...(installed.length ? [`Skills installed for /${name}: ${installed.join(', ')}.`] : []),
+                ...(dir ? [`Skill files for /${name} are at ${dir}.`] : []),
+            ].join(' ');
+            // The durable queue delivers it at the runner's next opportunity: several runners refuse
+            // agent input while the human message is in flight, and a restart replays it.
+            const input = { id: randomUUID(), parentRunId: runId, source: 'lifecycle', text, createdAt: new Date().toISOString() };
+            this.context.store.commitAgentInputs(runId, enqueueAgentInput(this.context.store.getRun(runId), input));
+            this.context.store.appendEvent(runId, { type: 'agent-input', input });
+            this.host.flushAgentInputs(runId);
+        })().catch(() => undefined));
+    }
+    /**
+     * Provision the step skill and leading registry slash skill for start, Continue, recovery and
+     * live input, and at a step's start every registry skill its prompt names as a typed `/name`
+     * (hearsay-tools/cezarion#1672). Native slashes that are not registry skills install nothing.
+     *
+     * The run's OWN task worktree gets every root and the companions their bodies name
+     * (`provisionSkills`): links to local and global skills, generated `SKILL.md` files, and marked
+     * team copies, in `.claude/skills`, `.agents/skills` and `.cursor/skills`, recorded in the
+     * worktree's git dir and kept out of git by a worktree-local `.gitignore`. The project's
+     * off-list (`disabledTeamSkills`) is read fresh on every pass and applied to the saved
+     * registry, the roots and the team list alike: a team skill switched off for the project is
+     * never installed, not even for a skill that runs it, and a switch-off made after the run
+     * started holds for the next step, a live `/name` and Continue. Copies a pass installed before
+     * the switch stay in the worktree until the task ends: cezar removes nothing mid-task.
+     *
+     * Any other cwd — worktree off, a non-git project, a Continue whose worktree is gone — is the
+     * main checkout or unknown, where those directories are LOCAL skills to `discoverSkills` that
+     * would shadow the team source for every later run. A selected or leading-slash directory team
+     * root gets a per-commit cache copy there instead, and nothing else is installed: a skill only
+     * the prompt names gets nothing there, like a companion. So does a worktree where no copy of
+     * it landed, such as one whose three agent dirs all link out of it; one that took only some
+     * copies names the first that landed, since the runner's own dir may be the one skipped.
+     * Returns the step-start notes and, per team root, the directory its prompt must name.
+     */
+    async provisionRunSkills(runId, state, wanted, phase = 'step-open') {
+        const notes = [];
+        const filesDir = new Map();
+        const wantedNames = [...new Set([wanted.stepSkill, wanted.slash].filter((name) => Boolean(name)))];
+        // Stop can land during an earlier await (Continue's team-cache wait): a stopped run writes
+        // nothing, here or between the pass's own steps.
+        const stopped = () => Boolean(state.liveSession.cancelled) || this.host.workerExecutionStopped(runId);
+        // The off-list as it is now, applied to every input: the saved registry predates a switch
+        // made during the run, so it is filtered as well as the fresh team list.
+        const reads = skillReads(phase);
+        const disabled = reads.disabledSkills(await reads.projectUiState(this.context.repoRoot));
+        const registry = this.enabledSkills(state, disabled, phase);
+        // A skill the prompt names as `/name` is a root after the selected ones, so a capped closure
+        // never leaves it out (hearsay-tools/cezarion#1672). It installs only in the task worktree, like a companion.
+        const named = registry.filter((skill) => namesSkillCommand(wanted.prompt ?? '', skill.name)).map((skill) => skill.name);
+        const roots = [...new Set([...wantedNames, ...named])]
+            .flatMap((name) => registry.filter((skill) => skill.name === name).slice(0, 1));
+        if (roots.length === 0 || stopped())
+            return { notes, filesDir, installed: [] };
+        const teamRoots = roots.filter((skill) => wantedNames.includes(skill.name) && skill.source === 'team' && skill.team?.dir);
+        const cacheCopy = async (skill) => {
+            const dir = await materializeSkillToCache(skill, this.context.home).catch(() => null);
+            if (!dir)
+                return;
+            notes.push(`team skill "${skill.name}" materialized to ${dir}`);
+            filesDir.set(skill.name, dir);
+        };
+        if (!this.isOwnTaskWorktree(runId, state.liveSession.cwd)) {
+            for (const skill of teamRoots)
+                await cacheCopy(skill);
+            return { notes, filesDir, installed: [] };
+        }
+        const team = reads.teamSkills(this.context.repoRoot, this.context.home);
+        const catalog = [...registry, ...reads.filterSkills(team, disabled)];
+        const result = await provisionSkills(state.liveSession.cwd, roots, catalog, { cancelled: stopped, home: this.context.home });
+        if (stopped())
+            return { notes, filesDir, installed: [] };
+        for (const skill of teamRoots) {
+            const written = result.teamCopies[skill.name] ?? [];
+            if (written.length === TEAM_SKILL_AGENT_DIRS.length) {
+                notes.push(`team skill "${skill.name}" materialized to .claude/skills/${skill.name}/ ` +
+                    `.agents/skills/${skill.name}/, and .cursor/skills/${skill.name}/`);
+            }
+            else if (written.length > 0) {
+                notes.push(`team skill "${skill.name}" materialized to ${written.map((dir) => `${relative(state.liveSession.cwd, dir)}/`).join(' and ')}`);
+                filesDir.set(skill.name, written[0]);
+            }
+            else {
+                await cacheCopy(skill);
+            }
+        }
+        const others = result.installed.filter((name) => !teamRoots.some((skill) => skill.name === name));
+        if (others.length > 0 || result.truncated) {
+            notes.push(`skills installed in the task's workspace: ${others.join(', ') || 'none new'}` +
+                (result.truncated ? `; closure capped at ${MAX_SKILL_CLOSURE}, skipped ${result.truncated} and later` : ''));
+        }
+        return { notes, filesDir, installed: result.installed };
+    }
+    /** `cwd` is the run's recorded task worktree, and not the project root. Unresolvable means no. */
+    isOwnTaskWorktree(runId, cwd) {
+        const worktreePath = this.context.store.getRun(runId)?.worktreePath;
+        if (!worktreePath)
+            return false;
+        const real = (path) => { try {
+            return realpathSync(path);
+        }
+        catch {
+            return undefined;
+        } };
+        const dir = real(cwd);
+        return dir !== undefined && dir === real(worktreePath) && dir !== real(this.context.repoRoot);
+    }
+}
+//# sourceMappingURL=run-skills.js.map

package/dist/workflows/run/run-skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-skills.js","sourceRoot":"","sources":["../../../src/workflows/run/run-skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAGrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACxF,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAClG,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE5F,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAGrD,iFAAiF;AACjF,MAAM,OAAO,aAAa;IACxB,MAAM,CAAQ;IACd,YAAY,KAAY,IAAI,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACvE,IAAI,IAAI,KAAa,OAAO,IAAI,CAAC,MAAM,CAAC,IAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACrD,IAAI,GAAG,KAAa,OAAO,IAAI,CAAC,MAAM,CAAC,IAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IACnD,IAAI,IAAI,KAAa,OAAO,IAAI,CAAC,MAAM,CAAC,IAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACrD,IAAI,GAAG,KAAc,OAAO,IAAI,CAAC,MAAM,CAAC,IAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IACpD,IAAI,MAAM,KAAyB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAK,CAAC,MAAM,CAAC,CAAC,CAAC;CACtE;AAED,iFAAiF;AACjF,MAAM,OAAO,SAAS;IACpB,MAAM,CAAQ;IACd,KAAK,CAAgB;IACrB,YAAY,KAAY;QACtB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QAAC,IAAI,CAAC,KAAK,GAAG,IAAI,aAAa,CAAC,KAAK,CAAC,CAAC;QAC3D,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IACD,IAAI,IAAI,KAAa,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/C,IAAI,WAAW,KAAyB,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;IACzE,IAAI,WAAW,KAAuB,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;IACvE,IAAI,IAAI,KAAa,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/C,IAAI,IAAI,KAAa,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/C,IAAI,MAAM,KAAsB,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5D,IAAI,IAAI,KAAgC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;CAC5F;AAED,IAAI,YAGH,CAAC;AACF,MAAM,OAAO,WAAW;IACtB,QAAQ,CAAmC;IAC3C,sBAAsB,CAA4B;IAClD,gBAAgB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACtC;;uDAEmD;IACnD,IAAI,OAAO,KAAuC,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IACzE,mHAAmH;IACnH,IAAI,qBAAqB,KAAgC,OAAO,IAAI,CAAC,sBAAsB,CAAC,CAAC,CAAC;IAC9F;QACE,YAAY,GAAG;YACb,OAAO,CAAC,KAAK,EAAE,OAAO,IAAI,KAAK,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACzG,YAAY,CAAC,KAAK,EAAE,OAAO,IAAI,KAAK,CAAC,sBAAsB,GAAG,OAAO,CAAC,CAAC,CAAC;SACzE,CAAC;IACJ,CAAC;CACF;AACD,KAAK,MAAM,IAAI,IAAI,CAAC,aAAa,EAAE,SAAS,EAAE,WAAW,CAAC,EAAE,CAAC;IAC3D,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC9B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC;AACD,MAAM,UAAU,iBAAiB,KAAkB,OAAO,IAAI,WAAW,EAAE,CAAC,CAAC,CAAC;AAG9E,MAAM,UAAU,GAAG,CAAC,KAAqB,EAAE,EAAE,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,KAAK,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC;AASpI,MAAM,OAAO,SAAS;IACS,OAAO;IAAqC,IAAI;IAA7E,YAA6B,OAAyB,EAAmB,IAAmB;uBAA/D,OAAO;oBAAqC,IAAI;IAAkB,CAAC;IAEhG,gGAAgG;IAChG,cAAc,CAAC,KAAK,GAA6B,WAAW;QAC1D,OAAO,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACxI,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,aAAa,CAAC,KAAgB,EAAE,SAA6B;QACjE,wFAAwF;QACxF,4CAA4C;QAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;QACzF,IAAI,CAAC;YACH,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,SAAS,CAAC,CAAC;QACtD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,SAAS,KAAK,OAAO;gBAAE,MAAM,KAAK,CAAC;QACzC,CAAC;IACH,CAAC;IACD;;;;;;;OAOG;IACH,aAAa,CACX,KAAgB,EAChB,QAAuD,EACvD,KAAK,GAAmB,WAAW;QAEnC,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QAChC,MAAM,GAAG,GAAG,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QACtH,OAAO,KAAK,CAAC,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAChE,CAAC;IACD;;;;;;;OAOG;IACH,uBAAuB,CAAC,KAAa,EAAE,KAAgB,EAAE,MAAsB;QAC7E,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;QAC5D,MAAM,IAAI,GAAG,KAAK,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,qBAAqB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACpF,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,MAAM,OAAO,GAAG,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC;QAC1C,YAAY,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,EAAE;YAClD,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,YAAY,CAAC,CAAC;YAC3G,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG;gBAAE,OAAO;YAC3C,IAAI,KAAK,CAAC,WAAW,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,KAAK,CAAC,WAAW,CAAC,OAAO,KAAK,OAAO;gBAAE,OAAO;YAC5H,MAAM,IAAI,GAAG;gBACX,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,yBAAyB,IAAI,KAAK,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACxF,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,oBAAoB,IAAI,WAAW,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;aAC5D,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACZ,yFAAyF;YACzF,8EAA8E;YAC9E,MAAM,KAAK,GAAe,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;YACnI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAE,EAAE,KAAK,CAAC,CAAC,CAAC;YACzG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,CAAC;YACtE,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAC/B,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,KAAK,CAAC,kBAAkB,CACtB,KAAa,EACb,KAAgB,EAChB,MAAuF,EACvF,KAAK,GAAmB,WAAW;QAEnC,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC3C,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACnH,2FAA2F;QAC3F,iDAAiD;QACjD,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC;QACtG,0FAA0F;QAC1F,yEAAyE;QACzE,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QAChC,MAAM,QAAQ,GAAG,KAAK,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;QACzF,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC5D,6FAA6F;QAC7F,8GAA8G;QAC9G,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,iBAAiB,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxH,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,WAAW,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC;aACnD,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAClF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,EAAE;YAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;QAC/E,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC1H,MAAM,SAAS,GAAG,KAAK,EAAE,KAAY,EAAiB,EAAE;YACtD,MAAM,GAAG,GAAG,MAAM,uBAAuB,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YACtF,IAAI,CAAC,GAAG;gBAAE,OAAO;YACjB,KAAK,CAAC,IAAI,CAAC,eAAe,KAAK,CAAC,IAAI,qBAAqB,GAAG,EAAE,CAAC,CAAC;YAChE,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAChC,CAAC,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1D,KAAK,MAAM,KAAK,IAAI,SAAS;gBAAE,MAAM,SAAS,CAAC,KAAK,CAAC,CAAC;YACtD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;QAC5C,CAAC;QACD,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACxE,MAAM,OAAO,GAAG,CAAC,GAAG,QAAQ,EAAE,GAAG,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;QACrE,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7H,IAAI,OAAO,EAAE;YAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;QACzD,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACpD,IAAI,OAAO,CAAC,MAAM,KAAK,qBAAqB,CAAC,MAAM,EAAE,CAAC;gBACpD,KAAK,CAAC,IAAI,CAAC,eAAe,KAAK,CAAC,IAAI,oCAAoC,KAAK,CAAC,IAAI,IAAI;oBACpF,kBAAkB,KAAK,CAAC,IAAI,yBAAyB,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;YACxE,CAAC;iBAAM,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9B,KAAK,CAAC,IAAI,CAAC,eAAe,KAAK,CAAC,IAAI,qBAAqB,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBAC3I,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAE,CAAC,CAAC;YACxC,CAAC;iBAAM,CAAC;gBACN,MAAM,SAAS,CAAC,KAAK,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC;QAClG,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YAC1C,KAAK,CAAC,IAAI,CAAC,6CAA6C,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,UAAU,EAAE;gBACvF,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,uBAAuB,iBAAiB,aAAa,MAAM,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACjH,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;IAC1D,CAAC;IACD,kGAAkG;IAC1F,iBAAiB,CAAC,KAAa,EAAE,GAAW;QAClD,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;QACpE,IAAI,CAAC,YAAY;YAAE,OAAO,KAAK,CAAC;QAChC,MAAM,IAAI,GAAG,CAAC,IAAY,EAAsB,EAAE,GAAG,IAAI,CAAC;YAAC,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,SAAS,CAAC;QAAC,CAAC,CAAC,CAAC,CAAC;QACtH,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;QACtB,OAAO,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,CAAC,YAAY,CAAC,IAAI,GAAG,KAAK,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChG,CAAC;CAEF"}

package/dist/workflows/run/run-start.d.ts

@@ -0,0 +1,64 @@
+import type { RunRecord, RunStore } from '../../runs/store.ts';
+import type { RunnerId, ContentBlock } from '../../core/agent-runner.ts';
+import type { ActiveRun } from '../active-run.ts';
+import type { PastedContent, PersistedAttachment } from '../pasted-content.ts';
+import type { RunExitId } from '../../runs/run-exits.ts';
+import type { WorkflowDef } from '../types.ts';
+import type { PendingJob, RunLine } from './run-line.ts';
+import type { RunModuleContext, StartRunInput, PendingContinuation } from './types.ts';
+import type { AttachmentWriter } from './attachment-writer.ts';
+import type { TurnBookkeeper } from './turn-bookkeeping.ts';
+import type { QueuedInput } from './queued-input.ts';
+import type { ContinuationAcceptance } from './continuation-acceptance.ts';
+import type { WorkerExecutions } from './worker-executions.ts';
+interface RunStartHost {
+    active: Map<string, ActiveRun>;
+    startRun(workflow: WorkflowDef, input: StartRunInput, request?: {
+        id: string;
+        hash: string;
+    }): RunRecord;
+    execute(runId: string, workflow: WorkflowDef, input: StartRunInput, startAt?: number): Promise<void>;
+    runContinuation(runId: string, stepId: string, sessionId: string | undefined, backend: RunnerId, prompt: string, images?: PastedContent[], persistedImages?: ContentBlock[], persistedAttachments?: PersistedAttachment[]): Promise<void>;
+    move(runId: string, exit: RunExitId, patch?: Omit<Parameters<RunStore['updateRun']>[1], 'status'>): RunRecord | undefined;
+    dropActive(runId: string): void;
+    historyDeletionPending(runId: string): boolean;
+}
+/** Creates runs and launches jobs at the head of the scheduler's line. */
+export declare class RunStart {
+    private readonly context;
+    private readonly host;
+    private readonly line;
+    private readonly attachments;
+    private readonly turnBookkeeper;
+    private readonly queuedInput;
+    private readonly continuationAcceptance;
+    private readonly workerExecutions;
+    constructor(context: RunModuleContext, host: RunStartHost, line: RunLine, attachments: AttachmentWriter, turnBookkeeper: TurnBookkeeper, queuedInput: QueuedInput, continuationAcceptance: ContinuationAcceptance, workerExecutions: WorkerExecutions);
+    /**
+     * Idempotent start (hearsay-tools/cezarion#504, spec 2026-09-24-cez-task-cli). Lookup and create share one
+     * synchronous path, so the event loop serialises concurrent retries: the first creates, every
+     * later one with the same hash gets that run back, and a different hash is a conflict.
+     */
+    startRunIdempotent(workflow: WorkflowDef, input: StartRunInput, request: {
+        id: string;
+        hash: string;
+    }): {
+        run: RunRecord;
+        created: boolean;
+    } | {
+        conflict: true;
+    };
+    startRun(workflow: WorkflowDef, input: StartRunInput, clientRequest?: {
+        id: string;
+        hash: string;
+    }): RunRecord;
+    /** Accept only the store's already-durable owned creation, never caller-supplied paths/workflows. */
+    enqueueOwnedRun(runId: string): void;
+    ownedJob(run: RunRecord): {
+        workflow: WorkflowDef;
+        input: StartRunInput;
+    };
+    /** Read and hydrate mutable queued input in the same synchronous tick as dequeue. */
+    launchQueuedRun(runId: string, job: PendingJob | undefined, continuation: PendingContinuation | undefined): void;
+}
+export {};

package/dist/workflows/run/run-start.js

@@ -0,0 +1,126 @@
+import { atTaskHead } from './launch-read-resolver.js';
+import { DelegationPolicyError } from '../../delegation/policy.js';
+import { extractTaskRefs, refineTaskRefs } from '../../runs/task-refs.js';
+import { clearIdleTimer, clearAutosaveTimer } from './input-timers.js';
+/** Creates runs and launches jobs at the head of the scheduler's line. */
+export class RunStart {
+    context;
+    host;
+    line;
+    attachments;
+    turnBookkeeper;
+    queuedInput;
+    continuationAcceptance;
+    workerExecutions;
+    constructor(context, host, line, attachments, turnBookkeeper, queuedInput, continuationAcceptance, workerExecutions) {
+        this.context = context;
+        this.host = host;
+        this.line = line;
+        this.attachments = attachments;
+        this.turnBookkeeper = turnBookkeeper;
+        this.queuedInput = queuedInput;
+        this.continuationAcceptance = continuationAcceptance;
+        this.workerExecutions = workerExecutions;
+    }
+    /**
+     * Idempotent start (hearsay-tools/cezarion#504, spec 2026-09-24-cez-task-cli). Lookup and create share one
+     * synchronous path, so the event loop serialises concurrent retries: the first creates, every
+     * later one with the same hash gets that run back, and a different hash is a conflict.
+     */
+    startRunIdempotent(workflow, input, request) {
+        const existing = this.context.store.findRunByClientRequestId(request.id);
+        if (existing) {
+            return existing.clientRequestHash === request.hash ? { run: existing, created: false } : { conflict: true };
+        }
+        return { run: this.host.startRun(workflow, input, request), created: true };
+    }
+    startRun(workflow, input, clientRequest) {
+        // Sanitize at the manager boundary so CLI runs, workflows, and
+        // direct callers cannot bypass the HTTP policy.
+        const effectiveInput = atTaskHead.acceptInput(this.context.repoRoot, input, this.context.home);
+        const run = this.context.store.createRun(atTaskHead.acceptedRunFields(input, workflow, effectiveInput, clientRequest));
+        // The row exists from here on. A later write that throws still queues the job, so the caller
+        // that sees the throw finds a run that starts now, not one only a restart would start (#1465).
+        try {
+            // Persist the full definition so a queued run survives a restart (#367) —
+            // ad-hoc "(planned)" chains exist nowhere else to re-resolve from.
+            this.context.store.updateRun(run.id, atTaskHead.acceptedWorkflowFields(workflow));
+            // Initial pasted attachments must be visible while the run is still queued (#612),
+            // and must survive a restart before a slot opens. Persist them before the job
+            // enters `pendingJobs`; `hydrateQueuedInput` reconstructs their content blocks
+            // from these URLs when a recovered run eventually starts — and for a file (#950)
+            // this write is the ONLY copy, since it never had a block to be rebuilt from.
+            if (atTaskHead.images(input)?.length) {
+                const persisted = this.attachments.persistPastedAttachments(run.id, atTaskHead.images(input));
+                if (persisted.length) {
+                    this.context.store.updateRun(run.id, { taskImages: persisted.map((saved) => saved.url) });
+                }
+            }
+            // Step-0 reference extraction (task auto-naming spec): the regex layer's
+            // numbers persist immediately; the namer may add the kind it verified later.
+            const skillHint = atTaskHead.skillHint(workflow);
+            const refs = refineTaskRefs(extractTaskRefs(atTaskHead.task(input)), skillHint);
+            if (refs.prNumber !== undefined || refs.issueNumber !== undefined) {
+                this.context.store.updateRun(run.id, {
+                    ...(refs.prNumber !== undefined ? { prNumber: refs.prNumber } : {}),
+                    ...(refs.issueNumber !== undefined ? { issueNumber: refs.issueNumber } : {}),
+                });
+            }
+            // Fire-and-forget LLM naming (task auto-naming spec): the heuristic title
+            // above shows instantly; the namer's short title replaces it when (and if)
+            // the model answers. Never awaited, never fails the run.
+            void this.turnBookkeeper.autoNameRun(run.id, skillHint, atTaskHead.task(input));
+        }
+        finally {
+            this.line.enqueueJob(run.id, atTaskHead.queuedPayload(workflow, effectiveInput));
+            void this.line.pump();
+        }
+        return run;
+    }
+    /** Accept only the store's already-durable owned creation, never caller-supplied paths/workflows. */
+    enqueueOwnedRun(runId) {
+        const run = this.context.store.getRun(runId);
+        if (!run)
+            throw new DelegationPolicyError('incompatible_state', 'Owned queued run not found');
+        const job = this.ownedJob(run);
+        if (this.line.hasQueued(runId) || this.line.hasStarting(runId) || this.host.active.has(runId))
+            return;
+        this.line.enqueueJob(runId, job);
+        void this.line.pump();
+    }
+    ownedJob(run) {
+        return atTaskHead.ownedJob(this.context, this.host, run);
+    }
+    /** Read and hydrate mutable queued input in the same synchronous tick as dequeue. */
+    launchQueuedRun(runId, job, continuation) {
+        if (continuation) {
+            void (async () => {
+                const hydrated = this.queuedInput.hydrateQueuedContinuation(runId, continuation);
+                await this.context.work.track('runContinuation', this.host.runContinuation(runId, hydrated.stepId, hydrated.sessionId, hydrated.backend, hydrated.prompt, hydrated.images, hydrated.persistedImages, hydrated.persistedAttachments));
+            })().catch((err) => this.continuationAcceptance.failCrashedContinuation(runId, err))
+                .finally(() => this.workerExecutions.finishWorkerExecution(runId));
+            return;
+        }
+        if (!job)
+            return;
+        // Rebuild the prompt from the store at the last instant (open-mercato/cezar#472), so an edit
+        // or a stacked message that landed while the run waited is honored. Entered
+        // in the same synchronous tick as the `pendingJobs.delete` above, so no
+        // handler can observe a half-dequeued run.
+        void (async () => {
+            const input = this.queuedInput.hydrateQueuedInput(runId, atTaskHead.jobInput(job));
+            await this.context.work.track('execute', this.host.execute(runId, atTaskHead.jobWorkflow(job), input, job.startAt));
+        })().catch((err) => {
+            const message = err instanceof Error ? err.message : String(err);
+            this.host.move(runId, 'fail-crash', { error: `engine crashed: ${message}` });
+            const state = this.host.active.get(runId);
+            if (state) {
+                clearIdleTimer(state);
+                clearAutosaveTimer(state);
+            }
+            this.line.unmarkStarting(runId);
+            this.host.dropActive(runId);
+        }).finally(() => this.workerExecutions.finishWorkerExecution(runId));
+    }
+}
+//# sourceMappingURL=run-start.js.map

package/dist/workflows/run/run-start.js.map

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

package/dist/workflows/run/run-workspace.d.ts

@@ -0,0 +1,25 @@
+import { getRepoInfo } from '../../server/git.ts';
+import type { RunRecord, RunStore } from '../../runs/store.ts';
+import type { Execution, ExecutionLaunch, WorkerDelegationRecord } from './types.ts';
+export declare const REPOSITORY_ROOT_LOCK_DISABLED_NOTE = "repository-root lock disabled by CEZ_DISABLE_REPO_LOCK=1 (shared checkout is unsafe)";
+/** Verify an owned worker's Continue workspace without recreating it. The caller settles refusal. */
+export declare function ownedContinuationWorkspace(store: RunStore, repoRoot: string, dataDir: string, record: RunRecord, delegation: WorkerDelegationRecord): Promise<string>;
+/** An explicit worker attachment takes precedence over the project's personal config copy. */
+export declare function executionSeedFiles(ownedRun: RunRecord | undefined): Set<string>;
+/**
+ * Fork from the configured base branch (config.json `baseBranch`, e.g.
+ * `develop`) — also the target of the eventual draft PR. Unresolvable
+ * (typo, not fetched) → note + the currently checked-out branch.
+ *
+ * A task that already recorded a fork point keeps it: its worktree is
+ * reused as-is, and re-resolving against a since-changed config would
+ * silently re-anchor the `merge-base` every diff/shortstat is measured
+ * from, shifting "what did this task change" under an existing task.
+ */
+export declare function executionBaseRef(store: RunStore, repoRoot: string, execution: Execution, repo: Awaited<ReturnType<typeof getRepoInfo>>, launch: ExecutionLaunch): Promise<string>;
+/** The task's worktree: an owned worker's verified workspace, or a new worktree forked from `base`. */
+export declare function openExecutionWorktree(store: RunStore, repoRoot: string, dataDir: string, execution: Execution, launch: ExecutionLaunch, base: string): Promise<{
+    path: string;
+    branch: string;
+    baseBranch: string;
+}>;