@xtrape/capsule-contracts-node 0.4.0 → 0.5.0

package/dist/index.js

@@ -1,7 +1,104 @@
 // src/index.ts
+import { z as z2 } from "zod";
+
+// src/ce.ts
 import { z } from "zod";
+var CE_CONTRACT_VERSION = 1;
+var ServiceId = z.string().regex(/^[a-z0-9][a-z0-9-]*$/, "kebab-case service id");
+var Json = z.record(z.any());
+var ServiceInstanceHealth = ["HEALTHY", "DEGRADED", "UNREACHABLE"];
+var ServiceInstanceHealthSchema = z.enum(ServiceInstanceHealth);
+var ConversationTargetType = ["SERVICE", "TASK", "USER", "SYSTEM"];
+var ConversationTargetTypeSchema = z.enum(ConversationTargetType);
+var MessageSenderType = ["USER", "SERVICE", "SYSTEM"];
+var MessageSenderTypeSchema = z.enum(MessageSenderType);
+var MessageType = [
+  "TEXT",
+  "QUERY",
+  "COMMAND",
+  "SUMMARY",
+  "APPROVAL_REQUEST",
+  "APPROVAL_RESPONSE"
+];
+var MessageTypeSchema = z.enum(MessageType);
+var ServiceManifestSchema = z.object({
+  contractVersion: z.literal(CE_CONTRACT_VERSION),
+  tenant: z.string().default("default"),
+  service: z.object({
+    id: ServiceId,
+    name: z.string().min(1),
+    version: z.string().min(1),
+    description: z.string().optional()
+  }),
+  owner: z.object({ organization: z.string().optional(), maintainer: z.string().optional() }).optional(),
+  runtime: z.object({
+    language: z.string().min(1),
+    agent: z.string().min(1),
+    // declared template; the real address is reported by the instance on register
+    endpoint: z.string().url().optional()
+  }),
+  // business-semantic capabilities (Capability), e.g. "status.query"
+  capabilities: z.array(z.string().min(1)).min(1),
+  // platform feature toggles (not business semantics)
+  features: z.record(z.boolean()).optional(),
+  message: z.object({ supportedTypes: z.array(MessageTypeSchema).min(1) }),
+  // structured triggers; kept loose for Phase 0
+  triggers: z.array(z.object({ type: z.string() }).passthrough()).optional()
+}).passthrough();
+var ServiceInstanceSchema = z.object({
+  contractVersion: z.literal(CE_CONTRACT_VERSION),
+  serviceId: ServiceId,
+  instanceId: z.string().min(1),
+  tenant: z.string().default("default"),
+  address: z.string().url(),
+  version: z.string().min(1),
+  health: ServiceInstanceHealthSchema,
+  startedAt: z.string().optional(),
+  lastHeartbeatAt: z.string().optional()
+});
+var ConversationMessageSchema = z.object({
+  contractVersion: z.literal(CE_CONTRACT_VERSION),
+  messageId: z.string().min(1),
+  conversationId: z.string().min(1),
+  tenant: z.string().default("default"),
+  targetType: ConversationTargetTypeSchema,
+  targetId: z.string().min(1),
+  senderType: MessageSenderTypeSchema,
+  senderId: z.string().min(1),
+  messageType: MessageTypeSchema,
+  content: z.string(),
+  payload: Json.optional(),
+  replyToMessageId: z.string().optional(),
+  idempotencyKey: z.string().optional(),
+  metadata: Json.optional()
+});
+var AgentHeartbeatSchema = z.object({
+  contractVersion: z.literal(CE_CONTRACT_VERSION),
+  serviceId: ServiceId,
+  instanceId: z.string().min(1),
+  tenant: z.string().default("default"),
+  ts: z.string(),
+  health: ServiceInstanceHealthSchema,
+  metricsSummary: Json.optional()
+});
+var CeErrorCode = {
+  CONTRACT_VERSION_MISMATCH: "CONTRACT_VERSION_MISMATCH",
+  UNKNOWN_INSTANCE: "UNKNOWN_INSTANCE",
+  NO_HEALTHY_INSTANCE: "NO_HEALTHY_INSTANCE",
+  TARGET_OFFLINE: "TARGET_OFFLINE",
+  VALIDATION_FAILED: "VALIDATION_FAILED",
+  INTERNAL_ERROR: "INTERNAL_ERROR"
+};
+var ErrorModelSchema = z.object({
+  code: z.string().min(1),
+  message: z.string(),
+  retryable: z.boolean()
+});
+
+// src/index.ts
 var AgentStatus = ["PENDING", "ONLINE", "OFFLINE", "DISABLED", "REVOKED"];
 var CapsuleServiceStatus = ["UNKNOWN", "HEALTHY", "UNHEALTHY", "STALE", "OFFLINE"];
+var WorkerStatus = CapsuleServiceStatus;
 var HealthStatus = ["UP", "DEGRADED", "DOWN", "UNKNOWN"];
 var CommandStatus = ["PENDING", "RUNNING", "SUCCEEDED", "FAILED", "EXPIRED", "CANCELLED"];
 var DangerLevel = ["LOW", "MEDIUM", "HIGH"];
@@ -10,144 +107,163 @@ var AuditResult = ["SUCCESS", "FAILURE"];
 var TokenStatus = ["ACTIVE", "REVOKED", "EXPIRED", "USED"];
 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") });
-var updateUserRequestSchema = z.object({ displayName: z.string().optional(), role: UserRole.optional(), status: z.enum(["ACTIVE", "DISABLED"]).optional() });
-var resetUserPasswordRequestSchema = z.object({ password: z.string().min(12) });
-var AdminLoginRequestSchema = z.object({ username: z.string().min(1), password: z.string().min(1) });
+var ServiceKindSchema = z2.enum(ServiceKind);
+var AnyJson = z2.record(z2.any());
+var AgentStatusSchema = z2.enum(AgentStatus);
+var CapsuleServiceStatusSchema = z2.enum(CapsuleServiceStatus);
+var WorkerStatusSchema = CapsuleServiceStatusSchema;
+var HealthStatusSchema = z2.enum(HealthStatus);
+var CommandStatusSchema = z2.enum(CommandStatus);
+var DangerLevelSchema = z2.enum(DangerLevel).default("LOW");
+var AgentModeSchema = z2.enum(AgentMode);
+var UserSchema = z2.object({ id: z2.string().startsWith("usr_"), username: z2.string(), displayName: z2.string().nullable().optional(), createdAt: z2.string(), updatedAt: z2.string() });
+var UserRole = z2.enum(["owner", "operator", "viewer"]);
+var createUserRequestSchema = z2.object({ username: z2.string().min(1), password: z2.string().min(12), displayName: z2.string().optional(), role: UserRole.default("viewer") });
+var updateUserRequestSchema = z2.object({ displayName: z2.string().optional(), role: UserRole.optional(), status: z2.enum(["ACTIVE", "DISABLED"]).optional() });
+var resetUserPasswordRequestSchema = z2.object({ password: z2.string().min(12) });
+var AdminLoginRequestSchema = z2.object({ username: z2.string().min(1), password: z2.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: 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 AdminSessionSchema = z2.object({ user: UserSchema, csrfToken: z2.string(), expiresAt: z2.string() });
+var AgentSchema = z2.object({ id: z2.string().startsWith("agt_"), code: z2.string(), name: z2.string().nullable().optional(), mode: AgentModeSchema, runtime: z2.string().nullable().optional(), status: AgentStatusSchema, lastHeartbeatAt: z2.string().nullable().optional(), createdAt: z2.string(), updatedAt: z2.string() });
+var RegistrationTokenSchema = z2.object({ id: z2.string().startsWith("tok_"), name: z2.string(), status: z2.enum(TokenStatus), expiresAt: z2.string().nullable().optional(), usedAt: z2.string().nullable().optional(), createdAt: z2.string() });
+var CreateRegistrationTokenRequestSchema = z2.object({ name: z2.string().default("Default registration token").optional(), expiresInSeconds: z2.number().int().min(60).optional() });
 var createRegistrationTokenRequestSchema = CreateRegistrationTokenRequestSchema;
-var CreateRegistrationTokenResponseSchema = RegistrationTokenSchema.extend({ rawToken: z.string().startsWith("opstage_reg_") });
-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 CreateRegistrationTokenResponseSchema = RegistrationTokenSchema.extend({ rawToken: z2.string().startsWith("opstage_reg_") });
+var ServiceCapabilitySchema = z2.object({ name: z2.string().min(1).max(120), label: z2.string().max(200).optional(), description: z2.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 = z2.object({ name: z2.string().min(1).max(160), direction: z2.enum(["publish", "subscribe"]).optional(), schema: AnyJson.optional(), designOnly: z2.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 CapsuleManifestSchema = z2.object({ kind: z2.literal("CapsuleService"), schemaVersion: z2.string().default("1.0").optional(), code: z2.string().min(1), name: z2.string().min(1), description: z2.string().optional(), version: z2.string().min(1), runtime: z2.enum(["nodejs", "java", "python", "go", "other"]), agentMode: AgentModeSchema, capabilities: z2.array(z2.union([z2.string(), ServiceCapabilitySchema])).optional(), events: z2.array(EventMetadataSchema).optional(), labels: z2.record(z2.string()).optional() }).passthrough();
+var WorkerManifestSchema = CapsuleManifestSchema.extend({
+  kind: z2.enum(["Worker", "CapsuleService"]).default("Worker")
+});
+var workerManifestSchema = WorkerManifestSchema;
+var HealthReportInputSchema = z2.object({ status: HealthStatusSchema, message: z2.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 = z2.object({ key: z2.string(), label: z2.string().optional(), type: z2.string(), source: z2.string().optional(), editable: z2.boolean().optional(), sensitive: z2.boolean().optional(), valuePreview: z2.string().optional(), defaultValue: z2.string().optional(), secretRef: z2.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 = z2.object({ name: z2.string(), label: z2.string(), description: z2.string().optional(), dangerLevel: z2.enum(DangerLevel).default("LOW").optional(), requiresConfirmation: z2.boolean().optional(), category: z2.string().optional(), order: z2.number().int().optional(), inputSchema: AnyJson.optional(), outputSchema: AnyJson.optional(), timeoutSeconds: z2.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(),
+var ReportedServiceSchema = z2.object({
+  code: z2.string().min(1).max(80),
+  name: z2.string().min(1).max(200),
+  description: z2.string().max(2e3).optional(),
+  version: z2.string().max(80).optional(),
+  runtime: z2.string().optional(),
   manifest: AnyJson,
-  capabilities: z.array(ServiceCapabilitySchema).optional(),
-  events: z.array(EventMetadataSchema).optional(),
+  capabilities: z2.array(ServiceCapabilitySchema).optional(),
+  events: z2.array(EventMetadataSchema).optional(),
   health: HealthReportInputSchema.optional(),
-  configs: z.array(ConfigItemInputSchema).optional(),
-  actions: z.array(ActionDefinitionInputSchema).optional(),
+  configs: z2.array(ConfigItemInputSchema).optional(),
+  actions: z2.array(ActionDefinitionInputSchema).optional(),
   serviceKind: ServiceKindSchema.optional()
 });
 var reportedServiceSchema = ReportedServiceSchema;
-var ServiceReportRequestSchema = z.object({ services: z.array(ReportedServiceSchema).min(1) });
+var ReportedWorkerSchema = ReportedServiceSchema;
+var reportedWorkerSchema = ReportedWorkerSchema;
+var WorkerRuntimeReportSchema = ReportedWorkerSchema;
+var workerRuntimeReportSchema = WorkerRuntimeReportSchema;
+var ServiceReportRequestSchema = z2.object({ services: z2.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: AgentModeSchema.default("embedded"), runtime: RuntimeKindSchema.or(z.string()).optional() }), service: ReportedServiceSchema.optional() });
+var WorkerReportRequestSchema = z2.object({ workers: z2.array(ReportedWorkerSchema).min(1) });
+var workerReportRequestSchema = WorkerReportRequestSchema;
+var RuntimeKindSchema = z2.enum(["nodejs", "java", "python", "go", "other"]);
+var RegisterAgentRequestSchema = z2.object({ registrationToken: z2.string().startsWith("opstage_reg_"), agent: z2.object({ code: z2.string(), name: z2.string().optional(), mode: AgentModeSchema.default("embedded"), runtime: RuntimeKindSchema.or(z2.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() });
-var AgentHeartbeatRequestSchema = z.object({ serviceId: z.string().startsWith("svc_").optional(), health: HealthReportInputSchema.optional() });
+var RegisterAgentResponseSchema = z2.object({ agentId: z2.string().startsWith("agt_"), agentToken: z2.string().startsWith("opstage_agent_"), heartbeatIntervalSeconds: z2.number().int(), commandPollIntervalSeconds: z2.number().int() });
+var AgentHeartbeatResponseSchema = z2.object({ heartbeatIntervalSeconds: z2.number().int(), commandPollIntervalSeconds: z2.number().int() });
+var AgentHeartbeatRequestSchema = z2.object({ serviceId: z2.string().startsWith("svc_").optional(), health: HealthReportInputSchema.optional() });
 var agentHeartbeatRequestSchema = AgentHeartbeatRequestSchema;
-var CapsuleServiceSchema = z.object({ id: z.string().startsWith("svc_"), agentId: z.string().startsWith("agt_").optional(), code: z.string(), name: z.string(), description: z.string().nullable().optional(), version: z.string().nullable().optional(), runtime: z.string().nullable().optional(), status: CapsuleServiceStatusSchema, healthStatus: HealthStatusSchema.optional(), lastReportedAt: z.string().nullable().optional(), lastHealthAt: z.string().nullable().optional(), createdAt: z.string(), updatedAt: z.string() });
-var HealthReportSchema = z.object({ id: z.string().startsWith("hlr_"), serviceId: z.string().startsWith("svc_"), agentId: z.string().startsWith("agt_").optional(), status: HealthStatusSchema, message: z.string().nullable().optional(), details: AnyJson.optional(), reportedAt: z.string() });
-var ConfigItemSchema = z.object({ id: z.string().startsWith("cfg_"), serviceId: z.string().startsWith("svc_"), key: z.string(), label: z.string().nullable().optional(), type: z.string(), source: z.string().nullable().optional(), editable: z.boolean().default(false), sensitive: z.boolean(), valuePreview: z.string().nullable().optional(), defaultValue: z.string().nullable().optional(), secretRef: z.string().nullable().optional() });
-var ActionDefinitionSchema = z.object({ id: z.string().startsWith("act_"), serviceId: z.string().startsWith("svc_"), name: z.string(), label: z.string(), description: z.string().nullable().optional(), dangerLevel: z.enum(DangerLevel), requiresConfirmation: z.boolean(), category: z.string().optional(), order: z.number().int().optional(), inputSchema: AnyJson.optional(), outputSchema: AnyJson.optional(), timeoutSeconds: z.number().int().optional() });
-var CapsuleServiceDetailSchema = CapsuleServiceSchema.extend({ manifest: AnyJson.optional(), health: HealthReportSchema.nullable().optional(), configs: z.array(ConfigItemSchema).optional(), actions: z.array(ActionDefinitionSchema).optional() });
-var ActionPrepareResultSchema = z.object({
+var CapsuleServiceSchema = z2.object({ id: z2.string().startsWith("svc_"), agentId: z2.string().startsWith("agt_").optional(), code: z2.string(), name: z2.string(), description: z2.string().nullable().optional(), version: z2.string().nullable().optional(), runtime: z2.string().nullable().optional(), status: CapsuleServiceStatusSchema, healthStatus: HealthStatusSchema.optional(), lastReportedAt: z2.string().nullable().optional(), lastHealthAt: z2.string().nullable().optional(), createdAt: z2.string(), updatedAt: z2.string() });
+var WorkerSchema = CapsuleServiceSchema;
+var workerSchema = WorkerSchema;
+var WorkerInstanceSchema = CapsuleServiceSchema;
+var workerInstanceSchema = WorkerInstanceSchema;
+var HealthReportSchema = z2.object({ id: z2.string().startsWith("hlr_"), serviceId: z2.string().startsWith("svc_"), agentId: z2.string().startsWith("agt_").optional(), status: HealthStatusSchema, message: z2.string().nullable().optional(), details: AnyJson.optional(), reportedAt: z2.string() });
+var ConfigItemSchema = z2.object({ id: z2.string().startsWith("cfg_"), serviceId: z2.string().startsWith("svc_"), key: z2.string(), label: z2.string().nullable().optional(), type: z2.string(), source: z2.string().nullable().optional(), editable: z2.boolean().default(false), sensitive: z2.boolean(), valuePreview: z2.string().nullable().optional(), defaultValue: z2.string().nullable().optional(), secretRef: z2.string().nullable().optional() });
+var ActionDefinitionSchema = z2.object({ id: z2.string().startsWith("act_"), serviceId: z2.string().startsWith("svc_"), name: z2.string(), label: z2.string(), description: z2.string().nullable().optional(), dangerLevel: z2.enum(DangerLevel), requiresConfirmation: z2.boolean(), category: z2.string().optional(), order: z2.number().int().optional(), inputSchema: AnyJson.optional(), outputSchema: AnyJson.optional(), timeoutSeconds: z2.number().int().optional() });
+var CapsuleServiceDetailSchema = CapsuleServiceSchema.extend({ manifest: AnyJson.optional(), health: HealthReportSchema.nullable().optional(), configs: z2.array(ConfigItemSchema).optional(), actions: z2.array(ActionDefinitionSchema).optional() });
+var WorkerDetailSchema = CapsuleServiceDetailSchema;
+var workerDetailSchema = WorkerDetailSchema;
+var WorkerInstanceDetailSchema = CapsuleServiceDetailSchema;
+var workerInstanceDetailSchema = WorkerInstanceDetailSchema;
+var ActionPrepareResultSchema = z2.object({
   action: AnyJson.optional(),
   inputSchema: AnyJson.optional(),
   initialPayload: AnyJson.optional(),
   currentState: AnyJson.optional()
 });
 var actionPrepareResultSchema = ActionPrepareResultSchema;
-var CapsuleBusExperimentalSchema = z.literal("v0.4-experimental");
+var CapsuleBusExperimentalSchema = z2.literal("v0.4-experimental");
 var BusRouteStatus = ["ENABLED", "DISABLED", "DRY_RUN"];
-var BusRouteStatusSchema = z.enum(BusRouteStatus);
-var BusEventEnvelopeSchema = z.object({
-  id: z.string().startsWith("bev_").optional(),
+var BusRouteStatusSchema = z2.enum(BusRouteStatus);
+var BusEventEnvelopeSchema = z2.object({
+  id: z2.string().startsWith("bev_").optional(),
   experimental: CapsuleBusExperimentalSchema.default("v0.4-experimental"),
-  eventType: z.string().min(1).max(160),
-  sourceServiceCode: z.string().min(1).max(80),
-  sourceServiceId: z.string().startsWith("svc_").optional(),
-  occurredAt: z.string().datetime().optional(),
-  correlationId: z.string().min(1).max(160).optional(),
-  causationId: z.string().min(1).max(160).optional(),
+  eventType: z2.string().min(1).max(160),
+  sourceServiceCode: z2.string().min(1).max(80),
+  sourceServiceId: z2.string().startsWith("svc_").optional(),
+  occurredAt: z2.string().datetime().optional(),
+  correlationId: z2.string().min(1).max(160).optional(),
+  causationId: z2.string().min(1).max(160).optional(),
   payload: AnyJson.default({}).optional(),
   metadata: AnyJson.default({}).optional()
 });
 var PublishBusEventRequestSchema = BusEventEnvelopeSchema.omit({ id: true }).extend({
-  routePolicy: z.object({ dryRun: z.boolean().optional() }).optional()
+  routePolicy: z2.object({ dryRun: z2.boolean().optional() }).optional()
 });
-var BusRouteRuleSchema = z.object({
-  id: z.string().startsWith("brt_").optional(),
-  name: z.string().min(1).max(160),
-  description: z.string().max(1e3).optional(),
+var BusRouteRuleSchema = z2.object({
+  id: z2.string().startsWith("brt_").optional(),
+  name: z2.string().min(1).max(160),
+  description: z2.string().max(1e3).optional(),
   status: BusRouteStatusSchema.optional().default("DISABLED"),
-  match: z.object({
-    eventType: z.string().min(1).max(160),
-    sourceServiceCode: z.string().min(1).max(80).optional()
+  match: z2.object({
+    eventType: z2.string().min(1).max(160),
+    sourceServiceCode: z2.string().min(1).max(80).optional()
   }),
-  target: z.object({
-    serviceCode: z.string().min(1).max(80),
-    actionName: z.string().min(1).max(128)
+  target: z2.object({
+    serviceCode: z2.string().min(1).max(80),
+    actionName: z2.string().min(1).max(128)
   }),
   inputMapping: AnyJson.default({}).optional(),
   metadata: AnyJson.default({}).optional()
 });
 var CreateBusRouteRuleRequestSchema = BusRouteRuleSchema.omit({ id: true });
-var BusCommandRequestSchema = z.object({
-  commandId: z.string().startsWith("cmd_").optional(),
-  commandType: z.literal("ACTION_EXECUTE").default("ACTION_EXECUTE"),
-  targetService: z.string().min(1).max(80),
-  actionName: z.string().min(1).max(128),
-  sourceEventId: z.string().startsWith("bev_").optional(),
+var BusCommandRequestSchema = z2.object({
+  commandId: z2.string().startsWith("cmd_").optional(),
+  commandType: z2.literal("ACTION_EXECUTE").default("ACTION_EXECUTE"),
+  targetService: z2.string().min(1).max(80),
+  actionName: z2.string().min(1).max(128),
+  sourceEventId: z2.string().startsWith("bev_").optional(),
   payload: AnyJson.default({}).optional(),
-  metadata: z.object({
-    routingRuleId: z.string().startsWith("brt_").optional(),
-    correlationId: z.string().min(1).max(160).optional()
-  }).catchall(z.any()).optional()
+  metadata: z2.object({
+    routingRuleId: z2.string().startsWith("brt_").optional(),
+    correlationId: z2.string().min(1).max(160).optional()
+  }).catchall(z2.any()).optional()
 });
 var busCommandRequestSchema = BusCommandRequestSchema;
 var BusRoutingRuleSchema = BusRouteRuleSchema;
 var busRoutingRuleSchema = BusRoutingRuleSchema;
-var BusRoutedCommandSchema = z.object({
-  routeId: z.string().startsWith("brt_"),
-  commandId: z.string().startsWith("cmd_").optional(),
-  dryRun: z.boolean(),
-  targetServiceCode: z.string(),
-  actionName: z.string(),
-  status: z.enum(["CREATED", "DRY_RUN", "SKIPPED", "FAILED"]),
-  errorCode: z.string().optional(),
-  errorMessage: z.string().optional()
+var BusRoutedCommandSchema = z2.object({
+  routeId: z2.string().startsWith("brt_"),
+  commandId: z2.string().startsWith("cmd_").optional(),
+  dryRun: z2.boolean(),
+  targetServiceCode: z2.string(),
+  actionName: z2.string(),
+  status: z2.enum(["CREATED", "DRY_RUN", "SKIPPED", "FAILED"]),
+  errorCode: z2.string().optional(),
+  errorMessage: z2.string().optional()
 });
-var PublishBusEventResponseSchema = z.object({
-  eventId: z.string().startsWith("bev_"),
+var PublishBusEventResponseSchema = z2.object({
+  eventId: z2.string().startsWith("bev_"),
   experimental: CapsuleBusExperimentalSchema,
-  routedCommands: z.array(BusRoutedCommandSchema)
+  routedCommands: z2.array(BusRoutedCommandSchema)
 });
 var BusEventRecordSchema = BusEventEnvelopeSchema.extend({
-  id: z.string().startsWith("bev_"),
-  agentId: z.string().startsWith("agt_"),
-  acceptedAt: z.string(),
-  routeCount: z.number().int()
+  id: z2.string().startsWith("bev_"),
+  agentId: z2.string().startsWith("agt_"),
+  acceptedAt: z2.string(),
+  routeCount: z2.number().int()
 });
 var BusErrorCode = {
   CAPSULE_BUS_DISABLED: "CAPSULE_BUS_DISABLED",
@@ -159,19 +275,19 @@ var publishBusEventResponseSchema = PublishBusEventResponseSchema;
 var busEventEnvelopeSchema = BusEventEnvelopeSchema;
 var busRouteRuleSchema = BusRouteRuleSchema;
 var createBusRouteRuleRequestSchema = CreateBusRouteRuleRequestSchema;
-var CreateActionCommandRequestSchema = z.object({ payload: AnyJson.optional(), confirmation: z.boolean().optional() });
+var CreateActionCommandRequestSchema = z2.object({ payload: AnyJson.optional(), confirmation: z2.boolean().optional() });
 var createActionCommandRequestSchema = CreateActionCommandRequestSchema;
-var CommandTypeSchema = z.enum(["ACTION_PREPARE", "ACTION_EXECUTE"]);
-var CommandSchema = z.object({ id: z.string().startsWith("cmd_"), agentId: z.string().startsWith("agt_"), serviceId: z.string().startsWith("svc_"), type: CommandTypeSchema, actionName: z.string(), status: CommandStatusSchema, payload: AnyJson.optional(), createdByUserId: z.string().startsWith("usr_").nullable().optional(), createdAt: z.string(), startedAt: z.string().nullable().optional(), completedAt: z.string().nullable().optional(), expiresAt: z.string().nullable().optional() });
-var ReportCommandResultRequestSchema = z.object({ success: z.boolean(), message: z.string().optional(), data: AnyJson.optional(), error: AnyJson.optional(), startedAt: z.string().optional(), finishedAt: z.string().optional() });
+var CommandTypeSchema = z2.enum(["ACTION_PREPARE", "ACTION_EXECUTE"]);
+var CommandSchema = z2.object({ id: z2.string().startsWith("cmd_"), agentId: z2.string().startsWith("agt_"), serviceId: z2.string().startsWith("svc_"), type: CommandTypeSchema, actionName: z2.string(), status: CommandStatusSchema, payload: AnyJson.optional(), createdByUserId: z2.string().startsWith("usr_").nullable().optional(), createdAt: z2.string(), startedAt: z2.string().nullable().optional(), completedAt: z2.string().nullable().optional(), expiresAt: z2.string().nullable().optional() });
+var ReportCommandResultRequestSchema = z2.object({ success: z2.boolean(), message: z2.string().optional(), data: AnyJson.optional(), error: AnyJson.optional(), startedAt: z2.string().optional(), finishedAt: z2.string().optional() });
 var reportCommandResultRequestSchema = ReportCommandResultRequestSchema;
-var CommandResultSchema = z.object({ id: z.string().startsWith("crs_"), commandId: z.string().startsWith("cmd_"), success: z.boolean(), message: z.string().nullable().optional(), data: AnyJson.optional(), error: AnyJson.optional(), reportedAt: z.string() });
+var CommandResultSchema = z2.object({ id: z2.string().startsWith("crs_"), commandId: z2.string().startsWith("cmd_"), success: z2.boolean(), message: z2.string().nullable().optional(), data: AnyJson.optional(), error: AnyJson.optional(), reportedAt: z2.string() });
 var CommandDetailSchema = CommandSchema.extend({ result: CommandResultSchema.nullable().optional() });
-var AuditEventSchema = z.object({ id: z.string().startsWith("aud_"), actorType: z.enum(AuditActorType), actorId: z.string().nullable().optional(), action: z.string(), targetType: z.string().nullable().optional(), targetId: z.string().nullable().optional(), result: z.enum(AuditResult), message: z.string().nullable().optional(), metadata: AnyJson.optional(), createdAt: z.string() });
-var DashboardSummarySchema = z.object({ agentCounts: z.record(z.number().int()), serviceCounts: z.record(z.number().int()), commandCounts: z.record(z.number().int()), recentCommands: z.array(CommandSchema).optional(), recentAuditEvents: z.array(AuditEventSchema).optional() });
-var SystemHealthSchema = z.object({ status: z.enum(["UP", "DEGRADED", "DOWN"]), timestamp: z.string(), version: z.string(), edition: z.literal("ce"), database: z.object({ status: z.enum(["UP", "DEGRADED", "DOWN"]), kind: z.enum(["sqlite", "postgres", "mysql"]).optional(), latencyMs: z.number().int().optional() }), uptimeSeconds: z.number().int().optional() });
-var SystemVersionSchema = z.object({ version: z.string(), edition: z.literal("ce"), commit: z.string().optional(), buildTime: z.string().optional() });
-var ListQueryBase = z.object({ page: z.coerce.number().int().min(1).default(1), pageSize: z.coerce.number().int().min(1).max(100).default(20), sort: z.string().optional() });
+var AuditEventSchema = z2.object({ id: z2.string().startsWith("aud_"), actorType: z2.enum(AuditActorType), actorId: z2.string().nullable().optional(), action: z2.string(), targetType: z2.string().nullable().optional(), targetId: z2.string().nullable().optional(), result: z2.enum(AuditResult), message: z2.string().nullable().optional(), metadata: AnyJson.optional(), createdAt: z2.string() });
+var DashboardSummarySchema = z2.object({ agentCounts: z2.record(z2.number().int()), serviceCounts: z2.record(z2.number().int()), commandCounts: z2.record(z2.number().int()), recentCommands: z2.array(CommandSchema).optional(), recentAuditEvents: z2.array(AuditEventSchema).optional() });
+var SystemHealthSchema = z2.object({ status: z2.enum(["UP", "DEGRADED", "DOWN"]), timestamp: z2.string(), version: z2.string(), edition: z2.literal("ce"), database: z2.object({ status: z2.enum(["UP", "DEGRADED", "DOWN"]), kind: z2.enum(["sqlite", "postgres", "mysql"]).optional(), latencyMs: z2.number().int().optional() }), uptimeSeconds: z2.number().int().optional() });
+var SystemVersionSchema = z2.object({ version: z2.string(), edition: z2.literal("ce"), commit: z2.string().optional(), buildTime: z2.string().optional() });
+var ListQueryBase = z2.object({ page: z2.coerce.number().int().min(1).default(1), pageSize: z2.coerce.number().int().min(1).max(100).default(20), sort: z2.string().optional() });
 var HttpError = class extends Error {
   constructor(httpStatus, code, publicMessage, details) {
     super(publicMessage);
@@ -210,7 +326,8 @@ var ErrorCode = {
   TOKEN_REVOKED: "TOKEN_REVOKED",
   TOKEN_EXPIRED: "TOKEN_EXPIRED",
   AGENT_REVOKED: "AGENT_REVOKED",
-  AGENT_DISABLED: "AGENT_DISABLED"
+  AGENT_DISABLED: "AGENT_DISABLED",
+  CAPSULE_SERVICE_CODE_TAKEN: "CAPSULE_SERVICE_CODE_TAKEN"
 };
 export {
   ActionDefinitionInputSchema,
@@ -220,6 +337,7 @@ export {
   AdminSessionSchema,
   AgentHeartbeatRequestSchema,
   AgentHeartbeatResponseSchema,
+  AgentHeartbeatSchema,
   AgentMode,
   AgentModeSchema,
   AgentSchema,
@@ -238,12 +356,14 @@ export {
   BusRouteStatusSchema,
   BusRoutedCommandSchema,
   BusRoutingRuleSchema,
+  CE_CONTRACT_VERSION,
   CapsuleBusExperimentalSchema,
   CapsuleManifestSchema,
   CapsuleServiceDetailSchema,
   CapsuleServiceSchema,
   CapsuleServiceStatus,
   CapsuleServiceStatusSchema,
+  CeErrorCode,
   CommandDetailSchema,
   CommandResultSchema,
   CommandSchema,
@@ -252,6 +372,9 @@ export {
   CommandTypeSchema,
   ConfigItemInputSchema,
   ConfigItemSchema,
+  ConversationMessageSchema,
+  ConversationTargetType,
+  ConversationTargetTypeSchema,
   CreateActionCommandRequestSchema,
   CreateBusRouteRuleRequestSchema,
   CreateRegistrationTokenRequestSchema,
@@ -260,6 +383,7 @@ export {
   DangerLevelSchema,
   DashboardSummarySchema,
   ErrorCode,
+  ErrorModelSchema,
   EventMetadataSchema,
   HealthReportInputSchema,
   HealthReportSchema,
@@ -267,6 +391,10 @@ export {
   HealthStatusSchema,
   HttpError,
   ListQueryBase,
+  MessageSenderType,
+  MessageSenderTypeSchema,
+  MessageType,
+  MessageTypeSchema,
   PublishBusEventRequestSchema,
   PublishBusEventResponseSchema,
   RegisterAgentRequestSchema,
@@ -274,16 +402,30 @@ export {
   RegistrationTokenSchema,
   ReportCommandResultRequestSchema,
   ReportedServiceSchema,
+  ReportedWorkerSchema,
   RuntimeKindSchema,
   ServiceCapabilitySchema,
+  ServiceInstanceHealth,
+  ServiceInstanceHealthSchema,
+  ServiceInstanceSchema,
   ServiceKind,
   ServiceKindSchema,
+  ServiceManifestSchema,
   ServiceReportRequestSchema,
   SystemHealthSchema,
   SystemVersionSchema,
   TokenStatus,
   UserRole,
   UserSchema,
+  WorkerDetailSchema,
+  WorkerInstanceDetailSchema,
+  WorkerInstanceSchema,
+  WorkerManifestSchema,
+  WorkerReportRequestSchema,
+  WorkerRuntimeReportSchema,
+  WorkerSchema,
+  WorkerStatus,
+  WorkerStatusSchema,
   actionDefinitionInputSchema,
   actionPrepareResultSchema,
   adminLoginRequestSchema,
@@ -306,9 +448,17 @@ export {
   registerAgentRequestSchema,
   reportCommandResultRequestSchema,
   reportedServiceSchema,
+  reportedWorkerSchema,
   resetUserPasswordRequestSchema,
   serviceCapabilitySchema,
   serviceReportRequestSchema,
   updateUserRequestSchema,
-  z
+  workerDetailSchema,
+  workerInstanceDetailSchema,
+  workerInstanceSchema,
+  workerManifestSchema,
+  workerReportRequestSchema,
+  workerRuntimeReportSchema,
+  workerSchema,
+  z2 as z
 };

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@xtrape/capsule-contracts-node",
-  "version": "0.4.0",
-  "description": "TypeScript contracts and Zod schemas for Xtrape Capsule and Opstage wire protocols.",
+  "version": "0.5.0",
+  "description": "TypeScript contracts and Zod schemas for Xtrape Agent, Worker, and Panel wire protocols.",
   "keywords": [
     "xtrape",
-    "capsule",
+    "worker",
+    "panel",
     "opstage",
     "contracts",
     "zod",

package/spec/.source

@@ -1 +1 @@
-xtrape-capsule-docs@local
+xtrape-contracts-nodejs@local-authority

package/spec/enums/audit-actions.json

@@ -99,7 +99,7 @@
       "name": "service.reported",
       "actorType": "AGENT",
       "targetType": "CapsuleService",
-      "summary": "Agent reported (or updated) a Capsule Service manifest."
+      "summary": "Agent reported or updated a Worker Runtime Report; action name is retained for compatibility."
     },
     {
       "name": "service.retired",
@@ -111,7 +111,7 @@
       "name": "service.action.requested",
       "actorType": "USER",
       "targetType": "CapsuleService",
-      "summary": "Admin requested an action on a Capsule Service; backend created a Command."
+      "summary": "Admin requested a Worker Action; backend created a Command."
     },
     {
       "name": "command.created",

package/spec/enums/id-prefixes.json

@@ -16,7 +16,7 @@
     { "prefix": "agt", "type": "Agent",             "comment": "Agent identity." },
     { "prefix": "tok", "type": "RegistrationToken", "comment": "Registration token (the row; the raw token value is generated separately via newToken('reg'))." },
     { "prefix": "atk", "type": "AgentToken",        "comment": "Agent token (the row; raw token via newToken('agt'))." },
-    { "prefix": "svc", "type": "CapsuleService",    "comment": "Capsule Service registered by an Agent." },
+    { "prefix": "svc", "type": "CapsuleService",    "comment": "Worker Instance reported by an Agent; persisted type name retained for compatibility." },
     { "prefix": "act", "type": "ActionDefinition",  "comment": "Action declared on a service manifest." },
     { "prefix": "cmd", "type": "Command",           "comment": "Command for an Agent to execute." },
     { "prefix": "res", "type": "CommandResult",     "comment": "Optional separate row for command results; CE v0.1 may inline into Command." },

package/spec/enums/status-enums.json

@@ -21,7 +21,7 @@
       ]
     },
     "CapsuleServiceStatus": {
-      "description": "Effective lifecycle state of a Capsule Service. Persisted by the backend as derived from agent.status, lastReportedAt, and admin actions.",
+      "description": "Effective lifecycle state of a Worker Instance. The schema name is retained for wire compatibility.",
       "values": [
         { "value": "PENDING",  "meaning": "Service was reported by an Agent but has not yet sent a health report." },
         { "value": "UP",       "meaning": "Service has reported a healthy status within freshness threshold." },
@@ -119,7 +119,7 @@
     "AgentMode": {
       "description": "Deployment mode of an Agent.",
       "values": [
-        { "value": "embedded", "meaning": "Agent runs in-process inside a Capsule Service (CE v0.1 baseline)." },
+        { "value": "embedded", "meaning": "Agent runs in-process inside a Worker (CE v0.1 baseline)." },
         { "value": "sidecar",  "meaning": "Agent runs as a separate process beside services. Reserved for EE.", "reservedFor": "EE" },
         { "value": "external", "meaning": "Agent runs as a separate fleet manager. Reserved for EE/Cloud.", "reservedFor": "EE" }
       ]

package/spec/errors.json

@@ -76,12 +76,12 @@
     },
     {
       "name": "capsuleService",
-      "title": "Capsule Service Codes",
+      "title": "Worker compatibility codes",
       "codes": [
         { "code": "CAPSULE_SERVICE_NOT_FOUND",        "httpStatus": 404, "meaning": "serviceId does not exist." },
         { "code": "CAPSULE_SERVICE_NOT_OWNED",        "httpStatus": 403, "meaning": "Service exists but does not belong to the calling Agent." },
         { "code": "CAPSULE_SERVICE_MANIFEST_INVALID", "httpStatus": 422, "meaning": "Manifest validation failed (missing required fields, etc.)." },
-        { "code": "CAPSULE_SERVICE_CODE_TAKEN",       "httpStatus": 409, "meaning": "Service code conflict in workspace." }
+        { "code": "CAPSULE_SERVICE_CODE_TAKEN",       "httpStatus": 409, "meaning": "Worker code is already owned in the workspace; code name is retained for compatibility." }
       ]
     },
     {

package/spec/errors.md

@@ -89,7 +89,7 @@ Rules:
 
 ---
 
-## 6. Capsule Service Codes
+## 6. Worker compatibility codes
 
 | Code                              | HTTP | Meaning                                                       |
 |-----------------------------------|------|---------------------------------------------------------------|