@shipfox/annotations 2.0.0

package/.turbo/turbo-build.log

@@ -0,0 +1,2 @@
+$ shipfox-swc
+Successfully compiled: 16 files with swc (50.57ms)

package/.turbo/turbo-type$colon$emit.log

@@ -0,0 +1 @@
+$ shipfox-tsc-emit

package/.turbo/turbo-type.log

@@ -0,0 +1 @@
+$ shipfox-tsc-check

package/CHANGELOG.md

@@ -0,0 +1,67 @@
+# @shipfox/annotations
+
+## 2.0.0
+
+### Minor Changes
+
+- 1b0d344: Publishes the complete API runtime closure with packed-consumer-safe internal imports and records its exact package set in application releases.
+
+### Patch Changes
+
+- Updated dependencies [0cd6dd4]
+- Updated dependencies [1b0d344]
+  - @shipfox/node-module@0.2.0
+  - @shipfox/annotations-dto@2.0.0
+  - @shipfox/api-auth-context@2.0.0
+  - @shipfox/config@1.2.1
+  - @shipfox/node-drizzle@0.2.1
+  - @shipfox/node-fastify@0.2.1
+  - @shipfox/node-postgres@0.4.1
+
+## 0.0.3
+
+### Patch Changes
+
+- @shipfox/node-module@0.1.2
+
+## 0.0.2
+
+### Patch Changes
+
+- Updated dependencies [ec75cd5]
+- Updated dependencies [6a1fb54]
+  - @shipfox/node-drizzle@0.2.0
+  - @shipfox/node-postgres@0.4.0
+  - @shipfox/node-module@0.1.1
+
+## 0.0.1
+
+### Patch Changes
+
+- 5707d6d: Adds the user-authenticated annotations read route with workspace-scoped run-attempt filtering, DTO conversion, and a continuation cursor.
+- 0dd23a7: Warns on agent tool capability mismatches during dispatch without blocking label-matched runners.
+- Updated dependencies [34ba284]
+- Updated dependencies [5707d6d]
+- Updated dependencies [b9c3f32]
+- Updated dependencies [a81b68c]
+- Updated dependencies [c0a883c]
+- Updated dependencies [72ce351]
+- Updated dependencies [e47f8da]
+- Updated dependencies [ae7a63c]
+- Updated dependencies [f92122b]
+- Updated dependencies [857fd73]
+- Updated dependencies [75520ff]
+- Updated dependencies [d6d4862]
+- Updated dependencies [c0a883c]
+- Updated dependencies [6077301]
+- Updated dependencies [3bea87f]
+- Updated dependencies [82d22e4]
+- Updated dependencies [6181819]
+- Updated dependencies [9c149d1]
+  - @shipfox/node-fastify@0.2.0
+  - @shipfox/annotations-dto@0.0.1
+  - @shipfox/node-drizzle@0.1.0
+  - @shipfox/api-auth-context@0.1.0
+  - @shipfox/node-postgres@0.3.2
+  - @shipfox/node-module@0.1.0
+  - @shipfox/config@1.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shipfox
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/config.d.ts

@@ -0,0 +1,6 @@
+export declare const config: Readonly<{
+    ANNOTATIONS_MAX_BODY_BYTES: number;
+    ANNOTATIONS_MAX_PER_EXECUTION: number;
+    ANNOTATIONS_MAX_TOTAL_BYTES: number;
+} & import("@shipfox/config").CleanedEnvAccessors>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,MAAM;;;;kDAajB,CAAC"}

package/dist/config.js

@@ -0,0 +1,26 @@
+import { createConfig, num } from '@shipfox/config';
+export const config = createConfig({
+    ANNOTATIONS_MAX_BODY_BYTES: num({
+        desc: 'Maximum UTF-8 byte size of one annotation body. Writes that would make an annotation body larger than this are rejected.',
+        default: 1048576
+    }),
+    ANNOTATIONS_MAX_PER_EXECUTION: num({
+        desc: 'Maximum number of distinct annotation contexts one job execution may store.',
+        default: 50
+    }),
+    ANNOTATIONS_MAX_TOTAL_BYTES: num({
+        desc: 'Maximum total UTF-8 bytes of annotation bodies one job execution may store.',
+        default: 4194304
+    })
+});
+for (const name of [
+    'ANNOTATIONS_MAX_BODY_BYTES',
+    'ANNOTATIONS_MAX_PER_EXECUTION',
+    'ANNOTATIONS_MAX_TOTAL_BYTES'
+]){
+    if (!Number.isInteger(config[name]) || config[name] < 1) {
+        throw new Error(`${name} (${config[name]}) must be a whole number greater than 0.`);
+    }
+}
+
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config.ts"],"sourcesContent":["import {createConfig, num} from '@shipfox/config';\n\nexport const config = createConfig({\n  ANNOTATIONS_MAX_BODY_BYTES: num({\n    desc: 'Maximum UTF-8 byte size of one annotation body. Writes that would make an annotation body larger than this are rejected.',\n    default: 1048576,\n  }),\n  ANNOTATIONS_MAX_PER_EXECUTION: num({\n    desc: 'Maximum number of distinct annotation contexts one job execution may store.',\n    default: 50,\n  }),\n  ANNOTATIONS_MAX_TOTAL_BYTES: num({\n    desc: 'Maximum total UTF-8 bytes of annotation bodies one job execution may store.',\n    default: 4194304,\n  }),\n});\n\nfor (const name of [\n  'ANNOTATIONS_MAX_BODY_BYTES',\n  'ANNOTATIONS_MAX_PER_EXECUTION',\n  'ANNOTATIONS_MAX_TOTAL_BYTES',\n] as const) {\n  if (!Number.isInteger(config[name]) || config[name] < 1) {\n    throw new Error(`${name} (${config[name]}) must be a whole number greater than 0.`);\n  }\n}\n"],"names":["createConfig","num","config","ANNOTATIONS_MAX_BODY_BYTES","desc","default","ANNOTATIONS_MAX_PER_EXECUTION","ANNOTATIONS_MAX_TOTAL_BYTES","name","Number","isInteger","Error"],"mappings":"AAAA,SAAQA,YAAY,EAAEC,GAAG,QAAO,kBAAkB;AAElD,OAAO,MAAMC,SAASF,aAAa;IACjCG,4BAA4BF,IAAI;QAC9BG,MAAM;QACNC,SAAS;IACX;IACAC,+BAA+BL,IAAI;QACjCG,MAAM;QACNC,SAAS;IACX;IACAE,6BAA6BN,IAAI;QAC/BG,MAAM;QACNC,SAAS;IACX;AACF,GAAG;AAEH,KAAK,MAAMG,QAAQ;IACjB;IACA;IACA;CACD,CAAW;IACV,IAAI,CAACC,OAAOC,SAAS,CAACR,MAAM,CAACM,KAAK,KAAKN,MAAM,CAACM,KAAK,GAAG,GAAG;QACvD,MAAM,IAAIG,MAAM,GAAGH,KAAK,EAAE,EAAEN,MAAM,CAACM,KAAK,CAAC,wCAAwC,CAAC;IACpF;AACF"}

package/dist/core/entities/annotation.d.ts

@@ -0,0 +1,21 @@
+import type { AnnotationStyleDto } from '@shipfox/annotations-dto';
+export interface Annotation {
+    id: string;
+    workspaceId: string;
+    projectId: string;
+    workflowRunId: string;
+    workflowRunAttempt: number;
+    workflowRunAttemptId: string;
+    jobId: string;
+    jobExecutionId: string;
+    originStepId: string;
+    originStepAttempt: number;
+    context: string;
+    style: AnnotationStyleDto;
+    body: string;
+    bodyBytes: number;
+    sequence: number;
+    createdAt: Date;
+    updatedAt: Date;
+}
+//# sourceMappingURL=annotation.d.ts.map

package/dist/core/entities/annotation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotation.d.ts","sourceRoot":"","sources":["../../../src/core/entities/annotation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,0BAA0B,CAAC;AAEjE,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB"}

package/dist/core/entities/annotation.js

@@ -0,0 +1,3 @@
+export { };
+
+//# sourceMappingURL=annotation.js.map

package/dist/core/entities/annotation.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/entities/annotation.ts"],"sourcesContent":["import type {AnnotationStyleDto} from '@shipfox/annotations-dto';\n\nexport interface Annotation {\n  id: string;\n  workspaceId: string;\n  projectId: string;\n  workflowRunId: string;\n  workflowRunAttempt: number;\n  workflowRunAttemptId: string;\n  jobId: string;\n  jobExecutionId: string;\n  originStepId: string;\n  originStepAttempt: number;\n  context: string;\n  style: AnnotationStyleDto;\n  body: string;\n  bodyBytes: number;\n  sequence: number;\n  createdAt: Date;\n  updatedAt: Date;\n}\n"],"names":[],"mappings":"AAEA,WAkBC"}

package/dist/core/entities/index.d.ts

@@ -0,0 +1,2 @@
+export type { Annotation } from './annotation.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/entities/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/entities/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAC,UAAU,EAAC,MAAM,iBAAiB,CAAC"}

package/dist/core/entities/index.js

@@ -0,0 +1,3 @@
+export { };
+
+//# sourceMappingURL=index.js.map

package/dist/core/entities/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/entities/index.ts"],"sourcesContent":["export type {Annotation} from './annotation.js';\n"],"names":[],"mappings":"AAAA,WAAgD"}

package/dist/core/errors.d.ts

@@ -0,0 +1,13 @@
+export declare class AnnotationBodyTooLargeError extends Error {
+    readonly maxBytes: number;
+    constructor(maxBytes: number);
+}
+export declare class AnnotationCountLimitExceededError extends Error {
+    readonly maxAnnotations: number;
+    constructor(maxAnnotations: number);
+}
+export declare class AnnotationTotalBytesLimitExceededError extends Error {
+    readonly maxBytes: number;
+    constructor(maxBytes: number);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,2BAA4B,SAAQ,KAAK;aACxB,QAAQ,EAAE,MAAM;gBAAhB,QAAQ,EAAE,MAAM;CAI7C;AAED,qBAAa,iCAAkC,SAAQ,KAAK;aAC9B,cAAc,EAAE,MAAM;gBAAtB,cAAc,EAAE,MAAM;CAInD;AAED,qBAAa,sCAAuC,SAAQ,KAAK;aACnC,QAAQ,EAAE,MAAM;gBAAhB,QAAQ,EAAE,MAAM;CAI7C"}

package/dist/core/errors.js

@@ -0,0 +1,20 @@
+export class AnnotationBodyTooLargeError extends Error {
+    constructor(maxBytes){
+        super(`Annotation body exceeds ${maxBytes} bytes`), this.maxBytes = maxBytes;
+        this.name = 'AnnotationBodyTooLargeError';
+    }
+}
+export class AnnotationCountLimitExceededError extends Error {
+    constructor(maxAnnotations){
+        super(`Annotation count exceeds ${maxAnnotations}`), this.maxAnnotations = maxAnnotations;
+        this.name = 'AnnotationCountLimitExceededError';
+    }
+}
+export class AnnotationTotalBytesLimitExceededError extends Error {
+    constructor(maxBytes){
+        super(`Annotation total body bytes exceed ${maxBytes}`), this.maxBytes = maxBytes;
+        this.name = 'AnnotationTotalBytesLimitExceededError';
+    }
+}
+
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/errors.ts"],"sourcesContent":["export class AnnotationBodyTooLargeError extends Error {\n  constructor(public readonly maxBytes: number) {\n    super(`Annotation body exceeds ${maxBytes} bytes`);\n    this.name = 'AnnotationBodyTooLargeError';\n  }\n}\n\nexport class AnnotationCountLimitExceededError extends Error {\n  constructor(public readonly maxAnnotations: number) {\n    super(`Annotation count exceeds ${maxAnnotations}`);\n    this.name = 'AnnotationCountLimitExceededError';\n  }\n}\n\nexport class AnnotationTotalBytesLimitExceededError extends Error {\n  constructor(public readonly maxBytes: number) {\n    super(`Annotation total body bytes exceed ${maxBytes}`);\n    this.name = 'AnnotationTotalBytesLimitExceededError';\n  }\n}\n"],"names":["AnnotationBodyTooLargeError","Error","maxBytes","name","AnnotationCountLimitExceededError","maxAnnotations","AnnotationTotalBytesLimitExceededError"],"mappings":"AAAA,OAAO,MAAMA,oCAAoCC;IAC/C,YAAY,AAAgBC,QAAgB,CAAE;QAC5C,KAAK,CAAC,CAAC,wBAAwB,EAAEA,SAAS,MAAM,CAAC,QADvBA,WAAAA;QAE1B,IAAI,CAACC,IAAI,GAAG;IACd;AACF;AAEA,OAAO,MAAMC,0CAA0CH;IACrD,YAAY,AAAgBI,cAAsB,CAAE;QAClD,KAAK,CAAC,CAAC,yBAAyB,EAAEA,gBAAgB,QADxBA,iBAAAA;QAE1B,IAAI,CAACF,IAAI,GAAG;IACd;AACF;AAEA,OAAO,MAAMG,+CAA+CL;IAC1D,YAAY,AAAgBC,QAAgB,CAAE;QAC5C,KAAK,CAAC,CAAC,mCAAmC,EAAEA,UAAU,QAD5BA,WAAAA;QAE1B,IAAI,CAACC,IAAI,GAAG;IACd;AACF"}

package/dist/core/write-annotations.d.ts

@@ -0,0 +1,25 @@
+import type { LeasedWriteAnnotationOperationDto } from '@shipfox/annotations-dto';
+export interface WriteAnnotationsParams {
+    workspaceId: string;
+    projectId: string;
+    workflowRunId: string;
+    workflowRunAttempt: number;
+    workflowRunAttemptId: string;
+    jobId: string;
+    jobExecutionId: string;
+    originStepId: string;
+    originStepAttempt: number;
+    operations: readonly LeasedWriteAnnotationOperationDto[];
+}
+export interface WriteAnnotationsResult {
+    annotations: Array<{
+        context: string;
+        id: string | null;
+    }>;
+    accounting: {
+        annotationCount: number;
+        totalBodyBytes: number;
+    };
+}
+export declare function writeAnnotations(params: WriteAnnotationsParams): Promise<WriteAnnotationsResult>;
+//# sourceMappingURL=write-annotations.d.ts.map

package/dist/core/write-annotations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-annotations.d.ts","sourceRoot":"","sources":["../../src/core/write-annotations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,iCAAiC,EAAC,MAAM,0BAA0B,CAAC;AAShF,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,SAAS,iCAAiC,EAAE,CAAC;CAC1D;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,KAAK,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;KAAC,CAAC,CAAC;IACzD,UAAU,EAAE;QACV,eAAe,EAAE,MAAM,CAAC;QACxB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAqFhG"}

package/dist/core/write-annotations.js

@@ -0,0 +1,105 @@
+import { config } from '#config.js';
+import { withAnnotationLock } from '#db/annotations.js';
+import { AnnotationBodyTooLargeError, AnnotationCountLimitExceededError, AnnotationTotalBytesLimitExceededError } from './errors.js';
+export function writeAnnotations(params) {
+    return withAnnotationLock(params.jobExecutionId, async (repo)=>{
+        const current = await repo.loadCurrentAnnotations(params.jobExecutionId);
+        let nextSequence = Math.max(0, ...Array.from(current.values()).map((annotation)=>annotation.sequence)) + 1;
+        const results = [];
+        for (const operation of params.operations){
+            if (operation.op === 'remove') {
+                await repo.removeAnnotation(params.jobExecutionId, operation.context);
+                current.delete(operation.context);
+                results.push({
+                    context: operation.context,
+                    id: null
+                });
+                continue;
+            }
+            const existing = current.get(operation.context);
+            const body = operation.op === 'append' ? `${existing?.body ?? ''}${operation.body}` : operation.body;
+            const bodyBytes = Buffer.byteLength(body);
+            ensureBodyBudget(bodyBytes);
+            const isUnchangedReplace = operation.op === 'replace' && existing !== undefined && existing.body === body && existing.style === operation.style;
+            if (isUnchangedReplace) {
+                results.push({
+                    context: operation.context,
+                    id: existing.id
+                });
+                continue;
+            }
+            const draft = new Map(current);
+            draft.set(operation.context, {
+                id: existing?.id ?? '',
+                context: operation.context,
+                style: operation.style,
+                body,
+                bodyBytes,
+                sequence: existing?.sequence ?? nextSequence
+            });
+            ensureExecutionBudgets(draft);
+            const row = existing ? await repo.updateAnnotation({
+                id: existing.id,
+                originStepId: params.originStepId,
+                originStepAttempt: params.originStepAttempt,
+                style: operation.style,
+                body,
+                bodyBytes
+            }) : await repo.createAnnotation({
+                workspaceId: params.workspaceId,
+                projectId: params.projectId,
+                workflowRunId: params.workflowRunId,
+                workflowRunAttempt: params.workflowRunAttempt,
+                workflowRunAttemptId: params.workflowRunAttemptId,
+                jobId: params.jobId,
+                jobExecutionId: params.jobExecutionId,
+                originStepId: params.originStepId,
+                originStepAttempt: params.originStepAttempt,
+                context: operation.context,
+                style: operation.style,
+                body,
+                bodyBytes,
+                sequence: nextSequence
+            });
+            current.set(operation.context, {
+                id: row.id,
+                context: row.context,
+                style: row.style,
+                body: row.body,
+                bodyBytes: row.bodyBytes,
+                sequence: row.sequence
+            });
+            if (!existing) nextSequence += 1;
+            results.push({
+                context: operation.context,
+                id: row.id
+            });
+        }
+        return {
+            annotations: results,
+            accounting: currentAccounting(current)
+        };
+    });
+}
+function ensureBodyBudget(bodyBytes) {
+    if (bodyBytes > config.ANNOTATIONS_MAX_BODY_BYTES) {
+        throw new AnnotationBodyTooLargeError(config.ANNOTATIONS_MAX_BODY_BYTES);
+    }
+}
+function ensureExecutionBudgets(annotationsByContext) {
+    const accounting = currentAccounting(annotationsByContext);
+    if (accounting.annotationCount > config.ANNOTATIONS_MAX_PER_EXECUTION) {
+        throw new AnnotationCountLimitExceededError(config.ANNOTATIONS_MAX_PER_EXECUTION);
+    }
+    if (accounting.totalBodyBytes > config.ANNOTATIONS_MAX_TOTAL_BYTES) {
+        throw new AnnotationTotalBytesLimitExceededError(config.ANNOTATIONS_MAX_TOTAL_BYTES);
+    }
+}
+function currentAccounting(annotationsByContext) {
+    return {
+        annotationCount: annotationsByContext.size,
+        totalBodyBytes: Array.from(annotationsByContext.values()).reduce((total, annotation)=>total + annotation.bodyBytes, 0)
+    };
+}
+
+//# sourceMappingURL=write-annotations.js.map

package/dist/core/write-annotations.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/write-annotations.ts"],"sourcesContent":["import type {LeasedWriteAnnotationOperationDto} from '@shipfox/annotations-dto';\nimport {config} from '#config.js';\nimport {type StoredAnnotation, withAnnotationLock} from '#db/annotations.js';\nimport {\n  AnnotationBodyTooLargeError,\n  AnnotationCountLimitExceededError,\n  AnnotationTotalBytesLimitExceededError,\n} from './errors.js';\n\nexport interface WriteAnnotationsParams {\n  workspaceId: string;\n  projectId: string;\n  workflowRunId: string;\n  workflowRunAttempt: number;\n  workflowRunAttemptId: string;\n  jobId: string;\n  jobExecutionId: string;\n  originStepId: string;\n  originStepAttempt: number;\n  operations: readonly LeasedWriteAnnotationOperationDto[];\n}\n\nexport interface WriteAnnotationsResult {\n  annotations: Array<{context: string; id: string | null}>;\n  accounting: {\n    annotationCount: number;\n    totalBodyBytes: number;\n  };\n}\n\nexport function writeAnnotations(params: WriteAnnotationsParams): Promise<WriteAnnotationsResult> {\n  return withAnnotationLock(params.jobExecutionId, async (repo) => {\n    const current = await repo.loadCurrentAnnotations(params.jobExecutionId);\n    let nextSequence =\n      Math.max(0, ...Array.from(current.values()).map((annotation) => annotation.sequence)) + 1;\n    const results: WriteAnnotationsResult['annotations'] = [];\n\n    for (const operation of params.operations) {\n      if (operation.op === 'remove') {\n        await repo.removeAnnotation(params.jobExecutionId, operation.context);\n        current.delete(operation.context);\n        results.push({context: operation.context, id: null});\n        continue;\n      }\n\n      const existing = current.get(operation.context);\n      const body =\n        operation.op === 'append' ? `${existing?.body ?? ''}${operation.body}` : operation.body;\n      const bodyBytes = Buffer.byteLength(body);\n      ensureBodyBudget(bodyBytes);\n\n      const isUnchangedReplace =\n        operation.op === 'replace' &&\n        existing !== undefined &&\n        existing.body === body &&\n        existing.style === operation.style;\n      if (isUnchangedReplace) {\n        results.push({context: operation.context, id: existing.id});\n        continue;\n      }\n\n      const draft = new Map(current);\n      draft.set(operation.context, {\n        id: existing?.id ?? '',\n        context: operation.context,\n        style: operation.style,\n        body,\n        bodyBytes,\n        sequence: existing?.sequence ?? nextSequence,\n      });\n      ensureExecutionBudgets(draft);\n\n      const row = existing\n        ? await repo.updateAnnotation({\n            id: existing.id,\n            originStepId: params.originStepId,\n            originStepAttempt: params.originStepAttempt,\n            style: operation.style,\n            body,\n            bodyBytes,\n          })\n        : await repo.createAnnotation({\n            workspaceId: params.workspaceId,\n            projectId: params.projectId,\n            workflowRunId: params.workflowRunId,\n            workflowRunAttempt: params.workflowRunAttempt,\n            workflowRunAttemptId: params.workflowRunAttemptId,\n            jobId: params.jobId,\n            jobExecutionId: params.jobExecutionId,\n            originStepId: params.originStepId,\n            originStepAttempt: params.originStepAttempt,\n            context: operation.context,\n            style: operation.style,\n            body,\n            bodyBytes,\n            sequence: nextSequence,\n          });\n\n      current.set(operation.context, {\n        id: row.id,\n        context: row.context,\n        style: row.style,\n        body: row.body,\n        bodyBytes: row.bodyBytes,\n        sequence: row.sequence,\n      });\n      if (!existing) nextSequence += 1;\n      results.push({context: operation.context, id: row.id});\n    }\n\n    return {\n      annotations: results,\n      accounting: currentAccounting(current),\n    };\n  });\n}\n\nfunction ensureBodyBudget(bodyBytes: number): void {\n  if (bodyBytes > config.ANNOTATIONS_MAX_BODY_BYTES) {\n    throw new AnnotationBodyTooLargeError(config.ANNOTATIONS_MAX_BODY_BYTES);\n  }\n}\n\nfunction ensureExecutionBudgets(annotationsByContext: ReadonlyMap<string, StoredAnnotation>): void {\n  const accounting = currentAccounting(annotationsByContext);\n  if (accounting.annotationCount > config.ANNOTATIONS_MAX_PER_EXECUTION) {\n    throw new AnnotationCountLimitExceededError(config.ANNOTATIONS_MAX_PER_EXECUTION);\n  }\n  if (accounting.totalBodyBytes > config.ANNOTATIONS_MAX_TOTAL_BYTES) {\n    throw new AnnotationTotalBytesLimitExceededError(config.ANNOTATIONS_MAX_TOTAL_BYTES);\n  }\n}\n\nfunction currentAccounting(annotationsByContext: ReadonlyMap<string, StoredAnnotation>) {\n  return {\n    annotationCount: annotationsByContext.size,\n    totalBodyBytes: Array.from(annotationsByContext.values()).reduce(\n      (total, annotation) => total + annotation.bodyBytes,\n      0,\n    ),\n  };\n}\n"],"names":["config","withAnnotationLock","AnnotationBodyTooLargeError","AnnotationCountLimitExceededError","AnnotationTotalBytesLimitExceededError","writeAnnotations","params","jobExecutionId","repo","current","loadCurrentAnnotations","nextSequence","Math","max","Array","from","values","map","annotation","sequence","results","operation","operations","op","removeAnnotation","context","delete","push","id","existing","get","body","bodyBytes","Buffer","byteLength","ensureBodyBudget","isUnchangedReplace","undefined","style","draft","Map","set","ensureExecutionBudgets","row","updateAnnotation","originStepId","originStepAttempt","createAnnotation","workspaceId","projectId","workflowRunId","workflowRunAttempt","workflowRunAttemptId","jobId","annotations","accounting","currentAccounting","ANNOTATIONS_MAX_BODY_BYTES","annotationsByContext","annotationCount","ANNOTATIONS_MAX_PER_EXECUTION","totalBodyBytes","ANNOTATIONS_MAX_TOTAL_BYTES","size","reduce","total"],"mappings":"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"}

package/dist/db/annotations.d.ts

@@ -0,0 +1,63 @@
+import { type AnnotationStyleDto } from '@shipfox/annotations-dto';
+import type { Annotation } from '#core/entities/annotation.js';
+export declare const DEFAULT_ANNOTATIONS_READ_LIMIT = 500;
+export interface ListAnnotationsForRunAttemptParams {
+    workflowRunId: string;
+    workflowRunAttempt: number;
+    workspaceIds: readonly string[];
+    jobExecutionId?: string | undefined;
+    after?: {
+        sequence: number;
+        id: string;
+    } | undefined;
+    limit?: number | undefined;
+}
+export interface ListAnnotationsForRunAttemptResult {
+    annotations: Annotation[];
+    hasMore: boolean;
+    nextCursor: {
+        sequence: number;
+        id: string;
+    } | null;
+}
+export declare function listAnnotationsForRunAttempt(params: ListAnnotationsForRunAttemptParams): Promise<ListAnnotationsForRunAttemptResult>;
+export interface StoredAnnotation {
+    id: string;
+    context: string;
+    style: AnnotationStyleDto;
+    body: string;
+    bodyBytes: number;
+    sequence: number;
+}
+export interface CreateAnnotationParams {
+    workspaceId: string;
+    projectId: string;
+    workflowRunId: string;
+    workflowRunAttempt: number;
+    workflowRunAttemptId: string;
+    jobId: string;
+    jobExecutionId: string;
+    originStepId: string;
+    originStepAttempt: number;
+    context: string;
+    style: AnnotationStyleDto;
+    body: string;
+    bodyBytes: number;
+    sequence: number;
+}
+export interface UpdateAnnotationParams {
+    id: string;
+    originStepId: string;
+    originStepAttempt: number;
+    style: AnnotationStyleDto;
+    body: string;
+    bodyBytes: number;
+}
+export interface AnnotationWriteRepository {
+    loadCurrentAnnotations(jobExecutionId: string): Promise<Map<string, StoredAnnotation>>;
+    removeAnnotation(jobExecutionId: string, context: string): Promise<void>;
+    createAnnotation(params: CreateAnnotationParams): Promise<StoredAnnotation>;
+    updateAnnotation(params: UpdateAnnotationParams): Promise<StoredAnnotation>;
+}
+export declare function withAnnotationLock<T>(jobExecutionId: string, work: (repo: AnnotationWriteRepository) => Promise<T>): Promise<T>;
+//# sourceMappingURL=annotations.d.ts.map

package/dist/db/annotations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotations.d.ts","sourceRoot":"","sources":["../../src/db/annotations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,kBAAkB,EAA6B,MAAM,0BAA0B,CAAC;AAE7F,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,8BAA8B,CAAC;AAI7D,eAAO,MAAM,8BAA8B,MAA6B,CAAC;AAEzE,MAAM,WAAW,kCAAkC;IACjD,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,KAAK,CAAC,EAAE;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAC,GAAG,SAAS,CAAC;IACnD,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED,MAAM,WAAW,kCAAkC;IACjD,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAC,GAAG,IAAI,CAAC;CACnD;AAED,wBAAsB,4BAA4B,CAChD,MAAM,EAAE,kCAAkC,GACzC,OAAO,CAAC,kCAAkC,CAAC,CAoC7C;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,kBAAkB,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB;IACxC,sBAAsB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC;IACvF,gBAAgB,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzE,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC5E,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC7E;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,CAAC,IAAI,EAAE,yBAAyB,KAAK,OAAO,CAAC,CAAC,CAAC,GACpD,OAAO,CAAC,CAAC,CAAC,CAuEZ"}

package/dist/db/annotations.js

@@ -0,0 +1,96 @@
+import { READ_ANNOTATIONS_MAX_LIMIT } from '@shipfox/annotations-dto';
+import { and, asc, eq, gt, inArray, or, sql } from 'drizzle-orm';
+import { db } from './db.js';
+import { annotations, toAnnotation } from './schema/annotations.js';
+export const DEFAULT_ANNOTATIONS_READ_LIMIT = READ_ANNOTATIONS_MAX_LIMIT;
+export async function listAnnotationsForRunAttempt(params) {
+    if (params.workspaceIds.length === 0) return {
+        annotations: [],
+        hasMore: false,
+        nextCursor: null
+    };
+    const limit = params.limit ?? DEFAULT_ANNOTATIONS_READ_LIMIT;
+    const conditions = [
+        eq(annotations.workflowRunId, params.workflowRunId),
+        eq(annotations.workflowRunAttempt, params.workflowRunAttempt),
+        inArray(annotations.workspaceId, [
+            ...params.workspaceIds
+        ])
+    ];
+    if (params.jobExecutionId) {
+        conditions.push(eq(annotations.jobExecutionId, params.jobExecutionId));
+    }
+    if (params.after) {
+        const cursorCondition = or(gt(annotations.sequence, params.after.sequence), and(eq(annotations.sequence, params.after.sequence), gt(annotations.id, params.after.id)));
+        if (cursorCondition) conditions.push(cursorCondition);
+    }
+    const rows = await db().select().from(annotations).where(and(...conditions)).orderBy(asc(annotations.sequence), asc(annotations.id)).limit(limit + 1);
+    const pageRows = rows.slice(0, limit);
+    const last = pageRows.at(-1);
+    return {
+        annotations: pageRows.map(toAnnotation),
+        hasMore: rows.length > limit,
+        nextCursor: rows.length > limit && last ? {
+            sequence: last.sequence,
+            id: last.id
+        } : null
+    };
+}
+export function withAnnotationLock(jobExecutionId, work) {
+    return db().transaction(async (tx)=>{
+        await tx.execute(sql`select pg_advisory_xact_lock(hashtext(${jobExecutionId}))`);
+        const repo = {
+            loadCurrentAnnotations: async (lockedJobExecutionId)=>{
+                const rows = await tx.select({
+                    id: annotations.id,
+                    context: annotations.context,
+                    style: annotations.style,
+                    body: annotations.body,
+                    bodyBytes: annotations.bodyBytes,
+                    sequence: annotations.sequence
+                }).from(annotations).where(eq(annotations.jobExecutionId, lockedJobExecutionId));
+                return new Map(rows.map((row)=>[
+                        row.context,
+                        row
+                    ]));
+            },
+            removeAnnotation: async (lockedJobExecutionId, context)=>{
+                await tx.delete(annotations).where(and(eq(annotations.jobExecutionId, lockedJobExecutionId), eq(annotations.context, context)));
+            },
+            createAnnotation: async (params)=>{
+                const [row] = await tx.insert(annotations).values(params).returning({
+                    id: annotations.id,
+                    context: annotations.context,
+                    style: annotations.style,
+                    body: annotations.body,
+                    bodyBytes: annotations.bodyBytes,
+                    sequence: annotations.sequence
+                });
+                if (!row) throw new Error('createAnnotation: insert returned no row');
+                return row;
+            },
+            updateAnnotation: async (params)=>{
+                const [row] = await tx.update(annotations).set({
+                    originStepId: params.originStepId,
+                    originStepAttempt: params.originStepAttempt,
+                    style: params.style,
+                    body: params.body,
+                    bodyBytes: params.bodyBytes,
+                    updatedAt: new Date()
+                }).where(eq(annotations.id, params.id)).returning({
+                    id: annotations.id,
+                    context: annotations.context,
+                    style: annotations.style,
+                    body: annotations.body,
+                    bodyBytes: annotations.bodyBytes,
+                    sequence: annotations.sequence
+                });
+                if (!row) throw new Error('updateAnnotation: update returned no row');
+                return row;
+            }
+        };
+        return await work(repo);
+    });
+}
+
+//# sourceMappingURL=annotations.js.map

package/dist/db/annotations.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/db/annotations.ts"],"sourcesContent":["import {type AnnotationStyleDto, READ_ANNOTATIONS_MAX_LIMIT} from '@shipfox/annotations-dto';\nimport {and, asc, eq, gt, inArray, or, type SQL, sql} from 'drizzle-orm';\nimport type {Annotation} from '#core/entities/annotation.js';\nimport {db} from './db.js';\nimport {annotations, toAnnotation} from './schema/annotations.js';\n\nexport const DEFAULT_ANNOTATIONS_READ_LIMIT = READ_ANNOTATIONS_MAX_LIMIT;\n\nexport interface ListAnnotationsForRunAttemptParams {\n  workflowRunId: string;\n  workflowRunAttempt: number;\n  workspaceIds: readonly string[];\n  jobExecutionId?: string | undefined;\n  after?: {sequence: number; id: string} | undefined;\n  limit?: number | undefined;\n}\n\nexport interface ListAnnotationsForRunAttemptResult {\n  annotations: Annotation[];\n  hasMore: boolean;\n  nextCursor: {sequence: number; id: string} | null;\n}\n\nexport async function listAnnotationsForRunAttempt(\n  params: ListAnnotationsForRunAttemptParams,\n): Promise<ListAnnotationsForRunAttemptResult> {\n  if (params.workspaceIds.length === 0) return {annotations: [], hasMore: false, nextCursor: null};\n\n  const limit = params.limit ?? DEFAULT_ANNOTATIONS_READ_LIMIT;\n\n  const conditions: SQL[] = [\n    eq(annotations.workflowRunId, params.workflowRunId),\n    eq(annotations.workflowRunAttempt, params.workflowRunAttempt),\n    inArray(annotations.workspaceId, [...params.workspaceIds]),\n  ];\n  if (params.jobExecutionId) {\n    conditions.push(eq(annotations.jobExecutionId, params.jobExecutionId));\n  }\n  if (params.after) {\n    const cursorCondition = or(\n      gt(annotations.sequence, params.after.sequence),\n      and(eq(annotations.sequence, params.after.sequence), gt(annotations.id, params.after.id)),\n    );\n    if (cursorCondition) conditions.push(cursorCondition);\n  }\n\n  const rows = await db()\n    .select()\n    .from(annotations)\n    .where(and(...conditions))\n    .orderBy(asc(annotations.sequence), asc(annotations.id))\n    .limit(limit + 1);\n\n  const pageRows = rows.slice(0, limit);\n  const last = pageRows.at(-1);\n\n  return {\n    annotations: pageRows.map(toAnnotation),\n    hasMore: rows.length > limit,\n    nextCursor: rows.length > limit && last ? {sequence: last.sequence, id: last.id} : null,\n  };\n}\n\nexport interface StoredAnnotation {\n  id: string;\n  context: string;\n  style: AnnotationStyleDto;\n  body: string;\n  bodyBytes: number;\n  sequence: number;\n}\n\nexport interface CreateAnnotationParams {\n  workspaceId: string;\n  projectId: string;\n  workflowRunId: string;\n  workflowRunAttempt: number;\n  workflowRunAttemptId: string;\n  jobId: string;\n  jobExecutionId: string;\n  originStepId: string;\n  originStepAttempt: number;\n  context: string;\n  style: AnnotationStyleDto;\n  body: string;\n  bodyBytes: number;\n  sequence: number;\n}\n\nexport interface UpdateAnnotationParams {\n  id: string;\n  originStepId: string;\n  originStepAttempt: number;\n  style: AnnotationStyleDto;\n  body: string;\n  bodyBytes: number;\n}\n\nexport interface AnnotationWriteRepository {\n  loadCurrentAnnotations(jobExecutionId: string): Promise<Map<string, StoredAnnotation>>;\n  removeAnnotation(jobExecutionId: string, context: string): Promise<void>;\n  createAnnotation(params: CreateAnnotationParams): Promise<StoredAnnotation>;\n  updateAnnotation(params: UpdateAnnotationParams): Promise<StoredAnnotation>;\n}\n\nexport function withAnnotationLock<T>(\n  jobExecutionId: string,\n  work: (repo: AnnotationWriteRepository) => Promise<T>,\n): Promise<T> {\n  return db().transaction(async (tx) => {\n    await tx.execute(sql`select pg_advisory_xact_lock(hashtext(${jobExecutionId}))`);\n\n    const repo: AnnotationWriteRepository = {\n      loadCurrentAnnotations: async (lockedJobExecutionId) => {\n        const rows = await tx\n          .select({\n            id: annotations.id,\n            context: annotations.context,\n            style: annotations.style,\n            body: annotations.body,\n            bodyBytes: annotations.bodyBytes,\n            sequence: annotations.sequence,\n          })\n          .from(annotations)\n          .where(eq(annotations.jobExecutionId, lockedJobExecutionId));\n\n        return new Map(rows.map((row) => [row.context, row]));\n      },\n      removeAnnotation: async (lockedJobExecutionId, context) => {\n        await tx\n          .delete(annotations)\n          .where(\n            and(\n              eq(annotations.jobExecutionId, lockedJobExecutionId),\n              eq(annotations.context, context),\n            ),\n          );\n      },\n      createAnnotation: async (params) => {\n        const [row] = await tx.insert(annotations).values(params).returning({\n          id: annotations.id,\n          context: annotations.context,\n          style: annotations.style,\n          body: annotations.body,\n          bodyBytes: annotations.bodyBytes,\n          sequence: annotations.sequence,\n        });\n\n        if (!row) throw new Error('createAnnotation: insert returned no row');\n        return row;\n      },\n      updateAnnotation: async (params) => {\n        const [row] = await tx\n          .update(annotations)\n          .set({\n            originStepId: params.originStepId,\n            originStepAttempt: params.originStepAttempt,\n            style: params.style,\n            body: params.body,\n            bodyBytes: params.bodyBytes,\n            updatedAt: new Date(),\n          })\n          .where(eq(annotations.id, params.id))\n          .returning({\n            id: annotations.id,\n            context: annotations.context,\n            style: annotations.style,\n            body: annotations.body,\n            bodyBytes: annotations.bodyBytes,\n            sequence: annotations.sequence,\n          });\n\n        if (!row) throw new Error('updateAnnotation: update returned no row');\n        return row;\n      },\n    };\n\n    return await work(repo);\n  });\n}\n"],"names":["READ_ANNOTATIONS_MAX_LIMIT","and","asc","eq","gt","inArray","or","sql","db","annotations","toAnnotation","DEFAULT_ANNOTATIONS_READ_LIMIT","listAnnotationsForRunAttempt","params","workspaceIds","length","hasMore","nextCursor","limit","conditions","workflowRunId","workflowRunAttempt","workspaceId","jobExecutionId","push","after","cursorCondition","sequence","id","rows","select","from","where","orderBy","pageRows","slice","last","at","map","withAnnotationLock","work","transaction","tx","execute","repo","loadCurrentAnnotations","lockedJobExecutionId","context","style","body","bodyBytes","Map","row","removeAnnotation","delete","createAnnotation","insert","values","returning","Error","updateAnnotation","update","set","originStepId","originStepAttempt","updatedAt","Date"],"mappings":"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"}