@xtrape/capsule-contracts-node 0.1.0-public-review.1 → 0.3.0

package/dist/index.js

@@ -1,5 +1,4 @@
 // src/index.ts
-import { customAlphabet } from "nanoid";
 import { z } from "zod";
 var AgentStatus = ["PENDING", "ONLINE", "OFFLINE", "DISABLED", "REVOKED"];
 var CapsuleServiceStatus = ["UNKNOWN", "HEALTHY", "UNHEALTHY", "STALE", "OFFLINE"];
@@ -9,32 +8,16 @@ var DangerLevel = ["LOW", "MEDIUM", "HIGH"];
 var AuditActorType = ["USER", "AGENT", "SYSTEM"];
 var AuditResult = ["SUCCESS", "FAILURE"];
 var TokenStatus = ["ACTIVE", "REVOKED", "EXPIRED", "USED"];
-var ErrorCode = {
-  INTERNAL_ERROR: "INTERNAL_ERROR",
-  VALIDATION_FAILED: "VALIDATION_FAILED",
-  UNAUTHORIZED: "UNAUTHORIZED",
-  FORBIDDEN: "FORBIDDEN",
-  NOT_FOUND: "NOT_FOUND",
-  CONFLICT: "CONFLICT",
-  CSRF_INVALID: "CSRF_INVALID",
-  ACTION_REQUIRES_CONFIRMATION: "ACTION_REQUIRES_CONFIRMATION",
-  COMMAND_EXPIRED: "COMMAND_EXPIRED",
-  TOKEN_REVOKED: "TOKEN_REVOKED",
-  TOKEN_EXPIRED: "TOKEN_EXPIRED",
-  AGENT_REVOKED: "AGENT_REVOKED",
-  AGENT_DISABLED: "AGENT_DISABLED"
-};
-var idPrefixes = ["wks_", "usr_", "agt_", "tok_", "svc_", "hlr_", "cfg_", "act_", "cmd_", "crs_", "aud_"];
-var NANO = customAlphabet("0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz_-", 21);
-function newId(prefix) {
-  return `${prefix}${NANO()}`;
-}
+var AgentMode = ["embedded", "ophub"];
+var ServiceKind = ["business", "infrastructure", "system"];
+var ServiceKindSchema = z.enum(ServiceKind);
 var AnyJson = z.record(z.any());
 var AgentStatusSchema = z.enum(AgentStatus);
 var CapsuleServiceStatusSchema = z.enum(CapsuleServiceStatus);
 var HealthStatusSchema = z.enum(HealthStatus);
 var CommandStatusSchema = z.enum(CommandStatus);
 var DangerLevelSchema = z.enum(DangerLevel).default("LOW");
+var AgentModeSchema = z.enum(AgentMode);
 var UserSchema = z.object({ id: z.string().startsWith("usr_"), username: z.string(), displayName: z.string().nullable().optional(), createdAt: z.string(), updatedAt: z.string() });
 var UserRole = z.enum(["owner", "operator", "viewer"]);
 var createUserRequestSchema = z.object({ username: z.string().min(1), password: z.string().min(12), displayName: z.string().optional(), role: UserRole.default("viewer") });
@@ -43,24 +26,41 @@ var resetUserPasswordRequestSchema = z.object({ password: z.string().min(12) });
 var AdminLoginRequestSchema = z.object({ username: z.string().min(1), password: z.string().min(1) });
 var adminLoginRequestSchema = AdminLoginRequestSchema;
 var AdminSessionSchema = z.object({ user: UserSchema, csrfToken: z.string(), expiresAt: z.string() });
-var AgentSchema = z.object({ id: z.string().startsWith("agt_"), code: z.string(), name: z.string().nullable().optional(), mode: z.enum(["embedded", "sidecar", "external"]), runtime: z.string().nullable().optional(), status: AgentStatusSchema, lastHeartbeatAt: z.string().nullable().optional(), createdAt: z.string(), updatedAt: z.string() });
+var AgentSchema = z.object({ id: z.string().startsWith("agt_"), code: z.string(), name: z.string().nullable().optional(), mode: AgentModeSchema, runtime: z.string().nullable().optional(), status: AgentStatusSchema, lastHeartbeatAt: z.string().nullable().optional(), createdAt: z.string(), updatedAt: z.string() });
 var RegistrationTokenSchema = z.object({ id: z.string().startsWith("tok_"), name: z.string(), status: z.enum(TokenStatus), expiresAt: z.string().nullable().optional(), usedAt: z.string().nullable().optional(), createdAt: z.string() });
 var CreateRegistrationTokenRequestSchema = z.object({ name: z.string().default("Default registration token").optional(), expiresInSeconds: z.number().int().min(60).optional() });
 var createRegistrationTokenRequestSchema = CreateRegistrationTokenRequestSchema;
 var CreateRegistrationTokenResponseSchema = RegistrationTokenSchema.extend({ rawToken: z.string().startsWith("opstage_reg_") });
-var CapsuleManifestSchema = z.object({ kind: z.literal("CapsuleService"), schemaVersion: z.string().default("1.0").optional(), code: z.string().min(1), name: z.string().min(1), description: z.string().optional(), version: z.string().min(1), runtime: z.enum(["nodejs", "java", "python", "go", "other"]), agentMode: z.enum(["embedded", "sidecar", "external"]), capabilities: z.array(z.string()).optional(), labels: z.record(z.string()).optional() }).passthrough();
+var ServiceCapabilitySchema = z.object({ name: z.string().min(1).max(120), label: z.string().max(200).optional(), description: z.string().max(2e3).optional(), metadata: AnyJson.optional() });
+var serviceCapabilitySchema = ServiceCapabilitySchema;
+var EventMetadataSchema = z.object({ name: z.string().min(1).max(160), direction: z.enum(["publish", "subscribe"]).optional(), schema: AnyJson.optional(), designOnly: z.boolean().default(true), metadata: AnyJson.optional() });
+var eventMetadataSchema = EventMetadataSchema;
+var CapsuleManifestSchema = z.object({ kind: z.literal("CapsuleService"), schemaVersion: z.string().default("1.0").optional(), code: z.string().min(1), name: z.string().min(1), description: z.string().optional(), version: z.string().min(1), runtime: z.enum(["nodejs", "java", "python", "go", "other"]), agentMode: AgentModeSchema, capabilities: z.array(z.union([z.string(), ServiceCapabilitySchema])).optional(), events: z.array(EventMetadataSchema).optional(), labels: z.record(z.string()).optional() }).passthrough();
 var HealthReportInputSchema = z.object({ status: HealthStatusSchema, message: z.string().optional(), details: AnyJson.optional() });
 var healthReportInputSchema = HealthReportInputSchema;
 var ConfigItemInputSchema = z.object({ key: z.string(), label: z.string().optional(), type: z.string(), source: z.string().optional(), editable: z.boolean().optional(), sensitive: z.boolean().optional(), valuePreview: z.string().optional(), defaultValue: z.string().optional(), secretRef: z.string().optional() });
 var configItemInputSchema = ConfigItemInputSchema;
 var ActionDefinitionInputSchema = z.object({ name: z.string(), label: z.string(), description: z.string().optional(), dangerLevel: z.enum(DangerLevel).default("LOW").optional(), requiresConfirmation: z.boolean().optional(), category: z.string().optional(), order: z.number().int().optional(), inputSchema: AnyJson.optional(), outputSchema: AnyJson.optional(), timeoutSeconds: z.number().int().positive().optional() });
 var actionDefinitionInputSchema = ActionDefinitionInputSchema;
-var ReportedServiceSchema = z.object({ code: z.string().min(1).max(80), name: z.string().min(1).max(200), description: z.string().max(2e3).optional(), version: z.string().max(80).optional(), runtime: z.string().optional(), manifest: AnyJson, health: HealthReportInputSchema.optional(), configs: z.array(ConfigItemInputSchema).optional(), actions: z.array(ActionDefinitionInputSchema).optional() });
+var ReportedServiceSchema = z.object({
+  code: z.string().min(1).max(80),
+  name: z.string().min(1).max(200),
+  description: z.string().max(2e3).optional(),
+  version: z.string().max(80).optional(),
+  runtime: z.string().optional(),
+  manifest: AnyJson,
+  capabilities: z.array(ServiceCapabilitySchema).optional(),
+  events: z.array(EventMetadataSchema).optional(),
+  health: HealthReportInputSchema.optional(),
+  configs: z.array(ConfigItemInputSchema).optional(),
+  actions: z.array(ActionDefinitionInputSchema).optional(),
+  serviceKind: ServiceKindSchema.optional()
+});
 var reportedServiceSchema = ReportedServiceSchema;
 var ServiceReportRequestSchema = z.object({ services: z.array(ReportedServiceSchema).min(1) });
 var serviceReportRequestSchema = ServiceReportRequestSchema;
 var RuntimeKindSchema = z.enum(["nodejs", "java", "python", "go", "other"]);
-var RegisterAgentRequestSchema = z.object({ registrationToken: z.string().startsWith("opstage_reg_"), agent: z.object({ code: z.string(), name: z.string().optional(), mode: z.literal("embedded"), runtime: RuntimeKindSchema.optional() }), service: ReportedServiceSchema.optional() });
+var RegisterAgentRequestSchema = z.object({ registrationToken: z.string().startsWith("opstage_reg_"), agent: z.object({ code: z.string(), name: z.string().optional(), mode: AgentModeSchema.default("embedded"), runtime: RuntimeKindSchema.or(z.string()).optional() }), service: ReportedServiceSchema.optional() });
 var registerAgentRequestSchema = RegisterAgentRequestSchema;
 var RegisterAgentResponseSchema = z.object({ agentId: z.string().startsWith("agt_"), agentToken: z.string().startsWith("opstage_agent_"), heartbeatIntervalSeconds: z.number().int(), commandPollIntervalSeconds: z.number().int() });
 var AgentHeartbeatResponseSchema = z.object({ heartbeatIntervalSeconds: z.number().int(), commandPollIntervalSeconds: z.number().int() });
@@ -116,6 +116,21 @@ function parseSort(value, allowed) {
 function paginate(items, page, pageSize, total) {
   return { data: items, pagination: { page, pageSize, total } };
 }
+var ErrorCode = {
+  INTERNAL_ERROR: "INTERNAL_ERROR",
+  VALIDATION_FAILED: "VALIDATION_FAILED",
+  UNAUTHORIZED: "UNAUTHORIZED",
+  FORBIDDEN: "FORBIDDEN",
+  NOT_FOUND: "NOT_FOUND",
+  CONFLICT: "CONFLICT",
+  CSRF_INVALID: "CSRF_INVALID",
+  ACTION_REQUIRES_CONFIRMATION: "ACTION_REQUIRES_CONFIRMATION",
+  COMMAND_EXPIRED: "COMMAND_EXPIRED",
+  TOKEN_REVOKED: "TOKEN_REVOKED",
+  TOKEN_EXPIRED: "TOKEN_EXPIRED",
+  AGENT_REVOKED: "AGENT_REVOKED",
+  AGENT_DISABLED: "AGENT_DISABLED"
+};
 export {
   ActionDefinitionInputSchema,
   ActionDefinitionSchema,
@@ -124,6 +139,8 @@ export {
   AdminSessionSchema,
   AgentHeartbeatRequestSchema,
   AgentHeartbeatResponseSchema,
+  AgentMode,
+  AgentModeSchema,
   AgentSchema,
   AgentStatus,
   AgentStatusSchema,
@@ -151,6 +168,7 @@ export {
   DangerLevelSchema,
   DashboardSummarySchema,
   ErrorCode,
+  EventMetadataSchema,
   HealthReportInputSchema,
   HealthReportSchema,
   HealthStatus,
@@ -163,6 +181,9 @@ export {
   ReportCommandResultRequestSchema,
   ReportedServiceSchema,
   RuntimeKindSchema,
+  ServiceCapabilitySchema,
+  ServiceKind,
+  ServiceKindSchema,
   ServiceReportRequestSchema,
   SystemHealthSchema,
   SystemVersionSchema,
@@ -177,15 +198,15 @@ export {
   createActionCommandRequestSchema,
   createRegistrationTokenRequestSchema,
   createUserRequestSchema,
+  eventMetadataSchema,
   healthReportInputSchema,
-  idPrefixes,
-  newId,
   paginate,
   parseSort,
   registerAgentRequestSchema,
   reportCommandResultRequestSchema,
   reportedServiceSchema,
   resetUserPasswordRequestSchema,
+  serviceCapabilitySchema,
   serviceReportRequestSchema,
   updateUserRequestSchema,
   z

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xtrape/capsule-contracts-node",
-  "version": "0.1.0-public-review.1",
+  "version": "0.3.0",
   "description": "TypeScript contracts and Zod schemas for Xtrape Capsule and Opstage wire protocols.",
   "keywords": [
     "xtrape",
@@ -44,7 +44,6 @@
     "lint": "tsc --noEmit"
   },
   "dependencies": {
-    "nanoid": "^5.0.9",
     "zod": "^3.25.0"
   },
   "devDependencies": {