engineering-behavior-observatory 0.2.1

package/dist/src/deepseek-adapter.d.ts

@@ -0,0 +1,152 @@
+import { type ContentBlock } from "@deepseek-ai/dsh-sdk-client";
+import type { InitializeResult } from "@deepseek-ai/dsh-sdk-protocol";
+import type { HarnessExecutionContext, HarnessExecutionResult } from "./lifecycle.js";
+import type { AdapterCapabilityProfile, HarnessAdapter, NormalizationResult, QualifiedNativeCapture } from "./uniform-events.js";
+export declare const DEEPSEEK_SDK_VERSION = "0.1.1-rc.2";
+export declare const DEEPSEEK_ADAPTER_ID = "deepseek-harness-sdk";
+export declare const DEEPSEEK_HARNESS_ID = "deepseek-harness";
+type DigestString = `sha256:${string}`;
+export type DeepSeekFileReference = {
+    locator: string;
+    digest: DigestString;
+};
+export type DeepSeekRuntimeComposition = {
+    schemaVersion: "ebo.deepseek-runtime-composition/v1";
+    id: string;
+    launch: {
+        command: string;
+        args: string[];
+        processCwd: string;
+        profile: string;
+        dshHome?: string;
+        runtimeArtifact: DeepSeekFileReference;
+    };
+    workspaceCwd: string;
+    runtime: {
+        clientPackage: "@deepseek-ai/dsh-sdk-client";
+        clientVersion: string;
+        protocolPackage: "@deepseek-ai/dsh-sdk-protocol";
+        protocolVersion: string;
+    };
+    route: {
+        provider: string;
+        model: string;
+        maxTokens?: number;
+    };
+    cordis: DeepSeekFileReference;
+    patches: DeepSeekFileReference[];
+    plugins: Array<{
+        name: string;
+        configuration?: DeepSeekFileReference;
+    }>;
+    environment: {
+        mode: "replace";
+        allowedKeys: string[];
+        secretKeys: string[];
+    };
+    telemetry: {
+        status: "enabled" | "disabled";
+        nativeSpans: "available" | "unsupported" | "not-checked";
+        artifact?: DeepSeekFileReference;
+    };
+};
+export type DeepSeekRuntimeCompositionInput = {
+    id: string;
+    baseDir: string;
+    dshBin: string;
+    profile: string;
+    cordisPath: string;
+    patches?: readonly string[];
+    processCwd: string;
+    workspaceCwd: string;
+    dshHome?: string;
+    provider: string;
+    model: string;
+    maxTokens?: number;
+    plugins: ReadonlyArray<{
+        name: string;
+        configurationPath?: string;
+    }>;
+    environment: {
+        allowedKeys: readonly string[];
+        secretKeys: readonly string[];
+    };
+    telemetry: {
+        status: "enabled" | "disabled";
+        nativeSpans: "available" | "unsupported" | "not-checked";
+        artifactPath?: string;
+    };
+};
+export type DeepSeekCapabilities = {
+    protocolVersionNegotiation: "unsupported";
+    promptCancellation: "unsupported";
+    sessionClose: "unsupported";
+    promptResult: "unsupported";
+    sessionEvents: "available";
+    sessionStatus: "available";
+    subagentNotifications: "available";
+    telemetry: "available" | "unsupported";
+    nativeSpans: "available" | "unsupported" | "not-checked";
+    completionEvidence: "agent/inbox/spliced-to-session.status:idle";
+};
+export type DeepSeekNativeObservation = {
+    schemaVersion: "ebo.deepseek-native-observation/v1";
+    sequence: number;
+    observedAt: string;
+    kind: "composition" | "capability" | "request" | "response" | "notification" | "diagnostic" | "error";
+    method?: string;
+    sessionId?: string;
+    sourceIdentity?: string;
+    stream?: "stderr";
+    payload?: unknown;
+};
+export type DeepSeekCaptureReport = {
+    status: "completed" | "failed" | "stopped" | "interrupted";
+    composition: DeepSeekRuntimeComposition;
+    capabilities: DeepSeekCapabilities;
+    records: readonly DeepSeekNativeObservation[];
+    serverInfo?: InitializeResult["serverInfo"];
+    messageId?: string;
+    receiptSequence?: number;
+    idleSequence?: number;
+    relatedSessionIds: readonly string[];
+    error?: string;
+    captureError?: string;
+    stderr?: string;
+};
+export type DeepSeekHarnessConfiguration = {
+    composition: DeepSeekRuntimeComposition;
+    input: string | ContentBlock[];
+    sessionId: string;
+    env: NodeJS.ProcessEnv;
+    requestTimeoutMs?: number;
+    activityTimeoutMs?: number;
+    shutdownTimeoutMs?: number;
+    disposeEofGraceMs?: number;
+    disposeGraceMs?: number;
+};
+export type DeepSeekAdapterRequest = {
+    context: HarnessExecutionContext;
+    configuration: DeepSeekHarnessConfiguration;
+    capture: DeepSeekNativeCapture;
+};
+export declare class DeepSeekNativeCapture {
+    #private;
+    readonly path: string;
+    constructor(path: string);
+    record(input: Omit<DeepSeekNativeObservation, "schemaVersion" | "sequence" | "observedAt">): Promise<DeepSeekNativeObservation>;
+    report(): readonly DeepSeekNativeObservation[];
+    flush(): Promise<void>;
+    close(): Promise<void>;
+}
+export declare function createDeepSeekRuntimeComposition(input: DeepSeekRuntimeCompositionInput): DeepSeekRuntimeComposition;
+export declare function deepSeekCompositionDigest(composition: DeepSeekRuntimeComposition): DigestString;
+export declare function deepSeekCapabilities(composition: DeepSeekRuntimeComposition): DeepSeekCapabilities;
+export declare function executeDeepSeekHarness(context: HarnessExecutionContext, configuration: DeepSeekHarnessConfiguration, capture: DeepSeekNativeCapture): Promise<HarnessExecutionResult>;
+export declare function qualifiedDeepSeekCapture(runId: string, attemptId: string, report: DeepSeekCaptureReport, artifactId?: string): QualifiedNativeCapture<DeepSeekNativeObservation>;
+/** Reapply the native lifecycle gate while preserving retained physical JSONL locators. */
+export declare function qualifyRetainedDeepSeekCapture(input: QualifiedNativeCapture<DeepSeekNativeObservation>, sessionId: string | undefined, completed: boolean): QualifiedNativeCapture<DeepSeekNativeObservation>;
+export declare const DEEPSEEK_CAPABILITY_PROFILE: AdapterCapabilityProfile;
+export declare function normalizeDeepSeekCapture(input: QualifiedNativeCapture<DeepSeekNativeObservation>): NormalizationResult;
+export declare function createDeepSeekHarnessAdapter(): HarnessAdapter<DeepSeekAdapterRequest, DeepSeekNativeObservation>;
+export {};