@linnlabs/linnkit 0.8.0

package/dist/ports-DaatKJXp.d.cts

@@ -0,0 +1,90 @@
+import { O as OpenAIToolSchema, b as ToolParameterSchema, h as ToolDisplayOptions, y as ToolIdempotencyPolicy, a as ToolArgs, T as ToolExecutionContext } from './toolContracts-CLkQmhTG.cjs';
+
+/**
+ * tool schema 生成阶段的最小上下文合同
+ *
+ * 中文备注：
+ * - 这里只承载“生成工具 schema 时需要读到的上下文”；
+ * - 当前已知稳定字段只有 `imageGenerationModelId`；
+ * - 不应把完整 `ToolContext` 透传给 schema generation。
+ */
+interface ToolSchemaContext {
+    imageGenerationModelId?: string;
+    [key: string]: unknown;
+}
+
+interface ConversationArtifactContext {
+    conversationId?: string;
+    conversation_id?: string;
+    sharedMemory?: {
+        instanceId?: string;
+    } | Record<string, unknown>;
+    research?: {
+        instanceId?: string;
+    } | Record<string, unknown>;
+    [key: string]: unknown;
+}
+
+interface ToolRuntimeDefinition {
+    parameters: ToolParameterSchema;
+    displayOptions?: ToolDisplayOptions;
+    idempotency?: ToolIdempotencyPolicy;
+}
+interface ToolExecutionResult {
+    success: boolean;
+    result?: string;
+    error?: string;
+    errorKind?: 'protocol' | 'execution';
+    durationMs: number;
+    idempotency?: {
+        key: string;
+        cacheHit: boolean;
+    };
+}
+interface ObservationPreviewMeta {
+    filename?: string;
+    doc_name?: string;
+    document_name?: string;
+    doc_type?: 'markdown' | 'mindmap';
+}
+type ObservationPreviewContext = ToolExecutionContext & ConversationArtifactContext;
+type ObservationPreviewResult = {
+    truncated: false;
+    preview: string;
+} | {
+    truncated: true;
+    preview: string;
+    blob_id: string;
+};
+interface ToolCatalogPort {
+    getToolSchemas(toolNames?: string[], baseContext?: ToolSchemaContext): OpenAIToolSchema[];
+    getToolDefinition(toolName: string): ToolRuntimeDefinition | undefined;
+}
+interface ToolPresentationPort {
+    getDisplayOptions(toolName: string): ToolDisplayOptions | undefined;
+}
+interface ToolExecutionPort {
+    executeTool(toolName: string, args: ToolArgs, context: ToolExecutionContext): Promise<ToolExecutionResult>;
+}
+interface ObservationPreviewPort {
+    /**
+     * 执行期 observation 预览/落盘治理。
+     *
+     * 中文说明：
+     * - framework 只把 `maxChars/maxLines` 和工具上下文传给 host；
+     * - 完整内容写到本地目录、对象存储还是数据库，由 host 的这个 port 决定；
+     * - 如果返回 `blob_id`，host 需要保证对应读取工具使用同一个 store。
+     */
+    truncateObservation(params: {
+        context: ObservationPreviewContext;
+        toolName: string;
+        text: string;
+        maxChars: number;
+        maxLines: number;
+        meta?: ObservationPreviewMeta;
+    }): Promise<ObservationPreviewResult>;
+}
+interface ToolRuntimePort extends ToolCatalogPort, ToolPresentationPort, ToolExecutionPort {
+}
+
+export type { ConversationArtifactContext as C, ObservationPreviewPort as O, ToolCatalogPort as T, ToolPresentationPort as a, ToolExecutionPort as b, ObservationPreviewContext as c, ObservationPreviewMeta as d, ObservationPreviewResult as e, ToolExecutionResult as f, ToolRuntimeDefinition as g, ToolRuntimePort as h, ToolSchemaContext as i };

package/dist/ports-DnLuKfpE.d.ts

@@ -0,0 +1,90 @@
+import { O as OpenAIToolSchema, b as ToolParameterSchema, h as ToolDisplayOptions, y as ToolIdempotencyPolicy, a as ToolArgs, T as ToolExecutionContext } from './toolContracts-Blll0241.js';
+
+/**
+ * tool schema 生成阶段的最小上下文合同
+ *
+ * 中文备注：
+ * - 这里只承载“生成工具 schema 时需要读到的上下文”；
+ * - 当前已知稳定字段只有 `imageGenerationModelId`；
+ * - 不应把完整 `ToolContext` 透传给 schema generation。
+ */
+interface ToolSchemaContext {
+    imageGenerationModelId?: string;
+    [key: string]: unknown;
+}
+
+interface ConversationArtifactContext {
+    conversationId?: string;
+    conversation_id?: string;
+    sharedMemory?: {
+        instanceId?: string;
+    } | Record<string, unknown>;
+    research?: {
+        instanceId?: string;
+    } | Record<string, unknown>;
+    [key: string]: unknown;
+}
+
+interface ToolRuntimeDefinition {
+    parameters: ToolParameterSchema;
+    displayOptions?: ToolDisplayOptions;
+    idempotency?: ToolIdempotencyPolicy;
+}
+interface ToolExecutionResult {
+    success: boolean;
+    result?: string;
+    error?: string;
+    errorKind?: 'protocol' | 'execution';
+    durationMs: number;
+    idempotency?: {
+        key: string;
+        cacheHit: boolean;
+    };
+}
+interface ObservationPreviewMeta {
+    filename?: string;
+    doc_name?: string;
+    document_name?: string;
+    doc_type?: 'markdown' | 'mindmap';
+}
+type ObservationPreviewContext = ToolExecutionContext & ConversationArtifactContext;
+type ObservationPreviewResult = {
+    truncated: false;
+    preview: string;
+} | {
+    truncated: true;
+    preview: string;
+    blob_id: string;
+};
+interface ToolCatalogPort {
+    getToolSchemas(toolNames?: string[], baseContext?: ToolSchemaContext): OpenAIToolSchema[];
+    getToolDefinition(toolName: string): ToolRuntimeDefinition | undefined;
+}
+interface ToolPresentationPort {
+    getDisplayOptions(toolName: string): ToolDisplayOptions | undefined;
+}
+interface ToolExecutionPort {
+    executeTool(toolName: string, args: ToolArgs, context: ToolExecutionContext): Promise<ToolExecutionResult>;
+}
+interface ObservationPreviewPort {
+    /**
+     * 执行期 observation 预览/落盘治理。
+     *
+     * 中文说明：
+     * - framework 只把 `maxChars/maxLines` 和工具上下文传给 host；
+     * - 完整内容写到本地目录、对象存储还是数据库，由 host 的这个 port 决定；
+     * - 如果返回 `blob_id`，host 需要保证对应读取工具使用同一个 store。
+     */
+    truncateObservation(params: {
+        context: ObservationPreviewContext;
+        toolName: string;
+        text: string;
+        maxChars: number;
+        maxLines: number;
+        meta?: ObservationPreviewMeta;
+    }): Promise<ObservationPreviewResult>;
+}
+interface ToolRuntimePort extends ToolCatalogPort, ToolPresentationPort, ToolExecutionPort {
+}
+
+export type { ConversationArtifactContext as C, ObservationPreviewPort as O, ToolCatalogPort as T, ToolPresentationPort as a, ToolExecutionPort as b, ObservationPreviewContext as c, ObservationPreviewMeta as d, ObservationPreviewResult as e, ToolExecutionResult as f, ToolRuntimeDefinition as g, ToolRuntimePort as h, ToolSchemaContext as i };

package/dist/ports.cjs

@@ -0,0 +1,4 @@
+'use strict';
+
+//# sourceMappingURL=ports.cjs.map
+//# sourceMappingURL=ports.cjs.map

package/dist/ports.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"ports.cjs"}

package/dist/ports.d.cts

@@ -0,0 +1,7 @@
+export { A as AgentInvocationRequest } from './agent-invocation-BHcNfrBV.cjs';
+export { A as AgentAiEngine, a as AgentAiEngineStreamContent, b as AuditPort } from './audit-LeOrm2hX.cjs';
+export { T as TokenizerPort } from './tokenizer-DH_JXv-H.cjs';
+export { L as LlmCallOptions, a as LlmRequestMessage, b as LlmResponseContent, c as LlmRetryConfig, P as ProviderReasoningDetails, T as ToolCall, d as ToolCallChunk, e as ToolCallExtraContent } from './ai-engine.types-BpeU_XQG.cjs';
+import './messages-XthmnHZ3.cjs';
+import 'zod';
+import './audit-BaRUGaqv.cjs';

package/dist/ports.d.ts

@@ -0,0 +1,7 @@
+export { A as AgentInvocationRequest } from './agent-invocation-BznDaXDs.js';
+export { A as AgentAiEngine, a as AgentAiEngineStreamContent, b as AuditPort } from './audit-CtcfART1.js';
+export { T as TokenizerPort } from './tokenizer-DFL4I7-I.js';
+export { L as LlmCallOptions, a as LlmRequestMessage, b as LlmResponseContent, c as LlmRetryConfig, P as ProviderReasoningDetails, T as ToolCall, d as ToolCallChunk, e as ToolCallExtraContent } from './ai-engine.types-vZRnQcJa.js';
+import './messages-XthmnHZ3.js';
+import 'zod';
+import './audit-BaRUGaqv.js';

package/dist/ports.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=ports.js.map
+//# sourceMappingURL=ports.js.map

package/dist/ports.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"ports.js"}