@linnlabs/linnkit 0.8.0

package/dist/index.d.cts

@@ -0,0 +1,89 @@
+export { i as ports } from './index-Cvr23YCl.cjs';
+export { i as runtimeKernel } from './index-Cm-JbzTH.cjs';
+export { i as contracts } from './index-Dl5PLgAv.cjs';
+export { D as DefineAgentInput, a as DefinedAgent, L as LinnkitQuickstartConfig, R as RunAgentOptions, b as RunAgentResult, d as defineAgent, c as defineConfig, r as resolveConfiguredLlm, e as runAgent } from './runAgent-HYKlXbVr.cjs';
+export { L as LlmCallTelemetry, w as withLLMTelemetryContext } from './defaultGraphExecutor-BIjJj7WF.cjs';
+import './agent-invocation-BHcNfrBV.cjs';
+import './messages-XthmnHZ3.cjs';
+import 'zod';
+import './audit-LeOrm2hX.cjs';
+import './ai-engine.types-BpeU_XQG.cjs';
+import './audit-BaRUGaqv.cjs';
+import './tokenizer-DH_JXv-H.cjs';
+import './ports-DaatKJXp.cjs';
+import './toolContracts-CLkQmhTG.cjs';
+import './todo-B1PmDlp3.cjs';
+import './agentEvents-DEB7Fy_J.cjs';
+import './runHandle-D3gPsD7B.cjs';
+import './agentSpec-EkmviZjy.cjs';
+import './execution-CAIypb41.cjs';
+import './checkpointMarker-DAI3wUQu.cjs';
+import './index-DO4dQgf2.cjs';
+import './sse-vPyrOPa0.cjs';
+
+/**
+ * Isomorphic ID generators.
+ *
+ * 设计约束：
+ * - linnkit 是同构 package（既会被 Node-side host 使用，也会被前端 renderer 通过
+ *   `linnkit/runtime-kernel/events` 等子入口透传 transitive import 拖入 bundle）。
+ * - 因此本文件不允许 `import { randomUUID } from 'crypto'`：那会触发 vite
+ *   `__vite-browser-external` shim，构建时 named import 解析失败。
+ * - 改用 Web Crypto API（`globalThis.crypto.randomUUID`），它在所有现代浏览器
+ *   与 Node 19+ 上都内置；老 Node 也可通过 `globalThis.crypto.randomUUID` 访问
+ *   （Node 14.17+ 在 `node:crypto` 暴露了 `webcrypto`，并自 19 起把 `crypto`
+ *   挂到 globalThis）。
+ * - 极端 fallback：若运行环境同时缺 Web Crypto，则降级为 Math.random RFC4122 v4
+ *   生成器；这些 ID 仅用于会话/消息/run/exec/trace 内部去重展示，不承担加密
+ *   强度要求，降级在语义上是安全的。
+ */
+declare function generateMessageId(): string;
+declare function generateRunId(): string;
+declare function generateAuditEnvelopeId(): string;
+declare function generateAuditEnvelopeEventId(): string;
+
+/**
+ * @file src/agent/shared/llmAuditRecorder.ts
+ *
+ * @description
+ * Agent runtime 对 LLM 审计的最小记录协议。
+ *
+ * 说明：
+ * - runtime-kernel 只需要“记录”审计片段；
+ * - AsyncLocalStorage、落盘、Documents 路径等都属于宿主实现，不应反向依赖到 agent package。
+ */
+interface ContextManagerAuditRecordInput {
+    mode: 'agent' | 'chat';
+    payload?: unknown;
+    llmMessages?: unknown[];
+    toolNames?: string[];
+    systemReminder?: {
+        ruleIds?: string[];
+    };
+    contextTrace?: unknown;
+}
+interface ToolProtocolErrorAuditInput {
+    mode: 'agent' | 'chat';
+    toolName: string;
+    toolCallId?: string;
+    rawArguments?: string;
+    parsedArguments?: Record<string, unknown>;
+    error: string;
+}
+interface RunTranscriptAuditInput {
+    mode: 'agent' | 'chat';
+    transcriptMessages: unknown[];
+    toolset?: {
+        availableTools?: string[];
+    };
+}
+interface LlmAuditRecorder {
+    recordBeforeContextManager?(params: ContextManagerAuditRecordInput): void;
+    recordAfterContextManager?(params: ContextManagerAuditRecordInput): void;
+    recordAfterContextManagerOnSystemReminderHit?(params: ContextManagerAuditRecordInput): void;
+    recordToolProtocolError?(params: ToolProtocolErrorAuditInput): void;
+    recordRunTranscript?(params: RunTranscriptAuditInput): void;
+}
+declare function setLlmAuditRecorder(next: LlmAuditRecorder | null): void;
+
+export { type ContextManagerAuditRecordInput, type LlmAuditRecorder, type RunTranscriptAuditInput, type ToolProtocolErrorAuditInput, generateAuditEnvelopeEventId, generateAuditEnvelopeId, generateMessageId, generateRunId, setLlmAuditRecorder };

package/dist/index.d.ts

@@ -0,0 +1,89 @@
+export { i as ports } from './index-DDzuSb0n.js';
+export { i as runtimeKernel } from './index-DRBWi1fy.js';
+export { i as contracts } from './index-CHqwkvGp.js';
+export { D as DefineAgentInput, a as DefinedAgent, L as LinnkitQuickstartConfig, R as RunAgentOptions, b as RunAgentResult, d as defineAgent, c as defineConfig, r as resolveConfiguredLlm, e as runAgent } from './runAgent-CPj_9e58.js';
+export { L as LlmCallTelemetry, w as withLLMTelemetryContext } from './defaultGraphExecutor-BBswR8wn.js';
+import './agent-invocation-BznDaXDs.js';
+import './messages-XthmnHZ3.js';
+import 'zod';
+import './audit-CtcfART1.js';
+import './ai-engine.types-vZRnQcJa.js';
+import './audit-BaRUGaqv.js';
+import './tokenizer-DFL4I7-I.js';
+import './ports-DnLuKfpE.js';
+import './toolContracts-Blll0241.js';
+import './todo-B1PmDlp3.js';
+import './agentEvents-DEB7Fy_J.js';
+import './runHandle-CyXvzgzk.js';
+import './agentSpec-EkmviZjy.js';
+import './execution-CAIypb41.js';
+import './checkpointMarker-DAI3wUQu.js';
+import './index-CJeWHopy.js';
+import './sse-vPyrOPa0.js';
+
+/**
+ * Isomorphic ID generators.
+ *
+ * 设计约束：
+ * - linnkit 是同构 package（既会被 Node-side host 使用，也会被前端 renderer 通过
+ *   `linnkit/runtime-kernel/events` 等子入口透传 transitive import 拖入 bundle）。
+ * - 因此本文件不允许 `import { randomUUID } from 'crypto'`：那会触发 vite
+ *   `__vite-browser-external` shim，构建时 named import 解析失败。
+ * - 改用 Web Crypto API（`globalThis.crypto.randomUUID`），它在所有现代浏览器
+ *   与 Node 19+ 上都内置；老 Node 也可通过 `globalThis.crypto.randomUUID` 访问
+ *   （Node 14.17+ 在 `node:crypto` 暴露了 `webcrypto`，并自 19 起把 `crypto`
+ *   挂到 globalThis）。
+ * - 极端 fallback：若运行环境同时缺 Web Crypto，则降级为 Math.random RFC4122 v4
+ *   生成器；这些 ID 仅用于会话/消息/run/exec/trace 内部去重展示，不承担加密
+ *   强度要求，降级在语义上是安全的。
+ */
+declare function generateMessageId(): string;
+declare function generateRunId(): string;
+declare function generateAuditEnvelopeId(): string;
+declare function generateAuditEnvelopeEventId(): string;
+
+/**
+ * @file src/agent/shared/llmAuditRecorder.ts
+ *
+ * @description
+ * Agent runtime 对 LLM 审计的最小记录协议。
+ *
+ * 说明：
+ * - runtime-kernel 只需要“记录”审计片段；
+ * - AsyncLocalStorage、落盘、Documents 路径等都属于宿主实现，不应反向依赖到 agent package。
+ */
+interface ContextManagerAuditRecordInput {
+    mode: 'agent' | 'chat';
+    payload?: unknown;
+    llmMessages?: unknown[];
+    toolNames?: string[];
+    systemReminder?: {
+        ruleIds?: string[];
+    };
+    contextTrace?: unknown;
+}
+interface ToolProtocolErrorAuditInput {
+    mode: 'agent' | 'chat';
+    toolName: string;
+    toolCallId?: string;
+    rawArguments?: string;
+    parsedArguments?: Record<string, unknown>;
+    error: string;
+}
+interface RunTranscriptAuditInput {
+    mode: 'agent' | 'chat';
+    transcriptMessages: unknown[];
+    toolset?: {
+        availableTools?: string[];
+    };
+}
+interface LlmAuditRecorder {
+    recordBeforeContextManager?(params: ContextManagerAuditRecordInput): void;
+    recordAfterContextManager?(params: ContextManagerAuditRecordInput): void;
+    recordAfterContextManagerOnSystemReminderHit?(params: ContextManagerAuditRecordInput): void;
+    recordToolProtocolError?(params: ToolProtocolErrorAuditInput): void;
+    recordRunTranscript?(params: RunTranscriptAuditInput): void;
+}
+declare function setLlmAuditRecorder(next: LlmAuditRecorder | null): void;
+
+export { type ContextManagerAuditRecordInput, type LlmAuditRecorder, type RunTranscriptAuditInput, type ToolProtocolErrorAuditInput, generateAuditEnvelopeEventId, generateAuditEnvelopeId, generateMessageId, generateRunId, setLlmAuditRecorder };