@tangle-network/braid 0.1.0

package/dist/adapters/runtime/sandbox-account-observation.js

@@ -0,0 +1,82 @@
+export function observeSandboxAccount(client, state, unavailable, track, now) {
+    let identity;
+    let usage;
+    let subscription;
+    const publish = () => {
+        state.account = accountObservation(identity, usage, subscription, now());
+    };
+    if (client.getIdentity === undefined)
+        unavailable.add('sandbox-account-identity:not-exposed-by-client');
+    else
+        track(Promise.resolve()
+            .then(() => client.getIdentity?.())
+            .then((value) => {
+            identity = value;
+            publish();
+        })
+            .catch(() => {
+            unavailable.add('sandbox-account-identity:request-failed');
+        }));
+    if (client.usage === undefined)
+        unavailable.add('sandbox-account-usage:not-exposed-by-client');
+    else
+        track(Promise.resolve()
+            .then(() => client.usage?.())
+            .then((value) => {
+            usage = value;
+            publish();
+        })
+            .catch(() => {
+            unavailable.add('sandbox-account-usage:request-failed');
+        }));
+    if (client.subscription === undefined)
+        unavailable.add('sandbox-subscription:not-exposed-by-client');
+    else
+        track(Promise.resolve()
+            .then(() => client.subscription?.())
+            .then((value) => {
+            subscription = value;
+            publish();
+        })
+            .catch(() => {
+            unavailable.add('sandbox-subscription:request-failed');
+        }));
+}
+function accountObservation(identity, usage, subscription, sampledAt) {
+    if (identity === undefined && usage === undefined && subscription === undefined)
+        return undefined;
+    return {
+        scope: 'account',
+        completeness: 'provider-reported-possibly-defaulted',
+        ...(identity === undefined
+            ? {}
+            : { customerId: identity.customerId, billingOwnerId: identity.billingOwnerId }),
+        ...(usage === undefined
+            ? {}
+            : {
+                computeMinutes: usage.computeMinutes,
+                gpuSeconds: usage.gpuSeconds,
+                gpuCostUsd: usage.gpuCostUsd,
+                activeSandboxes: usage.activeSandboxes,
+                totalSandboxes: usage.totalSandboxes,
+                usagePeriodStart: usage.periodStart.toISOString(),
+                usagePeriodEnd: usage.periodEnd.toISOString(),
+            }),
+        ...(subscription === undefined
+            ? {}
+            : {
+                creditsAvailableUsd: subscription.creditsAvailableUsd,
+                creditsUsedUsd: subscription.creditsUsedUsd,
+                monthlyBalanceUsd: subscription.monthlyBalanceUsd,
+                plan: subscription.plan,
+                subscriptionStatus: subscription.status,
+                maximumConcurrentSandboxes: subscription.maxConcurrentSandboxes,
+                maximumCpuCores: subscription.limits.maxCpuCores,
+                maximumRamGB: subscription.limits.maxRamGB,
+                maximumStorageGB: subscription.limits.maxStorageGB,
+                subscriptionPeriodEnd: new Date(subscription.currentPeriodEnd).toISOString(),
+            }),
+        sampledAt,
+    };
+}
+//# sourceMappingURL=sandbox-account-observation.js.map

package/dist/adapters/runtime/sandbox-account-observation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-account-observation.js","sourceRoot":"","sources":["../../../src/adapters/runtime/sandbox-account-observation.ts"],"names":[],"mappings":"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"}

package/dist/adapters/runtime/sandbox-instance-observation.d.ts

@@ -0,0 +1,9 @@
+import type { SandboxInstanceLike } from '@tangle-network/agent-provider-tangle';
+import type { EnvironmentResourceRequest } from '../../domain/execution-observation.js';
+import { type MutableSandboxObservation, type ObservableSandboxInstance } from './sandbox-observation-types.js';
+export declare function wrapObservedSandboxBox(box: ObservableSandboxInstance, state: MutableSandboxObservation, unavailable: Set<string>): SandboxInstanceLike;
+export declare function captureSandboxBox(state: MutableSandboxObservation, box: ObservableSandboxInstance, unavailable: Set<string>): void;
+export declare function captureSandboxPlacement(state: MutableSandboxObservation, value: unknown, unavailable: Set<string>): void;
+export declare function requestedSandboxResources(value: unknown): EnvironmentResourceRequest | undefined;
+export declare function requestedSandboxRegion(value: unknown): string | undefined;
+//# sourceMappingURL=sandbox-instance-observation.d.ts.map

package/dist/adapters/runtime/sandbox-instance-observation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-instance-observation.d.ts","sourceRoot":"","sources":["../../../src/adapters/runtime/sandbox-instance-observation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAA;AAEhF,OAAO,KAAK,EAEV,0BAA0B,EAE3B,MAAM,uCAAuC,CAAA;AAE9C,OAAO,EAEL,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAK/B,MAAM,gCAAgC,CAAA;AAEvC,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,yBAAyB,EAC9B,KAAK,EAAE,yBAAyB,EAChC,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,GACvB,mBAAmB,CA6BrB;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,yBAAyB,EAChC,GAAG,EAAE,yBAAyB,EAC9B,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,GACvB,IAAI,CAcN;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,yBAAyB,EAChC,KAAK,EAAE,OAAO,EACd,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,GACvB,IAAI,CAQN;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,0BAA0B,GAAG,SAAS,CAiChG;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAEzE"}

package/dist/adapters/runtime/sandbox-instance-observation.js

@@ -0,0 +1,162 @@
+import { endpointLocation } from './execution-observation-source.js';
+import { boundedObservationText, observationDate, observationRecord, positiveObservationNumber, settleWithin, } from './sandbox-observation-types.js';
+export function wrapObservedSandboxBox(box, state, unavailable) {
+    const remove = box.delete?.bind(box);
+    return new Proxy(box, {
+        get(target, property) {
+            if (property === 'delete' && remove !== undefined) {
+                return async (options) => {
+                    state.lifecycle = 'destroying';
+                    await captureResourceSample(state, target, unavailable).catch(() => {
+                        unavailable.add('runtime-cpu-memory-usage:request-failed-or-timed-out');
+                    });
+                    let failure;
+                    for (let attempt = 0; attempt < 2; attempt += 1) {
+                        try {
+                            await remove(options);
+                            state.lifecycle = 'destroyed';
+                            return;
+                        }
+                        catch (error) {
+                            failure = error;
+                        }
+                    }
+                    state.lifecycle = 'unknown';
+                    unavailable.add('cleanup-outcome:unknown');
+                    throw failure;
+                };
+            }
+            const value = Reflect.get(target, property, target);
+            return typeof value === 'function' ? value.bind(target) : value;
+        },
+    });
+}
+export function captureSandboxBox(state, box, unavailable) {
+    state.providerEnvironmentId = boundedObservationText(box.id);
+    state.name = boundedObservationText(box.name) ?? state.name;
+    state.lifecycle = observedLifecycle(box.status);
+    state.createdAt = observationDate(box.createdAt) ?? state.createdAt;
+    state.startedAt = observationDate(box.startedAt);
+    state.lastActivityAt = observationDate(box.lastActivityAt);
+    state.expiresAt = observationDate(box.expiresAt);
+    const runtimeUrl = boundedObservationText(box.connection?.runtimeUrl);
+    if (runtimeUrl !== undefined)
+        state.runtimeEndpointHost = endpointLocation(runtimeUrl).runtimeEndpointHost;
+    state.gpu = gpuObservation(box.gpuLease);
+    if (state.lifecycle === 'unknown')
+        unavailable.add('sandbox-lifecycle:not-reported-or-unrecognized');
+}
+export function captureSandboxPlacement(state, value, unavailable) {
+    const record = observationRecord(value);
+    if (record === undefined) {
+        unavailable.add('verified-placement:empty-response');
+        return;
+    }
+    state.machineId = boundedObservationText(record.machineId);
+    state.region = boundedObservationText(record.region);
+}
+export function requestedSandboxResources(value) {
+    const record = observationRecord(value);
+    if (record === undefined)
+        return undefined;
+    const cpuCores = positiveObservationNumber(record.cpuCores ?? record.cpu);
+    const memoryMB = positiveObservationNumber(record.memoryMB ?? record.memoryMb);
+    const diskMb = positiveObservationNumber(record.diskMb);
+    const diskGB = positiveObservationNumber(record.diskGB) ?? (diskMb === undefined ? undefined : diskMb / 1_024);
+    const acceleratorRecord = observationRecord(record.accelerator);
+    const acceleratorKind = boundedObservationText(acceleratorRecord?.kind ?? record.gpu);
+    const acceleratorCount = positiveObservationNumber(acceleratorRecord?.count) ?? 1;
+    const acceleratorMemory = positiveObservationNumber(acceleratorRecord?.memoryMB);
+    if (cpuCores === undefined &&
+        memoryMB === undefined &&
+        diskGB === undefined &&
+        acceleratorKind === undefined)
+        return undefined;
+    return {
+        ...(cpuCores === undefined ? {} : { cpuCores }),
+        ...(memoryMB === undefined ? {} : { memoryMB }),
+        ...(diskGB === undefined ? {} : { diskGB }),
+        ...(acceleratorKind === undefined
+            ? {}
+            : {
+                accelerator: {
+                    kind: acceleratorKind,
+                    count: acceleratorCount,
+                    ...(acceleratorMemory === undefined ? {} : { memoryMB: acceleratorMemory }),
+                },
+            }),
+    };
+}
+export function requestedSandboxRegion(value) {
+    return boundedObservationText(observationRecord(value)?.preferredRegion);
+}
+async function captureResourceSample(state, box, unavailable) {
+    if (box.resourceUsage === undefined) {
+        unavailable.add('runtime-cpu-memory-usage:not-exposed-by-client');
+        return;
+    }
+    const result = await settleWithin(Promise.resolve().then(() => box.resourceUsage?.()), 750);
+    if (result === undefined) {
+        unavailable.add('runtime-cpu-memory-usage:request-failed-or-timed-out');
+        return;
+    }
+    if (result === null) {
+        unavailable.add('runtime-cpu-memory-usage:unavailable-on-host');
+        return;
+    }
+    state.resourceSample = {
+        cgroupVersion: result.cgroupVersion,
+        memoryCurrentMb: result.memoryCurrentMb,
+        ...(result.memoryPeakMb === null ? {} : { memoryPeakMb: result.memoryPeakMb }),
+        ...(result.memoryLimitMb === null ? {} : { memoryLimitMb: result.memoryLimitMb }),
+        cpuUsageUsec: result.cpuUsageUsec,
+        sampledAt: new Date(result.sampledAtMs).toISOString(),
+    };
+}
+function gpuObservation(lease) {
+    if (lease === undefined)
+        return undefined;
+    const instanceType = boundedObservationText(lease.providerInstanceType);
+    const region = boundedObservationText(lease.region);
+    return {
+        provider: lease.provider,
+        ...(instanceType === undefined ? {} : { instanceType }),
+        ...(region === undefined ? {} : { region }),
+        accelerator: lease.accelerator.kind,
+        count: lease.accelerator.count,
+        status: lease.status,
+        ...(lease.customerPricePerHourUsd === undefined
+            ? {}
+            : { customerPricePerHourUsd: lease.customerPricePerHourUsd }),
+        ...(lease.estimatedCustomerCostUsd === undefined
+            ? {}
+            : { estimatedCustomerCostUsd: lease.estimatedCustomerCostUsd }),
+        ...(lease.billing === undefined
+            ? {}
+            : {
+                billedSeconds: lease.billing.seconds,
+                billedCustomerCostUsd: lease.billing.customerCostUsd,
+            }),
+    };
+}
+function observedLifecycle(value) {
+    switch (value) {
+        case 'pending':
+            return 'requested';
+        case 'provisioning':
+            return 'creating';
+        case 'running':
+            return 'ready';
+        case 'stopped':
+            return 'detached';
+        case 'failed':
+            return 'failed';
+        case 'expired':
+            return 'expired';
+        case 'deleted':
+            return 'destroyed';
+        default:
+            return 'unknown';
+    }
+}
+//# sourceMappingURL=sandbox-instance-observation.js.map

package/dist/adapters/runtime/sandbox-instance-observation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-instance-observation.js","sourceRoot":"","sources":["../../../src/adapters/runtime/sandbox-instance-observation.ts"],"names":[],"mappings":"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"}

package/dist/adapters/runtime/sandbox-observation-types.d.ts

@@ -0,0 +1,42 @@
+import type { SandboxClientLike, SandboxInstanceLike } from '@tangle-network/agent-provider-tangle';
+import type { GpuLease, SandboxConnection, SandboxIdentity, SandboxResourceUsage, SubscriptionInfo, UsageInfo } from '@tangle-network/sandbox';
+import type { EnvironmentGpuObservation, EnvironmentResourceRequest, ExecutionEnvironmentObservation, ObservedEnvironmentLifecycle, SandboxAccountObservation } from '../../domain/execution-observation.js';
+export interface ObservableSandboxClient extends SandboxClientLike {
+    getIdentity?(): Promise<SandboxIdentity>;
+    usage?(): Promise<UsageInfo>;
+    subscription?(): Promise<SubscriptionInfo>;
+}
+export interface ObservableSandboxInstance extends SandboxInstanceLike {
+    readonly connection?: SandboxConnection;
+    readonly createdAt?: Date | string;
+    readonly startedAt?: Date | string;
+    readonly lastActivityAt?: Date | string;
+    readonly expiresAt?: Date | string;
+    readonly gpuLease?: GpuLease;
+    resourceUsage?(): Promise<SandboxResourceUsage | null>;
+}
+export interface MutableSandboxObservation {
+    providerEnvironmentId?: string | undefined;
+    name?: string | undefined;
+    lifecycle: ObservedEnvironmentLifecycle;
+    runtimeEndpointHost?: string | undefined;
+    machineId?: string | undefined;
+    requestedRegion?: string | undefined;
+    region?: string | undefined;
+    storagePersistence?: ExecutionEnvironmentObservation['storagePersistence'] | undefined;
+    requestedResources?: EnvironmentResourceRequest | undefined;
+    resourceSample?: ExecutionEnvironmentObservation['resourceSample'] | undefined;
+    gpu?: EnvironmentGpuObservation | undefined;
+    account?: SandboxAccountObservation | undefined;
+    createdAt: string;
+    startedAt?: string | undefined;
+    lastActivityAt?: string | undefined;
+    expiresAt?: string | undefined;
+}
+export declare function boundedObservationText(value: unknown): string | undefined;
+export declare function observationRecord(value: unknown): Record<string, unknown> | undefined;
+export declare function positiveObservationNumber(value: unknown): number | undefined;
+export declare function observationDate(value: Date | string | undefined): string | undefined;
+export declare function settleWithin<T>(promise: Promise<T>, timeoutMs: number): Promise<T | undefined>;
+export declare function completesWithin(promise: Promise<unknown>, timeoutMs: number): Promise<boolean>;
+//# sourceMappingURL=sandbox-observation-types.d.ts.map

package/dist/adapters/runtime/sandbox-observation-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-observation-types.d.ts","sourceRoot":"","sources":["../../../src/adapters/runtime/sandbox-observation-types.ts"],"names":[],"mappings":"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"}

package/dist/adapters/runtime/sandbox-observation-types.js

@@ -0,0 +1,45 @@
+export function boundedObservationText(value) {
+    if (typeof value !== 'string')
+        return undefined;
+    const candidate = value.trim();
+    return candidate.length > 0 && candidate.length <= 512 ? candidate : undefined;
+}
+export function observationRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+export function positiveObservationNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value > 0 ? value : undefined;
+}
+export function observationDate(value) {
+    if (value === undefined)
+        return undefined;
+    const date = value instanceof Date ? value : new Date(value);
+    return Number.isFinite(date.valueOf()) ? date.toISOString() : undefined;
+}
+export function settleWithin(promise, timeoutMs) {
+    return new Promise((resolve) => {
+        const timeout = setTimeout(() => resolve(undefined), timeoutMs);
+        promise.then((value) => {
+            clearTimeout(timeout);
+            resolve(value);
+        }, () => {
+            clearTimeout(timeout);
+            resolve(undefined);
+        });
+    });
+}
+export function completesWithin(promise, timeoutMs) {
+    return new Promise((resolve) => {
+        const timeout = setTimeout(() => resolve(false), timeoutMs);
+        promise.then(() => {
+            clearTimeout(timeout);
+            resolve(true);
+        }, () => {
+            clearTimeout(timeout);
+            resolve(false);
+        });
+    });
+}
+//# sourceMappingURL=sandbox-observation-types.js.map

package/dist/adapters/runtime/sandbox-observation-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-observation-types.js","sourceRoot":"","sources":["../../../src/adapters/runtime/sandbox-observation-types.ts"],"names":[],"mappings":"AAoDA,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACnD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAA;IAC/C,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;IAC9B,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,SAAS,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAA;AAChF,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACzE,CAAC,CAAE,KAAiC;QACpC,CAAC,CAAC,SAAS,CAAA;AACf,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,KAAc;IACtD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;AAC7F,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAgC;IAC9D,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IACzC,MAAM,IAAI,GAAG,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAA;IAC5D,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;AACzE,CAAC;AAED,MAAM,UAAU,YAAY,CAAI,OAAmB,EAAE,SAAiB;IACpE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,CAAA;QAC/D,OAAO,CAAC,IAAI,CACV,CAAC,KAAK,EAAE,EAAE;YACR,YAAY,CAAC,OAAO,CAAC,CAAA;YACrB,OAAO,CAAC,KAAK,CAAC,CAAA;QAChB,CAAC,EACD,GAAG,EAAE;YACH,YAAY,CAAC,OAAO,CAAC,CAAA;YACrB,OAAO,CAAC,SAAS,CAAC,CAAA;QACpB,CAAC,CACF,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAyB,EAAE,SAAiB;IAC1E,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,CAAA;QAC3D,OAAO,CAAC,IAAI,CACV,GAAG,EAAE;YACH,YAAY,CAAC,OAAO,CAAC,CAAA;YACrB,OAAO,CAAC,IAAI,CAAC,CAAA;QACf,CAAC,EACD,GAAG,EAAE;YACH,YAAY,CAAC,OAAO,CAAC,CAAA;YACrB,OAAO,CAAC,KAAK,CAAC,CAAA;QAChB,CAAC,CACF,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/adapters/runtime/sandbox-observation.d.ts

@@ -0,0 +1,9 @@
+import type { SandboxClientLike } from '@tangle-network/agent-provider-tangle';
+import type { ExecutionObservationSource, SandboxLifecyclePolicy } from './prepared-execution.js';
+export interface SandboxObservationBinding {
+    readonly client: SandboxClientLike;
+    readonly observation: ExecutionObservationSource;
+}
+/** Adds secret-free observation without changing the provider contract. */
+export declare function observeSandboxClient(source: SandboxClientLike, lifecycle: SandboxLifecyclePolicy, now?: () => string): SandboxObservationBinding;
+//# sourceMappingURL=sandbox-observation.d.ts.map

package/dist/adapters/runtime/sandbox-observation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-observation.d.ts","sourceRoot":"","sources":["../../../src/adapters/runtime/sandbox-observation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAuB,MAAM,uCAAuC,CAAA;AAiBnG,OAAO,KAAK,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AAEjG,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAA;IAClC,QAAQ,CAAC,WAAW,EAAE,0BAA0B,CAAA;CACjD;AAED,2EAA2E;AAC3E,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,sBAAsB,EACjC,GAAG,GAAE,MAAM,MAAuC,GACjD,yBAAyB,CAwF3B"}

package/dist/adapters/runtime/sandbox-observation.js

@@ -0,0 +1,123 @@
+import { observeSandboxAccount } from './sandbox-account-observation.js';
+import { captureSandboxBox, captureSandboxPlacement, requestedSandboxRegion, requestedSandboxResources, wrapObservedSandboxBox, } from './sandbox-instance-observation.js';
+import { boundedObservationText, completesWithin, } from './sandbox-observation-types.js';
+/** Adds secret-free observation without changing the provider contract. */
+export function observeSandboxClient(source, lifecycle, now = () => new Date().toISOString()) {
+    const client = source;
+    const unavailable = new Set([
+        'machine-ip:not-exposed-by-provider',
+        'effective-resources:not-exposed-by-provider',
+        'disk-usage:not-exposed-by-provider',
+        'per-sandbox-cpu-ram-storage-cost:not-exposed-by-provider',
+    ]);
+    const state = { lifecycle: 'requested', createdAt: now() };
+    const pending = [];
+    let pendingCount = 0;
+    const originals = new WeakMap();
+    const track = (task) => {
+        pendingCount += 1;
+        pending.push(task
+            .catch(() => undefined)
+            .then(() => {
+            pendingCount -= 1;
+        }));
+    };
+    observeSandboxAccount(client, state, unavailable, track, now);
+    const wrapped = {
+        async create(options, requestOptions) {
+            state.lifecycle = 'creating';
+            state.name = boundedObservationText(options?.name);
+            state.requestedResources = requestedSandboxResources(options?.resources);
+            state.requestedRegion = requestedSandboxRegion(options?.driver);
+            state.storagePersistence = options?.ephemeral === true ? 'ephemeral-home' : 'persistent-home';
+            try {
+                const box = (await source.create(options, requestOptions));
+                captureSandboxBox(state, box, unavailable);
+                if (source.describePlacement === undefined) {
+                    unavailable.add('verified-placement:not-exposed-by-client');
+                }
+                else {
+                    track(Promise.resolve()
+                        .then(() => source.describePlacement?.(box))
+                        .then((placement) => captureSandboxPlacement(state, placement, unavailable)));
+                }
+                const proxy = wrapObservedSandboxBox(box, state, unavailable);
+                originals.set(proxy, box);
+                return proxy;
+            }
+            catch (error) {
+                state.lifecycle = 'failed';
+                unavailable.add('provider-environment-id:not-materialized');
+                throw error;
+            }
+        },
+        ...(source.get === undefined
+            ? {}
+            : {
+                get: (id, requestOptions) => source.get?.(id, requestOptions) ?? Promise.resolve(null),
+            }),
+        ...(source.list === undefined
+            ? {}
+            : {
+                list: (options) => source.list?.(options) ?? Promise.resolve([]),
+            }),
+        ...(source.describePlacement === undefined
+            ? {}
+            : {
+                describePlacement: (box) => source.describePlacement?.(originals.get(box) ?? box),
+            }),
+    };
+    return {
+        client: wrapped,
+        observation: {
+            async snapshot() {
+                const settled = await completesWithin(Promise.all(pending), 1_000);
+                const currentUnavailable = new Set(unavailable);
+                if (!settled || pendingCount > 0)
+                    currentUnavailable.add('account-or-placement-observation:pending');
+                if (state.machineId === undefined)
+                    currentUnavailable.add('machine-id:not-exposed-by-provider');
+                if (state.region === undefined)
+                    currentUnavailable.add('verified-region:not-exposed-by-provider');
+                return freezeObservation(state, lifecycle, currentUnavailable, now());
+            },
+        },
+    };
+}
+function freezeObservation(state, lifecycle, unavailable, observedAt) {
+    return Object.freeze({
+        kind: 'sandbox',
+        provider: 'tangle-sandbox',
+        ...(state.providerEnvironmentId === undefined
+            ? {}
+            : { providerEnvironmentId: state.providerEnvironmentId }),
+        ...(state.name === undefined ? {} : { name: state.name }),
+        lifecycle: state.lifecycle,
+        lifecycleMode: lifecycle.mode,
+        cleanup: lifecycle.cleanup,
+        continuity: lifecycle.continuity,
+        location: 'remote',
+        ...(state.runtimeEndpointHost === undefined
+            ? {}
+            : { runtimeEndpointHost: state.runtimeEndpointHost }),
+        ...(state.machineId === undefined ? {} : { machineId: state.machineId }),
+        ...(state.requestedRegion === undefined ? {} : { requestedRegion: state.requestedRegion }),
+        ...(state.region === undefined ? {} : { region: state.region }),
+        ...(state.storagePersistence === undefined
+            ? {}
+            : { storagePersistence: state.storagePersistence }),
+        ...(state.requestedResources === undefined
+            ? {}
+            : { requestedResources: state.requestedResources }),
+        ...(state.resourceSample === undefined ? {} : { resourceSample: state.resourceSample }),
+        ...(state.gpu === undefined ? {} : { gpu: state.gpu }),
+        ...(state.account === undefined ? {} : { account: state.account }),
+        createdAt: state.createdAt,
+        ...(state.startedAt === undefined ? {} : { startedAt: state.startedAt }),
+        ...(state.lastActivityAt === undefined ? {} : { lastActivityAt: state.lastActivityAt }),
+        ...(state.expiresAt === undefined ? {} : { expiresAt: state.expiresAt }),
+        observedAt,
+        unavailable: Object.freeze([...unavailable].sort()),
+    });
+}
+//# sourceMappingURL=sandbox-observation.js.map

package/dist/adapters/runtime/sandbox-observation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-observation.js","sourceRoot":"","sources":["../../../src/adapters/runtime/sandbox-observation.ts"],"names":[],"mappings":"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"}

package/dist/adapters/runtime/sandbox-result-projection.d.ts

@@ -0,0 +1,10 @@
+import type { ExecutorFactory } from '@tangle-network/agent-runtime/kernel';
+export interface SandboxTerminalOutcome {
+    readonly status: 'completed' | 'failed' | 'aborted';
+    readonly reason?: string;
+}
+/** Project Runtime's buffered sandbox artifact into its standard terminal result shape. */
+export declare function withSandboxResultProjection(factory: ExecutorFactory<unknown>): ExecutorFactory<unknown>;
+/** Read only the outcome marker created by this module. */
+export declare function sandboxTerminalOutcomeFromExecutorOutput(value: unknown): SandboxTerminalOutcome | undefined;
+//# sourceMappingURL=sandbox-result-projection.d.ts.map

package/dist/adapters/runtime/sandbox-result-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-result-projection.d.ts","sourceRoot":"","sources":["../../../src/adapters/runtime/sandbox-result-projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAA;AAe3E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAA;IACnD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAUD,2FAA2F;AAC3F,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,eAAe,CAAC,OAAO,CAAC,GAChC,eAAe,CAAC,OAAO,CAAC,CAsB1B;AAED,2DAA2D;AAC3D,wBAAgB,wCAAwC,CACtD,KAAK,EAAE,OAAO,GACb,sBAAsB,GAAG,SAAS,CAWpC"}