@namzu/sdk 43.0.0 → 44.1.0

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

@@ -1,10 +1,5 @@
-import type { WorkingStateSnapshot } from '../../compaction/wire.js';
-import type { SerializedSpanContext } from '../../telemetry/attributes.js';
 import type { CostInfo, TokenUsage } from '../common/index.js';
-import type { CheckpointId, PlanId, RunId } from '../ids/index.js';
-import type { Message, UserMessage } from '../message/index.js';
-import type { PlanStatus } from '../plan/index.js';
-import type { TokenBudgetBinding } from '../run/token-budget-store.js';
+import type { CheckpointId, PlanId, SessionId, TurnId } from '../ids/index.js';
 export type { CheckpointId };
 export type HITLResumeDecision = {
     action: 'continue';
@@ -18,7 +13,7 @@ export type HITLResumeDecision = {
     action: 'approve_tools';
     /**
      * Grant keys to remember, so calls covered by them are not asked
-     * about again for the rest of the run.
+     * about again for the rest of the turn.
      *
      * Nothing is remembered unless this says so, and only an explicit
      * approval can say it — a denial or a non-response leaves nothing
@@ -34,9 +29,24 @@ export type HITLResumeDecision = {
      * only way out was a blanket grant that also covered `rm -rf`.
      */
     remember?: readonly string[];
+    /**
+     * Ids of calls whose sandbox escape a reviewer confirmed.
+     *
+     * A call that asks to leave the sandbox
+     * (`ToolCallSummary.escalation.sandboxEscape`) runs unconfined only
+     * when its id is here. An approval that does not list it refuses
+     * that call and runs the rest, so a policy that answers
+     * `approve_tools` to everything — an auto mode, a remembered
+     * "approve all", a host's own blanket handler — cannot grant an
+     * escape by accident. `createReviewHandler` fills it only after a
+     * person said yes to a batch that showed the escape.
+     */
+    confirmedEscalations?: readonly string[];
 } | {
     action: 'modify_tools';
     modifications: ToolModification[];
+    /** See the `approve_tools` field of the same name. */
+    confirmedEscalations?: readonly string[];
 } | {
     action: 'reject_tools';
     feedback: string;
@@ -47,8 +57,8 @@ export type HITLResumeDecision = {
     /**
      * Echo of `UserQuestionData.questionId` — the misdirection
      * guard. The park/resolve registry on hosts is typically
-     * keyed by run, so a stale client can answer question N
-     * after question N+1 re-parked under the same run. When
+     * keyed by turn, so a stale client can answer question N
+     * after question N+1 re-parked under the same turn. When
      * present and it does not match the asking tool's own
      * questionId, the tool treats the decision as unanswered
      * instead of fabricating a selection against the wrong
@@ -64,22 +74,26 @@ export type HITLResumeDecision = {
 };
 export type HITLDecisionRequest = {
     type: 'plan_approval';
-    runId: RunId;
+    sessionId: SessionId;
+    turnId: TurnId;
     checkpointId: CheckpointId;
     plan: PlanApprovalData;
 } | {
     type: 'tool_review';
-    runId: RunId;
+    sessionId: SessionId;
+    turnId: TurnId;
     checkpointId: CheckpointId;
     toolCalls: ToolCallSummary[];
 } | {
     type: 'iteration_checkpoint';
-    runId: RunId;
+    sessionId: SessionId;
+    turnId: TurnId;
     checkpointId: CheckpointId;
     summary: CheckpointSummary;
 } | {
     type: 'user_question';
-    runId: RunId;
+    sessionId: SessionId;
+    turnId: TurnId;
     checkpointId: CheckpointId;
     question: UserQuestionData;
 };
@@ -102,6 +116,32 @@ export interface ToolCallSummary {
         /** A matching rule requested review; read-only exemptions must not bypass it. */
         explicitReview?: true;
     };
+    /**
+     * What this call reaches beyond the turn's ordinary boundary, as the
+     * kernel found it in the prepared input. Absent for the ordinary call.
+     *
+     * A call carrying one is always reviewed: an `allow` rule, a remembered
+     * grant, a read-only declaration and `accept-edits` all decline to
+     * approve it on their own. A `deny` rule still refuses it outright.
+     */
+    escalation?: ToolCallEscalation;
+}
+/** See {@link ToolCallSummary.escalation}. */
+export interface ToolCallEscalation {
+    /**
+     * Absolute paths the call names outside the working directory and the
+     * added directories. Present only when the turn reviews such paths
+     * (`QueryParams.outsideRootAccess: 'review'`) and runs without a sandbox;
+     * an approval lets this call, and only this call, reach them.
+     */
+    outsidePaths?: readonly string[];
+    /**
+     * The call asks to run outside the turn's sandbox. Present only when the
+     * turn has a sandbox and allows escapes (`QueryParams.sandboxEscape:
+     * 'review'`). Honoured only when the decision lists the call's id in
+     * `confirmedEscalations`.
+     */
+    sandboxEscape?: true;
 }
 export interface ToolModification {
     toolCallId: string;
@@ -165,23 +205,23 @@ export interface CheckpointSummary {
     lastAssistantMessage?: string;
 }
 /**
- * A decision the run is parked on, recorded durably.
+ * A decision a turn is parked on, recorded durably (`decision_requested`).
  *
  * Without this the park exists only as a suspended `await` inside one
  * process: a checkpoint written at a tool-review gate looks identical to a
  * checkpoint written mid-run, so nothing on disk says "a human owes this
  * run an answer". Kill the process and the request is gone — the approval
  * queue a host would build from durable state has nothing to read, and a
- * resumed run silently re-asks the model instead of honoring the approval
+ * resumed turn silently re-asks the model instead of honoring the approval
  * that was already granted.
  *
  * `request` is stored verbatim so a fresh process can render exactly what
  * the human was shown, and apply the answer to exactly those tool calls.
  */
 export interface PendingDecision {
-    /** The request the run parked on, as the `resumeHandler` received it. */
+    /** The request the turn parked on, as the `resumeHandler` received it. */
     readonly request: HITLDecisionRequest;
-    /** Epoch ms at which the run parked. */
+    /** Epoch ms at which the turn parked. */
     readonly parkedAt: number;
     /**
      * Epoch ms after which this park is no longer worth serving.
@@ -189,14 +229,14 @@ export interface PendingDecision {
      * Absolute, not a duration, so it survives the process that set it —
      * every timer in the SDK is an in-process `setTimeout` and the
      * park-record delay is deliberately `unref`'d, so nothing in-memory can
-     * outlive a redeploy. Without it a run parks for approval, the worker is
+     * outlive a redeploy. Without it a turn parks for approval, the worker is
      * replaced, nobody answers, and the checkpoint stays outstanding
      * forever: every approval-queue reader keeps serving it and its
      * workspace is never reclaimed.
      *
-     * The run timeout cannot cover this. `checkLimitsDetailed` is only
+     * The turn timeout cannot cover this. `checkLimitsDetailed` is only
      * reached between iterations and a park suspends mid-iteration, so a
-     * long-lived process hard-stops the run immediately AFTER the human
+     * long-lived process hard-stops the turn immediately AFTER the human
      * finally approves, while across a restart the restored elapsed time
      * excludes parked time entirely — the same configuration giving two
      * opposite outcomes.
@@ -213,102 +253,5 @@ export interface PendingDecision {
     /** The answer, when one arrived. Kept as evidence of who decided what. */
     readonly decision?: HITLResumeDecision;
 }
-export interface IterationCheckpoint {
-    /** Reference to the canonical tree ledger; a checkpoint never resets it. */
-    readonly budgetBinding?: TokenBudgetBinding;
-    /** Also present for non-durable accounts; those require the live authority on resume. */
-    readonly budgetAccountId?: string;
-    id: CheckpointId;
-    runId: RunId;
-    iteration: number;
-    messages: Message[];
-    /**
-     * Current operator/goal/steering text and provenance, independent of
-     * compacted history. Attachments are not duplicated here. Older
-     * checkpoints omit this field and use surviving history on resume.
-     */
-    latestUserMessage?: UserMessage;
-    /** Structured host-review rejections consumed at this checkpoint, independent of compacted messages. */
-    structuredReviewAttempts?: number;
-    /** Consumed prose-answer rejections, independent of compactable feedback messages. */
-    answerReviewAttempts?: number;
-    /** Native structured-output corrections consumed independently of message history. */
-    nativeStructuredAttempts?: number;
-    tokenUsage: TokenUsage;
-    costInfo: CostInfo;
-    /**
-     * **Never set.** No checkpoint is written with a plan status.
-     *
-     * It matters more than an unused field usually would: a host restoring a
-     * checkpoint and reading this to decide whether the plan was approved
-     * gets `undefined` for every run, approved or not, and cannot tell the
-     * two apart. Ask the plan manager instead.
-     *
-     * @deprecated No producer. Removed in the next major.
-     */
-    planStatus?: PlanStatus;
-    /**
-     * When the RUN was attributed — not when this checkpoint was written.
-     * See {@link IterationCheckpoint.createdAt} for the latter.
-     *
-     * Denormalized onto every checkpoint of the run, identically, and that
-     * repetition is the whole point. A listing above the run needs a key it
-     * can order by, and a key a paging caller can trust is one that cannot
-     * MOVE. Every other time a checkpoint store can derive per run moves: the
-     * newest checkpoint's `createdAt` advances every time the run checkpoints
-     * again, and the oldest one's advances every time `prune` deletes
-     * oldest-first. Carried on all of them, this one survives both — pruning
-     * cannot reach a value every survivor also holds.
-     *
-     * `readonly`, and written exactly once per run by
-     * {@link import('../../runtime/query/checkpoint.js').CheckpointManager},
-     * which settles it on whichever comes first — adopting it from the
-     * checkpoint a resume restores, or minting it from the run's own start
-     * instant — and never reassigns after. A field that COULD be updated is
-     * one edit away from moving again, which would put the ordering back
-     * where it started.
-     *
-     * Absent on checkpoints written before this existed. That absence is
-     * information, not a gap: a run with no stamp on any of its checkpoints
-     * was attributed before the stamp existed, and therefore before every
-     * run that has one.
-     */
-    readonly runCreatedAt?: number;
-    /**
-     * Present when the run parked at this checkpoint awaiting a human.
-     * See {@link PendingDecision}.
-     */
-    pending?: PendingDecision;
-    guardState: {
-        iterationCount: number;
-        elapsedMs: number;
-    };
-    createdAt: number;
-    toolResultHashes?: Record<string, string>;
-    /**
-     * Compaction's accumulated working state at the moment of the
-     * checkpoint.
-     *
-     * Absent on checkpoints written before this existed, and absent when
-     * compaction is disabled — in both cases the resumed run starts with an
-     * empty manager, which is exactly today's behaviour.
-     */
-    workingState?: WorkingStateSnapshot;
-    /**
-     * The trace this checkpoint was taken inside.
-     *
-     * A resumed run used to mint a fresh root span with a new trace id and
-     * no link to the one that crashed, so the failure and its recovery could
-     * not be reconstructed as one timeline. Every span carries the run id,
-     * which is enough to find both traces by query and not enough to see one
-     * waterfall — and even that goes away for a replay fork, which mints a
-     * new run id.
-     *
-     * Absent on checkpoints written before this existed, and on runs with no
-     * telemetry registered; in both cases the resumed run starts its own
-     * trace, which is exactly today's behaviour.
-     */
-    traceContext?: SerializedSpanContext;
-}
 export declare function autoApproveHandler(request: HITLDecisionRequest): Promise<HITLResumeDecision>;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/hitl/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AACpE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAA;AAC1E,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AAClE,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAA;AAEtE,YAAY,EAAE,YAAY,EAAE,CAAA;AAE5B,MAAM,MAAM,kBAAkB,GAC3B;IAAE,MAAM,EAAE,UAAU,CAAA;CAAE,GACtB;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC3C;IACA,MAAM,EAAE,eAAe,CAAA;IACvB;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC3B,GACD;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,aAAa,EAAE,gBAAgB,EAAE,CAAA;CAAE,GAC7D;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC5C;IACA,MAAM,EAAE,iBAAiB,CAAA;IACzB,iBAAiB,EAAE,MAAM,EAAE,CAAA;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;;;;;;OASG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CAClB,GACD;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAEtC,MAAM,MAAM,mBAAmB,GAC5B;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC;IAAC,YAAY,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,gBAAgB,CAAA;CAAE,GAC3F;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC;IAAC,YAAY,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,eAAe,EAAE,CAAA;CAAE,GAC/F;IACA,IAAI,EAAE,sBAAsB,CAAA;IAC5B,KAAK,EAAE,KAAK,CAAA;IACZ,YAAY,EAAE,YAAY,CAAA;IAC1B,OAAO,EAAE,iBAAiB,CAAA;CACzB,GACD;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC;IAAC,YAAY,EAAE,YAAY,CAAC;IAAC,QAAQ,EAAE,gBAAgB,CAAA;CAAE,CAAA;AAElG,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,mBAAmB,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAA;AAEzF,MAAM,WAAW,eAAe;IAC/B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,OAAO,CAAA;IACd,aAAa,EAAE,OAAO,CAAA;IACtB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE;QACf,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAA;QACrC,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,iFAAiF;QACjF,cAAc,CAAC,EAAE,IAAI,CAAA;KACrB,CAAA;CACD;AAED,MAAM,WAAW,gBAAgB;IAChC,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAA;IACrC,aAAa,CAAC,EAAE,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,kBAAkB;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAChC,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,kBAAkB,EAAE,CAAA;IAC7B,WAAW,EAAE,OAAO,CAAA;IACpB,aAAa,EAAE,OAAO,CAAA;CACtB;AAED,MAAM,WAAW,gBAAgB;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,KAAK,CAAC;QACZ,EAAE,EAAE,MAAM,CAAA;QACV,WAAW,EAAE,MAAM,CAAA;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;QAEjB;;;;;;;;;;;;;;WAcG;QACH,OAAO,CAAC,EAAE,MAAM,CAAA;QAEhB,SAAS,EAAE,MAAM,EAAE,CAAA;QACnB,KAAK,EAAE,MAAM,CAAA;KACb,CAAC,CAAA;IACF,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,iBAAiB;IACjC,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,UAAU,CAAA;IACtB,QAAQ,EAAE,QAAQ,CAAA;IAClB,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAC7B;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,eAAe;IAC/B,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAA;IACrC,wCAAwC;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,CAAC,EAAE,kBAAkB,CAAA;CACtC;AAED,MAAM,WAAW,mBAAmB;IACnC,4EAA4E;IAC5E,QAAQ,CAAC,aAAa,CAAC,EAAE,kBAAkB,CAAA;IAC3C,yFAAyF;IACzF,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,EAAE,EAAE,YAAY,CAAA;IAChB,KAAK,EAAE,KAAK,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,OAAO,EAAE,CAAA;IACnB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,WAAW,CAAA;IAC/B,wGAAwG;IACxG,wBAAwB,CAAC,EAAE,MAAM,CAAA;IACjC,sFAAsF;IACtF,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,sFAAsF;IACtF,wBAAwB,CAAC,EAAE,MAAM,CAAA;IACjC,UAAU,EAAE,UAAU,CAAA;IACtB,QAAQ,EAAE,QAAQ,CAAA;IAClB;;;;;;;;;OASG;IACH,UAAU,CAAC,EAAE,UAAU,CAAA;IAEvB;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAE9B;;;OAGG;IACH,OAAO,CAAC,EAAE,eAAe,CAAA;IACzB,UAAU,EAAE;QACX,cAAc,EAAE,MAAM,CAAA;QACtB,SAAS,EAAE,MAAM,CAAA;KACjB,CAAA;IACD,SAAS,EAAE,MAAM,CAAA;IAEjB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAEzC;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,oBAAoB,CAAA;IAEnC;;;;;;;;;;;;;OAaG;IACH,YAAY,CAAC,EAAE,qBAAqB,CAAA;CACpC;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAwB5F"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/hitl/index.ts"],"names":[],"mappings":"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"}

package/dist/types/hitl/index.js

@@ -7,7 +7,7 @@ export function autoApproveHandler(request) {
         case 'iteration_checkpoint':
             return Promise.resolve({ action: 'continue' });
         case 'user_question':
-            // Headless runs must never deadlock on a question and must
+            // Headless turns must never deadlock on a question and must
             // never fabricate a user choice: answer with an explicit
             // no-selection sentinel so the asking tool renders "the user
             // did not answer" rather than consent.

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/hitl/index.ts"],"names":[],"mappings":"AAsTA,MAAM,UAAU,kBAAkB,CAAC,OAA4B;IAC9D,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACtB,KAAK,eAAe;YACnB,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAA;QACnD,KAAK,aAAa;YACjB,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAA;QACpD,KAAK,sBAAsB;YAC1B,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAA;QAC/C,KAAK,eAAe;YACnB,2DAA2D;YAC3D,yDAAyD;YACzD,6DAA6D;YAC7D,uCAAuC;YACvC,OAAO,OAAO,CAAC,OAAO,CAAC;gBACtB,MAAM,EAAE,iBAAiB;gBACzB,iBAAiB,EAAE,EAAE;gBACrB,QAAQ,EAAE,mEAAmE;gBAC7E,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,UAAU;aACvC,CAAC,CAAA;QACH,OAAO,CAAC,CAAC,CAAC;YACT,MAAM,WAAW,GAAU,OAAO,CAAA;YAClC,MAAM,IAAI,KAAK,CAAC,gCAAiC,WAAmC,CAAC,IAAI,EAAE,CAAC,CAAA;QAC7F,CAAC;IACF,CAAC;AACF,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/hitl/index.ts"],"names":[],"mappings":"AA0QA,MAAM,UAAU,kBAAkB,CAAC,OAA4B;IAC9D,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACtB,KAAK,eAAe;YACnB,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAA;QACnD,KAAK,aAAa;YACjB,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAA;QACpD,KAAK,sBAAsB;YAC1B,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAA;QAC/C,KAAK,eAAe;YACnB,4DAA4D;YAC5D,yDAAyD;YACzD,6DAA6D;YAC7D,uCAAuC;YACvC,OAAO,OAAO,CAAC,OAAO,CAAC;gBACtB,MAAM,EAAE,iBAAiB;gBACzB,iBAAiB,EAAE,EAAE;gBACrB,QAAQ,EAAE,mEAAmE;gBAC7E,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,UAAU;aACvC,CAAC,CAAA;QACH,OAAO,CAAC,CAAC,CAAC;YACT,MAAM,WAAW,GAAU,OAAO,CAAA;YAClC,MAAM,IAAI,KAAK,CAAC,gCAAiC,WAAmC,CAAC,IAAI,EAAE,CAAC,CAAA;QAC7F,CAAC;IACF,CAAC;AACF,CAAC"}

package/dist/types/hitl/policy.d.ts

@@ -1,11 +1,11 @@
-import type { RunId } from '../ids/index.js';
+import type { SessionId, TurnId } from '../ids/index.js';
 import type { ResumeHandler } from './index.js';
 /**
- * Who answers when the run asks a human, as a value rather than a closure.
+ * Who answers when a turn asks a human, as a value rather than a closure.
  *
  * `ResumeHandler` was captured once at `query()` start and never read again
  * from anywhere a host could reach — so switching from "ask me about every
- * write" to "go ahead, I'm stepping out" meant ending the run and starting
+ * write" to "go ahead, I'm stepping out" meant ending the turn and starting
  * another. That is the same defect `permissionMode` had before it became a
  * box the executor reads through, and it has the same cost: the fix
  * discards the in-flight step and the context that step was built from.
@@ -31,7 +31,7 @@ export interface ApprovalPolicy {
  * writes before the record landed would leave a log where the approvals
  * precede the decision that permitted them.
  */
-export interface RunApprovalPolicy {
+export interface SessionApprovalPolicy {
     readonly current: ApprovalPolicy;
     /**
      * Swap the policy, recording who and why.
@@ -46,7 +46,7 @@ export interface RunApprovalPolicy {
      * The change the model has not been told about yet — and reading it is
      * what marks it told.
      *
-     * The model plans around how closely it is being watched. A run that
+     * The model plans around how closely it is being watched. A turn that
      * silently stops asking a human, or silently starts, leaves the model
      * working from a supervision assumption that is no longer true: it will
      * keep batching destructive calls it expects to be reviewed, or keep
@@ -71,7 +71,9 @@ export interface ApprovalPolicyChange {
 /** The durable record of a policy change. */
 export interface ApprovalPolicyChangedEvent {
     readonly type: 'approval_policy_changed';
-    readonly runId: RunId;
+    readonly sessionId: SessionId;
+    /** Absent when the policy changed between turns. */
+    readonly turnId?: TurnId;
     readonly from: string;
     readonly to: string;
     readonly reason: string;

package/dist/types/hitl/policy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../../src/types/hitl/policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,cAAc;IAC9B;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAA;CAC/B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAA;IAChC;;;;;;;OAOG;IACH,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE1D;;;;;;;;;;;;;;;;;OAiBG;IACH,qBAAqB,IAAI,oBAAoB,GAAG,SAAS,CAAA;CACzD;AAED,sDAAsD;AACtD,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACvB;AAED,6CAA6C;AAC7C,MAAM,WAAW,0BAA0B;IAC1C,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAA;IACxC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACvB"}
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../../src/types/hitl/policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,cAAc;IAC9B;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAA;CAC/B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAA;IAChC;;;;;;;OAOG;IACH,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE1D;;;;;;;;;;;;;;;;;OAiBG;IACH,qBAAqB,IAAI,oBAAoB,GAAG,SAAS,CAAA;CACzD;AAED,sDAAsD;AACtD,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACvB;AAED,6CAA6C;AAC7C,MAAM,WAAW,0BAA0B;IAC1C,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAA;IACxC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,oDAAoD;IACpD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACvB"}

package/dist/types/ids/brand.d.ts

@@ -1,9 +1,16 @@
 /** Nominal identity is independent of the identifier's serialized spelling. */
 declare const ID_BRAND: unique symbol;
-/** An opaque string whose tag prevents mixing different entity types. */
-export type Id<B extends string> = string & {
+/**
+ * The nominal tag of an entity id. An interface rather than an inline object
+ * type so a declaration file can name it: a zod schema over branded ids makes
+ * TypeScript expand the id type, and an anonymous `{ [ID_BRAND]: B }` would
+ * then need the module-private symbol spelled in the emitting file.
+ */
+export interface IdBrand<B extends string> {
     readonly [ID_BRAND]: B;
-};
+}
+/** An opaque string whose tag prevents mixing different entity types. */
+export type Id<B extends string> = string & IdBrand<B>;
 /**
  * Internal escape hatch for factories and checked constructors. Not exported
  * from the package barrel; consumers validate external strings with `as*Id`.

package/dist/types/ids/brand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"brand.d.ts","sourceRoot":"","sources":["../../../src/types/ids/brand.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,OAAO,CAAC,MAAM,QAAQ,EAAE,OAAO,MAAM,CAAA;AAErC,yEAAyE;AACzE,MAAM,MAAM,EAAE,CAAC,CAAC,SAAS,MAAM,IAAI,MAAM,GAAG;IAC3C,QAAQ,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;CACtB,CAAA;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,CAE3D"}
+{"version":3,"file":"brand.d.ts","sourceRoot":"","sources":["../../../src/types/ids/brand.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,OAAO,CAAC,MAAM,QAAQ,EAAE,OAAO,MAAM,CAAA;AAErC;;;;;GAKG;AACH,MAAM,WAAW,OAAO,CAAC,CAAC,SAAS,MAAM;IACxC,QAAQ,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;CACtB;AAED,yEAAyE;AACzE,MAAM,MAAM,EAAE,CAAC,CAAC,SAAS,MAAM,IAAI,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;AAEtD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,CAE3D"}

package/dist/types/ids/brand.js.map

@@ -1 +1 @@
-{"version":3,"file":"brand.js","sourceRoot":"","sources":["../../../src/types/ids/brand.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAmB,KAAa;IACvD,OAAO,KAAqB,CAAA;AAC7B,CAAC"}
+{"version":3,"file":"brand.js","sourceRoot":"","sources":["../../../src/types/ids/brand.ts"],"names":[],"mappings":"AAgBA;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAmB,KAAa;IACvD,OAAO,KAAqB,CAAA;AAC7B,CAAC"}

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

@@ -2,14 +2,21 @@ import type { Id } from './brand.js';
 /**
  * Entity ids are opaque branded strings. Factories mint UUIDs; checked
  * constructors reject every other spelling, including earlier type prefixes.
- * A RunId cannot be assigned to a SessionId even though their wire shapes
+ * A TurnId cannot be assigned to a SessionId even though their wire shapes
  * are identical. Persisted records and typed fields establish the kind,
  * not the spelling of the id.
  *
  * Brands do not validate a type assertion. Use the checked constructors
  * for values received from JSON, flags, URLs, or other untyped boundaries.
  */
-export type RunId = Id<'RunId'>;
+/**
+ * One turn of a session: a user prompt (or a goal round, resident step or
+ * verification step) and everything the agent did to answer it. Recorded in
+ * the session log between `turn_started` and `turn_completed`/`turn_failed`.
+ */
+export type TurnId = Id<'TurnId'>;
+/** One line of a session log. Every record carries its own UUIDv7 id. */
+export type RecordId = Id<'RecordId'>;
 export type MessageId = Id<'MessageId'>;
 export type SessionId = Id<'SessionId'>;
 /** Identifies one durable completion goal across its revisions. */
@@ -44,11 +51,10 @@ export type CheckpointId = Id<'CheckpointId'>;
 export type LockId = Id<'LockId'>;
 export type AdvisoryId = Id<'AdvisoryId'>;
 export type AdvisoryCallId = Id<'AdvisoryCallId'>;
-export type EmergencySaveId = Id<'EmergencySaveId'>;
 export type MemoryId = Id<'MemoryId'>;
 export type PluginId = Id<'PluginId'>;
 export type SandboxId = Id<'SandboxId'>;
-/** LOG-14: the audit trail's own record id — distinct from `RunEvent.seq`. */
+/** LOG-14: the audit trail's own record id — distinct from a session record's `seq`. */
 export type AuditEventId = Id<'AuditEventId'>;
 export type UserId = Id<'UserId'>;
 /**

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/ids/index.ts"],"names":[],"mappings":"AAmGA;;;GAGG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAEpC;IACA;IAFV,YACU,KAAa,EACb,cAAsB;QAE/B,KAAK,CACJ,sBAAsB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,aAAa,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,uIAAuI,CAC7N,CAAA;QALQ,UAAK,GAAL,KAAK,CAAQ;QACb,mBAAc,GAAd,cAAc,CAAQ;QAK/B,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAA;IACnC,CAAC;CACD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/ids/index.ts"],"names":[],"mappings":"AAyGA;;;GAGG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAEpC;IACA;IAFV,YACU,KAAa,EACb,cAAsB;QAE/B,KAAK,CACJ,sBAAsB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,aAAa,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,uIAAuI,CAC7N,CAAA;QALQ,UAAK,GAAL,KAAK,CAAQ;QACb,mBAAc,GAAd,cAAc,CAAQ;QAK/B,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAA;IACnC,CAAC;CACD"}

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

@@ -1,6 +1,20 @@
 import type { MemoryId } from '../ids/index.js';
 export type MemoryStatus = 'active' | 'archived';
 export declare function assertMemoryStatus(status: MemoryStatus): void;
+/**
+ * What kind of thing a memory records, which decides when it is worth
+ * reading again:
+ *
+ * - `user` — who the operator is: role, expertise, preferences.
+ * - `feedback` — a rule the operator gave about how to work, with why.
+ * - `project` — a fact or decision about the work that the code and its
+ *   history do not already say.
+ * - `reference` — where to look: a dashboard, a ticket queue, a document.
+ */
+export type MemoryType = 'user' | 'feedback' | 'project' | 'reference';
+export declare const MEMORY_TYPES: readonly MemoryType[];
+export declare function assertMemoryType(type: MemoryType): void;
+export declare function isMemoryType(value: unknown): value is MemoryType;
 export interface MemoryIndexEntry {
     readonly id: MemoryId;
     readonly title: string;
@@ -9,6 +23,17 @@ export interface MemoryIndexEntry {
     readonly status: MemoryStatus;
     readonly createdAt: number;
     readonly updatedAt: number;
+    /**
+     * Unique kebab-case slug (`[a-z0-9]+(-[a-z0-9]+)*`, at most 64
+     * characters). A store that keeps one file per memory names the file
+     * after it, and `[[name]]` in another memory's body links here. Absent on
+     * records written before names existed.
+     */
+    readonly name?: string;
+    /** One line saying what the memory is for, used to judge relevance without reading it. */
+    readonly description?: string;
+    /** Absent on records written before types existed. */
+    readonly type?: MemoryType;
 }
 export interface MemoryContent {
     readonly id: MemoryId;
@@ -40,6 +65,16 @@ export interface CreateMemoryParams {
     readonly tags?: string[];
     readonly format?: 'text' | 'markdown' | 'json';
     readonly metadata?: Record<string, unknown>;
+    /**
+     * Unique slug for this memory. A store refuses a name another record
+     * already holds with {@link MemoryNameConflictError}, which names that
+     * record, so a caller updates it instead of writing a second copy. When
+     * omitted, a store that requires names derives one from `title` and
+     * suffixes it (`-2`, `-3`) until it is free.
+     */
+    readonly name?: string;
+    readonly description?: string;
+    readonly type?: MemoryType;
 }
 /** Change a memory's content or explicitly archive/reactivate it. */
 export interface UpdateMemoryParams extends Partial<CreateMemoryParams> {

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

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

package/dist/types/memory/index.js

@@ -9,4 +9,21 @@ export function assertMemoryStatus(status) {
         }
     }
 }
+export const MEMORY_TYPES = ['user', 'feedback', 'project', 'reference'];
+export function assertMemoryType(type) {
+    switch (type) {
+        case 'user':
+        case 'feedback':
+        case 'project':
+        case 'reference':
+            return;
+        default: {
+            const _exhaustive = type;
+            throw new Error(`Unknown MemoryType: ${_exhaustive}`);
+        }
+    }
+}
+export function isMemoryType(value) {
+    return typeof value === 'string' && MEMORY_TYPES.includes(value);
+}
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/memory/index.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,kBAAkB,CAAC,MAAoB;IACtD,QAAQ,MAAM,EAAE,CAAC;QAChB,KAAK,QAAQ,CAAC;QACd,KAAK,UAAU;YACd,OAAM;QACP,OAAO,CAAC,CAAC,CAAC;YACT,MAAM,WAAW,GAAU,MAAM,CAAA;YACjC,MAAM,IAAI,KAAK,CAAC,yBAAyB,WAAW,EAAE,CAAC,CAAA;QACxD,CAAC;IACF,CAAC;AACF,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/memory/index.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,kBAAkB,CAAC,MAAoB;IACtD,QAAQ,MAAM,EAAE,CAAC;QAChB,KAAK,QAAQ,CAAC;QACd,KAAK,UAAU;YACd,OAAM;QACP,OAAO,CAAC,CAAC,CAAC;YACT,MAAM,WAAW,GAAU,MAAM,CAAA;YACjC,MAAM,IAAI,KAAK,CAAC,yBAAyB,WAAW,EAAE,CAAC,CAAA;QACxD,CAAC;IACF,CAAC;AACF,CAAC;AAcD,MAAM,CAAC,MAAM,YAAY,GAA0B,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,CAAC,CAAA;AAE/F,MAAM,UAAU,gBAAgB,CAAC,IAAgB;IAChD,QAAQ,IAAI,EAAE,CAAC;QACd,KAAK,MAAM,CAAC;QACZ,KAAK,UAAU,CAAC;QAChB,KAAK,SAAS,CAAC;QACf,KAAK,WAAW;YACf,OAAM;QACP,OAAO,CAAC,CAAC,CAAC;YACT,MAAM,WAAW,GAAU,IAAI,CAAA;YAC/B,MAAM,IAAI,KAAK,CAAC,uBAAuB,WAAW,EAAE,CAAC,CAAA;QACtD,CAAC;IACF,CAAC;AACF,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc;IAC1C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,YAAkC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AACxF,CAAC"}

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

@@ -105,7 +105,7 @@ export interface Citation {
  * Inline base64 puts the bytes in the durable transcript, in every
  * checkpoint, in every compaction pass, and — because a conversation
  * resends its history — on the wire once per turn. A 4 MB PDF attached once
- * is 4 MB per request for the rest of the run.
+ * is 4 MB per request for the rest of the turn.
  */
 export interface StoredAttachmentRef {
     readonly type: 'stored';
@@ -157,7 +157,7 @@ export interface BaseMessage {
     /**
      * Exempt this message from compaction and from tool-result clearing.
      *
-     * Everything the run protected before was protected by POSITION — the
+     * Everything the turn protected before was protected by POSITION — the
      * leading system run, the working-memory slot, the last N turns, the
      * most recent tool results. A standing constraint stated in the middle
      * of a conversation ("the account id is X; never bill a different
@@ -171,10 +171,10 @@ export interface BaseMessage {
      * or an assistant-first retained tail, is not a smaller history — it is
      * one the provider rejects.
      *
-     * Pinned turns are exempt from the reclaim that keeps a long run
+     * Pinned turns are exempt from the reclaim that keeps a long turn
      * alive, so this is a budget the setter spends. Nothing caps it: a cap
      * would have to guess which pin mattered, and dropping the wrong one
-     * quietly is worse than a run that overflows in the open.
+     * quietly is worse than a turn that overflows in the open.
      */
     retain?: boolean;
 }

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

@@ -1,4 +1,4 @@
-import type { PlanId, RunId } from '../ids/index.js';
+import type { PlanId, SessionId, TurnId } from '../ids/index.js';
 export type PlanStatus = 'generating' | 'ready' | 'pending_approval' | 'approved' | 'rejected' | 'executing' | 'completed' | 'failed';
 export declare function isTerminalPlanStatus(status: PlanStatus): boolean;
 export interface PlanStep {
@@ -39,7 +39,8 @@ export interface PlanStep {
 }
 export interface Plan {
     id: PlanId;
-    runId: RunId;
+    sessionId: SessionId;
+    turnId: TurnId;
     status: PlanStatus;
     title: string;
     summary?: string;
@@ -67,7 +68,8 @@ export interface Plan {
 }
 export interface PlanApprovalRequest {
     planId: PlanId;
-    runId: RunId;
+    sessionId: SessionId;
+    turnId: TurnId;
     title: string;
     steps: PlanStep[];
     summary?: string;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/plan/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AAEpD,MAAM,MAAM,UAAU,GACnB,YAAY,GACZ,OAAO,GACP,kBAAkB,GAClB,UAAU,GACV,UAAU,GACV,WAAW,GACX,WAAW,GACX,QAAQ,CAAA;AAEX,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAEhE;AAED,MAAM,WAAW,QAAQ;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IAExB,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAA;IAClE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,IAAI;IACpB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,KAAK,CAAA;IACZ,MAAM,EAAE,UAAU,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,QAAQ,EAAE,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,eAAe,CAAC,EAAE,MAAM,CAAA;IAExB;;;;;;;;;;;OAWG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,mBAAmB;IACnC,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,KAAK,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,QAAQ,EAAE,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,oBAAoB;IACpC,QAAQ,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,QAAQ,EAAE,CAAA;CAC1B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/plan/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAEhE,MAAM,MAAM,UAAU,GACnB,YAAY,GACZ,OAAO,GACP,kBAAkB,GAClB,UAAU,GACV,UAAU,GACV,WAAW,GACX,WAAW,GACX,QAAQ,CAAA;AAEX,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAEhE;AAED,MAAM,WAAW,QAAQ;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IAExB,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAA;IAClE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,IAAI;IACpB,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,SAAS,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,UAAU,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,QAAQ,EAAE,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,eAAe,CAAC,EAAE,MAAM,CAAA;IAExB;;;;;;;;;;;OAWG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,mBAAmB;IACnC,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,SAAS,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,QAAQ,EAAE,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,oBAAoB;IACpC,QAAQ,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,QAAQ,EAAE,CAAA;CAC1B"}