@linnlabs/linnkit 0.8.0

package/dist/audit-BaRUGaqv.d.ts

@@ -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 };

package/dist/audit-CtcfART1.d.ts

@@ -0,0 +1,33 @@
+import { a as LlmRequestMessage, L as LlmCallOptions, d as ToolCallChunk, P as ProviderReasoningDetails } from './ai-engine.types-vZRnQcJa.js';
+import { e as AuditEnvelope } from './audit-BaRUGaqv.js';
+
+type AgentAiEngineStreamContent = string | {
+    content?: string;
+    tool_calls?: ToolCallChunk[];
+    reasoning_details?: ProviderReasoningDetails;
+};
+interface AgentAiEngine {
+    chatCompletion(modelId: string, messages: LlmRequestMessage[], options?: LlmCallOptions & {
+        signal?: AbortSignal;
+    }): Promise<unknown>;
+    chatCompletionStream(modelId: string, messages: LlmRequestMessage[], options?: LlmCallOptions & {
+        signal?: AbortSignal;
+        stream_options?: {
+            include_usage?: boolean;
+        };
+    }, onContent?: (content: AgentAiEngineStreamContent) => void, onError?: (error: Error) => void, onFinish?: (reason: string) => void, onThought?: (thought: string) => void, onUsage?: (usage: unknown) => void): Promise<void>;
+}
+
+/**
+ * 审计事件输出端口。
+ *
+ * 中文备注：
+ * - emit 允许同步或异步实现；framework 调用方需要 await，避免 file sink 未写完；
+ * - envelope 是追加只读事实，不提供 update/delete。
+ */
+interface AuditPort {
+    emit(envelope: AuditEnvelope): void | Promise<void>;
+    flush?(): void | Promise<void>;
+}
+
+export type { AgentAiEngine as A, AgentAiEngineStreamContent as a, AuditPort as b };

package/dist/audit-LeOrm2hX.d.cts

@@ -0,0 +1,33 @@
+import { a as LlmRequestMessage, L as LlmCallOptions, d as ToolCallChunk, P as ProviderReasoningDetails } from './ai-engine.types-BpeU_XQG.cjs';
+import { e as AuditEnvelope } from './audit-BaRUGaqv.cjs';
+
+type AgentAiEngineStreamContent = string | {
+    content?: string;
+    tool_calls?: ToolCallChunk[];
+    reasoning_details?: ProviderReasoningDetails;
+};
+interface AgentAiEngine {
+    chatCompletion(modelId: string, messages: LlmRequestMessage[], options?: LlmCallOptions & {
+        signal?: AbortSignal;
+    }): Promise<unknown>;
+    chatCompletionStream(modelId: string, messages: LlmRequestMessage[], options?: LlmCallOptions & {
+        signal?: AbortSignal;
+        stream_options?: {
+            include_usage?: boolean;
+        };
+    }, onContent?: (content: AgentAiEngineStreamContent) => void, onError?: (error: Error) => void, onFinish?: (reason: string) => void, onThought?: (thought: string) => void, onUsage?: (usage: unknown) => void): Promise<void>;
+}
+
+/**
+ * 审计事件输出端口。
+ *
+ * 中文备注：
+ * - emit 允许同步或异步实现；framework 调用方需要 await，避免 file sink 未写完；
+ * - envelope 是追加只读事实，不提供 update/delete。
+ */
+interface AuditPort {
+    emit(envelope: AuditEnvelope): void | Promise<void>;
+    flush?(): void | Promise<void>;
+}
+
+export type { AgentAiEngine as A, AgentAiEngineStreamContent as a, AuditPort as b };

package/dist/checkpointMarker-DAI3wUQu.d.cts

@@ -0,0 +1,8 @@
+/**
+ * @file shared/checkpointMarker.ts
+ * @description 上下文 checkpoint 的跨模块共享协议常量。
+ */
+declare const CHECKPOINT_MARKER_TYPE: "context_checkpoint";
+declare const DEFAULT_CONTEXT_CHECKPOINT_TOOL_NAME: "context_checkpoint";
+
+export { CHECKPOINT_MARKER_TYPE as C, DEFAULT_CONTEXT_CHECKPOINT_TOOL_NAME as D };

package/dist/checkpointMarker-DAI3wUQu.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @file shared/checkpointMarker.ts
+ * @description 上下文 checkpoint 的跨模块共享协议常量。
+ */
+declare const CHECKPOINT_MARKER_TYPE: "context_checkpoint";
+declare const DEFAULT_CONTEXT_CHECKPOINT_TOOL_NAME: "context_checkpoint";
+
+export { CHECKPOINT_MARKER_TYPE as C, DEFAULT_CONTEXT_CHECKPOINT_TOOL_NAME as D };