@xtrape/capsule-contracts-node 0.2.0 → 0.4.0

package/README.md

@@ -41,7 +41,7 @@ The package currently exports:
 - Zod itself as `z` for consumers that want one compatible Zod instance.
 - Status enum arrays and types: `AgentStatus`, `CapsuleServiceStatus`,
   `HealthStatus`, `CommandStatus`, `DangerLevel`, `AuditActorType`,
-  `AuditResult`, `TokenStatus`.
+  `AuditResult`, `TokenStatus`, `AgentMode`.
 - Admin schemas: users, sessions, registration token requests/responses.
 - Agent schemas: registration, heartbeat, service report, command result.
 - Capsule Service schemas: manifest, health, config, action, service detail.
@@ -58,7 +58,7 @@ import { RegisterAgentRequestSchema } from "@xtrape/capsule-contracts-node";
 const request = RegisterAgentRequestSchema.parse(input);
 
 // request.registrationToken starts with opstage_reg_
-// request.agent.mode is embedded
+// request.agent.mode is embedded or ophub
 ```
 
 Lowercase aliases are also exported for backend compatibility:
@@ -69,6 +69,52 @@ import { registerAgentRequestSchema } from "@xtrape/capsule-contracts-node";
 const request = registerAgentRequestSchema.parse(input);
 ```
 
+## v0.3 OpHub and Metadata
+
+v0.3 adds the experimental `ophub` Agent mode. `sidecar` and `base-image`
+remain OpHub deployment forms, but the wire contract should use
+`mode: "ophub"` for an OpHub that represents one or more local Capsule
+Services.
+
+```ts
+import { RegisterAgentRequestSchema, ServiceReportRequestSchema } from "@xtrape/capsule-contracts-node";
+
+RegisterAgentRequestSchema.parse({
+  registrationToken: "opstage_reg_...",
+  agent: {
+    code: "ophub-a",
+    name: "OpHub A",
+    mode: "ophub",
+    runtime: "go",
+  },
+});
+
+ServiceReportRequestSchema.parse({
+  services: [
+    {
+      code: "svc-one",
+      name: "Service One",
+      version: "0.3.0",
+      runtime: "nodejs",
+      manifest: {
+        kind: "CapsuleService",
+        code: "svc-one",
+        name: "Service One",
+        version: "0.3.0",
+        runtime: "nodejs",
+        agentMode: "ophub",
+        capabilities: [{ name: "inventory.read", label: "Inventory read" }],
+        events: [{ name: "inventory.changed", direction: "publish", designOnly: true }],
+      },
+    },
+  ],
+});
+```
+
+Capability metadata is implemented as declarative service metadata. Event
+metadata is intentionally a foundation for future Capsule Bus work; `designOnly`
+events must not be treated as a working event bus.
+
 ## Validate Service Report
 
 ```ts
@@ -358,3 +404,27 @@ contract validation safety guidance.
 
 Apache-2.0. "Xtrape", "Xtrape Capsule", and "Opstage" are trademarks of their
 respective owners; the open-source license does not grant trademark rights.
+
+## v0.4 Capsule Bus Experimental
+
+`v0.4` adds an experimental Capsule Bus contract surface for CE's built-in SQLite-backed in-process event-to-command router. It is intentionally small, single-node, and disabled by default; it is **not** a standalone Bus Server, external broker (NATS / RabbitMQ / Redis Streams / Kafka), workflow DSL, or service mesh. No fan-out (`maxCommandsPerEvent`) in v0.4 — one matched route produces at most one `ACTION_EXECUTE` command.
+
+Key exports:
+
+- `BusEventEnvelopeSchema`
+- `PublishBusEventRequestSchema`
+- `PublishBusEventResponseSchema`
+- `BusRouteRuleSchema`
+- `CreateBusRouteRuleRequestSchema`
+
+Minimal event payload:
+
+```ts
+BusEventEnvelopeSchema.parse({
+  eventType: "demo.item.created",
+  sourceServiceCode: "demo-worker",
+  payload: { itemId: "item-1" },
+});
+```
+
+All schemas include or default `experimental: "v0.4-experimental"`; consumers should treat the wire surface as unstable until v1.0.

package/dist/index.cjs

@@ -27,6 +27,8 @@ __export(index_exports, {
   AdminSessionSchema: () => AdminSessionSchema,
   AgentHeartbeatRequestSchema: () => AgentHeartbeatRequestSchema,
   AgentHeartbeatResponseSchema: () => AgentHeartbeatResponseSchema,
+  AgentMode: () => AgentMode,
+  AgentModeSchema: () => AgentModeSchema,
   AgentSchema: () => AgentSchema,
   AgentStatus: () => AgentStatus,
   AgentStatusSchema: () => AgentStatusSchema,
@@ -34,6 +36,16 @@ __export(index_exports, {
   AuditActorType: () => AuditActorType,
   AuditEventSchema: () => AuditEventSchema,
   AuditResult: () => AuditResult,
+  BusCommandRequestSchema: () => BusCommandRequestSchema,
+  BusErrorCode: () => BusErrorCode,
+  BusEventEnvelopeSchema: () => BusEventEnvelopeSchema,
+  BusEventRecordSchema: () => BusEventRecordSchema,
+  BusRouteRuleSchema: () => BusRouteRuleSchema,
+  BusRouteStatus: () => BusRouteStatus,
+  BusRouteStatusSchema: () => BusRouteStatusSchema,
+  BusRoutedCommandSchema: () => BusRoutedCommandSchema,
+  BusRoutingRuleSchema: () => BusRoutingRuleSchema,
+  CapsuleBusExperimentalSchema: () => CapsuleBusExperimentalSchema,
   CapsuleManifestSchema: () => CapsuleManifestSchema,
   CapsuleServiceDetailSchema: () => CapsuleServiceDetailSchema,
   CapsuleServiceSchema: () => CapsuleServiceSchema,
@@ -48,24 +60,31 @@ __export(index_exports, {
   ConfigItemInputSchema: () => ConfigItemInputSchema,
   ConfigItemSchema: () => ConfigItemSchema,
   CreateActionCommandRequestSchema: () => CreateActionCommandRequestSchema,
+  CreateBusRouteRuleRequestSchema: () => CreateBusRouteRuleRequestSchema,
   CreateRegistrationTokenRequestSchema: () => CreateRegistrationTokenRequestSchema,
   CreateRegistrationTokenResponseSchema: () => CreateRegistrationTokenResponseSchema,
   DangerLevel: () => DangerLevel,
   DangerLevelSchema: () => DangerLevelSchema,
   DashboardSummarySchema: () => DashboardSummarySchema,
   ErrorCode: () => ErrorCode,
+  EventMetadataSchema: () => EventMetadataSchema,
   HealthReportInputSchema: () => HealthReportInputSchema,
   HealthReportSchema: () => HealthReportSchema,
   HealthStatus: () => HealthStatus,
   HealthStatusSchema: () => HealthStatusSchema,
   HttpError: () => HttpError,
   ListQueryBase: () => ListQueryBase,
+  PublishBusEventRequestSchema: () => PublishBusEventRequestSchema,
+  PublishBusEventResponseSchema: () => PublishBusEventResponseSchema,
   RegisterAgentRequestSchema: () => RegisterAgentRequestSchema,
   RegisterAgentResponseSchema: () => RegisterAgentResponseSchema,
   RegistrationTokenSchema: () => RegistrationTokenSchema,
   ReportCommandResultRequestSchema: () => ReportCommandResultRequestSchema,
   ReportedServiceSchema: () => ReportedServiceSchema,
   RuntimeKindSchema: () => RuntimeKindSchema,
+  ServiceCapabilitySchema: () => ServiceCapabilitySchema,
+  ServiceKind: () => ServiceKind,
+  ServiceKindSchema: () => ServiceKindSchema,
   ServiceReportRequestSchema: () => ServiceReportRequestSchema,
   SystemHealthSchema: () => SystemHealthSchema,
   SystemVersionSchema: () => SystemVersionSchema,
@@ -76,17 +95,26 @@ __export(index_exports, {
   actionPrepareResultSchema: () => actionPrepareResultSchema,
   adminLoginRequestSchema: () => adminLoginRequestSchema,
   agentHeartbeatRequestSchema: () => agentHeartbeatRequestSchema,
+  busCommandRequestSchema: () => busCommandRequestSchema,
+  busEventEnvelopeSchema: () => busEventEnvelopeSchema,
+  busRouteRuleSchema: () => busRouteRuleSchema,
+  busRoutingRuleSchema: () => busRoutingRuleSchema,
   configItemInputSchema: () => configItemInputSchema,
   createActionCommandRequestSchema: () => createActionCommandRequestSchema,
+  createBusRouteRuleRequestSchema: () => createBusRouteRuleRequestSchema,
   createRegistrationTokenRequestSchema: () => createRegistrationTokenRequestSchema,
   createUserRequestSchema: () => createUserRequestSchema,
+  eventMetadataSchema: () => eventMetadataSchema,
   healthReportInputSchema: () => healthReportInputSchema,
   paginate: () => paginate,
   parseSort: () => parseSort,
+  publishBusEventRequestSchema: () => publishBusEventRequestSchema,
+  publishBusEventResponseSchema: () => publishBusEventResponseSchema,
   registerAgentRequestSchema: () => registerAgentRequestSchema,
   reportCommandResultRequestSchema: () => reportCommandResultRequestSchema,
   reportedServiceSchema: () => reportedServiceSchema,
   resetUserPasswordRequestSchema: () => resetUserPasswordRequestSchema,
+  serviceCapabilitySchema: () => serviceCapabilitySchema,
   serviceReportRequestSchema: () => serviceReportRequestSchema,
   updateUserRequestSchema: () => updateUserRequestSchema,
   z: () => import_zod.z
@@ -101,27 +129,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 AgentMode = ["embedded", "ophub"];
+var ServiceKind = ["business", "infrastructure", "system"];
+var ServiceKindSchema = import_zod.z.enum(ServiceKind);
 var AnyJson = import_zod.z.record(import_zod.z.any());
 var AgentStatusSchema = import_zod.z.enum(AgentStatus);
 var CapsuleServiceStatusSchema = import_zod.z.enum(CapsuleServiceStatus);
 var HealthStatusSchema = import_zod.z.enum(HealthStatus);
 var CommandStatusSchema = import_zod.z.enum(CommandStatus);
 var DangerLevelSchema = import_zod.z.enum(DangerLevel).default("LOW");
+var AgentModeSchema = import_zod.z.enum(AgentMode);
 var UserSchema = import_zod.z.object({ id: import_zod.z.string().startsWith("usr_"), username: import_zod.z.string(), displayName: import_zod.z.string().nullable().optional(), createdAt: import_zod.z.string(), updatedAt: import_zod.z.string() });
 var UserRole = import_zod.z.enum(["owner", "operator", "viewer"]);
 var createUserRequestSchema = import_zod.z.object({ username: import_zod.z.string().min(1), password: import_zod.z.string().min(12), displayName: import_zod.z.string().optional(), role: UserRole.default("viewer") });
@@ -130,24 +147,41 @@ var resetUserPasswordRequestSchema = import_zod.z.object({ password: import_zod.
 var AdminLoginRequestSchema = import_zod.z.object({ username: import_zod.z.string().min(1), password: import_zod.z.string().min(1) });
 var adminLoginRequestSchema = AdminLoginRequestSchema;
 var AdminSessionSchema = import_zod.z.object({ user: UserSchema, csrfToken: import_zod.z.string(), expiresAt: import_zod.z.string() });
-var AgentSchema = import_zod.z.object({ id: import_zod.z.string().startsWith("agt_"), code: import_zod.z.string(), name: import_zod.z.string().nullable().optional(), mode: import_zod.z.enum(["embedded", "sidecar", "external"]), runtime: import_zod.z.string().nullable().optional(), status: AgentStatusSchema, lastHeartbeatAt: import_zod.z.string().nullable().optional(), createdAt: import_zod.z.string(), updatedAt: import_zod.z.string() });
+var AgentSchema = import_zod.z.object({ id: import_zod.z.string().startsWith("agt_"), code: import_zod.z.string(), name: import_zod.z.string().nullable().optional(), mode: AgentModeSchema, runtime: import_zod.z.string().nullable().optional(), status: AgentStatusSchema, lastHeartbeatAt: import_zod.z.string().nullable().optional(), createdAt: import_zod.z.string(), updatedAt: import_zod.z.string() });
 var RegistrationTokenSchema = import_zod.z.object({ id: import_zod.z.string().startsWith("tok_"), name: import_zod.z.string(), status: import_zod.z.enum(TokenStatus), expiresAt: import_zod.z.string().nullable().optional(), usedAt: import_zod.z.string().nullable().optional(), createdAt: import_zod.z.string() });
 var CreateRegistrationTokenRequestSchema = import_zod.z.object({ name: import_zod.z.string().default("Default registration token").optional(), expiresInSeconds: import_zod.z.number().int().min(60).optional() });
 var createRegistrationTokenRequestSchema = CreateRegistrationTokenRequestSchema;
 var CreateRegistrationTokenResponseSchema = RegistrationTokenSchema.extend({ rawToken: import_zod.z.string().startsWith("opstage_reg_") });
-var CapsuleManifestSchema = import_zod.z.object({ kind: import_zod.z.literal("CapsuleService"), schemaVersion: import_zod.z.string().default("1.0").optional(), code: import_zod.z.string().min(1), name: import_zod.z.string().min(1), description: import_zod.z.string().optional(), version: import_zod.z.string().min(1), runtime: import_zod.z.enum(["nodejs", "java", "python", "go", "other"]), agentMode: import_zod.z.enum(["embedded", "sidecar", "external"]), capabilities: import_zod.z.array(import_zod.z.string()).optional(), labels: import_zod.z.record(import_zod.z.string()).optional() }).passthrough();
+var ServiceCapabilitySchema = import_zod.z.object({ name: import_zod.z.string().min(1).max(120), label: import_zod.z.string().max(200).optional(), description: import_zod.z.string().max(2e3).optional(), metadata: AnyJson.optional() });
+var serviceCapabilitySchema = ServiceCapabilitySchema;
+var EventMetadataSchema = import_zod.z.object({ name: import_zod.z.string().min(1).max(160), direction: import_zod.z.enum(["publish", "subscribe"]).optional(), schema: AnyJson.optional(), designOnly: import_zod.z.boolean().default(true), metadata: AnyJson.optional() });
+var eventMetadataSchema = EventMetadataSchema;
+var CapsuleManifestSchema = import_zod.z.object({ kind: import_zod.z.literal("CapsuleService"), schemaVersion: import_zod.z.string().default("1.0").optional(), code: import_zod.z.string().min(1), name: import_zod.z.string().min(1), description: import_zod.z.string().optional(), version: import_zod.z.string().min(1), runtime: import_zod.z.enum(["nodejs", "java", "python", "go", "other"]), agentMode: AgentModeSchema, capabilities: import_zod.z.array(import_zod.z.union([import_zod.z.string(), ServiceCapabilitySchema])).optional(), events: import_zod.z.array(EventMetadataSchema).optional(), labels: import_zod.z.record(import_zod.z.string()).optional() }).passthrough();
 var HealthReportInputSchema = import_zod.z.object({ status: HealthStatusSchema, message: import_zod.z.string().optional(), details: AnyJson.optional() });
 var healthReportInputSchema = HealthReportInputSchema;
 var ConfigItemInputSchema = import_zod.z.object({ key: import_zod.z.string(), label: import_zod.z.string().optional(), type: import_zod.z.string(), source: import_zod.z.string().optional(), editable: import_zod.z.boolean().optional(), sensitive: import_zod.z.boolean().optional(), valuePreview: import_zod.z.string().optional(), defaultValue: import_zod.z.string().optional(), secretRef: import_zod.z.string().optional() });
 var configItemInputSchema = ConfigItemInputSchema;
 var ActionDefinitionInputSchema = import_zod.z.object({ name: import_zod.z.string(), label: import_zod.z.string(), description: import_zod.z.string().optional(), dangerLevel: import_zod.z.enum(DangerLevel).default("LOW").optional(), requiresConfirmation: import_zod.z.boolean().optional(), category: import_zod.z.string().optional(), order: import_zod.z.number().int().optional(), inputSchema: AnyJson.optional(), outputSchema: AnyJson.optional(), timeoutSeconds: import_zod.z.number().int().positive().optional() });
 var actionDefinitionInputSchema = ActionDefinitionInputSchema;
-var ReportedServiceSchema = import_zod.z.object({ code: import_zod.z.string().min(1).max(80), name: import_zod.z.string().min(1).max(200), description: import_zod.z.string().max(2e3).optional(), version: import_zod.z.string().max(80).optional(), runtime: import_zod.z.string().optional(), manifest: AnyJson, health: HealthReportInputSchema.optional(), configs: import_zod.z.array(ConfigItemInputSchema).optional(), actions: import_zod.z.array(ActionDefinitionInputSchema).optional() });
+var ReportedServiceSchema = import_zod.z.object({
+  code: import_zod.z.string().min(1).max(80),
+  name: import_zod.z.string().min(1).max(200),
+  description: import_zod.z.string().max(2e3).optional(),
+  version: import_zod.z.string().max(80).optional(),
+  runtime: import_zod.z.string().optional(),
+  manifest: AnyJson,
+  capabilities: import_zod.z.array(ServiceCapabilitySchema).optional(),
+  events: import_zod.z.array(EventMetadataSchema).optional(),
+  health: HealthReportInputSchema.optional(),
+  configs: import_zod.z.array(ConfigItemInputSchema).optional(),
+  actions: import_zod.z.array(ActionDefinitionInputSchema).optional(),
+  serviceKind: ServiceKindSchema.optional()
+});
 var reportedServiceSchema = ReportedServiceSchema;
 var ServiceReportRequestSchema = import_zod.z.object({ services: import_zod.z.array(ReportedServiceSchema).min(1) });
 var serviceReportRequestSchema = ServiceReportRequestSchema;
 var RuntimeKindSchema = import_zod.z.enum(["nodejs", "java", "python", "go", "other"]);
-var RegisterAgentRequestSchema = import_zod.z.object({ registrationToken: import_zod.z.string().startsWith("opstage_reg_"), agent: import_zod.z.object({ code: import_zod.z.string(), name: import_zod.z.string().optional(), mode: import_zod.z.literal("embedded"), runtime: RuntimeKindSchema.optional() }), service: ReportedServiceSchema.optional() });
+var RegisterAgentRequestSchema = import_zod.z.object({ registrationToken: import_zod.z.string().startsWith("opstage_reg_"), agent: import_zod.z.object({ code: import_zod.z.string(), name: import_zod.z.string().optional(), mode: AgentModeSchema.default("embedded"), runtime: RuntimeKindSchema.or(import_zod.z.string()).optional() }), service: ReportedServiceSchema.optional() });
 var registerAgentRequestSchema = RegisterAgentRequestSchema;
 var RegisterAgentResponseSchema = import_zod.z.object({ agentId: import_zod.z.string().startsWith("agt_"), agentToken: import_zod.z.string().startsWith("opstage_agent_"), heartbeatIntervalSeconds: import_zod.z.number().int(), commandPollIntervalSeconds: import_zod.z.number().int() });
 var AgentHeartbeatResponseSchema = import_zod.z.object({ heartbeatIntervalSeconds: import_zod.z.number().int(), commandPollIntervalSeconds: import_zod.z.number().int() });
@@ -165,6 +199,87 @@ var ActionPrepareResultSchema = import_zod.z.object({
   currentState: AnyJson.optional()
 });
 var actionPrepareResultSchema = ActionPrepareResultSchema;
+var CapsuleBusExperimentalSchema = import_zod.z.literal("v0.4-experimental");
+var BusRouteStatus = ["ENABLED", "DISABLED", "DRY_RUN"];
+var BusRouteStatusSchema = import_zod.z.enum(BusRouteStatus);
+var BusEventEnvelopeSchema = import_zod.z.object({
+  id: import_zod.z.string().startsWith("bev_").optional(),
+  experimental: CapsuleBusExperimentalSchema.default("v0.4-experimental"),
+  eventType: import_zod.z.string().min(1).max(160),
+  sourceServiceCode: import_zod.z.string().min(1).max(80),
+  sourceServiceId: import_zod.z.string().startsWith("svc_").optional(),
+  occurredAt: import_zod.z.string().datetime().optional(),
+  correlationId: import_zod.z.string().min(1).max(160).optional(),
+  causationId: import_zod.z.string().min(1).max(160).optional(),
+  payload: AnyJson.default({}).optional(),
+  metadata: AnyJson.default({}).optional()
+});
+var PublishBusEventRequestSchema = BusEventEnvelopeSchema.omit({ id: true }).extend({
+  routePolicy: import_zod.z.object({ dryRun: import_zod.z.boolean().optional() }).optional()
+});
+var BusRouteRuleSchema = import_zod.z.object({
+  id: import_zod.z.string().startsWith("brt_").optional(),
+  name: import_zod.z.string().min(1).max(160),
+  description: import_zod.z.string().max(1e3).optional(),
+  status: BusRouteStatusSchema.optional().default("DISABLED"),
+  match: import_zod.z.object({
+    eventType: import_zod.z.string().min(1).max(160),
+    sourceServiceCode: import_zod.z.string().min(1).max(80).optional()
+  }),
+  target: import_zod.z.object({
+    serviceCode: import_zod.z.string().min(1).max(80),
+    actionName: import_zod.z.string().min(1).max(128)
+  }),
+  inputMapping: AnyJson.default({}).optional(),
+  metadata: AnyJson.default({}).optional()
+});
+var CreateBusRouteRuleRequestSchema = BusRouteRuleSchema.omit({ id: true });
+var BusCommandRequestSchema = import_zod.z.object({
+  commandId: import_zod.z.string().startsWith("cmd_").optional(),
+  commandType: import_zod.z.literal("ACTION_EXECUTE").default("ACTION_EXECUTE"),
+  targetService: import_zod.z.string().min(1).max(80),
+  actionName: import_zod.z.string().min(1).max(128),
+  sourceEventId: import_zod.z.string().startsWith("bev_").optional(),
+  payload: AnyJson.default({}).optional(),
+  metadata: import_zod.z.object({
+    routingRuleId: import_zod.z.string().startsWith("brt_").optional(),
+    correlationId: import_zod.z.string().min(1).max(160).optional()
+  }).catchall(import_zod.z.any()).optional()
+});
+var busCommandRequestSchema = BusCommandRequestSchema;
+var BusRoutingRuleSchema = BusRouteRuleSchema;
+var busRoutingRuleSchema = BusRoutingRuleSchema;
+var BusRoutedCommandSchema = import_zod.z.object({
+  routeId: import_zod.z.string().startsWith("brt_"),
+  commandId: import_zod.z.string().startsWith("cmd_").optional(),
+  dryRun: import_zod.z.boolean(),
+  targetServiceCode: import_zod.z.string(),
+  actionName: import_zod.z.string(),
+  status: import_zod.z.enum(["CREATED", "DRY_RUN", "SKIPPED", "FAILED"]),
+  errorCode: import_zod.z.string().optional(),
+  errorMessage: import_zod.z.string().optional()
+});
+var PublishBusEventResponseSchema = import_zod.z.object({
+  eventId: import_zod.z.string().startsWith("bev_"),
+  experimental: CapsuleBusExperimentalSchema,
+  routedCommands: import_zod.z.array(BusRoutedCommandSchema)
+});
+var BusEventRecordSchema = BusEventEnvelopeSchema.extend({
+  id: import_zod.z.string().startsWith("bev_"),
+  agentId: import_zod.z.string().startsWith("agt_"),
+  acceptedAt: import_zod.z.string(),
+  routeCount: import_zod.z.number().int()
+});
+var BusErrorCode = {
+  CAPSULE_BUS_DISABLED: "CAPSULE_BUS_DISABLED",
+  BUS_RATE_LIMITED: "BUS_RATE_LIMITED",
+  BUS_DEPTH_EXCEEDED: "BUS_DEPTH_EXCEEDED"
+};
+var publishBusEventRequestSchema = PublishBusEventRequestSchema;
+var publishBusEventResponseSchema = PublishBusEventResponseSchema;
+var busEventEnvelopeSchema = BusEventEnvelopeSchema;
+var busRouteRuleSchema = BusRouteRuleSchema;
+var createBusRouteRuleRequestSchema = CreateBusRouteRuleRequestSchema;
 var CreateActionCommandRequestSchema = import_zod.z.object({ payload: AnyJson.optional(), confirmation: import_zod.z.boolean().optional() });
 var createActionCommandRequestSchema = CreateActionCommandRequestSchema;
 var CommandTypeSchema = import_zod.z.enum(["ACTION_PREPARE", "ACTION_EXECUTE"]);
@@ -203,6 +318,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"
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ActionDefinitionInputSchema,
@@ -212,6 +342,8 @@ function paginate(items, page, pageSize, total) {
   AdminSessionSchema,
   AgentHeartbeatRequestSchema,
   AgentHeartbeatResponseSchema,
+  AgentMode,
+  AgentModeSchema,
   AgentSchema,
   AgentStatus,
   AgentStatusSchema,
@@ -219,6 +351,16 @@ function paginate(items, page, pageSize, total) {
   AuditActorType,
   AuditEventSchema,
   AuditResult,
+  BusCommandRequestSchema,
+  BusErrorCode,
+  BusEventEnvelopeSchema,
+  BusEventRecordSchema,
+  BusRouteRuleSchema,
+  BusRouteStatus,
+  BusRouteStatusSchema,
+  BusRoutedCommandSchema,
+  BusRoutingRuleSchema,
+  CapsuleBusExperimentalSchema,
   CapsuleManifestSchema,
   CapsuleServiceDetailSchema,
   CapsuleServiceSchema,
@@ -233,24 +375,31 @@ function paginate(items, page, pageSize, total) {
   ConfigItemInputSchema,
   ConfigItemSchema,
   CreateActionCommandRequestSchema,
+  CreateBusRouteRuleRequestSchema,
   CreateRegistrationTokenRequestSchema,
   CreateRegistrationTokenResponseSchema,
   DangerLevel,
   DangerLevelSchema,
   DashboardSummarySchema,
   ErrorCode,
+  EventMetadataSchema,
   HealthReportInputSchema,
   HealthReportSchema,
   HealthStatus,
   HealthStatusSchema,
   HttpError,
   ListQueryBase,
+  PublishBusEventRequestSchema,
+  PublishBusEventResponseSchema,
   RegisterAgentRequestSchema,
   RegisterAgentResponseSchema,
   RegistrationTokenSchema,
   ReportCommandResultRequestSchema,
   ReportedServiceSchema,
   RuntimeKindSchema,
+  ServiceCapabilitySchema,
+  ServiceKind,
+  ServiceKindSchema,
   ServiceReportRequestSchema,
   SystemHealthSchema,
   SystemVersionSchema,
@@ -261,17 +410,26 @@ function paginate(items, page, pageSize, total) {
   actionPrepareResultSchema,
   adminLoginRequestSchema,
   agentHeartbeatRequestSchema,
+  busCommandRequestSchema,
+  busEventEnvelopeSchema,
+  busRouteRuleSchema,
+  busRoutingRuleSchema,
   configItemInputSchema,
   createActionCommandRequestSchema,
+  createBusRouteRuleRequestSchema,
   createRegistrationTokenRequestSchema,
   createUserRequestSchema,
+  eventMetadataSchema,
   healthReportInputSchema,
   paginate,
   parseSort,
+  publishBusEventRequestSchema,
+  publishBusEventResponseSchema,
   registerAgentRequestSchema,
   reportCommandResultRequestSchema,
   reportedServiceSchema,
   resetUserPasswordRequestSchema,
+  serviceCapabilitySchema,
   serviceReportRequestSchema,
   updateUserRequestSchema,
   z