newmark-agent 0.3.11 → 0.4.0

package/dist/core/dshCompatibility.d.ts

@@ -0,0 +1,198 @@
+export interface DshCompatibilityOptions {
+    env?: NodeJS.ProcessEnv;
+    homeDir?: string;
+    pathValue?: string;
+    platform?: NodeJS.Platform;
+}
+export interface DshMcpTemplate {
+    name: string;
+    enabled: false;
+    transport: 'stdio' | 'http';
+    command?: string;
+    args?: string[];
+    cwd?: string;
+    url?: string;
+}
+export interface DshMcpCandidate {
+    name: string;
+    source: string;
+    importable: boolean;
+    reason?: string;
+    envKeys: string[];
+    headerKeys: string[];
+    template?: DshMcpTemplate;
+}
+export interface DshConfigLayer {
+    kind: 'bundle' | 'profile' | 'home';
+    name: string;
+    path: string;
+    order: number;
+}
+export interface DshBundleSnapshot {
+    name: string;
+    version?: string;
+    source: string;
+    manifestPath: string;
+    patch?: string;
+    patchPath?: string;
+    patchExists: boolean;
+    unknownKeys: string[];
+    resolved: boolean;
+}
+export interface DshProfileSnapshot {
+    name: string;
+    source: string;
+    manifestPath: string;
+    bundles: string[];
+    unsupportedBundleEntries: number;
+    configFiles: string[];
+    layers: DshConfigLayer[];
+    unknownKeys: string[];
+}
+/**
+ * DSH dsh-compaction-basic 运行时 seam 到 Newmark 压缩系统的语义映射(纯元数据)。
+ * Newmark 落地为运行时等价物，而非复制 DSH 代码；DSH 发现层永不 import/execute 插件主模块。
+ */
+export interface DshCompactionRuntimeSemantics {
+    plugin: '@deepseek-ai/dsh-compaction-basic';
+    execution: 'native-equivalent';
+    seams: {
+        apply: {
+            dsh: string;
+            newmark: string;
+            description: string;
+        };
+        summarize: {
+            dsh: string;
+            newmark: string;
+            description: string;
+        };
+        compactIfNeeded: {
+            dsh: string;
+            newmark: string;
+            description: string;
+        };
+        compactNow: {
+            dsh: string;
+            newmark: string;
+            description: string;
+        };
+    };
+    budget: {
+        buildBlockTriggerRatio: 0.70;
+        longHistoryTriggerRatio: 0.20;
+        buildRetainRatio: 0.16;
+        longHistoryRetainRatio: 0.05;
+        newmarkSource: string;
+    };
+    cacheReuse: {
+        dshStrategy: string;
+        newmarkEquivalent: string;
+        note: string;
+    };
+    /** DSH toolResultPruner 的 Newmark 落地（压缩前裁剪大工具结果）。 */
+    toolPruning: {
+        dsh: string;
+        newmark: string;
+        thresholdChars: number;
+    };
+}
+/**
+ * DSH 工具层运行时语义映射（纯元数据，永不执行 DSH 插件代码）。
+ * 覆盖 DSH 的 ToolRuntime / defineTool / 工具呈现与并发分级语义，映射到
+ * Newmark 原生工具执行层。DSH 是 developer preview，schema 可能不兼容变更，
+ * 映射层 fail-soft：未识别字段保留为元数据、降级 opaque，不抛错不改写外部文件。
+ */
+export interface DshToolLayerRuntimeSemantics {
+    plugin: '@deepseek-ai/dsh-tools';
+    execution: 'native-equivalent';
+    seams: {
+        register: {
+            dsh: string;
+            newmark: string;
+            description: string;
+        };
+        concurrency: {
+            dsh: string;
+            newmark: string;
+            description: string;
+        };
+        presentation: {
+            dsh: string;
+            newmark: string;
+            description: string;
+        };
+        pluginDiscovery: {
+            dsh: string;
+            newmark: string;
+            description: string;
+        };
+    };
+    breakingChangeCompat: {
+        strategy: string;
+        mechanisms: string[];
+        boundary: string;
+    };
+}
+export interface DshCompatibilitySnapshot {
+    id: 'deepseek-harness';
+    displayName: 'DeepSeek Harness (DSH)';
+    developerPreview: true;
+    detected: boolean;
+    readOnly: true;
+    preservesUnknownFields: true;
+    dshHome: string;
+    home: {
+        path: string;
+        source: 'DSH_HOME' | 'default';
+        exists: boolean;
+    };
+    cli: {
+        command: 'dsh';
+        available: boolean;
+        path?: string;
+        version?: string;
+        packageVersion?: string;
+    };
+    package: {
+        name: '@deepseek-ai/dsh';
+        version?: string;
+        manifestPath?: string;
+    };
+    update: {
+        package: '@deepseek-ai/dsh';
+        channel: 'latest';
+        locked: false;
+        runCommand: 'npx @deepseek-ai/dsh web';
+        pluginCommand: 'dsh plugin --profile <name> add <package>';
+        repository: string;
+        documentation: string;
+        npm: string;
+    };
+    recognizedManifestKeys: ['dsh.bundle.patch', 'dsh.profile.bundles'];
+    profiles: DshProfileSnapshot[];
+    bundles: DshBundleSnapshot[];
+    mcpCandidates: DshMcpCandidate[];
+    configFiles: string[];
+    homeConfigFiles: string[];
+    unknownKeys: string[];
+    warnings: string[];
+    scannedAt: string;
+    compaction: DshCompactionRuntimeSemantics;
+    toolLayer: DshToolLayerRuntimeSemantics;
+}
+export declare function discoverDshCompatibility(root: string, options?: DshCompatibilityOptions): DshCompatibilitySnapshot;
+/**
+ * DSH dsh-compaction-basic 运行时 seam 到 Newmark 压缩系统的语义映射。
+ * 纯只读元数据：描述 DSH 各运行时入口如何映射到 Newmark 的原生等价实现，
+ * 既不 import 也不 execute 任何 DSH 插件代码。
+ */
+export declare function dshCompactionRuntimeSemantics(): DshCompactionRuntimeSemantics;
+/**
+ * DSH 工具层的运行时语义映射（纯只读元数据）。
+ * 描述 DSH 工具层各 seam 如何映射到 Newmark 原生工具执行层，并声明破坏性
+ * developer-preview schema 更新的 fail-soft 兼容策略。既不 import 也不 execute
+ * 任何 DSH 插件代码。
+ */
+export declare function dshToolLayerRuntimeSemantics(): DshToolLayerRuntimeSemantics;
+//# sourceMappingURL=dshCompatibility.d.ts.map