@maiaos/node 0.1.0-canary.44938d4.manual.1

package/dist/session/testing/built-session-execution-receipt.js

@@ -0,0 +1,243 @@
+import { createHash } from "node:crypto";
+import { Effect, Schema } from "effect";
+import { BuiltSessionAuthorityFailure } from "./built-session-execution-failure.js";
+import { gateBoundedPlainData, plainDataShape, } from "./built-session-structural-gate.js";
+const hexDigestSchema = Schema.String.check(Schema.isPattern(/^[0-9a-f]{64}$/u));
+const identitySchema = Schema.String.check(Schema.isMinLength(1), Schema.isMaxLength(128));
+const artifactSchema = Schema.String.check(Schema.isMinLength(1), Schema.isMaxLength(4096));
+const monotonicSchema = Schema.Number.check(Schema.isGreaterThanOrEqualTo(0));
+const receiptIdentityFields = {
+    artifactIdentity: artifactSchema,
+    attestation: hexDigestSchema,
+    authorityId: identitySchema,
+    boundaryId: identitySchema,
+    deadline: monotonicSchema,
+    invocationId: identitySchema,
+    order: Schema.Int.check(Schema.isGreaterThanOrEqualTo(0)),
+    providerName: identitySchema,
+    providerVersion: identitySchema,
+    registrationDigest: hexDigestSchema,
+    requestDigest: hexDigestSchema,
+    rootIdentity: hexDigestSchema,
+    sessionAuthorityId: identitySchema,
+    treeId: identitySchema,
+};
+export const preparedReceiptSchema = Schema.Struct({
+    ...receiptIdentityFields,
+    capability: Schema.Literal("exact_empty_proof"),
+    phase: Schema.Literal("prepared"),
+    preparedAt: monotonicSchema,
+    stopped: Schema.Literal(true),
+});
+export const registrationReceiptSchema = Schema.Struct({
+    ...receiptIdentityFields,
+    nonce: hexDigestSchema,
+    phase: Schema.Literal("registered"),
+    registeredAt: monotonicSchema,
+});
+export const startedReceiptSchema = Schema.Struct({
+    ...receiptIdentityFields,
+    phase: Schema.Literal("started"),
+    startedAt: monotonicSchema,
+});
+export const terminationReceiptSchema = Schema.Struct({
+    ...receiptIdentityFields,
+    phase: Schema.Literal("terminated"),
+    terminatedAt: monotonicSchema,
+});
+export const emptyReceiptSchema = Schema.Struct({
+    ...receiptIdentityFields,
+    phase: Schema.Literal("empty"),
+    populated: Schema.Literal(0),
+    provenAt: monotonicSchema,
+});
+export const sessionEmptyReceiptSchema = Schema.Struct({
+    ...receiptIdentityFields,
+    phase: Schema.Literal("session_empty"),
+    populated: Schema.Literal(0),
+    provenAt: monotonicSchema,
+});
+export const rootCreationReceiptSchema = Schema.Struct({
+    attestation: hexDigestSchema,
+    authorityId: identitySchema,
+    canonicalPath: artifactSchema,
+    createdAt: monotonicSchema,
+    deadline: monotonicSchema,
+    device: monotonicSchema,
+    inode: monotonicSchema,
+    order: Schema.Int.check(Schema.isGreaterThanOrEqualTo(0)),
+    phase: Schema.Literal("root_created"),
+    providerName: identitySchema,
+    providerVersion: identitySchema,
+    rootIdentity: hexDigestSchema,
+    sessionAuthorityId: identitySchema,
+    treeId: identitySchema,
+});
+const decodeOptions = { onExcessProperty: "error" };
+const shapeOf = (keys) => plainDataShape.record(Object.fromEntries(keys.map((key) => [key, undefined])));
+const receiptIdentityKeys = Object.keys(receiptIdentityFields);
+const decoderForKeys = (schema, keys) => {
+    const shape = shapeOf(keys);
+    const decode = Schema.decodeUnknownEffect(schema, decodeOptions);
+    return (input) => gateBoundedPlainData(input, shape).pipe(Effect.flatMap((plain) => decode(plain)));
+};
+const decoder = (schema, additionalKeys) => decoderForKeys(schema, [...receiptIdentityKeys, ...additionalKeys]);
+export const decodePreparedReceipt = decoder(preparedReceiptSchema, [
+    "capability",
+    "phase",
+    "preparedAt",
+    "stopped",
+]);
+export const decodeRegistrationReceipt = decoder(registrationReceiptSchema, [
+    "nonce",
+    "phase",
+    "registeredAt",
+]);
+export const decodeStartedReceipt = decoder(startedReceiptSchema, [
+    "phase",
+    "startedAt",
+]);
+export const decodeTerminationReceipt = decoder(terminationReceiptSchema, [
+    "phase",
+    "terminatedAt",
+]);
+export const decodeEmptyReceipt = decoder(emptyReceiptSchema, [
+    "phase",
+    "populated",
+    "provenAt",
+]);
+export const decodeSessionEmptyReceipt = decoder(sessionEmptyReceiptSchema, [
+    "phase",
+    "populated",
+    "provenAt",
+]);
+export const decodeRootCreationReceipt = decoderForKeys(rootCreationReceiptSchema, [
+    "attestation",
+    "authorityId",
+    "canonicalPath",
+    "createdAt",
+    "deadline",
+    "device",
+    "inode",
+    "order",
+    "phase",
+    "providerName",
+    "providerVersion",
+    "rootIdentity",
+    "sessionAuthorityId",
+    "treeId",
+]);
+export const digestUtf8 = (value) => createHash("sha256").update(value).digest("hex");
+export const unboundRootIdentityDigest = digestUtf8("unbound");
+export const unregisteredRegistrationDigest = digestUtf8("unregistered");
+export const digestRootIdentity = (input) => digestUtf8(`${String(input.device)}:${String(input.inode)}:${input.canonicalPath}`);
+const environmentEntries = (environment) => Object.keys(environment)
+    .sort()
+    .map((key) => {
+    const value = environment[key];
+    return [key, value === undefined ? "" : digestUtf8(value)];
+});
+export const digestInvocationRequest = (input) => {
+    const environmentDigest = digestUtf8(JSON.stringify(environmentEntries(input.environment)));
+    return digestUtf8(JSON.stringify({
+        argumentsDigest: digestUtf8(JSON.stringify(input.cliArguments)),
+        cleanupReserveMilliseconds: input.cleanupReserveMilliseconds,
+        environmentDigest,
+        maximumTotalMilliseconds: input.maximumTotalMilliseconds,
+        maxOutputBytes: input.maxOutputBytes,
+        ownerKind: input.ownerKind,
+        program: input.program,
+        stdinDigest: digestUtf8(input.stdin ?? ""),
+    }));
+};
+export const captureRequestIdentity = (input) => {
+    const environmentKeys = Object.keys(input.environment).sort();
+    const stdin = input.stdin ?? "";
+    return {
+        argumentBytes: input.cliArguments.reduce((bytes, argument) => bytes + Buffer.byteLength(argument, "utf8"), 0),
+        argumentCount: input.cliArguments.length,
+        argumentsDigest: digestUtf8(JSON.stringify(input.cliArguments)),
+        cleanupReserveMilliseconds: input.cleanupReserveMilliseconds,
+        environmentDigest: digestUtf8(JSON.stringify(environmentEntries(input.environment))),
+        environmentKeys,
+        maximumTotalMilliseconds: input.maximumTotalMilliseconds,
+        maxOutputBytes: input.maxOutputBytes,
+        ownerKind: input.ownerKind,
+        program: input.program,
+        requestDigest: digestInvocationRequest(input),
+        stdinBytes: Buffer.byteLength(stdin, "utf8"),
+        stdinDigest: digestUtf8(stdin),
+    };
+};
+const receiptFailure = (message) => new BuiltSessionAuthorityFailure({
+    message,
+    reason: "cleanup_unknown",
+});
+const identityMismatch = (field) => receiptFailure(`The ${field} on the lifecycle receipt did not match the authority record.`);
+const identityFields = [
+    "artifactIdentity",
+    "authorityId",
+    "boundaryId",
+    "invocationId",
+    "providerName",
+    "providerVersion",
+    "registrationDigest",
+    "requestDigest",
+    "rootIdentity",
+    "sessionAuthorityId",
+    "treeId",
+];
+const compareIdentity = (expected, receipt) => {
+    const mismatched = identityFields.find((field) => receipt[field] !== expected[field]);
+    if (mismatched !== undefined)
+        return identityMismatch(mismatched);
+    if (receipt.deadline !== expected.deadline) {
+        return receiptFailure("The lifecycle receipt deadline did not match the public entry deadline.");
+    }
+};
+export const occurrenceTime = (receipt) => {
+    if (receipt.phase === "prepared")
+        return receipt.preparedAt;
+    if (receipt.phase === "registered")
+        return receipt.registeredAt;
+    if (receipt.phase === "started")
+        return receipt.startedAt;
+    if (receipt.phase === "terminated")
+        return receipt.terminatedAt;
+    if (receipt.phase === "root_created")
+        return receipt.createdAt;
+    return receipt.provenAt;
+};
+const rejectReceiptOrder = (decoded, lastAcceptedOrder) => {
+    if (decoded.order <= lastAcceptedOrder) {
+        return receiptFailure("The lifecycle receipt was replayed or stale.");
+    }
+    if (decoded.order !== lastAcceptedOrder + 1) {
+        return receiptFailure("The lifecycle receipt arrived in the wrong order.");
+    }
+};
+const rejectReceiptTime = (decoded, lastAcceptedAt, now) => {
+    const at = occurrenceTime(decoded);
+    if (at < lastAcceptedAt) {
+        return receiptFailure("The lifecycle receipt timestamp moved backward.");
+    }
+    if (at > decoded.deadline || at > now) {
+        return receiptFailure("The lifecycle receipt was issued after the deadline.");
+    }
+};
+const rejectDecodedReceipt = (decoded, input) => {
+    if (!input.verifier.verify(decoded, decoded.attestation)) {
+        return receiptFailure("The lifecycle receipt attestation is not authentic.");
+    }
+    return (compareIdentity(input.expected, decoded) ??
+        rejectReceiptOrder(decoded, input.lastAcceptedOrder) ??
+        rejectReceiptTime(decoded, input.lastAcceptedAt, input.expected.now));
+};
+export const acceptLifecycleReceipt = Effect.fn("BuiltSessionReceipt.accept")(function* (input) {
+    const decoded = yield* input
+        .decode(input.receipt)
+        .pipe(Effect.mapError(() => receiptFailure("The lifecycle receipt failed schema validation.")));
+    const rejected = rejectDecodedReceipt(decoded, input);
+    return rejected === undefined ? decoded : yield* Effect.fail(rejected);
+});
+//# sourceMappingURL=built-session-execution-receipt.js.map

package/dist/session/testing/built-session-execution-receipt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"built-session-execution-receipt.js","sourceRoot":"","sources":["../../../src/session/testing/built-session-execution-receipt.ts"],"names":[],"mappings":"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"}

package/dist/session/testing/built-session-execution-record.d.ts

@@ -0,0 +1,15 @@
+export type BuiltSessionRootIdentity = {
+    readonly canonicalPath: string;
+    readonly device: number;
+    readonly inode: number;
+    readonly ownedByThisAuthority: boolean;
+    readonly symbolicLink: boolean;
+};
+/** Pure filesystem observation; it never registers or mutates authority. */
+export declare const captureRootIdentity: (rootPath: string, ownedByThisAuthority?: boolean) => BuiltSessionRootIdentity;
+/** Pure exact-identity comparison against a fresh filesystem observation. */
+export declare const rootIdentityMatches: (input: {
+    readonly expected: BuiltSessionRootIdentity;
+    readonly rootPath: string;
+}) => boolean;
+//# sourceMappingURL=built-session-execution-record.d.ts.map

package/dist/session/testing/built-session-execution-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"built-session-execution-record.d.ts","sourceRoot":"","sources":["../../../src/session/testing/built-session-execution-record.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,wBAAwB,GAAG;IACrC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAChC,CAAC;AAEF,4EAA4E;AAC5E,eAAO,MAAM,mBAAmB,GAC9B,UAAU,MAAM,EAChB,8BAA4B,KAC3B,wBASF,CAAC;AAEF,6EAA6E;AAC7E,eAAO,MAAM,mBAAmB,GAAI,OAAO;IACzC,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,KAAG,OAaH,CAAC"}

package/dist/session/testing/built-session-execution-record.js

@@ -0,0 +1,27 @@
+import { lstatSync, realpathSync } from "node:fs";
+/** Pure filesystem observation; it never registers or mutates authority. */
+export const captureRootIdentity = (rootPath, ownedByThisAuthority = false) => {
+    const stats = lstatSync(rootPath);
+    return {
+        canonicalPath: stats.isSymbolicLink() ? rootPath : realpathSync(rootPath),
+        device: stats.dev,
+        inode: stats.ino,
+        ownedByThisAuthority,
+        symbolicLink: stats.isSymbolicLink(),
+    };
+};
+/** Pure exact-identity comparison against a fresh filesystem observation. */
+export const rootIdentityMatches = (input) => {
+    try {
+        const actual = captureRootIdentity(input.rootPath);
+        return (!actual.symbolicLink &&
+            !input.expected.symbolicLink &&
+            actual.canonicalPath === input.expected.canonicalPath &&
+            actual.device === input.expected.device &&
+            actual.inode === input.expected.inode);
+    }
+    catch {
+        return false;
+    }
+};
+//# sourceMappingURL=built-session-execution-record.js.map

package/dist/session/testing/built-session-execution-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"built-session-execution-record.js","sourceRoot":"","sources":["../../../src/session/testing/built-session-execution-record.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAUlD,4EAA4E;AAC5E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,QAAgB,EAChB,oBAAoB,GAAG,KAAK,EACF,EAAE;IAC5B,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAClC,OAAO;QACL,aAAa,EAAE,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC;QACzE,MAAM,EAAE,KAAK,CAAC,GAAG;QACjB,KAAK,EAAE,KAAK,CAAC,GAAG;QAChB,oBAAoB;QACpB,YAAY,EAAE,KAAK,CAAC,cAAc,EAAE;KACrC,CAAC;AACJ,CAAC,CAAC;AAEF,6EAA6E;AAC7E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,KAGnC,EAAW,EAAE;IACZ,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACnD,OAAO,CACL,CAAC,MAAM,CAAC,YAAY;YACpB,CAAC,KAAK,CAAC,QAAQ,CAAC,YAAY;YAC5B,MAAM,CAAC,aAAa,KAAK,KAAK,CAAC,QAAQ,CAAC,aAAa;YACrD,MAAM,CAAC,MAAM,KAAK,KAAK,CAAC,QAAQ,CAAC,MAAM;YACvC,MAAM,CAAC,KAAK,KAAK,KAAK,CAAC,QAAQ,CAAC,KAAK,CACtC,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC"}

package/dist/session/testing/built-session-execution-snapshot.d.ts

@@ -0,0 +1,83 @@
+import type { BuiltSessionLifecycleState } from "./built-session-execution-lifecycle.js";
+import type { BuiltSessionOwnerKind } from "./built-session-execution-policy.js";
+import type { BuiltSessionRootCreationReceipt, BuiltSessionSessionEmptyReceipt } from "./built-session-execution-receipt.js";
+export type BuiltSessionRootIdentitySnapshot = {
+    readonly canonicalPath: string;
+    readonly device: number;
+    readonly inode: number;
+    readonly ownedByThisAuthority: boolean;
+    readonly symbolicLink: boolean;
+};
+export declare const deepFreezeCopy: (value: unknown) => unknown;
+export declare const freezeSnapshot: <TValue>(value: TValue) => TValue;
+export type BuiltSessionSessionSnapshot = {
+    readonly admissionActive: number;
+    readonly cleanupActive: number;
+    readonly deleting: boolean;
+    readonly emptyAccepted: boolean;
+    readonly emptyPopulated?: number;
+    readonly lifecycle: BuiltSessionLifecycleState;
+    readonly rootPath?: string;
+    readonly sessionAuthorityId: string;
+    readonly treeId: string;
+};
+export type BuiltSessionInvocationSnapshot = {
+    readonly boundaryId?: string;
+    readonly directExitObserved: boolean;
+    readonly handlePublished: boolean;
+    readonly helpersCreated: number;
+    readonly invocationId: string;
+    readonly lifecycle: BuiltSessionLifecycleState;
+    readonly ownerKind: BuiltSessionOwnerKind;
+    readonly providerName?: string;
+    readonly providerVersion?: string;
+    readonly registrationAttestation?: string;
+    readonly releaseCompleted: boolean;
+    readonly releaseStarted: boolean;
+    readonly requestDigest?: string;
+    readonly sessionAuthorityId: string;
+    readonly startAcknowledged: boolean;
+    readonly startDispatched: boolean;
+    readonly stderr: string;
+    readonly stdout: string;
+    readonly targetsCreated: number;
+    readonly treeId: string;
+};
+export type BuiltSessionReleaseRegistrySnapshot = {
+    readonly latches: number;
+    readonly scopes: number;
+};
+export type BuiltSessionOwnedRootSnapshot = {
+    readonly identity: BuiltSessionRootIdentitySnapshot;
+    readonly receipt: BuiltSessionRootCreationReceipt;
+    readonly rootPath: string;
+};
+export type BuiltSessionNumericResult = {
+    readonly code: number;
+    readonly stderr: string;
+    readonly stdout: string;
+};
+export type OfficialFakeSnapshot = {
+    readonly acquireCalls: number;
+    readonly censusCalls: number;
+    readonly closeCalls: number;
+    readonly descendantPresent: boolean;
+    readonly empty: boolean;
+    readonly emptyProofCalls: number;
+    readonly eventWaiters: number;
+    readonly gateWaiters: number;
+    readonly helpersCreated: number;
+    readonly prepareCalls: number;
+    readonly prepared: boolean;
+    readonly reclaimCalls: number;
+    readonly reclaimedControllerIds: readonly string[];
+    readonly sessionEmptyProofCalls: number;
+    readonly startCalls: number;
+    readonly started: boolean;
+    readonly targetsCreated: number;
+    readonly terminateCalls: number;
+    readonly terminated: boolean;
+    readonly terminatedControllerIds: readonly string[];
+};
+export declare const freezeSessionEmptyReceipt: (receipt: BuiltSessionSessionEmptyReceipt) => BuiltSessionSessionEmptyReceipt;
+//# sourceMappingURL=built-session-execution-snapshot.d.ts.map

package/dist/session/testing/built-session-execution-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"built-session-execution-snapshot.d.ts","sourceRoot":"","sources":["../../../src/session/testing/built-session-execution-snapshot.ts"],"names":[],"mappings":"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"}

package/dist/session/testing/built-session-execution-snapshot.js

@@ -0,0 +1,5 @@
+import { copyBoundedPlainData } from "./built-session-structural-gate.js";
+export const deepFreezeCopy = (value) => copyBoundedPlainData(value);
+export const freezeSnapshot = (value) => copyBoundedPlainData(value);
+export const freezeSessionEmptyReceipt = (receipt) => freezeSnapshot(receipt);
+//# sourceMappingURL=built-session-execution-snapshot.js.map

package/dist/session/testing/built-session-execution-snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"built-session-execution-snapshot.js","sourceRoot":"","sources":["../../../src/session/testing/built-session-execution-snapshot.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAU1E,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAc,EAAW,EAAE,CACxD,oBAAoB,CAAC,KAAK,CAAC,CAAC;AAE9B,MAAM,CAAC,MAAM,cAAc,GAAG,CAAS,KAAa,EAAU,EAAE,CAC9D,oBAAoB,CAAC,KAAK,CAAC,CAAC;AA6E9B,MAAM,CAAC,MAAM,yBAAyB,GAAG,CACvC,OAAwC,EACP,EAAE,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC"}

package/dist/session/testing/built-session-node.d.ts

@@ -0,0 +1,110 @@
+import { type ChildProcess } from "node:child_process";
+import { type LocalNodeReadyRecord } from "@maiaos/protocol";
+import { type BuiltSessionPipeCapture } from "./built-session-bounded-capture.js";
+export declare const BUILT_SESSION_NODE_BIN_PATH: string;
+export declare const BUILT_SESSION_CLI_BIN_PATH: string;
+export declare const BUILT_SESSION_OPERATION_DEADLINE_MS = 1500;
+export declare const BUILT_SESSION_FORCE_KILL_AFTER_MS = 200;
+export declare const BUILT_SESSION_STREAM_SETTLE_MS = 200;
+export declare const BUILT_SESSION_POST_KILL_WAIT_MS = 200;
+export declare const BUILT_SESSION_CLEANUP_DEADLINE_MS = 400;
+export declare const BUILT_SESSION_STARTUP_BOUND_MS = 2000;
+export declare const BUILT_SESSION_SHUTDOWN_SIGNAL_MS = 1600;
+export declare const BUILT_SESSION_SHUTDOWN_BOUND_MS: number;
+export declare const BUILT_SESSION_CLEANUP_BOUND_MS = 800;
+export declare const BUILT_SESSION_MAX_OUTPUT_BYTES: number;
+export declare const BUILT_SESSION_PROCESS_DEADLINE_MS = 1500;
+export declare const BUILT_SESSION_GIT_COMMAND_BOUND_MS = 8000;
+export declare const BUILT_SESSION_BARRIER_WAIT_BOUND_MS = 8000;
+export declare const BUILT_SESSION_SDK_CALL_BOUND_MS = 1500;
+export declare const BUILT_SESSION_GIT_REPOSITORY_COMMANDS = 5;
+export declare const BUILT_SESSION_IDLE_SESSION_CLI_CALLS = 2;
+export declare const BUILT_SESSION_CLI_BOUND_MS: number;
+export type BuiltSessionTestBudgetCounts = {
+    readonly barrierWaits?: number;
+    readonly cliCalls: number;
+    readonly crashWaits?: number;
+    readonly extraMilliseconds?: number;
+    readonly gitCommands?: number;
+    readonly idleSessions?: number;
+    readonly sdkCalls?: number;
+    readonly shutdowns: number;
+    readonly startups: number;
+};
+export declare const builtSessionTestBudgetMs: (counts: BuiltSessionTestBudgetCounts) => number;
+export type BuiltSessionNode = {
+    readonly child: ChildProcess;
+    readonly cliBinPath: string;
+    readonly nodeBinPath: string;
+    readonly readStderr: () => string;
+    readonly root: string;
+    readonly runtimeDirectory: string;
+    readonly sessionAuthorityId: string;
+    readonly turnSourceCandidateStarted?: boolean;
+};
+export type BuiltProcessOutput = {
+    readonly code: null | number;
+    readonly stderr: string;
+    readonly stdout: string;
+};
+export declare const withSessionTestDeadline: <TValue>(promise: Promise<TValue>, milliseconds: number, label: string) => Promise<TValue>;
+export declare const mapSequentially: <TItem, TResult>(items: readonly TItem[], mapper: (item: TItem) => Promise<TResult>) => Promise<readonly TResult[]>;
+export type { BuiltSessionPipeCapture } from "./built-session-bounded-capture.js";
+export declare const captureBuiltSessionPipe: (stream: NodeJS.ReadableStream | null | undefined) => (() => BuiltSessionPipeCapture);
+export declare const attachBuiltSessionPipeDrain: (stream: NodeJS.ReadableStream | null | undefined) => (() => string);
+export declare const redactBuiltSessionDiagnostic: (text: string) => string;
+export declare const describeBuiltSessionNode: (node: BuiltSessionNode) => string;
+type ReadinessSource = {
+    readonly child: ChildProcess;
+    readonly deadlineMilliseconds?: number;
+    readonly readStderr: () => string;
+    readonly readStdout: () => string;
+};
+export declare const waitForBuiltSessionReadiness: (source: ReadinessSource) => Promise<LocalNodeReadyRecord>;
+type StartBuiltSessionNodeOptions = {
+    readonly activationBarrier?: boolean;
+    readonly codexCleanupBarrier?: boolean;
+    readonly codexDisabledMcpServers?: readonly string[];
+    readonly codexDriver?: string;
+    readonly codexExecutable?: string;
+    readonly codexExecutableSha256?: string;
+    readonly codexExecutableVersion?: string;
+    readonly codexWorkspaceWrite?: boolean;
+    readonly dropMutationResponse?: boolean;
+    readonly integrationAuthorization?: boolean;
+    readonly reconcileAdmissionBarrier?: boolean;
+    readonly reconciliationBarrier?: boolean;
+    readonly root?: string;
+    readonly startupDelayMilliseconds?: number;
+    readonly turnBarrier?: boolean;
+    readonly turnSourceCandidateTestEntries?: boolean;
+};
+export type StartParkedBuiltSessionNodeOptions = {
+    readonly activationBarrier?: boolean;
+    readonly codexDriver?: string;
+    readonly root: string;
+    readonly runtimeDirectory: string;
+    readonly turnBarrier?: boolean;
+    readonly turnSourceCandidateTestEntries: true;
+};
+export declare const buildTurnSourceCandidateTestCli: (outfile: string) => Promise<void>;
+export declare const disposeTurnSourceCandidateTestExecutables: () => Promise<void>;
+export declare const startBuiltSessionNode: (options?: StartBuiltSessionNodeOptions) => Promise<BuiltSessionNode>;
+export declare const startParkedBuiltSessionNode: (options: StartParkedBuiltSessionNodeOptions) => Promise<BuiltSessionNode>;
+export declare const crashBuiltSessionNode: (node: BuiltSessionNode) => Promise<null | number>;
+export declare const runBuiltSessionCliWithDeadline: (node: BuiltSessionNode, arguments_: readonly string[], options: {
+    readonly deadlineMilliseconds: number;
+    readonly input?: string;
+    readonly programPath?: string;
+    readonly signal?: AbortSignal;
+}) => Promise<BuiltProcessOutput>;
+export declare const runBuiltSessionCliAsync: (node: BuiltSessionNode, arguments_: readonly string[], input?: string) => Promise<BuiltProcessOutput>;
+export declare const runBuiltSessionCli: (node: BuiltSessionNode, arguments_: readonly string[], input?: string) => Promise<BuiltProcessOutput>;
+export declare const parseBuiltSessionResult: (output: string) => unknown;
+export declare const shutdownBuiltSessionNode: (node: BuiltSessionNode) => Promise<null | number>;
+export declare const assertUnqualifiedBuiltSessionStart: () => Promise<void>;
+export declare const describeStrongBuiltSession: (name: string, suite: () => void) => void;
+export declare const describeTurnSourceCandidateBuiltSession: (name: string, suite: () => void) => void;
+export { decodeBoundedUtf8, utf8ValidPrefixLength, } from "./built-session-bounded-capture.js";
+export { assertOwnedBuiltSessionRoot, BuiltSessionTemporaryLifecycleFailure, createOwnedBuiltSessionRoot, createOwnedBuiltSessionRuntime, createOwnedTurnTestBinariesDirectory, disposeFinishedOwnedBuiltSessionRoots, disposeFinishedOwnedBuiltSessionTemporaries, inspectOwnedBuiltSessionTemporary, isBuiltSessionTemporaryName, listBuiltSessionTemporaryOccupants, listOwnedBuiltSessionTemporaries, releaseOwnedBuiltSessionTemporary, removeOwnedBuiltSessionTemporary, retainOwnedBuiltSessionTemporary, trackOwnedBuiltSessionChild, } from "./built-session-temporary-lifecycle.js";
+//# sourceMappingURL=built-session-node.d.ts.map

package/dist/session/testing/built-session-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"built-session-node.d.ts","sourceRoot":"","sources":["../../../src/session/testing/built-session-node.ts"],"names":[],"mappings":"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"}