@agent-native/core 0.90.3 → 0.90.5

package/dist/client/review/use-review.d.ts

@@ -11,6 +11,15 @@ export interface ListReviewCommentsResult {
     comments: ReviewComment[];
     reviewStatus: ReviewStatusEntry | null;
 }
+export interface GetReviewFeedbackParams {
+    resourceType: string;
+    resourceId: string;
+    includeHumanTargeted?: boolean;
+    limit?: number;
+}
+export interface GetReviewFeedbackResult {
+    comments: ReviewComment[];
+}
 export interface CreateReviewCommentInput {
     resourceType: string;
     resourceId: string;
@@ -44,6 +53,11 @@ export interface DeleteReviewCommentInput {
     resourceId: string;
     commentId: string;
 }
+export interface ConsumeReviewFeedbackInput {
+    resourceType: string;
+    resourceId: string;
+    commentIds: string[];
+}
 export interface SetReviewStatusInput {
     resourceType: string;
     resourceId: string;
@@ -54,15 +68,24 @@ export interface SetReviewStatusInput {
 export declare function useReviewComments(params: ListReviewCommentsParams, options?: {
     enabled?: boolean;
 }): import("@tanstack/react-query").UseQueryResult<NoInfer<ListReviewCommentsResult>, Error>;
+export declare function useReviewFeedback(params: GetReviewFeedbackParams, options?: {
+    enabled?: boolean;
+}): import("@tanstack/react-query").UseQueryResult<NoInfer<GetReviewFeedbackResult>, Error>;
 export declare function useCreateReviewComment(): import("@tanstack/react-query").UseMutationResult<ReviewComment, Error, CreateReviewCommentInput, unknown>;
 export declare function useReplyReviewComment(): import("@tanstack/react-query").UseMutationResult<ReviewComment, Error, ReplyReviewCommentInput, unknown>;
 export declare function useResolveReviewThread(): import("@tanstack/react-query").UseMutationResult<{
     threadId: string;
     resolved: true;
+    updatedCount: number;
 }, Error, ResolveReviewThreadInput, unknown>;
 export declare function useDeleteReviewComment(): import("@tanstack/react-query").UseMutationResult<{
     commentId: string;
     deleted: true;
+    updatedCount: number;
 }, Error, DeleteReviewCommentInput, unknown>;
+export declare function useConsumeReviewFeedback(): import("@tanstack/react-query").UseMutationResult<{
+    consumedCommentIds: string[];
+    updatedCount: number;
+}, Error, ConsumeReviewFeedbackInput, unknown>;
 export declare function useSetReviewStatus(): import("@tanstack/react-query").UseMutationResult<ReviewStatusEntry, Error, SetReviewStatusInput, unknown>;
 //# sourceMappingURL=use-review.d.ts.map

package/dist/client/review/use-review.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-review.d.ts","sourceRoot":"","sources":["../../../src/client/review/use-review.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,sBAAsB,EACtB,YAAY,EACZ,iBAAiB,EAClB,MAAM,uBAAuB,CAAC;AAG/B,MAAM,WAAW,wBAAwB;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,YAAY,EAAE,iBAAiB,GAAG,IAAI,CAAC;CACxC;AAED,MAAM,WAAW,wBAAwB;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,gBAAgB,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACjD,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,gBAAgB,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACjD,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,wBAAwB;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,YAAY,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,wBAAwB,EAChC,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,4FAUhC;AAED,wBAAgB,sBAAsB,+GAIrC;AAED,wBAAgB,qBAAqB,8GAIpC;AAED,wBAAgB,sBAAsB;cAEtB,MAAM;cAAY,IAAI;6CAGrC;AAED,wBAAgB,sBAAsB;eAErB,MAAM;aAAW,IAAI;6CAGrC;AAED,wBAAgB,kBAAkB,+GAIjC"}
+{"version":3,"file":"use-review.d.ts","sourceRoot":"","sources":["../../../src/client/review/use-review.ts"],"names":[],"mappings":"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"}

package/dist/client/review/use-review.js

@@ -4,6 +4,11 @@ export function useReviewComments(params, options) {
         enabled: options?.enabled ?? Boolean(params.resourceType && params.resourceId),
     });
 }
+export function useReviewFeedback(params, options) {
+    return useActionQuery("get-review-feedback", params, {
+        enabled: options?.enabled ?? Boolean(params.resourceType && params.resourceId),
+    });
+}
 export function useCreateReviewComment() {
     return useActionMutation("create-review-comment");
 }
@@ -16,6 +21,9 @@ export function useResolveReviewThread() {
 export function useDeleteReviewComment() {
     return useActionMutation("delete-review-comment");
 }
+export function useConsumeReviewFeedback() {
+    return useActionMutation("consume-review-feedback");
+}
 export function useSetReviewStatus() {
     return useActionMutation("set-review-status");
 }

package/dist/client/review/use-review.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-review.js","sourceRoot":"","sources":["../../../src/client/review/use-review.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AA6DrE,MAAM,UAAU,iBAAiB,CAC/B,MAAgC,EAChC,OAA+B;IAE/B,OAAO,cAAc,CACnB,sBAAsB,EACtB,MAAM,EACN;QACE,OAAO,EACL,OAAO,EAAE,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,UAAU,CAAC;KACxE,CACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,iBAAiB,CACtB,uBAAuB,CACxB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,iBAAiB,CACtB,sBAAsB,CACvB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,iBAAiB,CAGtB,uBAAuB,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,iBAAiB,CAGtB,uBAAuB,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,iBAAiB,CACtB,mBAAmB,CACpB,CAAC;AACJ,CAAC","sourcesContent":["import type {\n  ReviewComment,\n  ReviewCommentKind,\n  ReviewMention,\n  ReviewResolutionTarget,\n  ReviewStatus,\n  ReviewStatusEntry,\n} from \"../../review/types.js\";\nimport { useActionMutation, useActionQuery } from \"../use-action.js\";\n\nexport interface ListReviewCommentsParams {\n  resourceType: string;\n  resourceId: string;\n  includeResolved?: boolean;\n  includeDeleted?: boolean;\n  targetId?: string | null;\n  limit?: number;\n}\n\nexport interface ListReviewCommentsResult {\n  comments: ReviewComment[];\n  reviewStatus: ReviewStatusEntry | null;\n}\n\nexport interface CreateReviewCommentInput {\n  resourceType: string;\n  resourceId: string;\n  targetId?: string | null;\n  kind?: ReviewCommentKind;\n  anchor?: unknown | null;\n  body: string;\n  authorName?: string | null;\n  resolutionTarget?: ReviewResolutionTarget | null;\n  mentions?: ReviewMention[];\n  metadata?: Record<string, unknown>;\n}\n\nexport interface ReplyReviewCommentInput {\n  resourceType: string;\n  resourceId: string;\n  commentId: string;\n  body: string;\n  authorName?: string | null;\n  resolutionTarget?: ReviewResolutionTarget | null;\n  mentions?: ReviewMention[];\n  metadata?: Record<string, unknown>;\n}\n\nexport interface ResolveReviewThreadInput {\n  resourceType: string;\n  resourceId: string;\n  threadId?: string;\n  commentId?: string;\n}\n\nexport interface DeleteReviewCommentInput {\n  resourceType: string;\n  resourceId: string;\n  commentId: string;\n}\n\nexport interface SetReviewStatusInput {\n  resourceType: string;\n  resourceId: string;\n  status: ReviewStatus;\n  note?: string | null;\n  metadata?: Record<string, unknown>;\n}\n\nexport function useReviewComments(\n  params: ListReviewCommentsParams,\n  options?: { enabled?: boolean },\n) {\n  return useActionQuery<ListReviewCommentsResult>(\n    \"list-review-comments\",\n    params,\n    {\n      enabled:\n        options?.enabled ?? Boolean(params.resourceType && params.resourceId),\n    },\n  );\n}\n\nexport function useCreateReviewComment() {\n  return useActionMutation<ReviewComment, CreateReviewCommentInput>(\n    \"create-review-comment\",\n  );\n}\n\nexport function useReplyReviewComment() {\n  return useActionMutation<ReviewComment, ReplyReviewCommentInput>(\n    \"reply-review-comment\",\n  );\n}\n\nexport function useResolveReviewThread() {\n  return useActionMutation<\n    { threadId: string; resolved: true },\n    ResolveReviewThreadInput\n  >(\"resolve-review-thread\");\n}\n\nexport function useDeleteReviewComment() {\n  return useActionMutation<\n    { commentId: string; deleted: true },\n    DeleteReviewCommentInput\n  >(\"delete-review-comment\");\n}\n\nexport function useSetReviewStatus() {\n  return useActionMutation<ReviewStatusEntry, SetReviewStatusInput>(\n    \"set-review-status\",\n  );\n}\n"]}
+{"version":3,"file":"use-review.js","sourceRoot":"","sources":["../../../src/client/review/use-review.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AA8ErE,MAAM,UAAU,iBAAiB,CAC/B,MAAgC,EAChC,OAA+B;IAE/B,OAAO,cAAc,CACnB,sBAAsB,EACtB,MAAM,EACN;QACE,OAAO,EACL,OAAO,EAAE,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,UAAU,CAAC;KACxE,CACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,MAA+B,EAC/B,OAA+B;IAE/B,OAAO,cAAc,CACnB,qBAAqB,EACrB,MAAM,EACN;QACE,OAAO,EACL,OAAO,EAAE,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,UAAU,CAAC;KACxE,CACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,iBAAiB,CACtB,uBAAuB,CACxB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,iBAAiB,CACtB,sBAAsB,CACvB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,iBAAiB,CAGtB,uBAAuB,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,iBAAiB,CAGtB,uBAAuB,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,wBAAwB;IACtC,OAAO,iBAAiB,CAGtB,yBAAyB,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,iBAAiB,CACtB,mBAAmB,CACpB,CAAC;AACJ,CAAC","sourcesContent":["import type {\n  ReviewComment,\n  ReviewCommentKind,\n  ReviewMention,\n  ReviewResolutionTarget,\n  ReviewStatus,\n  ReviewStatusEntry,\n} from \"../../review/types.js\";\nimport { useActionMutation, useActionQuery } from \"../use-action.js\";\n\nexport interface ListReviewCommentsParams {\n  resourceType: string;\n  resourceId: string;\n  includeResolved?: boolean;\n  includeDeleted?: boolean;\n  targetId?: string | null;\n  limit?: number;\n}\n\nexport interface ListReviewCommentsResult {\n  comments: ReviewComment[];\n  reviewStatus: ReviewStatusEntry | null;\n}\n\nexport interface GetReviewFeedbackParams {\n  resourceType: string;\n  resourceId: string;\n  includeHumanTargeted?: boolean;\n  limit?: number;\n}\n\nexport interface GetReviewFeedbackResult {\n  comments: ReviewComment[];\n}\n\nexport interface CreateReviewCommentInput {\n  resourceType: string;\n  resourceId: string;\n  targetId?: string | null;\n  kind?: ReviewCommentKind;\n  anchor?: unknown | null;\n  body: string;\n  authorName?: string | null;\n  resolutionTarget?: ReviewResolutionTarget | null;\n  mentions?: ReviewMention[];\n  metadata?: Record<string, unknown>;\n}\n\nexport interface ReplyReviewCommentInput {\n  resourceType: string;\n  resourceId: string;\n  commentId: string;\n  body: string;\n  authorName?: string | null;\n  resolutionTarget?: ReviewResolutionTarget | null;\n  mentions?: ReviewMention[];\n  metadata?: Record<string, unknown>;\n}\n\nexport interface ResolveReviewThreadInput {\n  resourceType: string;\n  resourceId: string;\n  threadId?: string;\n  commentId?: string;\n}\n\nexport interface DeleteReviewCommentInput {\n  resourceType: string;\n  resourceId: string;\n  commentId: string;\n}\n\nexport interface ConsumeReviewFeedbackInput {\n  resourceType: string;\n  resourceId: string;\n  commentIds: string[];\n}\n\nexport interface SetReviewStatusInput {\n  resourceType: string;\n  resourceId: string;\n  status: ReviewStatus;\n  note?: string | null;\n  metadata?: Record<string, unknown>;\n}\n\nexport function useReviewComments(\n  params: ListReviewCommentsParams,\n  options?: { enabled?: boolean },\n) {\n  return useActionQuery<ListReviewCommentsResult>(\n    \"list-review-comments\",\n    params,\n    {\n      enabled:\n        options?.enabled ?? Boolean(params.resourceType && params.resourceId),\n    },\n  );\n}\n\nexport function useReviewFeedback(\n  params: GetReviewFeedbackParams,\n  options?: { enabled?: boolean },\n) {\n  return useActionQuery<GetReviewFeedbackResult>(\n    \"get-review-feedback\",\n    params,\n    {\n      enabled:\n        options?.enabled ?? Boolean(params.resourceType && params.resourceId),\n    },\n  );\n}\n\nexport function useCreateReviewComment() {\n  return useActionMutation<ReviewComment, CreateReviewCommentInput>(\n    \"create-review-comment\",\n  );\n}\n\nexport function useReplyReviewComment() {\n  return useActionMutation<ReviewComment, ReplyReviewCommentInput>(\n    \"reply-review-comment\",\n  );\n}\n\nexport function useResolveReviewThread() {\n  return useActionMutation<\n    { threadId: string; resolved: true; updatedCount: number },\n    ResolveReviewThreadInput\n  >(\"resolve-review-thread\");\n}\n\nexport function useDeleteReviewComment() {\n  return useActionMutation<\n    { commentId: string; deleted: true; updatedCount: number },\n    DeleteReviewCommentInput\n  >(\"delete-review-comment\");\n}\n\nexport function useConsumeReviewFeedback() {\n  return useActionMutation<\n    { consumedCommentIds: string[]; updatedCount: number },\n    ConsumeReviewFeedbackInput\n  >(\"consume-review-feedback\");\n}\n\nexport function useSetReviewStatus() {\n  return useActionMutation<ReviewStatusEntry, SetReviewStatusInput>(\n    \"set-review-status\",\n  );\n}\n"]}

package/dist/client/use-run-stuck-detection.d.ts

@@ -22,7 +22,7 @@ export interface RunStuckState {
     heartbeatAt: number | null;
     /** Milliseconds since `heartbeatAt`, computed against the server clock. */
     heartbeatSinceMs: number | null;
-    /** How the run was dispatched, e.g. foreground or background-processing. */
+    /** How the run was dispatched/continued, e.g. foreground-self-chain or background-processing. */
     dispatchMode: string | null;
 }
 export interface UseRunStuckDetectionOptions {

package/dist/client/use-run-stuck-detection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-run-stuck-detection.d.ts","sourceRoot":"","sources":["../../src/client/use-run-stuck-detection.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC5B,8EAA8E;IAC9E,OAAO,EAAE,OAAO,CAAC;IACjB,+DAA+D;IAC/D,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,2EAA2E;IAC3E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,4EAA4E;IAC5E,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,oDAAoD;IACpD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,iEAAiE;IACjE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,2EAA2E;IAC3E,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,4EAA4E;IAC5E,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,2BAA2B;IAC1C,qEAAqE;IACrE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACpC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;;;OAOG;IACH,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAGD,eAAO,MAAM,qCAAqC,SAAU,CAAC;AA0B7D,wBAAgB,oBAAoB,CAAC,EACnC,QAAQ,EACR,OAAc,EACd,gBAA6C,EAC7C,0BAAkE,EAClE,cAAyC,EACzC,MAAM,GACP,EAAE,2BAA2B,GAAG,aAAa,CA8F7C;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,WAEzB,MAAM,WAAU,MAAM,KAAY,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAoBzE"}
+{"version":3,"file":"use-run-stuck-detection.d.ts","sourceRoot":"","sources":["../../src/client/use-run-stuck-detection.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC5B,8EAA8E;IAC9E,OAAO,EAAE,OAAO,CAAC;IACjB,+DAA+D;IAC/D,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,2EAA2E;IAC3E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,4EAA4E;IAC5E,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,oDAAoD;IACpD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,iEAAiE;IACjE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,2EAA2E;IAC3E,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,iGAAiG;IACjG,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,2BAA2B;IAC1C,qEAAqE;IACrE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACpC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;;;OAOG;IACH,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAGD,eAAO,MAAM,qCAAqC,SAAU,CAAC;AA0B7D,wBAAgB,oBAAoB,CAAC,EACnC,QAAQ,EACR,OAAc,EACd,gBAA6C,EAC7C,0BAAkE,EAClE,cAAyC,EACzC,MAAM,GACP,EAAE,2BAA2B,GAAG,aAAa,CAiG7C;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,WAEzB,MAAM,WAAU,MAAM,KAAY,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAoBzE"}

package/dist/client/use-run-stuck-detection.js

@@ -46,10 +46,12 @@ export function useRunStuckDetection({ threadId, enabled = true, stuckThresholdM
                     const heartbeatAt = data.heartbeatAt ?? null;
                     const heartbeatSinceMs = heartbeatAt != null ? nowMs - heartbeatAt : null;
                     const dispatchMode = typeof data.dispatchMode === "string" ? data.dispatchMode : null;
-                    // Background-dispatched runs get the wider threshold: the server's
-                    // own recovery (150s no-progress backstop + chained continuations)
-                    // must get its chance before the user sees a "stuck" affordance.
-                    const effectiveThresholdMs = dispatchMode?.startsWith("background")
+                    // Server-continued runs get the wider threshold: the server's own
+                    // recovery (150s no-progress backstop + chained continuations) must
+                    // get its chance before the user sees a "stuck" affordance.
+                    const serverContinued = dispatchMode === "foreground-self-chain" ||
+                        dispatchMode?.startsWith("background") === true;
+                    const effectiveThresholdMs = serverContinued
                         ? backgroundStuckThresholdMs
                         : stuckThresholdMs;
                     const isStuck = Boolean(data.active &&

package/dist/client/use-run-stuck-detection.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-run-stuck-detection.js","sourceRoot":"","sources":["../../src/client/use-run-stuck-detection.ts"],"names":[],"mappings":"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","sourcesContent":["import { useEffect, useState, useCallback } from \"react\";\n\nimport { agentNativePath } from \"./api-path.js\";\n\n/**\n * Per-thread chat run health, derived from the durable `last_progress_at`\n * timestamp on the server. Drives the user-visible \"this chat looks stuck\"\n * affordance — distinct from the silent reconnect logic in\n * `agent-chat-adapter.ts`, which keeps trying in the background. When\n * automatic recovery isn't making progress (for whatever reason), this\n * hook surfaces a Retry / Cancel button to the user instead of leaving\n * them staring at a frozen spinner.\n */\nexport interface RunStuckState {\n  /** True when an active run hasn't emitted an event for `stuckThresholdMs`. */\n  isStuck: boolean;\n  /** ID of the active run, or null when nothing is in flight. */\n  runId: string | null;\n  /** Server-side run status (\"running\" / \"completed\" / \"errored\" / etc.). */\n  status: string | null;\n  /** Server timestamp (ms) of the last emitted event, or null if none yet. */\n  lastProgressAt: number | null;\n  /** Milliseconds since `lastProgressAt`, or null. */\n  stuckSinceMs: number | null;\n  /** Server timestamp (ms) of the last process-alive heartbeat. */\n  heartbeatAt: number | null;\n  /** Milliseconds since `heartbeatAt`, computed against the server clock. */\n  heartbeatSinceMs: number | null;\n  /** How the run was dispatched, e.g. foreground or background-processing. */\n  dispatchMode: string | null;\n}\n\nexport interface UseRunStuckDetectionOptions {\n  /** The thread to monitor. Pass null/undefined to disable polling. */\n  threadId: string | null | undefined;\n  /**\n   * Set false to skip scheduling the poll loop entirely — used to gate\n   * polling to only the active chat tab when multiple tabs are mounted\n   * (inactive tabs are kept alive via display:none, not unmounted).\n   * Defaults to true.\n   */\n  enabled?: boolean;\n  /**\n   * Threshold above which an in-flight FOREGROUND run is considered stuck.\n   * The default sits comfortably above the adapter's 75s no-progress\n   * reconnect — by then automatic recovery has already had its chance.\n   */\n  stuckThresholdMs?: number;\n  /**\n   * Threshold for BACKGROUND-dispatched runs (dispatchMode starts with\n   * \"background\"). The server owns recovery for these — its run-manager\n   * no-progress backstop (150s) and unclaimed-run sweep act first — so the\n   * user-facing \"stuck\" affordance is a late fallback, not a race against\n   * them. Selected inside the hook because the dispatch mode is only known\n   * from the same poll response that computes the elapsed time.\n   */\n  backgroundStuckThresholdMs?: number;\n  /** Poll interval. Default 5_000ms. */\n  pollIntervalMs?: number;\n  /** API base path. Default `/_agent-native/agent-chat`. */\n  apiUrl?: string;\n}\n\nconst DEFAULT_STUCK_THRESHOLD_MS = 90_000;\nexport const DEFAULT_BACKGROUND_STUCK_THRESHOLD_MS = 180_000;\nconst DEFAULT_POLL_INTERVAL_MS = 5_000;\nconst IDLE_BACKOFF_INTERVAL_MS = 15_000;\n\ninterface ActiveRunResponse {\n  active: boolean;\n  runId?: string;\n  status?: string;\n  heartbeatAt: number | null;\n  lastProgressAt?: number | null;\n  dispatchMode?: string | null;\n  /** Server clock at response time, used to compute elapsed server-relative. */\n  serverNow?: number;\n}\n\nconst EMPTY_STATE: RunStuckState = {\n  isStuck: false,\n  runId: null,\n  status: null,\n  lastProgressAt: null,\n  stuckSinceMs: null,\n  heartbeatAt: null,\n  heartbeatSinceMs: null,\n  dispatchMode: null,\n};\n\nexport function useRunStuckDetection({\n  threadId,\n  enabled = true,\n  stuckThresholdMs = DEFAULT_STUCK_THRESHOLD_MS,\n  backgroundStuckThresholdMs = DEFAULT_BACKGROUND_STUCK_THRESHOLD_MS,\n  pollIntervalMs = DEFAULT_POLL_INTERVAL_MS,\n  apiUrl,\n}: UseRunStuckDetectionOptions): RunStuckState {\n  const [state, setState] = useState<RunStuckState>(EMPTY_STATE);\n\n  useEffect(() => {\n    // Reset on every thread change so the previous thread's stuck banner\n    // doesn't bleed onto the new one before the first poll completes.\n    setState(EMPTY_STATE);\n    if (!threadId || !enabled) return;\n\n    const base = apiUrl ?? agentNativePath(\"/_agent-native/agent-chat\");\n    let cancelled = false;\n    let timer: ReturnType<typeof setTimeout> | null = null;\n\n    const poll = async () => {\n      if (cancelled) return;\n      let nextDelay = pollIntervalMs;\n      try {\n        const res = await fetch(\n          `${base}/runs/active?threadId=${encodeURIComponent(threadId)}`,\n          { credentials: \"same-origin\" },\n        );\n        if (cancelled) return;\n        if (res.ok) {\n          const data = (await res.json()) as ActiveRunResponse;\n          const lastProgressAt = data.lastProgressAt ?? null;\n          // Measure elapsed against the SERVER clock (serverNow) rather than the\n          // client's Date.now(). lastProgressAt is a server timestamp, so client\n          // clock skew of more than stuckThresholdMs would otherwise mark every\n          // run stuck (clock ahead) or never stuck (clock behind). Fall back to\n          // the client clock for older bundles that don't send serverNow.\n          const nowMs = data.serverNow ?? Date.now();\n          const stuckSinceMs =\n            lastProgressAt != null ? nowMs - lastProgressAt : null;\n          const heartbeatAt = data.heartbeatAt ?? null;\n          const heartbeatSinceMs =\n            heartbeatAt != null ? nowMs - heartbeatAt : null;\n          const dispatchMode =\n            typeof data.dispatchMode === \"string\" ? data.dispatchMode : null;\n          // Background-dispatched runs get the wider threshold: the server's\n          // own recovery (150s no-progress backstop + chained continuations)\n          // must get its chance before the user sees a \"stuck\" affordance.\n          const effectiveThresholdMs = dispatchMode?.startsWith(\"background\")\n            ? backgroundStuckThresholdMs\n            : stuckThresholdMs;\n          const isStuck = Boolean(\n            data.active &&\n            data.status === \"running\" &&\n            stuckSinceMs != null &&\n            stuckSinceMs > effectiveThresholdMs,\n          );\n          setState({\n            isStuck,\n            runId: data.runId ?? null,\n            status: data.status ?? null,\n            lastProgressAt,\n            stuckSinceMs,\n            heartbeatAt,\n            heartbeatSinceMs,\n            dispatchMode,\n          });\n          // Back off polling when nothing is in flight — there's no point\n          // hammering the endpoint while the chat is idle. We still poll\n          // occasionally so a fresh run started in another tab is picked up.\n          if (!data.active || data.status !== \"running\") {\n            nextDelay = IDLE_BACKOFF_INTERVAL_MS;\n          }\n        }\n      } catch {\n        // Network blip — leave previous state. Next tick will retry.\n      }\n      if (!cancelled) {\n        timer = setTimeout(poll, nextDelay);\n      }\n    };\n\n    // Stagger the first poll so a freshly-started run isn't immediately\n    // classified as stuck before the server has had a chance to record\n    // any progress events.\n    timer = setTimeout(poll, 2_000);\n\n    return () => {\n      cancelled = true;\n      if (timer) clearTimeout(timer);\n    };\n  }, [\n    threadId,\n    enabled,\n    stuckThresholdMs,\n    backgroundStuckThresholdMs,\n    pollIntervalMs,\n    apiUrl,\n  ]);\n\n  return state;\n}\n\n/**\n * POST `/runs/:id/abort` so the server flips the run to \"aborted\" and the\n * adapter's reconnect loop exits cleanly. Returns the run id that was\n * aborted (or null on failure) so callers can correlate observability\n * events. Best-effort — failures are swallowed, since the user's intent\n * is already captured locally.\n */\nexport function useAbortRun(apiUrl?: string) {\n  return useCallback(\n    async (runId: string, reason: string = \"user\"): Promise<string | null> => {\n      const base = apiUrl ?? agentNativePath(\"/_agent-native/agent-chat\");\n      try {\n        const res = await fetch(\n          `${base}/runs/${encodeURIComponent(runId)}/abort`,\n          {\n            method: \"POST\",\n            headers: { \"Content-Type\": \"application/json\" },\n            credentials: \"same-origin\",\n            body: JSON.stringify({ reason }),\n          },\n        );\n        if (!res.ok) return null;\n        return runId;\n      } catch {\n        return null;\n      }\n    },\n    [apiUrl],\n  );\n}\n"]}
+{"version":3,"file":"use-run-stuck-detection.js","sourceRoot":"","sources":["../../src/client/use-run-stuck-detection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAEzD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AA6DhD,MAAM,0BAA0B,GAAG,MAAM,CAAC;AAC1C,MAAM,CAAC,MAAM,qCAAqC,GAAG,OAAO,CAAC;AAC7D,MAAM,wBAAwB,GAAG,KAAK,CAAC;AACvC,MAAM,wBAAwB,GAAG,MAAM,CAAC;AAaxC,MAAM,WAAW,GAAkB;IACjC,OAAO,EAAE,KAAK;IACd,KAAK,EAAE,IAAI;IACX,MAAM,EAAE,IAAI;IACZ,cAAc,EAAE,IAAI;IACpB,YAAY,EAAE,IAAI;IAClB,WAAW,EAAE,IAAI;IACjB,gBAAgB,EAAE,IAAI;IACtB,YAAY,EAAE,IAAI;CACnB,CAAC;AAEF,MAAM,UAAU,oBAAoB,CAAC,EACnC,QAAQ,EACR,OAAO,GAAG,IAAI,EACd,gBAAgB,GAAG,0BAA0B,EAC7C,0BAA0B,GAAG,qCAAqC,EAClE,cAAc,GAAG,wBAAwB,EACzC,MAAM,GACsB;IAC5B,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAgB,WAAW,CAAC,CAAC;IAE/D,SAAS,CAAC,GAAG,EAAE;QACb,qEAAqE;QACrE,kEAAkE;QAClE,QAAQ,CAAC,WAAW,CAAC,CAAC;QACtB,IAAI,CAAC,QAAQ,IAAI,CAAC,OAAO;YAAE,OAAO;QAElC,MAAM,IAAI,GAAG,MAAM,IAAI,eAAe,CAAC,2BAA2B,CAAC,CAAC;QACpE,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,IAAI,KAAK,GAAyC,IAAI,CAAC;QAEvD,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE;YACtB,IAAI,SAAS;gBAAE,OAAO;YACtB,IAAI,SAAS,GAAG,cAAc,CAAC;YAC/B,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,KAAK,CACrB,GAAG,IAAI,yBAAyB,kBAAkB,CAAC,QAAQ,CAAC,EAAE,EAC9D,EAAE,WAAW,EAAE,aAAa,EAAE,CAC/B,CAAC;gBACF,IAAI,SAAS;oBAAE,OAAO;gBACtB,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;oBACX,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAsB,CAAC;oBACrD,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC;oBACnD,uEAAuE;oBACvE,uEAAuE;oBACvE,sEAAsE;oBACtE,sEAAsE;oBACtE,gEAAgE;oBAChE,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;oBAC3C,MAAM,YAAY,GAChB,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC;oBACzD,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC;oBAC7C,MAAM,gBAAgB,GACpB,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;oBACnD,MAAM,YAAY,GAChB,OAAO,IAAI,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC;oBACnE,kEAAkE;oBAClE,oEAAoE;oBACpE,4DAA4D;oBAC5D,MAAM,eAAe,GACnB,YAAY,KAAK,uBAAuB;wBACxC,YAAY,EAAE,UAAU,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;oBAClD,MAAM,oBAAoB,GAAG,eAAe;wBAC1C,CAAC,CAAC,0BAA0B;wBAC5B,CAAC,CAAC,gBAAgB,CAAC;oBACrB,MAAM,OAAO,GAAG,OAAO,CACrB,IAAI,CAAC,MAAM;wBACX,IAAI,CAAC,MAAM,KAAK,SAAS;wBACzB,YAAY,IAAI,IAAI;wBACpB,YAAY,GAAG,oBAAoB,CACpC,CAAC;oBACF,QAAQ,CAAC;wBACP,OAAO;wBACP,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI;wBACzB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI;wBAC3B,cAAc;wBACd,YAAY;wBACZ,WAAW;wBACX,gBAAgB;wBAChB,YAAY;qBACb,CAAC,CAAC;oBACH,gEAAgE;oBAChE,+DAA+D;oBAC/D,mEAAmE;oBACnE,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;wBAC9C,SAAS,GAAG,wBAAwB,CAAC;oBACvC,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,6DAA6D;YAC/D,CAAC;YACD,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YACtC,CAAC;QACH,CAAC,CAAC;QAEF,oEAAoE;QACpE,mEAAmE;QACnE,uBAAuB;QACvB,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAEhC,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAC;YACjB,IAAI,KAAK;gBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC,CAAC;IACJ,CAAC,EAAE;QACD,QAAQ;QACR,OAAO;QACP,gBAAgB;QAChB,0BAA0B;QAC1B,cAAc;QACd,MAAM;KACP,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,MAAe;IACzC,OAAO,WAAW,CAChB,KAAK,EAAE,KAAa,EAAE,MAAM,GAAW,MAAM,EAA0B,EAAE;QACvE,MAAM,IAAI,GAAG,MAAM,IAAI,eAAe,CAAC,2BAA2B,CAAC,CAAC;QACpE,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,KAAK,CACrB,GAAG,IAAI,SAAS,kBAAkB,CAAC,KAAK,CAAC,QAAQ,EACjD;gBACE,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,WAAW,EAAE,aAAa;gBAC1B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;aACjC,CACF,CAAC;YACF,IAAI,CAAC,GAAG,CAAC,EAAE;gBAAE,OAAO,IAAI,CAAC;YACzB,OAAO,KAAK,CAAC;QACf,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC,EACD,CAAC,MAAM,CAAC,CACT,CAAC;AACJ,CAAC","sourcesContent":["import { useEffect, useState, useCallback } from \"react\";\n\nimport { agentNativePath } from \"./api-path.js\";\n\n/**\n * Per-thread chat run health, derived from the durable `last_progress_at`\n * timestamp on the server. Drives the user-visible \"this chat looks stuck\"\n * affordance — distinct from the silent reconnect logic in\n * `agent-chat-adapter.ts`, which keeps trying in the background. When\n * automatic recovery isn't making progress (for whatever reason), this\n * hook surfaces a Retry / Cancel button to the user instead of leaving\n * them staring at a frozen spinner.\n */\nexport interface RunStuckState {\n  /** True when an active run hasn't emitted an event for `stuckThresholdMs`. */\n  isStuck: boolean;\n  /** ID of the active run, or null when nothing is in flight. */\n  runId: string | null;\n  /** Server-side run status (\"running\" / \"completed\" / \"errored\" / etc.). */\n  status: string | null;\n  /** Server timestamp (ms) of the last emitted event, or null if none yet. */\n  lastProgressAt: number | null;\n  /** Milliseconds since `lastProgressAt`, or null. */\n  stuckSinceMs: number | null;\n  /** Server timestamp (ms) of the last process-alive heartbeat. */\n  heartbeatAt: number | null;\n  /** Milliseconds since `heartbeatAt`, computed against the server clock. */\n  heartbeatSinceMs: number | null;\n  /** How the run was dispatched/continued, e.g. foreground-self-chain or background-processing. */\n  dispatchMode: string | null;\n}\n\nexport interface UseRunStuckDetectionOptions {\n  /** The thread to monitor. Pass null/undefined to disable polling. */\n  threadId: string | null | undefined;\n  /**\n   * Set false to skip scheduling the poll loop entirely — used to gate\n   * polling to only the active chat tab when multiple tabs are mounted\n   * (inactive tabs are kept alive via display:none, not unmounted).\n   * Defaults to true.\n   */\n  enabled?: boolean;\n  /**\n   * Threshold above which an in-flight FOREGROUND run is considered stuck.\n   * The default sits comfortably above the adapter's 75s no-progress\n   * reconnect — by then automatic recovery has already had its chance.\n   */\n  stuckThresholdMs?: number;\n  /**\n   * Threshold for BACKGROUND-dispatched runs (dispatchMode starts with\n   * \"background\"). The server owns recovery for these — its run-manager\n   * no-progress backstop (150s) and unclaimed-run sweep act first — so the\n   * user-facing \"stuck\" affordance is a late fallback, not a race against\n   * them. Selected inside the hook because the dispatch mode is only known\n   * from the same poll response that computes the elapsed time.\n   */\n  backgroundStuckThresholdMs?: number;\n  /** Poll interval. Default 5_000ms. */\n  pollIntervalMs?: number;\n  /** API base path. Default `/_agent-native/agent-chat`. */\n  apiUrl?: string;\n}\n\nconst DEFAULT_STUCK_THRESHOLD_MS = 90_000;\nexport const DEFAULT_BACKGROUND_STUCK_THRESHOLD_MS = 180_000;\nconst DEFAULT_POLL_INTERVAL_MS = 5_000;\nconst IDLE_BACKOFF_INTERVAL_MS = 15_000;\n\ninterface ActiveRunResponse {\n  active: boolean;\n  runId?: string;\n  status?: string;\n  heartbeatAt: number | null;\n  lastProgressAt?: number | null;\n  dispatchMode?: string | null;\n  /** Server clock at response time, used to compute elapsed server-relative. */\n  serverNow?: number;\n}\n\nconst EMPTY_STATE: RunStuckState = {\n  isStuck: false,\n  runId: null,\n  status: null,\n  lastProgressAt: null,\n  stuckSinceMs: null,\n  heartbeatAt: null,\n  heartbeatSinceMs: null,\n  dispatchMode: null,\n};\n\nexport function useRunStuckDetection({\n  threadId,\n  enabled = true,\n  stuckThresholdMs = DEFAULT_STUCK_THRESHOLD_MS,\n  backgroundStuckThresholdMs = DEFAULT_BACKGROUND_STUCK_THRESHOLD_MS,\n  pollIntervalMs = DEFAULT_POLL_INTERVAL_MS,\n  apiUrl,\n}: UseRunStuckDetectionOptions): RunStuckState {\n  const [state, setState] = useState<RunStuckState>(EMPTY_STATE);\n\n  useEffect(() => {\n    // Reset on every thread change so the previous thread's stuck banner\n    // doesn't bleed onto the new one before the first poll completes.\n    setState(EMPTY_STATE);\n    if (!threadId || !enabled) return;\n\n    const base = apiUrl ?? agentNativePath(\"/_agent-native/agent-chat\");\n    let cancelled = false;\n    let timer: ReturnType<typeof setTimeout> | null = null;\n\n    const poll = async () => {\n      if (cancelled) return;\n      let nextDelay = pollIntervalMs;\n      try {\n        const res = await fetch(\n          `${base}/runs/active?threadId=${encodeURIComponent(threadId)}`,\n          { credentials: \"same-origin\" },\n        );\n        if (cancelled) return;\n        if (res.ok) {\n          const data = (await res.json()) as ActiveRunResponse;\n          const lastProgressAt = data.lastProgressAt ?? null;\n          // Measure elapsed against the SERVER clock (serverNow) rather than the\n          // client's Date.now(). lastProgressAt is a server timestamp, so client\n          // clock skew of more than stuckThresholdMs would otherwise mark every\n          // run stuck (clock ahead) or never stuck (clock behind). Fall back to\n          // the client clock for older bundles that don't send serverNow.\n          const nowMs = data.serverNow ?? Date.now();\n          const stuckSinceMs =\n            lastProgressAt != null ? nowMs - lastProgressAt : null;\n          const heartbeatAt = data.heartbeatAt ?? null;\n          const heartbeatSinceMs =\n            heartbeatAt != null ? nowMs - heartbeatAt : null;\n          const dispatchMode =\n            typeof data.dispatchMode === \"string\" ? data.dispatchMode : null;\n          // Server-continued runs get the wider threshold: the server's own\n          // recovery (150s no-progress backstop + chained continuations) must\n          // get its chance before the user sees a \"stuck\" affordance.\n          const serverContinued =\n            dispatchMode === \"foreground-self-chain\" ||\n            dispatchMode?.startsWith(\"background\") === true;\n          const effectiveThresholdMs = serverContinued\n            ? backgroundStuckThresholdMs\n            : stuckThresholdMs;\n          const isStuck = Boolean(\n            data.active &&\n            data.status === \"running\" &&\n            stuckSinceMs != null &&\n            stuckSinceMs > effectiveThresholdMs,\n          );\n          setState({\n            isStuck,\n            runId: data.runId ?? null,\n            status: data.status ?? null,\n            lastProgressAt,\n            stuckSinceMs,\n            heartbeatAt,\n            heartbeatSinceMs,\n            dispatchMode,\n          });\n          // Back off polling when nothing is in flight — there's no point\n          // hammering the endpoint while the chat is idle. We still poll\n          // occasionally so a fresh run started in another tab is picked up.\n          if (!data.active || data.status !== \"running\") {\n            nextDelay = IDLE_BACKOFF_INTERVAL_MS;\n          }\n        }\n      } catch {\n        // Network blip — leave previous state. Next tick will retry.\n      }\n      if (!cancelled) {\n        timer = setTimeout(poll, nextDelay);\n      }\n    };\n\n    // Stagger the first poll so a freshly-started run isn't immediately\n    // classified as stuck before the server has had a chance to record\n    // any progress events.\n    timer = setTimeout(poll, 2_000);\n\n    return () => {\n      cancelled = true;\n      if (timer) clearTimeout(timer);\n    };\n  }, [\n    threadId,\n    enabled,\n    stuckThresholdMs,\n    backgroundStuckThresholdMs,\n    pollIntervalMs,\n    apiUrl,\n  ]);\n\n  return state;\n}\n\n/**\n * POST `/runs/:id/abort` so the server flips the run to \"aborted\" and the\n * adapter's reconnect loop exits cleanly. Returns the run id that was\n * aborted (or null on failure) so callers can correlate observability\n * events. Best-effort — failures are swallowed, since the user's intent\n * is already captured locally.\n */\nexport function useAbortRun(apiUrl?: string) {\n  return useCallback(\n    async (runId: string, reason: string = \"user\"): Promise<string | null> => {\n      const base = apiUrl ?? agentNativePath(\"/_agent-native/agent-chat\");\n      try {\n        const res = await fetch(\n          `${base}/runs/${encodeURIComponent(runId)}/abort`,\n          {\n            method: \"POST\",\n            headers: { \"Content-Type\": \"application/json\" },\n            credentials: \"same-origin\",\n            body: JSON.stringify({ reason }),\n          },\n        );\n        if (!res.ok) return null;\n        return runId;\n      } catch {\n        return null;\n      }\n    },\n    [apiUrl],\n  );\n}\n"]}

package/dist/collab/struct-routes.d.ts

@@ -13,8 +13,8 @@
  * Body: { json: any, fieldName?: string, type?: "map"|"array", requestSource?: string }
  */
 export declare const postCollabJson: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
-    error: string;
     ok?: undefined;
+    error: string;
 } | {
     error?: undefined;
     ok: boolean;

package/dist/file-upload/actions/upload-image.d.ts

@@ -17,12 +17,12 @@ declare const _default: import("../../action.js").ActionDefinition<{
     id?: undefined;
     provider?: undefined;
 } | {
-    error?: undefined;
     configured?: undefined;
     connectPath?: undefined;
     url: string;
     id: string;
     provider: string;
+    error?: undefined;
 }>;
 export default _default;
 //# sourceMappingURL=upload-image.d.ts.map

package/dist/history/actions/create-resource-version.js

@@ -17,14 +17,17 @@ export default defineAction({
         const actionCtx = ctx;
         const access = await assertVersionedResourceAccess(args.resourceType, args.resourceId, actionCtx, "editor");
         const registration = getVersionedResource(args.resourceType);
-        const snapshot = args.snapshot !== undefined
-            ? args.snapshot
-            : await registration?.getSnapshot?.({
+        // Prefer the registered server snapshot when available so editors/agents
+        // cannot plant arbitrary restore payloads for managed resource types.
+        const serverSnapshot = registration?.getSnapshot
+            ? await registration.getSnapshot({
                 resourceType: args.resourceType,
                 resourceId: args.resourceId,
                 ctx: actionCtx,
                 access,
-            });
+            })
+            : undefined;
+        const snapshot = serverSnapshot !== undefined ? serverSnapshot : args.snapshot;
         if (snapshot === undefined) {
             throw new Error(`No snapshot was provided and ${args.resourceType} has no getSnapshot history handler`);
         }

package/dist/history/actions/create-resource-version.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-resource-version.js","sourceRoot":"","sources":["../../../src/history/actions/create-resource-version.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\n\nimport { defineAction } from \"../../action.js\";\nimport {\n  assertVersionedResourceAccess,\n  getVersionedResource,\n  normalizeHistoryVisibility,\n} from \"../registry.js\";\nimport { insertResourceVersion } from \"../store.js\";\nimport type { HistoryActorKind, VersionedResourceContext } from \"../types.js\";\n\nconst schema = z.object({\n  resourceType: z.string().min(1),\n  resourceId: z.string().min(1),\n  title: z.string().optional(),\n  summary: z.string().optional(),\n  snapshot: z.unknown().optional(),\n  metadata: z.record(z.string(), z.unknown()).optional(),\n});\n\nexport default defineAction({\n  description: \"Create a reusable version-history snapshot for a resource.\",\n  schema,\n  run: async (args, ctx) => {\n    const actionCtx = ctx as VersionedResourceContext | undefined;\n    const access = await assertVersionedResourceAccess(\n      args.resourceType,\n      args.resourceId,\n      actionCtx,\n      \"editor\",\n    );\n    const registration = getVersionedResource(args.resourceType);\n    const snapshot =\n      args.snapshot !== undefined\n        ? args.snapshot\n        : await registration?.getSnapshot?.({\n            resourceType: args.resourceType,\n            resourceId: args.resourceId,\n            ctx: actionCtx,\n            access,\n          });\n\n    if (snapshot === undefined) {\n      throw new Error(\n        `No snapshot was provided and ${args.resourceType} has no getSnapshot history handler`,\n      );\n    }\n\n    return insertResourceVersion({\n      resourceType: args.resourceType,\n      resourceId: args.resourceId,\n      createdBy: actionCtx?.userEmail ?? null,\n      actorKind: actorKindFromContext(actionCtx),\n      ownerEmail: access.ownerEmail ?? actionCtx?.userEmail ?? null,\n      orgId: access.orgId ?? actionCtx?.orgId ?? null,\n      visibility: normalizeHistoryVisibility(access.visibility),\n      title: args.title,\n      summary: args.summary,\n      snapshot,\n      metadata: args.metadata,\n    });\n  },\n  audit: {\n    target: (args, result) => {\n      const version = result as {\n        ownerEmail?: string | null;\n        orgId?: string | null;\n        visibility?: \"private\" | \"org\" | \"public\";\n      };\n      return {\n        type: args.resourceType,\n        id: args.resourceId,\n        ownerEmail: version.ownerEmail,\n        orgId: version.orgId,\n        visibility: version.visibility,\n      };\n    },\n  },\n});\n\nfunction actorKindFromContext(\n  ctx: VersionedResourceContext | undefined,\n): HistoryActorKind {\n  const caller = typeof ctx?.caller === \"string\" ? ctx.caller : \"\";\n  if (caller === \"agent\" || caller === \"tool\") {\n    return \"agent\";\n  }\n  return ctx?.userEmail ? \"human\" : \"system\";\n}\n"]}
+{"version":3,"file":"create-resource-version.js","sourceRoot":"","sources":["../../../src/history/actions/create-resource-version.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\n\nimport { defineAction } from \"../../action.js\";\nimport {\n  assertVersionedResourceAccess,\n  getVersionedResource,\n  normalizeHistoryVisibility,\n} from \"../registry.js\";\nimport { insertResourceVersion } from \"../store.js\";\nimport type { HistoryActorKind, VersionedResourceContext } from \"../types.js\";\n\nconst schema = z.object({\n  resourceType: z.string().min(1),\n  resourceId: z.string().min(1),\n  title: z.string().optional(),\n  summary: z.string().optional(),\n  snapshot: z.unknown().optional(),\n  metadata: z.record(z.string(), z.unknown()).optional(),\n});\n\nexport default defineAction({\n  description: \"Create a reusable version-history snapshot for a resource.\",\n  schema,\n  run: async (args, ctx) => {\n    const actionCtx = ctx as VersionedResourceContext | undefined;\n    const access = await assertVersionedResourceAccess(\n      args.resourceType,\n      args.resourceId,\n      actionCtx,\n      \"editor\",\n    );\n    const registration = getVersionedResource(args.resourceType);\n    // Prefer the registered server snapshot when available so editors/agents\n    // cannot plant arbitrary restore payloads for managed resource types.\n    const serverSnapshot = registration?.getSnapshot\n      ? await registration.getSnapshot({\n          resourceType: args.resourceType,\n          resourceId: args.resourceId,\n          ctx: actionCtx,\n          access,\n        })\n      : undefined;\n    const snapshot =\n      serverSnapshot !== undefined ? serverSnapshot : args.snapshot;\n\n    if (snapshot === undefined) {\n      throw new Error(\n        `No snapshot was provided and ${args.resourceType} has no getSnapshot history handler`,\n      );\n    }\n\n    return insertResourceVersion({\n      resourceType: args.resourceType,\n      resourceId: args.resourceId,\n      createdBy: actionCtx?.userEmail ?? null,\n      actorKind: actorKindFromContext(actionCtx),\n      ownerEmail: access.ownerEmail ?? actionCtx?.userEmail ?? null,\n      orgId: access.orgId ?? actionCtx?.orgId ?? null,\n      visibility: normalizeHistoryVisibility(access.visibility),\n      title: args.title,\n      summary: args.summary,\n      snapshot,\n      metadata: args.metadata,\n    });\n  },\n  audit: {\n    target: (args, result) => {\n      const version = result as {\n        ownerEmail?: string | null;\n        orgId?: string | null;\n        visibility?: \"private\" | \"org\" | \"public\";\n      };\n      return {\n        type: args.resourceType,\n        id: args.resourceId,\n        ownerEmail: version.ownerEmail,\n        orgId: version.orgId,\n        visibility: version.visibility,\n      };\n    },\n  },\n});\n\nfunction actorKindFromContext(\n  ctx: VersionedResourceContext | undefined,\n): HistoryActorKind {\n  const caller = typeof ctx?.caller === \"string\" ? ctx.caller : \"\";\n  if (caller === \"agent\" || caller === \"tool\") {\n    return \"agent\";\n  }\n  return ctx?.userEmail ? \"human\" : \"system\";\n}\n"]}

package/dist/history/index.d.ts

@@ -1,4 +1,4 @@
 export type { HistoryActorKind, HistoryResourceRole, ResourceHistoryScope, ResourceVersion, VersionedResourceAccess, VersionedResourceContext, VersionedResourceRegistration, VersionedResourceRestoreContext, VersionedResourceSnapshotContext, } from "./types.js";
 export { __resetVersionedResourcesForTests, assertVersionedResourceAccess, getVersionedResource, listVersionedResources, registerVersionedResource, resolveVersionedResourceAccess, } from "./registry.js";
-export { __resetHistoryInitForTests, ensureResourceVersionsTable, getResourceVersionById, getResourceVersionByNumber, insertResourceVersion, queryResourceVersions, } from "./store.js";
+export { __resetHistoryInitForTests, ensureResourceVersionsTable, getResourceVersionById, getResourceVersionByNumber, queryResourceVersions, } from "./store.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/history/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/history/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EACf,uBAAuB,EACvB,wBAAwB,EACxB,6BAA6B,EAC7B,+BAA+B,EAC/B,gCAAgC,GACjC,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,iCAAiC,EACjC,6BAA6B,EAC7B,oBAAoB,EACpB,sBAAsB,EACtB,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,EAC3B,sBAAsB,EACtB,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/history/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EACf,uBAAuB,EACvB,wBAAwB,EACxB,6BAA6B,EAC7B,+BAA+B,EAC/B,gCAAgC,GACjC,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,iCAAiC,EACjC,6BAA6B,EAC7B,oBAAoB,EACpB,sBAAsB,EACtB,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,EAC3B,sBAAsB,EACtB,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,YAAY,CAAC"}

package/dist/history/index.js

@@ -1,3 +1,3 @@
 export { __resetVersionedResourcesForTests, assertVersionedResourceAccess, getVersionedResource, listVersionedResources, registerVersionedResource, resolveVersionedResourceAccess, } from "./registry.js";
-export { __resetHistoryInitForTests, ensureResourceVersionsTable, getResourceVersionById, getResourceVersionByNumber, insertResourceVersion, queryResourceVersions, } from "./store.js";
+export { __resetHistoryInitForTests, ensureResourceVersionsTable, getResourceVersionById, getResourceVersionByNumber, queryResourceVersions, } from "./store.js";
 //# sourceMappingURL=index.js.map

package/dist/history/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/history/index.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,iCAAiC,EACjC,6BAA6B,EAC7B,oBAAoB,EACpB,sBAAsB,EACtB,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,EAC3B,sBAAsB,EACtB,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,YAAY,CAAC","sourcesContent":["export type {\n  HistoryActorKind,\n  HistoryResourceRole,\n  ResourceHistoryScope,\n  ResourceVersion,\n  VersionedResourceAccess,\n  VersionedResourceContext,\n  VersionedResourceRegistration,\n  VersionedResourceRestoreContext,\n  VersionedResourceSnapshotContext,\n} from \"./types.js\";\nexport {\n  __resetVersionedResourcesForTests,\n  assertVersionedResourceAccess,\n  getVersionedResource,\n  listVersionedResources,\n  registerVersionedResource,\n  resolveVersionedResourceAccess,\n} from \"./registry.js\";\nexport {\n  __resetHistoryInitForTests,\n  ensureResourceVersionsTable,\n  getResourceVersionById,\n  getResourceVersionByNumber,\n  insertResourceVersion,\n  queryResourceVersions,\n} from \"./store.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/history/index.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,iCAAiC,EACjC,6BAA6B,EAC7B,oBAAoB,EACpB,sBAAsB,EACtB,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,EAC3B,sBAAsB,EACtB,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,YAAY,CAAC","sourcesContent":["export type {\n  HistoryActorKind,\n  HistoryResourceRole,\n  ResourceHistoryScope,\n  ResourceVersion,\n  VersionedResourceAccess,\n  VersionedResourceContext,\n  VersionedResourceRegistration,\n  VersionedResourceRestoreContext,\n  VersionedResourceSnapshotContext,\n} from \"./types.js\";\nexport {\n  __resetVersionedResourcesForTests,\n  assertVersionedResourceAccess,\n  getVersionedResource,\n  listVersionedResources,\n  registerVersionedResource,\n  resolveVersionedResourceAccess,\n} from \"./registry.js\";\nexport {\n  __resetHistoryInitForTests,\n  ensureResourceVersionsTable,\n  getResourceVersionById,\n  getResourceVersionByNumber,\n  queryResourceVersions,\n} from \"./store.js\";\n"]}

package/dist/history/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/history/registry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACxB,6BAA6B,EAC9B,MAAM,YAAY,CAAC;AAIpB,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,6BAA6B,GAC1C,IAAI,CAON;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,GACX,6BAA6B,GAAG,SAAS,CAE3C;AAED,wBAAgB,sBAAsB,IAAI,6BAA6B,EAAE,CAExE;AAED,wBAAsB,8BAA8B,CAClD,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,GAAG,CAAC,EAAE,wBAAwB,GAC7B,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC,CA8BzC;AAED,wBAAsB,6BAA6B,CACjD,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,wBAAwB,GAAG,SAAS,EACzC,WAAW,EAAE,mBAAmB,GAC/B,OAAO,CAAC,uBAAuB,CAAC,CAYlC;AAED,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,GACxC,UAAU,CAIZ;AAED,wBAAgB,iCAAiC,IAAI,IAAI,CAExD"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/history/registry.ts"],"names":[],"mappings":"AAMA,OAAO,EAAiB,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACxB,6BAA6B,EAC9B,MAAM,YAAY,CAAC;AAIpB,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,6BAA6B,GAC1C,IAAI,CAON;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,GACX,6BAA6B,GAAG,SAAS,CAE3C;AAED,wBAAgB,sBAAsB,IAAI,6BAA6B,EAAE,CAExE;AAYD,wBAAsB,8BAA8B,CAClD,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,GAAG,CAAC,EAAE,wBAAwB,GAC7B,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC,CA4BzC;AAED,wBAAsB,6BAA6B,CACjD,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,wBAAwB,GAAG,SAAS,EACzC,WAAW,EAAE,mBAAmB,GAC/B,OAAO,CAAC,uBAAuB,CAAC,CAYlC;AAED,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,GACxC,UAAU,CAIZ;AAED,wBAAgB,iCAAiC,IAAI,IAAI,CAExD"}

package/dist/history/registry.js

@@ -1,4 +1,4 @@
-import { ForbiddenError, resolveAccess } from "../sharing/access.js";
+import { ForbiddenError, resolveAccess, } from "../sharing/access.js";
 import { getShareableResource } from "../sharing/registry.js";
 import { roleSatisfies } from "../sharing/schema.js";
 const registrations = new Map();
@@ -14,13 +14,21 @@ export function getVersionedResource(type) {
 export function listVersionedResources() {
     return Array.from(registrations.values());
 }
+function accessContextFrom(ctx) {
+    if (!ctx)
+        return undefined;
+    return {
+        userEmail: ctx.userEmail ?? undefined,
+        orgId: ctx.orgId ?? undefined,
+    };
+}
 export async function resolveVersionedResourceAccess(resourceType, resourceId, ctx) {
     const registration = getVersionedResource(resourceType);
     if (registration?.resolveAccess) {
         return registration.resolveAccess(resourceId, ctx);
     }
     if (getShareableResource(resourceType)) {
-        const access = await resolveAccess(resourceType, resourceId);
+        const access = await resolveAccess(resourceType, resourceId, accessContextFrom(ctx));
         if (!access) {
             return null;
         }
@@ -32,16 +40,10 @@ export async function resolveVersionedResourceAccess(resourceType, resourceId, c
             resource: access.resource,
         };
     }
-    const userEmail = ctx?.userEmail ?? null;
-    if (!userEmail) {
-        return null;
-    }
-    return {
-        role: "owner",
-        ownerEmail: userEmail,
-        orgId: ctx?.orgId ?? null,
-        visibility: "private",
-    };
+    // Fail closed: unregistered types, and registered types without an access
+    // resolver that aren't shareable, never invent ownership. bypassScope on
+    // history queries is only safe after a real resource ACL.
+    return null;
 }
 export async function assertVersionedResourceAccess(resourceType, resourceId, ctx, minimumRole) {
     const access = await resolveVersionedResourceAccess(resourceType, resourceId, ctx);

package/dist/history/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/history/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAmB,MAAM,sBAAsB,CAAC;AAQtE,MAAM,aAAa,GAAG,IAAI,GAAG,EAAyC,CAAC;AAEvE,MAAM,UAAU,yBAAyB,CACvC,YAA2C;IAE3C,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,8DAA8D,CAC/D,CAAC;IACJ,CAAC;IACD,aAAa,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,IAAY;IAEZ,OAAO,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,YAAoB,EACpB,UAAkB,EAClB,GAA8B;IAE9B,MAAM,YAAY,GAAG,oBAAoB,CAAC,YAAY,CAAC,CAAC;IACxD,IAAI,YAAY,EAAE,aAAa,EAAE,CAAC;QAChC,OAAO,YAAY,CAAC,aAAa,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IACrD,CAAC;IAED,IAAI,oBAAoB,CAAC,YAAY,CAAC,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QAC7D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,IAA2B;YACxC,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,UAAU,IAAI,IAAI;YAC9C,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,IAAI,IAAI;YACpC,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,UAAU;YACtC,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,GAAG,EAAE,SAAS,IAAI,IAAI,CAAC;IACzC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO;QACL,IAAI,EAAE,OAAO;QACb,UAAU,EAAE,SAAS;QACrB,KAAK,EAAE,GAAG,EAAE,KAAK,IAAI,IAAI;QACzB,UAAU,EAAE,SAAS;KACtB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,YAAoB,EACpB,UAAkB,EAClB,GAAyC,EACzC,WAAgC;IAEhC,MAAM,MAAM,GAAG,MAAM,8BAA8B,CACjD,YAAY,EACZ,UAAU,EACV,GAAG,CACJ,CAAC;IACF,IAAI,CAAC,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,cAAc,CACtB,yBAAyB,YAAY,IAAI,UAAU,EAAE,CACtD,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,UAAyC;IAEzC,OAAO,UAAU,KAAK,KAAK,IAAI,UAAU,KAAK,QAAQ;QACpD,CAAC,CAAC,UAAU;QACZ,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,iCAAiC;IAC/C,aAAa,CAAC,KAAK,EAAE,CAAC;AACxB,CAAC","sourcesContent":["import { ForbiddenError, resolveAccess } from \"../sharing/access.js\";\nimport { getShareableResource } from \"../sharing/registry.js\";\nimport { roleSatisfies, type Visibility } from \"../sharing/schema.js\";\nimport type {\n  HistoryResourceRole,\n  VersionedResourceAccess,\n  VersionedResourceContext,\n  VersionedResourceRegistration,\n} from \"./types.js\";\n\nconst registrations = new Map<string, VersionedResourceRegistration>();\n\nexport function registerVersionedResource(\n  registration: VersionedResourceRegistration,\n): void {\n  if (!registration.type.trim()) {\n    throw new Error(\n      \"registerVersionedResource requires a non-empty resource type\",\n    );\n  }\n  registrations.set(registration.type, registration);\n}\n\nexport function getVersionedResource(\n  type: string,\n): VersionedResourceRegistration | undefined {\n  return registrations.get(type);\n}\n\nexport function listVersionedResources(): VersionedResourceRegistration[] {\n  return Array.from(registrations.values());\n}\n\nexport async function resolveVersionedResourceAccess(\n  resourceType: string,\n  resourceId: string,\n  ctx?: VersionedResourceContext,\n): Promise<VersionedResourceAccess | null> {\n  const registration = getVersionedResource(resourceType);\n  if (registration?.resolveAccess) {\n    return registration.resolveAccess(resourceId, ctx);\n  }\n\n  if (getShareableResource(resourceType)) {\n    const access = await resolveAccess(resourceType, resourceId);\n    if (!access) {\n      return null;\n    }\n    return {\n      role: access.role as HistoryResourceRole,\n      ownerEmail: access.resource.ownerEmail ?? null,\n      orgId: access.resource.orgId ?? null,\n      visibility: access.resource.visibility,\n      resource: access.resource,\n    };\n  }\n\n  const userEmail = ctx?.userEmail ?? null;\n  if (!userEmail) {\n    return null;\n  }\n  return {\n    role: \"owner\",\n    ownerEmail: userEmail,\n    orgId: ctx?.orgId ?? null,\n    visibility: \"private\",\n  };\n}\n\nexport async function assertVersionedResourceAccess(\n  resourceType: string,\n  resourceId: string,\n  ctx: VersionedResourceContext | undefined,\n  minimumRole: HistoryResourceRole,\n): Promise<VersionedResourceAccess> {\n  const access = await resolveVersionedResourceAccess(\n    resourceType,\n    resourceId,\n    ctx,\n  );\n  if (!access || !roleSatisfies(access.role, minimumRole)) {\n    throw new ForbiddenError(\n      `Not allowed to access ${resourceType}:${resourceId}`,\n    );\n  }\n  return access;\n}\n\nexport function normalizeHistoryVisibility(\n  visibility: Visibility | null | undefined,\n): Visibility {\n  return visibility === \"org\" || visibility === \"public\"\n    ? visibility\n    : \"private\";\n}\n\nexport function __resetVersionedResourcesForTests(): void {\n  registrations.clear();\n}\n"]}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/history/registry.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  ForbiddenError,\n  resolveAccess,\n  type AccessContext,\n} from \"../sharing/access.js\";\nimport { getShareableResource } from \"../sharing/registry.js\";\nimport { roleSatisfies, type Visibility } from \"../sharing/schema.js\";\nimport type {\n  HistoryResourceRole,\n  VersionedResourceAccess,\n  VersionedResourceContext,\n  VersionedResourceRegistration,\n} from \"./types.js\";\n\nconst registrations = new Map<string, VersionedResourceRegistration>();\n\nexport function registerVersionedResource(\n  registration: VersionedResourceRegistration,\n): void {\n  if (!registration.type.trim()) {\n    throw new Error(\n      \"registerVersionedResource requires a non-empty resource type\",\n    );\n  }\n  registrations.set(registration.type, registration);\n}\n\nexport function getVersionedResource(\n  type: string,\n): VersionedResourceRegistration | undefined {\n  return registrations.get(type);\n}\n\nexport function listVersionedResources(): VersionedResourceRegistration[] {\n  return Array.from(registrations.values());\n}\n\nfunction accessContextFrom(\n  ctx?: VersionedResourceContext,\n): AccessContext | undefined {\n  if (!ctx) return undefined;\n  return {\n    userEmail: ctx.userEmail ?? undefined,\n    orgId: ctx.orgId ?? undefined,\n  };\n}\n\nexport async function resolveVersionedResourceAccess(\n  resourceType: string,\n  resourceId: string,\n  ctx?: VersionedResourceContext,\n): Promise<VersionedResourceAccess | null> {\n  const registration = getVersionedResource(resourceType);\n  if (registration?.resolveAccess) {\n    return registration.resolveAccess(resourceId, ctx);\n  }\n\n  if (getShareableResource(resourceType)) {\n    const access = await resolveAccess(\n      resourceType,\n      resourceId,\n      accessContextFrom(ctx),\n    );\n    if (!access) {\n      return null;\n    }\n    return {\n      role: access.role as HistoryResourceRole,\n      ownerEmail: access.resource.ownerEmail ?? null,\n      orgId: access.resource.orgId ?? null,\n      visibility: access.resource.visibility,\n      resource: access.resource,\n    };\n  }\n\n  // Fail closed: unregistered types, and registered types without an access\n  // resolver that aren't shareable, never invent ownership. bypassScope on\n  // history queries is only safe after a real resource ACL.\n  return null;\n}\n\nexport async function assertVersionedResourceAccess(\n  resourceType: string,\n  resourceId: string,\n  ctx: VersionedResourceContext | undefined,\n  minimumRole: HistoryResourceRole,\n): Promise<VersionedResourceAccess> {\n  const access = await resolveVersionedResourceAccess(\n    resourceType,\n    resourceId,\n    ctx,\n  );\n  if (!access || !roleSatisfies(access.role, minimumRole)) {\n    throw new ForbiddenError(\n      `Not allowed to access ${resourceType}:${resourceId}`,\n    );\n  }\n  return access;\n}\n\nexport function normalizeHistoryVisibility(\n  visibility: Visibility | null | undefined,\n): Visibility {\n  return visibility === \"org\" || visibility === \"public\"\n    ? visibility\n    : \"private\";\n}\n\nexport function __resetVersionedResourcesForTests(): void {\n  registrations.clear();\n}\n"]}

package/dist/history/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/history/store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EACV,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EAChB,MAAM,YAAY,CAAC;AAIpB,MAAM,WAAW,0BAA0B;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC3C;AAED,MAAM,WAAW,0BAA0B;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,oBAAoB,CAAC;IAC5B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,IAAI,CAAC,CAkDjE;AAED,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,0BAA0B,GAChC,OAAO,CAAC,eAAe,CAAC,CAwE1B;AAED,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,0BAA0B,GAChC,OAAO,CAAC,eAAe,EAAE,CAAC,CAiB5B;AAED,wBAAsB,sBAAsB,CAC1C,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,oBAAoB,EAC3B,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,GACtC,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAejC;AAED,wBAAsB,0BAA0B,CAC9C,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,oBAAoB,EAC3B,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,GACtC,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAkBjC;AAED,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/history/store.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EACV,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EAChB,MAAM,YAAY,CAAC;AAMpB,MAAM,WAAW,0BAA0B;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC3C;AAED,MAAM,WAAW,0BAA0B;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,oBAAoB,CAAC;IAC5B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,IAAI,CAAC,CAkDjE;AAED,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,0BAA0B,GAChC,OAAO,CAAC,eAAe,CAAC,CAgG1B;AAED,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,0BAA0B,GAChC,OAAO,CAAC,eAAe,EAAE,CAAC,CAiB5B;AAED,wBAAsB,sBAAsB,CAC1C,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,oBAAoB,EAC3B,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,GACtC,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAejC;AAED,wBAAsB,0BAA0B,CAC9C,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,oBAAoB,EAC3B,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,GACtC,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAkBjC;AAED,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD"}

package/dist/history/store.js

@@ -1,6 +1,7 @@
-import { getDbExec, intType, isPostgres } from "../db/client.js";
+import { getDbExec, intType, isPostgres, isUniqueViolation, } from "../db/client.js";
 import { ensureIndexExists, ensureTableExists } from "../db/ddl-guard.js";
 let historyTableInitPromise;
+const VERSION_INSERT_MAX_ATTEMPTS = 8;
 export async function ensureResourceVersionsTable() {
     if (!historyTableInitPromise) {
         historyTableInitPromise = (async () => {
@@ -22,7 +23,7 @@ export async function ensureResourceVersionsTable() {
       metadata_json TEXT
     )`;
             const indexes = [
-                `CREATE INDEX IF NOT EXISTS idx_agent_resource_versions_resource
+                `CREATE UNIQUE INDEX IF NOT EXISTS idx_agent_resource_versions_resource_number
            ON agent_resource_versions (resource_type, resource_id, version_number)`,
                 `CREATE INDEX IF NOT EXISTS idx_agent_resource_versions_owner
            ON agent_resource_versions (owner_email, created_at)`,
@@ -31,7 +32,7 @@ export async function ensureResourceVersionsTable() {
             ];
             if (isPostgres()) {
                 await ensureTableExists("agent_resource_versions", createSql);
-                await ensureIndexExists("idx_agent_resource_versions_resource", indexes[0]);
+                await ensureIndexExists("idx_agent_resource_versions_resource_number", indexes[0]);
                 await ensureIndexExists("idx_agent_resource_versions_owner", indexes[1]);
                 await ensureIndexExists("idx_agent_resource_versions_org", indexes[2]);
             }
@@ -48,36 +49,49 @@ export async function ensureResourceVersionsTable() {
 export async function insertResourceVersion(input) {
     await ensureResourceVersionsTable();
     const client = getDbExec();
-    const maxRows = await client.execute({
-        sql: `SELECT MAX(version_number) as max_version
+    const visibility = input.visibility === "org" || input.visibility === "public"
+        ? input.visibility
+        : "private";
+    const actorKind = input.actorKind ?? "human";
+    const createdBy = input.createdBy ?? null;
+    const ownerEmail = input.ownerEmail ?? input.createdBy ?? null;
+    const orgId = input.orgId ?? null;
+    const title = input.title ?? null;
+    const summary = input.summary ?? null;
+    const metadata = input.metadata ?? null;
+    const snapshotJson = JSON.stringify(input.snapshot);
+    const metadataJson = stringifyOptionalJson(metadata);
+    let lastError;
+    for (let attempt = 0; attempt < VERSION_INSERT_MAX_ATTEMPTS; attempt++) {
+        const maxRows = await client.execute({
+            sql: `SELECT MAX(version_number) as max_version
        FROM agent_resource_versions
       WHERE resource_type = ? AND resource_id = ?`,
-        args: [input.resourceType, input.resourceId],
-    });
-    const versionNumber = Number(maxRows.rows?.[0]?.max_version ??
-        0) + 1;
-    const id = createVersionId();
-    const createdAt = new Date().toISOString();
-    const version = {
-        id,
-        resourceType: input.resourceType,
-        resourceId: input.resourceId,
-        versionNumber,
-        createdAt,
-        createdBy: input.createdBy ?? null,
-        actorKind: input.actorKind ?? "human",
-        ownerEmail: input.ownerEmail ?? input.createdBy ?? null,
-        orgId: input.orgId ?? null,
-        visibility: input.visibility === "org" || input.visibility === "public"
-            ? input.visibility
-            : "private",
-        title: input.title ?? null,
-        summary: input.summary ?? null,
-        snapshot: input.snapshot,
-        metadata: input.metadata ?? null,
-    };
-    await client.execute({
-        sql: `INSERT INTO agent_resource_versions (
+            args: [input.resourceType, input.resourceId],
+        });
+        const versionNumber = Number(maxRows.rows?.[0]
+            ?.max_version ?? 0) + 1;
+        const id = createVersionId();
+        const createdAt = new Date().toISOString();
+        const version = {
+            id,
+            resourceType: input.resourceType,
+            resourceId: input.resourceId,
+            versionNumber,
+            createdAt,
+            createdBy,
+            actorKind,
+            ownerEmail,
+            orgId,
+            visibility,
+            title,
+            summary,
+            snapshot: input.snapshot,
+            metadata,
+        };
+        try {
+            await client.execute({
+                sql: `INSERT INTO agent_resource_versions (
       id,
       resource_type,
       resource_id,
@@ -93,24 +107,35 @@ export async function insertResourceVersion(input) {
       snapshot_json,
       metadata_json
     ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
-        args: [
-            version.id,
-            version.resourceType,
-            version.resourceId,
-            version.versionNumber,
-            version.createdAt,
-            version.createdBy,
-            version.actorKind,
-            version.ownerEmail,
-            version.orgId,
-            version.visibility,
-            version.title,
-            version.summary,
-            JSON.stringify(version.snapshot),
-            stringifyOptionalJson(version.metadata),
-        ],
-    });
-    return version;
+                args: [
+                    version.id,
+                    version.resourceType,
+                    version.resourceId,
+                    version.versionNumber,
+                    version.createdAt,
+                    version.createdBy,
+                    version.actorKind,
+                    version.ownerEmail,
+                    version.orgId,
+                    version.visibility,
+                    version.title,
+                    version.summary,
+                    snapshotJson,
+                    metadataJson,
+                ],
+            });
+            return version;
+        }
+        catch (error) {
+            lastError = error;
+            if (!isUniqueViolation(error)) {
+                throw error;
+            }
+        }
+    }
+    throw lastError instanceof Error
+        ? lastError
+        : new Error("Failed to allocate a unique resource version number");
 }
 export async function queryResourceVersions(input) {
     await ensureResourceVersionsTable();