@xemahq/platform-common 0.11.0 → 0.12.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/lib/session-event-payloads/assistant-message-metadata.d.ts +2 -0
- package/dist/lib/session-event-payloads/assistant-message-metadata.d.ts.map +1 -1
- package/dist/lib/session-event-payloads/assistant-message-metadata.js +8 -0
- package/dist/lib/session-event-payloads/assistant-message-metadata.js.map +1 -1
- package/dist/lib/session-event-payloads/validation.d.ts.map +1 -1
- package/dist/lib/session-event-payloads/validation.js +1 -0
- package/dist/lib/session-event-payloads/validation.js.map +1 -1
- package/dist/nestjs/fetch-with-retry.d.ts +0 -1
- package/dist/nestjs/fetch-with-retry.d.ts.map +1 -1
- package/dist/nestjs/fetch-with-retry.js +31 -3
- package/dist/nestjs/fetch-with-retry.js.map +1 -1
- package/package.json +2 -2
|
@@ -13,11 +13,13 @@ export type SessionAssistantMessageMetadata = {
|
|
|
13
13
|
widgets?: ChatWidgetEnvelope[];
|
|
14
14
|
toolCalls?: SessionPersistedToolCall[];
|
|
15
15
|
reasoning?: string;
|
|
16
|
+
railNotRecorded?: true;
|
|
16
17
|
};
|
|
17
18
|
export declare function buildAssistantMessageMetadata(args: {
|
|
18
19
|
turnId: SessionTurnId;
|
|
19
20
|
widgets?: readonly ChatWidgetEnvelope[];
|
|
20
21
|
toolCalls?: readonly SessionPersistedToolCall[];
|
|
21
22
|
reasoning?: string;
|
|
23
|
+
railNotRecorded?: true;
|
|
22
24
|
}): SessionAssistantMessageMetadata;
|
|
23
25
|
//# sourceMappingURL=assistant-message-metadata.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"assistant-message-metadata.d.ts","sourceRoot":"","sources":["../../../src/lib/session-event-payloads/assistant-message-metadata.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAE1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAO/D,MAAM,MAAM,wBAAwB,GAAG;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAiBF,MAAM,MAAM,+BAA+B,GAAG;IAC5C,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC/B,SAAS,CAAC,EAAE,wBAAwB,EAAE,CAAC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;
|
|
1
|
+
{"version":3,"file":"assistant-message-metadata.d.ts","sourceRoot":"","sources":["../../../src/lib/session-event-payloads/assistant-message-metadata.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAE1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAO/D,MAAM,MAAM,wBAAwB,GAAG;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAiBF,MAAM,MAAM,+BAA+B,GAAG;IAC5C,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC/B,SAAS,CAAC,EAAE,wBAAwB,EAAE,CAAC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IAwBnB,eAAe,CAAC,EAAE,IAAI,CAAC;CACxB,CAAC;AAUF,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAClD,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACxC,SAAS,CAAC,EAAE,SAAS,wBAAwB,EAAE,CAAC;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IAKnB,eAAe,CAAC,EAAE,IAAI,CAAC;CACxB,GAAG,+BAA+B,CAiClC"}
|
|
@@ -6,6 +6,13 @@ function buildAssistantMessageMetadata(args) {
|
|
|
6
6
|
throw new TypeError('Assistant message metadata field "turnId" must be a non-empty string.');
|
|
7
7
|
}
|
|
8
8
|
const reasoning = args.reasoning?.trim() ?? '';
|
|
9
|
+
const hasRailContent = (args.widgets?.length ?? 0) > 0 ||
|
|
10
|
+
(args.toolCalls?.length ?? 0) > 0 ||
|
|
11
|
+
reasoning.length > 0;
|
|
12
|
+
if (args.railNotRecorded === true && hasRailContent) {
|
|
13
|
+
throw new TypeError('Assistant message metadata cannot be marked railNotRecorded while ' +
|
|
14
|
+
'carrying rail content. A producer either observed the rail or did not.');
|
|
15
|
+
}
|
|
9
16
|
return {
|
|
10
17
|
turnId: args.turnId,
|
|
11
18
|
...(args.widgets !== undefined &&
|
|
@@ -13,6 +20,7 @@ function buildAssistantMessageMetadata(args) {
|
|
|
13
20
|
...(args.toolCalls !== undefined &&
|
|
14
21
|
args.toolCalls.length > 0 && { toolCalls: [...args.toolCalls] }),
|
|
15
22
|
...(reasoning.length > 0 && { reasoning }),
|
|
23
|
+
...(args.railNotRecorded === true && { railNotRecorded: true }),
|
|
16
24
|
};
|
|
17
25
|
}
|
|
18
26
|
//# sourceMappingURL=assistant-message-metadata.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"assistant-message-metadata.js","sourceRoot":"","sources":["../../../src/lib/session-event-payloads/assistant-message-metadata.ts"],"names":[],"mappings":";;
|
|
1
|
+
{"version":3,"file":"assistant-message-metadata.js","sourceRoot":"","sources":["../../../src/lib/session-event-payloads/assistant-message-metadata.ts"],"names":[],"mappings":";;AAuFA,sEA2CC;AA3CD,SAAgB,6BAA6B,CAAC,IAU7C;IACC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,SAAS,CACjB,uEAAuE,CACxE,CAAC;IACJ,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC/C,MAAM,cAAc,GAClB,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC;QAC/B,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC;QACjC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;IAMvB,IAAI,IAAI,CAAC,eAAe,KAAK,IAAI,IAAI,cAAc,EAAE,CAAC;QACpD,MAAM,IAAI,SAAS,CACjB,oEAAoE;YAClE,wEAAwE,CAC3E,CAAC;IACJ,CAAC;IACD,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS;YAC5B,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5D,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS;YAC9B,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAClE,GAAG,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC;QAG1C,GAAG,CAAC,IAAI,CAAC,eAAe,KAAK,IAAI,IAAI,EAAE,eAAe,EAAE,IAAa,EAAE,CAAC;KACzE,CAAC;AACJ,CAAC"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/lib/session-event-payloads/validation.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAEL,gBAAgB,EACjB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AACvD,OAAO,EAGL,iBAAiB,EAClB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACtB,MAAM,mBAAmB,CAAC;
|
|
1
|
+
{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/lib/session-event-payloads/validation.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAEL,gBAAgB,EACjB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AACvD,OAAO,EAGL,iBAAiB,EAClB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACtB,MAAM,mBAAmB,CAAC;AAgN3B,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAQhC,CAAC;AAGX,MAAM,MAAM,uBAAuB,GACjC,MAAM,OAAO,6BAA6B,CAAC;AAQ7C,qBAAa,gCAAiC,SAAQ,KAAK;IAEvD,QAAQ,CAAC,OAAO,EAAE,MAAM;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE;gBADzB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,SAAS,MAAM,EAAE;CAQrC;AAGD,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,gBAAgB,GAC1B,SAAS,IAAI,uBAAuB,CAEtC;AAiBD,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,gBAAgB,EAC3B,OAAO,EAAE,OAAO,GACf,IAAI,CAcN;AASD,wBAAgB,mCAAmC,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAQ3E"}
|
|
@@ -155,6 +155,7 @@ const SessionAssistantMessageMetadataSchema = zod_1.z
|
|
|
155
155
|
widgets: zod_1.z.array(widget_1.ChatWidgetEnvelopeSchema).min(1).optional(),
|
|
156
156
|
toolCalls: zod_1.z.array(SessionPersistedToolCallSchema).min(1).optional(),
|
|
157
157
|
reasoning: NonEmptyString.optional(),
|
|
158
|
+
railNotRecorded: zod_1.z.literal(true).optional(),
|
|
158
159
|
})
|
|
159
160
|
.strict();
|
|
160
161
|
exports.SESSION_EVENT_PAYLOAD_SCHEMAS = {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/lib/session-event-payloads/validation.ts"],"names":[],"mappings":";;;
|
|
1
|
+
{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/lib/session-event-payloads/validation.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"fetch-with-retry.d.ts","sourceRoot":"","sources":["../../src/nestjs/fetch-with-retry.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAE3B,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,
|
|
1
|
+
{"version":3,"file":"fetch-with-retry.d.ts","sourceRoot":"","sources":["../../src/nestjs/fetch-with-retry.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAE3B,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAQlB,MAAM,CAAC,EAAE,WAAW,CAAC;IAQrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAwGD,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,GAAG,GAAG,EACjB,IAAI,CAAC,EAAE,WAAW,EAClB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,QAAQ,CAAC,CAsGnB"}
|
|
@@ -5,14 +5,28 @@ const common_1 = require("@nestjs/common");
|
|
|
5
5
|
const logger = new common_1.Logger('fetchWithRetry');
|
|
6
6
|
const DEFAULT_OPTIONS = {
|
|
7
7
|
maxRetries: 3,
|
|
8
|
-
retryableStatuses: [429, 502, 503, 504],
|
|
9
8
|
initialDelay: 1000,
|
|
10
9
|
backoffMultiplier: 2,
|
|
11
10
|
maxDelay: 30_000,
|
|
12
11
|
};
|
|
12
|
+
const NOT_PROCESSED_STATUSES = [429, 503];
|
|
13
|
+
const AMBIGUOUS_STATUSES = [502, 504];
|
|
14
|
+
const IDEMPOTENT_METHODS = [
|
|
15
|
+
'GET',
|
|
16
|
+
'HEAD',
|
|
17
|
+
'OPTIONS',
|
|
18
|
+
'TRACE',
|
|
19
|
+
'PUT',
|
|
20
|
+
'DELETE',
|
|
21
|
+
];
|
|
22
|
+
function mayRetryAmbiguousFailure(init) {
|
|
23
|
+
const method = (init?.method ?? 'GET').toUpperCase();
|
|
24
|
+
return IDEMPOTENT_METHODS.includes(method);
|
|
25
|
+
}
|
|
13
26
|
async function fetchWithRetry(url, init, options) {
|
|
14
27
|
const opts = { ...DEFAULT_OPTIONS, ...options };
|
|
15
28
|
const overallSignal = options?.signal ?? init?.signal ?? undefined;
|
|
29
|
+
const ambiguousIsRetryable = mayRetryAmbiguousFailure(init);
|
|
16
30
|
let lastError;
|
|
17
31
|
let delay = opts.initialDelay;
|
|
18
32
|
for (let attempt = 0; attempt <= opts.maxRetries; attempt++) {
|
|
@@ -22,8 +36,16 @@ async function fetchWithRetry(url, init, options) {
|
|
|
22
36
|
...init,
|
|
23
37
|
signal: attemptSignal,
|
|
24
38
|
});
|
|
25
|
-
if (!
|
|
26
|
-
|
|
39
|
+
if (!NOT_PROCESSED_STATUSES.includes(response.status)) {
|
|
40
|
+
if (!AMBIGUOUS_STATUSES.includes(response.status)) {
|
|
41
|
+
return response;
|
|
42
|
+
}
|
|
43
|
+
if (!ambiguousIsRetryable) {
|
|
44
|
+
logger.warn(`Status ${response.status} from ${url} does not say whether the ` +
|
|
45
|
+
`request was applied, and ${init?.method ?? 'GET'} is not ` +
|
|
46
|
+
'idempotent — returning it rather than risking a duplicate write.');
|
|
47
|
+
return response;
|
|
48
|
+
}
|
|
27
49
|
}
|
|
28
50
|
if (attempt >= opts.maxRetries) {
|
|
29
51
|
return response;
|
|
@@ -40,6 +62,12 @@ async function fetchWithRetry(url, init, options) {
|
|
|
40
62
|
throw error;
|
|
41
63
|
}
|
|
42
64
|
lastError = error instanceof Error ? error : new Error(String(error));
|
|
65
|
+
if (!ambiguousIsRetryable) {
|
|
66
|
+
logger.warn(`Network error fetching ${url}: ${lastError.message}. ` +
|
|
67
|
+
`${init?.method ?? 'GET'} is not idempotent, so the request is ` +
|
|
68
|
+
'not re-sent — it may already have been applied.');
|
|
69
|
+
throw lastError;
|
|
70
|
+
}
|
|
43
71
|
if (attempt >= opts.maxRetries) {
|
|
44
72
|
throw lastError;
|
|
45
73
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"fetch-with-retry.js","sourceRoot":"","sources":["../../src/nestjs/fetch-with-retry.ts"],"names":[],"mappings":";;
|
|
1
|
+
{"version":3,"file":"fetch-with-retry.js","sourceRoot":"","sources":["../../src/nestjs/fetch-with-retry.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@xemahq/platform-common",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.12.0",
|
|
4
4
|
"description": "Shared NestJS building blocks for Xema services — auth guards, response redaction, CORS configuration, and crypto helpers.",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"author": "Neuralchowder Inc. <developer@xema.dev> (https://xema.dev)",
|
|
@@ -62,7 +62,7 @@
|
|
|
62
62
|
"rxjs": "7.8.2",
|
|
63
63
|
"ts-jest": "^29.4.9",
|
|
64
64
|
"typescript": "5.9.3",
|
|
65
|
-
"@xemahq/kernel-contracts": "^12.0
|
|
65
|
+
"@xemahq/kernel-contracts": "^12.1.0"
|
|
66
66
|
},
|
|
67
67
|
"exports": {
|
|
68
68
|
".": {
|