@kici-dev/engine 0.1.23 → 0.1.24

package/dist/protocol/messages/agent-run-result.d.ts

@@ -0,0 +1,350 @@
+/**
+ * Agent-facing, provenance-tagged run-result schema.
+ *
+ * A machine-first read shape for a run: the typed job DAG, per-step exit codes,
+ * durations, statuses, and a coarse derived failure classification. Every field
+ * an agent could be tricked by — names, refs, error text, log lines, job outputs —
+ * is wrapped in an {@link untrusted} envelope so a consumer can keep
+ * user-controlled content out of an instruction channel. KiCI-generated values
+ * (ids, enum statuses, exit codes, durations, hashes, derived categories) stay
+ * plain (trusted).
+ *
+ * Read-only contract — produced by the orchestrator admin run API and consumed by
+ * agents / the developer MCP server. Reuses the existing execution status enums;
+ * never define a parallel status string.
+ */
+import { z } from 'zod';
+/**
+ * Wrap a value KiCI does not vouch for — content from the user's repo, the
+ * contributor, or a process's output. Trusted fields are left plain. The
+ * envelope self-tags so the value survives reshaping / fencing: a renderer that
+ * fences untrusted content just refuses to emit any `{ untrusted: true }` value
+ * into an instruction channel.
+ */
+export declare const untrusted: <T extends z.ZodTypeAny>(v: T) => z.ZodObject<{
+    untrusted: z.ZodLiteral<true>;
+    value: T;
+}, z.core.$strip>;
+/** Construct an untrusted envelope around a runtime value. */
+export declare function wrapUntrusted<T>(value: T): {
+    untrusted: true;
+    value: T;
+};
+/** Coarse, derived run-failure classification (trusted — KiCI computes it). */
+export declare const AgentFailureCategory: z.ZodEnum<{
+    unknown: "unknown";
+    cancelled: "cancelled";
+    init_failure: "init_failure";
+    timed_out: "timed_out";
+    step_failed: "step_failed";
+    infra: "infra";
+}>;
+export type AgentFailureCategory = z.infer<typeof AgentFailureCategory>;
+export declare const agentStepResultSchema: z.ZodObject<{
+    stepIndex: z.ZodNumber;
+    stepName: z.ZodObject<{
+        untrusted: z.ZodLiteral<true>;
+        value: z.ZodString;
+    }, z.core.$strip>;
+    status: z.ZodEnum<{
+        skipped: "skipped";
+        success: "success";
+        pending: "pending";
+        running: "running";
+        failed: "failed";
+        cancelled: "cancelled";
+    }>;
+    exitCode: z.ZodNullable<z.ZodNumber>;
+    durationMs: z.ZodNullable<z.ZodNumber>;
+    startedAt: z.ZodNullable<z.ZodString>;
+    completedAt: z.ZodNullable<z.ZodString>;
+    errorMessage: z.ZodNullable<z.ZodObject<{
+        untrusted: z.ZodLiteral<true>;
+        value: z.ZodString;
+    }, z.core.$strip>>;
+    stepType: z.ZodString;
+    checkOutcome: z.ZodNullable<z.ZodEnum<{
+        skipped: "skipped";
+        applied: "applied";
+        declined: "declined";
+        "dry-run": "dry-run";
+        no_check: "no_check";
+    }>>;
+    secretsAccessed: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type AgentStepResult = z.infer<typeof agentStepResultSchema>;
+export declare const agentJobResultSchema: z.ZodObject<{
+    jobId: z.ZodString;
+    jobName: z.ZodObject<{
+        untrusted: z.ZodLiteral<true>;
+        value: z.ZodString;
+    }, z.core.$strip>;
+    status: z.ZodEnum<{
+        skipped: "skipped";
+        success: "success";
+        pending: "pending";
+        running: "running";
+        failed: "failed";
+        cancelled: "cancelled";
+        cancelling: "cancelling";
+        queued: "queued";
+        recovering: "recovering";
+        timed_out_stale: "timed_out_stale";
+        drift_dropped: "drift_dropped";
+    }>;
+    startedAt: z.ZodNullable<z.ZodString>;
+    completedAt: z.ZodNullable<z.ZodString>;
+    durationMs: z.ZodNullable<z.ZodNumber>;
+    agentId: z.ZodNullable<z.ZodString>;
+    errorMessage: z.ZodNullable<z.ZodObject<{
+        untrusted: z.ZodLiteral<true>;
+        value: z.ZodString;
+    }, z.core.$strip>>;
+    initFailure: z.ZodNullable<z.ZodObject<{
+        scope: z.ZodEnum<{
+            run: "run";
+            job: "job";
+        }>;
+        category: z.ZodEnum<{
+            secret_resolution: "secret_resolution";
+            install_secrets: "install_secrets";
+            lock_resolution: "lock_resolution";
+            build_coordination: "build_coordination";
+            environment_rules: "environment_rules";
+            dynamic_eval: "dynamic_eval";
+            no_agent: "no_agent";
+            matrix_expansion: "matrix_expansion";
+        }>;
+        message: z.ZodObject<{
+            untrusted: z.ZodLiteral<true>;
+            value: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    needs: z.ZodArray<z.ZodObject<{
+        ref: z.ZodObject<{
+            untrusted: z.ZodLiteral<true>;
+            value: z.ZodString;
+        }, z.core.$strip>;
+        runOn: z.ZodArray<z.ZodEnum<{
+            skipped: "skipped";
+            success: "success";
+            pending: "pending";
+            running: "running";
+            failed: "failed";
+            cancelled: "cancelled";
+            cancelling: "cancelling";
+            queued: "queued";
+            recovering: "recovering";
+            timed_out_stale: "timed_out_stale";
+            drift_dropped: "drift_dropped";
+        }>>;
+    }, z.core.$strip>>;
+    outputs: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodObject<{
+        untrusted: z.ZodLiteral<true>;
+        value: z.ZodString;
+    }, z.core.$strip>>>;
+    secretOutputKeys: z.ZodArray<z.ZodString>;
+    steps: z.ZodArray<z.ZodObject<{
+        stepIndex: z.ZodNumber;
+        stepName: z.ZodObject<{
+            untrusted: z.ZodLiteral<true>;
+            value: z.ZodString;
+        }, z.core.$strip>;
+        status: z.ZodEnum<{
+            skipped: "skipped";
+            success: "success";
+            pending: "pending";
+            running: "running";
+            failed: "failed";
+            cancelled: "cancelled";
+        }>;
+        exitCode: z.ZodNullable<z.ZodNumber>;
+        durationMs: z.ZodNullable<z.ZodNumber>;
+        startedAt: z.ZodNullable<z.ZodString>;
+        completedAt: z.ZodNullable<z.ZodString>;
+        errorMessage: z.ZodNullable<z.ZodObject<{
+            untrusted: z.ZodLiteral<true>;
+            value: z.ZodString;
+        }, z.core.$strip>>;
+        stepType: z.ZodString;
+        checkOutcome: z.ZodNullable<z.ZodEnum<{
+            skipped: "skipped";
+            applied: "applied";
+            declined: "declined";
+            "dry-run": "dry-run";
+            no_check: "no_check";
+        }>>;
+        secretsAccessed: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type AgentJobResult = z.infer<typeof agentJobResultSchema>;
+export declare const agentRunResultSchema: z.ZodObject<{
+    runId: z.ZodString;
+    workflowName: z.ZodObject<{
+        untrusted: z.ZodLiteral<true>;
+        value: z.ZodString;
+    }, z.core.$strip>;
+    status: z.ZodEnum<{
+        success: "success";
+        pending: "pending";
+        running: "running";
+        failed: "failed";
+        cancelled: "cancelled";
+        cancelling: "cancelling";
+        held: "held";
+    }>;
+    provider: z.ZodString;
+    repoIdentifier: z.ZodObject<{
+        untrusted: z.ZodLiteral<true>;
+        value: z.ZodString;
+    }, z.core.$strip>;
+    ref: z.ZodObject<{
+        untrusted: z.ZodLiteral<true>;
+        value: z.ZodString;
+    }, z.core.$strip>;
+    sha: z.ZodString;
+    baseSha: z.ZodNullable<z.ZodString>;
+    startedAt: z.ZodNullable<z.ZodString>;
+    completedAt: z.ZodNullable<z.ZodString>;
+    durationMs: z.ZodNullable<z.ZodNumber>;
+    trustTier: z.ZodNullable<z.ZodEnum<{
+        unknown: "unknown";
+        known: "known";
+        trusted: "trusted";
+    }>>;
+    contributorUsername: z.ZodNullable<z.ZodObject<{
+        untrusted: z.ZodLiteral<true>;
+        value: z.ZodString;
+    }, z.core.$strip>>;
+    failureCategory: z.ZodNullable<z.ZodEnum<{
+        unknown: "unknown";
+        cancelled: "cancelled";
+        init_failure: "init_failure";
+        timed_out: "timed_out";
+        step_failed: "step_failed";
+        infra: "infra";
+    }>>;
+    failureReason: z.ZodNullable<z.ZodObject<{
+        untrusted: z.ZodLiteral<true>;
+        value: z.ZodString;
+    }, z.core.$strip>>;
+    triggeredBy: z.ZodNullable<z.ZodString>;
+    jobs: z.ZodArray<z.ZodObject<{
+        jobId: z.ZodString;
+        jobName: z.ZodObject<{
+            untrusted: z.ZodLiteral<true>;
+            value: z.ZodString;
+        }, z.core.$strip>;
+        status: z.ZodEnum<{
+            skipped: "skipped";
+            success: "success";
+            pending: "pending";
+            running: "running";
+            failed: "failed";
+            cancelled: "cancelled";
+            cancelling: "cancelling";
+            queued: "queued";
+            recovering: "recovering";
+            timed_out_stale: "timed_out_stale";
+            drift_dropped: "drift_dropped";
+        }>;
+        startedAt: z.ZodNullable<z.ZodString>;
+        completedAt: z.ZodNullable<z.ZodString>;
+        durationMs: z.ZodNullable<z.ZodNumber>;
+        agentId: z.ZodNullable<z.ZodString>;
+        errorMessage: z.ZodNullable<z.ZodObject<{
+            untrusted: z.ZodLiteral<true>;
+            value: z.ZodString;
+        }, z.core.$strip>>;
+        initFailure: z.ZodNullable<z.ZodObject<{
+            scope: z.ZodEnum<{
+                run: "run";
+                job: "job";
+            }>;
+            category: z.ZodEnum<{
+                secret_resolution: "secret_resolution";
+                install_secrets: "install_secrets";
+                lock_resolution: "lock_resolution";
+                build_coordination: "build_coordination";
+                environment_rules: "environment_rules";
+                dynamic_eval: "dynamic_eval";
+                no_agent: "no_agent";
+                matrix_expansion: "matrix_expansion";
+            }>;
+            message: z.ZodObject<{
+                untrusted: z.ZodLiteral<true>;
+                value: z.ZodString;
+            }, z.core.$strip>;
+        }, z.core.$strip>>;
+        needs: z.ZodArray<z.ZodObject<{
+            ref: z.ZodObject<{
+                untrusted: z.ZodLiteral<true>;
+                value: z.ZodString;
+            }, z.core.$strip>;
+            runOn: z.ZodArray<z.ZodEnum<{
+                skipped: "skipped";
+                success: "success";
+                pending: "pending";
+                running: "running";
+                failed: "failed";
+                cancelled: "cancelled";
+                cancelling: "cancelling";
+                queued: "queued";
+                recovering: "recovering";
+                timed_out_stale: "timed_out_stale";
+                drift_dropped: "drift_dropped";
+            }>>;
+        }, z.core.$strip>>;
+        outputs: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodObject<{
+            untrusted: z.ZodLiteral<true>;
+            value: z.ZodString;
+        }, z.core.$strip>>>;
+        secretOutputKeys: z.ZodArray<z.ZodString>;
+        steps: z.ZodArray<z.ZodObject<{
+            stepIndex: z.ZodNumber;
+            stepName: z.ZodObject<{
+                untrusted: z.ZodLiteral<true>;
+                value: z.ZodString;
+            }, z.core.$strip>;
+            status: z.ZodEnum<{
+                skipped: "skipped";
+                success: "success";
+                pending: "pending";
+                running: "running";
+                failed: "failed";
+                cancelled: "cancelled";
+            }>;
+            exitCode: z.ZodNullable<z.ZodNumber>;
+            durationMs: z.ZodNullable<z.ZodNumber>;
+            startedAt: z.ZodNullable<z.ZodString>;
+            completedAt: z.ZodNullable<z.ZodString>;
+            errorMessage: z.ZodNullable<z.ZodObject<{
+                untrusted: z.ZodLiteral<true>;
+                value: z.ZodString;
+            }, z.core.$strip>>;
+            stepType: z.ZodString;
+            checkOutcome: z.ZodNullable<z.ZodEnum<{
+                skipped: "skipped";
+                applied: "applied";
+                declined: "declined";
+                "dry-run": "dry-run";
+                no_check: "no_check";
+            }>>;
+            secretsAccessed: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type AgentRunResult = z.infer<typeof agentRunResultSchema>;
+export declare const agentStepLogsSchema: z.ZodObject<{
+    runId: z.ZodString;
+    jobId: z.ZodString;
+    stepIndex: z.ZodNumber;
+    totalLines: z.ZodNumber;
+    lines: z.ZodArray<z.ZodObject<{
+        untrusted: z.ZodLiteral<true>;
+        value: z.ZodString;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type AgentStepLogs = z.infer<typeof agentStepLogsSchema>;
+//# sourceMappingURL=agent-run-result.d.ts.map

package/dist/protocol/messages/agent-run-result.js

@@ -0,0 +1,123 @@
+import "../../chunk-BTugEXQM.js";
+import { CheckStepOutcome } from "../../check-mode.js";
+import { ExecutionJobStatus, ExecutionRunStatus, ExecutionStepStatus, InitFailureCategory } from "./execution-status.js";
+import { TrustTierSchema } from "../../environment/types.js";
+import { z } from "zod";
+//#region src/protocol/messages/agent-run-result.ts
+/**
+* Agent-facing, provenance-tagged run-result schema.
+*
+* A machine-first read shape for a run: the typed job DAG, per-step exit codes,
+* durations, statuses, and a coarse derived failure classification. Every field
+* an agent could be tricked by — names, refs, error text, log lines, job outputs —
+* is wrapped in an {@link untrusted} envelope so a consumer can keep
+* user-controlled content out of an instruction channel. KiCI-generated values
+* (ids, enum statuses, exit codes, durations, hashes, derived categories) stay
+* plain (trusted).
+*
+* Read-only contract — produced by the orchestrator admin run API and consumed by
+* agents / the developer MCP server. Reuses the existing execution status enums;
+* never define a parallel status string.
+*/
+/**
+* Wrap a value KiCI does not vouch for — content from the user's repo, the
+* contributor, or a process's output. Trusted fields are left plain. The
+* envelope self-tags so the value survives reshaping / fencing: a renderer that
+* fences untrusted content just refuses to emit any `{ untrusted: true }` value
+* into an instruction channel.
+*/
+const untrusted = (v) => z.object({
+	untrusted: z.literal(true),
+	value: v
+});
+/** Construct an untrusted envelope around a runtime value. */
+function wrapUntrusted(value) {
+	return {
+		untrusted: true,
+		value
+	};
+}
+const untrustedString = untrusted(z.string());
+const untrustedStringNullable = untrusted(z.string()).nullable();
+/** Coarse, derived run-failure classification (trusted — KiCI computes it). */
+const AgentFailureCategory = z.enum([
+	"init_failure",
+	"timed_out",
+	"step_failed",
+	"cancelled",
+	"infra",
+	"unknown"
+]);
+const agentStepResultSchema = z.object({
+	stepIndex: z.number().int(),
+	stepName: untrustedString,
+	status: ExecutionStepStatus,
+	exitCode: z.number().int().nullable(),
+	durationMs: z.number().nullable(),
+	startedAt: z.string().nullable(),
+	completedAt: z.string().nullable(),
+	errorMessage: untrustedStringNullable,
+	/** Existing `step_type` discriminator (e.g. `step`, `hook:cleanup`, `cache:save`). */
+	stepType: z.string(),
+	checkOutcome: CheckStepOutcome.nullable(),
+	/** Secret context key names accessed by this step — names only, never values. */
+	secretsAccessed: z.array(z.string())
+});
+const agentJobResultSchema = z.object({
+	jobId: z.string(),
+	jobName: untrustedString,
+	status: ExecutionJobStatus,
+	startedAt: z.string().nullable(),
+	completedAt: z.string().nullable(),
+	durationMs: z.number().nullable(),
+	agentId: z.string().nullable(),
+	errorMessage: untrustedStringNullable,
+	initFailure: z.object({
+		scope: z.enum(["run", "job"]),
+		category: InitFailureCategory,
+		message: untrustedString
+	}).nullable(),
+	needs: z.array(z.object({
+		ref: untrustedString,
+		runOn: z.array(ExecutionJobStatus)
+	})),
+	/** Non-secret job outputs only (secret outputs are surfaced as key names). */
+	outputs: z.record(z.string(), untrustedString).nullable(),
+	/** Secret output key names produced by this job — names only, never values. */
+	secretOutputKeys: z.array(z.string()),
+	steps: z.array(agentStepResultSchema)
+});
+const agentRunResultSchema = z.object({
+	runId: z.string(),
+	workflowName: untrustedString,
+	status: ExecutionRunStatus,
+	provider: z.string(),
+	repoIdentifier: untrustedString,
+	ref: untrustedString,
+	sha: z.string(),
+	/** Best-effort base commit (provider context); null when unavailable. */
+	baseSha: z.string().nullable(),
+	startedAt: z.string().nullable(),
+	completedAt: z.string().nullable(),
+	durationMs: z.number().nullable(),
+	trustTier: TrustTierSchema.nullable(),
+	contributorUsername: untrustedStringNullable,
+	failureCategory: AgentFailureCategory.nullable(),
+	failureReason: untrustedStringNullable,
+	/** Identity that triggered a re-run (null for webhook-triggered runs). */
+	triggeredBy: z.string().nullable(),
+	jobs: z.array(agentJobResultSchema)
+});
+const agentStepLogsSchema = z.object({
+	runId: z.string(),
+	jobId: z.string(),
+	stepIndex: z.number().int(),
+	totalLines: z.number().int(),
+	/** Every log line is user/process-controlled — each is enveloped untrusted. */
+	lines: z.array(untrustedString),
+	nextCursor: z.string().nullable()
+});
+//#endregion
+export { AgentFailureCategory, agentJobResultSchema, agentRunResultSchema, agentStepLogsSchema, agentStepResultSchema, untrusted, wrapUntrusted };
+
+//# sourceMappingURL=agent-run-result.js.map

package/dist/protocol/messages/auth.d.ts

@@ -37,6 +37,7 @@ export declare const authRequestSchema: z.ZodObject<{
             "fleet.host.declare": "fleet.host.declare";
             "fleet.host.remove": "fleet.host.remove";
         }> & z.core.$partial, z.ZodBoolean>>;
+        supportedDashboardRequests: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$loose>>;
 }, z.core.$strip>;
 /** Auth success response sent by Platform to orchestrator after successful authentication. */
@@ -45,6 +46,7 @@ export declare const authSuccessSchema: z.ZodObject<{
     connectionId: z.ZodString;
     orgPublicAlias: z.ZodOptional<z.ZodString>;
     orgId: z.ZodOptional<z.ZodString>;
+    provenanceIssuer: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
 /** Auth failure response sent by Platform to orchestrator when authentication fails. */
 export declare const authFailureSchema: z.ZodObject<{

package/dist/protocol/messages/auth.js

@@ -32,7 +32,16 @@ const authSuccessSchema = z.object({
 	* that don't yet supply it; when absent, the orchestrator skips
 	* remote-source provisioning.
 	*/
-	orgId: z.string().optional()
+	orgId: z.string().optional(),
+	/**
+	* Provenance trust root (the OIDC issuer) the Platform mints build-provenance
+	* tokens under. The orchestrator uses it to verify provenance bundles at
+	* ingest: it derives the JWKS URI (`<issuer>/.well-known/jwks.json`) and
+	* caches the key set. `null` (or absent) means provenance is not configured —
+	* the orchestrator records each attestation's verdict as `unverifiable`
+	* rather than silently `verified`.
+	*/
+	provenanceIssuer: z.string().nullable().optional()
 });
 /** Auth failure response sent by Platform to orchestrator when authentication fails. */
 const authFailureSchema = z.object({

package/dist/protocol/messages/capabilities.d.ts

@@ -56,12 +56,14 @@ export declare const orchCapabilitiesSchema: z.ZodObject<{
         "fleet.host.declare": "fleet.host.declare";
         "fleet.host.remove": "fleet.host.remove";
     }> & z.core.$partial, z.ZodBoolean>>;
+    supportedDashboardRequests: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$loose>;
 /** Inferred type for orchestrator capabilities. */
 export type OrchCapabilities = z.infer<typeof orchCapabilitiesSchema>;
 /** Default orchestrator capabilities sent in auth.request. */
 export declare const ORCH_CAPABILITIES: Readonly<{
     orchRole: "coordinator";
+    supportedDashboardRequests: string[];
 }>;
 /**
  * Check whether an orchestrator advertises a specific capability flag.

package/dist/protocol/messages/capabilities.js

@@ -1,5 +1,6 @@
 import "../../chunk-BTugEXQM.js";
 import { dashboardWritePolicyMap } from "../dashboard-write-operations.js";
+import { DASHBOARD_REQUEST_TYPES } from "./dashboard.js";
 import { z } from "zod";
 //#region src/protocol/messages/capabilities.ts
 /**
@@ -33,10 +34,22 @@ const orchCapabilitiesSchema = z.object({
 	* the standalone `orch.capabilities.update` message on policy
 	* change (see platform-orchestrator.ts).
 	*/
-	dashboardWrites: dashboardWritePolicyMap.optional()
+	dashboardWrites: dashboardWritePolicyMap.optional(),
+	/**
+	* Every `dashboard.*` request type this orchestrator build understands.
+	* The Platform pre-flight-checks an incoming dashboard request against this
+	* set and refuses (with a precise "upgrade orchestrator" error) when the
+	* type is absent. Derived from the orchestrator's own protocol schema, so it
+	* cannot drift. Absent on pre-capability builds → treated as "unknown",
+	* never as "supports nothing".
+	*/
+	supportedDashboardRequests: z.array(z.string()).optional()
 }).passthrough();
 /** Default orchestrator capabilities sent in auth.request. */
-const ORCH_CAPABILITIES = Object.freeze({ orchRole: OrchRole.enum.coordinator });
+const ORCH_CAPABILITIES = Object.freeze({
+	orchRole: OrchRole.enum.coordinator,
+	supportedDashboardRequests: [...DASHBOARD_REQUEST_TYPES]
+});
 /**
 * Check whether an orchestrator advertises a specific capability flag.
 *

package/dist/protocol/messages/dashboard-global-workflows.d.ts

@@ -56,6 +56,10 @@ export declare const globalWorkflowsGetRequestSchema: z.ZodObject<{
     actor: z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodLiteral<"user">;
         sub: z.ZodString;
+        agent: z.ZodOptional<z.ZodObject<{
+            patId: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strip>>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"api_key">;
         keyId: z.ZodString;
@@ -85,6 +89,10 @@ export declare const globalWorkflowsUpdateRequestSchema: z.ZodObject<{
     actor: z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodLiteral<"user">;
         sub: z.ZodString;
+        agent: z.ZodOptional<z.ZodObject<{
+            patId: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strip>>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"api_key">;
         keyId: z.ZodString;