jg-agent-hq 0.2.0 → 0.4.0

package/dist/contracts/types.d.ts

@@ -53,7 +53,7 @@ export declare const HqRequestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         }, z.core.$strict>;
         kind: z.ZodLiteral<"finalize">;
     }, z.core.$strict>, z.ZodObject<{
-        milestoneId: z.ZodUUID;
+        milestoneId: z.ZodNullable<z.ZodUUID>;
         checks: z.ZodArray<z.ZodObject<{
             command: z.ZodString;
             outcome: z.ZodLiteral<"passed">;
@@ -239,7 +239,7 @@ export declare const HqRequestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             breakdownDigest: z.ZodNullable<z.ZodString>;
         }, z.core.$strict>;
         authorizationId: z.ZodUUID;
-        milestoneId: z.ZodUUID;
+        milestoneId: z.ZodNullable<z.ZodUUID>;
         mode: z.ZodEnum<{
             supervised: "supervised";
             auto: "auto";
@@ -464,7 +464,7 @@ export declare const HqRequestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         plan: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
             kind: z.ZodLiteral<"execution">;
             authorizationId: z.ZodUUID;
-            milestoneId: z.ZodUUID;
+            milestoneId: z.ZodNullable<z.ZodUUID>;
             mode: z.ZodEnum<{
                 supervised: "supervised";
                 auto: "auto";
@@ -483,7 +483,7 @@ export declare const HqRequestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             scope: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 kind: z.ZodLiteral<"execution">;
                 authorizationId: z.ZodUUID;
-                milestoneId: z.ZodUUID;
+                milestoneId: z.ZodNullable<z.ZodUUID>;
                 mode: z.ZodEnum<{
                     supervised: "supervised";
                     auto: "auto";
@@ -514,6 +514,9 @@ export declare const HqRequestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strict>, z.ZodObject<{
     kind: z.ZodLiteral<"managed-thread">;
     threadId: z.ZodUUID;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"thread-plan">;
+    threadId: z.ZodUUID;
 }, z.core.$strict>, z.ZodObject<{
     kind: z.ZodLiteral<"managed-thread-name">;
     name: z.ZodString;
@@ -536,6 +539,7 @@ export declare const HqRequestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strict>, z.ZodObject<{
     kind: z.ZodLiteral<"live-items">;
     threadId: z.ZodUUID;
+    afterRevision: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>], "kind">;
 export type IHqRequest = z.infer<typeof HqRequestSchema>;
 export type IHqRequestInput = z.input<typeof HqRequestSchema>;
@@ -597,6 +601,8 @@ export declare const HistoryItemSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type IHistoryItem = z.infer<typeof HistoryItemSchema>;
 export declare const LiveItemsSchema: z.ZodObject<{
+    revision: z.ZodNumber;
+    unchanged: z.ZodBoolean;
     data: z.ZodArray<z.ZodObject<{
         nativeId: z.ZodString;
         turnId: z.ZodString;
@@ -687,6 +693,32 @@ export declare const RuntimeStatusSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type IRuntimeStatus = z.infer<typeof RuntimeStatusSchema>;
 export declare const HqResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"thread-plan">;
+    result: z.ZodNullable<z.ZodObject<{
+        directory: z.ZodString;
+        scope: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"execution">;
+            authorizationId: z.ZodUUID;
+            milestoneId: z.ZodNullable<z.ZodUUID>;
+            mode: z.ZodEnum<{
+                supervised: "supervised";
+                auto: "auto";
+            }>;
+            revision: z.ZodObject<{
+                planDigest: z.ZodString;
+                breakdownDigest: z.ZodNullable<z.ZodString>;
+            }, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"planning">;
+            revisionId: z.ZodUUID;
+            invocationId: z.ZodUUID;
+        }, z.core.$strict>], "kind">>;
+        observedRevision: z.ZodObject<{
+            planDigest: z.ZodString;
+            breakdownDigest: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"status">;
     result: z.ZodObject<{
         runtimeEpoch: z.ZodUUID;
@@ -797,7 +829,7 @@ export declare const HqResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                         planDigest: z.ZodString;
                         breakdownDigest: z.ZodNullable<z.ZodString>;
                     }, z.core.$strict>;
-                    fileHash: z.ZodString;
+                    fileHash: z.ZodNullable<z.ZodString>;
                     createdAt: z.ZodNumber;
                 }, z.core.$strict>>;
                 planApproval: z.ZodNullable<z.ZodObject<{
@@ -1017,7 +1049,7 @@ export declare const HqResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                         planDigest: z.ZodString;
                         breakdownDigest: z.ZodNullable<z.ZodString>;
                     }, z.core.$strict>;
-                    fileHash: z.ZodString;
+                    fileHash: z.ZodNullable<z.ZodString>;
                     createdAt: z.ZodNumber;
                 }, z.core.$strict>>;
                 planApproval: z.ZodNullable<z.ZodObject<{
@@ -1205,7 +1237,7 @@ export declare const HqResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                             reference: z.ZodString;
                         }, z.core.$strict>;
                     }, z.core.$strict>;
-                    milestoneId: z.ZodUUID;
+                    milestoneId: z.ZodNullable<z.ZodUUID>;
                     revision: z.ZodObject<{
                         planDigest: z.ZodString;
                         breakdownDigest: z.ZodNullable<z.ZodString>;
@@ -1213,7 +1245,7 @@ export declare const HqResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                     contractDigest: z.ZodString;
                     title: z.ZodString;
                     contract: z.ZodString;
-                    sharedDigest: z.ZodString;
+                    sharedDigest: z.ZodNullable<z.ZodString>;
                     checkouts: z.ZodArray<z.ZodObject<{
                         repository: z.ZodString;
                         directory: z.ZodString;
@@ -1361,7 +1393,7 @@ export declare const HqResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                         planDigest: z.ZodString;
                         breakdownDigest: z.ZodNullable<z.ZodString>;
                     }, z.core.$strict>;
-                    fileHash: z.ZodString;
+                    fileHash: z.ZodNullable<z.ZodString>;
                     createdAt: z.ZodNumber;
                 }, z.core.$strict>>;
                 planApproval: z.ZodNullable<z.ZodObject<{
@@ -1500,7 +1532,7 @@ export declare const HqResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 }, z.core.$strict>>;
             }, z.core.$strict>;
         }, z.core.$strip>;
-        content: z.ZodString;
+        content: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<"milestones">;
         result: z.ZodObject<{
@@ -1581,7 +1613,7 @@ export declare const HqResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                     scope: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
                         kind: z.ZodLiteral<"execution">;
                         authorizationId: z.ZodUUID;
-                        milestoneId: z.ZodUUID;
+                        milestoneId: z.ZodNullable<z.ZodUUID>;
                         mode: z.ZodEnum<{
                             supervised: "supervised";
                             auto: "auto";
@@ -1714,7 +1746,7 @@ export declare const HqResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                     scope: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
                         kind: z.ZodLiteral<"execution">;
                         authorizationId: z.ZodUUID;
-                        milestoneId: z.ZodUUID;
+                        milestoneId: z.ZodNullable<z.ZodUUID>;
                         mode: z.ZodEnum<{
                             supervised: "supervised";
                             auto: "auto";
@@ -2051,7 +2083,7 @@ export declare const HqResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             scope: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 kind: z.ZodLiteral<"execution">;
                 authorizationId: z.ZodUUID;
-                milestoneId: z.ZodUUID;
+                milestoneId: z.ZodNullable<z.ZodUUID>;
                 mode: z.ZodEnum<{
                     supervised: "supervised";
                     auto: "auto";
@@ -2127,7 +2159,7 @@ export declare const HqResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             scope: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 kind: z.ZodLiteral<"execution">;
                 authorizationId: z.ZodUUID;
-                milestoneId: z.ZodUUID;
+                milestoneId: z.ZodNullable<z.ZodUUID>;
                 mode: z.ZodEnum<{
                     supervised: "supervised";
                     auto: "auto";
@@ -2315,7 +2347,7 @@ export declare const HqResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 scope: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
                     kind: z.ZodLiteral<"execution">;
                     authorizationId: z.ZodUUID;
-                    milestoneId: z.ZodUUID;
+                    milestoneId: z.ZodNullable<z.ZodUUID>;
                     mode: z.ZodEnum<{
                         supervised: "supervised";
                         auto: "auto";
@@ -2406,6 +2438,8 @@ export declare const HqResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"live-items">;
     result: z.ZodObject<{
+        revision: z.ZodNumber;
+        unchanged: z.ZodBoolean;
         data: z.ZodArray<z.ZodObject<{
             nativeId: z.ZodString;
             turnId: z.ZodString;
@@ -2496,7 +2530,7 @@ export declare const IpcRequestSchema: z.ZodObject<{
             }, z.core.$strict>;
             kind: z.ZodLiteral<"finalize">;
         }, z.core.$strict>, z.ZodObject<{
-            milestoneId: z.ZodUUID;
+            milestoneId: z.ZodNullable<z.ZodUUID>;
             checks: z.ZodArray<z.ZodObject<{
                 command: z.ZodString;
                 outcome: z.ZodLiteral<"passed">;
@@ -2682,7 +2716,7 @@ export declare const IpcRequestSchema: z.ZodObject<{
                 breakdownDigest: z.ZodNullable<z.ZodString>;
             }, z.core.$strict>;
             authorizationId: z.ZodUUID;
-            milestoneId: z.ZodUUID;
+            milestoneId: z.ZodNullable<z.ZodUUID>;
             mode: z.ZodEnum<{
                 supervised: "supervised";
                 auto: "auto";
@@ -2907,7 +2941,7 @@ export declare const IpcRequestSchema: z.ZodObject<{
             plan: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 kind: z.ZodLiteral<"execution">;
                 authorizationId: z.ZodUUID;
-                milestoneId: z.ZodUUID;
+                milestoneId: z.ZodNullable<z.ZodUUID>;
                 mode: z.ZodEnum<{
                     supervised: "supervised";
                     auto: "auto";
@@ -2926,7 +2960,7 @@ export declare const IpcRequestSchema: z.ZodObject<{
                 scope: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
                     kind: z.ZodLiteral<"execution">;
                     authorizationId: z.ZodUUID;
-                    milestoneId: z.ZodUUID;
+                    milestoneId: z.ZodNullable<z.ZodUUID>;
                     mode: z.ZodEnum<{
                         supervised: "supervised";
                         auto: "auto";
@@ -2957,6 +2991,9 @@ export declare const IpcRequestSchema: z.ZodObject<{
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"managed-thread">;
         threadId: z.ZodUUID;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"thread-plan">;
+        threadId: z.ZodUUID;
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"managed-thread-name">;
         name: z.ZodString;
@@ -2979,6 +3016,7 @@ export declare const IpcRequestSchema: z.ZodObject<{
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"live-items">;
         threadId: z.ZodUUID;
+        afterRevision: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>], "kind">;
 }, z.core.$strict>;
 export declare const IpcResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -2986,6 +3024,32 @@ export declare const IpcResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     id: z.ZodUUID;
     success: z.ZodLiteral<true>;
     response: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"thread-plan">;
+        result: z.ZodNullable<z.ZodObject<{
+            directory: z.ZodString;
+            scope: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"execution">;
+                authorizationId: z.ZodUUID;
+                milestoneId: z.ZodNullable<z.ZodUUID>;
+                mode: z.ZodEnum<{
+                    supervised: "supervised";
+                    auto: "auto";
+                }>;
+                revision: z.ZodObject<{
+                    planDigest: z.ZodString;
+                    breakdownDigest: z.ZodNullable<z.ZodString>;
+                }, z.core.$strict>;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"planning">;
+                revisionId: z.ZodUUID;
+                invocationId: z.ZodUUID;
+            }, z.core.$strict>], "kind">>;
+            observedRevision: z.ZodObject<{
+                planDigest: z.ZodString;
+                breakdownDigest: z.ZodNullable<z.ZodString>;
+            }, z.core.$strict>;
+        }, z.core.$strict>>;
+    }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<"status">;
         result: z.ZodObject<{
             runtimeEpoch: z.ZodUUID;
@@ -3096,7 +3160,7 @@ export declare const IpcResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                             planDigest: z.ZodString;
                             breakdownDigest: z.ZodNullable<z.ZodString>;
                         }, z.core.$strict>;
-                        fileHash: z.ZodString;
+                        fileHash: z.ZodNullable<z.ZodString>;
                         createdAt: z.ZodNumber;
                     }, z.core.$strict>>;
                     planApproval: z.ZodNullable<z.ZodObject<{
@@ -3316,7 +3380,7 @@ export declare const IpcResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                             planDigest: z.ZodString;
                             breakdownDigest: z.ZodNullable<z.ZodString>;
                         }, z.core.$strict>;
-                        fileHash: z.ZodString;
+                        fileHash: z.ZodNullable<z.ZodString>;
                         createdAt: z.ZodNumber;
                     }, z.core.$strict>>;
                     planApproval: z.ZodNullable<z.ZodObject<{
@@ -3504,7 +3568,7 @@ export declare const IpcResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                                 reference: z.ZodString;
                             }, z.core.$strict>;
                         }, z.core.$strict>;
-                        milestoneId: z.ZodUUID;
+                        milestoneId: z.ZodNullable<z.ZodUUID>;
                         revision: z.ZodObject<{
                             planDigest: z.ZodString;
                             breakdownDigest: z.ZodNullable<z.ZodString>;
@@ -3512,7 +3576,7 @@ export declare const IpcResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                         contractDigest: z.ZodString;
                         title: z.ZodString;
                         contract: z.ZodString;
-                        sharedDigest: z.ZodString;
+                        sharedDigest: z.ZodNullable<z.ZodString>;
                         checkouts: z.ZodArray<z.ZodObject<{
                             repository: z.ZodString;
                             directory: z.ZodString;
@@ -3660,7 +3724,7 @@ export declare const IpcResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                             planDigest: z.ZodString;
                             breakdownDigest: z.ZodNullable<z.ZodString>;
                         }, z.core.$strict>;
-                        fileHash: z.ZodString;
+                        fileHash: z.ZodNullable<z.ZodString>;
                         createdAt: z.ZodNumber;
                     }, z.core.$strict>>;
                     planApproval: z.ZodNullable<z.ZodObject<{
@@ -3799,7 +3863,7 @@ export declare const IpcResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                     }, z.core.$strict>>;
                 }, z.core.$strict>;
             }, z.core.$strip>;
-            content: z.ZodString;
+            content: z.ZodNullable<z.ZodString>;
         }, z.core.$strip>, z.ZodObject<{
             kind: z.ZodLiteral<"milestones">;
             result: z.ZodObject<{
@@ -3880,7 +3944,7 @@ export declare const IpcResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                         scope: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
                             kind: z.ZodLiteral<"execution">;
                             authorizationId: z.ZodUUID;
-                            milestoneId: z.ZodUUID;
+                            milestoneId: z.ZodNullable<z.ZodUUID>;
                             mode: z.ZodEnum<{
                                 supervised: "supervised";
                                 auto: "auto";
@@ -4013,7 +4077,7 @@ export declare const IpcResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                         scope: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
                             kind: z.ZodLiteral<"execution">;
                             authorizationId: z.ZodUUID;
-                            milestoneId: z.ZodUUID;
+                            milestoneId: z.ZodNullable<z.ZodUUID>;
                             mode: z.ZodEnum<{
                                 supervised: "supervised";
                                 auto: "auto";
@@ -4350,7 +4414,7 @@ export declare const IpcResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 scope: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
                     kind: z.ZodLiteral<"execution">;
                     authorizationId: z.ZodUUID;
-                    milestoneId: z.ZodUUID;
+                    milestoneId: z.ZodNullable<z.ZodUUID>;
                     mode: z.ZodEnum<{
                         supervised: "supervised";
                         auto: "auto";
@@ -4426,7 +4490,7 @@ export declare const IpcResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 scope: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
                     kind: z.ZodLiteral<"execution">;
                     authorizationId: z.ZodUUID;
-                    milestoneId: z.ZodUUID;
+                    milestoneId: z.ZodNullable<z.ZodUUID>;
                     mode: z.ZodEnum<{
                         supervised: "supervised";
                         auto: "auto";
@@ -4614,7 +4678,7 @@ export declare const IpcResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                     scope: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
                         kind: z.ZodLiteral<"execution">;
                         authorizationId: z.ZodUUID;
-                        milestoneId: z.ZodUUID;
+                        milestoneId: z.ZodNullable<z.ZodUUID>;
                         mode: z.ZodEnum<{
                             supervised: "supervised";
                             auto: "auto";
@@ -4705,6 +4769,8 @@ export declare const IpcResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<"live-items">;
         result: z.ZodObject<{
+            revision: z.ZodNumber;
+            unchanged: z.ZodBoolean;
             data: z.ZodArray<z.ZodObject<{
                 nativeId: z.ZodString;
                 turnId: z.ZodString;

package/dist/contracts/types.js

@@ -4,7 +4,7 @@ import { SkillIdSchema, SkillPageSchema, SkillPreviewSchema } from './skills/ind
 import { HandoffCommandSchema, HandoffResultSchema } from './handoffs/index.js';
 import { NativeIdSchema } from './identities/index.js';
 import { PlanCommandSchema, PlanResultSchema } from './plans/index.js';
-import { ActionEnvelopeSchema, ActionReceiptSchema, ActionSummarySchema, ManagedThreadSchema, NativeApprovalSchema, LifecycleEventSchema, } from './actions/index.js';
+import { ActionPlanContextSchema, ActionEnvelopeSchema, ActionReceiptSchema, ActionSummarySchema, ManagedThreadSchema, NativeApprovalSchema, LifecycleEventSchema, } from './actions/index.js';
 // opaque native identifiers, bounded independently of provider-specific formats
 const CursorSchema = z.string().min(1).max(16_384);
 const PageFields = {
@@ -58,6 +58,7 @@ export const HqRequestSchema = z.discriminatedUnion('kind', [
         ...PageFields,
     }),
     z.strictObject({ kind: z.literal('managed-thread'), threadId: z.uuid() }),
+    z.strictObject({ kind: z.literal('thread-plan'), threadId: z.uuid() }),
     z.strictObject({
         kind: z.literal('managed-thread-name'),
         name: z.string().regex(/^[a-z0-9][a-z0-9-]{0,31}$/i),
@@ -71,7 +72,11 @@ export const HqRequestSchema = z.discriminatedUnion('kind', [
         limit: PageFields.limit,
     }),
     z.strictObject({ kind: z.literal('approvals'), threadId: z.uuid() }),
-    z.strictObject({ kind: z.literal('live-items'), threadId: z.uuid() }),
+    z.strictObject({
+        kind: z.literal('live-items'),
+        threadId: z.uuid(),
+        afterRevision: z.number().int().nonnegative().optional(),
+    }),
 ]);
 // native discovery is external/read-only until explicitly adopted for control
 export const ThreadSummarySchema = z.object({
@@ -102,6 +107,8 @@ export const HistoryItemSchema = z.object({
     isTruncated: z.boolean(),
 });
 export const LiveItemsSchema = z.object({
+    revision: z.number().int().nonnegative(),
+    unchanged: z.boolean(),
     data: z.array(HistoryItemSchema.extend({ state: z.enum(['active', 'awaiting-flush']) })).max(128),
     hasGap: z.boolean(),
 });
@@ -141,6 +148,7 @@ export const RuntimeStatusSchema = z.object({
 });
 const PageResultFields = { nextCursor: CursorSchema.nullable(), source: z.literal('native') };
 export const HqResponseSchema = z.discriminatedUnion('kind', [
+    z.object({ kind: z.literal('thread-plan'), result: ActionPlanContextSchema.nullable() }),
     z.object({ kind: z.literal('status'), result: RuntimeStatusSchema }),
     z.object({ kind: z.literal('plan'), result: PlanResultSchema }),
     z.object({ kind: z.literal('handoff'), result: HandoffResultSchema }),

package/dist/handoffs/types.d.ts

@@ -19,7 +19,7 @@ export declare const HandoffRecordSchema: z.ZodObject<{
             scope: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 kind: z.ZodLiteral<"execution">;
                 authorizationId: z.ZodUUID;
-                milestoneId: z.ZodUUID;
+                milestoneId: z.ZodNullable<z.ZodUUID>;
                 mode: z.ZodEnum<{
                     supervised: "supervised";
                     auto: "auto";
@@ -155,7 +155,7 @@ export declare const HandoffRecordSchema: z.ZodObject<{
         plan: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
             kind: z.ZodLiteral<"execution">;
             authorizationId: z.ZodUUID;
-            milestoneId: z.ZodUUID;
+            milestoneId: z.ZodNullable<z.ZodUUID>;
             mode: z.ZodEnum<{
                 supervised: "supervised";
                 auto: "auto";
@@ -174,7 +174,7 @@ export declare const HandoffRecordSchema: z.ZodObject<{
             scope: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 kind: z.ZodLiteral<"execution">;
                 authorizationId: z.ZodUUID;
-                milestoneId: z.ZodUUID;
+                milestoneId: z.ZodNullable<z.ZodUUID>;
                 mode: z.ZodEnum<{
                     supervised: "supervised";
                     auto: "auto";
@@ -333,7 +333,7 @@ export declare const HandoffDispatchSchema: z.ZodObject<{
         plan: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
             kind: z.ZodLiteral<"execution">;
             authorizationId: z.ZodUUID;
-            milestoneId: z.ZodUUID;
+            milestoneId: z.ZodNullable<z.ZodUUID>;
             mode: z.ZodEnum<{
                 supervised: "supervised";
                 auto: "auto";
@@ -352,7 +352,7 @@ export declare const HandoffDispatchSchema: z.ZodObject<{
             scope: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 kind: z.ZodLiteral<"execution">;
                 authorizationId: z.ZodUUID;
-                milestoneId: z.ZodUUID;
+                milestoneId: z.ZodNullable<z.ZodUUID>;
                 mode: z.ZodEnum<{
                     supervised: "supervised";
                     auto: "auto";
@@ -404,7 +404,7 @@ export declare const HandoffPageSchema: z.ZodObject<{
                 scope: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
                     kind: z.ZodLiteral<"execution">;
                     authorizationId: z.ZodUUID;
-                    milestoneId: z.ZodUUID;
+                    milestoneId: z.ZodNullable<z.ZodUUID>;
                     mode: z.ZodEnum<{
                         supervised: "supervised";
                         auto: "auto";

package/dist/plans/admission.d.ts

@@ -48,7 +48,7 @@ export declare const createPlanAdmission: (coordinationRoot: string, store: ISto
                 scope: {
                     kind: "execution";
                     authorizationId: string;
-                    milestoneId: string;
+                    milestoneId: string | null;
                     mode: "supervised" | "auto";
                     revision: {
                         planDigest: string;
@@ -129,7 +129,7 @@ export declare const createPlanAdmission: (coordinationRoot: string, store: ISto
                 scope: {
                     kind: "execution";
                     authorizationId: string;
-                    milestoneId: string;
+                    milestoneId: string | null;
                     mode: "supervised" | "auto";
                     revision: {
                         planDigest: string;

package/dist/plans/admission.js

@@ -1,7 +1,7 @@
 import { Exception } from 'error-message-utils';
 import { getErrorKind } from '../errors/index.js';
 import { withHqLock } from '../locks/index.js';
-import { describePlan } from './authority.js';
+import { canExecutePlanUnit, describePlan } from './authority.js';
 import { isSamePlanRevision } from './utilities.js';
 const conflict = () => {
     throw new Exception('The HQ action conflicts with its recorded state', undefined, {
@@ -29,10 +29,9 @@ export const createPlanAdmission = (coordinationRoot, store, runtimeEpoch, readP
                 execution.revokedBy ||
                 execution.action.id !== scope.authorizationId ||
                 execution.mode !== scope.mode ||
-                !execution.milestoneIds.includes(scope.milestoneId) ||
+                !canExecutePlanUnit(artifacts, scope.milestoneId) ||
                 !isSamePlanRevision(execution.revision, scope.revision) ||
                 !isSamePlanRevision(scope.revision, artifacts.revision) ||
-                !status.isSequenceApproved ||
                 status.state === 'blocked' ||
                 (artifacts.coordination.revision && artifacts.coordination.revision.phase !== 'finished') ||
                 artifacts.coordination.observedConflict)
@@ -112,6 +111,13 @@ export const createPlanAdmission = (coordinationRoot, store, runtimeEpoch, readP
                             conflict();
                     }
                 }
+                // explicit assessment keeps its revision guard without inheriting implementation authority
+                const isFeedbackAssessment = !!action.expectedPlan &&
+                    (command.kind === 'message' || command.kind === 'queue') &&
+                    command.input.kind === 'skill' &&
+                    prepared.skill?.name === 'jg-feedback';
+                // current-turn permission replies and labels do not start another implementation unit
+                const isSeparateNativeControl = command.kind === 'native-reply' || command.kind === 'thread-rename';
                 if (action.plan) {
                     if (!['message', 'queue', 'steer', 'thread-resume', 'thread-recover'].includes(command.kind) ||
                         !threadId)
@@ -149,8 +155,22 @@ export const createPlanAdmission = (coordinationRoot, store, runtimeEpoch, readP
                     }
                     prepared.planContext = selected.context;
                 }
+                else if (command.kind === 'queue-send' && queued?.planContext) {
+                    const context = queued.planContext;
+                    if (context.scope) {
+                        const current = await scopeContext(context.scope);
+                        if (!isSamePlanRevision(context.observedRevision, current.artifacts.revision) &&
+                            context.scope.kind === 'execution')
+                            conflict();
+                    }
+                    else
+                        await boundArtifacts(context);
+                    prepared.planContext = context;
+                }
                 else if (binding && !safe) {
-                    if (command.kind === 'native-reply' && binding.scope?.kind === 'planning') {
+                    if (binding.scope &&
+                        !isFeedbackAssessment &&
+                        !(binding.scope.kind === 'execution' && isSeparateNativeControl)) {
                         prepared.planContext = (await scopeContext(binding.scope)).context;
                     }
                     else {
@@ -162,18 +182,6 @@ export const createPlanAdmission = (coordinationRoot, store, runtimeEpoch, readP
                         };
                     }
                 }
-                if (command.kind === 'queue-send' && queued?.planContext) {
-                    const context = queued.planContext;
-                    if (context.scope) {
-                        const current = await scopeContext(context.scope);
-                        if (!isSamePlanRevision(context.observedRevision, current.artifacts.revision) &&
-                            context.scope.kind === 'execution')
-                            conflict();
-                    }
-                    else
-                        await boundArtifacts(context);
-                    prepared.planContext = context;
-                }
                 return store.admit({ action, prepared });
             });
         },

package/dist/plans/authority.d.ts

@@ -2,6 +2,12 @@ import type { IPlanCommand, IPlanStatus, IPlanCoordination } from '../contracts/
 import type { IPlanArtifacts } from './types.js';
 /** Derives approval independently from native sessions and native permission requests. */
 export declare const describePlan: (artifacts: IPlanArtifacts, pendingActionId?: string | null) => IPlanStatus;
+/**
+ * Checks the current approved unfinished unit, with null identifying an undivided plan.
+ * Runtime epoch, action identity and mode remain the caller's separate admission checks.
+ * @returns Whether the exact unit is selected by current execution authority.
+ */
+export declare const canExecutePlanUnit: (artifacts: IPlanArtifacts, milestoneId: string | null) => boolean;
 /**
  * Applies one explicit operator decision without native dispatch or filesystem mutation.
  * @returns Updated current authority records.