opencode-swarm 7.164.1 → 7.164.3

package/dist/cli/{pr-workflow-gate-0zvp0qs9.js → pr-workflow-gate-v5wh09wz.js}

@@ -77,64 +77,64 @@ import {
   withPrWorkflowCheckoutMutationLock,
   withPrWorkflowCheckoutPreparationLock,
   writePrWorkflowAtomicJson
-} from "./index-2ee2g27m.js";
-import"./index-6097tx05.js";
-import"./index-wv4b01ex.js";
-import"./index-r5jn0ah5.js";
-import"./index-5084szce.js";
-import"./index-vkckf2ch.js";
+} from "./index-ehf0vjhx.js";
+import"./index-2xj34nkh.js";
+import"./index-8t11vcf5.js";
+import"./index-aty2dfmt.js";
+import"./index-493mxwj5.js";
+import"./index-w5jpjaqe.js";
 import"./index-txdagbh7.js";
 import"./index-3146wmgv.js";
-import"./index-e630pvvw.js";
-import"./index-6ay5zp1v.js";
-import"./index-h2f21caa.js";
+import"./index-88g6q52x.js";
+import"./index-rhdwrfgc.js";
+import"./index-xkqja15t.js";
 import"./index-70ha9e09.js";
 import"./index-y2f5s2cf.js";
 import"./index-hcn69kp0.js";
 import"./index-zaab1wz9.js";
-import"./index-x2qmpkth.js";
+import"./index-c8k4cs94.js";
 import"./index-zsrtt42s.js";
-import"./index-hzaw10zh.js";
+import"./index-9pwa798m.js";
 import"./index-3f7hqtgg.js";
 import"./index-qbr05tbw.js";
-import"./index-wnf1ej2q.js";
-import"./index-k8j7m0e2.js";
+import"./index-fc153g7b.js";
+import"./index-sb4eanpv.js";
 import"./index-rtry5xyf.js";
-import"./index-n1wcq816.js";
-import"./index-5bza8nxz.js";
+import"./index-jwc2v92w.js";
+import"./index-kn0y788q.js";
 import {
   PR_REVIEW_BASE_DIMENSION_IDS
-} from "./index-yc415pzf.js";
+} from "./index-kyayzfxp.js";
 import"./index-ddszzne4.js";
-import"./index-b98r3pyv.js";
-import"./index-vdgw2k4c.js";
-import"./index-dhzsvmx6.js";
+import"./index-sn2vm710.js";
+import"./index-yhpbcrdk.js";
+import"./index-0145kpjr.js";
 import"./index-556ja8an.js";
 import"./index-4fwbbad3.js";
 import"./index-b43rt5ph.js";
 import"./index-q7sjgr1y.js";
-import"./index-jczbtx2x.js";
-import"./index-1af3rb5n.js";
-import"./index-pmmfhzsp.js";
+import"./index-0e34njnm.js";
+import"./index-95hhrw1d.js";
+import"./index-j98116cx.js";
 import"./index-zg9d392c.js";
 import"./index-n832052r.js";
 import"./index-v56mhyhs.js";
 import"./index-z6xqpmqg.js";
 import"./index-r3mvsbtq.js";
-import"./index-862c0xhc.js";
-import"./index-2s40e3b0.js";
+import"./index-4wneygfx.js";
+import"./index-84qah5h6.js";
 import"./index-9e6fdz2h.js";
 import"./index-4rhhvd1a.js";
-import"./index-j0ajeary.js";
-import"./index-2yd732fd.js";
+import"./index-ac39znep.js";
+import"./index-m1nrd3yd.js";
 import"./index-zjygnfay.js";
 import"./index-ae75rja9.js";
-import"./index-6kd3jnaf.js";
-import"./index-6t35714n.js";
+import"./index-5d7bzpfn.js";
+import"./index-zs1jrsta.js";
 import"./index-bk5tah7q.js";
-import"./index-36nt17m8.js";
+import"./index-yep24wn4.js";
 import"./index-f9nfknjg.js";
-import"./index-1b1h770t.js";
+import"./index-bzd67m2j.js";
 import"./index-7g4c7s5r.js";
 import"./index-bpmtbmy9.js";
 import"./index-zgwm4ryv.js";

package/dist/cli/{runner-s55g5233.js → runner-m95v9d47.js}

@@ -3,14 +3,14 @@ import {
   _internals,
   createModelEvaluationExecutor,
   runEvaluation
-} from "./index-6097tx05.js";
-import"./index-vkckf2ch.js";
+} from "./index-2xj34nkh.js";
+import"./index-w5jpjaqe.js";
 import"./index-txdagbh7.js";
 import"./index-r3mvsbtq.js";
-import"./index-6t35714n.js";
-import"./index-36nt17m8.js";
+import"./index-zs1jrsta.js";
+import"./index-yep24wn4.js";
 import"./index-f9nfknjg.js";
-import"./index-1b1h770t.js";
+import"./index-bzd67m2j.js";
 import"./index-7g4c7s5r.js";
 import"./index-bpmtbmy9.js";
 import"./index-zgwm4ryv.js";

package/dist/cli/{scan-cursor-z6zepy3r.js → scan-cursor-6x0sqjer.js}

@@ -4,17 +4,17 @@ import {
   alreadyCuratedThisGeneration,
   claimNextScanBatch,
   getScanStatus
-} from "./index-h2f21caa.js";
-import"./index-jczbtx2x.js";
+} from "./index-xkqja15t.js";
+import"./index-0e34njnm.js";
 import"./index-9e6fdz2h.js";
 import"./index-4rhhvd1a.js";
 import"./index-ae75rja9.js";
-import"./index-6kd3jnaf.js";
-import"./index-6t35714n.js";
+import"./index-5d7bzpfn.js";
+import"./index-zs1jrsta.js";
 import"./index-bk5tah7q.js";
-import"./index-36nt17m8.js";
+import"./index-yep24wn4.js";
 import"./index-f9nfknjg.js";
-import"./index-1b1h770t.js";
+import"./index-bzd67m2j.js";
 import"./index-7g4c7s5r.js";
 import"./index-bpmtbmy9.js";
 import"./index-zgwm4ryv.js";

package/dist/cli/{schema-skf0ckh4.js → schema-mgpsycrr.js}

@@ -102,8 +102,8 @@ import {
   resolveGeneratedAgentRole,
   resolveGuardrailsConfig,
   stripKnownSwarmPrefix
-} from "./index-2s40e3b0.js";
-import"./index-2yd732fd.js";
+} from "./index-84qah5h6.js";
+import"./index-m1nrd3yd.js";
 import"./index-zjygnfay.js";
 import"./index-bk5tah7q.js";
 import"./index-bpmtbmy9.js";

package/dist/cli/{scope-persistence-f6davq7x.js → scope-persistence-pwqshfyr.js}

@@ -23,21 +23,21 @@ import {
   tombstoneScopeBinding,
   writeScopeBindingToDisk,
   writeScopeToDisk
-} from "./index-b98r3pyv.js";
-import"./index-vdgw2k4c.js";
-import"./index-dhzsvmx6.js";
+} from "./index-sn2vm710.js";
+import"./index-yhpbcrdk.js";
+import"./index-0145kpjr.js";
 import"./index-556ja8an.js";
-import"./index-862c0xhc.js";
-import"./index-2s40e3b0.js";
+import"./index-4wneygfx.js";
+import"./index-84qah5h6.js";
 import"./index-9e6fdz2h.js";
 import"./index-4rhhvd1a.js";
-import"./index-j0ajeary.js";
-import"./index-2yd732fd.js";
+import"./index-ac39znep.js";
+import"./index-m1nrd3yd.js";
 import"./index-zjygnfay.js";
 import"./index-bk5tah7q.js";
-import"./index-36nt17m8.js";
+import"./index-yep24wn4.js";
 import"./index-f9nfknjg.js";
-import"./index-1b1h770t.js";
+import"./index-bzd67m2j.js";
 import"./index-7g4c7s5r.js";
 import"./index-bpmtbmy9.js";
 import"./index-zgwm4ryv.js";

package/dist/cli/{skill-generator-wqbazppk.js → skill-generator-bywdfza0.js}

@@ -33,33 +33,33 @@ import {
   sanitizeSlug,
   selectCandidateEntries,
   writeEvalStub
-} from "./index-e630pvvw.js";
-import"./index-wnf1ej2q.js";
-import"./index-k8j7m0e2.js";
+} from "./index-88g6q52x.js";
+import"./index-fc153g7b.js";
+import"./index-sb4eanpv.js";
 import"./index-rtry5xyf.js";
 import"./index-q7sjgr1y.js";
-import"./index-jczbtx2x.js";
-import"./index-1af3rb5n.js";
-import"./index-pmmfhzsp.js";
+import"./index-0e34njnm.js";
+import"./index-95hhrw1d.js";
+import"./index-j98116cx.js";
 import"./index-zg9d392c.js";
 import"./index-n832052r.js";
 import"./index-v56mhyhs.js";
 import"./index-z6xqpmqg.js";
 import"./index-r3mvsbtq.js";
-import"./index-862c0xhc.js";
-import"./index-2s40e3b0.js";
+import"./index-4wneygfx.js";
+import"./index-84qah5h6.js";
 import"./index-9e6fdz2h.js";
 import"./index-4rhhvd1a.js";
-import"./index-j0ajeary.js";
-import"./index-2yd732fd.js";
+import"./index-ac39znep.js";
+import"./index-m1nrd3yd.js";
 import"./index-zjygnfay.js";
 import"./index-ae75rja9.js";
-import"./index-6kd3jnaf.js";
-import"./index-6t35714n.js";
+import"./index-5d7bzpfn.js";
+import"./index-zs1jrsta.js";
 import"./index-bk5tah7q.js";
-import"./index-36nt17m8.js";
+import"./index-yep24wn4.js";
 import"./index-f9nfknjg.js";
-import"./index-1b1h770t.js";
+import"./index-bzd67m2j.js";
 import"./index-7g4c7s5r.js";
 import"./index-bpmtbmy9.js";
 import"./index-zgwm4ryv.js";

package/dist/cli/{telemetry-q51s6tyt.js → telemetry-c4j18da8.js}

@@ -14,7 +14,7 @@ import {
   startHeartbeatTracking,
   stopHeartbeatTracking,
   telemetry
-} from "./index-1b1h770t.js";
+} from "./index-bzd67m2j.js";
 import"./index-bpmtbmy9.js";
 import"./index-a76rekgs.js";
 export {

package/dist/cli/{worktree-collision-ownership-c0030qbm.js → worktree-collision-ownership-71x5pqfz.js}

@@ -10,7 +10,7 @@ import {
 import {
   scanDelegationFallbacksForRecovery,
   scanDelegationsForRecovery
-} from "./index-yc415pzf.js";
+} from "./index-kyayzfxp.js";
 import"./index-ddszzne4.js";
 import"./index-v56mhyhs.js";
 import"./index-z6xqpmqg.js";
@@ -22,11 +22,11 @@ import {
   resolveGitExecutable
 } from "./index-9e6fdz2h.js";
 import"./index-4rhhvd1a.js";
-import"./index-j0ajeary.js";
+import"./index-ac39znep.js";
 import"./index-zjygnfay.js";
-import"./index-36nt17m8.js";
+import"./index-yep24wn4.js";
 import"./index-f9nfknjg.js";
-import"./index-1b1h770t.js";
+import"./index-bzd67m2j.js";
 import"./index-7g4c7s5r.js";
 import"./index-bpmtbmy9.js";
 import"./index-zgwm4ryv.js";

package/dist/cli/{worktree-isolation-09qq8066.js → worktree-isolation-e6tym281.js}

@@ -21,64 +21,64 @@ import {
   sanitizeWorktreeTaskId,
   standardWorktreeByCallID,
   standardWorktreeSerializationSessions
-} from "./index-2ee2g27m.js";
-import"./index-6097tx05.js";
-import"./index-wv4b01ex.js";
-import"./index-r5jn0ah5.js";
-import"./index-5084szce.js";
-import"./index-vkckf2ch.js";
+} from "./index-ehf0vjhx.js";
+import"./index-2xj34nkh.js";
+import"./index-8t11vcf5.js";
+import"./index-aty2dfmt.js";
+import"./index-493mxwj5.js";
+import"./index-w5jpjaqe.js";
 import"./index-txdagbh7.js";
 import"./index-3146wmgv.js";
-import"./index-e630pvvw.js";
-import"./index-6ay5zp1v.js";
-import"./index-h2f21caa.js";
+import"./index-88g6q52x.js";
+import"./index-rhdwrfgc.js";
+import"./index-xkqja15t.js";
 import"./index-70ha9e09.js";
 import"./index-y2f5s2cf.js";
 import"./index-hcn69kp0.js";
 import"./index-zaab1wz9.js";
-import"./index-x2qmpkth.js";
+import"./index-c8k4cs94.js";
 import"./index-zsrtt42s.js";
-import"./index-hzaw10zh.js";
+import"./index-9pwa798m.js";
 import"./index-3f7hqtgg.js";
 import"./index-qbr05tbw.js";
-import"./index-wnf1ej2q.js";
-import"./index-k8j7m0e2.js";
+import"./index-fc153g7b.js";
+import"./index-sb4eanpv.js";
 import"./index-rtry5xyf.js";
-import"./index-n1wcq816.js";
-import"./index-5bza8nxz.js";
-import"./index-yc415pzf.js";
+import"./index-jwc2v92w.js";
+import"./index-kn0y788q.js";
+import"./index-kyayzfxp.js";
 import"./index-ddszzne4.js";
-import"./index-b98r3pyv.js";
-import"./index-vdgw2k4c.js";
-import"./index-dhzsvmx6.js";
+import"./index-sn2vm710.js";
+import"./index-yhpbcrdk.js";
+import"./index-0145kpjr.js";
 import"./index-556ja8an.js";
 import"./index-4fwbbad3.js";
 import"./index-b43rt5ph.js";
 import"./index-q7sjgr1y.js";
-import"./index-jczbtx2x.js";
-import"./index-1af3rb5n.js";
+import"./index-0e34njnm.js";
+import"./index-95hhrw1d.js";
 import {
   resolveWorktreeIsolationConfig
-} from "./index-pmmfhzsp.js";
+} from "./index-j98116cx.js";
 import"./index-zg9d392c.js";
 import"./index-n832052r.js";
 import"./index-v56mhyhs.js";
 import"./index-z6xqpmqg.js";
 import"./index-r3mvsbtq.js";
-import"./index-862c0xhc.js";
-import"./index-2s40e3b0.js";
+import"./index-4wneygfx.js";
+import"./index-84qah5h6.js";
 import"./index-9e6fdz2h.js";
 import"./index-4rhhvd1a.js";
-import"./index-j0ajeary.js";
-import"./index-2yd732fd.js";
+import"./index-ac39znep.js";
+import"./index-m1nrd3yd.js";
 import"./index-zjygnfay.js";
 import"./index-ae75rja9.js";
-import"./index-6kd3jnaf.js";
-import"./index-6t35714n.js";
+import"./index-5d7bzpfn.js";
+import"./index-zs1jrsta.js";
 import"./index-bk5tah7q.js";
-import"./index-36nt17m8.js";
+import"./index-yep24wn4.js";
 import"./index-f9nfknjg.js";
-import"./index-1b1h770t.js";
+import"./index-bzd67m2j.js";
 import"./index-7g4c7s5r.js";
 import"./index-bpmtbmy9.js";
 import"./index-zgwm4ryv.js";

package/dist/hooks/delegate-ack-collector.d.ts

@@ -27,6 +27,7 @@
  * durable `delegate_directive` memberships) and Task collections share ONE
  * implementation — not a second lifecycle copy.
  */
+import { type TaskIdResolution } from './task-id-resolver.js';
 export interface DelegateAckInput {
     tool: unknown;
     agent?: unknown;
@@ -36,6 +37,8 @@ export interface DelegateAckInput {
 export interface DelegateAckOutput {
     output?: unknown;
 }
+/** Best-effort extraction of a task id from a delegation prompt envelope. */
+export declare function resolveDelegateAckTaskId(args: Record<string, unknown>, knownPlanTaskIds?: ReadonlySet<string>, planContextOverLimit?: boolean): string | undefined;
 export interface CollectDelegateAcksResult {
     emitted: Array<{
         id: string;
@@ -113,6 +116,8 @@ export declare function collectDelegateAcks(params: {
     agent: string;
     sessionId?: string;
     taskId?: string;
+    /** A caller-owned resolution attempt; non-resolved states forbid reparsing. */
+    taskIdResolution?: TaskIdResolution;
 }): Promise<CollectDelegateAcksResult>;
 export interface CollectLaneDelegateAcksResult extends CollectDelegateAcksResult {
     /**

package/dist/hooks/delegation-gate.d.ts

@@ -11,6 +11,9 @@ import { type QaGates } from '../db/qa-gate-profile.js';
 import { loadPlanJsonOnly } from '../plan/manager';
 import type { AgentSessionState } from '../state';
 import type { DelegationEnvelope, EnvelopeValidationResult } from '../types/delegation.js';
+import { type PlanTaskIdContext } from './plan-task-id-context.js';
+import { resolveDelegatedPlanTaskId } from './task-id-resolver.js';
+export { resolveDelegatedPlanTaskId } from './task-id-resolver.js';
 import { resetStandardWorktreeIsolationState } from './delegation-gate/worktree-isolation';
 export { resetStandardWorktreeIsolationState };
 import { _internals as _wtiInternals } from './delegation-gate/worktree-isolation';
@@ -351,6 +354,14 @@ interface MessageWithParts {
     info: MessageInfo;
     parts: MessagePart[];
 }
+/**
+ * Extracts a plan task ID (N.M or N.M.P format) from text.
+ * Checks for:
+ * 1. Task IDs in task list format: "- [ ] 1.1: ..." or "- [x] 1.1: ..."
+ * 2. Standalone task IDs like "1.1" or "1.2.3" near the TASK: line
+ * Returns the plan task ID if found, otherwise null.
+ */
+declare function extractPlanTaskId(text: string): string | null;
 declare function extractPlanCriticVerdict(output: unknown): 'APPROVED' | 'NEEDS_REVISION' | 'REJECTED' | null;
 /**
  * Returns whether the plan in the given directory has a valid plan-critic
@@ -407,7 +418,6 @@ export declare function forceRecordPlanCriticApproval(directory: string, session
     reason?: string;
     userConfirmed: boolean;
 }>;
-export declare function resolveDelegatedPlanTaskId(args: Record<string, unknown>, knownPlanTaskIds?: ReadonlySet<string>): string | null;
 /**
  * Builds a cause-specific diagnostic for `prepareCoderScope`'s SCOPE_NOT_DECLARED
  * throw when `resolveDelegatedPlanTaskId` returns null. Re-runs extraction with
@@ -418,7 +428,7 @@ export declare function resolveDelegatedPlanTaskId(args: Record<string, unknown>
  * latency, and does NOT handle plan-task-shaped-but-unknown ids (those are
  * rejected by the membership gate in prepareCoderScope with their own message).
  */
-declare function describeCoderScopeFailure(args: Record<string, unknown>, planTaskIds: ReadonlySet<string>): string;
+declare function describeCoderScopeFailure(args: Record<string, unknown>, planTaskIdContext: PlanTaskIdContext): string;
 type FileDirectiveExtractionMode = 'enforce' | 'observe';
 declare function extractTaskFileDirectives(args: Record<string, unknown>, mode?: FileDirectiveExtractionMode): {
     present: boolean;
@@ -493,6 +503,7 @@ export declare const _internals: {
     resetStandardWorktreeIsolationState: typeof resetStandardWorktreeIsolationState;
     PLAN_CRITIC_TASK_SIGNALS: readonly ["critic-gate", "plan critic", "review plan", "review the plan", "plan.md", "approve the plan", "plan approval", "pre-implementation review", "evaluate this plan", "evaluate the plan", "assess this plan", "assess the plan", "plan soundness", "before implementation", "review the plan below"];
     extractPlanCriticVerdict: typeof extractPlanCriticVerdict;
+    extractPlanTaskId: typeof extractPlanTaskId;
     forceRecordPlanCriticApproval: typeof forceRecordPlanCriticApproval;
     beforePrFeedbackScopeConsume: (() => Promise<void>) | undefined;
     provisionWorktree: typeof _wtiInternals.provisionWorktree;

package/dist/hooks/plan-task-id-context.d.ts

@@ -0,0 +1,24 @@
+import { type TaskIdPlanContextOptions } from './task-id-resolver.js';
+export type PlanTaskIdContext = {
+    status: 'available';
+    taskIds: ReadonlySet<string>;
+} | {
+    status: 'unavailable';
+} | {
+    status: 'over_limit';
+};
+/** Traverse plan phases without first materializing an unbounded flat task list. */
+export declare function collectPlanTaskIdContextFromPhases(phases: ReadonlyArray<{
+    tasks?: ReadonlyArray<{
+        id?: string;
+    } | null> | null;
+} | null | undefined>): PlanTaskIdContext;
+/**
+ * Best-effort caller-side plan context for the pure task-ID resolver.
+ * Missing/corrupt plans remain distinguishable from valid plans whose task-ID
+ * cardinality exceeds the resolver bound. Callers must preserve that distinction
+ * so numeric IDs never become unfiltered when a plan is merely too large.
+ */
+export declare function loadPlanTaskIdContext(directory: string): Promise<PlanTaskIdContext>;
+/** Convert a typed loader result into the resolver's bounded plan context. */
+export declare function toTaskIdPlanContextOptions(context: PlanTaskIdContext): TaskIdPlanContextOptions;

package/dist/hooks/skill-injection.d.ts

@@ -15,9 +15,9 @@
  *     the three other recording sites in `skill-propagation-gate.ts`, (b) broke
  *     the SKILL_COMPLIANCE round-trip join except by coincidence, and (c)
  *     inflated frequency / taskID-diversity scoring. The fallback is
- *     `'auto-injected'` rather than `'unknown'` so the compliance resolver's
- *     `resolvedTaskID !== 'unknown'` guard at `skill-propagation-gate.ts:1302`
- *     continues to fire and populate fallback skill paths.
+ *     `'auto-injected'` to preserve a stable local audit ID for the injection
+ *     entry; reviewer compliance attribution still requires an explicit TASK
+ *     marker and otherwise fails closed as `'unknown'`.
  *
  *  2. Observability — a `skill_injection_decision` event is emitted to
  *     `.swarm/events.jsonl` for BOTH the qualified-injection and the
@@ -40,6 +40,10 @@ export interface RecommendedSkill {
 export interface SkillInjectionOptions {
     /** When true, suppresses console.warn output (does not affect event emission). */
     quiet?: boolean;
+    /** Caller-loaded finite plan IDs for plan-aware attribution. */
+    knownPlanTaskIds?: ReadonlySet<string>;
+    /** The caller observed a valid plan whose task-ID cardinality exceeded the bound. */
+    planContextOverLimit?: boolean;
 }
 /** Result of an injection attempt. */
 export interface SkillInjectionResult {

package/dist/hooks/skill-propagation-gate.d.ts

@@ -160,7 +160,7 @@ export declare function validateExplicitSkillReferencesBefore(directory: string,
  * Looks for patterns like "taskId: <id>" or "TASK: <id>" (case-insensitive).
  * Returns "unknown" when no pattern is found.
  */
-export declare function extractTaskIdFromPrompt(prompt: string): string;
+export declare function extractTaskIdFromPrompt(prompt: string, knownPlanTaskIds?: ReadonlySet<string>, planContextOverLimit?: boolean): string;
 /**
  * Pre-tool gate. When the architect delegates via Task tool to a skill-capable
  * agent and the SKILLS field is missing or 'none' while skills exist in the

package/dist/hooks/task-id-resolver.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Pure, bounded task-identity resolution shared by delegation hooks.
+ *
+ * This leaf deliberately performs no I/O and imports no plan, hook, or tool
+ * modules. Callers own plan loading and may supply only finite known IDs and an
+ * optional fallback whose uniqueness they have already proved.
+ */
+export declare const TASK_ID_RESOLUTION_LIMITS: {
+    readonly maxFields: 4;
+    readonly maxFieldChars: number;
+    readonly maxTotalChars: number;
+    readonly maxKnownIds: 1024;
+    readonly maxCandidates: 32;
+    readonly maxTokenChars: 80;
+};
+export type TaskIdPolicy = 'plan' | 'attribution';
+export type TaskIdSource = 'explicit' | 'task_line' | 'text' | 'marker' | 'fallback';
+export type TaskIdResolution = {
+    status: 'resolved';
+    taskId: string;
+    source: TaskIdSource;
+} | {
+    status: 'missing';
+} | {
+    status: 'ambiguous';
+    candidates: string[];
+} | {
+    status: 'over_limit';
+    input: string;
+} | {
+    status: 'invalid';
+    input: string;
+};
+export interface ResolveTaskIdOptions {
+    policy: TaskIdPolicy;
+    knownPlanTaskIds?: ReadonlySet<string>;
+    /** The caller observed a valid plan whose task-ID cardinality exceeded the bound. */
+    planContextOverLimit?: boolean;
+    fallback?: string;
+    fallbackProvenUnique?: boolean;
+}
+export type TaskIdPlanContextOptions = Pick<ResolveTaskIdOptions, 'knownPlanTaskIds' | 'planContextOverLimit'>;
+/** Resolve a task identity without I/O or mutable session state. */
+export declare function resolveTaskId(input: Record<string, unknown>, options: ResolveTaskIdOptions): TaskIdResolution;
+/** Backward-compatible delegation API backed by the bounded plan policy. */
+export declare function resolveDelegatedPlanTaskId(args: Record<string, unknown>, planContext?: ReadonlySet<string> | TaskIdPlanContextOptions): string | null;