@kya-os/contracts 1.7.26 → 1.7.31

package/dist/agent-deployment-utils.d.ts

@@ -40,3 +40,23 @@ export declare function didToSlug(did: string): string;
  * @throws {Error} If `did` is empty or does not start with "did:"
  */
 export declare function didToFlyApp(did: string): string;
+/**
+ * Derive a readable, DNS-safe Fly app name from an agent name + DID.
+ *
+ * Format: "kya-{name[:19]}-{first 6 hex chars of SHA-256 of DID}"
+ * Example: ("researcher", "did:key:z6Mk...") → "kya-researcher-a3f2b1"
+ *
+ * Constraints:
+ *   "kya-" (4) + name[:19] (≤19) + "-" (1) + hash[:6] (6) = ≤30 chars
+ *   Fly app name hard limit: 30 chars ✓
+ *
+ * Uniqueness: 6 hex chars = 24 bits → birthday collision at ~4,096 agents
+ * sharing the exact same human name. Safe for production scale.
+ *
+ * Node.js only — same crypto constraint as didToSlug.
+ *
+ * @param name - Human-readable agent name from the deploy request
+ * @param did  - The agent DID string (must start with "did:")
+ * @throws {Error} If DID is invalid or name sanitizes to empty string
+ */
+export declare function nameToFlySlug(name: string, did: string): string;

package/dist/agent-deployment-utils.js

@@ -14,6 +14,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.didToSlug = didToSlug;
 exports.didToFlyApp = didToFlyApp;
+exports.nameToFlySlug = nameToFlySlug;
 const crypto_1 = require("crypto");
 /**
  * Derive a short, deterministic, DNS-safe slug from an agent DID.
@@ -53,3 +54,39 @@ function didToSlug(did) {
 function didToFlyApp(did) {
     return didToSlug(did);
 }
+/**
+ * Derive a readable, DNS-safe Fly app name from an agent name + DID.
+ *
+ * Format: "kya-{name[:19]}-{first 6 hex chars of SHA-256 of DID}"
+ * Example: ("researcher", "did:key:z6Mk...") → "kya-researcher-a3f2b1"
+ *
+ * Constraints:
+ *   "kya-" (4) + name[:19] (≤19) + "-" (1) + hash[:6] (6) = ≤30 chars
+ *   Fly app name hard limit: 30 chars ✓
+ *
+ * Uniqueness: 6 hex chars = 24 bits → birthday collision at ~4,096 agents
+ * sharing the exact same human name. Safe for production scale.
+ *
+ * Node.js only — same crypto constraint as didToSlug.
+ *
+ * @param name - Human-readable agent name from the deploy request
+ * @param did  - The agent DID string (must start with "did:")
+ * @throws {Error} If DID is invalid or name sanitizes to empty string
+ */
+function nameToFlySlug(name, did) {
+    if (!did || typeof did !== "string" || !did.startsWith("did:")) {
+        throw new Error('nameToFlySlug: expected a valid DID string starting with "did:"');
+    }
+    const hash = (0, crypto_1.createHash)("sha256").update(did).digest("hex").substring(0, 6);
+    const slug = name
+        .toLowerCase()
+        .replace(/[^a-z0-9-]/g, "-") // non-alphanumeric → hyphen
+        .replace(/-{2,}/g, "-") // collapse consecutive hyphens
+        .replace(/^-+|-+$/g, "") // strip leading/trailing hyphens
+        .substring(0, 19)
+        .replace(/-+$/, ""); // strip trailing hyphens after truncation
+    if (!slug) {
+        throw new Error("nameToFlySlug: name sanitized to empty string");
+    }
+    return `kya-${slug}-${hash}`;
+}

package/dist/agent-deployment.d.ts

@@ -119,15 +119,15 @@ export declare const ManagedDeployStepSchema: z.ZodObject<{
     startedAt: z.ZodOptional<z.ZodString>;
     completedAt: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
     name: string;
+    status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
     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;
+    status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
     id: "identity_create" | "project_create" | "kta_register" | "fly_provision" | "compute_boot" | "health_check";
     message?: string | undefined;
     startedAt?: string | undefined;
@@ -146,15 +146,15 @@ export declare const ManagedDeployProgressSchema: z.ZodObject<{
         startedAt: z.ZodOptional<z.ZodString>;
         completedAt: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
         name: string;
+        status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
         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;
+        status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
         id: "identity_create" | "project_create" | "kta_register" | "fly_provision" | "compute_boot" | "health_check";
         message?: string | undefined;
         startedAt?: string | undefined;
@@ -166,8 +166,8 @@ export declare const ManagedDeployProgressSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     deploymentId: string;
     steps: {
-        status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
         name: string;
+        status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
         id: "identity_create" | "project_create" | "kta_register" | "fly_provision" | "compute_boot" | "health_check";
         message?: string | undefined;
         startedAt?: string | undefined;
@@ -179,8 +179,8 @@ export declare const ManagedDeployProgressSchema: z.ZodObject<{
 }, {
     deploymentId: string;
     steps: {
-        status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
         name: string;
+        status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
         id: "identity_create" | "project_create" | "kta_register" | "fly_provision" | "compute_boot" | "health_check";
         message?: string | undefined;
         startedAt?: string | undefined;
@@ -366,15 +366,15 @@ export declare const ManagedSSEProgressEventSchema: z.ZodObject<{
             startedAt: z.ZodOptional<z.ZodString>;
             completedAt: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
-            status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
             name: string;
+            status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
             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;
+            status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
             id: "identity_create" | "project_create" | "kta_register" | "fly_provision" | "compute_boot" | "health_check";
             message?: string | undefined;
             startedAt?: string | undefined;
@@ -386,8 +386,8 @@ export declare const ManagedSSEProgressEventSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         deploymentId: string;
         steps: {
-            status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
             name: string;
+            status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
             id: "identity_create" | "project_create" | "kta_register" | "fly_provision" | "compute_boot" | "health_check";
             message?: string | undefined;
             startedAt?: string | undefined;
@@ -399,8 +399,8 @@ export declare const ManagedSSEProgressEventSchema: z.ZodObject<{
     }, {
         deploymentId: string;
         steps: {
-            status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
             name: string;
+            status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
             id: "identity_create" | "project_create" | "kta_register" | "fly_provision" | "compute_boot" | "health_check";
             message?: string | undefined;
             startedAt?: string | undefined;
@@ -415,8 +415,8 @@ export declare const ManagedSSEProgressEventSchema: z.ZodObject<{
     data: {
         deploymentId: string;
         steps: {
-            status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
             name: string;
+            status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
             id: "identity_create" | "project_create" | "kta_register" | "fly_provision" | "compute_boot" | "health_check";
             message?: string | undefined;
             startedAt?: string | undefined;
@@ -431,8 +431,8 @@ export declare const ManagedSSEProgressEventSchema: z.ZodObject<{
     data: {
         deploymentId: string;
         steps: {
-            status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
             name: string;
+            status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
             id: "identity_create" | "project_create" | "kta_register" | "fly_provision" | "compute_boot" | "health_check";
             message?: string | undefined;
             startedAt?: string | undefined;
@@ -550,15 +550,15 @@ export declare const ManagedSSEEventSchema: z.ZodDiscriminatedUnion<"type", [z.Z
             startedAt: z.ZodOptional<z.ZodString>;
             completedAt: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
-            status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
             name: string;
+            status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
             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;
+            status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
             id: "identity_create" | "project_create" | "kta_register" | "fly_provision" | "compute_boot" | "health_check";
             message?: string | undefined;
             startedAt?: string | undefined;
@@ -570,8 +570,8 @@ export declare const ManagedSSEEventSchema: z.ZodDiscriminatedUnion<"type", [z.Z
     }, "strip", z.ZodTypeAny, {
         deploymentId: string;
         steps: {
-            status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
             name: string;
+            status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
             id: "identity_create" | "project_create" | "kta_register" | "fly_provision" | "compute_boot" | "health_check";
             message?: string | undefined;
             startedAt?: string | undefined;
@@ -583,8 +583,8 @@ export declare const ManagedSSEEventSchema: z.ZodDiscriminatedUnion<"type", [z.Z
     }, {
         deploymentId: string;
         steps: {
-            status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
             name: string;
+            status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
             id: "identity_create" | "project_create" | "kta_register" | "fly_provision" | "compute_boot" | "health_check";
             message?: string | undefined;
             startedAt?: string | undefined;
@@ -599,8 +599,8 @@ export declare const ManagedSSEEventSchema: z.ZodDiscriminatedUnion<"type", [z.Z
     data: {
         deploymentId: string;
         steps: {
-            status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
             name: string;
+            status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
             id: "identity_create" | "project_create" | "kta_register" | "fly_provision" | "compute_boot" | "health_check";
             message?: string | undefined;
             startedAt?: string | undefined;
@@ -615,8 +615,8 @@ export declare const ManagedSSEEventSchema: z.ZodDiscriminatedUnion<"type", [z.Z
     data: {
         deploymentId: string;
         steps: {
-            status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
             name: string;
+            status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
             id: "identity_create" | "project_create" | "kta_register" | "fly_provision" | "compute_boot" | "health_check";
             message?: string | undefined;
             startedAt?: string | undefined;
@@ -720,4 +720,4 @@ export declare const ManagedSSEEventSchema: z.ZodDiscriminatedUnion<"type", [z.Z
     };
 }>]>;
 export type ManagedSSEEvent = z.infer<typeof ManagedSSEEventSchema>;
-export { didToSlug, didToFlyApp } from "./agent-deployment-utils.js";
+export { didToSlug, didToFlyApp, nameToFlySlug } from "./agent-deployment-utils.js";

package/dist/agent-deployment.js

@@ -8,7 +8,7 @@
  * @package @kya-os/contracts/agent-deployment
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.didToFlyApp = exports.didToSlug = exports.ManagedSSEEventSchema = exports.ManagedSSEKeepaliveEventSchema = exports.ManagedSSEErrorEventSchema = exports.ManagedSSECompleteEventSchema = exports.ManagedSSEProgressEventSchema = exports.ManagedDeployResponseSchema = exports.ManagedDeploySuccessResponseSchema = exports.ManagedDeployErrorResponseSchema = exports.ManagedDeployErrorCodeSchema = exports.ManagedDeployProgressSchema = exports.ManagedDeployStepSchema = exports.ManagedDeployStepStatusSchema = exports.MANAGED_DEPLOY_STEP_NAMES = exports.ManagedDeployStepIdSchema = exports.ManagedDeployResultSchema = exports.ManagedDeployRequestSchema = exports.HostingModeSchema = exports.AgentStatusSchema = exports.FlyRegionSchema = exports.DidStringSchema = void 0;
+exports.nameToFlySlug = exports.didToFlyApp = exports.didToSlug = exports.ManagedSSEEventSchema = exports.ManagedSSEKeepaliveEventSchema = exports.ManagedSSEErrorEventSchema = exports.ManagedSSECompleteEventSchema = exports.ManagedSSEProgressEventSchema = exports.ManagedDeployResponseSchema = exports.ManagedDeploySuccessResponseSchema = exports.ManagedDeployErrorResponseSchema = exports.ManagedDeployErrorCodeSchema = exports.ManagedDeployProgressSchema = exports.ManagedDeployStepSchema = exports.ManagedDeployStepStatusSchema = exports.MANAGED_DEPLOY_STEP_NAMES = exports.ManagedDeployStepIdSchema = exports.ManagedDeployResultSchema = exports.ManagedDeployRequestSchema = exports.HostingModeSchema = exports.AgentStatusSchema = exports.FlyRegionSchema = exports.DidStringSchema = void 0;
 const zod_1 = require("zod");
 // ============================================================================
 // Shared Schemas
@@ -267,3 +267,4 @@ exports.ManagedSSEEventSchema = zod_1.z.discriminatedUnion("type", [
 var agent_deployment_utils_js_1 = require("./agent-deployment-utils.js");
 Object.defineProperty(exports, "didToSlug", { enumerable: true, get: function () { return agent_deployment_utils_js_1.didToSlug; } });
 Object.defineProperty(exports, "didToFlyApp", { enumerable: true, get: function () { return agent_deployment_utils_js_1.didToFlyApp; } });
+Object.defineProperty(exports, "nameToFlySlug", { enumerable: true, get: function () { return agent_deployment_utils_js_1.nameToFlySlug; } });

package/dist/agentshield-api/admin-schemas.d.ts

@@ -30,8 +30,8 @@ export declare const clearCacheResponseSchema: z.ZodObject<{
     cleared: z.ZodBoolean;
 }, "strip", z.ZodTypeAny, {
     message: string;
-    agent_did: string;
     project_id: string | null;
+    agent_did: string;
     cache_key: string;
     old_cache_key: string | null;
     had_value: boolean;
@@ -39,8 +39,8 @@ export declare const clearCacheResponseSchema: z.ZodObject<{
     cleared: boolean;
 }, {
     message: string;
-    agent_did: string;
     project_id: string | null;
+    agent_did: string;
     cache_key: string;
     old_cache_key: string | null;
     had_value: boolean;