@kya-os/cli 2.0.0 → 2.0.2

package/node_modules/@kya-os/contracts/dist/workbench/cache.d.ts

@@ -0,0 +1,461 @@
+import { z } from "zod";
+/** Version of the reviewed policy catalog, not a provider capability guarantee. */
+export declare const CACHE_POLICY_VERSION: "2026-09-24.1";
+/** Display preference only. No inference, warming, or provider settings are changed. */
+export declare const CacheAwarenessConfigSchema: z.ZodObject<{
+    enabled: z.ZodOptional<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    enabled?: boolean | undefined;
+}, {
+    enabled?: boolean | undefined;
+}>;
+export type CacheAwarenessConfig = z.infer<typeof CacheAwarenessConfigSchema>;
+export declare const CacheScopeSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    actorId: z.ZodString;
+    /** Opaque prefix/block/resource identity; never include prompt content or credentials. */
+    blockId: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    sessionId: string;
+    actorId: string;
+    blockId: string;
+}, {
+    sessionId: string;
+    actorId: string;
+    blockId: string;
+}>;
+export type CacheScope = z.infer<typeof CacheScopeSchema>;
+export declare const CacheContextSchema: z.ZodObject<{
+    harness: z.ZodEnum<["claude", "codex", "gemini", "opencode", "goose", "hermes", "openclaw", "custom"]>;
+    harnessVersion: z.ZodOptional<z.ZodString>;
+    provider: z.ZodOptional<z.ZodString>;
+    endpoint: z.ZodEnum<["anthropic_api", "openai_api", "chatgpt", "gemini_developer", "vertex", "bedrock", "openrouter", "code_assist", "custom", "unknown"]>;
+    authMode: z.ZodEnum<["api_key", "subscription_included", "usage_credits", "cloud", "oauth", "unknown"]>;
+    model: z.ZodOptional<z.ZodString>;
+    requestClass: z.ZodEnum<["main", "subagent", "auxiliary"]>;
+    headless: z.ZodOptional<z.ZodBoolean>;
+    /** Set by the trusted adapter after resolving route/config, never copied from task input. */
+    metadataVerified: z.ZodBoolean;
+}, "strict", z.ZodTypeAny, {
+    harness: "custom" | "openclaw" | "claude" | "codex" | "gemini" | "opencode" | "goose" | "hermes";
+    endpoint: "unknown" | "custom" | "anthropic_api" | "openai_api" | "chatgpt" | "gemini_developer" | "vertex" | "bedrock" | "openrouter" | "code_assist";
+    authMode: "unknown" | "oauth" | "api_key" | "subscription_included" | "usage_credits" | "cloud";
+    requestClass: "main" | "subagent" | "auxiliary";
+    metadataVerified: boolean;
+    provider?: string | undefined;
+    harnessVersion?: string | undefined;
+    model?: string | undefined;
+    headless?: boolean | undefined;
+}, {
+    harness: "custom" | "openclaw" | "claude" | "codex" | "gemini" | "opencode" | "goose" | "hermes";
+    endpoint: "unknown" | "custom" | "anthropic_api" | "openai_api" | "chatgpt" | "gemini_developer" | "vertex" | "bedrock" | "openrouter" | "code_assist";
+    authMode: "unknown" | "oauth" | "api_key" | "subscription_included" | "usage_credits" | "cloud";
+    requestClass: "main" | "subagent" | "auxiliary";
+    metadataVerified: boolean;
+    provider?: string | undefined;
+    harnessVersion?: string | undefined;
+    model?: string | undefined;
+    headless?: boolean | undefined;
+}>;
+export type CacheContext = z.infer<typeof CacheContextSchema>;
+export declare const CachePolicyMetadataSchema: z.ZodObject<{
+    effectiveTtlSeconds: z.ZodOptional<z.ZodNumber>;
+    retention: z.ZodOptional<z.ZodEnum<["in_memory", "extended_24h"]>>;
+    cacheEnabled: z.ZodOptional<z.ZodBoolean>;
+    mixedTtls: z.ZodOptional<z.ZodBoolean>;
+    cacheResourceId: z.ZodOptional<z.ZodString>;
+    providerExpiresAtMs: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    effectiveTtlSeconds?: number | undefined;
+    retention?: "in_memory" | "extended_24h" | undefined;
+    cacheEnabled?: boolean | undefined;
+    mixedTtls?: boolean | undefined;
+    cacheResourceId?: string | undefined;
+    providerExpiresAtMs?: number | undefined;
+}, {
+    effectiveTtlSeconds?: number | undefined;
+    retention?: "in_memory" | "extended_24h" | undefined;
+    cacheEnabled?: boolean | undefined;
+    mixedTtls?: boolean | undefined;
+    cacheResourceId?: string | undefined;
+    providerExpiresAtMs?: number | undefined;
+}>;
+export type CachePolicyMetadata = z.infer<typeof CachePolicyMetadataSchema>;
+export declare const CacheUsageBasisSchema: z.ZodEnum<["request", "turn", "session", "unknown"]>;
+export type CacheUsageBasis = z.infer<typeof CacheUsageBasisSchema>;
+/** Scope is explicit: aggregate turn/session usage never establishes a per-request cache timer. */
+export declare const CacheObservationSchema: z.ZodEffects<z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    eventId: z.ZodString;
+    /** Assigned by the durable owner, monotonically increasing within this scope across restarts. */
+    sequence: z.ZodNumber;
+    scope: z.ZodObject<{
+        sessionId: z.ZodString;
+        actorId: z.ZodString;
+        /** Opaque prefix/block/resource identity; never include prompt content or credentials. */
+        blockId: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        sessionId: string;
+        actorId: string;
+        blockId: string;
+    }, {
+        sessionId: string;
+        actorId: string;
+        blockId: string;
+    }>;
+    context: z.ZodObject<{
+        harness: z.ZodEnum<["claude", "codex", "gemini", "opencode", "goose", "hermes", "openclaw", "custom"]>;
+        harnessVersion: z.ZodOptional<z.ZodString>;
+        provider: z.ZodOptional<z.ZodString>;
+        endpoint: z.ZodEnum<["anthropic_api", "openai_api", "chatgpt", "gemini_developer", "vertex", "bedrock", "openrouter", "code_assist", "custom", "unknown"]>;
+        authMode: z.ZodEnum<["api_key", "subscription_included", "usage_credits", "cloud", "oauth", "unknown"]>;
+        model: z.ZodOptional<z.ZodString>;
+        requestClass: z.ZodEnum<["main", "subagent", "auxiliary"]>;
+        headless: z.ZodOptional<z.ZodBoolean>;
+        /** Set by the trusted adapter after resolving route/config, never copied from task input. */
+        metadataVerified: z.ZodBoolean;
+    }, "strict", z.ZodTypeAny, {
+        harness: "custom" | "openclaw" | "claude" | "codex" | "gemini" | "opencode" | "goose" | "hermes";
+        endpoint: "unknown" | "custom" | "anthropic_api" | "openai_api" | "chatgpt" | "gemini_developer" | "vertex" | "bedrock" | "openrouter" | "code_assist";
+        authMode: "unknown" | "oauth" | "api_key" | "subscription_included" | "usage_credits" | "cloud";
+        requestClass: "main" | "subagent" | "auxiliary";
+        metadataVerified: boolean;
+        provider?: string | undefined;
+        harnessVersion?: string | undefined;
+        model?: string | undefined;
+        headless?: boolean | undefined;
+    }, {
+        harness: "custom" | "openclaw" | "claude" | "codex" | "gemini" | "opencode" | "goose" | "hermes";
+        endpoint: "unknown" | "custom" | "anthropic_api" | "openai_api" | "chatgpt" | "gemini_developer" | "vertex" | "bedrock" | "openrouter" | "code_assist";
+        authMode: "unknown" | "oauth" | "api_key" | "subscription_included" | "usage_credits" | "cloud";
+        requestClass: "main" | "subagent" | "auxiliary";
+        metadataVerified: boolean;
+        provider?: string | undefined;
+        harnessVersion?: string | undefined;
+        model?: string | undefined;
+        headless?: boolean | undefined;
+    }>;
+    observedAtMs: z.ZodNumber;
+    requestStartedAtMs: z.ZodOptional<z.ZodNumber>;
+    source: z.ZodEnum<["provider_response", "native_runtime", "unverified"]>;
+    kind: z.ZodEnum<["usage", "disabled", "reuse_changed"]>;
+    usageBasis: z.ZodDefault<z.ZodEnum<["request", "turn", "session", "unknown"]>>;
+    inputTokens: z.ZodOptional<z.ZodNumber>;
+    outputTokens: z.ZodOptional<z.ZodNumber>;
+    cacheReadTokens: z.ZodOptional<z.ZodNumber>;
+    cacheWriteTokens: z.ZodOptional<z.ZodNumber>;
+    policy: z.ZodObject<{
+        effectiveTtlSeconds: z.ZodOptional<z.ZodNumber>;
+        retention: z.ZodOptional<z.ZodEnum<["in_memory", "extended_24h"]>>;
+        cacheEnabled: z.ZodOptional<z.ZodBoolean>;
+        mixedTtls: z.ZodOptional<z.ZodBoolean>;
+        cacheResourceId: z.ZodOptional<z.ZodString>;
+        providerExpiresAtMs: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        effectiveTtlSeconds?: number | undefined;
+        retention?: "in_memory" | "extended_24h" | undefined;
+        cacheEnabled?: boolean | undefined;
+        mixedTtls?: boolean | undefined;
+        cacheResourceId?: string | undefined;
+        providerExpiresAtMs?: number | undefined;
+    }, {
+        effectiveTtlSeconds?: number | undefined;
+        retention?: "in_memory" | "extended_24h" | undefined;
+        cacheEnabled?: boolean | undefined;
+        mixedTtls?: boolean | undefined;
+        cacheResourceId?: string | undefined;
+        providerExpiresAtMs?: number | undefined;
+    }>;
+    changeReason: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    scope: {
+        sessionId: string;
+        actorId: string;
+        blockId: string;
+    };
+    context: {
+        harness: "custom" | "openclaw" | "claude" | "codex" | "gemini" | "opencode" | "goose" | "hermes";
+        endpoint: "unknown" | "custom" | "anthropic_api" | "openai_api" | "chatgpt" | "gemini_developer" | "vertex" | "bedrock" | "openrouter" | "code_assist";
+        authMode: "unknown" | "oauth" | "api_key" | "subscription_included" | "usage_credits" | "cloud";
+        requestClass: "main" | "subagent" | "auxiliary";
+        metadataVerified: boolean;
+        provider?: string | undefined;
+        harnessVersion?: string | undefined;
+        model?: string | undefined;
+        headless?: boolean | undefined;
+    };
+    kind: "disabled" | "usage" | "reuse_changed";
+    policy: {
+        effectiveTtlSeconds?: number | undefined;
+        retention?: "in_memory" | "extended_24h" | undefined;
+        cacheEnabled?: boolean | undefined;
+        mixedTtls?: boolean | undefined;
+        cacheResourceId?: string | undefined;
+        providerExpiresAtMs?: number | undefined;
+    };
+    schemaVersion: 1;
+    eventId: string;
+    sequence: number;
+    observedAtMs: number;
+    source: "provider_response" | "native_runtime" | "unverified";
+    usageBasis: "unknown" | "session" | "request" | "turn";
+    requestStartedAtMs?: number | undefined;
+    inputTokens?: number | undefined;
+    outputTokens?: number | undefined;
+    cacheReadTokens?: number | undefined;
+    cacheWriteTokens?: number | undefined;
+    changeReason?: string | undefined;
+}, {
+    scope: {
+        sessionId: string;
+        actorId: string;
+        blockId: string;
+    };
+    context: {
+        harness: "custom" | "openclaw" | "claude" | "codex" | "gemini" | "opencode" | "goose" | "hermes";
+        endpoint: "unknown" | "custom" | "anthropic_api" | "openai_api" | "chatgpt" | "gemini_developer" | "vertex" | "bedrock" | "openrouter" | "code_assist";
+        authMode: "unknown" | "oauth" | "api_key" | "subscription_included" | "usage_credits" | "cloud";
+        requestClass: "main" | "subagent" | "auxiliary";
+        metadataVerified: boolean;
+        provider?: string | undefined;
+        harnessVersion?: string | undefined;
+        model?: string | undefined;
+        headless?: boolean | undefined;
+    };
+    kind: "disabled" | "usage" | "reuse_changed";
+    policy: {
+        effectiveTtlSeconds?: number | undefined;
+        retention?: "in_memory" | "extended_24h" | undefined;
+        cacheEnabled?: boolean | undefined;
+        mixedTtls?: boolean | undefined;
+        cacheResourceId?: string | undefined;
+        providerExpiresAtMs?: number | undefined;
+    };
+    schemaVersion: 1;
+    eventId: string;
+    sequence: number;
+    observedAtMs: number;
+    source: "provider_response" | "native_runtime" | "unverified";
+    requestStartedAtMs?: number | undefined;
+    usageBasis?: "unknown" | "session" | "request" | "turn" | undefined;
+    inputTokens?: number | undefined;
+    outputTokens?: number | undefined;
+    cacheReadTokens?: number | undefined;
+    cacheWriteTokens?: number | undefined;
+    changeReason?: string | undefined;
+}>, {
+    scope: {
+        sessionId: string;
+        actorId: string;
+        blockId: string;
+    };
+    context: {
+        harness: "custom" | "openclaw" | "claude" | "codex" | "gemini" | "opencode" | "goose" | "hermes";
+        endpoint: "unknown" | "custom" | "anthropic_api" | "openai_api" | "chatgpt" | "gemini_developer" | "vertex" | "bedrock" | "openrouter" | "code_assist";
+        authMode: "unknown" | "oauth" | "api_key" | "subscription_included" | "usage_credits" | "cloud";
+        requestClass: "main" | "subagent" | "auxiliary";
+        metadataVerified: boolean;
+        provider?: string | undefined;
+        harnessVersion?: string | undefined;
+        model?: string | undefined;
+        headless?: boolean | undefined;
+    };
+    kind: "disabled" | "usage" | "reuse_changed";
+    policy: {
+        effectiveTtlSeconds?: number | undefined;
+        retention?: "in_memory" | "extended_24h" | undefined;
+        cacheEnabled?: boolean | undefined;
+        mixedTtls?: boolean | undefined;
+        cacheResourceId?: string | undefined;
+        providerExpiresAtMs?: number | undefined;
+    };
+    schemaVersion: 1;
+    eventId: string;
+    sequence: number;
+    observedAtMs: number;
+    source: "provider_response" | "native_runtime" | "unverified";
+    usageBasis: "unknown" | "session" | "request" | "turn";
+    requestStartedAtMs?: number | undefined;
+    inputTokens?: number | undefined;
+    outputTokens?: number | undefined;
+    cacheReadTokens?: number | undefined;
+    cacheWriteTokens?: number | undefined;
+    changeReason?: string | undefined;
+}, {
+    scope: {
+        sessionId: string;
+        actorId: string;
+        blockId: string;
+    };
+    context: {
+        harness: "custom" | "openclaw" | "claude" | "codex" | "gemini" | "opencode" | "goose" | "hermes";
+        endpoint: "unknown" | "custom" | "anthropic_api" | "openai_api" | "chatgpt" | "gemini_developer" | "vertex" | "bedrock" | "openrouter" | "code_assist";
+        authMode: "unknown" | "oauth" | "api_key" | "subscription_included" | "usage_credits" | "cloud";
+        requestClass: "main" | "subagent" | "auxiliary";
+        metadataVerified: boolean;
+        provider?: string | undefined;
+        harnessVersion?: string | undefined;
+        model?: string | undefined;
+        headless?: boolean | undefined;
+    };
+    kind: "disabled" | "usage" | "reuse_changed";
+    policy: {
+        effectiveTtlSeconds?: number | undefined;
+        retention?: "in_memory" | "extended_24h" | undefined;
+        cacheEnabled?: boolean | undefined;
+        mixedTtls?: boolean | undefined;
+        cacheResourceId?: string | undefined;
+        providerExpiresAtMs?: number | undefined;
+    };
+    schemaVersion: 1;
+    eventId: string;
+    sequence: number;
+    observedAtMs: number;
+    source: "provider_response" | "native_runtime" | "unverified";
+    requestStartedAtMs?: number | undefined;
+    usageBasis?: "unknown" | "session" | "request" | "turn" | undefined;
+    inputTokens?: number | undefined;
+    outputTokens?: number | undefined;
+    cacheReadTokens?: number | undefined;
+    cacheWriteTokens?: number | undefined;
+    changeReason?: string | undefined;
+}>;
+export type CacheObservation = z.infer<typeof CacheObservationSchema>;
+export declare const CacheStatusSchema: z.ZodEnum<["provider_expiry", "policy_window", "window_elapsed", "expired", "unknown", "not_observed", "disabled", "reuse_changed"]>;
+export type CacheStatus = z.infer<typeof CacheStatusSchema>;
+export declare const CacheDisplaySchema: z.ZodEffects<z.ZodObject<{
+    scope: z.ZodObject<{
+        sessionId: z.ZodString;
+        actorId: z.ZodString;
+        /** Opaque prefix/block/resource identity; never include prompt content or credentials. */
+        blockId: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        sessionId: string;
+        actorId: string;
+        blockId: string;
+    }, {
+        sessionId: string;
+        actorId: string;
+        blockId: string;
+    }>;
+    status: z.ZodEnum<["provider_expiry", "policy_window", "window_elapsed", "expired", "unknown", "not_observed", "disabled", "reuse_changed"]>;
+    label: z.ZodString;
+    detail: z.ZodString;
+    usageBasis: z.ZodDefault<z.ZodEnum<["request", "turn", "session", "unknown"]>>;
+    observedModel: z.ZodOptional<z.ZodString>;
+    observedProvider: z.ZodOptional<z.ZodString>;
+    observedInputTokens: z.ZodOptional<z.ZodNumber>;
+    observedOutputTokens: z.ZodOptional<z.ZodNumber>;
+    newInputTokens: z.ZodOptional<z.ZodNumber>;
+    cacheReadDenominatorTokens: z.ZodOptional<z.ZodNumber>;
+    readFractionPermille: z.ZodOptional<z.ZodNumber>;
+    remainingMs: z.ZodOptional<z.ZodNumber>;
+    totalMs: z.ZodOptional<z.ZodNumber>;
+    progressPermille: z.ZodOptional<z.ZodNumber>;
+    lastReadTokens: z.ZodOptional<z.ZodNumber>;
+    lastWriteTokens: z.ZodOptional<z.ZodNumber>;
+    lastObservedAtMs: z.ZodOptional<z.ZodNumber>;
+    policyVersion: z.ZodLiteral<"2026-09-24.1">;
+    policySourceUrl: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    status: "unknown" | "expired" | "disabled" | "reuse_changed" | "provider_expiry" | "policy_window" | "window_elapsed" | "not_observed";
+    detail: string;
+    scope: {
+        sessionId: string;
+        actorId: string;
+        blockId: string;
+    };
+    usageBasis: "unknown" | "session" | "request" | "turn";
+    label: string;
+    policyVersion: "2026-09-24.1";
+    observedModel?: string | undefined;
+    observedProvider?: string | undefined;
+    observedInputTokens?: number | undefined;
+    observedOutputTokens?: number | undefined;
+    newInputTokens?: number | undefined;
+    cacheReadDenominatorTokens?: number | undefined;
+    readFractionPermille?: number | undefined;
+    remainingMs?: number | undefined;
+    totalMs?: number | undefined;
+    progressPermille?: number | undefined;
+    lastReadTokens?: number | undefined;
+    lastWriteTokens?: number | undefined;
+    lastObservedAtMs?: number | undefined;
+    policySourceUrl?: string | undefined;
+}, {
+    status: "unknown" | "expired" | "disabled" | "reuse_changed" | "provider_expiry" | "policy_window" | "window_elapsed" | "not_observed";
+    detail: string;
+    scope: {
+        sessionId: string;
+        actorId: string;
+        blockId: string;
+    };
+    label: string;
+    policyVersion: "2026-09-24.1";
+    usageBasis?: "unknown" | "session" | "request" | "turn" | undefined;
+    observedModel?: string | undefined;
+    observedProvider?: string | undefined;
+    observedInputTokens?: number | undefined;
+    observedOutputTokens?: number | undefined;
+    newInputTokens?: number | undefined;
+    cacheReadDenominatorTokens?: number | undefined;
+    readFractionPermille?: number | undefined;
+    remainingMs?: number | undefined;
+    totalMs?: number | undefined;
+    progressPermille?: number | undefined;
+    lastReadTokens?: number | undefined;
+    lastWriteTokens?: number | undefined;
+    lastObservedAtMs?: number | undefined;
+    policySourceUrl?: string | undefined;
+}>, {
+    status: "unknown" | "expired" | "disabled" | "reuse_changed" | "provider_expiry" | "policy_window" | "window_elapsed" | "not_observed";
+    detail: string;
+    scope: {
+        sessionId: string;
+        actorId: string;
+        blockId: string;
+    };
+    usageBasis: "unknown" | "session" | "request" | "turn";
+    label: string;
+    policyVersion: "2026-09-24.1";
+    observedModel?: string | undefined;
+    observedProvider?: string | undefined;
+    observedInputTokens?: number | undefined;
+    observedOutputTokens?: number | undefined;
+    newInputTokens?: number | undefined;
+    cacheReadDenominatorTokens?: number | undefined;
+    readFractionPermille?: number | undefined;
+    remainingMs?: number | undefined;
+    totalMs?: number | undefined;
+    progressPermille?: number | undefined;
+    lastReadTokens?: number | undefined;
+    lastWriteTokens?: number | undefined;
+    lastObservedAtMs?: number | undefined;
+    policySourceUrl?: string | undefined;
+}, {
+    status: "unknown" | "expired" | "disabled" | "reuse_changed" | "provider_expiry" | "policy_window" | "window_elapsed" | "not_observed";
+    detail: string;
+    scope: {
+        sessionId: string;
+        actorId: string;
+        blockId: string;
+    };
+    label: string;
+    policyVersion: "2026-09-24.1";
+    usageBasis?: "unknown" | "session" | "request" | "turn" | undefined;
+    observedModel?: string | undefined;
+    observedProvider?: string | undefined;
+    observedInputTokens?: number | undefined;
+    observedOutputTokens?: number | undefined;
+    newInputTokens?: number | undefined;
+    cacheReadDenominatorTokens?: number | undefined;
+    readFractionPermille?: number | undefined;
+    remainingMs?: number | undefined;
+    totalMs?: number | undefined;
+    progressPermille?: number | undefined;
+    lastReadTokens?: number | undefined;
+    lastWriteTokens?: number | undefined;
+    lastObservedAtMs?: number | undefined;
+    policySourceUrl?: string | undefined;
+}>;
+export type CacheDisplay = z.infer<typeof CacheDisplaySchema>;

package/node_modules/@kya-os/contracts/dist/workbench/cache.js

@@ -0,0 +1,165 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheDisplaySchema = exports.CacheStatusSchema = exports.CacheObservationSchema = exports.CacheUsageBasisSchema = exports.CachePolicyMetadataSchema = exports.CacheContextSchema = exports.CacheScopeSchema = exports.CacheAwarenessConfigSchema = exports.CACHE_POLICY_VERSION = void 0;
+const zod_1 = require("zod");
+/** Version of the reviewed policy catalog, not a provider capability guarantee. */
+exports.CACHE_POLICY_VERSION = "2026-09-24.1";
+const safeCount = zod_1.z.number().int().nonnegative().max(Number.MAX_SAFE_INTEGER);
+const identifier = zod_1.z
+    .string()
+    .regex(/^[\x21-\x7e]{1,512}$/, "Expected a printable ASCII identifier");
+/** Display preference only. No inference, warming, or provider settings are changed. */
+exports.CacheAwarenessConfigSchema = zod_1.z
+    .object({ enabled: zod_1.z.boolean().optional() })
+    .strict();
+exports.CacheScopeSchema = zod_1.z
+    .object({
+    sessionId: identifier,
+    actorId: identifier,
+    /** Opaque prefix/block/resource identity; never include prompt content or credentials. */
+    blockId: identifier,
+})
+    .strict();
+exports.CacheContextSchema = zod_1.z
+    .object({
+    harness: zod_1.z.enum([
+        "claude",
+        "codex",
+        "gemini",
+        "opencode",
+        "goose",
+        "hermes",
+        "openclaw",
+        "custom",
+    ]),
+    harnessVersion: identifier.optional(),
+    provider: identifier.optional(),
+    endpoint: zod_1.z.enum([
+        "anthropic_api",
+        "openai_api",
+        "chatgpt",
+        "gemini_developer",
+        "vertex",
+        "bedrock",
+        "openrouter",
+        "code_assist",
+        "custom",
+        "unknown",
+    ]),
+    authMode: zod_1.z.enum([
+        "api_key",
+        "subscription_included",
+        "usage_credits",
+        "cloud",
+        "oauth",
+        "unknown",
+    ]),
+    model: identifier.optional(),
+    requestClass: zod_1.z.enum(["main", "subagent", "auxiliary"]),
+    headless: zod_1.z.boolean().optional(),
+    /** Set by the trusted adapter after resolving route/config, never copied from task input. */
+    metadataVerified: zod_1.z.boolean(),
+})
+    .strict();
+exports.CachePolicyMetadataSchema = zod_1.z
+    .object({
+    effectiveTtlSeconds: safeCount.positive().optional(),
+    retention: zod_1.z.enum(["in_memory", "extended_24h"]).optional(),
+    cacheEnabled: zod_1.z.boolean().optional(),
+    mixedTtls: zod_1.z.boolean().optional(),
+    cacheResourceId: identifier.optional(),
+    providerExpiresAtMs: safeCount.optional(),
+})
+    .strict();
+exports.CacheUsageBasisSchema = zod_1.z.enum([
+    "request",
+    "turn",
+    "session",
+    "unknown",
+]);
+/** Scope is explicit: aggregate turn/session usage never establishes a per-request cache timer. */
+exports.CacheObservationSchema = zod_1.z
+    .object({
+    schemaVersion: zod_1.z.literal(1),
+    eventId: identifier,
+    /** Assigned by the durable owner, monotonically increasing within this scope across restarts. */
+    sequence: safeCount,
+    scope: exports.CacheScopeSchema,
+    context: exports.CacheContextSchema,
+    observedAtMs: safeCount,
+    requestStartedAtMs: safeCount.optional(),
+    source: zod_1.z.enum(["provider_response", "native_runtime", "unverified"]),
+    kind: zod_1.z.enum(["usage", "disabled", "reuse_changed"]),
+    usageBasis: exports.CacheUsageBasisSchema.default("unknown"),
+    inputTokens: safeCount.optional(),
+    outputTokens: safeCount.optional(),
+    cacheReadTokens: safeCount.optional(),
+    cacheWriteTokens: safeCount.optional(),
+    policy: exports.CachePolicyMetadataSchema,
+    changeReason: zod_1.z.string().max(1024).optional(),
+})
+    .strict()
+    .superRefine((event, ctx) => {
+    if (event.requestStartedAtMs !== undefined &&
+        event.requestStartedAtMs > event.observedAtMs) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            path: ["requestStartedAtMs"],
+            message: "Request start must not follow observation time",
+        });
+    }
+});
+exports.CacheStatusSchema = zod_1.z.enum([
+    "provider_expiry",
+    "policy_window",
+    "window_elapsed",
+    "expired",
+    "unknown",
+    "not_observed",
+    "disabled",
+    "reuse_changed",
+]);
+exports.CacheDisplaySchema = zod_1.z
+    .object({
+    scope: exports.CacheScopeSchema,
+    status: exports.CacheStatusSchema,
+    label: zod_1.z.string(),
+    detail: zod_1.z.string(),
+    usageBasis: exports.CacheUsageBasisSchema.default("unknown"),
+    observedModel: zod_1.z.string().optional(),
+    observedProvider: zod_1.z.string().optional(),
+    observedInputTokens: safeCount.optional(),
+    observedOutputTokens: safeCount.optional(),
+    newInputTokens: safeCount.optional(),
+    cacheReadDenominatorTokens: safeCount.optional(),
+    readFractionPermille: zod_1.z.number().int().min(0).max(1000).optional(),
+    remainingMs: safeCount.optional(),
+    totalMs: safeCount.optional(),
+    progressPermille: zod_1.z.number().int().min(0).max(1000).optional(),
+    lastReadTokens: safeCount.optional(),
+    lastWriteTokens: safeCount.optional(),
+    lastObservedAtMs: safeCount.optional(),
+    policyVersion: zod_1.z.literal(exports.CACHE_POLICY_VERSION),
+    policySourceUrl: zod_1.z.string().url().optional(),
+})
+    .strict()
+    .superRefine((display, ctx) => {
+    const timed = display.status === "provider_expiry" ||
+        display.status === "policy_window";
+    if (!timed &&
+        (display.remainingMs !== undefined ||
+            display.totalMs !== undefined ||
+            display.progressPermille !== undefined)) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            message: "Only a supported active window has a countdown",
+        });
+    }
+    if (timed && display.remainingMs === undefined) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            path: ["remainingMs"],
+            message: "Active windows require a remaining time",
+        });
+    }
+});