@shipfox/api-agent-access 21.0.0 → 21.2.0

package/dist/core/response.js

@@ -42,34 +42,73 @@ export function serializedAgentAccessEnvelopeByteLength(envelope) {
     if (!params.envelope.ok || !isRecord(params.envelope.result)) {
         return agentAccessError('content-too-large');
     }
-    const itemCounts = params.items.length === 0 ? [
-        0
-    ] : Array.from({
-        length: Math.max(0, params.items.length - 1)
-    }, (_, index)=>params.items.length - index - 1);
-    for (const itemCount of itemCounts){
-        const retained = params.items.slice(0, itemCount);
-        const last = retained.at(-1);
-        const nextCursor = last === undefined ? null : params.cursorForItem(last, itemCount - 1);
-        const candidate = {
-            ...params.envelope,
+    const producerResult = params.envelope.result;
+    const fitState = buildPagedResponseFitState(params, producerResult, initialBytes);
+    const itemCount = largestFittingItemCount(fitState.candidateBytes, params.items.length, maxBytes);
+    if (itemCount !== undefined) {
+        const nextCursor = itemCount === 0 ? null : fitState.itemCursors[itemCount - 1];
+        if (nextCursor === undefined && itemCount > 0) return agentAccessError('content-too-large');
+        return {
+            ...fitState.emptyCandidate,
             result: {
-                ...params.envelope.result,
-                [params.itemKey]: retained,
-                next_cursor: nextCursor
-            },
-            response_truncated: true,
-            response_total_bytes: initialBytes
+                ...fitState.emptyResult,
+                [params.itemKey]: params.items.slice(0, itemCount),
+                next_cursor: nextCursor ?? null
+            }
         };
-        if (serializedAgentAccessEnvelopeByteLength(candidate) <= maxBytes) return candidate;
     }
     return agentAccessError('content-too-large');
 }
+function buildPagedResponseFitState(params, producerResult, initialBytes) {
+    const emptyResult = {
+        ...producerResult,
+        [params.itemKey]: [],
+        next_cursor: null
+    };
+    const emptyCandidate = {
+        ...params.envelope,
+        result: emptyResult,
+        response_truncated: true,
+        response_total_bytes: initialBytes
+    };
+    const emptyCandidateBytes = serializedAgentAccessEnvelopeByteLength(emptyCandidate);
+    const nullCursorBytes = serializedJsonByteLength(null);
+    const candidateBytes = [
+        emptyCandidateBytes
+    ];
+    const itemCursors = [];
+    let retainedItemBytes = 0;
+    for (const [index, item] of params.items.entries()){
+        retainedItemBytes += serializedJsonByteLength(item) + (index === 0 ? 0 : 1);
+        const cursor = params.cursorForItem(item, index);
+        itemCursors.push(cursor);
+        candidateBytes.push(emptyCandidateBytes + retainedItemBytes + serializedJsonByteLength(cursor) - nullCursorBytes);
+    }
+    return {
+        emptyCandidate,
+        emptyResult,
+        candidateBytes,
+        itemCursors
+    };
+}
+function largestFittingItemCount(candidateBytes, itemCount, maxBytes) {
+    const minimumItemCount = itemCount === 0 ? 0 : 1;
+    for(let count = itemCount; count >= minimumItemCount; count -= 1){
+        const candidateByteLength = candidateBytes[count];
+        if (candidateByteLength !== undefined && candidateByteLength <= maxBytes) return count;
+    }
+    return undefined;
+}
 export function fitAgentAccessResponseToCeiling(envelope, maxBytes = AGENT_ACCESS_RESPONSE_MAX_BYTES) {
     return serializedAgentAccessEnvelopeByteLength(envelope) <= maxBytes ? envelope : agentAccessError('content-too-large');
 }
 function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
+function serializedJsonByteLength(value) {
+    const serialized = JSON.stringify(value);
+    if (serialized === undefined) throw new Error('Agent-access value is not serializable');
+    return utf8Encoder.encode(serialized).byteLength;
+}
 
 //# sourceMappingURL=response.js.map

package/dist/core/response.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/core/response.ts"],"sourcesContent":["import {\n  AGENT_ACCESS_RESPONSE_MAX_BYTES,\n  type AgentAccessEnvelopeDto,\n} from '@shipfox/api-agent-access-dto';\nimport {agentAccessError} from './envelope.js';\n\nconst utf8Encoder = new TextEncoder();\n\nexport interface AgentAccessUtf8Truncation {\n  value: string;\n  truncated: boolean;\n  totalBytes: number;\n}\n\nexport function truncateAgentAccessUtf8(\n  value: string,\n  maxBytes: number,\n): AgentAccessUtf8Truncation {\n  const totalBytes = utf8Encoder.encode(value).byteLength;\n  if (totalBytes <= maxBytes) return {value, truncated: false, totalBytes};\n  if (maxBytes <= 0) return {value: '', truncated: true, totalBytes};\n\n  let bytes = 0;\n  let result = '';\n  for (const codePoint of value) {\n    const codePointBytes = utf8Encoder.encode(codePoint).byteLength;\n    if (bytes + codePointBytes > maxBytes) break;\n    result += codePoint;\n    bytes += codePointBytes;\n  }\n\n  return {value: result, truncated: true, totalBytes};\n}\n\nexport function serializedAgentAccessEnvelopeByteLength(envelope: AgentAccessEnvelopeDto): number {\n  const serialized = JSON.stringify(envelope);\n  if (serialized === undefined) throw new Error('Agent-access envelope is not serializable');\n  return utf8Encoder.encode(serialized).byteLength;\n}\n\nexport interface ReducePagedAgentAccessResponseParams {\n  envelope: AgentAccessEnvelopeDto;\n  itemKey: string;\n  items: readonly Record<string, unknown>[];\n  cursorForItem: (item: Record<string, unknown>, index: number) => string;\n  maxBytes?: number | undefined;\n}\n\n/**\n * Fits a paged success response without reusing a producer cursor that points past dropped rows.\n * The cursor is always rebuilt from the final retained item.\n */\nexport function reducePagedAgentAccessResponse(\n  params: ReducePagedAgentAccessResponseParams,\n): AgentAccessEnvelopeDto {\n  const maxBytes = params.maxBytes ?? AGENT_ACCESS_RESPONSE_MAX_BYTES;\n  const initialBytes = serializedAgentAccessEnvelopeByteLength(params.envelope);\n  if (initialBytes <= maxBytes) return params.envelope;\n  if (!params.envelope.ok || !isRecord(params.envelope.result)) {\n    return agentAccessError('content-too-large');\n  }\n\n  const itemCounts =\n    params.items.length === 0\n      ? [0]\n      : Array.from(\n          {length: Math.max(0, params.items.length - 1)},\n          (_, index) => params.items.length - index - 1,\n        );\n  for (const itemCount of itemCounts) {\n    const retained = params.items.slice(0, itemCount);\n    const last = retained.at(-1);\n    const nextCursor = last === undefined ? null : params.cursorForItem(last, itemCount - 1);\n    const candidate: AgentAccessEnvelopeDto = {\n      ...params.envelope,\n      result: {\n        ...params.envelope.result,\n        [params.itemKey]: retained,\n        next_cursor: nextCursor,\n      },\n      response_truncated: true,\n      response_total_bytes: initialBytes,\n    };\n    if (serializedAgentAccessEnvelopeByteLength(candidate) <= maxBytes) return candidate;\n  }\n\n  return agentAccessError('content-too-large');\n}\n\nexport function fitAgentAccessResponseToCeiling(\n  envelope: AgentAccessEnvelopeDto,\n  maxBytes = AGENT_ACCESS_RESPONSE_MAX_BYTES,\n): AgentAccessEnvelopeDto {\n  return serializedAgentAccessEnvelopeByteLength(envelope) <= maxBytes\n    ? envelope\n    : agentAccessError('content-too-large');\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n"],"names":["AGENT_ACCESS_RESPONSE_MAX_BYTES","agentAccessError","utf8Encoder","TextEncoder","truncateAgentAccessUtf8","value","maxBytes","totalBytes","encode","byteLength","truncated","bytes","result","codePoint","codePointBytes","serializedAgentAccessEnvelopeByteLength","envelope","serialized","JSON","stringify","undefined","Error","reducePagedAgentAccessResponse","params","initialBytes","ok","isRecord","itemCounts","items","length","Array","from","Math","max","_","index","itemCount","retained","slice","last","at","nextCursor","cursorForItem","candidate","itemKey","next_cursor","response_truncated","response_total_bytes","fitAgentAccessResponseToCeiling","isArray"],"mappings":"AAAA,SACEA,+BAA+B,QAE1B,gCAAgC;AACvC,SAAQC,gBAAgB,QAAO,gBAAgB;AAE/C,MAAMC,cAAc,IAAIC;AAQxB,OAAO,SAASC,wBACdC,KAAa,EACbC,QAAgB;IAEhB,MAAMC,aAAaL,YAAYM,MAAM,CAACH,OAAOI,UAAU;IACvD,IAAIF,cAAcD,UAAU,OAAO;QAACD;QAAOK,WAAW;QAAOH;IAAU;IACvE,IAAID,YAAY,GAAG,OAAO;QAACD,OAAO;QAAIK,WAAW;QAAMH;IAAU;IAEjE,IAAII,QAAQ;IACZ,IAAIC,SAAS;IACb,KAAK,MAAMC,aAAaR,MAAO;QAC7B,MAAMS,iBAAiBZ,YAAYM,MAAM,CAACK,WAAWJ,UAAU;QAC/D,IAAIE,QAAQG,iBAAiBR,UAAU;QACvCM,UAAUC;QACVF,SAASG;IACX;IAEA,OAAO;QAACT,OAAOO;QAAQF,WAAW;QAAMH;IAAU;AACpD;AAEA,OAAO,SAASQ,wCAAwCC,QAAgC;IACtF,MAAMC,aAAaC,KAAKC,SAAS,CAACH;IAClC,IAAIC,eAAeG,WAAW,MAAM,IAAIC,MAAM;IAC9C,OAAOnB,YAAYM,MAAM,CAACS,YAAYR,UAAU;AAClD;AAUA;;;CAGC,GACD,OAAO,SAASa,+BACdC,MAA4C;IAE5C,MAAMjB,WAAWiB,OAAOjB,QAAQ,IAAIN;IACpC,MAAMwB,eAAeT,wCAAwCQ,OAAOP,QAAQ;IAC5E,IAAIQ,gBAAgBlB,UAAU,OAAOiB,OAAOP,QAAQ;IACpD,IAAI,CAACO,OAAOP,QAAQ,CAACS,EAAE,IAAI,CAACC,SAASH,OAAOP,QAAQ,CAACJ,MAAM,GAAG;QAC5D,OAAOX,iBAAiB;IAC1B;IAEA,MAAM0B,aACJJ,OAAOK,KAAK,CAACC,MAAM,KAAK,IACpB;QAAC;KAAE,GACHC,MAAMC,IAAI,CACR;QAACF,QAAQG,KAAKC,GAAG,CAAC,GAAGV,OAAOK,KAAK,CAACC,MAAM,GAAG;IAAE,GAC7C,CAACK,GAAGC,QAAUZ,OAAOK,KAAK,CAACC,MAAM,GAAGM,QAAQ;IAEpD,KAAK,MAAMC,aAAaT,WAAY;QAClC,MAAMU,WAAWd,OAAOK,KAAK,CAACU,KAAK,CAAC,GAAGF;QACvC,MAAMG,OAAOF,SAASG,EAAE,CAAC,CAAC;QAC1B,MAAMC,aAAaF,SAASnB,YAAY,OAAOG,OAAOmB,aAAa,CAACH,MAAMH,YAAY;QACtF,MAAMO,YAAoC;YACxC,GAAGpB,OAAOP,QAAQ;YAClBJ,QAAQ;gBACN,GAAGW,OAAOP,QAAQ,CAACJ,MAAM;gBACzB,CAACW,OAAOqB,OAAO,CAAC,EAAEP;gBAClBQ,aAAaJ;YACf;YACAK,oBAAoB;YACpBC,sBAAsBvB;QACxB;QACA,IAAIT,wCAAwC4B,cAAcrC,UAAU,OAAOqC;IAC7E;IAEA,OAAO1C,iBAAiB;AAC1B;AAEA,OAAO,SAAS+C,gCACdhC,QAAgC,EAChCV,WAAWN,+BAA+B;IAE1C,OAAOe,wCAAwCC,aAAaV,WACxDU,WACAf,iBAAiB;AACvB;AAEA,SAASyB,SAASrB,KAAc;IAC9B,OAAO,OAAOA,UAAU,YAAYA,UAAU,QAAQ,CAACyB,MAAMmB,OAAO,CAAC5C;AACvE"}
+{"version":3,"sources":["../../src/core/response.ts"],"sourcesContent":["import {\n  AGENT_ACCESS_RESPONSE_MAX_BYTES,\n  type AgentAccessEnvelopeDto,\n} from '@shipfox/api-agent-access-dto';\nimport {agentAccessError} from './envelope.js';\n\nconst utf8Encoder = new TextEncoder();\n\nexport interface AgentAccessUtf8Truncation {\n  value: string;\n  truncated: boolean;\n  totalBytes: number;\n}\n\nexport function truncateAgentAccessUtf8(\n  value: string,\n  maxBytes: number,\n): AgentAccessUtf8Truncation {\n  const totalBytes = utf8Encoder.encode(value).byteLength;\n  if (totalBytes <= maxBytes) return {value, truncated: false, totalBytes};\n  if (maxBytes <= 0) return {value: '', truncated: true, totalBytes};\n\n  let bytes = 0;\n  let result = '';\n  for (const codePoint of value) {\n    const codePointBytes = utf8Encoder.encode(codePoint).byteLength;\n    if (bytes + codePointBytes > maxBytes) break;\n    result += codePoint;\n    bytes += codePointBytes;\n  }\n\n  return {value: result, truncated: true, totalBytes};\n}\n\nexport function serializedAgentAccessEnvelopeByteLength(envelope: AgentAccessEnvelopeDto): number {\n  const serialized = JSON.stringify(envelope);\n  if (serialized === undefined) throw new Error('Agent-access envelope is not serializable');\n  return utf8Encoder.encode(serialized).byteLength;\n}\n\nexport interface ReducePagedAgentAccessResponseParams {\n  envelope: AgentAccessEnvelopeDto;\n  itemKey: string;\n  items: readonly Record<string, unknown>[];\n  cursorForItem: (item: Record<string, unknown>, index: number) => string;\n  maxBytes?: number | undefined;\n}\n\ninterface PagedResponseFitState {\n  emptyCandidate: AgentAccessEnvelopeDto;\n  emptyResult: Record<string, unknown>;\n  candidateBytes: readonly number[];\n  itemCursors: readonly string[];\n}\n\n/**\n * Fits a paged success response without reusing a producer cursor that points past dropped rows.\n * The cursor is always rebuilt from the final retained item.\n */\nexport function reducePagedAgentAccessResponse(\n  params: ReducePagedAgentAccessResponseParams,\n): AgentAccessEnvelopeDto {\n  const maxBytes = params.maxBytes ?? AGENT_ACCESS_RESPONSE_MAX_BYTES;\n  const initialBytes = serializedAgentAccessEnvelopeByteLength(params.envelope);\n  if (initialBytes <= maxBytes) return params.envelope;\n  if (!params.envelope.ok || !isRecord(params.envelope.result)) {\n    return agentAccessError('content-too-large');\n  }\n\n  const producerResult = params.envelope.result;\n  const fitState = buildPagedResponseFitState(params, producerResult, initialBytes);\n  const itemCount = largestFittingItemCount(fitState.candidateBytes, params.items.length, maxBytes);\n  if (itemCount !== undefined) {\n    const nextCursor = itemCount === 0 ? null : fitState.itemCursors[itemCount - 1];\n    if (nextCursor === undefined && itemCount > 0) return agentAccessError('content-too-large');\n    return {\n      ...fitState.emptyCandidate,\n      result: {\n        ...fitState.emptyResult,\n        [params.itemKey]: params.items.slice(0, itemCount),\n        next_cursor: nextCursor ?? null,\n      },\n    };\n  }\n\n  return agentAccessError('content-too-large');\n}\n\nfunction buildPagedResponseFitState(\n  params: ReducePagedAgentAccessResponseParams,\n  producerResult: Record<string, unknown>,\n  initialBytes: number,\n): PagedResponseFitState {\n  const emptyResult = {...producerResult, [params.itemKey]: [], next_cursor: null};\n  const emptyCandidate: AgentAccessEnvelopeDto = {\n    ...params.envelope,\n    result: emptyResult,\n    response_truncated: true,\n    response_total_bytes: initialBytes,\n  };\n  const emptyCandidateBytes = serializedAgentAccessEnvelopeByteLength(emptyCandidate);\n  const nullCursorBytes = serializedJsonByteLength(null);\n  const candidateBytes: number[] = [emptyCandidateBytes];\n  const itemCursors: string[] = [];\n  let retainedItemBytes = 0;\n\n  for (const [index, item] of params.items.entries()) {\n    retainedItemBytes += serializedJsonByteLength(item) + (index === 0 ? 0 : 1);\n    const cursor = params.cursorForItem(item, index);\n    itemCursors.push(cursor);\n    candidateBytes.push(\n      emptyCandidateBytes + retainedItemBytes + serializedJsonByteLength(cursor) - nullCursorBytes,\n    );\n  }\n\n  return {emptyCandidate, emptyResult, candidateBytes, itemCursors};\n}\n\nfunction largestFittingItemCount(\n  candidateBytes: readonly number[],\n  itemCount: number,\n  maxBytes: number,\n): number | undefined {\n  const minimumItemCount = itemCount === 0 ? 0 : 1;\n  for (let count = itemCount; count >= minimumItemCount; count -= 1) {\n    const candidateByteLength = candidateBytes[count];\n    if (candidateByteLength !== undefined && candidateByteLength <= maxBytes) return count;\n  }\n  return undefined;\n}\n\nexport function fitAgentAccessResponseToCeiling(\n  envelope: AgentAccessEnvelopeDto,\n  maxBytes = AGENT_ACCESS_RESPONSE_MAX_BYTES,\n): AgentAccessEnvelopeDto {\n  return serializedAgentAccessEnvelopeByteLength(envelope) <= maxBytes\n    ? envelope\n    : agentAccessError('content-too-large');\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction serializedJsonByteLength(value: unknown): number {\n  const serialized = JSON.stringify(value);\n  if (serialized === undefined) throw new Error('Agent-access value is not serializable');\n  return utf8Encoder.encode(serialized).byteLength;\n}\n"],"names":["AGENT_ACCESS_RESPONSE_MAX_BYTES","agentAccessError","utf8Encoder","TextEncoder","truncateAgentAccessUtf8","value","maxBytes","totalBytes","encode","byteLength","truncated","bytes","result","codePoint","codePointBytes","serializedAgentAccessEnvelopeByteLength","envelope","serialized","JSON","stringify","undefined","Error","reducePagedAgentAccessResponse","params","initialBytes","ok","isRecord","producerResult","fitState","buildPagedResponseFitState","itemCount","largestFittingItemCount","candidateBytes","items","length","nextCursor","itemCursors","emptyCandidate","emptyResult","itemKey","slice","next_cursor","response_truncated","response_total_bytes","emptyCandidateBytes","nullCursorBytes","serializedJsonByteLength","retainedItemBytes","index","item","entries","cursor","cursorForItem","push","minimumItemCount","count","candidateByteLength","fitAgentAccessResponseToCeiling","Array","isArray"],"mappings":"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"}

package/dist/core/tool-utils.d.ts

@@ -0,0 +1,37 @@
+import { type AgentAccessEnvelopeDto } from '@shipfox/api-agent-access-dto';
+import { truncateAgentAccessUtf8 } from './response.js';
+export { truncateAgentAccessUtf8 };
+export interface SafeParseSchema<T> {
+    safeParse(value: unknown): {
+        success: true;
+        data: T;
+    } | {
+        success: false;
+    };
+}
+export declare function parseInput<T>(schema: SafeParseSchema<T>, value: unknown): T | undefined;
+export declare function reducePage(envelope: AgentAccessEnvelopeDto, itemKey: string, items: readonly Record<string, unknown>[], cursorForItem: (item: Record<string, unknown>, index: number) => string): AgentAccessEnvelopeDto;
+export declare function decodeTimestampCursor(value: string | undefined): {
+    createdAt: string;
+    id: string;
+} | undefined;
+export declare function validateTimestampCursor(value: string | undefined): string | undefined;
+export declare function decodeStringCursor(value: string | undefined): {
+    value: string;
+    id: string;
+} | undefined;
+export declare function decodeNumberCursor(value: string | undefined): {
+    value: number;
+    id: string;
+} | undefined;
+export declare function validateBoundedNumberCursor(value: string | undefined, bounds: {
+    minValue: number;
+    maxValue: number;
+}): string | undefined;
+export declare function validateBoundedPositionCursor(value: string | undefined, maxValue: number): string | undefined;
+export declare function encodeTimestampCursor(createdAt: string, id: string): string;
+export declare function cap(value: string, maxBytes?: number): string;
+export declare function capNullable(value: string | null, maxBytes?: number): string | null;
+export declare function invalidRequest(): AgentAccessEnvelopeDto;
+export declare function notFound(): AgentAccessEnvelopeDto;
+//# sourceMappingURL=tool-utils.d.ts.map

package/dist/core/tool-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-utils.d.ts","sourceRoot":"","sources":["../../src/core/tool-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,+BAA+B,CAAC;AAQvC,OAAO,EAAiC,uBAAuB,EAAC,MAAM,eAAe,CAAC;AAEtF,OAAO,EAAC,uBAAuB,EAAC,CAAC;AAKjC,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG;QAAC,OAAO,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,CAAC,CAAA;KAAC,GAAG;QAAC,OAAO,EAAE,KAAK,CAAA;KAAC,CAAC;CACxE;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,GAAG,SAAS,CAGvF;AAED,wBAAgB,UAAU,CACxB,QAAQ,EAAE,sBAAsB,EAChC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EACzC,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,GACtE,sBAAsB,CAExB;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAC,GAAG,SAAS,CAI7C;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAIrF;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAC,GAAG,SAAS,CAEzC;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAC,GAAG,SAAS,CAGzC;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,MAAM,EAAE;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAC,GAC3C,MAAM,GAAG,SAAS,CAUpB;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,SAAS,CAUpB;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAA8B,GAAG,MAAM,CAEjF;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,QAAQ,SAA8B,GACrC,MAAM,GAAG,IAAI,CAEf;AAED,wBAAgB,cAAc,IAAI,sBAAsB,CAEvD;AAED,wBAAgB,QAAQ,IAAI,sBAAsB,CAEjD"}

package/dist/core/tool-utils.js

@@ -0,0 +1,73 @@
+import { AGENT_ACCESS_TEXT_MAX_BYTES } from '@shipfox/api-agent-access-dto';
+import { decodeNumberIdCursor, decodeStringIdCursor, decodeTimestampIdCursor, encodeTimestampIdCursor } from '@shipfox/node-drizzle';
+import { agentAccessError } from './envelope.js';
+import { reducePagedAgentAccessResponse, truncateAgentAccessUtf8 } from './response.js';
+export { truncateAgentAccessUtf8 };
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/iu;
+const DECIMAL_RE = /^\d+$/u;
+export function parseInput(schema, value) {
+    const parsed = schema.safeParse(value);
+    return parsed.success ? parsed.data : undefined;
+}
+export function reducePage(envelope, itemKey, items, cursorForItem) {
+    return reducePagedAgentAccessResponse({
+        envelope,
+        itemKey,
+        items,
+        cursorForItem
+    });
+}
+export function decodeTimestampCursor(value) {
+    if (value === undefined) return undefined;
+    const cursor = decodeTimestampIdCursor(value);
+    return cursor ? {
+        createdAt: cursor.createdAt.toISOString(),
+        id: cursor.id
+    } : undefined;
+}
+export function validateTimestampCursor(value) {
+    if (value === undefined) return undefined;
+    const cursor = decodeTimestampCursor(value);
+    return cursor !== undefined && UUID_RE.test(cursor.id) ? value : undefined;
+}
+export function decodeStringCursor(value) {
+    return value === undefined ? undefined : decodeStringIdCursor(value);
+}
+export function decodeNumberCursor(value) {
+    const cursor = value === undefined ? undefined : decodeNumberIdCursor(value);
+    return cursor !== undefined && Number.isSafeInteger(cursor.value) ? cursor : undefined;
+}
+export function validateBoundedNumberCursor(value, bounds) {
+    if (value === undefined) return undefined;
+    const cursor = decodeNumberCursor(value);
+    return cursor !== undefined && UUID_RE.test(cursor.id) && Number.isSafeInteger(cursor.value) && cursor.value >= bounds.minValue && cursor.value <= bounds.maxValue ? value : undefined;
+}
+export function validateBoundedPositionCursor(value, maxValue) {
+    if (value === undefined) return undefined;
+    const cursor = decodeStringCursor(value);
+    if (cursor === undefined || !UUID_RE.test(cursor.id) || !DECIMAL_RE.test(cursor.value)) {
+        return undefined;
+    }
+    const position = Number(cursor.value);
+    return Number.isSafeInteger(position) && position >= 0 && position <= maxValue ? value : undefined;
+}
+export function encodeTimestampCursor(createdAt, id) {
+    return encodeTimestampIdCursor({
+        createdAt: new Date(createdAt),
+        id
+    });
+}
+export function cap(value, maxBytes = AGENT_ACCESS_TEXT_MAX_BYTES) {
+    return truncateAgentAccessUtf8(value, maxBytes).value;
+}
+export function capNullable(value, maxBytes = AGENT_ACCESS_TEXT_MAX_BYTES) {
+    return value === null ? null : cap(value, maxBytes);
+}
+export function invalidRequest() {
+    return agentAccessError('invalid-request');
+}
+export function notFound() {
+    return agentAccessError('not-found');
+}
+
+//# sourceMappingURL=tool-utils.js.map

package/dist/core/tool-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/tool-utils.ts"],"sourcesContent":["import {\n  AGENT_ACCESS_TEXT_MAX_BYTES,\n  type AgentAccessEnvelopeDto,\n} from '@shipfox/api-agent-access-dto';\nimport {\n  decodeNumberIdCursor,\n  decodeStringIdCursor,\n  decodeTimestampIdCursor,\n  encodeTimestampIdCursor,\n} from '@shipfox/node-drizzle';\nimport {agentAccessError} from './envelope.js';\nimport {reducePagedAgentAccessResponse, truncateAgentAccessUtf8} from './response.js';\n\nexport {truncateAgentAccessUtf8};\n\nconst UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/iu;\nconst DECIMAL_RE = /^\\d+$/u;\n\nexport interface SafeParseSchema<T> {\n  safeParse(value: unknown): {success: true; data: T} | {success: false};\n}\n\nexport function parseInput<T>(schema: SafeParseSchema<T>, value: unknown): T | undefined {\n  const parsed = schema.safeParse(value);\n  return parsed.success ? parsed.data : undefined;\n}\n\nexport function reducePage(\n  envelope: AgentAccessEnvelopeDto,\n  itemKey: string,\n  items: readonly Record<string, unknown>[],\n  cursorForItem: (item: Record<string, unknown>, index: number) => string,\n): AgentAccessEnvelopeDto {\n  return reducePagedAgentAccessResponse({envelope, itemKey, items, cursorForItem});\n}\n\nexport function decodeTimestampCursor(\n  value: string | undefined,\n): {createdAt: string; id: string} | undefined {\n  if (value === undefined) return undefined;\n  const cursor = decodeTimestampIdCursor(value);\n  return cursor ? {createdAt: cursor.createdAt.toISOString(), id: cursor.id} : undefined;\n}\n\nexport function validateTimestampCursor(value: string | undefined): string | undefined {\n  if (value === undefined) return undefined;\n  const cursor = decodeTimestampCursor(value);\n  return cursor !== undefined && UUID_RE.test(cursor.id) ? value : undefined;\n}\n\nexport function decodeStringCursor(\n  value: string | undefined,\n): {value: string; id: string} | undefined {\n  return value === undefined ? undefined : decodeStringIdCursor(value);\n}\n\nexport function decodeNumberCursor(\n  value: string | undefined,\n): {value: number; id: string} | undefined {\n  const cursor = value === undefined ? undefined : decodeNumberIdCursor(value);\n  return cursor !== undefined && Number.isSafeInteger(cursor.value) ? cursor : undefined;\n}\n\nexport function validateBoundedNumberCursor(\n  value: string | undefined,\n  bounds: {minValue: number; maxValue: number},\n): string | undefined {\n  if (value === undefined) return undefined;\n  const cursor = decodeNumberCursor(value);\n  return cursor !== undefined &&\n    UUID_RE.test(cursor.id) &&\n    Number.isSafeInteger(cursor.value) &&\n    cursor.value >= bounds.minValue &&\n    cursor.value <= bounds.maxValue\n    ? value\n    : undefined;\n}\n\nexport function validateBoundedPositionCursor(\n  value: string | undefined,\n  maxValue: number,\n): string | undefined {\n  if (value === undefined) return undefined;\n  const cursor = decodeStringCursor(value);\n  if (cursor === undefined || !UUID_RE.test(cursor.id) || !DECIMAL_RE.test(cursor.value)) {\n    return undefined;\n  }\n  const position = Number(cursor.value);\n  return Number.isSafeInteger(position) && position >= 0 && position <= maxValue\n    ? value\n    : undefined;\n}\n\nexport function encodeTimestampCursor(createdAt: string, id: string): string {\n  return encodeTimestampIdCursor({createdAt: new Date(createdAt), id});\n}\n\nexport function cap(value: string, maxBytes = AGENT_ACCESS_TEXT_MAX_BYTES): string {\n  return truncateAgentAccessUtf8(value, maxBytes).value;\n}\n\nexport function capNullable(\n  value: string | null,\n  maxBytes = AGENT_ACCESS_TEXT_MAX_BYTES,\n): string | null {\n  return value === null ? null : cap(value, maxBytes);\n}\n\nexport function invalidRequest(): AgentAccessEnvelopeDto {\n  return agentAccessError('invalid-request');\n}\n\nexport function notFound(): AgentAccessEnvelopeDto {\n  return agentAccessError('not-found');\n}\n"],"names":["AGENT_ACCESS_TEXT_MAX_BYTES","decodeNumberIdCursor","decodeStringIdCursor","decodeTimestampIdCursor","encodeTimestampIdCursor","agentAccessError","reducePagedAgentAccessResponse","truncateAgentAccessUtf8","UUID_RE","DECIMAL_RE","parseInput","schema","value","parsed","safeParse","success","data","undefined","reducePage","envelope","itemKey","items","cursorForItem","decodeTimestampCursor","cursor","createdAt","toISOString","id","validateTimestampCursor","test","decodeStringCursor","decodeNumberCursor","Number","isSafeInteger","validateBoundedNumberCursor","bounds","minValue","maxValue","validateBoundedPositionCursor","position","encodeTimestampCursor","Date","cap","maxBytes","capNullable","invalidRequest","notFound"],"mappings":"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"}

package/dist/core/workflow-diagnostic-tools.d.ts

@@ -0,0 +1,5 @@
+import type { WorkflowsModuleClient } from '@shipfox/api-workflows-dto/inter-module';
+import type { AgentAccessTool } from './tools.js';
+/** Creates the lazy workflow diagnostic tools for later gateway composition. */
+export declare function createAgentAccessWorkflowDiagnosticTools(workflows: WorkflowsModuleClient): readonly AgentAccessTool[];
+//# sourceMappingURL=workflow-diagnostic-tools.d.ts.map

package/dist/core/workflow-diagnostic-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-diagnostic-tools.d.ts","sourceRoot":"","sources":["../../src/core/workflow-diagnostic-tools.ts"],"names":[],"mappings":"AAwDA,OAAO,KAAK,EAAC,qBAAqB,EAAC,MAAM,yCAAyC,CAAC;AAenF,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,YAAY,CAAC;AAKhD,gFAAgF;AAChF,wBAAgB,wCAAwC,CACtD,SAAS,EAAE,qBAAqB,GAC/B,SAAS,eAAe,EAAE,CAS5B"}