@telora/daemon 0.22.245 → 0.22.290

package/dist/directive/directive-dispatch.d.ts

@@ -1,194 +0,0 @@
-/**
- * Directive dispatch: execute a stage directive against a focus.
- *
- * Resolves the directive's execution mode, then dispatches: inject mode
- * writes /compact + assembled content to the live team's stdin; spawn mode
- * terminates the current team and stashes a PendingSpawnDirective for the
- * next spawn cycle. Also holds the bounded-retry runner + the escalation
- * path for exhausted retries. Extracted from directive-executor.ts; the
- * executor re-exports the public surface so existing importers are
- * unaffected.
- */
-import type { DaemonConfig, StageDirective } from '../types/index.js';
-import { type LineageSpec } from '../session/session-lineage.js';
-import { createEscalation } from '../queries/escalations.js';
-import { assembleDirectiveContent } from './directive-assembly.js';
-import { recordUndeliveredDirective, clearUndeliveredDirective } from '../queries/directive-undelivered.js';
-export { AGENTLESS_EXECUTION_MODE, isAgentlessDirective } from './agentless-directive.js';
-/**
- * True when a workflow stage is a QUIET TERMINAL: terminal AND non-agent-actionable
- * (its own declared shape, e.g. winding_down: is_terminal=true +
- * is_agent_actionable=false). No agent runs at such a stage regardless of what
- * agent_directive the row still carries -- winding_down's directive is
- * execution:'inject', which without this predicate falls through to the no-team
- * inject fallback and spawns a full team with nothing to do (TEL, delivery 5).
- *
- * Pure + exported for testing and for the checkDirectives silent-entry path. The
- * decision keys ONLY on the two declared flags, never on the stage name, so any
- * stage marked terminal + non-actionable is honoured without a special case.
- * Absent flags (undefined, from an older workflow row) => not quiet: the pre-flag
- * behaviour (dispatch the directive) is preserved for stages that never declared
- * the shape.
- */
-export declare function isQuietTerminalStage(stage: {
-    is_terminal?: boolean;
-    is_agent_actionable?: boolean;
-}): boolean;
-/**
- * Resolve the execution mode a directive should dispatch under.
- *
- * Pure + exported for testing. The rule:
- *   - A valid mode ('inject' | 'spawn') passes through unchanged.
- *   - A review-lineage directive whose execution is missing/invalid defaults
- *     to 'spawn'. Review always spawns a fresh team, so 'spawn' is the only
- *     sensible mode for that lineage; defaulting here self-heals malformed or
- *     seed-drifted review directives (e.g. the focus 'review' stage whose
- *     agent_directive lost its execution field -- see the backfill migration)
- *     so the review-spawn path can no longer be silently stranded.
- *   - Anything else is UNRESOLVABLE (returns null). The caller treats null as
- *     a fail-loud condition (throw -> escalate + loop trigger) rather than a
- *     silent no-op.
- *
- * Note: a review-lineage directive defaults to spawn even for a non-empty but
- * unrecognized execution value -- review is always spawnable, so we self-heal
- * rather than fail. Non-review lineages have no safe default and fail loud.
- */
-export declare function resolveDirectiveExecutionMode(execution: string | null | undefined, lineage: string): 'inject' | 'spawn' | null;
-/**
- * What a directive run actually DID -- the distinction the stage watermark needs.
- *
- * Before this, `checkDirectives` advanced the watermark the moment the run
- * returned, so a stage entry was consumed by the ATTEMPT rather than by the
- * delivery. That was survivable only while a lost delivery threw: the liveness
- * guard correctly stopped it throwing (a session that has ended is not a
- * transient failure), and a run that delivered nothing then became
- * indistinguishable from a success.
- *
- * Four outcomes, and they do NOT all mean the same thing for the watermark --
- * which is why this is a named type and not a boolean. A boolean would
- * re-collapse exactly what this focus separated.
- */
-export type DirectiveDisposition = 
-/** Reached a live session. */
-'delivered'
-/** The target session ended mid-delivery; the work it carried did not happen. */
- | 'undelivered'
-/** No live team: stashed as a PendingSpawnDirective for the next spawn. */
- | 'retained'
-/** Deliberately not delivered (a live review team must not be retasked into a coder). */
- | 'skipped';
-/**
- * Whether this disposition CONSUMES the focus's stage entry.
- *
- * The rule, with the reason each way:
- *   - delivered  -> yes. Consumed exactly once; a later poll must not re-issue it.
- *   - undelivered-> NO. Nothing reached the session, so the stage entry is still
- *                   owed. This is the whole point of the disposition type.
- *   - retained   -> yes. The pending-spawn queue is its own redelivery mechanism;
- *                   re-offering would re-assemble and re-stash on every poll.
- *   - skipped    -> yes. A fresh team spawns after the review team exits, which
- *                   is the existing trade (see the retask guard) and is not
- *                   re-opened here.
- *
- * A directive that THREW is not a disposition at all: that path escalates and
- * still consumes the entry, so a broken directive cannot loop every poll.
- */
-export declare function directiveConsumesStageEntry(disposition: DirectiveDisposition): boolean;
-/**
- * Execute a stage directive for a focus.
- *
- * inject mode: sends /compact + assembled context + prompt to the active team's stdin.
- * spawn mode: terminates the current team, assembles directive content, stores for respawn.
- *
- * When the directive's execution mode cannot be resolved to a valid mode
- * (see resolveDirectiveExecutionMode), this THROWS instead of silently
- * no-oping. The throw propagates through runDirectiveWithRetry in
- * checkDirectives, which escalates and emits a loop trigger -- so a malformed
- * directive surfaces a signal instead of stranding the focus.
- *
- * Exported for testing.
- */
-export declare function executeDirective(config: DaemonConfig, focusId: string, directive: StageDirective, focusWorkflowStageId: string, stageName?: string, focusOverrideModel?: string | null): Promise<DirectiveDisposition>;
-/**
- * A human summary of a directive's compaction recipe (preserve / shed), or null
- * when it carries none. Pure + exported so the "compact rides the spawn" log and
- * the no-team stash are testable without driving the DB-touching dispatch path.
- */
-export declare function compactRecipeSummary(directive: StageDirective): string | null;
-/**
- * Seams for the inject path. The assembly is the one that matters: it is the
- * AWAIT the lead can die inside, and a test cannot stage that death without
- * standing in the middle of it. Injected rather than `mock.module`'d, per the
- * package's mock-loader note -- registering any module mock poisons bare
- * daemon-core value imports for the rest of the file.
- */
-export interface InjectDirectiveDeps {
-    assembleDirectiveContent?: typeof assembleDirectiveContent;
-    /** The undelivered-directive record, so which disposal ran is observable. */
-    recordUndeliveredDirective?: typeof recordUndeliveredDirective;
-    clearUndeliveredDirective?: typeof clearUndeliveredDirective;
-}
-/**
- * Inject mode: send /compact + assembled context + prompt to the active team's stdin.
- */
-export declare function executeInjectDirective(config: DaemonConfig, focusId: string, directive: StageDirective, sessionType?: 'coding' | 'review', spec?: LineageSpec, focusOverrideModel?: string | null, originStageId?: string | null, deps?: InjectDirectiveDeps): Promise<DirectiveDisposition>;
-/**
- * Clear a focus's undelivered-directive record, best-effort.
- *
- * Called wherever a directive actually REACHES a live session -- here and at
- * the spawn's stdin write -- because the record's promise to a reader is that
- * it disappears the moment the focus is served again. A clear that fails must
- * never cost the delivery that succeeded, so it is logged and swallowed; the
- * next successful delivery clears it.
- */
-export declare function settleUndeliveredDirective(focusId: string, clear?: typeof clearUndeliveredDirective): Promise<void>;
-/**
- * Result of a bounded-retry attempt to run a directive. The retry is on
- * ANY thrown error (assembly resolver throws, fetch failures, Supabase
- * timeouts) -- broader than `withRetry` from daemon-core, which classifies
- * by error type. Transient failures during directive execution are not
- * always classified as network errors, but they're still worth retrying
- * before treating as permanent.
- */
-export interface DirectiveRunResult {
-    /** Whether the directive ran to completion within the retry bound. */
-    ok: boolean;
-    /** Number of attempts made (1 = first attempt succeeded). */
-    attempts: number;
-    /** Last error if the retry bound was exhausted, null on success. */
-    error: Error | null;
-}
-export interface RunDirectiveOptions {
-    maxAttempts?: number;
-    baseDelayMs?: number;
-    label: string;
-    /** Sleep implementation -- override in tests to avoid real delays. */
-    sleep?: (ms: number) => Promise<void>;
-    /** Called once per failed attempt before the backoff sleep. */
-    onAttemptFailed?: (attempt: number, error: Error) => void;
-}
-/**
- * Run a directive function with bounded retry and exponential backoff.
- * Returns a result tuple instead of throwing so the caller can decide
- * whether to escalate or continue.
- */
-export declare function runDirectiveWithRetry(fn: () => Promise<void>, options: RunDirectiveOptions): Promise<DirectiveRunResult>;
-/**
- * Escalate when bounded retry of a stage directive is exhausted.
- *
- * Visible signal so operators can find which focus + stage failed and
- * why, instead of a buried console.warn. Mirrors escalatePlanningFailure
- * from completion/event-escalations.ts.
- */
-export declare function escalateDirectiveFailure(params: {
-    organizationId: string;
-    sessionId: string;
-    focusId: string;
-    focusName: string;
-    stageName: string | undefined;
-    error: Error;
-    attempts: number;
-}, deps?: {
-    createEscalation: typeof createEscalation;
-}): Promise<void>;
-//# sourceMappingURL=directive-dispatch.d.ts.map

package/dist/directive/directive-dispatch.d.ts.map

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