spawnfile 0.1.14 → 0.1.17

package/dist/runtime/daimon/contractManifest.d.ts

@@ -0,0 +1,295 @@
+export declare const DAIMON_CONTRACT_MANIFEST_VERSION: "noopolis.daimon.runtime-contract-manifest.v3";
+export declare const DAIMON_CONTRACT_MANIFEST_SHA256: "sha256:c672ed47e4a01a75f1482ea6e4b6ecb28205aab344741a10cad8783f5501b6c4";
+export declare const DAIMON_CONTRACT_MANIFEST_FILE = "contract-manifest.json";
+export declare const DAIMON_CONTRACT_MANIFEST_DIGEST_FILE = "contract-manifest.sha256";
+export declare const DAIMON_RUNTIME_HOME_ROOT = "/var/lib/spawnfile/instances/daimon";
+export declare const DAIMON_ENGINE_KINDS: readonly ["agy", "codex", "grok"];
+export declare const DAIMON_ORGANIZATION_RUNTIME_CONFIG_VERSIONS: readonly ["noopolis.daimon.organization-runtime.v1", "noopolis.daimon.organization-runtime.v2"];
+export declare const DAIMON_ENGINE_CREDENTIALS: {
+    readonly codex: {
+        readonly destinationRelativePath: ".codex/auth.json";
+        readonly directoryMode: 448;
+        readonly fileMode: 384;
+        readonly sourceRelativePath: ".daimon-inbound/codex-auth";
+        readonly sourceSlot: "codex-auth";
+    };
+};
+export declare const DAIMON_GROK_SUBSCRIPTION_REALM: {
+    readonly agentCredentialRelativePath: ".grok/auth.json";
+    readonly bootstrapMountPath: "/var/lib/spawnfile/daimon/grok-bootstrap-auth";
+    readonly bootstrapSourceSlot: "grok-auth";
+    readonly directoryMode: 448;
+    readonly durableMountPath: "/var/lib/spawnfile/daimon/grok-subscription-realm";
+    readonly fileMode: 384;
+    readonly maxCredentialBytes: number;
+};
+export declare const DAIMON_GROK_BROKER_MODELS: readonly ["grok-4.6", "grok-4.5", "grok-build"];
+export declare const DAIMON_GROK_BROKER_REASONING_EFFORTS: readonly ["low", "medium", "high"];
+export type DaimonGrokBrokerModel = typeof DAIMON_GROK_BROKER_MODELS[number];
+export type DaimonGrokBrokerReasoningEffort = typeof DAIMON_GROK_BROKER_REASONING_EFFORTS[number];
+/**
+ * Byte mirror of Daimon's `GROK_ENGINE_BROKER` (daimon
+ * `src/contracts/runtimeContractManifest.ts`), attested key-for-key against the
+ * vendored `contract-manifest.json` by `parseDaimonContractManifest`.
+ */
+export declare const DAIMON_GROK_ENGINE_BROKER: {
+    readonly nativeAbiVersion: 2;
+    readonly nativeExecutablePath: "/opt/daimon/bin/daimon-engine-broker";
+    readonly grokExecutablePath: "/usr/local/bin/grok";
+    readonly registrationPath: "/etc/daimon-engine-broker/registrations.bin";
+    readonly credentialHomePath: "/var/lib/spawnfile/daimon/grok-subscription-realm";
+    readonly turnStorePath: "/var/lib/spawnfile/daimon/grok-subscription-realm/turns";
+    readonly controlSocketPath: "/run/daimon-engine-broker/control.sock";
+    readonly backendSocketPath: "/run/daimon-engine-broker/backend.sock";
+    readonly launcherSocketPath: "/run/daimon-engine-broker/launcher.sock";
+    readonly serviceConfigPath: "/etc/daimon-engine-broker/service.json";
+    readonly providerProxy: {
+        readonly host: "127.0.0.1";
+        readonly port: 43123;
+    };
+    readonly mcpFacade: {
+        readonly host: "127.0.0.1";
+        readonly port: 43124;
+        readonly path: "/mcp";
+    };
+    readonly identities: {
+        readonly organizationUid: 2000;
+        readonly brokerUid: 2100;
+        readonly firstWorkerUid: 2200;
+    };
+    readonly grokCliVersion: "1.0.34";
+    readonly grokCliBuild: "3736acbc8658";
+    readonly grokCliArtifacts: {
+        readonly arm64: {
+            readonly url: "https://storage.googleapis.com/grok-build-public-artifacts/cli/grok-1.0.34-linux-aarch64";
+            readonly sha256: "39ab87666877d64ef3a40aa60fbe0c3b6a6acd7001b78fe60e2c76bb6cfc4a94";
+            readonly bytes: 136090504;
+        };
+        readonly x64: {
+            readonly url: "https://storage.googleapis.com/grok-build-public-artifacts/cli/grok-1.0.34-linux-x86_64";
+            readonly sha256: "be5905e107d2b8b5f3c142d21ecfe4c8fd32a913d2fd551b788707930c4dc80d";
+            readonly bytes: 163035648;
+        };
+    };
+    readonly worker: {
+        readonly modelId: "daimon-broker-grok";
+        readonly models: readonly ["grok-4.6", "grok-4.5", "grok-build"];
+        readonly reasoningEfforts: readonly ["low", "medium", "high"];
+        readonly defaultModel: "grok-4.6";
+        readonly defaultReasoningEffort: "low";
+        readonly toolIds: readonly ["run_terminal_cmd", "read_file", "grep", "list_dir", "search_tool", "use_tool"];
+        readonly visibleTools: readonly ["grep", "list_dir", "read_file", "run_terminal_command", "search_tool", "use_tool"];
+        readonly maxTurns: 48;
+        readonly systemPromptSha256: "2c31c0085a54a4efbf9c0cf0b8124c56e47f38691b7f0c7fa233a74abaa8ddf8";
+        readonly configSha256: {
+            readonly "grok-4.6": {
+                readonly low: "ab58499ac32678097c146479896f2b8a8e2b0e39aea22dc0a60b6227e370538e";
+                readonly medium: "df1a5cc84346e7f6bf6090492fbd19faaefb42953e3bb2e8c6cbc0572242403f";
+                readonly high: "65b0212564fb74042b1503d293fb8d3620276033264c0efade2a539ca09218e3";
+            };
+            readonly "grok-4.5": {
+                readonly low: "8247127c3625ff7c5d8d527a53596b89ec6557a821ac46cfd00bd122b90daff6";
+                readonly medium: "59288cee61297bb8c002097061a48f77b09d310754187a253ee089f7172a9155";
+                readonly high: "c63c3387ce92d94ec3f690abfe98942afcd7c9e17ff84816bbe751f340ab251f";
+            };
+            readonly "grok-build": {
+                readonly low: "fb343f2809903f26d21681470943235031f946e99085542fd89555eb7782cbb5";
+                readonly medium: "8a587ef75c90eab70d19b24583e60051d6fba9d90c558839fdbb15588b4cc656";
+                readonly high: "a23724e00d670caee185ba7690d2daa868173e53905cf446f5329666f01ab4e3";
+            };
+        };
+        readonly home: {
+            readonly directory: {
+                readonly uid: 0;
+                readonly group: "worker";
+                readonly mode: 1017;
+            };
+            readonly sessionsDirectory: {
+                readonly relativePath: "sessions";
+                readonly uid: 0;
+                readonly group: "worker";
+                readonly mode: 1017;
+            };
+            readonly readOnlyFiles: {
+                readonly names: readonly ["config.toml", "managed_config.toml", "requirements.toml", "sandbox.toml", "trusted_folders.toml"];
+                readonly uid: 0;
+                readonly gid: 0;
+                readonly mode: 292;
+            };
+            readonly sandboxEvents: {
+                readonly relativePath: "sessions/sandbox-events.jsonl";
+                readonly owner: "worker";
+                readonly group: "broker";
+                readonly mode: 416;
+            };
+            readonly privateTmp: {
+                readonly relativeToWorkerHome: "tmp";
+                readonly owner: "worker";
+                readonly mode: 448;
+            };
+            readonly sharedTmp: {
+                readonly paths: readonly ["/tmp", "/var/tmp"];
+                readonly uid: 0;
+                readonly maxGroupExclusive: 2200;
+                readonly otherMode: 4;
+                readonly mode: 1020;
+            };
+            readonly organizationRuntimeHome: {
+                readonly owner: "organization";
+                readonly group: "worker";
+                readonly mode: 456;
+            };
+            readonly spillDirectory: {
+                readonly relativeToRuntimeHome: "tool-output";
+                readonly owner: "organization";
+                readonly group: "worker";
+                readonly mode: 1512;
+                readonly fileMode: 416;
+            };
+        };
+    };
+    readonly bounds: {
+        readonly promptBytes: 65536;
+        readonly capabilityBytes: 4096;
+        readonly capabilityBundleBytes: 8196;
+        readonly outputBytes: 262144;
+    };
+    readonly controlProtocolVersion: "noopolis.daimon.engine-broker.v2";
+    readonly turnRecordVersions: readonly ["noopolis.daimon.engine-broker-turn.v1", "noopolis.daimon.engine-broker-turn.v2"];
+    readonly serviceConfigVersions: readonly ["noopolis.daimon.engine-broker-service.v1", "noopolis.daimon.engine-broker-service.v2"];
+    readonly turnLimits: {
+        readonly keys: readonly ["maxRequests", "maxTokens", "timeoutMs"];
+        readonly v1Defaults: {
+            readonly maxRequests: 32;
+            readonly maxTokens: 300000;
+            readonly timeoutMs: 240000;
+        };
+        readonly bounds: {
+            readonly maxRequests: readonly [1, 48];
+            readonly maxTokens: readonly [1, 10000000];
+            readonly timeoutMs: readonly [1000, 3600000];
+        };
+        readonly limitReasons: readonly ["tokens", "requests", "timeout", "none"];
+        readonly wakeMayOnlyLower: true;
+        readonly tokenCeilingOvershoot: "at-most-one-request";
+        readonly maxInFlightRequests: 1;
+        readonly requestUsageMaxTokens: 500000;
+        readonly missingUsageEstimate: {
+            readonly inputBytesPerToken: 2;
+            readonly outputTokens: 4096;
+        };
+    };
+    readonly wakeLimitEnvironment: {
+        readonly timeoutMs: "DAIMON_ENGINE_WAKE_TIMEOUT_MS";
+        readonly maxTokens: "DAIMON_ENGINE_WAKE_TOKEN_CEILING";
+    };
+    readonly projectionVersion: "noopolis.daimon.grok-broker-projection.v1";
+    readonly slotPreflightVersion: "noopolis.daimon.grok-slot-preflight.v2";
+    readonly inferenceGrants: {
+        readonly requestKinds: readonly ["request_inference_grant", "release_inference_grant"];
+        readonly purposes: readonly ["judge", "optimizer"];
+        readonly tokenPrefix: "inference_";
+        readonly ttlMs: 600000;
+        readonly limits: {
+            readonly maxRequests: 64;
+            readonly maxTokens: 2000000;
+        };
+        readonly maxLiveGrants: 8;
+        readonly maxInFlightRequestsPerGrant: 1;
+        readonly bodyMembers: readonly ["messages", "model", "reasoning_effort", "response_format", "stream", "stream_options"];
+        readonly messageRoles: readonly ["system", "user", "assistant"];
+        readonly failureCodes: readonly ["auth_stale", "grant_limit", "invalid_request", "unavailable"];
+        readonly ledgerVersion: "noopolis.daimon.inference-usage.v1";
+        readonly ledgerDedupeKey: readonly ["grant", "request"];
+        readonly client: {
+            readonly modelId: "daimon-inference-grok";
+            readonly envKey: "DAIMON_INFERENCE_GRANT";
+            readonly configSha256: {
+                readonly "grok-4.6": {
+                    readonly low: "79314d039f787e4ebfec7dacf57adc969086b948f564dec008f0ed6367e6062f";
+                    readonly medium: "6f538de0547c0c4e6a3f04ae08595ceadadabb06b75f6b6ee4c428744bb95cd8";
+                    readonly high: "5652656effa82f0c4f09cf8226b16e6140332a5a358b571194bb5563312367ac";
+                };
+                readonly "grok-4.5": {
+                    readonly low: "a07f7436f1268bb399ec233c65d3b3d8fb99a11a1f175f8da1ca133c9367bc74";
+                    readonly medium: "1f4c0d4dad1f3b09419b5739db6423a09e0049abc091594c64123a75dd53dfb9";
+                    readonly high: "ffbc33728b821e9854fbc7c93601e599225da421ecfd6ebf10d314afcc28d6f2";
+                };
+                readonly "grok-build": {
+                    readonly low: "ca15c6a562a008227d39c51d3a3a83715663089b3784e8b46debb1fb67b3c4a1";
+                    readonly medium: "01783fb6beadcf6f8486fff0836820ad43fab5662b812a907fe9cfdb83e9804d";
+                    readonly high: "98d16f2b7d12f4eb540d625c853e51d227933e204923e43e8b9b4176f10aca2c";
+                };
+            };
+        };
+    };
+    readonly artifacts: {
+        readonly sourceSha256: "dd39aacfece496cc6528f6acdb4f1066a848a0fb5b0961f5c70b0ba00440dc24";
+        readonly x64Sha256: "67e3624d3198e9c59e1ffafa4eca7c895dfe265d5b8bb0614cb547b68b8b93a7";
+        readonly arm64Sha256: "c07d22225ff968bc289e5ddf0981cdd5d64040eee6e3ea45da7d03e1439dea98";
+    };
+};
+/**
+ * Where the Daimon broker writes its per-turn usage ledger, and what this
+ * compiler provisions. Deliberately kept out of `DAIMON_GROK_ENGINE_BROKER`:
+ * that object's canonical bytes are digest-pinned and attested against the
+ * runtime image at compile time, so a new key there would make every pinned
+ * image fail to attest. Mirrors `TURN_USAGE_LEDGER` in
+ * `daimon/src/runtime/turnUsageLedger.ts`.
+ */
+export declare const DAIMON_GROK_TURN_USAGE_LEDGER: {
+    readonly version: "noopolis.daimon.turn-usage.v1";
+    readonly directoryPath: "/var/lib/spawnfile/daimon/usage";
+    readonly filePath: "/var/lib/spawnfile/daimon/usage/usage.jsonl";
+    readonly rotatedFilePath: "/var/lib/spawnfile/daimon/usage/usage.jsonl.1";
+    readonly directoryMode: 488;
+    readonly fileMode: 416;
+    /**
+     * Mirrors `TURN_USAGE_ROTATE_BYTES` in `daimon/src/runtime/turnUsageLedger.ts`
+     * (Spawnfile must not import from `daimon/`, so this is the Spawnfile-side
+     * copy of the same agreed number). It is a LOWER bound on the size of a
+     * rotated generation, not an upper one: the broker rotates on the append
+     * *after* the file reaches this size, so `usage.jsonl.1` is always at least
+     * this large and the line that crossed the bound overshoots it. Anything
+     * sizing a read of one generation must therefore leave headroom above this
+     * number rather than matching it (see
+     * `DEFAULT_DOCKER_PROBE_MAX_BUFFER_BYTES`).
+     */
+    readonly rotateBytes: number;
+};
+export declare const DAIMON_AGY_SUBSCRIPTION_REALM: {
+    readonly directoryMode: 448;
+    readonly durableMountPath: "/var/lib/spawnfile/daimon/agy-subscription-realm";
+    readonly fileMode: 384;
+    readonly maxUnlockBytes: 4096;
+    readonly unlockMountPath: "/var/lib/spawnfile/daimon/agy-unlock-secret";
+    readonly unlockSourceSlot: "agy-unlock-secret";
+};
+export type DaimonEngine = typeof DAIMON_ENGINE_KINDS[number];
+export type DaimonPortableEngine = keyof typeof DAIMON_ENGINE_CREDENTIALS;
+type DaimonCredentialMaterial = (typeof DAIMON_ENGINE_CREDENTIALS)[DaimonPortableEngine];
+export interface DaimonContractManifest {
+    readonly agySubscriptionRealm: typeof DAIMON_AGY_SUBSCRIPTION_REALM;
+    readonly consumedConfigFields: readonly string[];
+    readonly engineCredentialMaterial: Readonly<Record<DaimonPortableEngine, DaimonCredentialMaterial>>;
+    readonly grokSubscriptionRealm: typeof DAIMON_GROK_SUBSCRIPTION_REALM;
+    readonly grokEngineBroker: typeof DAIMON_GROK_ENGINE_BROKER;
+    readonly supportedEngineKinds: readonly DaimonEngine[];
+    readonly wakeAcceptanceTypes: readonly ["manual", "message", "schedule", "external"];
+    readonly deliverySemantics: Readonly<{
+        activeDeliveryIdempotency: "unbounded-until-terminal";
+        terminalReceiptHorizon: 2_048;
+        recovery: "at-least-once-with-stable-wake-id";
+        concurrentSameAgentTurns: false;
+        externalEffectsExactlyOnce: false;
+    }>;
+    readonly version: typeof DAIMON_CONTRACT_MANIFEST_VERSION;
+}
+export interface VerifiedDaimonContractManifest {
+    readonly digest: `sha256:${string}`;
+    readonly manifest: DaimonContractManifest;
+}
+export declare const parseDaimonContractManifest: (raw: unknown) => DaimonContractManifest;
+export declare const assertDaimonRuntimeHome: (candidate: string) => string;
+export declare const readVerifiedDaimonContractManifest: (runtimeRoot: string) => Promise<VerifiedDaimonContractManifest>;
+export {};

package/dist/runtime/daimon/contractManifest.js

@@ -0,0 +1,319 @@
+import { createHash } from "node:crypto";
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { SpawnfileError } from "../../shared/index.js";
+export const DAIMON_CONTRACT_MANIFEST_VERSION = "noopolis.daimon.runtime-contract-manifest.v3";
+export const DAIMON_CONTRACT_MANIFEST_SHA256 = "sha256:c672ed47e4a01a75f1482ea6e4b6ecb28205aab344741a10cad8783f5501b6c4";
+export const DAIMON_CONTRACT_MANIFEST_FILE = "contract-manifest.json";
+export const DAIMON_CONTRACT_MANIFEST_DIGEST_FILE = "contract-manifest.sha256";
+export const DAIMON_RUNTIME_HOME_ROOT = "/var/lib/spawnfile/instances/daimon";
+export const DAIMON_ENGINE_KINDS = ["agy", "codex", "grok"];
+export const DAIMON_ORGANIZATION_RUNTIME_CONFIG_VERSIONS = ["noopolis.daimon.organization-runtime.v1", "noopolis.daimon.organization-runtime.v2"];
+export const DAIMON_ENGINE_CREDENTIALS = {
+    codex: {
+        destinationRelativePath: ".codex/auth.json",
+        directoryMode: 0o700,
+        fileMode: 0o600,
+        sourceRelativePath: ".daimon-inbound/codex-auth",
+        sourceSlot: "codex-auth"
+    },
+};
+export const DAIMON_GROK_SUBSCRIPTION_REALM = {
+    agentCredentialRelativePath: ".grok/auth.json",
+    bootstrapMountPath: "/var/lib/spawnfile/daimon/grok-bootstrap-auth",
+    bootstrapSourceSlot: "grok-auth",
+    directoryMode: 0o700,
+    durableMountPath: "/var/lib/spawnfile/daimon/grok-subscription-realm",
+    fileMode: 0o600,
+    maxCredentialBytes: 64 * 1024
+};
+export const DAIMON_GROK_BROKER_MODELS = ["grok-4.6", "grok-4.5", "grok-build"];
+export const DAIMON_GROK_BROKER_REASONING_EFFORTS = ["low", "medium", "high"];
+/**
+ * Byte mirror of Daimon's `GROK_ENGINE_BROKER` (daimon
+ * `src/contracts/runtimeContractManifest.ts`), attested key-for-key against the
+ * vendored `contract-manifest.json` by `parseDaimonContractManifest`.
+ */
+export const DAIMON_GROK_ENGINE_BROKER = {
+    nativeAbiVersion: 2,
+    nativeExecutablePath: "/opt/daimon/bin/daimon-engine-broker",
+    grokExecutablePath: "/usr/local/bin/grok",
+    registrationPath: "/etc/daimon-engine-broker/registrations.bin",
+    credentialHomePath: "/var/lib/spawnfile/daimon/grok-subscription-realm",
+    turnStorePath: "/var/lib/spawnfile/daimon/grok-subscription-realm/turns",
+    controlSocketPath: "/run/daimon-engine-broker/control.sock",
+    backendSocketPath: "/run/daimon-engine-broker/backend.sock",
+    launcherSocketPath: "/run/daimon-engine-broker/launcher.sock",
+    serviceConfigPath: "/etc/daimon-engine-broker/service.json",
+    providerProxy: { host: "127.0.0.1", port: 43_123 },
+    mcpFacade: { host: "127.0.0.1", port: 43_124, path: "/mcp" },
+    identities: { organizationUid: 2_000, brokerUid: 2_100, firstWorkerUid: 2_200 },
+    grokCliVersion: "1.0.34",
+    grokCliBuild: "3736acbc8658",
+    grokCliArtifacts: {
+        arm64: { url: "https://storage.googleapis.com/grok-build-public-artifacts/cli/grok-1.0.34-linux-aarch64", sha256: "39ab87666877d64ef3a40aa60fbe0c3b6a6acd7001b78fe60e2c76bb6cfc4a94", bytes: 136_090_504 },
+        x64: { url: "https://storage.googleapis.com/grok-build-public-artifacts/cli/grok-1.0.34-linux-x86_64", sha256: "be5905e107d2b8b5f3c142d21ecfe4c8fd32a913d2fd551b788707930c4dc80d", bytes: 163_035_648 }
+    },
+    worker: {
+        modelId: "daimon-broker-grok",
+        models: DAIMON_GROK_BROKER_MODELS,
+        reasoningEfforts: DAIMON_GROK_BROKER_REASONING_EFFORTS,
+        defaultModel: "grok-4.6",
+        defaultReasoningEffort: "low",
+        toolIds: ["run_terminal_cmd", "read_file", "grep", "list_dir", "search_tool", "use_tool"],
+        visibleTools: ["grep", "list_dir", "read_file", "run_terminal_command", "search_tool", "use_tool"],
+        maxTurns: 48,
+        systemPromptSha256: "2c31c0085a54a4efbf9c0cf0b8124c56e47f38691b7f0c7fa233a74abaa8ddf8",
+        configSha256: {
+            "grok-4.6": { low: "ab58499ac32678097c146479896f2b8a8e2b0e39aea22dc0a60b6227e370538e", medium: "df1a5cc84346e7f6bf6090492fbd19faaefb42953e3bb2e8c6cbc0572242403f", high: "65b0212564fb74042b1503d293fb8d3620276033264c0efade2a539ca09218e3" },
+            "grok-4.5": { low: "8247127c3625ff7c5d8d527a53596b89ec6557a821ac46cfd00bd122b90daff6", medium: "59288cee61297bb8c002097061a48f77b09d310754187a253ee089f7172a9155", high: "c63c3387ce92d94ec3f690abfe98942afcd7c9e17ff84816bbe751f340ab251f" },
+            "grok-build": { low: "fb343f2809903f26d21681470943235031f946e99085542fd89555eb7782cbb5", medium: "8a587ef75c90eab70d19b24583e60051d6fba9d90c558839fdbb15588b4cc656", high: "a23724e00d670caee185ba7690d2daa868173e53905cf446f5329666f01ab4e3" }
+        },
+        home: {
+            directory: { uid: 0, group: "worker", mode: 0o1771 },
+            sessionsDirectory: { relativePath: "sessions", uid: 0, group: "worker", mode: 0o1771 },
+            readOnlyFiles: { names: ["config.toml", "managed_config.toml", "requirements.toml", "sandbox.toml", "trusted_folders.toml"], uid: 0, gid: 0, mode: 0o444 },
+            sandboxEvents: { relativePath: "sessions/sandbox-events.jsonl", owner: "worker", group: "broker", mode: 0o640 },
+            privateTmp: { relativeToWorkerHome: "tmp", owner: "worker", mode: 0o700 },
+            sharedTmp: { paths: ["/tmp", "/var/tmp"], uid: 0, maxGroupExclusive: 2_200, otherMode: 0o4, mode: 0o1774 },
+            organizationRuntimeHome: { owner: "organization", group: "worker", mode: 0o710 },
+            spillDirectory: { relativeToRuntimeHome: "tool-output", owner: "organization", group: "worker", mode: 0o2750, fileMode: 0o640 }
+        }
+    },
+    bounds: { promptBytes: 65_536, capabilityBytes: 4_096, capabilityBundleBytes: 8_196, outputBytes: 262_144 },
+    controlProtocolVersion: "noopolis.daimon.engine-broker.v2",
+    turnRecordVersions: ["noopolis.daimon.engine-broker-turn.v1", "noopolis.daimon.engine-broker-turn.v2"],
+    serviceConfigVersions: ["noopolis.daimon.engine-broker-service.v1", "noopolis.daimon.engine-broker-service.v2"],
+    turnLimits: {
+        keys: ["maxRequests", "maxTokens", "timeoutMs"],
+        v1Defaults: { maxRequests: 32, maxTokens: 300_000, timeoutMs: 240_000 },
+        bounds: { maxRequests: [1, 48], maxTokens: [1, 10_000_000], timeoutMs: [1_000, 3_600_000] },
+        limitReasons: ["tokens", "requests", "timeout", "none"],
+        wakeMayOnlyLower: true,
+        tokenCeilingOvershoot: "at-most-one-request",
+        maxInFlightRequests: 1,
+        requestUsageMaxTokens: 500_000,
+        missingUsageEstimate: { inputBytesPerToken: 2, outputTokens: 4_096 }
+    },
+    wakeLimitEnvironment: { timeoutMs: "DAIMON_ENGINE_WAKE_TIMEOUT_MS", maxTokens: "DAIMON_ENGINE_WAKE_TOKEN_CEILING" },
+    projectionVersion: "noopolis.daimon.grok-broker-projection.v1",
+    slotPreflightVersion: "noopolis.daimon.grok-slot-preflight.v2",
+    inferenceGrants: {
+        requestKinds: ["request_inference_grant", "release_inference_grant"],
+        purposes: ["judge", "optimizer"],
+        tokenPrefix: "inference_",
+        ttlMs: 600_000,
+        limits: { maxRequests: 64, maxTokens: 2_000_000 },
+        maxLiveGrants: 8,
+        maxInFlightRequestsPerGrant: 1,
+        bodyMembers: ["messages", "model", "reasoning_effort", "response_format", "stream", "stream_options"],
+        messageRoles: ["system", "user", "assistant"],
+        failureCodes: ["auth_stale", "grant_limit", "invalid_request", "unavailable"],
+        ledgerVersion: "noopolis.daimon.inference-usage.v1",
+        ledgerDedupeKey: ["grant", "request"],
+        client: {
+            modelId: "daimon-inference-grok",
+            envKey: "DAIMON_INFERENCE_GRANT",
+            configSha256: {
+                "grok-4.6": { low: "79314d039f787e4ebfec7dacf57adc969086b948f564dec008f0ed6367e6062f", medium: "6f538de0547c0c4e6a3f04ae08595ceadadabb06b75f6b6ee4c428744bb95cd8", high: "5652656effa82f0c4f09cf8226b16e6140332a5a358b571194bb5563312367ac" },
+                "grok-4.5": { low: "a07f7436f1268bb399ec233c65d3b3d8fb99a11a1f175f8da1ca133c9367bc74", medium: "1f4c0d4dad1f3b09419b5739db6423a09e0049abc091594c64123a75dd53dfb9", high: "ffbc33728b821e9854fbc7c93601e599225da421ecfd6ebf10d314afcc28d6f2" },
+                "grok-build": { low: "ca15c6a562a008227d39c51d3a3a83715663089b3784e8b46debb1fb67b3c4a1", medium: "01783fb6beadcf6f8486fff0836820ad43fab5662b812a907fe9cfdb83e9804d", high: "98d16f2b7d12f4eb540d625c853e51d227933e204923e43e8b9b4176f10aca2c" }
+            }
+        }
+    },
+    artifacts: {
+        sourceSha256: "dd39aacfece496cc6528f6acdb4f1066a848a0fb5b0961f5c70b0ba00440dc24",
+        x64Sha256: "67e3624d3198e9c59e1ffafa4eca7c895dfe265d5b8bb0614cb547b68b8b93a7",
+        arm64Sha256: "c07d22225ff968bc289e5ddf0981cdd5d64040eee6e3ea45da7d03e1439dea98"
+    }
+};
+/**
+ * Where the Daimon broker writes its per-turn usage ledger, and what this
+ * compiler provisions. Deliberately kept out of `DAIMON_GROK_ENGINE_BROKER`:
+ * that object's canonical bytes are digest-pinned and attested against the
+ * runtime image at compile time, so a new key there would make every pinned
+ * image fail to attest. Mirrors `TURN_USAGE_LEDGER` in
+ * `daimon/src/runtime/turnUsageLedger.ts`.
+ */
+export const DAIMON_GROK_TURN_USAGE_LEDGER = {
+    version: "noopolis.daimon.turn-usage.v1",
+    directoryPath: "/var/lib/spawnfile/daimon/usage",
+    filePath: "/var/lib/spawnfile/daimon/usage/usage.jsonl",
+    rotatedFilePath: "/var/lib/spawnfile/daimon/usage/usage.jsonl.1",
+    directoryMode: 0o750,
+    fileMode: 0o640,
+    /**
+     * Mirrors `TURN_USAGE_ROTATE_BYTES` in `daimon/src/runtime/turnUsageLedger.ts`
+     * (Spawnfile must not import from `daimon/`, so this is the Spawnfile-side
+     * copy of the same agreed number). It is a LOWER bound on the size of a
+     * rotated generation, not an upper one: the broker rotates on the append
+     * *after* the file reaches this size, so `usage.jsonl.1` is always at least
+     * this large and the line that crossed the bound overshoots it. Anything
+     * sizing a read of one generation must therefore leave headroom above this
+     * number rather than matching it (see
+     * `DEFAULT_DOCKER_PROBE_MAX_BUFFER_BYTES`).
+     */
+    rotateBytes: 64 * 1024 * 1024
+};
+export const DAIMON_AGY_SUBSCRIPTION_REALM = {
+    directoryMode: 0o700,
+    durableMountPath: "/var/lib/spawnfile/daimon/agy-subscription-realm",
+    fileMode: 0o600,
+    maxUnlockBytes: 4_096,
+    unlockMountPath: "/var/lib/spawnfile/daimon/agy-unlock-secret",
+    unlockSourceSlot: "agy-unlock-secret"
+};
+const SHA256 = /^[a-f0-9]{64}$/u;
+const expectedConfigFields = [
+    "version", "host.bindHost", "host.port", "host.controlTokenEnv", "agents[].id",
+    "agents[].name", "agents[].instructions", "agents[].workspacePath",
+    "agents[].runtimeHomePath", "agents[].engine.kind", "agents[].engine.model",
+    "agents[].engine.reasoningEffort", "agents[].engine.codexSandbox", "agents[].schedule.kind",
+    "agents[].schedule.interval_ms", "agents[].schedule.cron",
+    "agents[].schedule.timezone", "agents[].schedule.prompt",
+    "agents[].schedule.jitter_seconds",
+    "agents[].mcp", "agents[].moltnet", "agents[].memory", "agents[].attention"
+];
+const exactKeys = (value, keys) => Object.keys(value).sort().join("\0") === [...keys].sort().join("\0");
+const fail = (message) => {
+    throw new SpawnfileError("runtime_error", `Daimon runtime contract manifest ${message}`);
+};
+const asRecord = (value, label) => {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        fail(`${label} must be an object`);
+    return value;
+};
+const canonicalJson = (value) => {
+    if (value === null || typeof value === "boolean" || typeof value === "number" || typeof value === "string") {
+        return JSON.stringify(value);
+    }
+    if (Array.isArray(value))
+        return `[${value.map(canonicalJson).join(",")}]`;
+    const record = asRecord(value, "JSON value");
+    return `{${Object.keys(record).sort().map((key) => `${JSON.stringify(key)}:${canonicalJson(record[key])}`).join(",")}}`;
+};
+const matchesCredentialMaterial = (value, expected) => {
+    const material = asRecord(value, "engine credential material");
+    return exactKeys(material, ["destinationRelativePath", "directoryMode", "fileMode", "sourceRelativePath", "sourceSlot"])
+        && material.destinationRelativePath === expected.destinationRelativePath
+        && material.directoryMode === expected.directoryMode
+        && material.fileMode === expected.fileMode
+        && material.sourceRelativePath === expected.sourceRelativePath
+        && material.sourceSlot === expected.sourceSlot;
+};
+const matchesAgyRealm = (value) => {
+    const realm = asRecord(value, "AGY subscription realm");
+    return exactKeys(realm, [
+        "directoryMode", "durableMountPath", "fileMode", "maxUnlockBytes",
+        "unlockMountPath", "unlockSourceSlot"
+    ])
+        && Object.entries(DAIMON_AGY_SUBSCRIPTION_REALM)
+            .every(([name, expected]) => realm[name] === expected);
+};
+const matchesGrokRealm = (value) => {
+    const realm = asRecord(value, "Grok subscription realm");
+    return exactKeys(realm, [
+        "agentCredentialRelativePath", "bootstrapMountPath", "bootstrapSourceSlot",
+        "directoryMode", "durableMountPath", "fileMode", "maxCredentialBytes"
+    ]) && Object.entries(DAIMON_GROK_SUBSCRIPTION_REALM)
+        .every(([name, expected]) => realm[name] === expected);
+};
+const matchesGrokEngineBroker = (value) => {
+    const broker = asRecord(value, "Grok engine broker");
+    if (!exactKeys(broker, Object.keys(DAIMON_GROK_ENGINE_BROKER)))
+        return false;
+    return canonicalJson(broker) === canonicalJson(DAIMON_GROK_ENGINE_BROKER);
+};
+export const parseDaimonContractManifest = (raw) => {
+    const root = asRecord(raw, "root");
+    if (root.version !== DAIMON_CONTRACT_MANIFEST_VERSION ||
+        !Array.isArray(root.supportedEngineKinds) ||
+        root.supportedEngineKinds.join("\0") !== "agy\0codex\0grok" ||
+        !Array.isArray(root.consumedConfigFields) ||
+        root.consumedConfigFields.join("\0") !== expectedConfigFields.join("\0") ||
+        !Array.isArray(root.wakeAcceptanceTypes) ||
+        root.wakeAcceptanceTypes.join("\0") !== "manual\0message\0schedule\0external")
+        return fail("has an unsupported version or configuration contract");
+    const v2 = asRecord(root.organizationRuntimeConfigV2Schema, "organizationRuntimeConfigV2Schema");
+    const v2Properties = asRecord(v2.properties, "organizationRuntimeConfigV2Schema.properties");
+    const v2Agents = asRecord(v2Properties.agents, "organizationRuntimeConfigV2Schema.properties.agents");
+    const v2Agent = asRecord(v2Agents.items, "organizationRuntimeConfigV2Schema.properties.agents.items");
+    const v2AgentProperties = asRecord(v2Agent.properties, "organizationRuntimeConfigV2Schema.properties.agents.items.properties");
+    const schedule = asRecord(v2AgentProperties.schedule, "organizationRuntimeConfigV2Schema schedule");
+    if (v2.$id !== "noopolis.daimon.organization-runtime.v2" || !Array.isArray(schedule.oneOf) || schedule.oneOf.length !== 3)
+        return fail("does not attest the organization runtime v2 schedule contract");
+    const semantics = asRecord(root.deliverySemantics, "deliverySemantics");
+    if (!exactKeys(semantics, ["activeDeliveryIdempotency", "terminalReceiptHorizon", "recovery", "concurrentSameAgentTurns", "externalEffectsExactlyOnce"]) ||
+        semantics.activeDeliveryIdempotency !== "unbounded-until-terminal" || semantics.terminalReceiptHorizon !== 2_048 ||
+        semantics.recovery !== "at-least-once-with-stable-wake-id" || semantics.concurrentSameAgentTurns !== false || semantics.externalEffectsExactlyOnce !== false)
+        return fail("has unsupported delivery semantics");
+    const materials = asRecord(root.engineCredentialMaterial, "engineCredentialMaterial");
+    if (!exactKeys(materials, ["codex"]))
+        return fail("has unsupported credential material");
+    for (const engine of ["codex"]) {
+        if (!matchesCredentialMaterial(materials[engine], DAIMON_ENGINE_CREDENTIALS[engine])) {
+            return fail(`has unsafe ${engine} credential material`);
+        }
+    }
+    if (!matchesAgyRealm(root.agySubscriptionRealm)) {
+        return fail("has unsafe AGY subscription realm material");
+    }
+    if (!matchesGrokRealm(root.grokSubscriptionRealm)) {
+        return fail("has unsafe Grok subscription realm material");
+    }
+    if (!matchesGrokEngineBroker(root.grokEngineBroker)) {
+        return fail("has unsafe Grok engine broker material");
+    }
+    return Object.freeze({
+        agySubscriptionRealm: Object.freeze({ ...DAIMON_AGY_SUBSCRIPTION_REALM }),
+        consumedConfigFields: Object.freeze([...expectedConfigFields]),
+        engineCredentialMaterial: Object.freeze({ ...DAIMON_ENGINE_CREDENTIALS }),
+        grokSubscriptionRealm: Object.freeze({ ...DAIMON_GROK_SUBSCRIPTION_REALM }),
+        grokEngineBroker: Object.freeze({ ...DAIMON_GROK_ENGINE_BROKER }),
+        supportedEngineKinds: Object.freeze([...DAIMON_ENGINE_KINDS]),
+        wakeAcceptanceTypes: Object.freeze(["manual", "message", "schedule", "external"]),
+        deliverySemantics: Object.freeze({
+            activeDeliveryIdempotency: "unbounded-until-terminal", terminalReceiptHorizon: 2_048,
+            recovery: "at-least-once-with-stable-wake-id", concurrentSameAgentTurns: false, externalEffectsExactlyOnce: false
+        }),
+        version: DAIMON_CONTRACT_MANIFEST_VERSION
+    });
+};
+export const assertDaimonRuntimeHome = (candidate) => {
+    if (!path.posix.isAbsolute(candidate))
+        fail("runtime home must be an absolute POSIX path");
+    const normalized = path.posix.normalize(candidate);
+    const relative = path.posix.relative(DAIMON_RUNTIME_HOME_ROOT, normalized);
+    if (!relative || relative === ".." || relative.startsWith("../") || path.posix.isAbsolute(relative)) {
+        fail("runtime home escapes the caller-owned Daimon root");
+    }
+    return normalized;
+};
+export const readVerifiedDaimonContractManifest = async (runtimeRoot) => {
+    const manifestPath = path.join(runtimeRoot, DAIMON_CONTRACT_MANIFEST_FILE);
+    const digestPath = path.join(runtimeRoot, DAIMON_CONTRACT_MANIFEST_DIGEST_FILE);
+    let bytes;
+    let sidecar;
+    try {
+        [bytes, sidecar] = await Promise.all([readFile(manifestPath), readFile(digestPath, "utf8")]);
+    }
+    catch {
+        return fail("is missing its packaged bytes or digest sidecar");
+    }
+    const source = bytes.toString("utf8");
+    if (!source.endsWith("\n") || source.includes("\r"))
+        return fail("is not canonical UTF-8 JSON");
+    let parsed;
+    try {
+        parsed = JSON.parse(source);
+    }
+    catch {
+        return fail("is not valid JSON");
+    }
+    if (`${canonicalJson(parsed)}\n` !== source)
+        return fail("is not canonical JSON");
+    const digest = createHash("sha256").update(bytes).digest("hex");
+    if (sidecar !== `sha256:${digest}\n` || !SHA256.test(digest))
+        return fail("digest sidecar does not match its bytes");
+    return Object.freeze({ digest: `sha256:${digest}`, manifest: parseDaimonContractManifest(parsed) });
+};

package/dist/runtime/daimon/grokModel.d.ts

@@ -0,0 +1,19 @@
+import type { ResolvedAgentNode } from "../../compiler/types.js";
+import { type DaimonGrokBrokerModel, type DaimonGrokBrokerReasoningEffort } from "./contractManifest.js";
+export interface DaimonGrokModel {
+    model: DaimonGrokBrokerModel;
+    reasoningEffort: DaimonGrokBrokerReasoningEffort;
+}
+/**
+ * The declared model of one brokered Daimon Grok agent.
+ *
+ * Every Grok agent runs through Daimon's engine broker, whose worker
+ * `config.toml` bytes are pinned per model x effort and whose provider proxy
+ * refuses any request body carrying another pair. Nothing may be inherited: Grok
+ * 1.0.34 silently drops an effort a model does not declare and its catalog
+ * default for `grok-4.6` is `high`, so the declaration is required in full —
+ * `execution.model.primary` with `provider: xai`, a name from Daimon's closed
+ * list, a target-level `auth.method: grok`, and `reasoning_effort` — and there
+ * is exactly one model (no fallback, no legacy model-level auth).
+ */
+export declare const resolveDaimonGrokModel: (node: ResolvedAgentNode) => DaimonGrokModel;