@zhivex-ai/agents 1.0.2 → 1.2.0

package/README.md

@@ -40,17 +40,18 @@ console.log(result.state);
 
 ## Entry Points
 
-The package uses explicit entry points so production applications do not accidentally couple themselves to beta or experimental APIs:
+The package uses explicit entry points so production applications can keep operational, control-plane, realtime, beta, and testing dependencies intentional:
 
 | Import | Stability | Purpose |
 | --- | --- | --- |
 | `@zhivex-ai/agents` | Stable | Agent execution, tools, HITL, safety, streaming, handoffs, and subagents |
 | `@zhivex-ai/agents/ops` | Stable | Stores, memory, tracing, evaluation, replay, costs, and provider-support reports |
-| `@zhivex-ai/agents/beta` | Beta | Control plane, capsules, approval queues, ledgers, governance, and capability routing |
-| `@zhivex-ai/agents/realtime` | Experimental | Live/realtime agent streaming |
+| `@zhivex-ai/agents/control-plane` | Stable | Capsules, approval queues, ledgers, governance policy, durable approval resume, and capability routing |
+| `@zhivex-ai/agents/beta` | Mixed compatibility | Stable control-plane alias plus remaining Beta harness, audit, and hosted-tool helpers |
+| `@zhivex-ai/agents/realtime` | Stable | Live/realtime agent streaming |
 | `@zhivex-ai/agents/testing` | Stable | Deterministic model and tool test doubles |
 
-Beta APIs may change between minor releases. Experimental APIs may change more frequently and should be isolated behind an application-owned adapter.
+Beta APIs may change between minor releases. Provider-specific realtime options and upstream preview model availability are not promoted by the stable shared realtime contract.
 
 ## What This Package Covers
 
@@ -143,7 +144,7 @@ If a subagent pauses for approval, the parent exposes a `kind: "subagent"` reque
 Use `createAgentApprovalQueue()` when the application needs queue items with approval tokens and resume URLs.
 
 ```ts
-import { createAgentApprovalQueue } from "@zhivex-ai/agents/beta";
+import { createAgentApprovalQueue } from "@zhivex-ai/agents/control-plane";
 ```
 
 ## Production State
@@ -188,7 +189,7 @@ Capsules created through `createAgentCapsule()` bind a canonical harness fingerp
 Use provider support helpers before routing important agent workloads:
 
 ```ts
-import { createAgentCapabilityRouter } from "@zhivex-ai/agents/beta";
+import { createAgentCapabilityRouter } from "@zhivex-ai/agents/control-plane";
 
 const router = createAgentCapabilityRouter([openai("gpt-5"), anthropic("claude-sonnet-5")]);
 const selected = router.select({
@@ -202,7 +203,7 @@ Tier A means native agent building blocks such as approval-capable remote MCP or
 
 ## Realtime And Testing
 
-Keep experimental realtime use explicit:
+Keep realtime dependencies explicit through the dedicated stable entry point:
 
 ```ts
 import { streamLiveAgent } from "@zhivex-ai/agents/realtime";
@@ -229,7 +230,7 @@ import {
 
 // After
 import { createInMemoryAgentRunStore } from "@zhivex-ai/agents/ops";
-import { createAgentControlPlane } from "@zhivex-ai/agents/beta";
+import { createAgentControlPlane } from "@zhivex-ai/agents/control-plane";
 import { streamLiveAgent } from "@zhivex-ai/agents/realtime";
 import { createMockLanguageModel } from "@zhivex-ai/agents/testing";
 ```

package/dist/beta.d.ts

@@ -1,8 +1,10 @@
 /**
- * Beta control-plane and governance APIs.
+ * Compatibility alias for the stable control-plane entry point plus the
+ * remaining beta governance helpers.
  *
- * These exports may change between minor releases until promoted to stable.
+ * @deprecated Import stable control-plane contracts from "./control-plane".
  */
-export { AGENT_CONTROL_PLANE_SCHEMA_VERSION, PRODUCTION_AGENT_KIT_SCHEMA_VERSION, createAgentExecutionEnvironmentBinding, createAgentHarnessBinding, createAgentApprovalQueue, createAgentAuditRecord, createAgentCapabilityRouter, createAgentCapsule, createAgentControlPlane, createAgentControlPlaneRunRecord, createAgentRunLedger, createAgentToolPolicy, createReadOnlyToolApprovalPolicy, createSensitiveDataPolicy, createToolAuditRecords, diffAgentRunLedgers, fingerprintAgentHarness, getAgentCapabilities, getAgentSupportTier, getHostedToolClass, inspectAgentCapsule, inspectAgentControlPlane, promoteAgentGoldenTrace, selectAgentModel } from "@zhivex-ai/core";
-export type { AgentApprovalQueueItem, AgentApprovalQueueOptions, AgentAuditRecord, AgentAuditRecordOptions, AgentCapabilityRequirements, AgentCapabilityRouter, AgentCapsule, AgentCapsuleEvaluationManifest, AgentCapsuleInspection, AgentCapsuleManifest, AgentCapsuleMcpServerManifest, AgentCapsulePolicyManifest, AgentCapsuleSkillManifest, AgentCapsuleToolManifest, AgentControlPlane, AgentControlPlaneInspection, AgentControlPlaneOptions, AgentControlPlaneRunInput, AgentControlPlaneRunRecord, AgentGoldenTrace, AgentModelCandidate, AgentModelSelection, AgentRunLedger, AgentRunLedgerDiff, AgentRunLedgerDiffChange, AgentRunLedgerOptions, AgentToolPermission, AgentToolPolicyMode, AgentToolPolicyOptions, AgentToolRiskLevel, CreateAgentCapsuleOptions, ReadOnlyToolApprovalPolicyOptions, SensitiveDataPolicyOptions, ToolAuditRecord, ToolAuditRecordOptions } from "@zhivex-ai/core";
+export * from "./control-plane.js";
+export { PRODUCTION_AGENT_KIT_SCHEMA_VERSION, createAgentExecutionEnvironmentBinding, createAgentHarnessBinding, createAgentAuditRecord, createReadOnlyToolApprovalPolicy, createSensitiveDataPolicy, createToolAuditRecords, fingerprintAgentHarness, getAgentCapabilities, getAgentSupportTier, getHostedToolClass } from "@zhivex-ai/core";
+export type { AgentAuditRecord, AgentAuditRecordOptions, ReadOnlyToolApprovalPolicyOptions, SensitiveDataPolicyOptions, ToolAuditRecord, ToolAuditRecordOptions } from "@zhivex-ai/core";
 //# sourceMappingURL=beta.d.ts.map

package/dist/beta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"beta.d.ts","sourceRoot":"","sources":["../src/beta.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,kCAAkC,EAClC,mCAAmC,EACnC,sCAAsC,EACtC,yBAAyB,EACzB,wBAAwB,EACxB,sBAAsB,EACtB,2BAA2B,EAC3B,kBAAkB,EAClB,uBAAuB,EACvB,gCAAgC,EAChC,oBAAoB,EACpB,qBAAqB,EACrB,gCAAgC,EAChC,yBAAyB,EACzB,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACvB,gBAAgB,EACjB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,sBAAsB,EACtB,yBAAyB,EACzB,gBAAgB,EAChB,uBAAuB,EACvB,2BAA2B,EAC3B,qBAAqB,EACrB,YAAY,EACZ,8BAA8B,EAC9B,sBAAsB,EACtB,oBAAoB,EACpB,6BAA6B,EAC7B,0BAA0B,EAC1B,yBAAyB,EACzB,wBAAwB,EACxB,iBAAiB,EACjB,2BAA2B,EAC3B,wBAAwB,EACxB,yBAAyB,EACzB,0BAA0B,EAC1B,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,yBAAyB,EACzB,iCAAiC,EACjC,0BAA0B,EAC1B,eAAe,EACf,sBAAsB,EACvB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"beta.d.ts","sourceRoot":"","sources":["../src/beta.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,oBAAoB,CAAC;AAEnC,OAAO,EACL,mCAAmC,EACnC,sCAAsC,EACtC,yBAAyB,EACzB,sBAAsB,EACtB,gCAAgC,EAChC,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,gBAAgB,EAChB,uBAAuB,EACvB,iCAAiC,EACjC,0BAA0B,EAC1B,eAAe,EACf,sBAAsB,EACvB,MAAM,iBAAiB,CAAC"}

package/dist/beta.js

@@ -1,7 +1,9 @@
 /**
- * Beta control-plane and governance APIs.
+ * Compatibility alias for the stable control-plane entry point plus the
+ * remaining beta governance helpers.
  *
- * These exports may change between minor releases until promoted to stable.
+ * @deprecated Import stable control-plane contracts from "./control-plane".
  */
-export { AGENT_CONTROL_PLANE_SCHEMA_VERSION, PRODUCTION_AGENT_KIT_SCHEMA_VERSION, createAgentExecutionEnvironmentBinding, createAgentHarnessBinding, createAgentApprovalQueue, createAgentAuditRecord, createAgentCapabilityRouter, createAgentCapsule, createAgentControlPlane, createAgentControlPlaneRunRecord, createAgentRunLedger, createAgentToolPolicy, createReadOnlyToolApprovalPolicy, createSensitiveDataPolicy, createToolAuditRecords, diffAgentRunLedgers, fingerprintAgentHarness, getAgentCapabilities, getAgentSupportTier, getHostedToolClass, inspectAgentCapsule, inspectAgentControlPlane, promoteAgentGoldenTrace, selectAgentModel } from "@zhivex-ai/core";
+export * from "./control-plane.js";
+export { PRODUCTION_AGENT_KIT_SCHEMA_VERSION, createAgentExecutionEnvironmentBinding, createAgentHarnessBinding, createAgentAuditRecord, createReadOnlyToolApprovalPolicy, createSensitiveDataPolicy, createToolAuditRecords, fingerprintAgentHarness, getAgentCapabilities, getAgentSupportTier, getHostedToolClass } from "@zhivex-ai/core";
 //# sourceMappingURL=beta.js.map

package/dist/beta.js.map

@@ -1 +1 @@
-{"version":3,"file":"beta.js","sourceRoot":"","sources":["../src/beta.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,kCAAkC,EAClC,mCAAmC,EACnC,sCAAsC,EACtC,yBAAyB,EACzB,wBAAwB,EACxB,sBAAsB,EACtB,2BAA2B,EAC3B,kBAAkB,EAClB,uBAAuB,EACvB,gCAAgC,EAChC,oBAAoB,EACpB,qBAAqB,EACrB,gCAAgC,EAChC,yBAAyB,EACzB,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACvB,gBAAgB,EACjB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"beta.js","sourceRoot":"","sources":["../src/beta.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,oBAAoB,CAAC;AAEnC,OAAO,EACL,mCAAmC,EACnC,sCAAsC,EACtC,yBAAyB,EACzB,sBAAsB,EACtB,gCAAgC,EAChC,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,iBAAiB,CAAC"}

package/dist/control-plane.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Stable agent control-plane contracts.
+ *
+ * This entry point intentionally excludes provider-hosted tool registries and
+ * other provider-native surfaces whose upstream contracts can still change.
+ */
+export { AGENT_CONTROL_PLANE_SCHEMA_VERSION, createAgentApprovalQueue, createAgentCapabilityRouter, createAgentCapsule, createAgentControlPlane, createAgentControlPlaneRunRecord, createAgentRunLedger, createAgentToolPolicy, diffAgentRunLedgers, inspectAgentCapsule, inspectAgentControlPlane, migrateAgentApprovalQueueItem, migrateAgentCapsuleManifest, migrateAgentRunLedger, normalizeAgentApprovalQueueItem, normalizeAgentCapsuleManifest, normalizeAgentRunLedger, promoteAgentGoldenTrace, selectAgentModel } from "@zhivex-ai/core";
+export type { AgentApprovalQueueItem, AgentApprovalQueueOptions, AgentCapabilityRequirements, AgentCapabilityRouter, AgentCapsule, AgentCapsuleEvaluationManifest, AgentCapsuleInspection, AgentCapsuleManifest, AgentCapsuleMcpServerManifest, AgentCapsulePolicyManifest, AgentCapsuleSkillManifest, AgentCapsuleToolManifest, AgentControlPlane, AgentControlPlaneApprovalResumeInput, AgentControlPlaneInspection, AgentControlPlaneMigrationTarget, AgentControlPlaneOptions, AgentControlPlaneRunInput, AgentControlPlaneRunRecord, AgentGoldenTrace, AgentModelCandidate, AgentModelSelection, AgentRunLedger, AgentRunLedgerDiff, AgentRunLedgerDiffChange, AgentRunLedgerOptions, AgentToolPermission, AgentToolPolicyMode, AgentToolPolicyOptions, AgentToolRiskLevel, CreateAgentCapsuleOptions } from "@zhivex-ai/core";
+//# sourceMappingURL=control-plane.d.ts.map

package/dist/control-plane.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-plane.d.ts","sourceRoot":"","sources":["../src/control-plane.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,kCAAkC,EAClC,wBAAwB,EACxB,2BAA2B,EAC3B,kBAAkB,EAClB,uBAAuB,EACvB,gCAAgC,EAChC,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,EACxB,6BAA6B,EAC7B,2BAA2B,EAC3B,qBAAqB,EACrB,+BAA+B,EAC/B,6BAA6B,EAC7B,uBAAuB,EACvB,uBAAuB,EACvB,gBAAgB,EACjB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,sBAAsB,EACtB,yBAAyB,EACzB,2BAA2B,EAC3B,qBAAqB,EACrB,YAAY,EACZ,8BAA8B,EAC9B,sBAAsB,EACtB,oBAAoB,EACpB,6BAA6B,EAC7B,0BAA0B,EAC1B,yBAAyB,EACzB,wBAAwB,EACxB,iBAAiB,EACjB,oCAAoC,EACpC,2BAA2B,EAC3B,gCAAgC,EAChC,wBAAwB,EACxB,yBAAyB,EACzB,0BAA0B,EAC1B,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,yBAAyB,EAC1B,MAAM,iBAAiB,CAAC"}

package/dist/control-plane.js

@@ -0,0 +1,8 @@
+/**
+ * Stable agent control-plane contracts.
+ *
+ * This entry point intentionally excludes provider-hosted tool registries and
+ * other provider-native surfaces whose upstream contracts can still change.
+ */
+export { AGENT_CONTROL_PLANE_SCHEMA_VERSION, createAgentApprovalQueue, createAgentCapabilityRouter, createAgentCapsule, createAgentControlPlane, createAgentControlPlaneRunRecord, createAgentRunLedger, createAgentToolPolicy, diffAgentRunLedgers, inspectAgentCapsule, inspectAgentControlPlane, migrateAgentApprovalQueueItem, migrateAgentCapsuleManifest, migrateAgentRunLedger, normalizeAgentApprovalQueueItem, normalizeAgentCapsuleManifest, normalizeAgentRunLedger, promoteAgentGoldenTrace, selectAgentModel } from "@zhivex-ai/core";
+//# sourceMappingURL=control-plane.js.map

package/dist/control-plane.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-plane.js","sourceRoot":"","sources":["../src/control-plane.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,kCAAkC,EAClC,wBAAwB,EACxB,2BAA2B,EAC3B,kBAAkB,EAClB,uBAAuB,EACvB,gCAAgC,EAChC,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,EACxB,6BAA6B,EAC7B,2BAA2B,EAC3B,qBAAqB,EACrB,+BAA+B,EAC/B,6BAA6B,EAC7B,uBAAuB,EACvB,uBAAuB,EACvB,gBAAgB,EACjB,MAAM,iBAAiB,CAAC"}

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * Stable application-facing agent runtime.
  *
- * Operational helpers, beta control-plane APIs, experimental realtime APIs,
+ * Operational helpers and stable control-plane/realtime APIs,
  * and test doubles live in explicit package subpaths.
  */
 export { AGENT_RUN_STATE_SCHEMA_VERSION, Agent, agentApprovalResponsePart, applySafetyPolicyToAgent, cancelAgentRun, cancelAgentRunTree, createAgent, createAgentApprovalMessage, createAgentHandoff, createAgentHandoffMessage, createApprovalPolicy, createBudgetGuard, createProductionSafetyPolicy, createRedactionPolicy, createSafetyPolicy, createSubAgentTool, evaluateAgentBudgetPreflight, getAgentApprovalRequestFromPart, getAgentApprovalRequests, getAgentBudgetStatus, migrateAgentRunState, normalizeAgentRunState, prepareSubagentsForAgent, resumeAgent, runAgent, runAgentGroup, runAgentHandoff, streamAgent, toUIAgentStreamResponse, tool } from "@zhivex-ai/core";

package/dist/index.js

@@ -1,7 +1,7 @@
 /**
  * Stable application-facing agent runtime.
  *
- * Operational helpers, beta control-plane APIs, experimental realtime APIs,
+ * Operational helpers and stable control-plane/realtime APIs,
  * and test doubles live in explicit package subpaths.
  */
 export { AGENT_RUN_STATE_SCHEMA_VERSION, Agent, agentApprovalResponsePart, applySafetyPolicyToAgent, cancelAgentRun, cancelAgentRunTree, createAgent, createAgentApprovalMessage, createAgentHandoff, createAgentHandoffMessage, createApprovalPolicy, createBudgetGuard, createProductionSafetyPolicy, createRedactionPolicy, createSafetyPolicy, createSubAgentTool, evaluateAgentBudgetPreflight, getAgentApprovalRequestFromPart, getAgentApprovalRequests, getAgentBudgetStatus, migrateAgentRunState, normalizeAgentRunState, prepareSubagentsForAgent, resumeAgent, runAgent, runAgentGroup, runAgentHandoff, streamAgent, toUIAgentStreamResponse, tool } from "@zhivex-ai/core";

package/dist/realtime.d.ts

@@ -1,4 +1,4 @@
-/** Experimental live/realtime agent APIs. */
+/** Stable live/realtime agent APIs. */
 export { streamLiveAgent } from "@zhivex-ai/core";
 export type { AgentLiveEvent, AgentLiveStreamResult, LiveAgentDefinition, LiveAgentRunInput, LiveAgentRunOutput } from "@zhivex-ai/core";
 //# sourceMappingURL=realtime.d.ts.map

package/dist/realtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"realtime.d.ts","sourceRoot":"","sources":["../src/realtime.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,YAAY,EACV,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"realtime.d.ts","sourceRoot":"","sources":["../src/realtime.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,YAAY,EACV,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,iBAAiB,CAAC"}

package/dist/realtime.js

@@ -1,3 +1,3 @@
-/** Experimental live/realtime agent APIs. */
+/** Stable live/realtime agent APIs. */
 export { streamLiveAgent } from "@zhivex-ai/core";
 //# sourceMappingURL=realtime.js.map

package/dist/realtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"realtime.js","sourceRoot":"","sources":["../src/realtime.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"realtime.js","sourceRoot":"","sources":["../src/realtime.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhivex-ai/agents",
-  "version": "1.0.2",
+  "version": "1.2.0",
   "description": "Agent-first facade for the Zhivex AI SDK runtime.",
   "license": "MIT",
   "type": "module",
@@ -19,6 +19,10 @@
       "types": "./dist/ops.d.ts",
       "import": "./dist/ops.js"
     },
+    "./control-plane": {
+      "types": "./dist/control-plane.d.ts",
+      "import": "./dist/control-plane.js"
+    },
     "./beta": {
       "types": "./dist/beta.d.ts",
       "import": "./dist/beta.js"
@@ -57,6 +61,6 @@
     "access": "public"
   },
   "dependencies": {
-    "@zhivex-ai/core": "^1.1.2"
+    "@zhivex-ai/core": "^1.5.0"
   }
 }