@linnlabs/linnkit 0.8.0

package/dist/ai-engine.types-BpeU_XQG.d.cts

@@ -0,0 +1,158 @@
+import { A as AiMessage } from './messages-XthmnHZ3.cjs';
+
+/**
+ * @file packages/linnkit/src/ports/ai-engine.types.ts
+ * @description
+ * AI 引擎协议参数 type 的**真正 owner**。
+ *
+ * 历史背景：这 5 个 type 原本定义在 `runtime-kernel/llm/caller.types.ts`，
+ * 但它们的语义其实是"host 实现 `AgentAiEngine` 时要填入的参数形状" —— 属于 ports
+ * 协议面，不属于 runtime-kernel 实现层。把它们放在 runtime-kernel 一侧导致
+ * `ports/ai-engine.ts` 反向 import runtime-kernel，形成 ports ⇄ runtime-kernel 循环
+ * 依赖（rollup dts 打包阶段发出 chunk 循环警告）。
+ *
+ * 2026-04-23 归位：
+ * - 5 个 type 的 **definitive source** 移到本文件
+ * - `runtime-kernel/llm/caller.types.ts` 改为从 `'../../ports'` barrel re-export，保持
+ *   runtime-kernel 的 public face 兼容（`llm.LlmCallOptions` namespace 访问仍然 work）
+ * - `ports` 不再依赖 runtime-kernel，循环彻底消除
+ *
+ * 约定：
+ * - 本文件**只放类型定义**，不包含业务逻辑；
+ * - 供 ports / runtime-kernel / testkit / 外部 host 共享引用；
+ * - 字段语义与 OpenAI chat completion / tool calls 协议对齐，兼容 Anthropic / Gemini
+ *   等供应商（由各 adapter 做映射）。
+ */
+
+/**
+ * 工具调用的结构类型（OpenAI tool_calls 兼容）
+ */
+type ProviderReasoningDetails = unknown[];
+type ToolCallExtraContent = {
+    google?: {
+        thought_signature?: string;
+    } & Record<string, unknown>;
+} & Record<string, unknown>;
+interface ToolCall {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+    /**
+     * Provider 工具调用扩展载荷。
+     *
+     * 说明：
+     * - linnkit 不解析 provider 私有内容，只负责在工具调用轮次中原样回放；
+     * - Gemini / Google OpenAI-compat 会在 google.thought_signature 中放置签名；
+     * - 其他 provider 可使用自己的命名空间承载不透明 replay 数据。
+     */
+    extra_content?: ToolCallExtraContent;
+}
+/**
+ * 流式工具调用增量（OpenAI tool_calls delta）
+ */
+interface ToolCallChunk {
+    index: number;
+    id?: string;
+    function?: {
+        name?: string;
+        arguments?: string;
+    };
+    /**
+     * Provider 工具调用扩展增量（可能只在首个 tool_call 上出现一次）。
+     */
+    extra_content?: ToolCallExtraContent;
+}
+type LlmRequestMessage = AiMessage | {
+    role: 'system' | 'user';
+    content: string;
+} | {
+    role: 'assistant';
+    content: string;
+} | {
+    role: 'assistant';
+    content: string | null;
+    tool_calls: unknown[];
+    reasoning_details?: ProviderReasoningDetails;
+} | {
+    role: 'tool';
+    tool_call_id: string;
+    content: string;
+};
+/**
+ * LLM 流式/非流式的统一响应载荷（caller 内部使用）
+ */
+interface LlmResponseContent {
+    content?: string;
+    tool_calls?: ToolCall[] | ToolCallChunk[];
+    /**
+     * Provider reasoning replay blocks。
+     *
+     * 这些 blocks 是不透明的 provider sidecar：linnkit 只负责保存、绑定到工具调用决策并在
+     * 下一轮回放，具体结构由 adapter/policy 解释。部分 reasoning models 在工具调用后
+     * 要求这些 blocks 原样传回，否则后续请求会被拒绝。
+     */
+    reasoning_details?: ProviderReasoningDetails;
+    /**
+     * 供应商返回的 token 用量（若支持）
+     *
+     * 中文备注：
+     * - 流式场景需配合 `stream_options.include_usage` 才可能拿到；
+     * - 不同 provider 字段可能不同（例如 mock 返回 usage.tokens），上层应做归一化处理。
+     */
+    usage?: unknown;
+}
+interface LlmCallOptions {
+    tools?: unknown[];
+    /**
+     * 工具选择策略（OpenAI tool_choice 兼容）
+     *
+     * 说明：
+     * - 'auto' / 'none'：常见 provider 统一语义；
+     * - {type:'function', function:{name}}：强制调用指定工具（用于步数收尾策略 force_tools 等）。
+     *
+     * 注意：不同 provider 的"强制工具调用"字段名可能不同（例如 Anthropic 为 {type:'tool', name}），
+     * 但在本系统边界内统一使用 OpenAI-compat 形态，由各 adapter 做映射。
+     */
+    tool_choice?: 'auto' | 'none' | {
+        type: 'function';
+        function: {
+            name: string;
+        };
+    };
+    temperature?: number;
+    top_p?: number;
+    max_tokens?: number;
+    /**
+     * 重试策略（仅影响客户端侧 `LlmCaller.callWithRetries`）。
+     *
+     * 背景（中文说明）：
+     * - BYOK（本地直连）模式下，客户端重试是合理的：成本由用户自带 key 承担；
+     * - Cloud（积分计费）模式下，客户端重试会导致"一次点击一个 request_id"的账单语义被破坏，
+     *   因为同一次点击可能触发多次上游调用，造成对账困难或平台资损。
+     *
+     * 约定：
+     * - `client`：允许客户端按本地 retryConfig 重试（默认）；
+     * - `none`：强制不重试（只执行一次，失败直接返回错误）。Cloud 模式推荐使用该值或在模型配置中关闭客户端重试。
+     */
+    retry_policy?: 'client' | 'none';
+    /**
+     * 云端模型限额降级目标（同一个 run 内续跑专用）
+     *
+     * 中文说明：
+     * - 仅当"同一个 run 内已经不是第一次 LLM 调用"时由上层传入；
+     * - 如果本次 LLM 调用因为云端 quota/限额被拒，LlmCaller 会静默切到该模型继续，
+     *   不向前端发 error 事件（前端无感知）；
+     * - 若为 undefined 或空字符串，则 quota 错误仍按"不可重试"处理（即新请求直接报错）。
+     */
+    cloud_quota_fallback_model_id?: string;
+}
+interface LlmRetryConfig {
+    maxRetries: number;
+    enableEmptyResponseRetry: boolean;
+    retryDelayMs: number;
+}
+
+export type { LlmCallOptions as L, ProviderReasoningDetails as P, ToolCall as T, LlmRequestMessage as a, LlmResponseContent as b, LlmRetryConfig as c, ToolCallChunk as d, ToolCallExtraContent as e };

package/dist/ai-engine.types-vZRnQcJa.d.ts

@@ -0,0 +1,158 @@
+import { A as AiMessage } from './messages-XthmnHZ3.js';
+
+/**
+ * @file packages/linnkit/src/ports/ai-engine.types.ts
+ * @description
+ * AI 引擎协议参数 type 的**真正 owner**。
+ *
+ * 历史背景：这 5 个 type 原本定义在 `runtime-kernel/llm/caller.types.ts`，
+ * 但它们的语义其实是"host 实现 `AgentAiEngine` 时要填入的参数形状" —— 属于 ports
+ * 协议面，不属于 runtime-kernel 实现层。把它们放在 runtime-kernel 一侧导致
+ * `ports/ai-engine.ts` 反向 import runtime-kernel，形成 ports ⇄ runtime-kernel 循环
+ * 依赖（rollup dts 打包阶段发出 chunk 循环警告）。
+ *
+ * 2026-04-23 归位：
+ * - 5 个 type 的 **definitive source** 移到本文件
+ * - `runtime-kernel/llm/caller.types.ts` 改为从 `'../../ports'` barrel re-export，保持
+ *   runtime-kernel 的 public face 兼容（`llm.LlmCallOptions` namespace 访问仍然 work）
+ * - `ports` 不再依赖 runtime-kernel，循环彻底消除
+ *
+ * 约定：
+ * - 本文件**只放类型定义**，不包含业务逻辑；
+ * - 供 ports / runtime-kernel / testkit / 外部 host 共享引用；
+ * - 字段语义与 OpenAI chat completion / tool calls 协议对齐，兼容 Anthropic / Gemini
+ *   等供应商（由各 adapter 做映射）。
+ */
+
+/**
+ * 工具调用的结构类型（OpenAI tool_calls 兼容）
+ */
+type ProviderReasoningDetails = unknown[];
+type ToolCallExtraContent = {
+    google?: {
+        thought_signature?: string;
+    } & Record<string, unknown>;
+} & Record<string, unknown>;
+interface ToolCall {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+    /**
+     * Provider 工具调用扩展载荷。
+     *
+     * 说明：
+     * - linnkit 不解析 provider 私有内容，只负责在工具调用轮次中原样回放；
+     * - Gemini / Google OpenAI-compat 会在 google.thought_signature 中放置签名；
+     * - 其他 provider 可使用自己的命名空间承载不透明 replay 数据。
+     */
+    extra_content?: ToolCallExtraContent;
+}
+/**
+ * 流式工具调用增量（OpenAI tool_calls delta）
+ */
+interface ToolCallChunk {
+    index: number;
+    id?: string;
+    function?: {
+        name?: string;
+        arguments?: string;
+    };
+    /**
+     * Provider 工具调用扩展增量（可能只在首个 tool_call 上出现一次）。
+     */
+    extra_content?: ToolCallExtraContent;
+}
+type LlmRequestMessage = AiMessage | {
+    role: 'system' | 'user';
+    content: string;
+} | {
+    role: 'assistant';
+    content: string;
+} | {
+    role: 'assistant';
+    content: string | null;
+    tool_calls: unknown[];
+    reasoning_details?: ProviderReasoningDetails;
+} | {
+    role: 'tool';
+    tool_call_id: string;
+    content: string;
+};
+/**
+ * LLM 流式/非流式的统一响应载荷（caller 内部使用）
+ */
+interface LlmResponseContent {
+    content?: string;
+    tool_calls?: ToolCall[] | ToolCallChunk[];
+    /**
+     * Provider reasoning replay blocks。
+     *
+     * 这些 blocks 是不透明的 provider sidecar：linnkit 只负责保存、绑定到工具调用决策并在
+     * 下一轮回放，具体结构由 adapter/policy 解释。部分 reasoning models 在工具调用后
+     * 要求这些 blocks 原样传回，否则后续请求会被拒绝。
+     */
+    reasoning_details?: ProviderReasoningDetails;
+    /**
+     * 供应商返回的 token 用量（若支持）
+     *
+     * 中文备注：
+     * - 流式场景需配合 `stream_options.include_usage` 才可能拿到；
+     * - 不同 provider 字段可能不同（例如 mock 返回 usage.tokens），上层应做归一化处理。
+     */
+    usage?: unknown;
+}
+interface LlmCallOptions {
+    tools?: unknown[];
+    /**
+     * 工具选择策略（OpenAI tool_choice 兼容）
+     *
+     * 说明：
+     * - 'auto' / 'none'：常见 provider 统一语义；
+     * - {type:'function', function:{name}}：强制调用指定工具（用于步数收尾策略 force_tools 等）。
+     *
+     * 注意：不同 provider 的"强制工具调用"字段名可能不同（例如 Anthropic 为 {type:'tool', name}），
+     * 但在本系统边界内统一使用 OpenAI-compat 形态，由各 adapter 做映射。
+     */
+    tool_choice?: 'auto' | 'none' | {
+        type: 'function';
+        function: {
+            name: string;
+        };
+    };
+    temperature?: number;
+    top_p?: number;
+    max_tokens?: number;
+    /**
+     * 重试策略（仅影响客户端侧 `LlmCaller.callWithRetries`）。
+     *
+     * 背景（中文说明）：
+     * - BYOK（本地直连）模式下，客户端重试是合理的：成本由用户自带 key 承担；
+     * - Cloud（积分计费）模式下，客户端重试会导致"一次点击一个 request_id"的账单语义被破坏，
+     *   因为同一次点击可能触发多次上游调用，造成对账困难或平台资损。
+     *
+     * 约定：
+     * - `client`：允许客户端按本地 retryConfig 重试（默认）；
+     * - `none`：强制不重试（只执行一次，失败直接返回错误）。Cloud 模式推荐使用该值或在模型配置中关闭客户端重试。
+     */
+    retry_policy?: 'client' | 'none';
+    /**
+     * 云端模型限额降级目标（同一个 run 内续跑专用）
+     *
+     * 中文说明：
+     * - 仅当"同一个 run 内已经不是第一次 LLM 调用"时由上层传入；
+     * - 如果本次 LLM 调用因为云端 quota/限额被拒，LlmCaller 会静默切到该模型继续，
+     *   不向前端发 error 事件（前端无感知）；
+     * - 若为 undefined 或空字符串，则 quota 错误仍按"不可重试"处理（即新请求直接报错）。
+     */
+    cloud_quota_fallback_model_id?: string;
+}
+interface LlmRetryConfig {
+    maxRetries: number;
+    enableEmptyResponseRetry: boolean;
+    retryDelayMs: number;
+}
+
+export type { LlmCallOptions as L, ProviderReasoningDetails as P, ToolCall as T, LlmRequestMessage as a, LlmResponseContent as b, LlmRetryConfig as c, ToolCallChunk as d, ToolCallExtraContent as e };

package/dist/audit-BaRUGaqv.d.cts

@@ -0,0 +1,307 @@
+import { z } from 'zod';
+
+declare const AUDIT_ACTIONS: readonly ["model.select", "model.fallback", "tool.allow", "tool.deny", "wait_user.request", "sandbox.decide", "run.cancel", "run.pause", "run.resume", "memory.write"];
+declare const AUDIT_DECISION_OUTCOMES: readonly ["allowed", "denied", "fallback", "retry", "cancelled", "paused", "resumed", "requested", "recorded"];
+declare const AuditActor: z.ZodObject<{
+    kind: z.ZodEnum<["system", "host", "agent", "model", "tool", "user"]>;
+    id: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    kind: "system" | "user" | "tool" | "agent" | "host" | "model";
+    id?: string | undefined;
+    name?: string | undefined;
+}, {
+    kind: "system" | "user" | "tool" | "agent" | "host" | "model";
+    id?: string | undefined;
+    name?: string | undefined;
+}>;
+type AuditActor = z.infer<typeof AuditActor>;
+declare const AuditDecision: z.ZodObject<{
+    outcome: z.ZodEnum<["allowed", "denied", "fallback", "retry", "cancelled", "paused", "resumed", "requested", "recorded"]>;
+    reason: z.ZodOptional<z.ZodString>;
+    policy: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    outcome: "requested" | "allowed" | "denied" | "fallback" | "retry" | "cancelled" | "paused" | "resumed" | "recorded";
+    metadata?: Record<string, unknown> | undefined;
+    reason?: string | undefined;
+    policy?: string | undefined;
+}, {
+    outcome: "requested" | "allowed" | "denied" | "fallback" | "retry" | "cancelled" | "paused" | "resumed" | "recorded";
+    metadata?: Record<string, unknown> | undefined;
+    reason?: string | undefined;
+    policy?: string | undefined;
+}>;
+type AuditDecision = z.infer<typeof AuditDecision>;
+declare const AuditEvidence: z.ZodObject<{
+    kind: z.ZodString;
+    ref: z.ZodOptional<z.ZodString>;
+    summary: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    kind: string;
+    summary?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    ref?: string | undefined;
+}, {
+    kind: string;
+    summary?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    ref?: string | undefined;
+}>;
+type AuditEvidence = z.infer<typeof AuditEvidence>;
+declare const AuditCostDelta: z.ZodObject<{
+    tokensInput: z.ZodOptional<z.ZodNumber>;
+    tokensOutput: z.ZodOptional<z.ZodNumber>;
+    totalCostUsd: z.ZodOptional<z.ZodNumber>;
+    latencyMs: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    tokensInput?: number | undefined;
+    tokensOutput?: number | undefined;
+    totalCostUsd?: number | undefined;
+    latencyMs?: number | undefined;
+}, {
+    tokensInput?: number | undefined;
+    tokensOutput?: number | undefined;
+    totalCostUsd?: number | undefined;
+    latencyMs?: number | undefined;
+}>;
+type AuditCostDelta = z.infer<typeof AuditCostDelta>;
+declare const AuditScope: z.ZodObject<{
+    conversationId: z.ZodOptional<z.ZodString>;
+    runId: z.ZodOptional<z.ZodString>;
+    parentRunId: z.ZodOptional<z.ZodString>;
+    turnId: z.ZodOptional<z.ZodString>;
+    traceId: z.ZodOptional<z.ZodString>;
+    agentSpecId: z.ZodOptional<z.ZodString>;
+    toolCallId: z.ZodOptional<z.ZodString>;
+    toolName: z.ZodOptional<z.ZodString>;
+    modelId: z.ZodOptional<z.ZodString>;
+    nodeId: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    metadata?: Record<string, unknown> | undefined;
+    toolName?: string | undefined;
+    conversationId?: string | undefined;
+    runId?: string | undefined;
+    parentRunId?: string | undefined;
+    turnId?: string | undefined;
+    traceId?: string | undefined;
+    agentSpecId?: string | undefined;
+    toolCallId?: string | undefined;
+    modelId?: string | undefined;
+    nodeId?: string | undefined;
+}, {
+    metadata?: Record<string, unknown> | undefined;
+    toolName?: string | undefined;
+    conversationId?: string | undefined;
+    runId?: string | undefined;
+    parentRunId?: string | undefined;
+    turnId?: string | undefined;
+    traceId?: string | undefined;
+    agentSpecId?: string | undefined;
+    toolCallId?: string | undefined;
+    modelId?: string | undefined;
+    nodeId?: string | undefined;
+}>;
+type AuditScope = z.infer<typeof AuditScope>;
+/**
+ * 标准审计信封。
+ *
+ * 中文备注：
+ * - action 保持 string，以便 host 扩展自己的动作名；
+ * - decision/evidence/costDelta 都是可选事实片段，避免把所有审计场景压成同一种形状；
+ * - envelope 必须追加只读，更新/撤回应追加新的补偿 envelope。
+ */
+declare const AuditEnvelope: z.ZodObject<{
+    envelopeId: z.ZodString;
+    runId: z.ZodString;
+    parentRunId: z.ZodOptional<z.ZodString>;
+    ts: z.ZodNumber;
+    actor: z.ZodObject<{
+        kind: z.ZodEnum<["system", "host", "agent", "model", "tool", "user"]>;
+        id: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "system" | "user" | "tool" | "agent" | "host" | "model";
+        id?: string | undefined;
+        name?: string | undefined;
+    }, {
+        kind: "system" | "user" | "tool" | "agent" | "host" | "model";
+        id?: string | undefined;
+        name?: string | undefined;
+    }>;
+    action: z.ZodString;
+    decision: z.ZodOptional<z.ZodObject<{
+        outcome: z.ZodEnum<["allowed", "denied", "fallback", "retry", "cancelled", "paused", "resumed", "requested", "recorded"]>;
+        reason: z.ZodOptional<z.ZodString>;
+        policy: z.ZodOptional<z.ZodString>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        outcome: "requested" | "allowed" | "denied" | "fallback" | "retry" | "cancelled" | "paused" | "resumed" | "recorded";
+        metadata?: Record<string, unknown> | undefined;
+        reason?: string | undefined;
+        policy?: string | undefined;
+    }, {
+        outcome: "requested" | "allowed" | "denied" | "fallback" | "retry" | "cancelled" | "paused" | "resumed" | "recorded";
+        metadata?: Record<string, unknown> | undefined;
+        reason?: string | undefined;
+        policy?: string | undefined;
+    }>>;
+    evidence: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        ref: z.ZodOptional<z.ZodString>;
+        summary: z.ZodOptional<z.ZodString>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        kind: string;
+        summary?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        ref?: string | undefined;
+    }, {
+        kind: string;
+        summary?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        ref?: string | undefined;
+    }>, "many">>;
+    costDelta: z.ZodOptional<z.ZodObject<{
+        tokensInput: z.ZodOptional<z.ZodNumber>;
+        tokensOutput: z.ZodOptional<z.ZodNumber>;
+        totalCostUsd: z.ZodOptional<z.ZodNumber>;
+        latencyMs: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        tokensInput?: number | undefined;
+        tokensOutput?: number | undefined;
+        totalCostUsd?: number | undefined;
+        latencyMs?: number | undefined;
+    }, {
+        tokensInput?: number | undefined;
+        tokensOutput?: number | undefined;
+        totalCostUsd?: number | undefined;
+        latencyMs?: number | undefined;
+    }>>;
+    scope: z.ZodOptional<z.ZodObject<{
+        conversationId: z.ZodOptional<z.ZodString>;
+        runId: z.ZodOptional<z.ZodString>;
+        parentRunId: z.ZodOptional<z.ZodString>;
+        turnId: z.ZodOptional<z.ZodString>;
+        traceId: z.ZodOptional<z.ZodString>;
+        agentSpecId: z.ZodOptional<z.ZodString>;
+        toolCallId: z.ZodOptional<z.ZodString>;
+        toolName: z.ZodOptional<z.ZodString>;
+        modelId: z.ZodOptional<z.ZodString>;
+        nodeId: z.ZodOptional<z.ZodString>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        metadata?: Record<string, unknown> | undefined;
+        toolName?: string | undefined;
+        conversationId?: string | undefined;
+        runId?: string | undefined;
+        parentRunId?: string | undefined;
+        turnId?: string | undefined;
+        traceId?: string | undefined;
+        agentSpecId?: string | undefined;
+        toolCallId?: string | undefined;
+        modelId?: string | undefined;
+        nodeId?: string | undefined;
+    }, {
+        metadata?: Record<string, unknown> | undefined;
+        toolName?: string | undefined;
+        conversationId?: string | undefined;
+        runId?: string | undefined;
+        parentRunId?: string | undefined;
+        turnId?: string | undefined;
+        traceId?: string | undefined;
+        agentSpecId?: string | undefined;
+        toolCallId?: string | undefined;
+        modelId?: string | undefined;
+        nodeId?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    runId: string;
+    envelopeId: string;
+    ts: number;
+    actor: {
+        kind: "system" | "user" | "tool" | "agent" | "host" | "model";
+        id?: string | undefined;
+        name?: string | undefined;
+    };
+    action: string;
+    parentRunId?: string | undefined;
+    decision?: {
+        outcome: "requested" | "allowed" | "denied" | "fallback" | "retry" | "cancelled" | "paused" | "resumed" | "recorded";
+        metadata?: Record<string, unknown> | undefined;
+        reason?: string | undefined;
+        policy?: string | undefined;
+    } | undefined;
+    evidence?: {
+        kind: string;
+        summary?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        ref?: string | undefined;
+    }[] | undefined;
+    costDelta?: {
+        tokensInput?: number | undefined;
+        tokensOutput?: number | undefined;
+        totalCostUsd?: number | undefined;
+        latencyMs?: number | undefined;
+    } | undefined;
+    scope?: {
+        metadata?: Record<string, unknown> | undefined;
+        toolName?: string | undefined;
+        conversationId?: string | undefined;
+        runId?: string | undefined;
+        parentRunId?: string | undefined;
+        turnId?: string | undefined;
+        traceId?: string | undefined;
+        agentSpecId?: string | undefined;
+        toolCallId?: string | undefined;
+        modelId?: string | undefined;
+        nodeId?: string | undefined;
+    } | undefined;
+}, {
+    runId: string;
+    envelopeId: string;
+    ts: number;
+    actor: {
+        kind: "system" | "user" | "tool" | "agent" | "host" | "model";
+        id?: string | undefined;
+        name?: string | undefined;
+    };
+    action: string;
+    parentRunId?: string | undefined;
+    decision?: {
+        outcome: "requested" | "allowed" | "denied" | "fallback" | "retry" | "cancelled" | "paused" | "resumed" | "recorded";
+        metadata?: Record<string, unknown> | undefined;
+        reason?: string | undefined;
+        policy?: string | undefined;
+    } | undefined;
+    evidence?: {
+        kind: string;
+        summary?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        ref?: string | undefined;
+    }[] | undefined;
+    costDelta?: {
+        tokensInput?: number | undefined;
+        tokensOutput?: number | undefined;
+        totalCostUsd?: number | undefined;
+        latencyMs?: number | undefined;
+    } | undefined;
+    scope?: {
+        metadata?: Record<string, unknown> | undefined;
+        toolName?: string | undefined;
+        conversationId?: string | undefined;
+        runId?: string | undefined;
+        parentRunId?: string | undefined;
+        turnId?: string | undefined;
+        traceId?: string | undefined;
+        agentSpecId?: string | undefined;
+        toolCallId?: string | undefined;
+        modelId?: string | undefined;
+        nodeId?: string | undefined;
+    } | undefined;
+}>;
+type AuditEnvelope = z.infer<typeof AuditEnvelope>;
+
+export { AUDIT_ACTIONS as A, AUDIT_DECISION_OUTCOMES as a, AuditActor as b, AuditCostDelta as c, AuditDecision as d, AuditEnvelope as e, AuditEvidence as f, AuditScope as g };