@claudexor/schema 5.0.2 → 6.0.0

package/dist/control-web-evidence.d.ts

@@ -0,0 +1,125 @@
+import { z } from "zod/v3";
+export declare const ControlWebEvidence: z.ZodObject<{
+    required: z.ZodDefault<z.ZodBoolean>;
+    /** Requested external-context policy for the run. */
+    mode: z.ZodDefault<z.ZodEnum<["off", "auto", "cached", "live"]>>;
+    /** Mode given to the selected route (disclosed upgrades, e.g. claude cached->live). */
+    effectiveMode: z.ZodDefault<z.ZodEnum<["off", "auto", "cached", "live"]>>;
+    attempted: z.ZodDefault<z.ZodBoolean>;
+    satisfied: z.ZodDefault<z.ZodBoolean>;
+    status: z.ZodDefault<z.ZodEnum<["none", "attempted", "satisfied", "failed", "unverified"]>>;
+    verification: z.ZodDefault<z.ZodEnum<["verified", "dispatched", "none"]>>;
+    verifiedContent: z.ZodDefault<z.ZodNullable<z.ZodEnum<["page", "search_results"]>>>;
+    observation: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        evidence: z.ZodLiteral<"tool_calls">;
+        network: z.ZodLiteral<"not_measured">;
+    }, "strip", z.ZodTypeAny, {
+        evidence: "tool_calls";
+        network: "not_measured";
+    }, {
+        evidence: "tool_calls";
+        network: "not_measured";
+    }>>>;
+    tool: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    target: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    errorSummary: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    rawDetailRef: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    /** False when the run predates telemetry.yaml; surfaces must render "telemetry unavailable". */
+    available: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    required: boolean;
+    mode: "auto" | "cached" | "live" | "off";
+    effectiveMode: "auto" | "cached" | "live" | "off";
+    attempted: boolean;
+    satisfied: boolean;
+    status: "attempted" | "failed" | "none" | "satisfied" | "unverified";
+    verification: "dispatched" | "none" | "verified";
+    verifiedContent: "page" | "search_results" | null;
+    observation: {
+        evidence: "tool_calls";
+        network: "not_measured";
+    } | null;
+    tool: string | null;
+    target: string | null;
+    errorSummary: string | null;
+    rawDetailRef: string | null;
+    available: boolean;
+}, {
+    required?: boolean | undefined;
+    mode?: "auto" | "cached" | "live" | "off" | undefined;
+    effectiveMode?: "auto" | "cached" | "live" | "off" | undefined;
+    attempted?: boolean | undefined;
+    satisfied?: boolean | undefined;
+    status?: "attempted" | "failed" | "none" | "satisfied" | "unverified" | undefined;
+    verification?: "dispatched" | "none" | "verified" | undefined;
+    verifiedContent?: "page" | "search_results" | null | undefined;
+    observation?: {
+        evidence: "tool_calls";
+        network: "not_measured";
+    } | null | undefined;
+    tool?: string | null | undefined;
+    target?: string | null | undefined;
+    errorSummary?: string | null | undefined;
+    rawDetailRef?: string | null | undefined;
+    available?: boolean | undefined;
+}>;
+export type ControlWebEvidence = z.infer<typeof ControlWebEvidence>;
+/** One distinct route of a run: the native controls prepared for its spawns and
+ * whether a native session was reported started (#118, #413), projected from
+ * telemetry and never inferred for older records. */
+export declare const ControlRouteControl: z.ZodObject<{
+    harnessId: z.ZodString;
+    webMode: z.ZodEnum<["off", "auto", "cached", "live"]>;
+    webMechanism: z.ZodEnum<["native", "tools", "uncontrolled", "none"]>;
+    browser: z.ZodBoolean;
+    browserStartup: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        status: z.ZodEnum<["ready", "failed", "cancelled", "starting", "not_observed"]>;
+        waitedMs: z.ZodNumber;
+        error: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: "cancelled" | "failed" | "not_observed" | "ready" | "starting";
+        waitedMs: number;
+        error: string | null;
+    }, {
+        status: "cancelled" | "failed" | "not_observed" | "ready" | "starting";
+        waitedMs: number;
+        error: string | null;
+    }>>>;
+    access: z.ZodEnum<["readonly", "workspace_write", "full", "inherit_native"]>;
+    nativeAccess: z.ZodNullable<z.ZodString>;
+    accessMechanism: z.ZodEnum<["fs_sandbox", "permission_deny", "tool_allowlist", "tool_policy", "native_settings", "none"]>;
+    nativeSessionStarted: z.ZodBoolean;
+    homeScoped: z.ZodNullable<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    harnessId: string;
+    webMode: "auto" | "cached" | "live" | "off";
+    webMechanism: "native" | "none" | "tools" | "uncontrolled";
+    browser: boolean;
+    browserStartup: {
+        status: "cancelled" | "failed" | "not_observed" | "ready" | "starting";
+        waitedMs: number;
+        error: string | null;
+    } | null;
+    access: "full" | "inherit_native" | "readonly" | "workspace_write";
+    nativeAccess: string | null;
+    accessMechanism: "fs_sandbox" | "native_settings" | "none" | "permission_deny" | "tool_allowlist" | "tool_policy";
+    nativeSessionStarted: boolean;
+    homeScoped: boolean | null;
+}, {
+    harnessId: string;
+    webMode: "auto" | "cached" | "live" | "off";
+    webMechanism: "native" | "none" | "tools" | "uncontrolled";
+    browser: boolean;
+    browserStartup?: {
+        status: "cancelled" | "failed" | "not_observed" | "ready" | "starting";
+        waitedMs: number;
+        error: string | null;
+    } | null | undefined;
+    access: "full" | "inherit_native" | "readonly" | "workspace_write";
+    nativeAccess: string | null;
+    accessMechanism: "fs_sandbox" | "native_settings" | "none" | "permission_deny" | "tool_allowlist" | "tool_policy";
+    nativeSessionStarted: boolean;
+    homeScoped: boolean | null;
+}>;
+export type ControlRouteControl = z.infer<typeof ControlRouteControl>;
+//# sourceMappingURL=control-web-evidence.d.ts.map

package/dist/control-web-evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-web-evidence.d.ts","sourceRoot":"","sources":["../src/control-web-evidence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAK3B,eAAO,MAAM,kBAAkB;;IAG3B,qDAAqD;;IAIrD,uFAAuF;;;;;;;;;;;;;;;;;;;;;IAwDvF,gGAAgG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQf,CAAC;AACtF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAsBpE;;qDAEqD;AACrD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmC7B,CAAC;AACJ,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/control-web-evidence.js

@@ -0,0 +1,109 @@
+import { z } from "zod/v3";
+import { AccessProfile, ExternalContextPolicy } from "./primitives.js";
+import { RouteAccessMechanism, WebPolicySupport } from "./route-controls.js";
+import { WebObservation } from "./web-evidence.js";
+export const ControlWebEvidence = z
+    .object({
+    required: z.boolean().default(false).describe("Explicit stored web requirement."),
+    /** Requested external-context policy for the run. */
+    mode: ExternalContextPolicy.default("auto").describe("Requested external-context policy for the run."),
+    /** Mode given to the selected route (disclosed upgrades, e.g. claude cached->live). */
+    effectiveMode: ExternalContextPolicy.default("auto").describe("Policy given to the selected route, after disclosed upgrades (e.g. cached to live); not proof that a native session ran."),
+    attempted: z
+        .boolean()
+        .default(false)
+        .describe("Whether a web tool call or engine Browser call was observed; not a network measurement."),
+    satisfied: z
+        .boolean()
+        .default(false)
+        .describe("Completed without a typed failure; retrieved content is not necessarily proven."),
+    status: z
+        .enum(["none", "attempted", "satisfied", "failed", "unverified"])
+        .default("none")
+        .describe("Observed web status; satisfied does not prove retrieved content was verified."),
+    verification: z
+        .enum(["verified", "dispatched", "none"])
+        .default("none")
+        .describe("Retrieval-proof strength: verified when a typed result shows a retrieval (verifiedContent says of what); dispatched when a web call completed without one; none when no search or page retrieval was observed, though a Browser action may have completed."),
+    verifiedContent: z
+        .enum(["page", "search_results"])
+        .nullable()
+        .default(null)
+        .describe("What the verified retrieval returned: page (a fetched or loaded page) or search_results (a web search's results, not a fetched page); null when nothing was verified or the engine did not record it."),
+    observation: WebObservation.nullable()
+        .default(null)
+        .describe("What the evidence covers (tool calls; network not measured); null when no telemetry was recorded."),
+    tool: z
+        .string()
+        .nullable()
+        .default(null)
+        .describe("Web tool that produced the evidence, when any."),
+    target: z
+        .string()
+        .nullable()
+        .default(null)
+        .describe("Target (query/url) of the web activity as issued, when any."),
+    errorSummary: z
+        .string()
+        .nullable()
+        .default(null)
+        .describe("Redacted error detail when web activity failed."),
+    rawDetailRef: z
+        .string()
+        .nullable()
+        .default(null)
+        .describe("Artifact path holding the full evidence record."),
+    /** False when the run predates telemetry.yaml; surfaces must render "telemetry unavailable". */
+    available: z
+        .boolean()
+        .default(true)
+        .describe('False when the run predates the telemetry artifact; surfaces must render "telemetry unavailable".'),
+})
+    .describe("Web evidence projected onto a run summary from the telemetry artifact.");
+/** The selected Browser's startup on a route, as its adapter reported it (#215). */
+const ControlBrowserStartup = z
+    .object({
+    status: z
+        .enum(["ready", "failed", "cancelled", "starting", "not_observed"])
+        .describe("Startup state when the first model request was allowed: ready (Codex reported the server started), failed, cancelled, starting (still starting when the hold ended: Codex's 90 s limit plus a 5 s grace for its status), or not_observed (no startup status at all)."),
+    waitedMs: z
+        .number()
+        .int()
+        .nonnegative()
+        .describe("How long the first model request was held for this outcome."),
+    error: z
+        .string()
+        .nullable()
+        .describe("The vendor's own reason for a failed or cancelled startup, masked."),
+})
+    .describe("The selected Browser's reported startup outcome on one route (#215).");
+/** One distinct route of a run: the native controls prepared for its spawns and
+ * whether a native session was reported started (#118, #413), projected from
+ * telemetry and never inferred for older records. */
+export const ControlRouteControl = z
+    .object({
+    harnessId: z.string().describe("Harness of the route."),
+    webMode: ExternalContextPolicy.describe("Web policy given to the route."),
+    webMechanism: WebPolicySupport.describe("How the route's own web tools are switched."),
+    browser: z
+        .boolean()
+        .describe("Whether the engine Browser MCP was handed to the route (prepared; not a connection)."),
+    browserStartup: ControlBrowserStartup.nullable()
+        .default(null)
+        .describe("The Browser's startup as the route reported it before the first model request; null when it reported none, so an armed Browser was only prepared."),
+    access: AccessProfile.describe("Access profile handed to the route."),
+    nativeAccess: z
+        .string()
+        .nullable()
+        .describe("The vendor access setting prepared for the route; null when none or undisclosed."),
+    accessMechanism: RouteAccessMechanism,
+    nativeSessionStarted: z
+        .boolean()
+        .describe("Whether an adapter reported a native session started under these controls. False means none was observed (refused before launch, or stopped or ended before a start was reported); it does not prove that no process ran."),
+    homeScoped: z
+        .boolean()
+        .nullable()
+        .describe("Applied HOME fact: true when the engine assigned the child a Claudexor-owned HOME, false when the engine did not replace HOME, so the child inherits the engine's own environment; null when the route recorded none."),
+})
+    .describe("Native web and access controls prepared for one route of the run; Claudexor adds no outer boundary.");
+//# sourceMappingURL=control-web-evidence.js.map

package/dist/control-web-evidence.js.map

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