@stigmer/runner 3.12.8 → 3.12.9
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/.build-fingerprint +1 -1
- package/dist/activities/execute-cursor/fetch-interceptor.js +29 -16
- package/dist/activities/execute-cursor/fetch-interceptor.js.map +1 -1
- package/dist/activities/execute-cursor/index.d.ts +14 -0
- package/dist/activities/execute-cursor/index.js +55 -5
- package/dist/activities/execute-cursor/index.js.map +1 -1
- package/dist/activities/execute-cursor/message-translator.d.ts +15 -9
- package/dist/activities/execute-cursor/message-translator.js +15 -9
- package/dist/activities/execute-cursor/message-translator.js.map +1 -1
- package/dist/activities/execute-deep-agent/index.js +9 -0
- package/dist/activities/execute-deep-agent/index.js.map +1 -1
- package/dist/activities/execute-deep-agent/setup.d.ts +10 -1
- package/dist/activities/execute-deep-agent/setup.js +20 -3
- package/dist/activities/execute-deep-agent/setup.js.map +1 -1
- package/dist/payload-codecs.d.ts +1 -1
- package/dist/payload-codecs.js +6 -4
- package/dist/payload-codecs.js.map +1 -1
- package/dist/shared/memory-retrieval.d.ts +126 -0
- package/dist/shared/memory-retrieval.js +293 -0
- package/dist/shared/memory-retrieval.js.map +1 -0
- package/dist/shared/runner-credential-keys.js +2 -1
- package/dist/shared/runner-credential-keys.js.map +1 -1
- package/package.json +3 -2
- package/src/__tests__/history-encryption-e2e.test.ts +1 -1
- package/src/activities/execute-cursor/__tests__/build-prompt.test.ts +40 -1
- package/src/activities/execute-cursor/__tests__/fetch-interceptor.test.ts +49 -15
- package/src/activities/execute-cursor/fetch-interceptor.ts +37 -16
- package/src/activities/execute-cursor/index.ts +58 -5
- package/src/activities/execute-cursor/message-translator.ts +15 -9
- package/src/activities/execute-deep-agent/index.ts +10 -0
- package/src/activities/execute-deep-agent/setup.ts +34 -6
- package/src/payload-codecs.ts +12 -9
- package/src/shared/__tests__/memory-retrieval.test.ts +310 -0
- package/src/shared/memory-retrieval.ts +383 -0
- package/src/shared/runner-credential-keys.ts +2 -1
- package/dist/claimcheck/compressor.d.ts +0 -2
- package/dist/claimcheck/compressor.js +0 -8
- package/dist/claimcheck/compressor.js.map +0 -1
- package/dist/claimcheck/config.d.ts +0 -7
- package/dist/claimcheck/config.js +0 -10
- package/dist/claimcheck/config.js.map +0 -1
- package/dist/claimcheck/index.d.ts +0 -3
- package/dist/claimcheck/index.js +0 -4
- package/dist/claimcheck/index.js.map +0 -1
- package/dist/claimcheck/payload-codec.d.ts +0 -23
- package/dist/claimcheck/payload-codec.js +0 -105
- package/dist/claimcheck/payload-codec.js.map +0 -1
- package/dist/encryption/config.d.ts +0 -64
- package/dist/encryption/config.js +0 -113
- package/dist/encryption/config.js.map +0 -1
- package/dist/encryption/index.d.ts +0 -3
- package/dist/encryption/index.js +0 -3
- package/dist/encryption/index.js.map +0 -1
- package/dist/encryption/payload-codec.d.ts +0 -41
- package/dist/encryption/payload-codec.js +0 -130
- package/dist/encryption/payload-codec.js.map +0 -1
- package/src/__tests__/claimcheck-codec.test.ts +0 -256
- package/src/__tests__/encryption-codec.test.ts +0 -287
- package/src/__tests__/fixtures/encrypted-payload-fixture.json +0 -15
- package/src/claimcheck/compressor.ts +0 -9
- package/src/claimcheck/config.ts +0 -20
- package/src/claimcheck/index.ts +0 -3
- package/src/claimcheck/payload-codec.ts +0 -139
- package/src/encryption/config.ts +0 -161
- package/src/encryption/index.ts +0 -3
- package/src/encryption/payload-codec.ts +0 -152
|
@@ -63,7 +63,8 @@ export const RUNNER_CREDENTIAL_ENV_KEYS: readonly string[] = [
|
|
|
63
63
|
* rotation bookkeeping, not secrets.
|
|
64
64
|
*/
|
|
65
65
|
export const RUNNER_ENCRYPTION_ENV_KEYS: readonly string[] = [
|
|
66
|
-
// Temporal payload-encryption keys (
|
|
66
|
+
// Temporal payload-encryption keys (@stigmer/temporal-codecs' encryption
|
|
67
|
+
// config, read through the injected getRunnerSecret). An agent that
|
|
67
68
|
// reads these could decrypt the runner's Temporal history payloads.
|
|
68
69
|
"STIGMER_PAYLOAD_ENCRYPTION_KEY",
|
|
69
70
|
"STIGMER_PAYLOAD_ENCRYPTION_SECONDARY_KEY",
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"compressor.js","sourceRoot":"","sources":["../../src/claimcheck/compressor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEjD,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,QAAQ,CAAC,IAAI,CAAwB,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,UAAU,CAAC,IAAI,CAAwB,CAAC;AACjD,CAAC"}
|
|
@@ -1,10 +0,0 @@
|
|
|
1
|
-
const DEFAULT_THRESHOLD_BYTES = 128 * 1024; // 128KB
|
|
2
|
-
export function loadClaimcheckConfig() {
|
|
3
|
-
return {
|
|
4
|
-
enabled: process.env.CLAIMCHECK_ENABLED === "true",
|
|
5
|
-
thresholdBytes: parseInt(process.env.CLAIMCHECK_THRESHOLD_BYTES ?? String(DEFAULT_THRESHOLD_BYTES), 10),
|
|
6
|
-
compressionEnabled: process.env.CLAIMCHECK_COMPRESSION_ENABLED !== "false",
|
|
7
|
-
keyPrefix: process.env.CLAIMCHECK_KEY_PREFIX ?? "claimcheck/",
|
|
8
|
-
};
|
|
9
|
-
}
|
|
10
|
-
//# sourceMappingURL=config.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/claimcheck/config.ts"],"names":[],"mappings":"AAOA,MAAM,uBAAuB,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC,QAAQ;AAEpD,MAAM,UAAU,oBAAoB;IAClC,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,MAAM;QAClD,cAAc,EAAE,QAAQ,CACtB,OAAO,CAAC,GAAG,CAAC,0BAA0B,IAAI,MAAM,CAAC,uBAAuB,CAAC,EACzE,EAAE,CACH;QACD,kBAAkB,EAAE,OAAO,CAAC,GAAG,CAAC,8BAA8B,KAAK,OAAO;QAC1E,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,aAAa;KAC9D,CAAC;AACJ,CAAC"}
|
package/dist/claimcheck/index.js
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/claimcheck/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAyB,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}
|
|
@@ -1,23 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Temporal PayloadCodec that transparently offloads large payloads to
|
|
3
|
-
* external storage (ArtifactStorage). Payloads below the threshold pass
|
|
4
|
-
* through unchanged. Payloads at or above the threshold are compressed
|
|
5
|
-
* (optional), uploaded, and replaced with a small reference marker.
|
|
6
|
-
*
|
|
7
|
-
* On decode, markers are detected, the original payload is downloaded
|
|
8
|
-
* and decompressed, and the original bytes are restored — transparent
|
|
9
|
-
* to workflow/activity code.
|
|
10
|
-
*/
|
|
11
|
-
import type { Payload, PayloadCodec } from "@temporalio/common";
|
|
12
|
-
import type { ArtifactStorage } from "../shared/artifact-storage.js";
|
|
13
|
-
import type { ClaimcheckConfig } from "./config.js";
|
|
14
|
-
export declare class ClaimcheckPayloadCodec implements PayloadCodec {
|
|
15
|
-
private readonly storage;
|
|
16
|
-
private readonly config;
|
|
17
|
-
constructor(storage: ArtifactStorage, config: ClaimcheckConfig);
|
|
18
|
-
encode(payloads: Payload[]): Promise<Payload[]>;
|
|
19
|
-
decode(payloads: Payload[]): Promise<Payload[]>;
|
|
20
|
-
private encodePayload;
|
|
21
|
-
private decodePayload;
|
|
22
|
-
private isClaimcheckPayload;
|
|
23
|
-
}
|
|
@@ -1,105 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Temporal PayloadCodec that transparently offloads large payloads to
|
|
3
|
-
* external storage (ArtifactStorage). Payloads below the threshold pass
|
|
4
|
-
* through unchanged. Payloads at or above the threshold are compressed
|
|
5
|
-
* (optional), uploaded, and replaced with a small reference marker.
|
|
6
|
-
*
|
|
7
|
-
* On decode, markers are detected, the original payload is downloaded
|
|
8
|
-
* and decompressed, and the original bytes are restored — transparent
|
|
9
|
-
* to workflow/activity code.
|
|
10
|
-
*/
|
|
11
|
-
import { randomUUID } from "node:crypto";
|
|
12
|
-
import { compress, decompress } from "./compressor.js";
|
|
13
|
-
const MARKER_METADATA_KEY = "encoding";
|
|
14
|
-
const MARKER_ENCODING_VALUE = "binary/claimcheck";
|
|
15
|
-
export class ClaimcheckPayloadCodec {
|
|
16
|
-
storage;
|
|
17
|
-
config;
|
|
18
|
-
constructor(storage, config) {
|
|
19
|
-
this.storage = storage;
|
|
20
|
-
this.config = config;
|
|
21
|
-
}
|
|
22
|
-
async encode(payloads) {
|
|
23
|
-
return Promise.all(payloads.map((p) => this.encodePayload(p)));
|
|
24
|
-
}
|
|
25
|
-
async decode(payloads) {
|
|
26
|
-
return Promise.all(payloads.map((p) => this.decodePayload(p)));
|
|
27
|
-
}
|
|
28
|
-
async encodePayload(payload) {
|
|
29
|
-
const data = payload.data;
|
|
30
|
-
if (!data || data.length < this.config.thresholdBytes) {
|
|
31
|
-
return payload;
|
|
32
|
-
}
|
|
33
|
-
const originalBuf = Buffer.from(data);
|
|
34
|
-
let uploadBuf = originalBuf;
|
|
35
|
-
let compressed = false;
|
|
36
|
-
if (this.config.compressionEnabled) {
|
|
37
|
-
const compressedBuf = compress(originalBuf);
|
|
38
|
-
if (compressedBuf.length < originalBuf.length) {
|
|
39
|
-
uploadBuf = compressedBuf;
|
|
40
|
-
compressed = true;
|
|
41
|
-
}
|
|
42
|
-
}
|
|
43
|
-
const key = `${this.config.keyPrefix}${randomUUID()}`;
|
|
44
|
-
await this.storage.upload(key, uploadBuf, "application/octet-stream");
|
|
45
|
-
const marker = {
|
|
46
|
-
key,
|
|
47
|
-
size: data.length,
|
|
48
|
-
compressed,
|
|
49
|
-
metadata: serializeMetadata(payload.metadata),
|
|
50
|
-
};
|
|
51
|
-
return {
|
|
52
|
-
metadata: {
|
|
53
|
-
[MARKER_METADATA_KEY]: Buffer.from(MARKER_ENCODING_VALUE),
|
|
54
|
-
},
|
|
55
|
-
data: Buffer.from(JSON.stringify(marker)),
|
|
56
|
-
};
|
|
57
|
-
}
|
|
58
|
-
async decodePayload(payload) {
|
|
59
|
-
if (!this.isClaimcheckPayload(payload)) {
|
|
60
|
-
return payload;
|
|
61
|
-
}
|
|
62
|
-
const marker = JSON.parse(Buffer.from(payload.data).toString("utf-8"));
|
|
63
|
-
let rawBuf;
|
|
64
|
-
try {
|
|
65
|
-
rawBuf = await this.storage.download(marker.key);
|
|
66
|
-
}
|
|
67
|
-
catch (err) {
|
|
68
|
-
// Preserve the claimcheck-scoped error contract; the shared download error
|
|
69
|
-
// already carries the HTTP status (proxy) or the miss (local) as the cause.
|
|
70
|
-
const cause = err instanceof Error ? err.message : String(err);
|
|
71
|
-
throw new Error(`Claimcheck retrieve failed for key ${marker.key}: ${cause}`);
|
|
72
|
-
}
|
|
73
|
-
const dataBuf = marker.compressed ? decompress(rawBuf) : rawBuf;
|
|
74
|
-
return {
|
|
75
|
-
metadata: marker.metadata
|
|
76
|
-
? deserializeMetadata(marker.metadata)
|
|
77
|
-
: payload.metadata,
|
|
78
|
-
data: dataBuf,
|
|
79
|
-
};
|
|
80
|
-
}
|
|
81
|
-
isClaimcheckPayload(payload) {
|
|
82
|
-
const encoding = payload.metadata?.[MARKER_METADATA_KEY];
|
|
83
|
-
if (!encoding)
|
|
84
|
-
return false;
|
|
85
|
-
return Buffer.from(encoding).toString("utf-8") === MARKER_ENCODING_VALUE;
|
|
86
|
-
}
|
|
87
|
-
}
|
|
88
|
-
function serializeMetadata(metadata) {
|
|
89
|
-
if (!metadata)
|
|
90
|
-
return undefined;
|
|
91
|
-
const out = {};
|
|
92
|
-
for (const [key, value] of Object.entries(metadata)) {
|
|
93
|
-
if (value)
|
|
94
|
-
out[key] = Buffer.from(value).toString("base64");
|
|
95
|
-
}
|
|
96
|
-
return out;
|
|
97
|
-
}
|
|
98
|
-
function deserializeMetadata(metadata) {
|
|
99
|
-
const out = {};
|
|
100
|
-
for (const [key, value] of Object.entries(metadata)) {
|
|
101
|
-
out[key] = Buffer.from(value, "base64");
|
|
102
|
-
}
|
|
103
|
-
return out;
|
|
104
|
-
}
|
|
105
|
-
//# sourceMappingURL=payload-codec.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"payload-codec.js","sourceRoot":"","sources":["../../src/claimcheck/payload-codec.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,64 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Payload-encryption configuration (stigmer-cloud#227, stigmer#398).
|
|
3
|
-
*
|
|
4
|
-
* Two key sources, strict precedence:
|
|
5
|
-
*
|
|
6
|
-
* 1. Environment (STIGMER_PAYLOAD_ENCRYPTION_KEY(_ID)) — the operator's
|
|
7
|
-
* explicit choice: self-hosted deployments sharing one key with their
|
|
8
|
-
* server, and cloud sandboxes injected with the platform key. When the
|
|
9
|
-
* env key is set, bootstrap-delivered material is ignored entirely.
|
|
10
|
-
* 2. Bootstrap-delivered — server-managed per-identity keys handed to
|
|
11
|
-
* desktop-class runners by getRunnerBootstrapConfig. Held in memory
|
|
12
|
-
* only; persistence lives server-side, which is what makes Temporal
|
|
13
|
-
* replay work across runner restarts (every boot re-fetches the SAME
|
|
14
|
-
* key).
|
|
15
|
-
*
|
|
16
|
-
* Encryption is enabled iff a key is present from either source — the same
|
|
17
|
-
* enabled-iff-configured pattern as the claim-check codec. A malformed key
|
|
18
|
-
* fails the boot rather than silently running plaintext: an operator who set
|
|
19
|
-
* the key (or a server that minted one) intended history to be encrypted.
|
|
20
|
-
*
|
|
21
|
-
* Key rotation: payloads carry the id of the key that encrypted them.
|
|
22
|
-
* During a rotation window the previous key stays readable via the
|
|
23
|
-
* secondary pair while new payloads are written under the primary key.
|
|
24
|
-
* Workers capture keys at construction, so a rotated bootstrap key lands
|
|
25
|
-
* on the next runner boot — there is no live re-key.
|
|
26
|
-
*/
|
|
27
|
-
export interface EncryptionKey {
|
|
28
|
-
readonly keyId: string;
|
|
29
|
-
/** 32-byte AES-256 key. */
|
|
30
|
-
readonly key: Buffer;
|
|
31
|
-
}
|
|
32
|
-
export interface PayloadEncryptionConfig {
|
|
33
|
-
/** Key used to encrypt outgoing payloads (and decrypt its own). */
|
|
34
|
-
readonly primary: EncryptionKey;
|
|
35
|
-
/** Decrypt-only key accepted during rotation windows. */
|
|
36
|
-
readonly secondary?: EncryptionKey;
|
|
37
|
-
}
|
|
38
|
-
/**
|
|
39
|
-
* Server-managed key material delivered by getRunnerBootstrapConfig.
|
|
40
|
-
* Structurally mirrors {@link BootstrapPayloadEncryptionKeys} in
|
|
41
|
-
* stigmer-client.ts — declared here so this leaf module stays free of
|
|
42
|
-
* client imports.
|
|
43
|
-
*/
|
|
44
|
-
export interface BootstrapKeyMaterial {
|
|
45
|
-
readonly key: string;
|
|
46
|
-
readonly keyId?: string;
|
|
47
|
-
readonly secondaryKey?: string;
|
|
48
|
-
readonly secondaryKeyId?: string;
|
|
49
|
-
}
|
|
50
|
-
/**
|
|
51
|
-
* Returns the encryption config, or undefined when encryption is not
|
|
52
|
-
* configured (the codec is then simply not installed).
|
|
53
|
-
*
|
|
54
|
-
* Source precedence: the env key wins outright; bootstrap-delivered
|
|
55
|
-
* material applies only when no env key is set (see the module doc).
|
|
56
|
-
*
|
|
57
|
-
* @throws when a key is present but malformed, or a key id is missing —
|
|
58
|
-
* key misconfiguration must stop the boot, not degrade to plaintext.
|
|
59
|
-
* This applies equally to bootstrap material: a server that hands out
|
|
60
|
-
* a bad key or omits its id has broken the protocol contract, and
|
|
61
|
-
* running plaintext against a server that manages keys would silently
|
|
62
|
-
* defeat the feature.
|
|
63
|
-
*/
|
|
64
|
-
export declare function loadPayloadEncryptionConfig(bootstrap?: BootstrapKeyMaterial): PayloadEncryptionConfig | undefined;
|
|
@@ -1,113 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Payload-encryption configuration (stigmer-cloud#227, stigmer#398).
|
|
3
|
-
*
|
|
4
|
-
* Two key sources, strict precedence:
|
|
5
|
-
*
|
|
6
|
-
* 1. Environment (STIGMER_PAYLOAD_ENCRYPTION_KEY(_ID)) — the operator's
|
|
7
|
-
* explicit choice: self-hosted deployments sharing one key with their
|
|
8
|
-
* server, and cloud sandboxes injected with the platform key. When the
|
|
9
|
-
* env key is set, bootstrap-delivered material is ignored entirely.
|
|
10
|
-
* 2. Bootstrap-delivered — server-managed per-identity keys handed to
|
|
11
|
-
* desktop-class runners by getRunnerBootstrapConfig. Held in memory
|
|
12
|
-
* only; persistence lives server-side, which is what makes Temporal
|
|
13
|
-
* replay work across runner restarts (every boot re-fetches the SAME
|
|
14
|
-
* key).
|
|
15
|
-
*
|
|
16
|
-
* Encryption is enabled iff a key is present from either source — the same
|
|
17
|
-
* enabled-iff-configured pattern as the claim-check codec. A malformed key
|
|
18
|
-
* fails the boot rather than silently running plaintext: an operator who set
|
|
19
|
-
* the key (or a server that minted one) intended history to be encrypted.
|
|
20
|
-
*
|
|
21
|
-
* Key rotation: payloads carry the id of the key that encrypted them.
|
|
22
|
-
* During a rotation window the previous key stays readable via the
|
|
23
|
-
* secondary pair while new payloads are written under the primary key.
|
|
24
|
-
* Workers capture keys at construction, so a rotated bootstrap key lands
|
|
25
|
-
* on the next runner boot — there is no live re-key.
|
|
26
|
-
*/
|
|
27
|
-
import { getRunnerSecret } from "../shared/runner-credential-store.js";
|
|
28
|
-
const KEY_ENV = "STIGMER_PAYLOAD_ENCRYPTION_KEY";
|
|
29
|
-
const KEY_ID_ENV = "STIGMER_PAYLOAD_ENCRYPTION_KEY_ID";
|
|
30
|
-
const SECONDARY_KEY_ENV = "STIGMER_PAYLOAD_ENCRYPTION_SECONDARY_KEY";
|
|
31
|
-
const SECONDARY_KEY_ID_ENV = "STIGMER_PAYLOAD_ENCRYPTION_SECONDARY_KEY_ID";
|
|
32
|
-
const AES_256_KEY_BYTES = 32;
|
|
33
|
-
/**
|
|
34
|
-
* Returns the encryption config, or undefined when encryption is not
|
|
35
|
-
* configured (the codec is then simply not installed).
|
|
36
|
-
*
|
|
37
|
-
* Source precedence: the env key wins outright; bootstrap-delivered
|
|
38
|
-
* material applies only when no env key is set (see the module doc).
|
|
39
|
-
*
|
|
40
|
-
* @throws when a key is present but malformed, or a key id is missing —
|
|
41
|
-
* key misconfiguration must stop the boot, not degrade to plaintext.
|
|
42
|
-
* This applies equally to bootstrap material: a server that hands out
|
|
43
|
-
* a bad key or omits its id has broken the protocol contract, and
|
|
44
|
-
* running plaintext against a server that manages keys would silently
|
|
45
|
-
* defeat the feature.
|
|
46
|
-
*/
|
|
47
|
-
export function loadPayloadEncryptionConfig(bootstrap) {
|
|
48
|
-
// Key VALUES resolve through the credential store (the #508 boot capture
|
|
49
|
-
// moves them out of process.env — agent shells must not read them); the
|
|
50
|
-
// *_KEY_ID companions are rotation bookkeeping, not secrets, and stay
|
|
51
|
-
// plain env reads.
|
|
52
|
-
const rawKey = getRunnerSecret(KEY_ENV);
|
|
53
|
-
if (rawKey) {
|
|
54
|
-
const primary = {
|
|
55
|
-
keyId: requireKeyId(KEY_ID_ENV),
|
|
56
|
-
key: parseKey(rawKey, KEY_ENV),
|
|
57
|
-
};
|
|
58
|
-
const rawSecondary = getRunnerSecret(SECONDARY_KEY_ENV);
|
|
59
|
-
const secondary = rawSecondary
|
|
60
|
-
? {
|
|
61
|
-
keyId: requireKeyId(SECONDARY_KEY_ID_ENV),
|
|
62
|
-
key: parseKey(rawSecondary, SECONDARY_KEY_ENV),
|
|
63
|
-
}
|
|
64
|
-
: undefined;
|
|
65
|
-
return { primary, secondary };
|
|
66
|
-
}
|
|
67
|
-
if (bootstrap?.key) {
|
|
68
|
-
const primary = {
|
|
69
|
-
keyId: requireBootstrapKeyId(bootstrap.keyId, "payload_encryption_key_id"),
|
|
70
|
-
key: parseKey(bootstrap.key, "bootstrap payload_encryption_key"),
|
|
71
|
-
};
|
|
72
|
-
const secondary = bootstrap.secondaryKey
|
|
73
|
-
? {
|
|
74
|
-
keyId: requireBootstrapKeyId(bootstrap.secondaryKeyId, "payload_encryption_secondary_key_id"),
|
|
75
|
-
key: parseKey(bootstrap.secondaryKey, "bootstrap payload_encryption_secondary_key"),
|
|
76
|
-
}
|
|
77
|
-
: undefined;
|
|
78
|
-
return { primary, secondary };
|
|
79
|
-
}
|
|
80
|
-
return undefined;
|
|
81
|
-
}
|
|
82
|
-
function requireKeyId(envName) {
|
|
83
|
-
const keyId = process.env[envName];
|
|
84
|
-
// An explicit id is required (no default): during rotation two keys
|
|
85
|
-
// coexist, and payloads must name which one encrypted them.
|
|
86
|
-
if (!keyId) {
|
|
87
|
-
throw new Error(`Payload encryption misconfigured: ${envName} is required when the ` +
|
|
88
|
-
`corresponding key is set`);
|
|
89
|
-
}
|
|
90
|
-
return keyId;
|
|
91
|
-
}
|
|
92
|
-
function requireBootstrapKeyId(keyId, fieldName) {
|
|
93
|
-
if (!keyId) {
|
|
94
|
-
throw new Error(`Runner bootstrap returned a payload encryption key without its ${fieldName} — ` +
|
|
95
|
-
`refusing to encrypt under an unidentified key (server contract violation)`);
|
|
96
|
-
}
|
|
97
|
-
return keyId;
|
|
98
|
-
}
|
|
99
|
-
function parseKey(rawBase64, envName) {
|
|
100
|
-
let key;
|
|
101
|
-
try {
|
|
102
|
-
key = Buffer.from(rawBase64, "base64");
|
|
103
|
-
}
|
|
104
|
-
catch {
|
|
105
|
-
throw new Error(`Payload encryption misconfigured: ${envName} is not valid base64`);
|
|
106
|
-
}
|
|
107
|
-
if (key.length !== AES_256_KEY_BYTES) {
|
|
108
|
-
throw new Error(`Payload encryption misconfigured: ${envName} must decode to ` +
|
|
109
|
-
`${AES_256_KEY_BYTES} bytes (AES-256), got ${key.length}`);
|
|
110
|
-
}
|
|
111
|
-
return key;
|
|
112
|
-
}
|
|
113
|
-
//# sourceMappingURL=config.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/encryption/config.ts"],"names":[],"mappings":"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"}
|
package/dist/encryption/index.js
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/encryption/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC"}
|
|
@@ -1,41 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Temporal PayloadCodec that encrypts payloads at rest in workflow
|
|
3
|
-
* history (stigmer-cloud#227).
|
|
4
|
-
*
|
|
5
|
-
* Why: the workflow engine runs inside the Temporal deterministic
|
|
6
|
-
* sandbox, so decrypted execution-context values cross the history
|
|
7
|
-
* boundary in many places — the hydrate activity result, the runtime
|
|
8
|
-
* env passed as an input to every per-task activity, and expression
|
|
9
|
-
* results recorded as local-activity markers. Encrypting at the payload
|
|
10
|
-
* codec layer closes the entire class with one mechanism instead of
|
|
11
|
-
* chasing each crossing.
|
|
12
|
-
*
|
|
13
|
-
* Envelope (cross-SDK contract — the Java decode-only codec in
|
|
14
|
-
* stigmer-cloud's temporal-starter must match it byte-for-byte, pinned
|
|
15
|
-
* by the conformance fixture in __tests__/fixtures/):
|
|
16
|
-
*
|
|
17
|
-
* metadata: encoding = "binary/encrypted"
|
|
18
|
-
* encryption-key-id = <key id that encrypted this payload>
|
|
19
|
-
* data: iv (12 bytes) ‖ AES-256-GCM(ciphertext ‖ tag (16 bytes))
|
|
20
|
-
*
|
|
21
|
-
* The plaintext is the serialized ORIGINAL Payload proto (metadata AND
|
|
22
|
-
* data), so decode restores the payload exactly — including its
|
|
23
|
-
* original encoding — with no side channel.
|
|
24
|
-
*
|
|
25
|
-
* Decode passes through payloads it did not encode. This is what keeps
|
|
26
|
-
* plaintext signals from the Java/Go orchestrators and pre-rollout
|
|
27
|
-
* in-flight histories working with zero migration. Everything else
|
|
28
|
-
* fails closed: unknown key id, missing key id, and ciphertext tampering
|
|
29
|
-
* all throw rather than surfacing bogus payloads.
|
|
30
|
-
*/
|
|
31
|
-
import type { Payload, PayloadCodec } from "@temporalio/common";
|
|
32
|
-
import type { PayloadEncryptionConfig } from "./config.js";
|
|
33
|
-
export declare class EncryptionPayloadCodec implements PayloadCodec {
|
|
34
|
-
private readonly config;
|
|
35
|
-
private readonly decryptKeysById;
|
|
36
|
-
constructor(config: PayloadEncryptionConfig);
|
|
37
|
-
encode(payloads: Payload[]): Promise<Payload[]>;
|
|
38
|
-
decode(payloads: Payload[]): Promise<Payload[]>;
|
|
39
|
-
private encodePayload;
|
|
40
|
-
private decodePayload;
|
|
41
|
-
}
|
|
@@ -1,130 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Temporal PayloadCodec that encrypts payloads at rest in workflow
|
|
3
|
-
* history (stigmer-cloud#227).
|
|
4
|
-
*
|
|
5
|
-
* Why: the workflow engine runs inside the Temporal deterministic
|
|
6
|
-
* sandbox, so decrypted execution-context values cross the history
|
|
7
|
-
* boundary in many places — the hydrate activity result, the runtime
|
|
8
|
-
* env passed as an input to every per-task activity, and expression
|
|
9
|
-
* results recorded as local-activity markers. Encrypting at the payload
|
|
10
|
-
* codec layer closes the entire class with one mechanism instead of
|
|
11
|
-
* chasing each crossing.
|
|
12
|
-
*
|
|
13
|
-
* Envelope (cross-SDK contract — the Java decode-only codec in
|
|
14
|
-
* stigmer-cloud's temporal-starter must match it byte-for-byte, pinned
|
|
15
|
-
* by the conformance fixture in __tests__/fixtures/):
|
|
16
|
-
*
|
|
17
|
-
* metadata: encoding = "binary/encrypted"
|
|
18
|
-
* encryption-key-id = <key id that encrypted this payload>
|
|
19
|
-
* data: iv (12 bytes) ‖ AES-256-GCM(ciphertext ‖ tag (16 bytes))
|
|
20
|
-
*
|
|
21
|
-
* The plaintext is the serialized ORIGINAL Payload proto (metadata AND
|
|
22
|
-
* data), so decode restores the payload exactly — including its
|
|
23
|
-
* original encoding — with no side channel.
|
|
24
|
-
*
|
|
25
|
-
* Decode passes through payloads it did not encode. This is what keeps
|
|
26
|
-
* plaintext signals from the Java/Go orchestrators and pre-rollout
|
|
27
|
-
* in-flight histories working with zero migration. Everything else
|
|
28
|
-
* fails closed: unknown key id, missing key id, and ciphertext tampering
|
|
29
|
-
* all throw rather than surfacing bogus payloads.
|
|
30
|
-
*/
|
|
31
|
-
import { createCipheriv, createDecipheriv, randomBytes } from "node:crypto";
|
|
32
|
-
// Default-import + destructure, NOT `import { temporal } from …`:
|
|
33
|
-
// @temporalio/proto is CommonJS and its `temporal` export defeats Node's
|
|
34
|
-
// cjs-module-lexer named-export detection, so the named form loads under
|
|
35
|
-
// tsx/vitest (their interop is looser) but crashes plain `node dist/main.js`
|
|
36
|
-
// at startup with "Named export 'temporal' not found" (stigmer/stigmer#399
|
|
37
|
-
// boot regression). Pinned by scripts/verify-dist-boot.mjs in CI.
|
|
38
|
-
import proto from "@temporalio/proto";
|
|
39
|
-
const { temporal } = proto;
|
|
40
|
-
const ENCODING_METADATA_KEY = "encoding";
|
|
41
|
-
const ENCRYPTED_ENCODING_VALUE = "binary/encrypted";
|
|
42
|
-
const KEY_ID_METADATA_KEY = "encryption-key-id";
|
|
43
|
-
/** AES-GCM parameters shared with the Java implementation. */
|
|
44
|
-
const IV_BYTES = 12;
|
|
45
|
-
const AUTH_TAG_BYTES = 16;
|
|
46
|
-
export class EncryptionPayloadCodec {
|
|
47
|
-
config;
|
|
48
|
-
decryptKeysById;
|
|
49
|
-
constructor(config) {
|
|
50
|
-
this.config = config;
|
|
51
|
-
this.decryptKeysById = new Map([[config.primary.keyId, config.primary.key]]);
|
|
52
|
-
if (config.secondary) {
|
|
53
|
-
this.decryptKeysById.set(config.secondary.keyId, config.secondary.key);
|
|
54
|
-
}
|
|
55
|
-
}
|
|
56
|
-
async encode(payloads) {
|
|
57
|
-
return payloads.map((p) => this.encodePayload(p));
|
|
58
|
-
}
|
|
59
|
-
async decode(payloads) {
|
|
60
|
-
return payloads.map((p) => this.decodePayload(p));
|
|
61
|
-
}
|
|
62
|
-
encodePayload(payload) {
|
|
63
|
-
// Data-less payloads (binary/null from void results) stay as-is:
|
|
64
|
-
// there is nothing to protect, and the cross-language parents that
|
|
65
|
-
// await our workflows as void must be able to read them without a key.
|
|
66
|
-
if (!payload.data || payload.data.length === 0) {
|
|
67
|
-
return payload;
|
|
68
|
-
}
|
|
69
|
-
const plaintext = temporal.api.common.v1.Payload.encode(payload).finish();
|
|
70
|
-
return {
|
|
71
|
-
metadata: {
|
|
72
|
-
[ENCODING_METADATA_KEY]: Buffer.from(ENCRYPTED_ENCODING_VALUE),
|
|
73
|
-
[KEY_ID_METADATA_KEY]: Buffer.from(this.config.primary.keyId),
|
|
74
|
-
},
|
|
75
|
-
data: encrypt(plaintext, this.config.primary),
|
|
76
|
-
};
|
|
77
|
-
}
|
|
78
|
-
decodePayload(payload) {
|
|
79
|
-
if (!isEncryptedPayload(payload)) {
|
|
80
|
-
return payload;
|
|
81
|
-
}
|
|
82
|
-
const keyIdBytes = payload.metadata?.[KEY_ID_METADATA_KEY];
|
|
83
|
-
if (!keyIdBytes) {
|
|
84
|
-
throw new Error("Encrypted payload is missing its encryption-key-id metadata — refusing to decode");
|
|
85
|
-
}
|
|
86
|
-
const keyId = Buffer.from(keyIdBytes).toString("utf-8");
|
|
87
|
-
const key = this.decryptKeysById.get(keyId);
|
|
88
|
-
if (!key) {
|
|
89
|
-
throw new Error(`Encrypted payload uses unknown key id '${keyId}' — configure it as the ` +
|
|
90
|
-
`primary or secondary payload encryption key (rotation window?)`);
|
|
91
|
-
}
|
|
92
|
-
const plaintext = decrypt(payload.data, key, keyId);
|
|
93
|
-
return temporal.api.common.v1.Payload.decode(plaintext);
|
|
94
|
-
}
|
|
95
|
-
}
|
|
96
|
-
function isEncryptedPayload(payload) {
|
|
97
|
-
const encoding = payload.metadata?.[ENCODING_METADATA_KEY];
|
|
98
|
-
if (!encoding)
|
|
99
|
-
return false;
|
|
100
|
-
return Buffer.from(encoding).toString("utf-8") === ENCRYPTED_ENCODING_VALUE;
|
|
101
|
-
}
|
|
102
|
-
function encrypt(plaintext, key) {
|
|
103
|
-
const iv = randomBytes(IV_BYTES);
|
|
104
|
-
const cipher = createCipheriv("aes-256-gcm", key.key, iv);
|
|
105
|
-
const ciphertext = Buffer.concat([cipher.update(plaintext), cipher.final()]);
|
|
106
|
-
// Layout iv ‖ ciphertext ‖ tag matches Java's AES/GCM/NoPadding, whose
|
|
107
|
-
// doFinal() output is ciphertext ‖ tag.
|
|
108
|
-
return Buffer.concat([iv, ciphertext, cipher.getAuthTag()]);
|
|
109
|
-
}
|
|
110
|
-
function decrypt(data, key, keyId) {
|
|
111
|
-
if (data.length < IV_BYTES + AUTH_TAG_BYTES) {
|
|
112
|
-
throw new Error(`Encrypted payload under key id '${keyId}' is truncated (${data.length} bytes)`);
|
|
113
|
-
}
|
|
114
|
-
const buf = Buffer.from(data);
|
|
115
|
-
const iv = buf.subarray(0, IV_BYTES);
|
|
116
|
-
const ciphertext = buf.subarray(IV_BYTES, buf.length - AUTH_TAG_BYTES);
|
|
117
|
-
const tag = buf.subarray(buf.length - AUTH_TAG_BYTES);
|
|
118
|
-
const decipher = createDecipheriv("aes-256-gcm", key, iv);
|
|
119
|
-
decipher.setAuthTag(tag);
|
|
120
|
-
try {
|
|
121
|
-
return Buffer.concat([decipher.update(ciphertext), decipher.final()]);
|
|
122
|
-
}
|
|
123
|
-
catch {
|
|
124
|
-
// GCM auth failure: tampered ciphertext or a key that does not match
|
|
125
|
-
// its advertised id. Never surface partially decrypted bytes.
|
|
126
|
-
throw new Error(`Failed to decrypt payload under key id '${keyId}' — ciphertext is ` +
|
|
127
|
-
`corrupt or the configured key does not match`);
|
|
128
|
-
}
|
|
129
|
-
}
|
|
130
|
-
//# sourceMappingURL=payload-codec.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"payload-codec.js","sourceRoot":"","sources":["../../src/encryption/payload-codec.ts"],"names":[],"mappings":"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"}
|