@mengruo/dsh-vision-toolkit 0.0.1

package/lib/types/runtime.d.ts

@@ -0,0 +1,412 @@
+/**
+ * Vision Toolkit runtime: structured requests in, structured results out.
+ * One operation-wide deadline reaches every subprocess; image decoding,
+ * byte/pixel limits, session-scoped concurrency, credential resolution, safe
+ * output staging, and diagnostic logging stay below the model-facing tools.
+ * @module dsh-vision-toolkit/runtime
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import { type ArtifactDescriptor } from './artifacts.ts';
+import { type ResolvedVisionToolkitConfig } from './config.ts';
+import { UpstreamAdapter, type DominantColorsOutput, type UpstreamEnvironment, type UpstreamVersionInfo } from './upstream.ts';
+/** Per-invocation cancellation and timeout facts. */
+export interface Deadline {
+    signal: AbortSignal;
+    /** True when the deadline timer fired. */
+    timedOut: boolean;
+    /** True when the caller signal fired first. */
+    cancelled: boolean;
+    /** Clear the timer and caller listener. */
+    cleanup(): void;
+}
+/** Combine a caller abort signal with one hard operation timeout. */
+export declare function createDeadline(signal: AbortSignal, timeoutMs: number): Deadline;
+/** FIFO bounded concurrency gate whose queued callers remain cancellable. */
+export declare class Semaphore {
+    private readonly limit;
+    private active;
+    private readonly waiters;
+    constructor(limit: number);
+    /** Whether no active or queued caller still owns this gate. */
+    get idle(): boolean;
+    /** Acquire one slot, aborting while queued when `signal` fires. */
+    acquire(signal: AbortSignal, permits?: number): Promise<void>;
+    /** Release owned permits and wake FIFO waiters whose full weight now fits. */
+    release(permits?: number): void;
+}
+/** Validated image metadata retained in structured results and diagnostics. */
+export interface ImageInfo {
+    path: string;
+    bytes: number;
+    width: number;
+    height: number;
+    format: string;
+    /** Original user-facing image path before any automatic compression. */
+    originalPath: string;
+}
+/** Structured input for one glance call. */
+export interface GlanceRequest {
+    images: string[];
+    query?: string;
+    ocr?: boolean;
+    region?: string;
+}
+/** Structured glance result. */
+export interface GlanceResult {
+    images: ImageInfo[];
+    mode: 'describe' | 'qa' | 'ocr';
+    answer: string;
+    truncated: boolean;
+}
+/** Structured input for ground/detect. */
+export interface LocateRequest {
+    image: string;
+    target: string;
+    region?: string;
+}
+/** One located element with an upstream or caller label. */
+export interface LocateMatch {
+    label: string;
+    box: {
+        x1: number;
+        y1: number;
+        x2: number;
+        y2: number;
+    };
+}
+/** Structured ground result. */
+export interface GroundResult {
+    target: string;
+    image: ImageInfo;
+    imageWidth: number;
+    imageHeight: number;
+    matches: LocateMatch[];
+    preview?: ArtifactDescriptor;
+}
+/** Structured detect result. */
+export interface DetectResult {
+    category: string;
+    image: ImageInfo;
+    imageWidth: number;
+    imageHeight: number;
+    elements: Array<{
+        index: number;
+        label: string;
+        box: {
+            x1: number;
+            y1: number;
+            x2: number;
+            y2: number;
+        };
+    }>;
+    preview?: ArtifactDescriptor;
+}
+/** Structured crop request. */
+export interface CropRequest {
+    image: string;
+    region: string;
+    scale?: number;
+    output?: string;
+}
+/** Structured crop result. */
+export interface CropResult {
+    imageWidth: number;
+    imageHeight: number;
+    region: {
+        x1: number;
+        y1: number;
+        x2: number;
+        y2: number;
+    };
+    outputPath: string;
+    mimeType: 'image/png' | 'image/jpeg';
+    width: number;
+    height: number;
+    clamped: boolean;
+    artifact: ArtifactDescriptor;
+    note?: string;
+}
+/** Structured trace request supported by the pinned upstream snapshot. */
+export interface TraceRequest {
+    image: string;
+    region?: string;
+    scale?: number;
+    color?: boolean;
+    polygon?: boolean;
+    output?: string;
+}
+/** Structured trace result. */
+export interface TraceResult {
+    imageWidth: number;
+    imageHeight: number;
+    outputPath: string;
+    mimeType: 'image/svg+xml';
+    geometry: {
+        status: 'generated' | 'empty';
+        pathCount: number;
+        tracedScale: number;
+        bytes: number;
+    };
+    artifact: ArtifactDescriptor;
+    warning?: string;
+}
+/** Structured input for local image comparison. */
+export interface PixelDiffRequest {
+    original: string;
+    rebuilt: string;
+    grid?: number;
+    top?: number;
+    runName?: string;
+}
+/** Structured local pixel comparison plus formally delivered files. */
+export interface PixelDiffResult {
+    original: ImageInfo;
+    rebuilt: ImageInfo;
+    scaled: boolean;
+    rebuiltOriginalSize?: {
+        width: number;
+        height: number;
+    };
+    overallDifferencePct: number;
+    worstRegions: Array<{
+        index: number;
+        differencePct: number;
+        box: {
+            x1: number;
+            y1: number;
+            x2: number;
+            y2: number;
+        };
+    }>;
+    heatmap: ArtifactDescriptor;
+    report: ArtifactDescriptor;
+}
+/** Structured input for the pinned long-screenshot OCR pipeline. */
+export interface LongScreenshotOcrRequest {
+    image: string;
+    mode?: 'general' | 'chat';
+    output?: string;
+    runName?: string;
+    targetHeight?: number;
+    minHeight?: number;
+    maxHeight?: number;
+    overlap?: number;
+    prompt?: string;
+    jobs?: number;
+    chunkTimeoutSeconds?: number;
+    splitOnly?: boolean;
+    resume?: boolean;
+}
+/** One long-OCR chunk and the files retained for audit or reuse. */
+export interface LongScreenshotChunk {
+    index: number;
+    coreTop: number;
+    coreBottom: number;
+    cropTop: number;
+    cropBottom: number;
+    image: ArtifactDescriptor;
+    ocr?: ArtifactDescriptor;
+    reused?: boolean;
+}
+/** Long-screenshot split/OCR result with every durable deliverable. */
+export interface LongScreenshotOcrResult {
+    source: ImageInfo;
+    mode: 'general' | 'chat';
+    splitOnly: boolean;
+    complete: boolean;
+    chunkCount: number;
+    runDirectory: string;
+    output?: ArtifactDescriptor;
+    manifest: ArtifactDescriptor;
+    audit?: ArtifactDescriptor;
+    chunks: LongScreenshotChunk[];
+}
+/** Structured input for transparent foreground extraction. */
+export interface ExtractForegroundRequest {
+    image: string;
+    region?: string;
+    boxes?: string;
+    mode?: 'color' | 'dark';
+    discRadius?: number;
+    saturation?: number;
+    darkThreshold?: number;
+    excludeColor?: string;
+    excludeTolerance?: number;
+    padding?: number;
+    keepWhites?: boolean;
+    output?: string;
+}
+/** Transparent foreground file plus the pinned script's component metrics. */
+export interface ExtractForegroundResult {
+    source: ImageInfo;
+    box: {
+        x1: number;
+        y1: number;
+        x2: number;
+        y2: number;
+    };
+    foregroundPixels: number;
+    keptComponents: number;
+    totalComponents: number;
+    largestComponentPct: number;
+    width: number;
+    height: number;
+    artifact: ArtifactDescriptor;
+    autoSummary?: string;
+}
+/** Structured input for palette extraction or candidate scoring. */
+export interface DominantColorsRequest {
+    image: string;
+    region?: string;
+    candidates?: string[];
+    top?: number;
+    quantize?: number;
+    maxPixels?: number;
+    mergeTolerance?: number;
+    candidateTolerance?: number;
+}
+/** Stable dominant-colour result enriched with source image facts. */
+export interface DominantColorsResult {
+    image: ImageInfo;
+    analysis: DominantColorsOutput;
+}
+/** Structured input for rendering an authorized local HTML document. */
+export interface HtmlScreenshotRequest {
+    source: string;
+    width?: number;
+    height?: number;
+    scale?: number;
+    waitMs?: number;
+    fullPage?: boolean;
+    output?: string;
+}
+/** Browser-rendered PNG plus viewport and source facts. */
+export interface HtmlScreenshotResult {
+    sourcePath: string;
+    sourceBytes: number;
+    viewport: {
+        width: number;
+        height: number;
+        scale: number;
+    };
+    width: number;
+    height: number;
+    /** Full document height in CSS pixels; present only for full-page captures. */
+    pageHeight?: number;
+    artifact: ArtifactDescriptor;
+}
+/** Optional preview controls shared by ground and detect. */
+export interface LocatePreviewRequest extends LocateRequest {
+    preview?: boolean;
+    previewOutput?: string;
+}
+/** One named health-check state. */
+export interface HealthCheck {
+    status: 'ok' | 'warning' | 'error' | 'not_tested';
+    detail: string;
+}
+/** Runtime, dependency, storage, credential, and optional service health. */
+export interface VisionToolkitHealthResult {
+    pluginVersion: string;
+    upstream: UpstreamVersionInfo;
+    checks: {
+        python: HealthCheck;
+        dependencies: HealthCheck;
+        chrome: HealthCheck;
+        credential: HealthCheck;
+        artifactDirectory: HealthCheck;
+        tempDirectory: HealthCheck;
+        service: HealthCheck;
+        model: HealthCheck;
+    };
+    healthy: boolean;
+    connectionTested: boolean;
+    modelTested: boolean;
+}
+/** Shared per-call execution options. */
+export interface ToolCallOptions {
+    signal: AbortSignal;
+    timeoutMs?: number;
+    workspace: string;
+    /** Session identity for the per-session concurrency cap. */
+    sessionId?: string;
+    /** Live Session object whose lifetime bounds the one-entry glance cache. */
+    sessionScope?: object;
+}
+/** One immutable vision-service snapshot used to generate cache-keyed evidence. */
+export interface CapturedEvidenceRuntime {
+    readonly evidenceFingerprint: string;
+    glance(request: GlanceRequest, options: ToolCallOptions): Promise<GlanceResult>;
+}
+/** Parse a non-empty four-integer pixel box. */
+export declare function parseRegion(region: string): {
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+};
+/** Runtime facade used by every native tool. */
+export declare class VisionToolkitRuntime {
+    private readonly ctx;
+    private readonly config;
+    private readonly semaphores;
+    private readonly glanceCache;
+    private readonly adapter;
+    constructor(ctx: Context, config: ResolvedVisionToolkitConfig, adapter?: UpstreamAdapter);
+    /** Pinned and prepared upstream identity. */
+    get upstreamVersion(): UpstreamVersionInfo;
+    /** Stable identity for persisted image descriptions produced by this runtime. */
+    get evidenceFingerprint(): string;
+    /** Capture the credential and provider identity used by one evidence conversion. */
+    captureEvidenceRuntime(): Promise<CapturedEvidenceRuntime>;
+    private timeout;
+    private operationError;
+    private semaphore;
+    private runOperation;
+    /** Resolve the configured credential at the remote-operation boundary. */
+    resolveVisionEnv(): Promise<UpstreamEnvironment>;
+    private visionEnv;
+    private pathPolicy;
+    private compressedImageRoot;
+    private readCacheCandidate;
+    private cacheEntryOutDigest;
+    private pruneCompressedCache;
+    private autoCompressImage;
+    private validateImage;
+    private accountImage;
+    private glanceCacheKey;
+    private runUpstream;
+    private probeGeneratedImage;
+    private annotateLocations;
+    /** glance: describe, targeted QA, OCR, or multi-image comparison. */
+    glance(request: GlanceRequest, options: ToolCallOptions): Promise<GlanceResult>;
+    private glanceWithEnv;
+    private validateLocations;
+    private locate;
+    /** ground: locate one named target and return pixel boxes. */
+    ground(request: LocatePreviewRequest, options: ToolCallOptions): Promise<GroundResult>;
+    /** detect: inventory every instance of a kind. */
+    detect(request: LocatePreviewRequest, options: ToolCallOptions): Promise<DetectResult>;
+    /** crop: cut a pixel box into its own image file without requiring a credential. */
+    crop(request: CropRequest, options: ToolCallOptions): Promise<CropResult>;
+    /** trace: recover an SVG through the pinned upstream vtracer pipeline. */
+    trace(request: TraceRequest, options: ToolCallOptions): Promise<TraceResult>;
+    /** pixel_diff: compare real pixels, rank error regions, and deliver a heatmap plus JSON report. */
+    pixelDiff(request: PixelDiffRequest, options: ToolCallOptions): Promise<PixelDiffResult>;
+    /** long_screenshot_ocr: split safely, optionally OCR, and atomically deliver the complete audit run. */
+    longScreenshotOcr(request: LongScreenshotOcrRequest, options: ToolCallOptions): Promise<LongScreenshotOcrResult>;
+    /** extract_foreground: preserve the pinned component selection and deliver an RGBA PNG. */
+    extractForeground(request: ExtractForegroundRequest, options: ToolCallOptions): Promise<ExtractForegroundResult>;
+    /** dominant_colors: expose palette clusters or candidate scores as structure, never stdout prose. */
+    dominantColors(request: DominantColorsRequest, options: ToolCallOptions): Promise<DominantColorsResult>;
+    /** html_screenshot: render only a path-fenced local HTML file in the pinned Chrome adapter. */
+    htmlScreenshot(request: HtmlScreenshotRequest, options: ToolCallOptions): Promise<HtmlScreenshotResult>;
+    private writableDirectoryCheck;
+    /** Health: inspect local readiness, optionally probe `/models`, and explicitly test one real multimodal request. */
+    health(testConnection: boolean, options: ToolCallOptions, testModel?: boolean): Promise<VisionToolkitHealthResult>;
+    /** Report the packaged upstream snapshot version. */
+    checkoutVersion(): Promise<string>;
+    /** Prepared Python command. */
+    python(): string;
+}
+//# sourceMappingURL=runtime.d.ts.map

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

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

package/lib/types/skill.d.ts

@@ -0,0 +1,14 @@
+/**
+ * DSH-native adapter for the upstream vision-tools Skill and playbooks.
+ * @module dsh-vision-toolkit/skill
+ */
+import type { SkillRegistration } from '@deepseek-ai/dsh-skill';
+/** Stable catalog/invocation name shared with progressive tool exposure. */
+export declare const VISION_SKILLS_NAME = "vision-skills";
+/** Packaged resource root for the adapted upstream playbooks. */
+export declare const VISION_SKILLS_RESOURCE_BASE: string;
+/** Exact bundled instructions used as the progressive-exposure evidence marker. */
+export declare const VISION_SKILLS_CONTENT: string;
+/** Runtime skill registration mounted only after every native tool is ready. */
+export declare const VISION_SKILLS_SKILL: SkillRegistration;
+//# sourceMappingURL=skill.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../src/skill.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAE/D,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,kBAAkB,CAAA;AAEjD,iEAAiE;AACjE,eAAO,MAAM,2BAA2B,QAEvC,CAAA;AAED,mFAAmF;AACnF,eAAO,MAAM,qBAAqB,QAGjC,CAAA;AAED,gFAAgF;AAChF,eAAO,MAAM,mBAAmB,EAAE,iBAUjC,CAAA"}

package/lib/types/tools.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Model-facing native tools. Every definition projects one structured runtime
+ * operation, declares replay-safe file locations, and preserves canonical
+ * result metadata for the optional Web client without changing Headless or
+ * model-visible semantics.
+ * @module dsh-vision-toolkit/tools
+ */
+import { defineTool, type JsonValue } from '@deepseek-ai/dsh-tools';
+import { VisionToolkitRuntime } from './runtime.ts';
+/** Canonical names shared by registration, bootstrap guidance, and tests. */
+export declare const VISION_TOOL_NAMES: {
+    readonly glance: "vision_glance";
+    readonly ground: "vision_ground";
+    readonly detect: "vision_detect";
+    readonly trace: "vision_trace";
+    readonly crop: "vision_crop";
+    readonly pixelDiff: "vision_pixel_diff";
+    readonly longScreenshotOcr: "vision_long_screenshot_ocr";
+    readonly extractForeground: "vision_extract_foreground";
+    readonly dominantColors: "vision_dominant_colors";
+    readonly htmlScreenshot: "vision_html_screenshot";
+};
+/** Runtime lookup accepted by tools so Settings can atomically swap generations. */
+export type VisionToolkitRuntimeSource = VisionToolkitRuntime | (() => VisionToolkitRuntime);
+/** Browser-only metadata projector; the model-visible value remains unchanged. */
+export type VisionToolkitPresentationProjector = (value: JsonValue) => JsonValue;
+/**
+ * Build the complete P0/P1 tool set from one live runtime source.
+ * @param source - Current runtime or atomic runtime lookup.
+ * @param projectPresentation - Browser-only projection for Artifact capabilities.
+ * @param lifecycleSignal - Plugin lifetime; aborting it cancels every active tool call.
+ * @returns Native tool definitions registered as one lifecycle generation.
+ */
+export declare function createVisionTools(source: VisionToolkitRuntimeSource, projectPresentation?: VisionToolkitPresentationProjector, lifecycleSignal?: AbortSignal): ReturnType<typeof defineTool>[];
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,UAAU,EAAE,KAAK,SAAS,EAA6C,MAAM,wBAAwB,CAAA;AAC9G,OAAO,EACL,oBAAoB,EAWrB,MAAM,cAAc,CAAA;AAerB,6EAA6E;AAC7E,eAAO,MAAM,iBAAiB;;;;;;;;;;;CAWpB,CAAA;AAqHV,oFAAoF;AACpF,MAAM,MAAM,0BAA0B,GAAG,oBAAoB,GAAG,CAAC,MAAM,oBAAoB,CAAC,CAAA;AAE5F,kFAAkF;AAClF,MAAM,MAAM,kCAAkC,GAAG,CAAC,KAAK,EAAE,SAAS,KAAK,SAAS,CAAA;AAMhF;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,0BAA0B,EAClC,mBAAmB,GAAE,kCAAyD,EAC9E,eAAe,CAAC,EAAE,WAAW,GAC5B,UAAU,CAAC,OAAO,UAAU,CAAC,EAAE,CAmZjC"}