@kya-os/contracts 1.7.24 → 1.7.26

package/dist/agent-deployment.d.ts

@@ -0,0 +1,723 @@
+/**
+ * Managed Agent Deployment Contracts
+ *
+ * Schemas for the managed hosting tier where agents run on Fly.io
+ * instead of user-managed Cloudflare Workers.
+ *
+ * @package @kya-os/contracts/agent-deployment
+ */
+import { z } from "zod";
+/**
+ * Validated DID string schema.
+ * Reusable across all contract files that reference agent DIDs.
+ *
+ * Format: `did:<method>:<method-specific-id>`
+ * - method: 1+ lowercase alphanumeric chars
+ * - method-specific-id: 1+ non-whitespace chars
+ *
+ * Examples: `did:key:z6Mk...`, `did:web:example.com`
+ */
+export declare const DidStringSchema: z.ZodString;
+/**
+ * Fly.io deployment regions.
+ * Enumerated to prevent arbitrary strings from being accepted.
+ * @see https://fly.io/docs/reference/regions/
+ */
+export declare const FlyRegionSchema: z.ZodEnum<["ams", "arn", "atl", "bog", "bos", "cdg", "den", "dfw", "ewr", "eze", "fra", "gdl", "gig", "gru", "hkg", "iad", "jnb", "lax", "lhr", "mad", "mia", "nrt", "ord", "otp", "phx", "qro", "scl", "sea", "sin", "sjc", "syd", "waw", "yul", "yyz"]>;
+export type FlyRegion = z.infer<typeof FlyRegionSchema>;
+/**
+ * Agent lifecycle status — tracks the full state machine
+ * from initial provisioning through running to permanent revocation.
+ */
+export declare const AgentStatusSchema: z.ZodEnum<["provisioning", "starting", "running", "stopping", "stopped", "error", "revoked"]>;
+export type AgentStatus = z.infer<typeof AgentStatusSchema>;
+/**
+ * Hosting mode discriminator — differentiates between
+ * self-managed BYOK deploys and platform-managed deploys.
+ */
+export declare const HostingModeSchema: z.ZodEnum<["byok", "managed"]>;
+export type HostingMode = z.infer<typeof HostingModeSchema>;
+/**
+ * Request body for POST /api/v1/molti/deploy/managed/fly
+ *
+ * Validated server-side before any resources are created.
+ * The name field becomes the agent's subdomain: {name}.agents.kya-os.ai
+ */
+export declare const ManagedDeployRequestSchema: z.ZodObject<{
+    /** Agent name — becomes DNS subdomain. Must be DNS-safe. */
+    name: z.ZodString;
+    /** AI provider for inference */
+    aiProvider: z.ZodEnum<["anthropic", "openai"]>;
+    /** User's AI API key — encrypted before storage */
+    aiApiKey: z.ZodString;
+    /** Fly.io deployment region */
+    region: z.ZodDefault<z.ZodEnum<["ams", "arn", "atl", "bog", "bos", "cdg", "den", "dfw", "ewr", "eze", "fra", "gdl", "gig", "gru", "hkg", "iad", "jnb", "lax", "lhr", "mad", "mia", "nrt", "ord", "otp", "phx", "qro", "scl", "sea", "sin", "sjc", "syd", "waw", "yul", "yyz"]>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    aiProvider: "anthropic" | "openai";
+    aiApiKey: string;
+    region: "ams" | "arn" | "atl" | "bog" | "bos" | "cdg" | "den" | "dfw" | "ewr" | "eze" | "fra" | "gdl" | "gig" | "gru" | "hkg" | "iad" | "jnb" | "lax" | "lhr" | "mad" | "mia" | "nrt" | "ord" | "otp" | "phx" | "qro" | "scl" | "sea" | "sin" | "sjc" | "syd" | "waw" | "yul" | "yyz";
+}, {
+    name: string;
+    aiProvider: "anthropic" | "openai";
+    aiApiKey: string;
+    region?: "ams" | "arn" | "atl" | "bog" | "bos" | "cdg" | "den" | "dfw" | "ewr" | "eze" | "fra" | "gdl" | "gig" | "gru" | "hkg" | "iad" | "jnb" | "lax" | "lhr" | "mad" | "mia" | "nrt" | "ord" | "otp" | "phx" | "qro" | "scl" | "sea" | "sin" | "sjc" | "syd" | "waw" | "yul" | "yyz" | undefined;
+}>;
+export type ManagedDeployRequest = z.infer<typeof ManagedDeployRequestSchema>;
+/**
+ * Successful managed deployment result.
+ * Returned at the end of the SSE stream as the "complete" event data.
+ */
+export declare const ManagedDeployResultSchema: z.ZodObject<{
+    /** Agent DID — the primary identifier */
+    agentDid: z.ZodString;
+    /** Live agent URL (e.g., https://my-agent.agents.kya-os.ai) */
+    agentUrl: z.ZodString;
+    /** Current agent status */
+    status: z.ZodEnum<["provisioning", "starting", "running", "stopping", "stopped", "error", "revoked"]>;
+    /** AgentShield project ID */
+    projectId: z.ZodString;
+    /** AgentShield project friendly ID */
+    friendlyId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    status: "provisioning" | "starting" | "running" | "stopping" | "stopped" | "error" | "revoked";
+    agentDid: string;
+    agentUrl: string;
+    projectId: string;
+    friendlyId: string;
+}, {
+    status: "provisioning" | "starting" | "running" | "stopping" | "stopped" | "error" | "revoked";
+    agentDid: string;
+    agentUrl: string;
+    projectId: string;
+    friendlyId: string;
+}>;
+export type ManagedDeployResult = z.infer<typeof ManagedDeployResultSchema>;
+/**
+ * Steps in the managed deploy pipeline.
+ * Different from BYOK steps — no GitHub, no Cloudflare.
+ */
+export declare const ManagedDeployStepIdSchema: z.ZodEnum<["identity_create", "project_create", "kta_register", "fly_provision", "compute_boot", "health_check"]>;
+export type ManagedDeployStepId = z.infer<typeof ManagedDeployStepIdSchema>;
+/**
+ * Human-readable names for each managed deploy step.
+ * Used by the frontend progress UI.
+ */
+export declare const MANAGED_DEPLOY_STEP_NAMES: Record<ManagedDeployStepId, string>;
+/**
+ * Deploy step status — reuses same status enum as BYOK.
+ */
+export declare const ManagedDeployStepStatusSchema: z.ZodEnum<["pending", "in_progress", "completed", "failed", "skipped"]>;
+/**
+ * Individual managed deploy step with timing.
+ */
+export declare const ManagedDeployStepSchema: z.ZodObject<{
+    id: z.ZodEnum<["identity_create", "project_create", "kta_register", "fly_provision", "compute_boot", "health_check"]>;
+    name: z.ZodString;
+    status: z.ZodEnum<["pending", "in_progress", "completed", "failed", "skipped"]>;
+    message: z.ZodOptional<z.ZodString>;
+    startedAt: z.ZodOptional<z.ZodString>;
+    completedAt: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
+    name: string;
+    id: "identity_create" | "project_create" | "kta_register" | "fly_provision" | "compute_boot" | "health_check";
+    message?: string | undefined;
+    startedAt?: string | undefined;
+    completedAt?: string | undefined;
+}, {
+    status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
+    name: string;
+    id: "identity_create" | "project_create" | "kta_register" | "fly_provision" | "compute_boot" | "health_check";
+    message?: string | undefined;
+    startedAt?: string | undefined;
+    completedAt?: string | undefined;
+}>;
+/**
+ * Overall managed deployment progress — sent via SSE "progress" events.
+ */
+export declare const ManagedDeployProgressSchema: z.ZodObject<{
+    deploymentId: z.ZodString;
+    steps: z.ZodArray<z.ZodObject<{
+        id: z.ZodEnum<["identity_create", "project_create", "kta_register", "fly_provision", "compute_boot", "health_check"]>;
+        name: z.ZodString;
+        status: z.ZodEnum<["pending", "in_progress", "completed", "failed", "skipped"]>;
+        message: z.ZodOptional<z.ZodString>;
+        startedAt: z.ZodOptional<z.ZodString>;
+        completedAt: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
+        name: string;
+        id: "identity_create" | "project_create" | "kta_register" | "fly_provision" | "compute_boot" | "health_check";
+        message?: string | undefined;
+        startedAt?: string | undefined;
+        completedAt?: string | undefined;
+    }, {
+        status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
+        name: string;
+        id: "identity_create" | "project_create" | "kta_register" | "fly_provision" | "compute_boot" | "health_check";
+        message?: string | undefined;
+        startedAt?: string | undefined;
+        completedAt?: string | undefined;
+    }>, "many">;
+    currentStep: z.ZodNumber;
+    totalSteps: z.ZodNumber;
+    overallStatus: z.ZodEnum<["pending", "in_progress", "completed", "failed"]>;
+}, "strip", z.ZodTypeAny, {
+    deploymentId: string;
+    steps: {
+        status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
+        name: string;
+        id: "identity_create" | "project_create" | "kta_register" | "fly_provision" | "compute_boot" | "health_check";
+        message?: string | undefined;
+        startedAt?: string | undefined;
+        completedAt?: string | undefined;
+    }[];
+    currentStep: number;
+    totalSteps: number;
+    overallStatus: "pending" | "in_progress" | "completed" | "failed";
+}, {
+    deploymentId: string;
+    steps: {
+        status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
+        name: string;
+        id: "identity_create" | "project_create" | "kta_register" | "fly_provision" | "compute_boot" | "health_check";
+        message?: string | undefined;
+        startedAt?: string | undefined;
+        completedAt?: string | undefined;
+    }[];
+    currentStep: number;
+    totalSteps: number;
+    overallStatus: "pending" | "in_progress" | "completed" | "failed";
+}>;
+export type ManagedDeployProgress = z.infer<typeof ManagedDeployProgressSchema>;
+/**
+ * Error codes specific to managed deployment failures.
+ */
+export declare const ManagedDeployErrorCodeSchema: z.ZodEnum<["IDENTITY_ERROR", "PROJECT_CREATION_ERROR", "KTA_REGISTRATION_ERROR", "FLY_PROVISION_FAILED", "COMPUTE_BOOT_TIMEOUT", "HEALTH_CHECK_FAILED", "RATE_LIMIT_EXCEEDED", "NAME_TAKEN", "INTERNAL_ERROR"]>;
+export type ManagedDeployErrorCode = z.infer<typeof ManagedDeployErrorCodeSchema>;
+/**
+ * Managed deploy error response.
+ */
+export declare const ManagedDeployErrorResponseSchema: z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    error: z.ZodObject<{
+        code: z.ZodEnum<["IDENTITY_ERROR", "PROJECT_CREATION_ERROR", "KTA_REGISTRATION_ERROR", "FLY_PROVISION_FAILED", "COMPUTE_BOOT_TIMEOUT", "HEALTH_CHECK_FAILED", "RATE_LIMIT_EXCEEDED", "NAME_TAKEN", "INTERNAL_ERROR"]>;
+        message: z.ZodString;
+        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        code: "IDENTITY_ERROR" | "PROJECT_CREATION_ERROR" | "KTA_REGISTRATION_ERROR" | "FLY_PROVISION_FAILED" | "COMPUTE_BOOT_TIMEOUT" | "HEALTH_CHECK_FAILED" | "RATE_LIMIT_EXCEEDED" | "NAME_TAKEN" | "INTERNAL_ERROR";
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    }, {
+        code: "IDENTITY_ERROR" | "PROJECT_CREATION_ERROR" | "KTA_REGISTRATION_ERROR" | "FLY_PROVISION_FAILED" | "COMPUTE_BOOT_TIMEOUT" | "HEALTH_CHECK_FAILED" | "RATE_LIMIT_EXCEEDED" | "NAME_TAKEN" | "INTERNAL_ERROR";
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    error: {
+        code: "IDENTITY_ERROR" | "PROJECT_CREATION_ERROR" | "KTA_REGISTRATION_ERROR" | "FLY_PROVISION_FAILED" | "COMPUTE_BOOT_TIMEOUT" | "HEALTH_CHECK_FAILED" | "RATE_LIMIT_EXCEEDED" | "NAME_TAKEN" | "INTERNAL_ERROR";
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    };
+    success: false;
+}, {
+    error: {
+        code: "IDENTITY_ERROR" | "PROJECT_CREATION_ERROR" | "KTA_REGISTRATION_ERROR" | "FLY_PROVISION_FAILED" | "COMPUTE_BOOT_TIMEOUT" | "HEALTH_CHECK_FAILED" | "RATE_LIMIT_EXCEEDED" | "NAME_TAKEN" | "INTERNAL_ERROR";
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    };
+    success: false;
+}>;
+/**
+ * Managed deploy success response.
+ */
+export declare const ManagedDeploySuccessResponseSchema: z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        /** Agent DID — the primary identifier */
+        agentDid: z.ZodString;
+        /** Live agent URL (e.g., https://my-agent.agents.kya-os.ai) */
+        agentUrl: z.ZodString;
+        /** Current agent status */
+        status: z.ZodEnum<["provisioning", "starting", "running", "stopping", "stopped", "error", "revoked"]>;
+        /** AgentShield project ID */
+        projectId: z.ZodString;
+        /** AgentShield project friendly ID */
+        friendlyId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        status: "provisioning" | "starting" | "running" | "stopping" | "stopped" | "error" | "revoked";
+        agentDid: string;
+        agentUrl: string;
+        projectId: string;
+        friendlyId: string;
+    }, {
+        status: "provisioning" | "starting" | "running" | "stopping" | "stopped" | "error" | "revoked";
+        agentDid: string;
+        agentUrl: string;
+        projectId: string;
+        friendlyId: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    success: true;
+    data: {
+        status: "provisioning" | "starting" | "running" | "stopping" | "stopped" | "error" | "revoked";
+        agentDid: string;
+        agentUrl: string;
+        projectId: string;
+        friendlyId: string;
+    };
+}, {
+    success: true;
+    data: {
+        status: "provisioning" | "starting" | "running" | "stopping" | "stopped" | "error" | "revoked";
+        agentDid: string;
+        agentUrl: string;
+        projectId: string;
+        friendlyId: string;
+    };
+}>;
+/**
+ * Union response type for managed deploy endpoint.
+ */
+export declare const ManagedDeployResponseSchema: z.ZodDiscriminatedUnion<"success", [z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        /** Agent DID — the primary identifier */
+        agentDid: z.ZodString;
+        /** Live agent URL (e.g., https://my-agent.agents.kya-os.ai) */
+        agentUrl: z.ZodString;
+        /** Current agent status */
+        status: z.ZodEnum<["provisioning", "starting", "running", "stopping", "stopped", "error", "revoked"]>;
+        /** AgentShield project ID */
+        projectId: z.ZodString;
+        /** AgentShield project friendly ID */
+        friendlyId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        status: "provisioning" | "starting" | "running" | "stopping" | "stopped" | "error" | "revoked";
+        agentDid: string;
+        agentUrl: string;
+        projectId: string;
+        friendlyId: string;
+    }, {
+        status: "provisioning" | "starting" | "running" | "stopping" | "stopped" | "error" | "revoked";
+        agentDid: string;
+        agentUrl: string;
+        projectId: string;
+        friendlyId: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    success: true;
+    data: {
+        status: "provisioning" | "starting" | "running" | "stopping" | "stopped" | "error" | "revoked";
+        agentDid: string;
+        agentUrl: string;
+        projectId: string;
+        friendlyId: string;
+    };
+}, {
+    success: true;
+    data: {
+        status: "provisioning" | "starting" | "running" | "stopping" | "stopped" | "error" | "revoked";
+        agentDid: string;
+        agentUrl: string;
+        projectId: string;
+        friendlyId: string;
+    };
+}>, z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    error: z.ZodObject<{
+        code: z.ZodEnum<["IDENTITY_ERROR", "PROJECT_CREATION_ERROR", "KTA_REGISTRATION_ERROR", "FLY_PROVISION_FAILED", "COMPUTE_BOOT_TIMEOUT", "HEALTH_CHECK_FAILED", "RATE_LIMIT_EXCEEDED", "NAME_TAKEN", "INTERNAL_ERROR"]>;
+        message: z.ZodString;
+        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        code: "IDENTITY_ERROR" | "PROJECT_CREATION_ERROR" | "KTA_REGISTRATION_ERROR" | "FLY_PROVISION_FAILED" | "COMPUTE_BOOT_TIMEOUT" | "HEALTH_CHECK_FAILED" | "RATE_LIMIT_EXCEEDED" | "NAME_TAKEN" | "INTERNAL_ERROR";
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    }, {
+        code: "IDENTITY_ERROR" | "PROJECT_CREATION_ERROR" | "KTA_REGISTRATION_ERROR" | "FLY_PROVISION_FAILED" | "COMPUTE_BOOT_TIMEOUT" | "HEALTH_CHECK_FAILED" | "RATE_LIMIT_EXCEEDED" | "NAME_TAKEN" | "INTERNAL_ERROR";
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    error: {
+        code: "IDENTITY_ERROR" | "PROJECT_CREATION_ERROR" | "KTA_REGISTRATION_ERROR" | "FLY_PROVISION_FAILED" | "COMPUTE_BOOT_TIMEOUT" | "HEALTH_CHECK_FAILED" | "RATE_LIMIT_EXCEEDED" | "NAME_TAKEN" | "INTERNAL_ERROR";
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    };
+    success: false;
+}, {
+    error: {
+        code: "IDENTITY_ERROR" | "PROJECT_CREATION_ERROR" | "KTA_REGISTRATION_ERROR" | "FLY_PROVISION_FAILED" | "COMPUTE_BOOT_TIMEOUT" | "HEALTH_CHECK_FAILED" | "RATE_LIMIT_EXCEEDED" | "NAME_TAKEN" | "INTERNAL_ERROR";
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    };
+    success: false;
+}>]>;
+export declare const ManagedSSEProgressEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"progress">;
+    data: z.ZodObject<{
+        deploymentId: z.ZodString;
+        steps: z.ZodArray<z.ZodObject<{
+            id: z.ZodEnum<["identity_create", "project_create", "kta_register", "fly_provision", "compute_boot", "health_check"]>;
+            name: z.ZodString;
+            status: z.ZodEnum<["pending", "in_progress", "completed", "failed", "skipped"]>;
+            message: z.ZodOptional<z.ZodString>;
+            startedAt: z.ZodOptional<z.ZodString>;
+            completedAt: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
+            name: string;
+            id: "identity_create" | "project_create" | "kta_register" | "fly_provision" | "compute_boot" | "health_check";
+            message?: string | undefined;
+            startedAt?: string | undefined;
+            completedAt?: string | undefined;
+        }, {
+            status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
+            name: string;
+            id: "identity_create" | "project_create" | "kta_register" | "fly_provision" | "compute_boot" | "health_check";
+            message?: string | undefined;
+            startedAt?: string | undefined;
+            completedAt?: string | undefined;
+        }>, "many">;
+        currentStep: z.ZodNumber;
+        totalSteps: z.ZodNumber;
+        overallStatus: z.ZodEnum<["pending", "in_progress", "completed", "failed"]>;
+    }, "strip", z.ZodTypeAny, {
+        deploymentId: string;
+        steps: {
+            status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
+            name: string;
+            id: "identity_create" | "project_create" | "kta_register" | "fly_provision" | "compute_boot" | "health_check";
+            message?: string | undefined;
+            startedAt?: string | undefined;
+            completedAt?: string | undefined;
+        }[];
+        currentStep: number;
+        totalSteps: number;
+        overallStatus: "pending" | "in_progress" | "completed" | "failed";
+    }, {
+        deploymentId: string;
+        steps: {
+            status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
+            name: string;
+            id: "identity_create" | "project_create" | "kta_register" | "fly_provision" | "compute_boot" | "health_check";
+            message?: string | undefined;
+            startedAt?: string | undefined;
+            completedAt?: string | undefined;
+        }[];
+        currentStep: number;
+        totalSteps: number;
+        overallStatus: "pending" | "in_progress" | "completed" | "failed";
+    }>;
+}, "strip", z.ZodTypeAny, {
+    type: "progress";
+    data: {
+        deploymentId: string;
+        steps: {
+            status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
+            name: string;
+            id: "identity_create" | "project_create" | "kta_register" | "fly_provision" | "compute_boot" | "health_check";
+            message?: string | undefined;
+            startedAt?: string | undefined;
+            completedAt?: string | undefined;
+        }[];
+        currentStep: number;
+        totalSteps: number;
+        overallStatus: "pending" | "in_progress" | "completed" | "failed";
+    };
+}, {
+    type: "progress";
+    data: {
+        deploymentId: string;
+        steps: {
+            status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
+            name: string;
+            id: "identity_create" | "project_create" | "kta_register" | "fly_provision" | "compute_boot" | "health_check";
+            message?: string | undefined;
+            startedAt?: string | undefined;
+            completedAt?: string | undefined;
+        }[];
+        currentStep: number;
+        totalSteps: number;
+        overallStatus: "pending" | "in_progress" | "completed" | "failed";
+    };
+}>;
+export declare const ManagedSSECompleteEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"complete">;
+    data: z.ZodObject<{
+        /** Agent DID — the primary identifier */
+        agentDid: z.ZodString;
+        /** Live agent URL (e.g., https://my-agent.agents.kya-os.ai) */
+        agentUrl: z.ZodString;
+        /** Current agent status */
+        status: z.ZodEnum<["provisioning", "starting", "running", "stopping", "stopped", "error", "revoked"]>;
+        /** AgentShield project ID */
+        projectId: z.ZodString;
+        /** AgentShield project friendly ID */
+        friendlyId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        status: "provisioning" | "starting" | "running" | "stopping" | "stopped" | "error" | "revoked";
+        agentDid: string;
+        agentUrl: string;
+        projectId: string;
+        friendlyId: string;
+    }, {
+        status: "provisioning" | "starting" | "running" | "stopping" | "stopped" | "error" | "revoked";
+        agentDid: string;
+        agentUrl: string;
+        projectId: string;
+        friendlyId: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    type: "complete";
+    data: {
+        status: "provisioning" | "starting" | "running" | "stopping" | "stopped" | "error" | "revoked";
+        agentDid: string;
+        agentUrl: string;
+        projectId: string;
+        friendlyId: string;
+    };
+}, {
+    type: "complete";
+    data: {
+        status: "provisioning" | "starting" | "running" | "stopping" | "stopped" | "error" | "revoked";
+        agentDid: string;
+        agentUrl: string;
+        projectId: string;
+        friendlyId: string;
+    };
+}>;
+export declare const ManagedSSEErrorEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"error">;
+    data: z.ZodObject<{
+        code: z.ZodEnum<["IDENTITY_ERROR", "PROJECT_CREATION_ERROR", "KTA_REGISTRATION_ERROR", "FLY_PROVISION_FAILED", "COMPUTE_BOOT_TIMEOUT", "HEALTH_CHECK_FAILED", "RATE_LIMIT_EXCEEDED", "NAME_TAKEN", "INTERNAL_ERROR"]>;
+        message: z.ZodString;
+        step: z.ZodOptional<z.ZodEnum<["identity_create", "project_create", "kta_register", "fly_provision", "compute_boot", "health_check"]>>;
+    }, "strip", z.ZodTypeAny, {
+        code: "IDENTITY_ERROR" | "PROJECT_CREATION_ERROR" | "KTA_REGISTRATION_ERROR" | "FLY_PROVISION_FAILED" | "COMPUTE_BOOT_TIMEOUT" | "HEALTH_CHECK_FAILED" | "RATE_LIMIT_EXCEEDED" | "NAME_TAKEN" | "INTERNAL_ERROR";
+        message: string;
+        step?: "identity_create" | "project_create" | "kta_register" | "fly_provision" | "compute_boot" | "health_check" | undefined;
+    }, {
+        code: "IDENTITY_ERROR" | "PROJECT_CREATION_ERROR" | "KTA_REGISTRATION_ERROR" | "FLY_PROVISION_FAILED" | "COMPUTE_BOOT_TIMEOUT" | "HEALTH_CHECK_FAILED" | "RATE_LIMIT_EXCEEDED" | "NAME_TAKEN" | "INTERNAL_ERROR";
+        message: string;
+        step?: "identity_create" | "project_create" | "kta_register" | "fly_provision" | "compute_boot" | "health_check" | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    type: "error";
+    data: {
+        code: "IDENTITY_ERROR" | "PROJECT_CREATION_ERROR" | "KTA_REGISTRATION_ERROR" | "FLY_PROVISION_FAILED" | "COMPUTE_BOOT_TIMEOUT" | "HEALTH_CHECK_FAILED" | "RATE_LIMIT_EXCEEDED" | "NAME_TAKEN" | "INTERNAL_ERROR";
+        message: string;
+        step?: "identity_create" | "project_create" | "kta_register" | "fly_provision" | "compute_boot" | "health_check" | undefined;
+    };
+}, {
+    type: "error";
+    data: {
+        code: "IDENTITY_ERROR" | "PROJECT_CREATION_ERROR" | "KTA_REGISTRATION_ERROR" | "FLY_PROVISION_FAILED" | "COMPUTE_BOOT_TIMEOUT" | "HEALTH_CHECK_FAILED" | "RATE_LIMIT_EXCEEDED" | "NAME_TAKEN" | "INTERNAL_ERROR";
+        message: string;
+        step?: "identity_create" | "project_create" | "kta_register" | "fly_provision" | "compute_boot" | "health_check" | undefined;
+    };
+}>;
+export declare const ManagedSSEKeepaliveEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"keepalive">;
+    data: z.ZodObject<{
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        timestamp: string;
+    }, {
+        timestamp: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    type: "keepalive";
+    data: {
+        timestamp: string;
+    };
+}, {
+    type: "keepalive";
+    data: {
+        timestamp: string;
+    };
+}>;
+export declare const ManagedSSEEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"progress">;
+    data: z.ZodObject<{
+        deploymentId: z.ZodString;
+        steps: z.ZodArray<z.ZodObject<{
+            id: z.ZodEnum<["identity_create", "project_create", "kta_register", "fly_provision", "compute_boot", "health_check"]>;
+            name: z.ZodString;
+            status: z.ZodEnum<["pending", "in_progress", "completed", "failed", "skipped"]>;
+            message: z.ZodOptional<z.ZodString>;
+            startedAt: z.ZodOptional<z.ZodString>;
+            completedAt: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
+            name: string;
+            id: "identity_create" | "project_create" | "kta_register" | "fly_provision" | "compute_boot" | "health_check";
+            message?: string | undefined;
+            startedAt?: string | undefined;
+            completedAt?: string | undefined;
+        }, {
+            status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
+            name: string;
+            id: "identity_create" | "project_create" | "kta_register" | "fly_provision" | "compute_boot" | "health_check";
+            message?: string | undefined;
+            startedAt?: string | undefined;
+            completedAt?: string | undefined;
+        }>, "many">;
+        currentStep: z.ZodNumber;
+        totalSteps: z.ZodNumber;
+        overallStatus: z.ZodEnum<["pending", "in_progress", "completed", "failed"]>;
+    }, "strip", z.ZodTypeAny, {
+        deploymentId: string;
+        steps: {
+            status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
+            name: string;
+            id: "identity_create" | "project_create" | "kta_register" | "fly_provision" | "compute_boot" | "health_check";
+            message?: string | undefined;
+            startedAt?: string | undefined;
+            completedAt?: string | undefined;
+        }[];
+        currentStep: number;
+        totalSteps: number;
+        overallStatus: "pending" | "in_progress" | "completed" | "failed";
+    }, {
+        deploymentId: string;
+        steps: {
+            status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
+            name: string;
+            id: "identity_create" | "project_create" | "kta_register" | "fly_provision" | "compute_boot" | "health_check";
+            message?: string | undefined;
+            startedAt?: string | undefined;
+            completedAt?: string | undefined;
+        }[];
+        currentStep: number;
+        totalSteps: number;
+        overallStatus: "pending" | "in_progress" | "completed" | "failed";
+    }>;
+}, "strip", z.ZodTypeAny, {
+    type: "progress";
+    data: {
+        deploymentId: string;
+        steps: {
+            status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
+            name: string;
+            id: "identity_create" | "project_create" | "kta_register" | "fly_provision" | "compute_boot" | "health_check";
+            message?: string | undefined;
+            startedAt?: string | undefined;
+            completedAt?: string | undefined;
+        }[];
+        currentStep: number;
+        totalSteps: number;
+        overallStatus: "pending" | "in_progress" | "completed" | "failed";
+    };
+}, {
+    type: "progress";
+    data: {
+        deploymentId: string;
+        steps: {
+            status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
+            name: string;
+            id: "identity_create" | "project_create" | "kta_register" | "fly_provision" | "compute_boot" | "health_check";
+            message?: string | undefined;
+            startedAt?: string | undefined;
+            completedAt?: string | undefined;
+        }[];
+        currentStep: number;
+        totalSteps: number;
+        overallStatus: "pending" | "in_progress" | "completed" | "failed";
+    };
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"complete">;
+    data: z.ZodObject<{
+        /** Agent DID — the primary identifier */
+        agentDid: z.ZodString;
+        /** Live agent URL (e.g., https://my-agent.agents.kya-os.ai) */
+        agentUrl: z.ZodString;
+        /** Current agent status */
+        status: z.ZodEnum<["provisioning", "starting", "running", "stopping", "stopped", "error", "revoked"]>;
+        /** AgentShield project ID */
+        projectId: z.ZodString;
+        /** AgentShield project friendly ID */
+        friendlyId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        status: "provisioning" | "starting" | "running" | "stopping" | "stopped" | "error" | "revoked";
+        agentDid: string;
+        agentUrl: string;
+        projectId: string;
+        friendlyId: string;
+    }, {
+        status: "provisioning" | "starting" | "running" | "stopping" | "stopped" | "error" | "revoked";
+        agentDid: string;
+        agentUrl: string;
+        projectId: string;
+        friendlyId: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    type: "complete";
+    data: {
+        status: "provisioning" | "starting" | "running" | "stopping" | "stopped" | "error" | "revoked";
+        agentDid: string;
+        agentUrl: string;
+        projectId: string;
+        friendlyId: string;
+    };
+}, {
+    type: "complete";
+    data: {
+        status: "provisioning" | "starting" | "running" | "stopping" | "stopped" | "error" | "revoked";
+        agentDid: string;
+        agentUrl: string;
+        projectId: string;
+        friendlyId: string;
+    };
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"error">;
+    data: z.ZodObject<{
+        code: z.ZodEnum<["IDENTITY_ERROR", "PROJECT_CREATION_ERROR", "KTA_REGISTRATION_ERROR", "FLY_PROVISION_FAILED", "COMPUTE_BOOT_TIMEOUT", "HEALTH_CHECK_FAILED", "RATE_LIMIT_EXCEEDED", "NAME_TAKEN", "INTERNAL_ERROR"]>;
+        message: z.ZodString;
+        step: z.ZodOptional<z.ZodEnum<["identity_create", "project_create", "kta_register", "fly_provision", "compute_boot", "health_check"]>>;
+    }, "strip", z.ZodTypeAny, {
+        code: "IDENTITY_ERROR" | "PROJECT_CREATION_ERROR" | "KTA_REGISTRATION_ERROR" | "FLY_PROVISION_FAILED" | "COMPUTE_BOOT_TIMEOUT" | "HEALTH_CHECK_FAILED" | "RATE_LIMIT_EXCEEDED" | "NAME_TAKEN" | "INTERNAL_ERROR";
+        message: string;
+        step?: "identity_create" | "project_create" | "kta_register" | "fly_provision" | "compute_boot" | "health_check" | undefined;
+    }, {
+        code: "IDENTITY_ERROR" | "PROJECT_CREATION_ERROR" | "KTA_REGISTRATION_ERROR" | "FLY_PROVISION_FAILED" | "COMPUTE_BOOT_TIMEOUT" | "HEALTH_CHECK_FAILED" | "RATE_LIMIT_EXCEEDED" | "NAME_TAKEN" | "INTERNAL_ERROR";
+        message: string;
+        step?: "identity_create" | "project_create" | "kta_register" | "fly_provision" | "compute_boot" | "health_check" | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    type: "error";
+    data: {
+        code: "IDENTITY_ERROR" | "PROJECT_CREATION_ERROR" | "KTA_REGISTRATION_ERROR" | "FLY_PROVISION_FAILED" | "COMPUTE_BOOT_TIMEOUT" | "HEALTH_CHECK_FAILED" | "RATE_LIMIT_EXCEEDED" | "NAME_TAKEN" | "INTERNAL_ERROR";
+        message: string;
+        step?: "identity_create" | "project_create" | "kta_register" | "fly_provision" | "compute_boot" | "health_check" | undefined;
+    };
+}, {
+    type: "error";
+    data: {
+        code: "IDENTITY_ERROR" | "PROJECT_CREATION_ERROR" | "KTA_REGISTRATION_ERROR" | "FLY_PROVISION_FAILED" | "COMPUTE_BOOT_TIMEOUT" | "HEALTH_CHECK_FAILED" | "RATE_LIMIT_EXCEEDED" | "NAME_TAKEN" | "INTERNAL_ERROR";
+        message: string;
+        step?: "identity_create" | "project_create" | "kta_register" | "fly_provision" | "compute_boot" | "health_check" | undefined;
+    };
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"keepalive">;
+    data: z.ZodObject<{
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        timestamp: string;
+    }, {
+        timestamp: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    type: "keepalive";
+    data: {
+        timestamp: string;
+    };
+}, {
+    type: "keepalive";
+    data: {
+        timestamp: string;
+    };
+}>]>;
+export type ManagedSSEEvent = z.infer<typeof ManagedSSEEventSchema>;
+export { didToSlug, didToFlyApp } from "./agent-deployment-utils.js";