dsh-input-assistant 0.0.0-stage → 0.1.4

package/lib/client.meta.json

@@ -0,0 +1,274 @@
+{
+  "inputs": {
+    "src/core/diff.ts": {
+      "bytes": 3821,
+      "imports": [],
+      "format": "esm"
+    },
+    "src/browser/dom.ts": {
+      "bytes": 6650,
+      "imports": [],
+      "format": "esm"
+    },
+    "src/browser/floating.ts": {
+      "bytes": 1635,
+      "imports": [],
+      "format": "esm"
+    },
+    "src/browser/components.tsx": {
+      "bytes": 27915,
+      "imports": [
+        {
+          "path": "react",
+          "kind": "import-statement",
+          "external": true
+        },
+        {
+          "path": "react-dom",
+          "kind": "import-statement",
+          "external": true
+        },
+        {
+          "path": "src/core/diff.ts",
+          "kind": "import-statement",
+          "original": "../core/diff.js"
+        },
+        {
+          "path": "src/browser/dom.ts",
+          "kind": "import-statement",
+          "original": "./dom.js"
+        },
+        {
+          "path": "src/browser/floating.ts",
+          "kind": "import-statement",
+          "original": "./floating.js"
+        },
+        {
+          "path": "react/jsx-runtime",
+          "kind": "import-statement",
+          "external": true
+        }
+      ],
+      "format": "esm"
+    },
+    "src/core/types.ts": {
+      "bytes": 2990,
+      "imports": [],
+      "format": "esm"
+    },
+    "src/core/snapshot.ts": {
+      "bytes": 590,
+      "imports": [],
+      "format": "esm"
+    },
+    "src/core/context.ts": {
+      "bytes": 1880,
+      "imports": [],
+      "format": "esm"
+    },
+    "src/browser/controller.ts": {
+      "bytes": 46928,
+      "imports": [
+        {
+          "path": "src/core/types.ts",
+          "kind": "import-statement",
+          "original": "../core/types.js"
+        },
+        {
+          "path": "src/browser/dom.ts",
+          "kind": "import-statement",
+          "original": "./dom.js"
+        },
+        {
+          "path": "src/core/snapshot.ts",
+          "kind": "import-statement",
+          "original": "../core/snapshot.js"
+        },
+        {
+          "path": "src/core/context.ts",
+          "kind": "import-statement",
+          "original": "../core/context.js"
+        }
+      ],
+      "format": "esm"
+    },
+    "src/browser/runtime.ts": {
+      "bytes": 6245,
+      "imports": [
+        {
+          "path": "src/browser/controller.ts",
+          "kind": "import-statement",
+          "original": "./controller.js"
+        }
+      ],
+      "format": "esm"
+    },
+    "src/browser/styles.ts": {
+      "bytes": 10969,
+      "imports": [],
+      "format": "esm"
+    },
+    "src/core/config.ts": {
+      "bytes": 4132,
+      "imports": [
+        {
+          "path": "src/core/types.ts",
+          "kind": "import-statement",
+          "original": "./types.js"
+        }
+      ],
+      "format": "esm"
+    },
+    "src/browser/settings.tsx": {
+      "bytes": 14673,
+      "imports": [
+        {
+          "path": "react",
+          "kind": "import-statement",
+          "external": true
+        },
+        {
+          "path": "src/core/config.ts",
+          "kind": "import-statement",
+          "original": "../core/config.js"
+        },
+        {
+          "path": "src/core/types.ts",
+          "kind": "import-statement",
+          "original": "../core/types.js"
+        },
+        {
+          "path": "react/jsx-runtime",
+          "kind": "import-statement",
+          "external": true
+        }
+      ],
+      "format": "esm"
+    },
+    "src/browser/public.ts": {
+      "bytes": 107,
+      "imports": [
+        {
+          "path": "src/browser/runtime.ts",
+          "kind": "import-statement",
+          "original": "./runtime.js"
+        },
+        {
+          "path": "src/browser/controller.ts",
+          "kind": "import-statement",
+          "original": "./controller.js"
+        }
+      ],
+      "format": "esm"
+    },
+    "src/browser/index.ts": {
+      "bytes": 2104,
+      "imports": [
+        {
+          "path": "src/browser/components.tsx",
+          "kind": "import-statement",
+          "original": "./components.js"
+        },
+        {
+          "path": "src/browser/runtime.ts",
+          "kind": "import-statement",
+          "original": "./runtime.js"
+        },
+        {
+          "path": "src/browser/styles.ts",
+          "kind": "import-statement",
+          "original": "./styles.js"
+        },
+        {
+          "path": "src/browser/settings.tsx",
+          "kind": "import-statement",
+          "original": "./settings.js"
+        },
+        {
+          "path": "src/browser/public.ts",
+          "kind": "import-statement",
+          "original": "./public.js"
+        }
+      ],
+      "format": "esm"
+    }
+  },
+  "outputs": {
+    "index.js": {
+      "imports": [
+        {
+          "path": "react",
+          "kind": "require-call",
+          "external": true
+        },
+        {
+          "path": "react-dom",
+          "kind": "require-call",
+          "external": true
+        },
+        {
+          "path": "react/jsx-runtime",
+          "kind": "require-call",
+          "external": true
+        },
+        {
+          "path": "react",
+          "kind": "require-call",
+          "external": true
+        },
+        {
+          "path": "react/jsx-runtime",
+          "kind": "require-call",
+          "external": true
+        }
+      ],
+      "exports": [],
+      "entryPoint": "src/browser/index.ts",
+      "inputs": {
+        "src/browser/index.ts": {
+          "bytesInOutput": 1490
+        },
+        "src/browser/components.tsx": {
+          "bytesInOutput": 37601
+        },
+        "src/core/diff.ts": {
+          "bytesInOutput": 2610
+        },
+        "src/browser/dom.ts": {
+          "bytesInOutput": 5368
+        },
+        "src/browser/floating.ts": {
+          "bytesInOutput": 1060
+        },
+        "src/core/types.ts": {
+          "bytesInOutput": 603
+        },
+        "src/core/snapshot.ts": {
+          "bytesInOutput": 459
+        },
+        "src/core/context.ts": {
+          "bytesInOutput": 51
+        },
+        "src/browser/controller.ts": {
+          "bytesInOutput": 43757
+        },
+        "src/browser/runtime.ts": {
+          "bytesInOutput": 5060
+        },
+        "src/browser/styles.ts": {
+          "bytesInOutput": 10614
+        },
+        "src/browser/settings.tsx": {
+          "bytesInOutput": 22816
+        },
+        "src/core/config.ts": {
+          "bytesInOutput": 2160
+        },
+        "src/browser/public.ts": {
+          "bytesInOutput": 0
+        }
+      },
+      "bytes": 134870
+    }
+  }
+}

package/lib/core/config.d.ts

@@ -0,0 +1,17 @@
+import { type AssistantConfig } from './types.js';
+/**
+ * Strict resolution for author-supplied input: the plugin's own Cordis config and
+ * every `settings/set` patch. Unknown keys are a caller mistake and must fail loudly
+ * rather than be silently dropped from a partial update.
+ */
+export declare function resolveConfig(input?: Partial<AssistantConfig>): AssistantConfig;
+/**
+ * Lenient resolution for settings already on disk.
+ *
+ * Stored settings outlive the code that wrote them: a downgrade, a newer build
+ * that added a key, or a partially-written record must never make the plugin
+ * unusable. Unknown keys are ignored and unusable values fall back to their
+ * default, so a bad record degrades one setting instead of locking every
+ * endpoint. The next successful `settings/set` rewrites a clean record.
+ */
+export declare function resolveStoredConfig(input: unknown): AssistantConfig;

package/lib/core/context.d.ts

@@ -0,0 +1,4 @@
+import type { HistoryMessage } from './types.js';
+export declare const charCount: (text: string) => number;
+/** Preserve the initial task, latest correction, and latest answer before filling the remaining tail. */
+export declare function buildContext(history: readonly HistoryMessage[], budget?: number): HistoryMessage[];

package/lib/core/diff.d.ts

@@ -0,0 +1,6 @@
+export interface TextChange {
+    type: 'equal' | 'insert' | 'delete';
+    value: string;
+}
+/** A bounded token diff for inspection; never a claim about semantic fidelity. */
+export declare function diffText(before: string, after: string): TextChange[];

package/lib/core/generation.d.ts

@@ -0,0 +1,15 @@
+import { type AssistantConfig, type GenerationRequest, type HistoryMessage, type Operation } from './types.js';
+import { type ProtectedText } from './protection.js';
+export declare const NO_SUGGESTION = "[[NO_SUGGESTION]]";
+export interface PreparedGeneration {
+    operation: Operation;
+    system: string;
+    input: string;
+    timeoutMs: number;
+    maxOutputTokens: number;
+    protection: ProtectedText | null;
+    request: GenerationRequest;
+    config: AssistantConfig;
+}
+export declare function prepareGeneration(request: GenerationRequest, history: readonly HistoryMessage[], config: AssistantConfig): PreparedGeneration;
+export declare function finishGeneration(raw: string, prepared: PreparedGeneration): string | null;

package/lib/core/index.d.ts

@@ -0,0 +1,9 @@
+export * from './types.js';
+export * from './config.js';
+export * from './context.js';
+export * from './protection.js';
+export * from './generation.js';
+export * from './scheduler.js';
+export * from './snapshot.js';
+export * from './diff.js';
+export * from './models.js';

package/lib/core/models.d.ts

@@ -0,0 +1,15 @@
+/** Read-only model choices for the plugin's auxiliary route, independent of the main composer. */
+export interface AssistantModelCatalog {
+    groups: {
+        provider: string;
+        name: string;
+        models: {
+            id: string;
+            name: string;
+        }[];
+    }[];
+    failures: {
+        provider: string;
+        name: string;
+    }[];
+}

package/lib/core/protection.d.ts

@@ -0,0 +1,18 @@
+export interface ProtectedFragment {
+    token: string;
+    original: string;
+}
+export interface ProtectedText {
+    original: string;
+    masked: string;
+    fragments: ProtectedFragment[];
+}
+/**
+ * Protect syntax and user-locked literals, without trying to prove semantic equivalence.
+ *
+ * Broad literals own their complete span, so nested paths are protected once.
+ * Plain candidates are consumed once and classified at their boundary; long
+ * prose without separators must not cause quadratic failed regex searches.
+ */
+export declare function protectText(text: string, locked?: readonly string[]): ProtectedText;
+export declare function restoreProtected(output: string, protectedText: ProtectedText): string;

package/lib/core/scheduler.d.ts

@@ -0,0 +1,10 @@
+import { type Operation } from './types.js';
+/** Cancellation settles callers even if a provider ignores AbortSignal. Late results cannot win. */
+export declare class SessionScheduler {
+    private flights;
+    run<T>(sessionId: string, requestId: string, operation: Operation, timeoutMs: number, work: (signal: AbortSignal) => Promise<T>, external?: AbortSignal): Promise<T>;
+    cancel(sessionId: string, requestId?: string): boolean;
+    /** Abort every in-flight request (a generation-affecting settings change invalidates them all). */
+    cancelAll(): void;
+    dispose(): void;
+}

package/lib/core/snapshot.d.ts

@@ -0,0 +1,2 @@
+import type { InputSnapshot } from './types.js';
+export declare function snapshotMatches(expected: InputSnapshot, current: Omit<InputSnapshot, 'requestId'>, checkCaret?: boolean): boolean;

package/lib/core/types.d.ts

@@ -0,0 +1,92 @@
+/** Carrier-neutral contracts shared by the host, browser and offline evaluation. */
+export type Operation = 'optimize' | 'next' | 'complete';
+export interface TokenSpan {
+    start: number;
+    end: number;
+    draftRev: number;
+}
+export interface ModelRoute {
+    provider: string;
+    model: string;
+}
+export type OptimizationStrength = 'light' | 'standard' | 'deep';
+export type PredictionDetail = 'concise' | 'standard' | 'detailed';
+export interface AssistantConfig {
+    optimizeEnabled: boolean;
+    stashEnabled: boolean;
+    optimizationStrength: OptimizationStrength;
+    nextEnabled: boolean;
+    completionEnabled: boolean;
+    predictionDetail: PredictionDetail;
+    displayMode: 'ghost' | 'panel';
+    debounceMs: number;
+    minIntervalMs: number;
+    maxHistoryChars: number;
+    maxDraftChars: number;
+    maxNextChars: number;
+    maxCompletionChars: number;
+    optimizeTimeoutMs: number;
+    suggestionTimeoutMs: number;
+    provider: string;
+    model: string;
+}
+export declare const DEFAULT_CONFIG: Readonly<AssistantConfig>;
+export interface InputSnapshot {
+    requestId: string;
+    sessionId: string;
+    sourceTurnId: string | null;
+    draft: string;
+    draftRev: number;
+    span: TokenSpan;
+    connectionGeneration: string;
+    routeKey: string;
+}
+export interface GenerationRequest extends InputSnapshot {
+    operation: Operation;
+    /** Explicit user action; automatic feature toggles do not block a single manual suggestion. */
+    manual?: boolean;
+    targetText?: string;
+    lockedFragments?: readonly string[];
+    provider?: string;
+    model?: string;
+}
+export interface GenerationResult {
+    text: string | null;
+    /** Temporary throttling is not a model abstention and must never be cached as one. */
+    outcome?: 'suggestion' | 'abstained' | 'throttled';
+    retryAfterMs?: number;
+    requestId: string;
+    sessionId: string;
+    sourceTurnId: string | null;
+    draftRev: number;
+    span: TokenSpan;
+    connectionGeneration: string;
+    routeKey: string;
+}
+export interface HistoryMessage {
+    role: 'user' | 'assistant';
+    text: string;
+    turnId?: string;
+}
+export interface AssistantStatus {
+    sourceTurnId: string | null;
+    running: boolean;
+    settings: AssistantConfig;
+    generation: string;
+    route?: ModelRoute;
+}
+export interface StoredDraft {
+    id: string;
+    text: string;
+    createdAt: number;
+}
+export interface DraftMutationResult {
+    drafts: StoredDraft[];
+    removed: StoredDraft[];
+}
+export declare const RPC_CHANNEL = "/api";
+export declare const RPC_PREFIX = "input-assistant/";
+export declare class AssistantError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}