@zhivex-ai/core 0.7.0 → 0.8.0

package/dist/provider-parity.js

@@ -0,0 +1,175 @@
+import { getAgentCapabilities } from "./messages.js";
+const boolText = (value) => (value ? "yes" : "no");
+const tierText = (tier) => {
+    switch (tier) {
+        case "tier-a":
+            return "Tier A";
+        case "tier-b":
+            return "Tier B";
+        case "tier-c":
+            return "Tier C";
+    }
+};
+const hostedSummary = (agent) => {
+    const features = [
+        agent.hostedWebSearch ? "web search" : undefined,
+        agent.hostedFileSearch ? "file search" : undefined,
+        agent.remoteMcp ? "remote MCP" : undefined,
+        agent.computerUse ? "computer use" : undefined,
+        agent.codeExecution ? "code execution" : undefined,
+        agent.shell ? "shell" : undefined,
+        agent.applyPatch ? "apply patch" : undefined,
+        agent.toolSearch ? "tool search" : undefined,
+        agent.webExtraction ? "web extraction" : undefined,
+        agent.skills ? "skills" : undefined,
+        agent.toolsets ? "toolsets" : undefined
+    ].filter((feature) => Boolean(feature));
+    return features.length ? features.join(", ") : "no";
+};
+const structuredSummary = (model) => model.capabilities.structuredOutput
+    ? model.capabilities.jsonMode
+        ? "native"
+        : "yes"
+    : "no";
+const reasoningSummary = (model) => (model.capabilities.reasoning ? "yes" : "no");
+export const inspectProviderAgentSupport = (model) => {
+    const agent = getAgentCapabilities(model);
+    const hostedTools = Boolean(agent.hostedWebSearch ||
+        agent.hostedFileSearch ||
+        agent.remoteMcp ||
+        agent.computerUse ||
+        agent.codeExecution ||
+        agent.shell ||
+        agent.applyPatch ||
+        agent.toolSearch ||
+        agent.webExtraction ||
+        agent.skills ||
+        agent.toolsets);
+    return {
+        provider: model.provider,
+        modelId: model.modelId,
+        agentTier: agent.supportTier,
+        portableToolLoop: model.capabilities.tools,
+        approvalReady: agent.approvalRequests,
+        hostedTools,
+        remoteMcp: agent.remoteMcp,
+        codeExecution: agent.codeExecution,
+        shell: agent.shell ?? false,
+        realtime: model.capabilities.realtime?.sessions ?? false,
+        structuredOutput: model.capabilities.structuredOutput,
+        reasoning: model.capabilities.reasoning,
+        streaming: model.capabilities.streaming,
+        toolChoice: model.capabilities.toolChoice,
+        webSearch: model.capabilities.webSearch,
+        embeddings: model.capabilities.embeddings,
+        audioInput: model.capabilities.audioInput,
+        audioOutput: model.capabilities.audioOutput,
+        browserTokens: model.capabilities.realtime?.browserTokens ?? false,
+        hostedToolSummary: hostedSummary(agent),
+        structuredOutputSummary: structuredSummary(model),
+        reasoningSummary: reasoningSummary(model)
+    };
+};
+export const createProviderSupportMatrix = (entries) => ({
+    entries: entries.map((entry) => {
+        const model = "model" in entry ? entry.model : entry;
+        return {
+            ...inspectProviderAgentSupport(model),
+            provider: "model" in entry ? entry.provider ?? model.provider : model.provider,
+            modelId: "model" in entry ? entry.modelId ?? model.modelId : model.modelId,
+            ...("model" in entry ? entry.summary ?? {} : {})
+        };
+    })
+});
+const row = (values) => `| ${values.join(" | ")} |`;
+export const renderProviderSupportMatrix = (matrix, options = {}) => {
+    const format = options.format ?? "markdown";
+    if (format !== "markdown") {
+        throw new Error(`Unsupported provider support matrix format "${format}".`);
+    }
+    const header = [
+        "Provider",
+        "`streamText`",
+        "Tools",
+        "`toolChoice`",
+        "Structured output",
+        "Embeddings",
+        "Audio in",
+        "Audio out",
+        "Realtime sessions",
+        "Browser tokens",
+        "Reasoning",
+        "Web search",
+        "Hosted tools / MCP",
+        "Agent tier"
+    ];
+    return [
+        row(header),
+        row(header.map(() => "---")),
+        ...matrix.entries.map((entry) => row([
+            entry.provider,
+            boolText(entry.streaming),
+            boolText(entry.portableToolLoop),
+            boolText(entry.toolChoice),
+            entry.structuredOutputSummary ?? boolText(entry.structuredOutput),
+            boolText(entry.embeddings),
+            boolText(entry.audioInput),
+            boolText(entry.audioOutput),
+            boolText(entry.realtime),
+            boolText(entry.browserTokens),
+            entry.reasoningSummary ?? boolText(entry.reasoning),
+            boolText(entry.webSearch),
+            entry.hostedToolSummary ?? boolText(entry.hostedTools),
+            tierText(entry.agentTier)
+        ]))
+    ].join("\n");
+};
+const entryKey = (entry, includeModel = true) => includeModel ? `${entry.provider}:${entry.modelId}` : entry.provider;
+export const createProviderSupportDriftReport = (actual, expected) => {
+    const missing = [];
+    const unexpected = [];
+    const changed = [];
+    const actualByFullKey = new Map(actual.entries.map((entry) => [entryKey(entry), entry]));
+    const actualByProvider = new Map(actual.entries.map((entry) => [entry.provider, entry]));
+    const matchedActualKeys = new Set();
+    for (const expectedEntry of expected.entries) {
+        const match = expectedEntry.modelId
+            ? actualByFullKey.get(entryKey(expectedEntry))
+            : actualByProvider.get(expectedEntry.provider);
+        if (!match) {
+            missing.push({
+                provider: expectedEntry.provider,
+                modelId: expectedEntry.modelId
+            });
+            continue;
+        }
+        matchedActualKeys.add(entryKey(match));
+        for (const [field, expectedValue] of Object.entries(expectedEntry)) {
+            const actualValue = match[field];
+            if (JSON.stringify(actualValue) !== JSON.stringify(expectedValue)) {
+                changed.push({
+                    provider: expectedEntry.provider,
+                    modelId: expectedEntry.modelId,
+                    field,
+                    expected: expectedValue,
+                    actual: actualValue
+                });
+            }
+        }
+    }
+    for (const actualEntry of actual.entries) {
+        if (!matchedActualKeys.has(entryKey(actualEntry))) {
+            unexpected.push({
+                provider: actualEntry.provider,
+                modelId: actualEntry.modelId
+            });
+        }
+    }
+    return {
+        ok: missing.length === 0 && unexpected.length === 0 && changed.length === 0,
+        missing,
+        unexpected,
+        changed
+    };
+};
+//# sourceMappingURL=provider-parity.js.map

package/dist/provider-parity.js.map

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

package/dist/runner.d.ts

@@ -0,0 +1,111 @@
+import type { AgentApprovalRequest, AgentDefinition, AgentRunInput, AgentRunOutput, AgentRunState, AgentStatus, AgentStreamEvent, JsonValue, LanguageModel, ModelMessage, PostgresClientLike, SqliteDatabaseLike } from "./types.js";
+export declare const SESSION_SCHEMA_VERSION: 1;
+export type SessionEventType = "session-created" | "user-message" | "agent-run-started" | "agent-run-finished" | "agent-run-failed" | "approval-required";
+export interface SessionEvent {
+    id: string;
+    type: SessionEventType;
+    appName: string;
+    userId: string;
+    sessionId: string;
+    createdAt: number;
+    runId?: string;
+    messages?: ModelMessage[];
+    status?: AgentStatus;
+    outputText?: string;
+    approvals?: AgentApprovalRequest[];
+    error?: {
+        message: string;
+    };
+    metadata?: Record<string, JsonValue>;
+}
+export interface AgentSession {
+    schemaVersion: typeof SESSION_SCHEMA_VERSION;
+    revision: number;
+    appName: string;
+    userId: string;
+    sessionId: string;
+    createdAt: number;
+    updatedAt: number;
+    metadata?: Record<string, JsonValue>;
+    events: SessionEvent[];
+    lastRunState?: AgentRunState;
+}
+export interface SessionLookup {
+    appName: string;
+    userId: string;
+    sessionId: string;
+}
+export interface SessionCreateInput extends SessionLookup {
+    metadata?: Record<string, JsonValue>;
+}
+export interface SessionSaveOptions {
+    expectedRevision?: number;
+}
+export interface SessionService {
+    loadSession(input: SessionLookup): Promise<AgentSession | undefined> | AgentSession | undefined;
+    createSession(input: SessionCreateInput): Promise<AgentSession> | AgentSession;
+    saveSession(session: AgentSession, options?: SessionSaveOptions): Promise<void> | void;
+    appendEvent(input: SessionLookup & {
+        event: SessionEvent;
+        expectedRevision?: number;
+    }): Promise<AgentSession> | AgentSession;
+}
+export type RunnerRunInput<TModel extends LanguageModel = LanguageModel> = Omit<AgentRunInput<TModel>, "state" | "handoff" | "parentRunId"> & {
+    userId: string;
+    sessionId?: string;
+    sessionMetadata?: Record<string, JsonValue>;
+    eventMetadata?: Record<string, JsonValue>;
+};
+export interface RunnerRunOutput {
+    session: AgentSession;
+    output: AgentRunOutput;
+}
+export interface RunnerStreamResult {
+    session: Promise<AgentSession>;
+    eventStream: AsyncIterable<AgentStreamEvent>;
+    textStream: AsyncIterable<string>;
+    collect: () => Promise<RunnerRunOutput>;
+}
+export interface Runner<TModel extends LanguageModel = LanguageModel> {
+    run(input: RunnerRunInput<TModel>): Promise<RunnerRunOutput>;
+    stream(input: RunnerRunInput<TModel>): RunnerStreamResult;
+}
+export interface CreateRunnerOptions<TModel extends LanguageModel = LanguageModel> {
+    appName: string;
+    agent: AgentDefinition<TModel>;
+    sessionService: SessionService;
+    defaults?: Partial<Omit<AgentRunInput<TModel>, "state" | "handoff" | "parentRunId">>;
+}
+export interface FileSessionServiceOptions {
+    directory: string;
+}
+export interface SqliteSessionServiceOptions {
+    db: SqliteDatabaseLike;
+    tableName?: string;
+}
+export interface PostgresSessionServiceOptions {
+    client: PostgresClientLike;
+    tableName?: string;
+}
+export interface FileSessionStorePruneOptions extends FileSessionServiceOptions {
+    olderThanMs?: number;
+    keepLast?: number;
+    now?: number;
+    dryRun?: boolean;
+}
+export interface FileSessionStorePruneResult {
+    directory: string;
+    dryRun: boolean;
+    deletedSessionKeys: string[];
+    keptSessionKeys: string[];
+}
+export type AgentSessionMigrationTarget = typeof SESSION_SCHEMA_VERSION;
+export declare const normalizeAgentSession: (value: unknown) => AgentSession;
+export declare const migrateAgentSessionRecord: (value: unknown, targetVersion?: AgentSessionMigrationTarget) => AgentSession;
+export declare const createInMemorySessionService: () => SessionService;
+export declare const createFileSessionService: (options: FileSessionServiceOptions) => SessionService;
+export declare const pruneFileSessionStore: (options: FileSessionStorePruneOptions) => Promise<FileSessionStorePruneResult>;
+export declare const createSqliteSessionService: (options: SqliteSessionServiceOptions) => SessionService;
+export declare const createPostgresSessionService: (options: PostgresSessionServiceOptions) => SessionService;
+export declare const createRunner: <TModel extends LanguageModel>(options: CreateRunnerOptions<TModel>) => Runner<TModel>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

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