@zhivex-ai/agents 0.7.2 → 0.8.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +77 -8
- package/dist/beta.d.ts +8 -0
- package/dist/beta.d.ts.map +1 -0
- package/dist/beta.js +7 -0
- package/dist/beta.js.map +1 -0
- package/dist/index.d.ts +8 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +7 -1
- package/dist/index.js.map +1 -1
- package/dist/ops.d.ts +7 -0
- package/dist/ops.d.ts.map +1 -0
- package/dist/ops.js +6 -0
- package/dist/ops.js.map +1 -0
- package/dist/realtime.d.ts +4 -0
- package/dist/realtime.d.ts.map +1 -0
- package/dist/realtime.js +3 -0
- package/dist/realtime.js.map +1 -0
- package/dist/testing.d.ts +4 -0
- package/dist/testing.d.ts.map +1 -0
- package/dist/testing.js +3 -0
- package/dist/testing.js.map +1 -0
- package/package.json +18 -2
package/README.md
CHANGED
|
@@ -38,17 +38,31 @@ console.log(result.state);
|
|
|
38
38
|
|
|
39
39
|
`Agent` is a stable ergonomic facade over the same core runtime used by `createAgent()` and `runAgent()`. Use `agent.toDefinition()` when a plain object definition is needed by lower-level helpers.
|
|
40
40
|
|
|
41
|
+
## Entry Points
|
|
42
|
+
|
|
43
|
+
The package uses explicit entry points so production applications do not accidentally couple themselves to beta or experimental APIs:
|
|
44
|
+
|
|
45
|
+
| Import | Stability | Purpose |
|
|
46
|
+
| --- | --- | --- |
|
|
47
|
+
| `@zhivex-ai/agents` | Stable | Agent execution, tools, HITL, safety, streaming, handoffs, and subagents |
|
|
48
|
+
| `@zhivex-ai/agents/ops` | Stable | Stores, memory, tracing, evaluation, replay, costs, and provider-support reports |
|
|
49
|
+
| `@zhivex-ai/agents/beta` | Beta | Control plane, capsules, approval queues, ledgers, governance, and capability routing |
|
|
50
|
+
| `@zhivex-ai/agents/realtime` | Experimental | Live/realtime agent streaming |
|
|
51
|
+
| `@zhivex-ai/agents/testing` | Stable | Deterministic model and tool test doubles |
|
|
52
|
+
|
|
53
|
+
Beta APIs may change between minor releases. Experimental APIs may change more frequently and should be isolated behind an application-owned adapter.
|
|
54
|
+
|
|
41
55
|
## What This Package Covers
|
|
42
56
|
|
|
43
57
|
- Stable agent runtime: `Agent`, `createAgent()`, `runAgent()`, `resumeAgent()`, and `streamAgent()`.
|
|
44
58
|
- Tool loops: local callable tools, tool-choice support, tool execution options, and approval policies.
|
|
45
59
|
- Human-in-the-loop: provider approval requests, approval response parts/messages, approval queues, and resumable states.
|
|
46
|
-
- Memory and stores
|
|
60
|
+
- Memory and stores from `/ops`: in-memory, file, SQLite, and Postgres run stores and memory stores.
|
|
47
61
|
- Multi-agent patterns: handoffs, subagents as tools, parallel agent groups, and hierarchical traces.
|
|
48
|
-
- Production safety: safety policies
|
|
49
|
-
- Observability and evaluation
|
|
50
|
-
- Provider
|
|
51
|
-
- Beta control plane
|
|
62
|
+
- Production safety: stable safety policies and budget guards in the root; beta governance policies and audit records under `/beta`.
|
|
63
|
+
- Observability and evaluation from `/ops`: trace collectors, run snapshots, replay, cost estimates, and evaluation fixtures.
|
|
64
|
+
- Provider inspection from `/ops`, with beta capability routing and model selection under `/beta`.
|
|
65
|
+
- Beta control plane from `/beta`: capsules, tool policies, approval queue items, ledgers, golden traces, and inspectable run records.
|
|
52
66
|
|
|
53
67
|
## Tools
|
|
54
68
|
|
|
@@ -119,28 +133,47 @@ if (waiting.status === "waiting_approval") {
|
|
|
119
133
|
|
|
120
134
|
Use `createAgentApprovalQueue()` when the application needs queue items with approval tokens and resume URLs.
|
|
121
135
|
|
|
136
|
+
```ts
|
|
137
|
+
import { createAgentApprovalQueue } from "@zhivex-ai/agents/beta";
|
|
138
|
+
```
|
|
139
|
+
|
|
122
140
|
## Production State
|
|
123
141
|
|
|
124
142
|
Use in-memory stores for tests, file stores for local development, and SQL stores for production runtimes that must survive process restarts:
|
|
125
143
|
|
|
126
144
|
```ts
|
|
127
|
-
import { Agent
|
|
145
|
+
import { Agent } from "@zhivex-ai/agents";
|
|
146
|
+
import { createPostgresAgentMemoryStore, createPostgresAgentRunStore } from "@zhivex-ai/agents/ops";
|
|
128
147
|
|
|
129
148
|
const agent = new Agent({
|
|
130
149
|
model,
|
|
131
150
|
store: createPostgresAgentRunStore({ client: postgresClient }),
|
|
132
151
|
memory: createPostgresAgentMemoryStore({ client: postgresClient })
|
|
133
152
|
});
|
|
153
|
+
|
|
154
|
+
const result = await agent.run({
|
|
155
|
+
prompt: "Process the request once.",
|
|
156
|
+
scope: { tenantId: "acme", userId: "user-7" },
|
|
157
|
+
idempotencyKey: "request-42"
|
|
158
|
+
});
|
|
134
159
|
```
|
|
135
160
|
|
|
136
161
|
For app-facing multi-turn sessions, use `createRunner()` from `@zhivex-ai/sdk`; `@zhivex-ai/agents` intentionally stays focused on the agent runtime facade.
|
|
137
162
|
|
|
163
|
+
Run stores claim an `idempotencyKey` before model or tool execution and persist every transition with a monotonic revision. Concurrent duplicates share the same run, while a stale resume or cancellation raises `ConflictError`. `scope` is the tenant/user isolation boundary and must accompany later lookup, resume, and cancellation operations.
|
|
164
|
+
|
|
165
|
+
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.
|
|
166
|
+
|
|
167
|
+
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`.
|
|
168
|
+
|
|
169
|
+
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.
|
|
170
|
+
|
|
138
171
|
## Provider Tiers
|
|
139
172
|
|
|
140
173
|
Use provider support helpers before routing important agent workloads:
|
|
141
174
|
|
|
142
175
|
```ts
|
|
143
|
-
import { createAgentCapabilityRouter } from "@zhivex-ai/agents";
|
|
176
|
+
import { createAgentCapabilityRouter } from "@zhivex-ai/agents/beta";
|
|
144
177
|
|
|
145
178
|
const router = createAgentCapabilityRouter([openai("gpt-5"), anthropic("claude-sonnet-5")]);
|
|
146
179
|
const selected = router.select({
|
|
@@ -152,8 +185,44 @@ const selected = router.select({
|
|
|
152
185
|
|
|
153
186
|
Tier A means native agent building blocks such as approval-capable remote MCP or equivalent hosted tools. Tier B is strong portable tool-loop support with provider-specific gaps. Tier C is useful for basic tool loops, but not full agent positioning.
|
|
154
187
|
|
|
188
|
+
## Realtime And Testing
|
|
189
|
+
|
|
190
|
+
Keep experimental realtime use explicit:
|
|
191
|
+
|
|
192
|
+
```ts
|
|
193
|
+
import { streamLiveAgent } from "@zhivex-ai/agents/realtime";
|
|
194
|
+
```
|
|
195
|
+
|
|
196
|
+
Tests can use deterministic doubles without adding them to the production root surface:
|
|
197
|
+
|
|
198
|
+
```ts
|
|
199
|
+
import { createMockLanguageModel, createMockTool } from "@zhivex-ai/agents/testing";
|
|
200
|
+
```
|
|
201
|
+
|
|
202
|
+
## Migrating Root Imports
|
|
203
|
+
|
|
204
|
+
Earlier versions exposed operations, control-plane helpers, realtime, and mocks from the package root. Move those imports to their owning entry point:
|
|
205
|
+
|
|
206
|
+
```ts
|
|
207
|
+
// Before
|
|
208
|
+
import {
|
|
209
|
+
createAgentControlPlane,
|
|
210
|
+
createInMemoryAgentRunStore,
|
|
211
|
+
createMockLanguageModel,
|
|
212
|
+
streamLiveAgent
|
|
213
|
+
} from "@zhivex-ai/agents";
|
|
214
|
+
|
|
215
|
+
// After
|
|
216
|
+
import { createInMemoryAgentRunStore } from "@zhivex-ai/agents/ops";
|
|
217
|
+
import { createAgentControlPlane } from "@zhivex-ai/agents/beta";
|
|
218
|
+
import { streamLiveAgent } from "@zhivex-ai/agents/realtime";
|
|
219
|
+
import { createMockLanguageModel } from "@zhivex-ai/agents/testing";
|
|
220
|
+
```
|
|
221
|
+
|
|
222
|
+
There is no runtime compatibility shim: unsupported root imports now fail during type checking or module loading instead of silently coupling stable code to a less-stable API.
|
|
223
|
+
|
|
155
224
|
## When To Use `@zhivex-ai/sdk`
|
|
156
225
|
|
|
157
226
|
Use `@zhivex-ai/sdk` when you also need the broader high-level API: `generateText()`, `generateObject()`, embeddings, media generation, artifacts, declarative workflows, `Runner + SessionService`, and the CLI.
|
|
158
227
|
|
|
159
|
-
Use `@zhivex-ai/agents` when you want
|
|
228
|
+
Use `@zhivex-ai/agents` when you want a narrow stable runtime, and opt into `/ops`, `/beta`, `/realtime`, or `/testing` only where the application needs those capabilities.
|
package/dist/beta.d.ts
ADDED
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Beta control-plane and governance APIs.
|
|
3
|
+
*
|
|
4
|
+
* These exports may change between minor releases until promoted to stable.
|
|
5
|
+
*/
|
|
6
|
+
export { AGENT_CONTROL_PLANE_SCHEMA_VERSION, PRODUCTION_AGENT_KIT_SCHEMA_VERSION, createAgentApprovalQueue, createAgentAuditRecord, createAgentCapabilityRouter, createAgentCapsule, createAgentControlPlane, createAgentControlPlaneRunRecord, createAgentRunLedger, createAgentToolPolicy, createReadOnlyToolApprovalPolicy, createSensitiveDataPolicy, createToolAuditRecords, diffAgentRunLedgers, getAgentCapabilities, getAgentSupportTier, getHostedToolClass, inspectAgentCapsule, inspectAgentControlPlane, promoteAgentGoldenTrace, selectAgentModel } from "@zhivex-ai/core";
|
|
7
|
+
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";
|
|
8
|
+
//# sourceMappingURL=beta.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"beta.d.ts","sourceRoot":"","sources":["../src/beta.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,kCAAkC,EAClC,mCAAmC,EACnC,wBAAwB,EACxB,sBAAsB,EACtB,2BAA2B,EAC3B,kBAAkB,EAClB,uBAAuB,EACvB,gCAAgC,EAChC,oBAAoB,EACpB,qBAAqB,EACrB,gCAAgC,EAChC,yBAAyB,EACzB,sBAAsB,EACtB,mBAAmB,EACnB,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"}
|
package/dist/beta.js
ADDED
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Beta control-plane and governance APIs.
|
|
3
|
+
*
|
|
4
|
+
* These exports may change between minor releases until promoted to stable.
|
|
5
|
+
*/
|
|
6
|
+
export { AGENT_CONTROL_PLANE_SCHEMA_VERSION, PRODUCTION_AGENT_KIT_SCHEMA_VERSION, createAgentApprovalQueue, createAgentAuditRecord, createAgentCapabilityRouter, createAgentCapsule, createAgentControlPlane, createAgentControlPlaneRunRecord, createAgentRunLedger, createAgentToolPolicy, createReadOnlyToolApprovalPolicy, createSensitiveDataPolicy, createToolAuditRecords, diffAgentRunLedgers, getAgentCapabilities, getAgentSupportTier, getHostedToolClass, inspectAgentCapsule, inspectAgentControlPlane, promoteAgentGoldenTrace, selectAgentModel } from "@zhivex-ai/core";
|
|
7
|
+
//# sourceMappingURL=beta.js.map
|
package/dist/beta.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"beta.js","sourceRoot":"","sources":["../src/beta.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,kCAAkC,EAClC,mCAAmC,EACnC,wBAAwB,EACxB,sBAAsB,EACtB,2BAA2B,EAC3B,kBAAkB,EAClB,uBAAuB,EACvB,gCAAgC,EAChC,oBAAoB,EACpB,qBAAqB,EACrB,gCAAgC,EAChC,yBAAyB,EACzB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACvB,gBAAgB,EACjB,MAAM,iBAAiB,CAAC"}
|
package/dist/index.d.ts
CHANGED
|
@@ -1,3 +1,9 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
1
|
+
/**
|
|
2
|
+
* Stable application-facing agent runtime.
|
|
3
|
+
*
|
|
4
|
+
* Operational helpers, beta control-plane APIs, experimental realtime APIs,
|
|
5
|
+
* and test doubles live in explicit package subpaths.
|
|
6
|
+
*/
|
|
7
|
+
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";
|
|
8
|
+
export type { AgentBudgetConsumption, AgentBudgetOperation, AgentBudgetPreflightOptions, AgentBudgetRemaining, AgentBudgetStatus, AgentApprovalRequest, AgentApprovalRequestEvent, AgentApprovalResolvedEvent, AgentApprovalResponse, AgentChildRun, AgentDefinition, AgentGroupMember, AgentGroupMemberResult, AgentGroupRunInput, AgentGroupRunOutput, AgentGuardrailTrigger, AgentHandoff, AgentHookFailureMode, AgentHookFailurePolicy, AgentInputGuardrail, AgentInputGuardrailRequest, AgentOutputGuardrail, AgentOutputGuardrailRequest, AgentOperationalError, AgentRunCancellationOptions, AgentRunFinishEvent, AgentRunInput, AgentRunOutput, AgentRunPolicy, AgentRunStartEvent, AgentRunState, AgentRunStateMigrationTarget, AgentStatus, AgentStep, AgentStepFinishEvent, AgentStepRequest, AgentStepResponse, AgentStepStartEvent, AgentStepStatus, AgentStreamEvent, AgentStreamResult, AgentSubAgentDefinition, ApprovalPolicyOptions, ApprovalPolicyPreset, BudgetGuard, BudgetGuardOptions, CreateSubAgentToolOptions, LanguageModel, PrepareSubagentsForAgentOptions, RedactionPolicy, RedactionPolicyOptions, RedactionRule, SafetyPolicy, SafetyPolicyOptions, SafetyPolicyPreset, SubAgentToolInput, SubAgentToolOutput, ToolApprovalDecision, ToolApprovalEvent, ToolApprovalObserver, ToolApprovalPolicy, ToolApprovalRequest } from "@zhivex-ai/core";
|
|
3
9
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,8BAA8B,EAC9B,KAAK,EACL,yBAAyB,EACzB,wBAAwB,EACxB,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,0BAA0B,EAC1B,kBAAkB,EAClB,yBAAyB,EACzB,oBAAoB,EACpB,iBAAiB,EACjB,4BAA4B,EAC5B,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,4BAA4B,EAC5B,+BAA+B,EAC/B,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,wBAAwB,EACxB,WAAW,EACX,QAAQ,EACR,aAAa,EACb,eAAe,EACf,WAAW,EACX,uBAAuB,EACvB,IAAI,EACL,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,sBAAsB,EACtB,oBAAoB,EACpB,2BAA2B,EAC3B,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,yBAAyB,EACzB,0BAA0B,EAC1B,qBAAqB,EACrB,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,YAAY,EACZ,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,0BAA0B,EAC1B,oBAAoB,EACpB,2BAA2B,EAC3B,qBAAqB,EACrB,2BAA2B,EAC3B,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,4BAA4B,EAC5B,WAAW,EACX,SAAS,EACT,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,WAAW,EACX,kBAAkB,EAClB,yBAAyB,EACzB,aAAa,EACb,+BAA+B,EAC/B,eAAe,EACf,sBAAsB,EACtB,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,iBAAiB,CAAC"}
|
package/dist/index.js
CHANGED
|
@@ -1,2 +1,8 @@
|
|
|
1
|
-
|
|
1
|
+
/**
|
|
2
|
+
* Stable application-facing agent runtime.
|
|
3
|
+
*
|
|
4
|
+
* Operational helpers, beta control-plane APIs, experimental realtime APIs,
|
|
5
|
+
* and test doubles live in explicit package subpaths.
|
|
6
|
+
*/
|
|
7
|
+
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";
|
|
2
8
|
//# sourceMappingURL=index.js.map
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,8BAA8B,EAC9B,KAAK,EACL,yBAAyB,EACzB,wBAAwB,EACxB,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,0BAA0B,EAC1B,kBAAkB,EAClB,yBAAyB,EACzB,oBAAoB,EACpB,iBAAiB,EACjB,4BAA4B,EAC5B,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,4BAA4B,EAC5B,+BAA+B,EAC/B,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,wBAAwB,EACxB,WAAW,EACX,QAAQ,EACR,aAAa,EACb,eAAe,EACf,WAAW,EACX,uBAAuB,EACvB,IAAI,EACL,MAAM,iBAAiB,CAAC"}
|
package/dist/ops.d.ts
ADDED
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Stable operational helpers for durable state, observability, evaluation,
|
|
3
|
+
* cost accounting, and provider-support inspection.
|
|
4
|
+
*/
|
|
5
|
+
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";
|
|
6
|
+
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";
|
|
7
|
+
//# sourceMappingURL=ops.d.ts.map
|
|
@@ -0,0 +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"}
|
package/dist/ops.js
ADDED
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Stable operational helpers for durable state, observability, evaluation,
|
|
3
|
+
* cost accounting, and provider-support inspection.
|
|
4
|
+
*/
|
|
5
|
+
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";
|
|
6
|
+
//# sourceMappingURL=ops.js.map
|
package/dist/ops.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ops.js","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"}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
/** Experimental live/realtime agent APIs. */
|
|
2
|
+
export { streamLiveAgent } from "@zhivex-ai/core";
|
|
3
|
+
export type { AgentLiveEvent, AgentLiveStreamResult, LiveAgentDefinition, LiveAgentRunInput, LiveAgentRunOutput } from "@zhivex-ai/core";
|
|
4
|
+
//# sourceMappingURL=realtime.d.ts.map
|
|
@@ -0,0 +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"}
|
package/dist/realtime.js
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"realtime.js","sourceRoot":"","sources":["../src/realtime.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,OAAO,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE1E,YAAY,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}
|
package/dist/testing.js
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"testing.js","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,OAAO,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@zhivex-ai/agents",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.8.1",
|
|
4
4
|
"description": "Agent-first facade for the Zhivex AI SDK runtime.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|
|
@@ -14,6 +14,22 @@
|
|
|
14
14
|
".": {
|
|
15
15
|
"types": "./dist/index.d.ts",
|
|
16
16
|
"import": "./dist/index.js"
|
|
17
|
+
},
|
|
18
|
+
"./ops": {
|
|
19
|
+
"types": "./dist/ops.d.ts",
|
|
20
|
+
"import": "./dist/ops.js"
|
|
21
|
+
},
|
|
22
|
+
"./beta": {
|
|
23
|
+
"types": "./dist/beta.d.ts",
|
|
24
|
+
"import": "./dist/beta.js"
|
|
25
|
+
},
|
|
26
|
+
"./realtime": {
|
|
27
|
+
"types": "./dist/realtime.d.ts",
|
|
28
|
+
"import": "./dist/realtime.js"
|
|
29
|
+
},
|
|
30
|
+
"./testing": {
|
|
31
|
+
"types": "./dist/testing.d.ts",
|
|
32
|
+
"import": "./dist/testing.js"
|
|
17
33
|
}
|
|
18
34
|
},
|
|
19
35
|
"files": [
|
|
@@ -41,6 +57,6 @@
|
|
|
41
57
|
"access": "public"
|
|
42
58
|
},
|
|
43
59
|
"dependencies": {
|
|
44
|
-
"@zhivex-ai/core": "^0.
|
|
60
|
+
"@zhivex-ai/core": "^0.20.0"
|
|
45
61
|
}
|
|
46
62
|
}
|