@zhivex-ai/agents 1.0.0 → 1.0.2

package/README.md

@@ -61,6 +61,7 @@ Beta APIs may change between minor releases. Experimental APIs may change more f
 - Durable harnesses: capsule fingerprints, app-provided execution-environment enforcement, and replay-visible context compaction.
 - Memory and stores from `/ops`: in-memory, file, SQLite, and Postgres run stores and memory stores.
 - Multi-agent patterns: handoffs, subagents as tools, parallel agent groups, and hierarchical traces.
+- Durable subagents: stores with atomic idempotency claims reuse a completed child after a failed parent checkpoint instead of repeating child tools.
 - Production safety: stable safety policies and budget guards in the root; beta governance policies and audit records under `/beta`.
 - Observability and evaluation from `/ops`: trace collectors, run snapshots, replay, cost estimates, and evaluation fixtures.
 - Provider inspection from `/ops`, with beta capability routing and model selection under `/beta`.
@@ -172,8 +173,12 @@ Run stores claim an `idempotencyKey` before model or tool execution and persist
 
 SQLite and Postgres support renewable worker leases, expired-run recovery, model/tool checkpoints, paginated run queries, retention cleanup, and a durable tool journal. The journal reuses completed results and refuses to repeat an indeterminate effect. Forward `context.idempotencyKey` and `context.abortSignal` from every side-effecting tool to the external API. The file store is a local-development backend with best-effort cross-process coordination.
 
+Store keys are canonical opaque digests of the full identity tuple, so delimiter-containing tenant, user, session, workflow, artifact, run, and memory identifiers remain isolated. File stores create new directories and files with private permissions (`0700`/`0600`). Matching legacy delimiter-based records remain readable and are removed after a successful migrated write.
+
 Active workers observe durable cancellation and abort in-flight provider/tool work. Streams and persisted state are bounded: stream overflow is explicit, step request snapshots are incremental, and `policy.maxStateBytes` defaults to 4 MiB. Telemetry and memory failures are isolated by default and can be reported through `hookFailurePolicy.onError`.
 
+Read-only governance is fail-closed: a tool must declare a non-empty explicit permission set that contains only `read`; missing permission metadata requires review. Production trace collectors retain bounded runs/events and expire old entries. Ledgers redact snapshot, timeline, audit, trace, metadata, and output payloads by default; enable each sensitive family only for an approved server-side destination.
+
 New states use `AGENT_RUN_STATE_SCHEMA_VERSION`. `normalizeAgentRunState()` accepts legacy states without a version or revision, while rejecting unknown future schema versions; `migrateAgentRunState()` is the explicit application-boundary helper.
 
 Capsules created through `createAgentCapsule()` bind a canonical harness fingerprint to the run. Agents may also define `executionEnvironment` to acquire and authorize an app-owned boundary, plus `compaction` to replace an old context prefix with a durable summary before a provider request. The environment adapter is responsible for real isolation; this package does not provide a managed sandbox.

package/dist/ops.d.ts

@@ -3,5 +3,5 @@
  * cost accounting, and provider-support inspection.
  */
 export { createAgentEvaluationFixture, createAgentEvaluationReport, createAgentRunSnapshot, createAgentRunTreeSnapshot, createAgentTraceArtifact, createAgentTraceCollector, createFileAgentMemoryStore, createFileAgentRunStore, createHierarchicalAgentTrace, createInMemoryAgentMemoryStore, createInMemoryAgentRunStore, createPostgresAgentMemoryStore, createPostgresAgentRunStore, createProductionTraceCollector, createProductionTraceOptions, createProviderSupportDriftReport, createProviderSupportMatrix, createSqliteAgentMemoryStore, createSqliteAgentRunStore, estimateAgentRunCost, estimateTokenCost, inspectProviderAgentSupport, judgeAgentEvaluation, renderProviderSupportMatrix, replayAgentRun, runAgentEvaluation, runAgentEvaluationFixture, summarizeAgentTrace } from "@zhivex-ai/core";
-export type { AgentCapabilities, AgentEvaluationCase, AgentEvaluationCaseResult, AgentEvaluationExpectations, AgentEvaluationFixture, AgentEvaluationJudge, AgentEvaluationJudgeResult, AgentEvaluationReport, AgentEvaluationReportCase, AgentEvaluationResult, AgentMemoryContext, AgentMemoryStore, AgentReplayResult, AgentReplayTimelineEvent, AgentRunCostPricing, AgentRunClaimResult, AgentRunLease, AgentRunLeaseOptions, AgentRunListOptions, AgentRunPage, AgentRunRetentionOptions, AgentRunSaveOptions, AgentRunSnapshot, AgentRunStore, AgentRunStoreScopeOptions, AgentRunTreeCancellationResult, AgentRunTreeNode, AgentRunTreeSnapshot, AgentSupportTier, AgentStoreScope, AgentTelemetryApprovalRequestEvent, AgentTelemetryApprovalResolvedEvent, AgentTelemetryEvent, AgentTelemetryGuardrailTriggeredEvent, AgentTelemetryHandoffEvent, AgentTelemetryMemoryLoadedEvent, AgentTelemetryObserver, AgentTelemetryRunFinishEvent, AgentTelemetryRunStartEvent, AgentTelemetryStateSavedEvent, AgentTelemetryStepFinishEvent, AgentTelemetryStepStartEvent, AgentTelemetrySubAgentFinishEvent, AgentTelemetrySubAgentStartEvent, AgentTelemetryToolApprovalEvent, AgentTraceApproval, AgentTraceArtifact, AgentTraceCollector, AgentTraceEvent, AgentTraceOptions, AgentTraceStep, AgentTraceSummary, AgentTraceToolCall, AgentToolCallJournalEntry, AgentToolCallJournalSaveOptions, AgentToolCallJournalStatus, AgentToolExecutionClaimResult, CostEstimate, HierarchicalAgentTrace, HierarchicalAgentTraceNode, LatencySummary, PostgresAgentMemoryStoreOptions, PostgresAgentRunStoreOptions, ProviderAgentSupport, ProviderSupportDrift, ProviderSupportDriftExpectedEntry, ProviderSupportDriftExpectedMatrix, ProviderSupportDriftReport, ProviderSupportMatrix, ProviderSupportMatrixEntry, ProviderSupportMatrixFormat, RunAgentEvaluationOptions, SqliteAgentMemoryStoreOptions, SqliteAgentRunStoreOptions, TokenPricing } from "@zhivex-ai/core";
+export type { AgentCapabilities, AgentEvaluationCase, AgentEvaluationCaseResult, AgentEvaluationExpectations, AgentEvaluationFixture, AgentEvaluationJudge, AgentEvaluationJudgeResult, AgentEvaluationReport, AgentEvaluationReportCase, AgentEvaluationResult, AgentMemoryContext, AgentMemoryStore, AgentReplayResult, AgentReplayTimelineEvent, AgentRunCostPricing, AgentRunClaimResult, AgentRunLease, AgentRunLeaseOptions, AgentRunListOptions, AgentRunPage, AgentRunRetentionOptions, AgentRunSaveOptions, AgentRunSnapshot, AgentRunStore, AgentRunStoreScopeOptions, AgentRunTreeCancellationResult, AgentRunTreeNode, AgentRunTreeSnapshot, AgentSupportTier, AgentStoreScope, AgentTelemetryApprovalRequestEvent, AgentTelemetryApprovalResolvedEvent, AgentTelemetryEvent, AgentTelemetryGuardrailTriggeredEvent, AgentTelemetryHandoffEvent, AgentTelemetryMemoryLoadedEvent, AgentTelemetryObserver, AgentTelemetryRunFinishEvent, AgentTelemetryRunStartEvent, AgentTelemetryStateSavedEvent, AgentTelemetryStepFinishEvent, AgentTelemetryStepStartEvent, AgentTelemetrySubAgentFinishEvent, AgentTelemetrySubAgentStartEvent, AgentTelemetryToolApprovalEvent, AgentTraceApproval, AgentTraceArtifact, AgentTraceCollector, AgentTraceCollectorOptions, AgentTraceEvent, AgentTraceOptions, AgentTraceStep, AgentTraceSummary, AgentTraceToolCall, AgentToolCallJournalEntry, AgentToolCallJournalSaveOptions, AgentToolCallJournalStatus, AgentToolExecutionClaimResult, CostEstimate, HierarchicalAgentTrace, HierarchicalAgentTraceNode, LatencySummary, PostgresAgentMemoryStoreOptions, PostgresAgentRunStoreOptions, ProviderAgentSupport, ProviderSupportDrift, ProviderSupportDriftExpectedEntry, ProviderSupportDriftExpectedMatrix, ProviderSupportDriftReport, ProviderSupportMatrix, ProviderSupportMatrixEntry, ProviderSupportMatrixFormat, RunAgentEvaluationOptions, SqliteAgentMemoryStoreOptions, SqliteAgentRunStoreOptions, TokenPricing } from "@zhivex-ai/core";
 //# sourceMappingURL=ops.d.ts.map

package/dist/ops.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhivex-ai/agents",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Agent-first facade for the Zhivex AI SDK runtime.",
   "license": "MIT",
   "type": "module",
@@ -57,6 +57,6 @@
     "access": "public"
   },
   "dependencies": {
-    "@zhivex-ai/core": "^1.0.0"
+    "@zhivex-ai/core": "^1.1.2"
   }
 }