@mengruo/dsh-vision-toolkit 0.0.1

package/lib/types/client/paste-images.d.ts

@@ -0,0 +1,126 @@
+/** Clipboard-only multi-image input for DSH Web. */
+import { type ReactNode } from 'react';
+import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+import type { InputTriggerSource } from '@deepseek-ai/dsh-client-ui-input-trigger/client';
+import type { PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+export declare const PASTE_IMAGES_ROUTE = "/_dsh/vision-toolkit/paste-images";
+export declare const PASTE_POLICY_ROUTE = "/_dsh/vision-toolkit/paste-policy";
+interface PasteRecord {
+    ref: string;
+    file: File;
+    batch: PasteBatch;
+    status: 'ready' | 'copying' | 'copied' | 'error';
+    error?: string | undefined;
+    absolutePath?: string | undefined;
+}
+interface PasteBatch {
+    sessionId: string;
+    records: PasteRecord[];
+    inflight?: Promise<void> | undefined;
+    unsubscribe?: (() => void) | undefined;
+}
+interface PasteOccurrence {
+    occurrenceId: number;
+    source: string;
+    ref: string;
+    offset: number;
+    label: string;
+}
+type PasteDockProps = PropsRuntime<'conversation.input.dock'> & {
+    controller: PasteImageController;
+    remove: (occurrence: PasteOccurrence) => void;
+};
+/** Owns browser File objects until DSH serializes the corresponding text references. */
+export declare class PasteImageController {
+    private readonly ctx;
+    private readonly records;
+    private readonly listeners;
+    private revision;
+    private readonly verdicts;
+    /** Guards the synthetic replay paste from re-entering capture interception. */
+    private replaying;
+    constructor(ctx: ClientContext);
+    subscribe: (listener: () => void) => (() => void);
+    snapshot: () => number;
+    private changed;
+    source(): InputTriggerSource;
+    recordsFor(occurrences: readonly PasteOccurrence[]): PasteRecord[];
+    private inputFor;
+    private insertText;
+    private insertRecords;
+    /**
+     * The host's verdict for one Session and selector label, when fresh. The
+     * last CONFIRMED answer is authoritative while a background refresh is in
+     * flight (the paste acts on what the host last said; the refresh only
+     * covers the next paste). A label that changed since the confirmation
+     * answers undefined, so the native attachment flow stays the default.
+     * @param sessionId - the live Session the paste belongs to.
+     * @param modelLabel - the model-selector label currently shown.
+     * @returns the fresh confirmed verdict, or undefined when unconfirmed.
+     */
+    private verdictFor;
+    /**
+     * The exact model route the live model catalog reports for one Session.
+     * Unreadable routes answer undefined, so the verdict falls back to the
+     * selector label alone.
+     * @param sessionId - the live Session id.
+     * @returns the current provider/model selection, when readable.
+     */
+    private readSelection;
+    /**
+     * Ask the host what to do with a paste for the current model, and cache the
+     * answer per Session and selector label. A model switch changes the label,
+     * which changes the cache key, so a stale verdict never outlives the model
+     * it described. The exact selection rides along when the live model catalog
+     * is readable, so the host can answer with an auto-switch route; a 404
+     * simply leaves the verdict unconfirmed; the next focus or paste retries.
+     * @param sessionId - the live Session to ask about.
+     * @param modelLabel - the model-selector label currently shown.
+     */
+    refreshVerdict(sessionId: string, modelLabel: string): void;
+    /**
+     * Switch one Session to the route the host validated, through the same
+     * model-directory seat the selector uses when present (so the shared UI
+     * state moves with the session), falling back to the raw RPC.
+     * @param sessionId - the live Session id.
+     * @param route - the validated variant route.
+     */
+    private switchModel;
+    /**
+     * Replay a swallowed paste as a synthetic clipboard event so the composer's
+     * own intake (limits, thumbnails, keyboard) runs with the captured files.
+     * @returns false when the environment cannot construct a clipboard payload.
+     */
+    private replayPaste;
+    /**
+     * Auto-switch flow: switch the Session to the image-input variant, announce
+     * it, then replay the paste into the composer's native intake. A failed
+     * switch, or an environment that cannot replay clipboard bytes, degrades to
+     * the path takeover with the same files.
+     * @param sessionId - the live Session id.
+     * @param target - the composer textarea the paste landed on.
+     * @param files - the captured image files.
+     * @param text - same-paste text, replayed alongside the files.
+     * @param route - the validated variant route to switch to.
+     */
+    private autoSwitchPaste;
+    /**
+     * Path-takeover flow: insert the same-paste text and every image as a text
+     * reference that serializes to the image's workspace path on send.
+     * @param sessionId - the live Session id.
+     * @param target - the composer textarea the paste landed on.
+     * @param files - the captured image files.
+     * @param text - same-paste text.
+     */
+    private takeoverPaste;
+    handlePaste(event: ClipboardEvent): boolean;
+    remove(sessionId: string, occurrence: PasteOccurrence): void;
+    private upload;
+    private serialize;
+}
+/** Minimal per-image progress, failure, and removal feedback above the composer. */
+export declare function PasteImageDock(props: PasteDockProps): ReactNode;
+/** Install capture interception, the text-reference codec, and composer feedback. */
+export declare function installPasteImages(ctx: ClientContext): void;
+export {};
+//# sourceMappingURL=paste-images.d.ts.map

package/lib/types/client/paste-images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paste-images.d.ts","sourceRoot":"","sources":["../../../src/client/paste-images.tsx"],"names":[],"mappings":"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"}

package/lib/types/config.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Plugin configuration: provider endpoint and credential reference, output
+ * language, limits, and the external upstream runtime location. Secrets never
+ * live here — `provider.credential` is a DSH Credential reference resolved per
+ * operation through `ctx.credentials`.
+ * @module dsh-vision-toolkit/config
+ */
+import type Schema from '@deepseek-ai/schemastery';
+import { type CredentialRef } from '@deepseek-ai/dsh-credentials';
+export { BUILT_IN_FREE_VISION_BASE_URL, BUILT_IN_FREE_VISION_CREDENTIAL, BUILT_IN_FREE_VISION_KEY, BUILT_IN_FREE_VISION_MODEL, } from './defaults.ts';
+/** Settings document namespace owned by this plugin. */
+export declare const VISION_TOOLKIT_SETTINGS_NAMESPACE: import("@deepseek-ai/dsh-settings").SettingsNamespace;
+/** Browser-compatible default shared with the vendored Python client. */
+export declare const DEFAULT_VISION_USER_AGENT = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.36";
+/** Full user-facing configuration; every field defaults at the schema boundary. */
+export interface VisionToolkitConfig {
+    provider?: {
+        /** Provider API base URL. */
+        baseUrl?: string;
+        /** DSH Credential reference holding the API key (an environment-style name). */
+        credential?: string;
+        /** Multimodal model name. */
+        model?: string;
+        /** Vision request protocol: OpenAI Chat Completions or Anthropic Messages. */
+        protocol?: 'openai' | 'anthropic';
+        /** Anthropic thinking field behavior; `omit` leaves model defaults untouched. */
+        anthropicThinking?: 'omit' | 'disabled' | 'adaptive';
+        /** Outbound User-Agent for provider requests and connection tests. */
+        userAgent?: string;
+    };
+    /** Vision output language (`zh` or `en`). */
+    language?: 'zh' | 'en';
+    /** Single remote/upstream call budget in milliseconds. */
+    timeoutMs?: number;
+    /** Maximum input image size in bytes; larger images are auto-compressed (lossless first). */
+    maxImageBytes?: number;
+    /** Maximum decoded pixel count per input image; larger images are auto-downscaled to fit. */
+    maxImagePixels?: number;
+    /** In-flight tool execution cap per session. */
+    concurrency?: number;
+    runtime?: {
+        /** `managed` uses the packaged snapshot and isolated venv; `external` uses a clean pinned checkout. */
+        mode?: 'managed' | 'external';
+        /** Required path to the clean pinned checkout when `mode` is `external`. */
+        agentVisionToolkitPath?: string;
+        /** Optional Python 3.11+ bootstrap/interpreter override. */
+        python?: string;
+    };
+    /** Extra directories (besides the workspace) inputs may come from. */
+    allowedDirs?: string[];
+    /**
+     * Image-input variants: sibling model-selector entries for every model the
+     * host positively declares text-only. A variant declares image input, so
+     * pasted images keep the native attachment flow (composer thumbnail and
+     * durable session image), and the plugin rewrites image blocks into Vision
+     * Toolkit descriptions only on the wire to the model.
+     */
+    imageInputVariants?: {
+        /** Whether variant routes are registered at all (default true). */
+        enabled?: boolean;
+        /** Restrict wrapped upstream routes by provider id; empty wraps every eligible route. */
+        providers?: string[];
+        /**
+         * Whether the browser paste integration automatically switches the Session
+         * to the image-input variant of a text-only model before the paste, so
+         * pasted images keep the native attachment flow with no manual model
+         * change. The variant still exposes a workspace path to the model; off
+         * keeps the path-only takeover instead (default true).
+         */
+        autoSwitch?: boolean;
+        /**
+         * Transparent routing: variant routes keep the upstream provider and model
+         * display names, and the browser integration hides the upstream text-only
+         * entries that have a variant twin, so the model selector shows one entry
+         * per model and sessions stay on the image-capable variant without users
+         * seeing or switching a `(Vision Toolkit)` route. On by default; disable
+         * to restore the explicit sibling entries.
+         */
+        hidden?: boolean;
+    };
+}
+/** Configuration schema with the documented P0 defaults. */
+export declare const Config: Schema<VisionToolkitConfig>;
+/** Configuration after static validation, with every default materialized. */
+export interface ResolvedVisionToolkitConfig {
+    provider: {
+        baseUrl: string;
+        credential: CredentialRef;
+        model: string;
+        protocol: 'openai' | 'anthropic';
+        anthropicThinking: 'omit' | 'disabled' | 'adaptive';
+        userAgent: string;
+    };
+    language: 'zh' | 'en';
+    timeoutMs: number;
+    maxImageBytes: number;
+    maxImagePixels: number;
+    concurrency: number;
+    runtime: {
+        mode: 'managed' | 'external';
+        agentVisionToolkitPath?: string;
+        python?: string;
+    };
+    allowedDirs: string[];
+    imageInputVariants: {
+        enabled: boolean;
+        providers: string[];
+        autoSwitch: boolean;
+        hidden: boolean;
+    };
+}
+/**
+ * Validate and normalize a config object (partial inputs receive the same
+ * defaults the schemastery schema applies). Configuration mistakes fail loud
+ * at plugin load (the earliest resolvable point); runtime availability is a
+ * separate, later concern.
+ * @param config - parsed config with defaults applied.
+ * @returns the fully defaulted, validated configuration.
+ */
+export declare function resolveConfig(config?: VisionToolkitConfig): ResolvedVisionToolkitConfig;
+/** Whether a resolved provider should use the bundled public key instead of DSH credentials. */
+export declare function isBuiltInFreeVisionProvider(provider: ResolvedVisionToolkitConfig['provider']): boolean;
+//# sourceMappingURL=config.d.ts.map

package/lib/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"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"}

package/lib/types/defaults.d.ts

@@ -0,0 +1,6 @@
+/** Public free vision service defaults shared by server and browser settings. */
+export declare const BUILT_IN_FREE_VISION_BASE_URL = "https://vision.anionex.me/v1";
+export declare const BUILT_IN_FREE_VISION_CREDENTIAL = "ANIONEX_FREE_VISION";
+export declare const BUILT_IN_FREE_VISION_KEY = "https://agent-vision.anionex.me";
+export declare const BUILT_IN_FREE_VISION_MODEL = "gemini-3.7-flash";
+//# sourceMappingURL=defaults.d.ts.map

package/lib/types/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/defaults.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,eAAO,MAAM,6BAA6B,iCAAiC,CAAA;AAC3E,eAAO,MAAM,+BAA+B,wBAAwB,CAAA;AACpE,eAAO,MAAM,wBAAwB,oCAAoC,CAAA;AACzE,eAAO,MAAM,0BAA0B,qBAAqB,CAAA"}

package/lib/types/errors.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Stable error vocabulary shared by the runtime, upstream adapter, and tools.
+ * Every failure reaching the model carries one of these codes and a message
+ * that never contains credentials or raw upstream stack traces.
+ * @module dsh-vision-toolkit/errors
+ */
+/** Discriminant tag for every Vision Toolkit failure. */
+export declare const VISION_TOOLKIT_ERROR_CODES: readonly ["config", "input", "capacity", "service", "runtime", "output", "timeout", "cancelled", "path"];
+/** Stable machine-readable error category. */
+export type VisionToolkitErrorCode = typeof VISION_TOOLKIT_ERROR_CODES[number];
+/** Error with a stable category; safe to surface to the model. */
+export declare class VisionToolkitError extends Error {
+    readonly code: VisionToolkitErrorCode;
+    constructor(code: VisionToolkitErrorCode, message: string, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * Replace every known secret occurrence in untrusted text. Used before
+ * upstream stderr, exit messages, or trace reports enter logs or results.
+ * @param text - text that may embed a secret.
+ * @param secrets - values that must never be surfaced.
+ * @returns text with each secret replaced by a fixed marker.
+ */
+export declare function redactText(text: string, secrets: readonly string[]): string;
+/**
+ * Build a model-safe upstream failure line: the tool prefix plus the
+ * redacted stderr tail, never a JavaScript stack.
+ * @param tool - upstream CLI name.
+ * @param stderr - captured upstream stderr.
+ * @param secrets - values to redact.
+ * @returns one-line safe message.
+ */
+export declare function upstreamFailureMessage(tool: string, stderr: string, secrets: readonly string[]): string;
+//# sourceMappingURL=errors.d.ts.map

package/lib/types/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,yDAAyD;AACzD,eAAO,MAAM,0BAA0B,0GAU7B,CAAA;AAEV,8CAA8C;AAC9C,MAAM,MAAM,sBAAsB,GAAG,OAAO,0BAA0B,CAAC,MAAM,CAAC,CAAA;AAE9E,kEAAkE;AAClE,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAA;gBAEzB,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAKzF;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAO3E;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAGvG"}

package/lib/types/evidence-cache.d.ts

@@ -0,0 +1,91 @@
+/** Durable, Session-scoped cache for image descriptions used by model variants. */
+import type { Context } from '@deepseek-ai/cordis';
+import type { ContentBlock } from '@deepseek-ai/dsh-llm';
+import type { ResolvedVisionToolkitConfig } from './config.ts';
+/** Bump only when the model-visible evidence contract changes incompatibly. */
+export declare const EVIDENCE_CONTRACT_VERSION = 1;
+type EvidenceRecordKey = string & {
+    readonly __evidenceRecordKey: unique symbol;
+};
+/** Plugin-owned sidecar domain; the host backend handles atomicity and file safety. */
+export declare const evidenceCacheDomainSpec: {
+    name: string;
+    version: number;
+    tables: {
+        evidence: import("@deepseek-ai/dsh-storage-domain").DomainTableSpec<EvidenceRecordKey, string>;
+    };
+};
+/** Stable metadata for one description lookup. Raw focus prompts are never persisted. */
+export interface EvidenceCacheKey {
+    readonly digest: string;
+    readonly contractVersion: number;
+    readonly sessionId?: string;
+    readonly sessionCreatedAt?: number;
+    readonly sessionCwd?: string;
+    readonly attachmentId: string;
+    readonly promptHash: string;
+    readonly runtimeHash: string;
+}
+/** Optional durable layer behind the process-local promise/LRU cache. */
+export interface EvidencePersistence {
+    read(key: EvidenceCacheKey): Promise<ContentBlock | undefined>;
+    write(key: EvidenceCacheKey, block: ContentBlock): Promise<void>;
+}
+/** Fingerprint every runtime setting that can change the generated description. */
+export declare function evidenceRuntimeFingerprint(config: ResolvedVisionToolkitConfig, credentialSha256?: string, sslVerify?: string): string;
+/** Build a non-secret cache key from the Session, attachment, focus, and runtime contract. */
+export declare function createEvidenceCacheKey(input: {
+    sessionId?: string;
+    sessionIdentity?: SessionIdentity;
+    attachmentId: string;
+    prompt: string;
+    runtimeHash: string;
+}): EvidenceCacheKey;
+/** Bounded promise cache; concurrent readers join one load and rejected loads are evicted. */
+export declare class EvidenceCache {
+    private readonly limit;
+    private readonly persistence?;
+    private readonly entries;
+    constructor(limit: number, persistence?: EvidencePersistence | undefined);
+    /** Read a memory/durable hit or compute and persist one model-visible result. */
+    read(key: string | EvidenceCacheKey, load: () => Promise<ContentBlock>): Promise<ContentBlock>;
+    /** Drop process-local descriptions; durable rows stay versioned by their runtime fingerprint. */
+    clear(): void;
+}
+interface SessionIdentity {
+    createdAt: number;
+    cwd?: string;
+}
+export interface SessionEvidenceStoreOptions {
+    maxEntries?: number;
+    maxBytes?: number;
+    maxEntryBytes?: number;
+    now?: () => number;
+}
+/** Official DSH storage-domain sidecar used to survive Profile restarts. */
+export declare class SessionEvidenceStore implements EvidencePersistence {
+    private readonly ctx;
+    private storage;
+    private storageFiber;
+    private storageReady;
+    private mutationTail;
+    private readonly flushes;
+    private warned;
+    private readonly maxEntries;
+    private readonly maxBytes;
+    private readonly maxEntryBytes;
+    private readonly now;
+    constructor(ctx: Context, options?: SessionEvidenceStoreOptions);
+    /** Release the optional storage binding with the owning variant lifecycle. */
+    dispose(): void;
+    read(key: EvidenceCacheKey): Promise<ContentBlock | undefined>;
+    write(key: EvidenceCacheKey, block: ContentBlock): Promise<void>;
+    private sessionFor;
+    private prepareStorage;
+    private enqueueMutation;
+    private flushSession;
+    private prune;
+    private warnOnce;
+}
+export {};
+//# sourceMappingURL=evidence-cache.d.ts.map

package/lib/types/evidence-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence-cache.d.ts","sourceRoot":"","sources":["../../src/evidence-cache.ts"],"names":[],"mappings":"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"}

package/lib/types/exposure.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Agent-scoped progressive exposure for the model-facing visual tools.
+ * Runtime readiness is global, while tool schemas enter only an Agent through
+ * the matching Skill or its bootstrap tool; administrative diagnostics stay on
+ * the Web seam.
+ * @module dsh-vision-toolkit/exposure
+ */
+import { type ToolDefinition } from '@deepseek-ai/dsh-tools';
+import type { Context } from '@deepseek-ai/cordis';
+/** Small bootstrap tool retained only until the current Agent gains visual tools. */
+export declare const VISION_TOOLKIT_ACTIVATE = "vision_toolkit_activate";
+/** Skill name used by releases before the rename to vision-skills. */
+export declare const LEGACY_VISION_TOOLS_SKILL_NAME = "vision-tools";
+/** Unique pre-rename line in bundled instructions, kept for Session restore. */
+export declare const LEGACY_VISION_TOOLS_SKILL_MARKER = "If this content arrived through a direct `/vision-tools` invocation and the";
+/** Result returned by the one-shot activation transport. */
+export interface VisionToolkitActivationResult {
+    activated: boolean;
+    tools: string[];
+}
+/**
+ * Owns one progressive-exposure generation for a ready Vision Toolkit runtime.
+ * The bootstrap tool is global; visual definitions are created and registered
+ * in an Agent scope after the Skill load is durable, just succeeded, or the
+ * model explicitly invokes the bootstrap fallback.
+ */
+export declare class VisionToolExposure {
+    private readonly ctx;
+    private readonly createTools;
+    readonly activationTool: ToolDefinition;
+    private readonly states;
+    private installed;
+    /**
+     * @param ctx - Plugin context with Tool and Agent registries.
+     * @param createTools - Fresh definitions bound to the current runtime generation.
+     */
+    constructor(ctx: Context, createTools: () => ToolDefinition[]);
+    /** Install lifecycle listeners and adopt Agents that already exist. */
+    install(): () => void;
+    private attach;
+    private activate;
+    /** Whether the session is attached to the live SessionStore (production). */
+    private isLiveSession;
+    private applyHideActivationForSession;
+    private applyHideActivation;
+    private detach;
+    private disposeStates;
+    private disposeState;
+}
+//# sourceMappingURL=exposure.d.ts.map

package/lib/types/exposure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exposure.d.ts","sourceRoot":"","sources":["../../src/exposure.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAA;AACxE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAIlD,qFAAqF;AACrF,eAAO,MAAM,uBAAuB,4BAA4B,CAAA;AAEhE,sEAAsE;AACtE,eAAO,MAAM,8BAA8B,iBAAiB,CAAA;AAE5D,gFAAgF;AAChF,eAAO,MAAM,gCAAgC,gFAAgF,CAAA;AAS7H,4DAA4D;AAC5D,MAAM,WAAW,6BAA6B;IAC5C,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB;AA8ED;;;;;GAKG;AACH,qBAAa,kBAAkB;IAU3B,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAV9B,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAA;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;IACzD,OAAO,CAAC,SAAS,CAAQ;IAEzB;;;OAGG;gBAEgB,GAAG,EAAE,OAAO,EACZ,WAAW,EAAE,MAAM,cAAc,EAAE;IA6BtD,uEAAuE;IACvE,OAAO,IAAI,MAAM,IAAI;IAoCrB,OAAO,CAAC,MAAM;IAMd,OAAO,CAAC,QAAQ;IA0BhB,6EAA6E;IAC7E,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,6BAA6B;IAQrC,OAAO,CAAC,mBAAmB;IAM3B,OAAO,CAAC,MAAM;IAOd,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,YAAY;CAIrB"}

package/lib/types/image-input-variants.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Image-input variants: sibling model-selector entries for every model the
+ * host positively declares text-only. A variant declares image input, so
+ * pasted images keep the native attachment flow — composer thumbnail and the
+ * durable session image — while the variant's stream rewrites every image
+ * block into a workspace path plus a Vision Toolkit description before
+ * delegating to the original route. The durable log is untouched; only the
+ * wire carries the evidence text.
+ * @module dsh-vision-toolkit/image-input-variants
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import LlmService, { LlmAdapter } from '@deepseek-ai/dsh-llm';
+import type { GenerateOptions, LlmModelInfo, LlmProviderInfo, LlmResolvedModelInfo, Message, ResolvedRetryPolicy, StreamChunk } from '@deepseek-ai/dsh-llm';
+import type { ResolvedVisionToolkitConfig } from './config.ts';
+import { EvidenceCache } from './evidence-cache.ts';
+import { type PasteSelectionQuery, type PasteVerdict } from './paste-images.ts';
+import type { CapturedEvidenceRuntime, VisionToolkitRuntime } from './runtime.ts';
+export { EvidenceCache } from './evidence-cache.ts';
+/** Provider-id prefix for the variant routes this plugin registers. */
+export declare const VARIANT_PROVIDER_PREFIX = "vision-toolkit-";
+/** Display suffix shared by variant provider names and variant model names. */
+export declare const VARIANT_SUFFIX = " (Vision Toolkit)";
+/** The variant provider route minted for one upstream route. */
+export declare function variantProviderId(upstream: string): string;
+/**
+ * Whether one model earns an image-input variant: the host must positively
+ * declare it text-only. A model with unknown modalities is left alone — its
+ * native channel is the safe default, and the variant would degrade it.
+ * @param info - model metadata from the host catalog.
+ * @returns true when the model is confirmed text-only.
+ */
+export declare function shouldWrapModel(info: Pick<LlmModelInfo, 'inputModalities'>): boolean;
+/** Whether a content block list carries an image at any depth (tool-result nesting included). */
+export { contentHasImage } from '@deepseek-ai/dsh-llm';
+/**
+ * Wait on a shared promise without inheriting its lifetime: the caller's
+ * abort rejects this wait immediately, while the underlying read keeps
+ * running and lands in the cache for the retry.
+ * @param promise - the shared computation.
+ * @param signal - the caller's cancellation, or undefined to wait unconditionally.
+ * @returns the computed value, unless the caller aborted first.
+ */
+export declare function abortableWait<T>(promise: Promise<T>, signal: AbortSignal | undefined): Promise<T>;
+/**
+ * Rewrite image blocks in one message list into description text blocks.
+ * The original messages are returned untouched when nothing carries an image;
+ * converted messages are new objects, so the durable request stays immutable.
+ * @param ctx - plugin context for the attachments service.
+ * @param runtime - the immutable runtime snapshot captured for this conversion.
+ * @param cache - shared process/durable description cache.
+ * @param messages - the assembled request messages.
+ * @param signal - the caller's cancellation for this conversion pass.
+ * @param sessionId - the live Session identity, when available.
+ * @param runtimeHash - stable fingerprint of the vision provider and evidence runtime.
+ * @returns the rewritten message list.
+ */
+export declare function convertImagesToEvidence(ctx: Context, runtime: () => CapturedEvidenceRuntime | undefined, cache: EvidenceCache, messages: readonly Message[], signal?: AbortSignal, sessionId?: string, runtimeHash?: string): Promise<Message[]>;
+/**
+ * The adapter behind one variant route: model metadata declares image input,
+ * and every stream rewrites image blocks before delegating to the upstream
+ * route through the host service (so the upstream route's own middleware,
+ * retry policy, and replay handling still apply).
+ */
+export declare class ImageInputVariantAdapter extends LlmAdapter {
+    private readonly ctx;
+    private readonly llm;
+    private readonly upstream;
+    private readonly upstreamName;
+    private readonly runtime;
+    private readonly cache;
+    private readonly hidden;
+    constructor(ctx: Context, llm: LlmService, upstream: string, upstreamName: string, runtime: () => VisionToolkitRuntime | undefined, cache: EvidenceCache, hidden?: () => boolean);
+    providerInfo(provider: string): LlmProviderInfo;
+    listModels(provider: string): Promise<readonly LlmModelInfo[]>;
+    resolveModel(provider: string, model: string, signal?: AbortSignal): Promise<LlmResolvedModelInfo>;
+    /**
+     * Keep the variant route aligned with the configured upstream route's retry
+     * policy. This route is a wire-only facade; without this delegation it would
+     * silently fall back to the host default policy when selected for images.
+     */
+    providerRetryPolicy(): ResolvedRetryPolicy | undefined;
+    stream(options: GenerateOptions): AsyncGenerator<StreamChunk>;
+}
+/**
+ * Whether the plugin should take a paste over for one live Session: true only
+ * when the current model is positively declared text-only. The model-selector
+ * label is the authoritative source when supplied — the Session's persisted
+ * route header only updates on a request, so a model switch would otherwise be
+ * invisible until the next turn — with a fallback to that header. Unknown
+ * routes answer false: the native attachment flow is the safe default, and a
+ * text-only model merely keeps its ordinary image-admission error.
+ * @param ctx - plugin context with `sessions` and `llm`.
+ * @param sessionId - the live Session id the paste belongs to.
+ * @param modelLabel - the model-selector label the client currently shows, if any.
+ * @returns true when pastes should become workspace paths instead of attachments.
+ */
+export declare function sessionPasteTakeover(ctx: Context, sessionId: string, modelLabel?: string): Promise<boolean>;
+/**
+ * Resolve the takeover verdict from the Session's last requested route header.
+ * @param ctx - plugin context with `sessions` and `llm`.
+ * @param sessionId - the live Session id.
+ * @returns true when the persisted route is positively text-only.
+ */
+export declare function sessionHeaderTakeover(ctx: Context, sessionId: string): Promise<boolean>;
+/**
+ * Resolve the takeover verdict from a model-selector label alone. Every model
+ * whose name or id appears in the label votes: any image-capable (or unknown-
+ * capability) match vetoes the takeover, and at least one positively text-only
+ * match confirms it. A route whose catalog cannot be read also vetoes — the
+ * unreadable route is exactly where an image-capable twin could hide, so a
+ * label match on a half-read catalog must not confirm a takeover. The label
+ * carries no provider id, so no picking is attempted: the answer is decisive
+ * only when the whole catalog was walkable and every match agrees.
+ * @param ctx - plugin context with the `llm` service.
+ * @param label - the selector label the browser shows.
+ * @returns true (take over), false (native), or undefined when nothing matched.
+ */
+export declare function labelTakeoverVerdict(ctx: Context, label: string): Promise<boolean | undefined>;
+/**
+ * Paste-policy resolver with a short cache. The exact route is the live fact
+ * (the browser re-reads it per paste), and the host catalog only changes on
+ * topology events, so a brief cache is safe; every `llm/adapters-updated`
+ * notification empties it — including the sweep that registers a variant
+ * after the first sweep, so a stale "no variant" verdict cannot outlive the
+ * route it described.
+ * @param ctx - plugin context with the `llm` service.
+ * @param getConfig - resolves the current plugin configuration per verdict.
+ * @returns the cached verdict resolver for the Web paste-policy route.
+ */
+export declare function createPasteTakeoverResolver(ctx: Context, getConfig: () => ResolvedVisionToolkitConfig): (sessionId: string, selection?: PasteSelectionQuery, modelLabel?: string) => Promise<PasteVerdict>;
+/**
+ * Register and maintain one variant route per eligible upstream route. Routes
+ * that later vanish are released; routes that gain eligible models later are
+ * picked up by the next sweep (host topology notifications included).
+ * @param ctx - plugin context with the `llm` service.
+ * @param getConfig - resolves the current plugin configuration per sweep.
+ * @param getRuntime - the currently serving Vision Toolkit runtime, if ready.
+ * @returns the disposer and a manual re-sweep trigger (settings changes).
+ */
+export declare function installImageInputVariants(ctx: Context, getConfig: () => ResolvedVisionToolkitConfig, getRuntime: () => VisionToolkitRuntime | undefined): {
+    dispose: () => void;
+    reconcile: () => void;
+};
+//# sourceMappingURL=image-input-variants.d.ts.map

package/lib/types/image-input-variants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-input-variants.d.ts","sourceRoot":"","sources":["../../src/image-input-variants.ts"],"names":[],"mappings":"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"}

package/lib/types/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @mengruo/dsh-vision-toolkit — DSH Vision Toolkit profile bundle.
+ *
+ * Plugin lifecycle follows the documented readiness chain: verify the pinned
+ * upstream checkout, publish the vision-skills Skill and its one-shot bootstrap,
+ * then mount the execution tools only in Agents that load that Skill or invoke
+ * the bootstrap. Any
+ * failure leaves no model capability behind, and disposal unregisters every
+ * global and Agent-scoped contribution the plugin mounted.
+ * @module @mengruo/dsh-vision-toolkit
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import { Config, type VisionToolkitConfig } from './config.ts';
+export declare const name = "@mengruo/dsh-vision-toolkit";
+export { Config };
+export declare const inject: string[];
+/** Plugin entry: validate configuration synchronously, then mount asynchronously. */
+export declare function apply(ctx: Context, config?: VisionToolkitConfig): Promise<() => void>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAKlD,OAAO,EACL,MAAM,EAGN,KAAK,mBAAmB,EACzB,MAAM,aAAa,CAAA;AAUpB,eAAO,MAAM,IAAI,gCAAgC,CAAA;AAEjD,OAAO,EAAE,MAAM,EAAE,CAAA;AAEjB,eAAO,MAAM,MAAM,UAAqF,CAAA;AAExG,qFAAqF;AACrF,wBAAsB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,mBAAwB,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAqG/F"}