@sqdr2/dsh-fusion 0.0.0-stage → 0.3.0

package/lib/types/activity.d.ts

@@ -0,0 +1,20 @@
+import type { SessionEvent } from '@deepseek-ai/dsh-session/types';
+/** Plugin-owned presentation record; never appended to a native Session. */
+export interface FusionActivity {
+    schemaVersion: 1;
+    taskId: string;
+    childSessionId: string;
+    parentCallId: string;
+    turn: number;
+    step: number;
+    anchorSeq: number;
+    source: SessionEvent<'tool/call'> | SessionEvent<'tool/result'>;
+}
+/** Namespaced display identity; the unchanged native identity remains in source. */
+export declare function activityCallId(activity: FusionActivity): string;
+export interface FusionActivityPage {
+    events: FusionActivity[];
+    cursor: number;
+    more: boolean;
+    done: boolean;
+}

package/lib/types/approval/logical.d.ts

@@ -0,0 +1,10 @@
+import type { Digest, LogicalApproval, SnapshotId } from '../contracts.js';
+export interface ApprovalScope {
+    argsDigest: Digest;
+    snapshot: SnapshotId;
+    permissionPolicyDigest: Digest;
+}
+export declare function answerApproval(approval: LogicalApproval, state: 'approved' | 'rejected' | 'withdrawn', decisionBy?: 'human' | 'preauthorized-policy'): LogicalApproval;
+export declare function consumeApproval(approval: LogicalApproval, scope: ApprovalScope): LogicalApproval;
+export declare function neverMeansDeny(policy: string): boolean;
+export declare function pendingDoesNotExpire(_approval: LogicalApproval, _nowMs: number): true;

package/lib/types/benchmark/naive.d.ts

@@ -0,0 +1,37 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { Agent } from '@deepseek-ai/dsh-agent';
+import type { PairProfile } from '../contracts.js';
+import type { SqliteFusionStore } from '../task/sqlite-store.js';
+/** A declared benchmark treatment, never installed in product sessions. */
+export declare const naivePrompts: {
+    lead: string;
+    worker: string;
+};
+export interface NaiveDelegation {
+    ordinal: number;
+    callId: string;
+    briefDigest: string;
+    startedAt: string;
+    endedAt: string | null;
+    childSessionId: string | null;
+    parentSessionId: string;
+    state: 'starting' | 'running' | 'settled' | 'failed';
+    stopReason: string | null;
+    disposed: boolean;
+    failure: string | null;
+}
+/** Simple sequential coordinator using the native single-activation child lifecycle. */
+export declare class NaiveCoordinator {
+    #private;
+    readonly ctx: Context;
+    readonly parent: Agent;
+    readonly store: SqliteFusionStore;
+    readonly profile: PairProfile;
+    readonly workerMaxTokens: number;
+    readonly tools: readonly string[];
+    readonly delegations: NaiveDelegation[];
+    constructor(ctx: Context, parent: Agent, store: SqliteFusionStore, profile: PairProfile, workerMaxTokens: number, tools?: readonly string[]);
+    owns(agent: Agent): boolean;
+    assertReady(): void;
+    close(): Promise<void>;
+}

package/lib/types/benchmark/native-run.d.ts

@@ -0,0 +1,68 @@
+import type { Context } from '@deepseek-ai/cordis';
+import { SessionId } from '@deepseek-ai/dsh-session';
+import { TaskId } from '../contracts.js';
+import { NativeRequestBudget } from '../host/native-budget.js';
+import type { NativeUsageRecord } from '../host/native-usage.js';
+import type { ResolvedProfile } from '../profile/resolve.js';
+import { type BenchmarkOutputLimits } from './output-limits.js';
+export interface NativeBenchmarkOptions {
+    runId: string;
+    variant: 'lead_only' | 'worker_only' | 'worker_selfreview' | 'naive' | 'fusion';
+    dataKind: 'real' | 'synthetic';
+    /** Version read by the trusted launcher from the loaded artifact's metadata. */
+    engineVersion?: string;
+    workspace: string;
+    /** Fresh directory, outside the candidate's filesystem. Never reused. */
+    output: string;
+    prompt: string;
+    profile: ResolvedProfile;
+    /** Required for real runs: exact public model limits frozen before the attempt. */
+    outputLimits?: BenchmarkOutputLimits;
+    /** One campaign-wide ledger, so attempts cannot reset the approved limit. */
+    budget: NativeRequestBudget;
+    maxRequests: number;
+    timeoutMs: number;
+}
+/**
+ * Run one fresh attempt through the same native AgentLoop and FusionCoordinator
+ * as the product. The caller composes public Host services and a sandboxed shell;
+ * this function does not implement another LLM/tool loop or grade candidate code.
+ */
+export declare function runNativeBenchmark(ctx: Context, options: NativeBenchmarkOptions): Promise<{
+    status: string;
+    failure: string | null;
+    endReason: import("@deepseek-ai/dsh-session").TurnEndReason | null;
+    phases: {
+        stage: "implementation" | "self_review";
+        completed: boolean;
+        nativeRequests: number;
+        endReason: unknown;
+    }[];
+    deliveredSnapshot: import("../host/workspace.js").WorkspaceSnapshot;
+    fusionState: import("../index.js").TaskState | null;
+    usage: NativeUsageRecord[];
+    actualBilledUsd: null;
+    apiEquivalentUsd: null;
+    upstreamHttpCalls: null;
+    naiveDelegations?: import("./naive.js").NaiveDelegation[] | undefined;
+    schemaVersion: number;
+    runId: string;
+    variant: "lead_only" | "worker_only" | "worker_selfreview" | "naive" | "fusion";
+    dataKind: "real" | "synthetic";
+    startedAt: string;
+    endedAt: string;
+    wallSeconds: number;
+    parentSessionId: SessionId;
+    workerSessionId: string | null;
+    taskId: TaskId;
+    nativeRequests: number;
+    protocolComplete: boolean;
+    artifactPass: null;
+    workerParentSessionId: SessionId | null;
+    workerSessions: {
+        sessionId: SessionId;
+        parentSessionId: SessionId | undefined;
+        eventsFile: string;
+    }[];
+}>;
+export { NativeRequestBudget };

package/lib/types/benchmark/output-limits.d.ts

@@ -0,0 +1,19 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { PairProfile, Role } from '../contracts.js';
+export interface BenchmarkOutputLimits {
+    policy: 'role-route-auto-v1';
+    roles: Record<Role, {
+        provider: string;
+        model: string;
+        contextWindow: number;
+        adapterDefault: number | null;
+        testedCap: number | null;
+        fallback: number;
+        maxTokens: number;
+    }>;
+}
+/** Run before preregistration, then compare the exact snapshot before spending.
+ * Every treatment uses the same role's automatic product allowance; the profile
+ * reservation is a fallback, not a universal per-request cap.
+ */
+export declare function resolveBenchmarkOutputLimits(ctx: Context, profile: PairProfile): Promise<BenchmarkOutputLimits>;

package/lib/types/bilingual.d.ts

@@ -0,0 +1,2 @@
+/** Host-side messages reach the UI and the command line as text; they carry both languages. */
+export declare const bi: (zh: string, en: string) => string;

package/lib/types/client/ActivityRows.d.ts

@@ -0,0 +1,8 @@
+import type { ActivityRow } from './activity-model.js';
+export declare function ActivityCard({ row, done, cwd, openFile }: {
+    row: ActivityRow;
+    done: boolean;
+    cwd?: string;
+    openFile(path: string): void;
+}): import("react").JSX.Element;
+export declare const activityStyles = "\n.fusion-activity-row{font-size:13px;line-height:1.5;margin:4px 0;min-width:0;color:var(--dsw-alias-label-secondary)}\n.fusion-activity-toggle{display:flex;align-items:center;gap:8px;width:100%;padding:6px 0;background:none;border:0;color:inherit;text-align:left;cursor:pointer;font:inherit}\n.fusion-activity-toggle:focus-visible,.fusion-activity-file:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:2px}\n.fusion-activity-summary{flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;color:var(--dsw-alias-label-primary)}\n.fusion-activity-toggle small{white-space:nowrap}.fusion-activity-toggle small[data-failed=true]{color:var(--dsw-alias-state-error-primary)}\n.fusion-activity-body{padding:4px 0 10px;overflow:hidden}.fusion-activity-body pre{white-space:pre-wrap;overflow-wrap:anywhere;max-height:360px;overflow:auto;font-size:12px}\n.fusion-activity-file{font:inherit;border:0;background:none;color:var(--dsw-alias-brand-primary);padding:0 0 6px;cursor:pointer}\n";

package/lib/types/client/FusionCache.d.ts

@@ -0,0 +1,4 @@
+/** Per-model cache keepalive: what applies and why, the documented default, and what was observed. */
+export declare function FusionCache({ refresh }: {
+    refresh: number;
+}): import("react").JSX.Element;

package/lib/types/client/FusionHint.d.ts

@@ -0,0 +1,9 @@
+import type { ModelDirectoryState } from '@deepseek-ai/dsh-client-ui-model-selection/client';
+import type { ObservableSnapshot } from '@deepseek-ai/dsh-client-store';
+export interface FusionHintProps {
+    sessionId: string;
+    directory: ObservableSnapshot<ModelDirectoryState>;
+    load(): void;
+}
+/** Additive composer hint. The original selector and its selection state stay native. */
+export declare function FusionHint({ sessionId, directory, load }: FusionHintProps): import("react").JSX.Element | null;

package/lib/types/client/FusionHistory.d.ts

@@ -0,0 +1,5 @@
+import type { HistoryTotals } from '../host/history.js';
+import { type Lang } from './i18n.js';
+export declare function formatCompact(tokens: number): string;
+export declare function outputTokens(lang: Lang, usage: HistoryTotals, calls: number): string;
+export declare function FusionHistory(): import("react").JSX.Element;

package/lib/types/client/FusionPanelIcon.d.ts

@@ -0,0 +1,13 @@
+import type { ReactNode } from 'react';
+export interface FusionPanelIconProps {
+    /** Square size in pixels requested by the host sidebar (defaults to 16). */
+    size?: number;
+    /** Whether the panel is currently active/selected in the main column. */
+    active?: boolean;
+    className?: string;
+}
+/**
+ * Compact, accessible icon for the Fusion sidebar entry.
+ * Renders a dual-node convergence (Lead + Sidekick models fusing into one) SVG glyph.
+ */
+export declare function FusionPanelIcon({ size, active, className }: FusionPanelIconProps): ReactNode;

package/lib/types/client/FusionRecovery.d.ts

@@ -0,0 +1,5 @@
+import type { FusionStatus } from '../status.js';
+export declare function FusionRecovery({ sessionId, task }: {
+    sessionId: string;
+    task: NonNullable<FusionStatus['task']>;
+}): import("react").JSX.Element;

package/lib/types/client/FusionSettings.d.ts

@@ -0,0 +1,9 @@
+import type { PhysicalRoute } from '../contracts.js';
+import type { SettingsCatalog } from '../host/settings.js';
+export declare function ModelChoice({ role, route, catalog, onChange }: {
+    role: 'Lead' | 'Sidekick' | 'compactor';
+    route?: PhysicalRoute;
+    catalog: SettingsCatalog;
+    onChange(route: PhysicalRoute | undefined): void;
+}): import("react").JSX.Element;
+export declare function FusionSettings(): import("react").JSX.Element;

package/lib/types/client/FusionStatus.d.ts

@@ -0,0 +1,5 @@
+/** Visible-session polling reads the plugin ledger; it never sends a chat message. */
+export declare function FusionStatus({ sessionId, attentionOnly }: {
+    sessionId: string;
+    attentionOnly?: boolean;
+}): import("react").JSX.Element | null;

package/lib/types/client/FusionTool.d.ts

@@ -0,0 +1,4 @@
+import type { ToolCallViewProps } from '@deepseek-ai/dsh-client-ui-tool/client';
+export declare const fusionControlTools: readonly ["fusion_read_state", "fusion_delegate_text", "fusion_explore", "fusion_delegate", "fusion_rework", "fusion_wait", "fusion_review_result", "fusion_submit_result", "fusion_takeover", "fusion_finish_direct", "fusion_read_evidence"];
+/** Keep internal coordination out of the normal conversation. Errors remain visible. */
+export declare function FusionTool({ block, sessionId, callId, toolName, cwd, openFile }: ToolCallViewProps): import("react").JSX.Element;

package/lib/types/client/activity-model.d.ts

@@ -0,0 +1,14 @@
+import type { DiffHunk } from '@deepseek-ai/dsh-client-ui-primitives';
+import type { FusionActivity } from '../activity.js';
+export interface ActivityRow {
+    id: string;
+    call: Extract<FusionActivity['source'], {
+        type: 'tool/call';
+    }>;
+    result?: Extract<FusionActivity['source'], {
+        type: 'tool/result';
+    }>;
+}
+export declare function activityRows(events: readonly FusionActivity[]): ActivityRow[];
+/** Only actual result-time metadata is labelled an applied diff. */
+export declare function activityDiffs(row: ActivityRow): DiffHunk[];

package/lib/types/client/i18n.d.ts

@@ -0,0 +1,15 @@
+/** The DSH client locale service (`ctx.locale`), used by structure only. */
+interface LocaleSource {
+    getSnapshot(): {
+        active: string;
+    };
+    subscribe(listener: () => void): () => void;
+}
+/** Called from the client entry when DSH's locale service is available; follows the user's language setting. */
+export declare function bindLocale(next: LocaleSource): () => void;
+export type Lang = 'zh' | 'en';
+/** The UI language: Chinese for any zh locale, English otherwise (DSH's own fallback). */
+export declare function useLang(): Lang;
+/** Pick the text for the active language. */
+export declare const tr: (lang: Lang, zh: string, en: string) => string;
+export {};

package/lib/types/client/index.d.ts

@@ -0,0 +1,22 @@
+import type { Context } from '@deepseek-ai/cordis';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface SlotMap {
+        'main': {
+            kind: 'keyed';
+            scope: 'root';
+        };
+        'sidebar.panellist': {
+            kind: 'list';
+            scope: 'root';
+            owner: {
+                size: number;
+                active: boolean;
+            };
+        };
+    }
+}
+export declare const name = "dsh-fusion/client";
+export declare const inject: string[];
+export declare const FUSION_PANEL_ID = "fusion";
+export { FusionPanelIcon } from './FusionPanelIcon.js';
+export declare function apply(ctx: Context): void;

package/lib/types/client/settings-events.d.ts

@@ -0,0 +1,2 @@
+export declare const onSettingsChanged: (listener: () => void) => (() => void);
+export declare const settingsChanged: () => void;

package/lib/types/client/status-polling.d.ts

@@ -0,0 +1,9 @@
+import type { FusionStatus } from '../status.js';
+interface Snapshot {
+    sessionId: string;
+    status?: FusionStatus;
+    failed: boolean;
+}
+/** One in-flight read per mounted session; collapsed hints still discover new attention states. */
+export declare function useFusionStatus(sessionId: string, expandedTask: string | undefined, attentionOnly?: boolean): Snapshot | undefined;
+export {};

package/lib/types/context/guard.d.ts

@@ -0,0 +1,21 @@
+import type { RoleContextPolicy, TokenMeasurement } from '../contracts.js';
+export interface RequestParts {
+    systemTokens: number;
+    messageTokens: number;
+    toolSchemaTokens: number;
+    cacheReadTokens: number;
+    reservedOutputTokens: number;
+    contextWindow: number;
+    quality: TokenMeasurement['quality'];
+}
+export declare function safetyTokens(contextWindow: number, policy: RoleContextPolicy, quality: TokenMeasurement['quality']): number;
+/** Output reservation that fits the disclosed window. Leaves half the usable window for input. */
+export declare function fittedOutputReservation(contextWindow: number): number;
+export declare function requestOutputReservation(contextWindow: number, requested?: number, adapterDefault?: number, testedCap?: number, fallback?: number): number;
+export declare function inputBudget(policy: RoleContextPolicy, contextWindow: number, maxOutput: number, quality?: TokenMeasurement['quality']): number;
+export declare function measureRequest(parts: RequestParts, policy: RoleContextPolicy): TokenMeasurement;
+export declare function assertFinalBudget(measurement: TokenMeasurement, policy: RoleContextPolicy): void;
+export interface RecoveryAttempt {
+    readonly projectionTokens: number;
+}
+export declare function boundedOverflowRecovery(attempts: readonly RecoveryAttempt[]): 'continue' | 'needs-decision';

package/lib/types/context/handoff.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Upper bound on recent conversation text carried into a Sidekick brief after compaction: about 10k tokens,
+ * enough for the latest exchanges while leaving most of the Sidekick's context for the task itself.
+ */
+export declare const HANDOFF_CONTENT_BYTES = 40000;
+/** Content bytes only: envelopes and independently retained task facts are extra. */
+export declare function recentHandoffSuffix<T extends {
+    readonly content: string;
+}>(records: readonly T[]): {
+    policy: "recent-whole-records-utf8-v1";
+    contentByteBudget: number;
+    totalRecords: number;
+    omittedRecords: number;
+    totalContentBytes: number;
+    retainedContentBytes: number;
+    records: T[];
+};