@namzu/sdk 1.4.0 → 3.0.0

package/dist/types/run/events.d.ts

@@ -1,11 +1,10 @@
 import type { ActivityStatus, ActivityType } from '../activity/index.js';
 import type { BaseAgentResult } from '../agent/base.js';
-import type { CostInfo, TokenUsage } from '../common/index.js';
+import type { CostInfo, PlatformError, TokenUsage } from '../common/index.js';
 import type { CheckpointId, ToolCallSummary } from '../hitl/index.js';
 import type { ActivityId, MessageId, PlanId, PluginId, RunId, SandboxId, TaskId, ToolUseId } from '../ids/index.js';
 import type { PlanStep } from '../plan/index.js';
 import type { PluginHookEvent, PluginHookResult } from '../plugin/index.js';
-import type { ProviderErrorInfo } from '../provider/index.js';
 import type { TaskStatus } from '../task/index.js';
 import type { Lineage } from './lineage.js';
 import type { MessageStopReason } from './stop-reason.js';
@@ -43,12 +42,95 @@ type CoreRunEvent = {
     runId: RunId;
     iteration: number;
     hasToolCalls: boolean;
+}
+/**
+ * A compaction pass replaced a span of history with a summary.
+ *
+ * Compaction deletes messages irrecoverably and previously emitted
+ * nothing at all — a host could not show the user that context was
+ * dropped, and `transcript.jsonl` recorded a conversation that silently
+ * lost its middle. Every field here is measured, not estimated, where
+ * the provider reported it (`measuredBy`).
+ */
+ | {
+    type: 'compaction_completed';
+    runId: RunId;
+    iteration: number;
+    /** Messages before and after the pass. */
+    messagesBefore: number;
+    messagesAfter: number;
+    /** Context size in tokens before and after. */
+    tokensBefore: number;
+    tokensAfter: number;
+    /** Whether `tokensBefore` came from the provider or a heuristic. */
+    measuredBy: 'provider' | 'estimate';
+    /** The window the trigger measured against, and where it came from. */
+    contextWindowTokens: number;
+    windowSource: 'config' | 'model-table' | 'default';
+    /**
+     * False when the pass could not get the context below
+     * `resetThreshold` — the trigger is still armed, and a host may
+     * want to surface that the run is running tight.
+     */
+    reachedResetThreshold?: boolean;
 } | {
     type: 'tool_executing';
     runId: RunId;
     toolUseId: ToolUseId;
     toolName: string;
     input: unknown;
+}
+/**
+ * A tool saying how far along it is.
+ *
+ * Ephemeral — excluded from `transcript.jsonl`, like `text_delta`. It is
+ * for a host rendering a live view, not part of the conversation, and a
+ * chatty tool must not be able to bloat the durable record.
+ *
+ * Tools get a deadline of up to two minutes by default, so before this
+ * a build, a test run or a long fetch was simply silent for its whole
+ * duration: the host could show that a tool had started and then nothing
+ * at all until it either finished or timed out. The model never sees
+ * these; they answer "is it still working?", which is a question only a
+ * human asks.
+ */
+ | {
+    type: 'tool_progress';
+    runId: RunId;
+    toolUseId: ToolUseId;
+    toolName: string;
+    /** Human-readable, e.g. "compiled 40/120 files". */
+    message: string;
+    /** Optional completion in [0,1] when the tool genuinely knows it. */
+    fraction?: number;
+}
+/**
+ * A model call failed transiently and is being retried after a backoff.
+ *
+ * Answers the same question `tool_progress` answers — "is it still
+ * working?" — for the other half of a run's wall clock. With the default
+ * policy, or a server-directed delay up to the cap, a run can sit silent
+ * for the better part of a minute between `iteration_started` and the
+ * next event. A host saw literally nothing and no keepalive, so a
+ * backoff was indistinguishable from a hang and a watchdog would cancel
+ * a run that was about to succeed.
+ *
+ * Emitted before the sleep, so the delay it names is the one still
+ * ahead.
+ */
+ | {
+    type: 'provider_retry';
+    runId: RunId;
+    iteration: number;
+    /** 1-based attempt that just failed. */
+    attempt: number;
+    maxRetries: number;
+    delayMs: number;
+    /** Classified failure code, as the boundary classifier reports it. */
+    code: string;
+    status?: number;
+    /** The delay came from the server's own `Retry-After`. */
+    serverDirected: boolean;
 } | {
     type: 'tool_completed';
     runId: RunId;
@@ -56,6 +138,63 @@ type CoreRunEvent = {
     toolName: string;
     result: string;
     isError: boolean;
+    /**
+     * Wall-clock the tool took. Computed since the first version of
+     * the executor but only ever logged; a host asking "which tool
+     * was slow" had to reconstruct it from event timestamps.
+     */
+    durationMs?: number;
+    /**
+     * Size of the tool's output BEFORE the model-visible budget was
+     * applied, so a host can report "returned 2.1 MB" even though
+     * `result` is a preview.
+     */
+    outputLength?: number;
+    /** True when `result` is a preview rather than the whole output. */
+    outputTruncated?: boolean;
+    /** Where the full output was written, when it was spilled. */
+    outputSpillPath?: string;
+}
+/**
+ * A tool asked the user a question and the run is parked on it.
+ *
+ * The question used to park through the raw handler under a synthetic
+ * checkpoint id that was never written, so a remote host could not
+ * observe it at all — the in-process callback was the only channel, and
+ * a tool review with the same shape had an event, a bridge mapping and
+ * a durable record. This is that surface, for the other kind of park.
+ */
+ | {
+    type: 'user_question_asked';
+    runId: RunId;
+    checkpointId: CheckpointId;
+    /** The asking `tool_use_id`, so an answer can be matched back. */
+    questionId: string;
+    question: string;
+}
+/**
+ * The question was resolved.
+ *
+ * `answered: false` covers a decline and a non-response. Distinguished
+ * because the asking tool refuses to invent consent from either, and a
+ * host rendering the card needs the same distinction.
+ */
+ | {
+    type: 'user_question_answered';
+    runId: RunId;
+    checkpointId: CheckpointId;
+    /**
+     * Which question, when the resolution named one.
+     *
+     * Its sibling `user_question_asked` carries this and the answer
+     * did not, so a client that keyed on the question id — the
+     * natural key, since it is what routes an answer back on resume
+     * — could not match the two halves without also having stored
+     * the checkpoint id. Absent when the pause was resolved without
+     * an answer.
+     */
+    questionId?: string;
+    answered: boolean;
 } | {
     type: 'tool_review_requested';
     runId: RunId;
@@ -79,15 +218,66 @@ type CoreRunEvent = {
     type: 'run_resuming';
     runId: RunId;
     fromCheckpointId: CheckpointId;
+}
+/**
+ * A guardrail blocked or rewrote the run.
+ *
+ * Emitted so a host can show WHY a run refused, and — for a rewrite —
+ * so a consumer that already rendered `text_delta` events knows the
+ * text it displayed has been corrected.
+ */
+ | {
+    type: 'guardrail_triggered';
+    runId: RunId;
+    stage: 'input' | 'output';
+    action: 'block' | 'rewrite';
+    guardrail?: string;
+    reason?: string;
 } | {
     type: 'run_completed';
     runId: RunId;
     result: string;
-} | {
+}
+/**
+ * The run failed.
+ *
+ * `error` is the flattened message, kept for every consumer that only
+ * ever rendered a string. `failure` is the structured projection, and
+ * it is the point: namzu already classifies at the provider boundary —
+ * over status, errno, `Retry-After` and the whole cause chain — so a
+ * fully-populated error genuinely arrived here and was flattened one
+ * line later, discarding `code`, `status`, `retryAfterMs`, `retryable`
+ * and `details`.
+ *
+ * The damage was self-inflicted downstream: one consumer substring-
+ * matched the flattened message to decide whether an error had
+ * occurred, and the iteration loop re-ran the classifier to recover
+ * structure that had already been computed upstream.
+ */
+ | {
     type: 'run_failed';
     runId: RunId;
     error: string;
-    providerError?: ProviderErrorInfo;
+    failure?: PlatformError;
+    /**
+     * The driver's own classification, when it produced one. Carried
+     * beside `failure` rather than folded into it: this is the
+     * provider's first-hand statement, and a consumer deciding whether
+     * to retry reads it directly.
+     */
+    providerError?: import('../provider/error.js').ProviderErrorInfo;
+    /**
+     * Operator-facing explanation, when a catalog rule claims this
+     * failure: a stable `id` to grep for, and `hint` saying what to
+     * change. Absent when no rule matched — inventing advice for an
+     * uncharacterised failure is worse than saying nothing, because
+     * it sends the reader somewhere specific and wrong.
+     */
+    explanation?: {
+        id: string;
+        message: string;
+        hint: string;
+    };
 } | {
     type: 'capability_warning';
     runId: RunId;
@@ -200,6 +390,40 @@ type CoreRunEvent = {
     runId: RunId;
     iteration: number;
     messageId: MessageId;
+}
+/**
+ * The model began emitting a reasoning block.
+ *
+ * Without these, extended thinking looked to a streaming UI like a
+ * multi-second stall with no events at all — the run was working, and
+ * the host had no way to say so.
+ */
+ | {
+    type: 'reasoning_started';
+    runId: RunId;
+    iteration: number;
+    messageId: MessageId;
+    blockIndex: number;
+    reasoningType: 'thinking' | 'redacted_thinking';
+}
+/** Ephemeral — excluded from `transcript.jsonl`, like `text_delta`. */
+ | {
+    type: 'reasoning_delta';
+    runId: RunId;
+    iteration: number;
+    messageId: MessageId;
+    blockIndex: number;
+    text: string;
+} | {
+    type: 'reasoning_completed';
+    runId: RunId;
+    iteration: number;
+    messageId: MessageId;
+    blockIndex: number;
+    /** Present only when the provider returned readable thinking. */
+    text?: string;
+    /** True when the block carried a signature that must be replayed. */
+    signed: boolean;
 } | {
     type: 'text_delta';
     runId: RunId;

package/dist/types/run/events.d.ts.map

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

package/dist/types/run/events.js

@@ -17,6 +17,13 @@
 const EPHEMERAL_EVENT_TYPES = new Set([
     'text_delta',
     'tool_input_delta',
+    // The completed block carries the full text; the deltas would only
+    // duplicate it into the transcript at scale.
+    'reasoning_delta',
+    // Answers "is it still working?", which only a live view asks. A tool
+    // reporting every file it compiles must not be able to write thousands
+    // of lines into the durable record.
+    'tool_progress',
 ]);
 export function isEphemeralEvent(event) {
     return EPHEMERAL_EVENT_TYPES.has(event.type);

package/dist/types/run/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/types/run/events.ts"],"names":[],"mappings":"AAqTA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,qBAAqB,GAAkC,IAAI,GAAG,CAAmB;IACtF,YAAY;IACZ,kBAAkB;CAClB,CAAC,CAAA;AAEF,MAAM,UAAU,gBAAgB,CAAC,KAAe;IAC/C,OAAO,qBAAqB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;AAC7C,CAAC"}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/types/run/events.ts"],"names":[],"mappings":"AAihBA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,qBAAqB,GAAkC,IAAI,GAAG,CAAmB;IACtF,YAAY;IACZ,kBAAkB;IAClB,mEAAmE;IACnE,6CAA6C;IAC7C,iBAAiB;IACjB,sEAAsE;IACtE,uEAAuE;IACvE,oCAAoC;IACpC,eAAe;CACf,CAAC,CAAA;AAEF,MAAM,UAAU,gBAAgB,CAAC,KAAe;IAC/C,OAAO,qBAAqB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;AAC7C,CAAC"}

package/dist/types/run/index.d.ts

@@ -1,3 +1,5 @@
+export * from './step.js';
+export * from './prepare-step.js';
 export * from './stop-reason.js';
 export * from './config.js';
 export * from './checkpoint-store.js';
@@ -7,8 +9,11 @@ export * from './status.js';
 export * from './events.js';
 export * from './metadata.js';
 export * from './emergency.js';
+export * from './state.js';
 export type { Lineage } from './lineage.js';
 export type { SubsessionIdledEvent, SubsessionLifecycleEvent, SubsessionMessagedEvent, SubsessionSpawnedEvent, } from './subsession-events.js';
 export { RUN_EVENT_SCHEMA_VERSION } from './schema-version.js';
 export type { RunEventSchemaVersion } from './schema-version.js';
+export type { AnswerReview, AnswerReviewContext, ReviewAnswer } from './answer-review.js';
+export type { PromoteMemory, RunMemoryCandidate } from './memory-promotion.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/run/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/run/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,aAAa,CAAA;AAC3B,cAAc,uBAAuB,CAAA;AACrC,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAK3B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAC9B,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAC3C,YAAY,EACX,oBAAoB,EACpB,wBAAwB,EACxB,uBAAuB,EACvB,sBAAsB,GACtB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAA;AAC9D,YAAY,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/run/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA;AAChC,cAAc,aAAa,CAAA;AAC3B,cAAc,uBAAuB,CAAA;AACrC,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAK3B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAC3C,YAAY,EACX,oBAAoB,EACpB,wBAAwB,EACxB,uBAAuB,EACvB,sBAAsB,GACtB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAA;AAC9D,YAAY,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAChE,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACzF,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/types/run/index.js

@@ -1,3 +1,5 @@
+export * from './step.js';
+export * from './prepare-step.js';
 export * from './stop-reason.js';
 export * from './config.js';
 export * from './checkpoint-store.js';
@@ -11,5 +13,6 @@ export * from './status.js';
 export * from './events.js';
 export * from './metadata.js';
 export * from './emergency.js';
+export * from './state.js';
 export { RUN_EVENT_SCHEMA_VERSION } from './schema-version.js';
 //# sourceMappingURL=index.js.map

package/dist/types/run/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/run/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,aAAa,CAAA;AAC3B,cAAc,uBAAuB,CAAA;AACrC,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,wEAAwE;AACxE,4EAA4E;AAC5E,0EAA0E;AAC1E,sBAAsB;AACtB,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAQ9B,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/run/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA;AAChC,cAAc,aAAa,CAAA;AAC3B,cAAc,uBAAuB,CAAA;AACrC,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,wEAAwE;AACxE,4EAA4E;AAC5E,0EAA0E;AAC1E,sBAAsB;AACtB,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAQ1B,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/types/run/memory-promotion.d.ts

@@ -0,0 +1,90 @@
+import type { RunId } from '../ids/index.js';
+/**
+ * What a run learned, offered to whoever decides what is worth keeping.
+ *
+ * namzu could store a memory and could not *form* one. `MemoryStore` and
+ * its disk implementation have been here all along, and the only path
+ * into them is the model calling `save_memory` — so a run that worked out
+ * a durable fact and never thought to write it down lost it at settle,
+ * along with everything the compaction pass had already extracted and
+ * structured on the way.
+ *
+ * The extraction is the part that was already built: the compaction pass
+ * distils the transcript into decisions, discoveries, constraints and
+ * failures precisely because a summary of prose is worth less than a list
+ * of facts. That structure was serialized into one system message and
+ * then dropped on the floor when the run ended.
+ */
+export interface RunMemoryCandidate {
+    readonly runId: RunId;
+    /** What the run was asked to do, as the extractor recorded it. */
+    readonly task: string;
+    /** Choices the run made and did not revisit. */
+    readonly decisions: readonly string[];
+    /** Things it found out — the shape of a codebase, the name of a table. */
+    readonly discoveries: readonly string[];
+    /** What the user said must hold. The most durable category of the four. */
+    readonly userRequirements: readonly string[];
+    /** Approaches that failed, so a later run does not pay for them again. */
+    readonly failures: readonly string[];
+    /** Facts about the machine, the toolchain, the environment. */
+    readonly environment: readonly string[];
+    /** Files the run touched, by path. */
+    readonly files: readonly string[];
+    /**
+     * How many entries each capped list dropped during the run.
+     *
+     * Carried rather than hidden: a host deciding whether this is worth
+     * storing should know it is looking at a truncated record.
+     */
+    readonly evicted: Readonly<Record<string, number>>;
+}
+/**
+ * Decide what a finished run should leave behind.
+ *
+ * Called once, when the run settles, with everything the compaction pass
+ * extracted. Deliberately a callback rather than a store the runtime
+ * writes into: what is worth remembering is a policy question the host
+ * owns, and a runtime that decided it would be writing a row for every
+ * run whether or not anything happened.
+ *
+ * Never blocks and never fails the run. It runs after the answer is
+ * settled, so a throw is logged and swallowed — a memory that failed to
+ * form must not retract an answer that was already produced. A host that
+ * needs the write to be part of the run's success should do it in its own
+ * code, where it can fail loudly.
+ */
+export type PromoteMemory = (candidate: RunMemoryCandidate) => void | Promise<void>;
+/**
+ * Project the compaction pass's working state into a promotion candidate.
+ *
+ * A projection rather than the state itself, for the same reason the
+ * plugin hooks got one: the working state is an internal structure with
+ * caps, eviction counters and slot objects that exist to serve
+ * compaction, and handing it over would make every future field of it
+ * part of a host-facing contract by accident.
+ */
+export declare function toMemoryCandidate(runId: RunId, state: {
+    task: string;
+    decisions: string[];
+    discoveries: string[];
+    userRequirements: string[];
+    failures: string[];
+    environment: string[];
+    files: Map<string, unknown>;
+    evicted: Record<string, number>;
+}): RunMemoryCandidate;
+/**
+ * The candidate for this run, or `undefined` when there is nothing to
+ * offer.
+ *
+ * A separate function because "was anything extracted?" is a decision,
+ * and a decision inlined into a `try` is one a test cannot tell apart
+ * from the catch that swallows its failure. Without an extractor there
+ * is no working state, and inventing an empty candidate would ask a host
+ * to store a record of nothing.
+ */
+export declare function memoryCandidateFor(runId: RunId, manager: {
+    getState(): Parameters<typeof toMemoryCandidate>[1];
+} | undefined): RunMemoryCandidate | undefined;
+//# sourceMappingURL=memory-promotion.d.ts.map

package/dist/types/run/memory-promotion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-promotion.d.ts","sourceRoot":"","sources":["../../../src/types/run/memory-promotion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AAE5C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,gDAAgD;IAChD,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;IACrC,0EAA0E;IAC1E,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;IACvC,2EAA2E;IAC3E,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5C,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;IACpC,+DAA+D;IAC/D,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;IACvC,sCAAsC;IACtC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAClD;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,kBAAkB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAEnF;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE;IACN,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC/B,GACC,kBAAkB,CAYpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE;IAAE,QAAQ,IAAI,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAA;CAAE,GAAG,SAAS,GAC1E,kBAAkB,GAAG,SAAS,CAGhC"}

package/dist/types/run/memory-promotion.js

@@ -0,0 +1,38 @@
+/**
+ * Project the compaction pass's working state into a promotion candidate.
+ *
+ * A projection rather than the state itself, for the same reason the
+ * plugin hooks got one: the working state is an internal structure with
+ * caps, eviction counters and slot objects that exist to serve
+ * compaction, and handing it over would make every future field of it
+ * part of a host-facing contract by accident.
+ */
+export function toMemoryCandidate(runId, state) {
+    return {
+        runId,
+        task: state.task,
+        decisions: [...state.decisions],
+        discoveries: [...state.discoveries],
+        userRequirements: [...state.userRequirements],
+        failures: [...state.failures],
+        environment: [...state.environment],
+        files: [...state.files.keys()],
+        evicted: { ...state.evicted },
+    };
+}
+/**
+ * The candidate for this run, or `undefined` when there is nothing to
+ * offer.
+ *
+ * A separate function because "was anything extracted?" is a decision,
+ * and a decision inlined into a `try` is one a test cannot tell apart
+ * from the catch that swallows its failure. Without an extractor there
+ * is no working state, and inventing an empty candidate would ask a host
+ * to store a record of nothing.
+ */
+export function memoryCandidateFor(runId, manager) {
+    if (!manager)
+        return undefined;
+    return toMemoryCandidate(runId, manager.getState());
+}
+//# sourceMappingURL=memory-promotion.js.map

package/dist/types/run/memory-promotion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-promotion.js","sourceRoot":"","sources":["../../../src/types/run/memory-promotion.ts"],"names":[],"mappings":"AA4DA;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAChC,KAAY,EACZ,KASC;IAED,OAAO;QACN,KAAK;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,SAAS,EAAE,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC;QAC/B,WAAW,EAAE,CAAC,GAAG,KAAK,CAAC,WAAW,CAAC;QACnC,gBAAgB,EAAE,CAAC,GAAG,KAAK,CAAC,gBAAgB,CAAC;QAC7C,QAAQ,EAAE,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC;QAC7B,WAAW,EAAE,CAAC,GAAG,KAAK,CAAC,WAAW,CAAC;QACnC,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAC9B,OAAO,EAAE,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE;KAC7B,CAAA;AACF,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CACjC,KAAY,EACZ,OAA4E;IAE5E,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAA;IAC9B,OAAO,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAA;AACpD,CAAC"}

package/dist/types/run/prepare-step.d.ts

@@ -0,0 +1,100 @@
+import type { RunId } from '../ids/index.js';
+import type { Message } from '../message/index.js';
+import type { StepResult } from './step.js';
+/**
+ * What the loop knows before it calls the model again.
+ *
+ * `stopWhen` (shipped earlier) let a run DECIDE TO STOP based on what the
+ * steps produced. This is the other half of the same idea: deciding how
+ * the next step should be shaped. Without it, a run's tool surface, model
+ * and sampling parameters are fixed at `query()` time, so a phased agent —
+ * research with search tools, then write with file tools, then verify with
+ * a cheaper model — had to be built as three separate runs, each losing
+ * the prior one's context.
+ */
+export interface PrepareStepContext {
+    readonly runId: RunId;
+    /** 1-based, matching the iteration number in events and traces. */
+    readonly stepNumber: number;
+    /** Full history as it stands, so a decision can read what happened. */
+    readonly messages: readonly Message[];
+    /** Every completed step, in order. */
+    readonly steps: readonly StepResult[];
+    /**
+     * What the stages before this one decided, when several were supplied.
+     *
+     * Empty for the first stage, and empty for a single `prepareStep`.
+     * Reading it is how a later stage refines an earlier one — narrowing a
+     * tool set that has already been narrowed, or leaving a model alone
+     * because something upstream had a reason to change it.
+     */
+    readonly prepared: Readonly<PrepareStepResult>;
+}
+/**
+ * Overrides for the NEXT step. Every field is optional; an omitted field
+ * keeps the run's configured value, and returning nothing at all is the
+ * same as not supplying a `prepareStep`.
+ */
+export interface PrepareStepResult {
+    /**
+     * Restrict which tools the model may call this step, by name. Names
+     * that are not registered are dropped with a warning rather than
+     * failing the run — a phase list that outlives a tool rename should
+     * narrow the surface, not kill the agent mid-run.
+     *
+     * **This costs a prompt-cache prefix.** Tools render at position 0, so
+     * changing the set between steps invalidates the cached prefix for that
+     * step. That is inherent to narrowing, not an implementation detail, so
+     * it is worth doing when a phase boundary genuinely changes what the
+     * agent should reach for — and not worth doing every step.
+     *
+     * Note it does NOT touch `tool_choice`. Not every provider has an `allowed_tools`
+     * parameter, and moving `tool_choice` invalidates cached MESSAGE blocks
+     * as well — a strictly worse trade for the same effect.
+     */
+    readonly activeTools?: readonly string[];
+    /** Use a different model for this step. */
+    readonly model?: string;
+    /**
+     * Guidance for this step ONLY, appended as a system message that is not
+     * retained afterwards.
+     *
+     * Kept separate from the run's system prompt on purpose: the prompt is
+     * the cached prefix, and rewriting it per step would bust the cache on
+     * every iteration for what is usually one sentence of phase direction.
+     */
+    readonly system?: string;
+    readonly temperature?: number;
+    readonly maxResponseTokens?: number;
+}
+/**
+ * Called before each model call, with everything the run has produced so
+ * far.
+ *
+ * A throw fails OPEN — the step proceeds with the run's configured values.
+ * Same reasoning as `stopWhen` and deliberately opposite to a guardrail: a
+ * broken step-shaping hook should not kill an otherwise healthy run, and
+ * unlike a safety check, nothing unsafe gets through when it is skipped.
+ */
+export type PrepareStep = (context: PrepareStepContext) => PrepareStepResult | undefined | Promise<PrepareStepResult | undefined>;
+/**
+ * One shaping stage, or several applied in order.
+ *
+ * A single slot is enough for one concern and no help with two. A host
+ * with a per-tenant system prefix AND a cost-based model downgrade had to
+ * hand-compose them into one callback, which puts the ordering in the
+ * host's code where nothing can see it and makes each concern's failure
+ * the other's problem.
+ *
+ * An ARRAY is ordered by declaration, not by registration. That
+ * distinction is the whole reason this is safe where a plugin-style
+ * fan-out would not be: the author writes the order down, so "who wins"
+ * is a line of their code rather than an accident of install history.
+ * Each stage sees what the ones before it decided, and a later stage
+ * overrides a field an earlier one set — last writer wins, visibly.
+ *
+ * A stage that throws is skipped and the rest still run, so one broken
+ * concern cannot silently disable the others.
+ */
+export type PrepareStepChain = PrepareStep | readonly PrepareStep[];
+//# sourceMappingURL=prepare-step.d.ts.map

package/dist/types/run/prepare-step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare-step.d.ts","sourceRoot":"","sources":["../../../src/types/run/prepare-step.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAE3C;;;;;;;;;;GAUG;AACH,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,mEAAmE;IACnE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAA;IACrC,sCAAsC;IACtC,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAA;IAErC;;;;;;;OAOG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,iBAAiB,CAAC,CAAA;CAC9C;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IACjC;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAExC,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IAEvB;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IAExB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;CACnC;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,WAAW,GAAG,CACzB,OAAO,EAAE,kBAAkB,KACvB,iBAAiB,GAAG,SAAS,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAAA;AAE3E;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,SAAS,WAAW,EAAE,CAAA"}

package/dist/types/run/prepare-step.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=prepare-step.js.map

package/dist/types/run/prepare-step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare-step.js","sourceRoot":"","sources":["../../../src/types/run/prepare-step.ts"],"names":[],"mappings":""}