@zhivex-ai/agents 0.5.1 → 0.6.0

package/README.md

@@ -2,6 +2,158 @@
 
 Agent-first facade for the Zhivex AI SDK runtime.
 
-Use this package when an application only needs the portable agent runtime, stores, memory, safety, tracing, evaluation, and provider support helpers. The implementation re-exports the current contracts from `@zhivex-ai/core`; `core` remains the source of truth.
+Use this package when an application wants the portable agent layer without the broader generation, media, artifact, and provider utility surface from `@zhivex-ai/sdk`.
 
-Use `@zhivex-ai/sdk` when you want the broader unified SDK surface, and use provider packages such as `@zhivex-ai/openai` or `@zhivex-ai/gemini` to create concrete models.
+## Install
+
+```bash
+bun add @zhivex-ai/agents @zhivex-ai/openai zod
+```
+
+Provider packages stay opt-in. Use `@zhivex-ai/openai`, `@zhivex-ai/anthropic`, `@zhivex-ai/gemini`, `@zhivex-ai/vertex`, `@zhivex-ai/qwen`, `@zhivex-ai/bedrock`, or another supported provider to create concrete models.
+
+## Quick Start
+
+```ts
+import { Agent } from "@zhivex-ai/agents";
+import { createOpenAI } from "@zhivex-ai/openai";
+
+const openai = createOpenAI({
+  apiKey: process.env.OPENAI_API_KEY
+});
+
+const agent = new Agent({
+  model: openai("gpt-5"),
+  instructions: "Be concise and use tools when they help.",
+  maxSteps: 4
+});
+
+const result = await agent.run({
+  prompt: "Summarize today's customer escalations."
+});
+
+console.log(result.outputText);
+console.log(result.state);
+```
+
+`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.
+
+## What This Package Covers
+
+- Stable agent runtime: `Agent`, `createAgent()`, `runAgent()`, `resumeAgent()`, and `streamAgent()`.
+- Tool loops: local callable tools, tool-choice support, tool execution options, and approval policies.
+- Human-in-the-loop: provider approval requests, approval response parts/messages, approval queues, and resumable states.
+- Memory and stores: in-memory, file, SQLite, and Postgres run stores and memory stores.
+- Multi-agent patterns: handoffs, subagents as tools, parallel agent groups, and hierarchical traces.
+- Production safety: safety policies, budget guards, read-only approval policies, redaction, and audit records.
+- Observability and evaluation: trace collectors, run snapshots, replay, cost estimates, golden traces, evaluation fixtures, and ledgers.
+- Provider routing: support matrices, agent capability routing, model selection, hosted-tool summaries, and provider drift reports.
+- Beta control plane: capsules, tool policies, approval queue items, ledgers, golden traces, and inspectable control-plane run records.
+
+## Tools
+
+```ts
+import { Agent, tool } from "@zhivex-ai/agents";
+import { createOpenAI } from "@zhivex-ai/openai";
+import { z } from "zod";
+
+const openai = createOpenAI({ apiKey: process.env.OPENAI_API_KEY });
+
+const agent = new Agent({
+  model: openai("gpt-5"),
+  maxSteps: 3,
+  tools: {
+    lookupAccount: tool({
+      name: "lookupAccount",
+      schema: z.object({ accountId: z.string() }),
+      execute: async ({ accountId }) => ({
+        accountId,
+        status: "active"
+      })
+    })
+  }
+});
+
+const result = await agent.run({
+  prompt: "Check account acct_123 before answering."
+});
+```
+
+## Streaming
+
+```ts
+const stream = agent.stream({
+  prompt: "Give me a live status update."
+});
+
+for await (const chunk of stream.textStream) {
+  process.stdout.write(chunk);
+}
+
+const final = await stream.collect();
+console.log(final.state);
+```
+
+For server responses, use `toUIAgentStreamResponse()` to expose lifecycle-aware agent streams to browser clients.
+
+## Human Approval
+
+When a provider emits an approval request, the run returns `waiting_approval` and keeps pending requests in `state.pendingApprovals`. Persist the state, collect a user decision, and resume:
+
+```ts
+const waiting = await agent.run({ prompt: "Use the remote MCP server." });
+
+if (waiting.status === "waiting_approval") {
+  const resumed = await agent.resume({
+    state: waiting.state,
+    approvals: waiting.state.pendingApprovals.map((request) => ({
+      provider: request.provider,
+      approvalRequestId: request.id,
+      approve: true
+    }))
+  });
+
+  console.log(resumed.outputText);
+}
+```
+
+Use `createAgentApprovalQueue()` when the application needs queue items with approval tokens and resume URLs.
+
+## Production State
+
+Use in-memory stores for tests, file stores for local development, and SQL stores for production runtimes that must survive process restarts:
+
+```ts
+import { Agent, createPostgresAgentRunStore, createPostgresAgentMemoryStore } from "@zhivex-ai/agents";
+
+const agent = new Agent({
+  model,
+  store: createPostgresAgentRunStore({ client: postgresClient }),
+  memory: createPostgresAgentMemoryStore({ client: postgresClient })
+});
+```
+
+For app-facing multi-turn sessions, use `createRunner()` from `@zhivex-ai/sdk`; `@zhivex-ai/agents` intentionally stays focused on the agent runtime facade.
+
+## Provider Tiers
+
+Use provider support helpers before routing important agent workloads:
+
+```ts
+import { createAgentCapabilityRouter } from "@zhivex-ai/agents";
+
+const router = createAgentCapabilityRouter([openai("gpt-5"), anthropic("claude-sonnet-5")]);
+const selected = router.select({
+  minTier: "tier-b",
+  approvals: true,
+  remoteMcp: true
+});
+```
+
+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.
+
+## When To Use `@zhivex-ai/sdk`
+
+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.
+
+Use `@zhivex-ai/agents` when you want the smallest public package surface for portable agents, stores, safety, tracing, evaluation, provider support, and control-plane helpers.

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-export { AGENT_CONTROL_PLANE_SCHEMA_VERSION, agentApprovalResponsePart, applySafetyPolicyToAgent, cancelAgentRun, cancelAgentRunTree, createAgent, createAgentApprovalMessage, createAgentEvaluationFixture, createAgentEvaluationReport, createAgentAuditRecord, createAgentApprovalQueue, createAgentCapabilityRouter, createAgentCapsule, createAgentControlPlane, createAgentControlPlaneRunRecord, createAgentHandoff, createAgentHandoffMessage, createAgentRunSnapshot, createAgentRunTreeSnapshot, createAgentTraceArtifact, createAgentTraceCollector, createAgentRunLedger, createAgentToolPolicy, createApprovalPolicy, createBudgetGuard, createFileAgentMemoryStore, createFileAgentRunStore, createHierarchicalAgentTrace, createInMemoryAgentMemoryStore, createInMemoryAgentRunStore, createMockLanguageModel, createMockTool, createPostgresAgentMemoryStore, createPostgresAgentRunStore, createProductionSafetyPolicy, createProductionTraceCollector, createProductionTraceOptions, createProviderSupportDriftReport, createProviderSupportMatrix, createRedactionPolicy, createReadOnlyToolApprovalPolicy, createSafetyPolicy, createSensitiveDataPolicy, createSqliteAgentMemoryStore, createSqliteAgentRunStore, createSubAgentTool, estimateAgentRunCost, estimateTokenCost, getAgentApprovalRequestFromPart, getAgentApprovalRequests, getAgentCapabilities, getAgentSupportTier, getHostedToolClass, diffAgentRunLedgers, inspectAgentCapsule, inspectAgentControlPlane, inspectProviderAgentSupport, judgeAgentEvaluation, prepareSubagentsForAgent, promoteAgentGoldenTrace, renderProviderSupportMatrix, replayAgentRun, resumeAgent, runAgent, runAgentEvaluation, runAgentEvaluationFixture, runAgentGroup, runAgentHandoff, selectAgentModel, streamAgent, streamLiveAgent, summarizeAgentTrace, createToolAuditRecords, PRODUCTION_AGENT_KIT_SCHEMA_VERSION, toUIAgentStreamResponse } from "@zhivex-ai/core";
-export type { AgentApprovalQueueItem, AgentApprovalQueueOptions, AgentApprovalRequest, AgentApprovalRequestEvent, AgentApprovalResolvedEvent, AgentApprovalResponse, AgentCapabilities, AgentCapabilityRequirements, AgentCapabilityRouter, AgentCapsule, AgentCapsuleEvaluationManifest, AgentCapsuleInspection, AgentCapsuleManifest, AgentCapsuleMcpServerManifest, AgentCapsulePolicyManifest, AgentCapsuleSkillManifest, AgentCapsuleToolManifest, AgentChildRun, AgentControlPlane, AgentControlPlaneInspection, AgentControlPlaneOptions, AgentControlPlaneRunInput, AgentControlPlaneRunRecord, AgentDefinition, AgentEvaluationCase, AgentEvaluationCaseResult, AgentEvaluationExpectations, AgentEvaluationFixture, AgentEvaluationJudge, AgentEvaluationJudgeResult, AgentEvaluationReport, AgentEvaluationReportCase, AgentEvaluationResult, AgentGroupMember, AgentGroupMemberResult, AgentGroupRunInput, AgentGroupRunOutput, AgentGuardrailTrigger, AgentHandoff, AgentInputGuardrail, AgentInputGuardrailRequest, AgentLiveEvent, AgentLiveStreamResult, AgentMemoryContext, AgentMemoryStore, AgentOutputGuardrail, AgentOutputGuardrailRequest, AgentReplayResult, AgentReplayTimelineEvent, AgentRunCancellationOptions, AgentRunCostPricing, AgentRunLedger, AgentRunLedgerDiff, AgentRunLedgerDiffChange, AgentRunLedgerOptions, AgentRunFinishEvent, AgentRunInput, AgentRunOutput, AgentRunPolicy, AgentRunSnapshot, AgentRunStartEvent, AgentRunState, AgentRunStore, AgentRunTreeCancellationResult, AgentRunTreeNode, AgentRunTreeSnapshot, AgentStatus, AgentStep, AgentStepFinishEvent, AgentStepRequest, AgentStepResponse, AgentStepStartEvent, AgentStepStatus, AgentStreamEvent, AgentStreamResult, AgentSubAgentDefinition, AgentSupportTier, AgentGoldenTrace, AgentModelCandidate, AgentModelSelection, AgentToolPermission, AgentToolPolicyMode, AgentToolPolicyOptions, AgentToolRiskLevel, AgentTelemetryApprovalRequestEvent, AgentTelemetryApprovalResolvedEvent, AgentTelemetryEvent, AgentTelemetryGuardrailTriggeredEvent, AgentTelemetryHandoffEvent, AgentTelemetryMemoryLoadedEvent, AgentTelemetryObserver, AgentTelemetryRunFinishEvent, AgentTelemetryRunStartEvent, AgentTelemetryStateSavedEvent, AgentTelemetryStepFinishEvent, AgentTelemetryStepStartEvent, AgentTelemetrySubAgentFinishEvent, AgentTelemetrySubAgentStartEvent, AgentTelemetryToolApprovalEvent, AgentTraceArtifact, AgentAuditRecord, AgentAuditRecordOptions, AgentTraceCollector, AgentTraceEvent, AgentTraceOptions, AgentTraceStep, AgentTraceSummary, AgentTraceToolCall, ApprovalPolicyOptions, ApprovalPolicyPreset, BudgetGuard, BudgetGuardOptions, CostEstimate, CreateSubAgentToolOptions, CreateAgentCapsuleOptions, HierarchicalAgentTrace, HierarchicalAgentTraceNode, LatencySummary, LiveAgentDefinition, LiveAgentRunInput, LiveAgentRunOutput, MockLanguageModelOptions, MockToolOptions, PostgresAgentMemoryStoreOptions, PostgresAgentRunStoreOptions, PrepareSubagentsForAgentOptions, ReadOnlyToolApprovalPolicyOptions, ProviderAgentSupport, ProviderSupportDrift, ProviderSupportDriftExpectedEntry, ProviderSupportDriftExpectedMatrix, ProviderSupportDriftReport, ProviderSupportMatrix, ProviderSupportMatrixEntry, ProviderSupportMatrixFormat, RedactionPolicy, RedactionPolicyOptions, RedactionRule, SensitiveDataPolicyOptions, RunAgentEvaluationOptions, SafetyPolicy, SafetyPolicyOptions, SafetyPolicyPreset, SqliteAgentMemoryStoreOptions, SqliteAgentRunStoreOptions, SubAgentToolInput, SubAgentToolOutput, TokenPricing, ToolApprovalDecision, ToolApprovalEvent, ToolApprovalObserver, ToolApprovalPolicy, ToolApprovalRequest, ToolAuditRecord, ToolAuditRecordOptions } from "@zhivex-ai/core";
+export { AGENT_CONTROL_PLANE_SCHEMA_VERSION, Agent, agentApprovalResponsePart, applySafetyPolicyToAgent, cancelAgentRun, cancelAgentRunTree, createAgent, createAgentApprovalMessage, createAgentEvaluationFixture, createAgentEvaluationReport, createAgentAuditRecord, createAgentApprovalQueue, createAgentCapabilityRouter, createAgentCapsule, createAgentControlPlane, createAgentControlPlaneRunRecord, createAgentHandoff, createAgentHandoffMessage, createAgentRunSnapshot, createAgentRunTreeSnapshot, createAgentTraceArtifact, createAgentTraceCollector, createAgentRunLedger, createAgentToolPolicy, createApprovalPolicy, createBudgetGuard, createFileAgentMemoryStore, createFileAgentRunStore, createHierarchicalAgentTrace, createInMemoryAgentMemoryStore, createInMemoryAgentRunStore, createMockLanguageModel, createMockTool, createPostgresAgentMemoryStore, createPostgresAgentRunStore, createProductionSafetyPolicy, createProductionTraceCollector, createProductionTraceOptions, createProviderSupportDriftReport, createProviderSupportMatrix, createRedactionPolicy, createReadOnlyToolApprovalPolicy, createSafetyPolicy, createSensitiveDataPolicy, createSqliteAgentMemoryStore, createSqliteAgentRunStore, createSubAgentTool, estimateAgentRunCost, estimateTokenCost, getAgentApprovalRequestFromPart, getAgentApprovalRequests, getAgentCapabilities, getAgentSupportTier, getHostedToolClass, diffAgentRunLedgers, inspectAgentCapsule, inspectAgentControlPlane, inspectProviderAgentSupport, judgeAgentEvaluation, prepareSubagentsForAgent, promoteAgentGoldenTrace, renderProviderSupportMatrix, replayAgentRun, resumeAgent, runAgent, runAgentEvaluation, runAgentEvaluationFixture, runAgentGroup, runAgentHandoff, selectAgentModel, streamAgent, streamLiveAgent, summarizeAgentTrace, createToolAuditRecords, PRODUCTION_AGENT_KIT_SCHEMA_VERSION, toUIAgentStreamResponse, tool } from "@zhivex-ai/core";
+export type { AgentApprovalQueueItem, AgentApprovalQueueOptions, AgentApprovalRequest, AgentApprovalRequestEvent, AgentApprovalResolvedEvent, AgentApprovalResponse, AgentCapabilities, AgentCapabilityRequirements, AgentCapabilityRouter, AgentCapsule, AgentCapsuleEvaluationManifest, AgentCapsuleInspection, AgentCapsuleManifest, AgentCapsuleMcpServerManifest, AgentCapsulePolicyManifest, AgentCapsuleSkillManifest, AgentCapsuleToolManifest, AgentChildRun, AgentControlPlane, AgentControlPlaneInspection, AgentControlPlaneOptions, AgentControlPlaneRunInput, AgentControlPlaneRunRecord, AgentDefinition, AgentEvaluationCase, AgentEvaluationCaseResult, AgentEvaluationExpectations, AgentEvaluationFixture, AgentEvaluationJudge, AgentEvaluationJudgeResult, AgentEvaluationReport, AgentEvaluationReportCase, AgentEvaluationResult, AgentGroupMember, AgentGroupMemberResult, AgentGroupRunInput, AgentGroupRunOutput, AgentGuardrailTrigger, AgentHandoff, AgentInputGuardrail, AgentInputGuardrailRequest, AgentLiveEvent, AgentLiveStreamResult, AgentMemoryContext, AgentMemoryStore, AgentOutputGuardrail, AgentOutputGuardrailRequest, AgentReplayResult, AgentReplayTimelineEvent, AgentRunCancellationOptions, AgentRunCostPricing, AgentRunLedger, AgentRunLedgerDiff, AgentRunLedgerDiffChange, AgentRunLedgerOptions, AgentRunFinishEvent, AgentRunInput, AgentRunOutput, AgentRunPolicy, AgentRunSnapshot, AgentRunStartEvent, AgentRunState, AgentRunStore, AgentRunTreeCancellationResult, AgentRunTreeNode, AgentRunTreeSnapshot, AgentStatus, AgentStep, AgentStepFinishEvent, AgentStepRequest, AgentStepResponse, AgentStepStartEvent, AgentStepStatus, AgentStreamEvent, AgentStreamResult, AgentSubAgentDefinition, AgentSupportTier, AgentGoldenTrace, AgentModelCandidate, AgentModelSelection, AgentToolPermission, AgentToolPolicyMode, AgentToolPolicyOptions, AgentToolRiskLevel, AgentTelemetryApprovalRequestEvent, AgentTelemetryApprovalResolvedEvent, AgentTelemetryEvent, AgentTelemetryGuardrailTriggeredEvent, AgentTelemetryHandoffEvent, AgentTelemetryMemoryLoadedEvent, AgentTelemetryObserver, AgentTelemetryRunFinishEvent, AgentTelemetryRunStartEvent, AgentTelemetryStateSavedEvent, AgentTelemetryStepFinishEvent, AgentTelemetryStepStartEvent, AgentTelemetrySubAgentFinishEvent, AgentTelemetrySubAgentStartEvent, AgentTelemetryToolApprovalEvent, AgentTraceArtifact, AgentAuditRecord, AgentAuditRecordOptions, AgentTraceCollector, AgentTraceEvent, AgentTraceOptions, AgentTraceStep, AgentTraceSummary, AgentTraceToolCall, ApprovalPolicyOptions, ApprovalPolicyPreset, BudgetGuard, BudgetGuardOptions, CostEstimate, CreateSubAgentToolOptions, CreateAgentCapsuleOptions, HierarchicalAgentTrace, HierarchicalAgentTraceNode, LatencySummary, LanguageModel, LiveAgentDefinition, LiveAgentRunInput, LiveAgentRunOutput, MockLanguageModelOptions, MockToolOptions, PostgresAgentMemoryStoreOptions, PostgresAgentRunStoreOptions, PrepareSubagentsForAgentOptions, ReadOnlyToolApprovalPolicyOptions, ProviderAgentSupport, ProviderSupportDrift, ProviderSupportDriftExpectedEntry, ProviderSupportDriftExpectedMatrix, ProviderSupportDriftReport, ProviderSupportMatrix, ProviderSupportMatrixEntry, ProviderSupportMatrixFormat, RedactionPolicy, RedactionPolicyOptions, RedactionRule, SensitiveDataPolicyOptions, RunAgentEvaluationOptions, SafetyPolicy, SafetyPolicyOptions, SafetyPolicyPreset, SqliteAgentMemoryStoreOptions, SqliteAgentRunStoreOptions, SubAgentToolInput, SubAgentToolOutput, TokenPricing, ToolApprovalDecision, ToolApprovalEvent, ToolApprovalObserver, ToolApprovalPolicy, ToolApprovalRequest, ToolAuditRecord, ToolAuditRecordOptions } from "@zhivex-ai/core";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,2 +1,2 @@
-export { AGENT_CONTROL_PLANE_SCHEMA_VERSION, agentApprovalResponsePart, applySafetyPolicyToAgent, cancelAgentRun, cancelAgentRunTree, createAgent, createAgentApprovalMessage, createAgentEvaluationFixture, createAgentEvaluationReport, createAgentAuditRecord, createAgentApprovalQueue, createAgentCapabilityRouter, createAgentCapsule, createAgentControlPlane, createAgentControlPlaneRunRecord, createAgentHandoff, createAgentHandoffMessage, createAgentRunSnapshot, createAgentRunTreeSnapshot, createAgentTraceArtifact, createAgentTraceCollector, createAgentRunLedger, createAgentToolPolicy, createApprovalPolicy, createBudgetGuard, createFileAgentMemoryStore, createFileAgentRunStore, createHierarchicalAgentTrace, createInMemoryAgentMemoryStore, createInMemoryAgentRunStore, createMockLanguageModel, createMockTool, createPostgresAgentMemoryStore, createPostgresAgentRunStore, createProductionSafetyPolicy, createProductionTraceCollector, createProductionTraceOptions, createProviderSupportDriftReport, createProviderSupportMatrix, createRedactionPolicy, createReadOnlyToolApprovalPolicy, createSafetyPolicy, createSensitiveDataPolicy, createSqliteAgentMemoryStore, createSqliteAgentRunStore, createSubAgentTool, estimateAgentRunCost, estimateTokenCost, getAgentApprovalRequestFromPart, getAgentApprovalRequests, getAgentCapabilities, getAgentSupportTier, getHostedToolClass, diffAgentRunLedgers, inspectAgentCapsule, inspectAgentControlPlane, inspectProviderAgentSupport, judgeAgentEvaluation, prepareSubagentsForAgent, promoteAgentGoldenTrace, renderProviderSupportMatrix, replayAgentRun, resumeAgent, runAgent, runAgentEvaluation, runAgentEvaluationFixture, runAgentGroup, runAgentHandoff, selectAgentModel, streamAgent, streamLiveAgent, summarizeAgentTrace, createToolAuditRecords, PRODUCTION_AGENT_KIT_SCHEMA_VERSION, toUIAgentStreamResponse } from "@zhivex-ai/core";
+export { AGENT_CONTROL_PLANE_SCHEMA_VERSION, Agent, agentApprovalResponsePart, applySafetyPolicyToAgent, cancelAgentRun, cancelAgentRunTree, createAgent, createAgentApprovalMessage, createAgentEvaluationFixture, createAgentEvaluationReport, createAgentAuditRecord, createAgentApprovalQueue, createAgentCapabilityRouter, createAgentCapsule, createAgentControlPlane, createAgentControlPlaneRunRecord, createAgentHandoff, createAgentHandoffMessage, createAgentRunSnapshot, createAgentRunTreeSnapshot, createAgentTraceArtifact, createAgentTraceCollector, createAgentRunLedger, createAgentToolPolicy, createApprovalPolicy, createBudgetGuard, createFileAgentMemoryStore, createFileAgentRunStore, createHierarchicalAgentTrace, createInMemoryAgentMemoryStore, createInMemoryAgentRunStore, createMockLanguageModel, createMockTool, createPostgresAgentMemoryStore, createPostgresAgentRunStore, createProductionSafetyPolicy, createProductionTraceCollector, createProductionTraceOptions, createProviderSupportDriftReport, createProviderSupportMatrix, createRedactionPolicy, createReadOnlyToolApprovalPolicy, createSafetyPolicy, createSensitiveDataPolicy, createSqliteAgentMemoryStore, createSqliteAgentRunStore, createSubAgentTool, estimateAgentRunCost, estimateTokenCost, getAgentApprovalRequestFromPart, getAgentApprovalRequests, getAgentCapabilities, getAgentSupportTier, getHostedToolClass, diffAgentRunLedgers, inspectAgentCapsule, inspectAgentControlPlane, inspectProviderAgentSupport, judgeAgentEvaluation, prepareSubagentsForAgent, promoteAgentGoldenTrace, renderProviderSupportMatrix, replayAgentRun, resumeAgent, runAgent, runAgentEvaluation, runAgentEvaluationFixture, runAgentGroup, runAgentHandoff, selectAgentModel, streamAgent, streamLiveAgent, summarizeAgentTrace, createToolAuditRecords, PRODUCTION_AGENT_KIT_SCHEMA_VERSION, toUIAgentStreamResponse, tool } from "@zhivex-ai/core";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kCAAkC,EAClC,yBAAyB,EACzB,wBAAwB,EACxB,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,0BAA0B,EAC1B,4BAA4B,EAC5B,2BAA2B,EAC3B,sBAAsB,EACtB,wBAAwB,EACxB,2BAA2B,EAC3B,kBAAkB,EAClB,uBAAuB,EACvB,gCAAgC,EAChC,kBAAkB,EAClB,yBAAyB,EACzB,sBAAsB,EACtB,0BAA0B,EAC1B,wBAAwB,EACxB,yBAAyB,EACzB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,0BAA0B,EAC1B,uBAAuB,EACvB,4BAA4B,EAC5B,8BAA8B,EAC9B,2BAA2B,EAC3B,uBAAuB,EACvB,cAAc,EACd,8BAA8B,EAC9B,2BAA2B,EAC3B,4BAA4B,EAC5B,8BAA8B,EAC9B,4BAA4B,EAC5B,gCAAgC,EAChC,2BAA2B,EAC3B,qBAAqB,EACrB,gCAAgC,EAChC,kBAAkB,EAClB,yBAAyB,EACzB,4BAA4B,EAC5B,yBAAyB,EACzB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,+BAA+B,EAC/B,wBAAwB,EACxB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,EACxB,2BAA2B,EAC3B,oBAAoB,EACpB,wBAAwB,EACxB,uBAAuB,EACvB,2BAA2B,EAC3B,cAAc,EACd,WAAW,EACX,QAAQ,EACR,kBAAkB,EAClB,yBAAyB,EACzB,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,mCAAmC,EACnC,uBAAuB,EACxB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kCAAkC,EAClC,KAAK,EACL,yBAAyB,EACzB,wBAAwB,EACxB,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,0BAA0B,EAC1B,4BAA4B,EAC5B,2BAA2B,EAC3B,sBAAsB,EACtB,wBAAwB,EACxB,2BAA2B,EAC3B,kBAAkB,EAClB,uBAAuB,EACvB,gCAAgC,EAChC,kBAAkB,EAClB,yBAAyB,EACzB,sBAAsB,EACtB,0BAA0B,EAC1B,wBAAwB,EACxB,yBAAyB,EACzB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,0BAA0B,EAC1B,uBAAuB,EACvB,4BAA4B,EAC5B,8BAA8B,EAC9B,2BAA2B,EAC3B,uBAAuB,EACvB,cAAc,EACd,8BAA8B,EAC9B,2BAA2B,EAC3B,4BAA4B,EAC5B,8BAA8B,EAC9B,4BAA4B,EAC5B,gCAAgC,EAChC,2BAA2B,EAC3B,qBAAqB,EACrB,gCAAgC,EAChC,kBAAkB,EAClB,yBAAyB,EACzB,4BAA4B,EAC5B,yBAAyB,EACzB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,+BAA+B,EAC/B,wBAAwB,EACxB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,EACxB,2BAA2B,EAC3B,oBAAoB,EACpB,wBAAwB,EACxB,uBAAuB,EACvB,2BAA2B,EAC3B,cAAc,EACd,WAAW,EACX,QAAQ,EACR,kBAAkB,EAClB,yBAAyB,EACzB,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,mCAAmC,EACnC,uBAAuB,EACvB,IAAI,EACL,MAAM,iBAAiB,CAAC"}

package/package.json

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