@yadsh/dsh-qa-surface 0.6.1 → 0.7.1

package/lib/documents/tools/inspect.js

@@ -1,135 +0,0 @@
-/**
- * `document_inspect` — what a document is, without converting it (§11, §34).
- */
-import { defineTool } from "@deepseek-ai/dsh-tools";
-import { fileParameter, formatBytes, renderWarning, requireDocumentScope, toolWarnings, warningsSchema, } from "./shared.js";
-export const DOCUMENT_INSPECT_TOOL = "document_inspect";
-const DESCRIPTION = [
-    "Inspect document type, metadata and basic structure without converting it.",
-    "Reports the detected format, size, hash, document properties, page/heading/table/image counts and whether the file is encrypted or macro-enabled.",
-].join(" ");
-function structureLines(value) {
-    const structure = value.structure;
-    if (structure === undefined)
-        return [];
-    return Object.entries(structure)
-        .filter(([, count]) => typeof count === "number")
-        .map(([name, count]) => `${name}: ${String(count)}`);
-}
-export function createDocumentInspectTool(options) {
-    return defineTool({
-        name: DOCUMENT_INSPECT_TOOL,
-        description: DESCRIPTION,
-        parameters: { file: fileParameter() },
-        output: {
-            schema: {
-                type: "object",
-                additionalProperties: false,
-                properties: {
-                    filename: { type: "string", required: true },
-                    format: { type: "string", required: true },
-                    mediaType: { type: "string", required: true },
-                    size: { type: "number", required: true },
-                    sha256: { type: "string", required: true },
-                    metadata: {
-                        type: "object",
-                        additionalProperties: false,
-                        properties: {
-                            title: { type: "string" },
-                            author: { type: "string" },
-                            createdAt: { type: "string" },
-                            modifiedAt: { type: "string" },
-                        },
-                    },
-                    structure: {
-                        type: "object",
-                        additionalProperties: false,
-                        properties: {
-                            pages: { type: "number" },
-                            headings: { type: "number" },
-                            tables: { type: "number" },
-                            images: { type: "number" },
-                        },
-                    },
-                    encrypted: { type: "boolean" },
-                    macroEnabled: { type: "boolean" },
-                    warnings: warningsSchema,
-                },
-            },
-            render: (_args, value) => {
-                const result = value;
-                return [
-                    {
-                        type: "text",
-                        text: [
-                            `${result.filename}: ${result.format} (${result.mediaType})`,
-                            `size: ${formatBytes(result.size)}, sha256: ${result.sha256}`,
-                            ...(result.encrypted === true ? ["encrypted: yes"] : []),
-                            ...(result.macroEnabled === true ? ["macro-enabled: yes"] : []),
-                            ...(result.metadata === undefined
-                                ? []
-                                : Object.entries(result.metadata).map(([key, entry]) => `${key}: ${entry}`)),
-                            ...structureLines(result),
-                            ...result.warnings.map(renderWarning),
-                        ].join("\n"),
-                    },
-                ];
-            },
-        },
-        timeoutMs: 30_000,
-        async execute(args, exec) {
-            const result = await options.runtime.inspect(args, requireDocumentScope(exec));
-            return {
-                filename: result.filename,
-                format: result.format,
-                mediaType: result.mediaType,
-                size: result.size,
-                sha256: result.sha256,
-                ...(result.metadata === undefined
-                    ? {}
-                    : {
-                        metadata: {
-                            ...(result.metadata.title === undefined
-                                ? {}
-                                : { title: result.metadata.title }),
-                            ...(result.metadata.author === undefined
-                                ? {}
-                                : { author: result.metadata.author }),
-                            ...(result.metadata.createdAt === undefined
-                                ? {}
-                                : { createdAt: result.metadata.createdAt }),
-                            ...(result.metadata.modifiedAt === undefined
-                                ? {}
-                                : { modifiedAt: result.metadata.modifiedAt }),
-                        },
-                    }),
-                ...(result.structure === undefined
-                    ? {}
-                    : {
-                        structure: {
-                            ...(result.structure.pages === undefined
-                                ? {}
-                                : { pages: result.structure.pages }),
-                            ...(result.structure.headings === undefined
-                                ? {}
-                                : { headings: result.structure.headings }),
-                            ...(result.structure.tables === undefined
-                                ? {}
-                                : { tables: result.structure.tables }),
-                            ...(result.structure.images === undefined
-                                ? {}
-                                : { images: result.structure.images }),
-                        },
-                    }),
-                ...(result.encrypted === undefined
-                    ? {}
-                    : { encrypted: result.encrypted }),
-                ...(result.macroEnabled === undefined
-                    ? {}
-                    : { macroEnabled: result.macroEnabled }),
-                warnings: toolWarnings(result.warnings),
-            };
-        },
-    });
-}
-//# sourceMappingURL=inspect.js.map

package/lib/documents/tools/inspect.js.map

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

package/lib/documents/tools/shared.js

@@ -1,88 +0,0 @@
-/**
- * What the four document tools share: the calling session's scope, the output
- * shapes they render, and the warning formatter.
- *
- * A tool is a thin adapter. It reads the session's working directory (the
- * artifact root and the allowed input roots both derive from it), hands intent
- * to the runtime, and renders the structured result for the model. No tool
- * knows a backend name beyond the one the result reports.
- */
-import { DocumentError } from "../errors.js";
-export function toolWarnings(warnings) {
-    return warnings.map((warning) => ({
-        code: warning.code,
-        message: warning.message,
-        ...(warning.backend === undefined ? {} : { backend: warning.backend }),
-    }));
-}
-/** Shared output-schema fragment for the `warnings` array of every tool. */
-export const warningsSchema = {
-    type: "array",
-    items: {
-        type: "object",
-        additionalProperties: false,
-        properties: {
-            code: { type: "string", required: true },
-            message: { type: "string", required: true },
-            backend: { type: "string" },
-        },
-    },
-};
-/** Mutable projection of a produced file for the tool result. */
-export function toolFiles(files) {
-    return files.map((file) => ({
-        format: file.format,
-        path: file.path,
-        mediaType: file.mediaType,
-        size: file.size,
-        sha256: file.sha256,
-        status: file.status,
-        ...(file.error === undefined ? {} : { error: file.error }),
-    }));
-}
-/**
- * Resolve the session scope, failing closed: a session without a working
- * directory gets no document access rather than the host process's cwd.
- */ export function requireDocumentScope(exec) {
-    const header = exec.agent?.session.header;
-    const cwd = header?.cwd;
-    if (typeof cwd !== "string" || cwd.trim() === "") {
-        throw new DocumentError("INVALID_INPUT", "this tool requires a calling session with a working directory");
-    }
-    const sessionId = header?.id === undefined ? undefined : String(header.id);
-    return {
-        workspaceRoot: cwd,
-        ...(sessionId === undefined ? {} : { sessionId }),
-        ...(exec.signal === undefined ? {} : { signal: exec.signal }),
-    };
-}
-export function fileParameter() {
-    return {
-        type: "string",
-        required: true,
-        description: "Path to the document. Relative paths start at the session working directory and must " +
-            "stay inside it or a configured document root.",
-    };
-}
-export function formatBytes(bytes) {
-    if (bytes < 1024)
-        return `${bytes} B`;
-    if (bytes < 1024 * 1024)
-        return `${(bytes / 1024).toFixed(1)} KiB`;
-    return `${(bytes / (1024 * 1024)).toFixed(1)} MiB`;
-}
-export function renderWarning(warning) {
-    const backend = warning.backend === undefined ? "" : ` [${warning.backend}]`;
-    return `warning ${warning.code}${backend}: ${warning.message}`;
-}
-/** One line per produced file, plus failed formats explicitly named. */
-export function renderFiles(files) {
-    return files.map((file) => {
-        if (file.status === "failed") {
-            return `${file.format}: failed (${file.error ?? "unknown error"})`;
-        }
-        return `${file.format}: ${file.path} (${formatBytes(file.size)}, sha256 ${file.sha256.slice(0, 16)}…)`;
-    });
-}
-export const ARTIFACT_NOTE = "The artifact directory keeps the source, the assets and manifest.json beside the outputs.";
-//# sourceMappingURL=shared.js.map

package/lib/documents/tools/shared.js.map

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

package/lib/documents/tools/to-markdown.js

@@ -1,125 +0,0 @@
-/**
- * `document_to_markdown` — DOCX/PDF to Markdown (§9, §34).
- *
- * The model gets the extracted text and a path to the full copy; the artifact
- * bundle keeps the input, the extracted Markdown and any extracted images.
- */
-import { defineTool } from "@deepseek-ai/dsh-tools";
-import { fileParameter, renderWarning, requireDocumentScope, toolWarnings, warningsSchema, } from "./shared.js";
-export const DOCUMENT_TO_MARKDOWN_TOOL = "document_to_markdown";
-const DESCRIPTION = [
-    "Extract a DOCX or PDF into Markdown.",
-    "Supports structured extraction, tables and images, and applies OCR when the document has no text layer.",
-    "Returns the Markdown plus the path of the extracted file inside its artifact bundle.",
-].join(" ");
-export function createDocumentToMarkdownTool(options) {
-    return defineTool({
-        name: DOCUMENT_TO_MARKDOWN_TOOL,
-        description: DESCRIPTION,
-        parameters: {
-            file: fileParameter(),
-            mode: {
-                type: "string",
-                enum: ["auto", "fast", "accurate"],
-                description: "Extraction route. `accurate` (default) uses the layout-aware extractor; `fast` prefers the light extractor when the deployment enables one.",
-            },
-            ocr: {
-                type: "string",
-                enum: ["auto", "off", "force"],
-                description: "OCR policy: `auto` lets the extractor decide per page, `off` never runs OCR, `force` always runs it.",
-            },
-            ocrLanguages: {
-                type: "array",
-                items: { type: "string" },
-                description: 'OCR languages, e.g. ["rus", "eng"].',
-            },
-            extractImages: {
-                type: "boolean",
-                description: "Write extracted images into the bundle's assets directory.",
-            },
-            extractTables: {
-                type: "boolean",
-                description: "Use the accurate table extraction mode.",
-            },
-            preservePageMarkers: {
-                type: "boolean",
-                description: "Keep page boundaries in the extracted Markdown where the extractor reports them.",
-            },
-            outputFilename: {
-                type: "string",
-                description: "Name of the extracted Markdown file inside the artifact bundle.",
-            },
-        },
-        output: {
-            schema: {
-                type: "object",
-                additionalProperties: false,
-                properties: {
-                    artifactId: { type: "string", required: true },
-                    markdown: { type: "string", required: true },
-                    markdownPath: { type: "string", required: true },
-                    assets: {
-                        type: "array",
-                        items: {
-                            type: "object",
-                            additionalProperties: false,
-                            properties: {
-                                path: { type: "string", required: true },
-                                mediaType: { type: "string", required: true },
-                            },
-                        },
-                    },
-                    pages: { type: "number" },
-                    backend: { type: "string", required: true },
-                    warnings: warningsSchema,
-                    manifestPath: { type: "string", required: true },
-                },
-            },
-            render: (_args, value) => {
-                const result = value;
-                return [
-                    {
-                        type: "text",
-                        text: [
-                            `artifact: ${result.artifactId} (extracted by ${result.backend})`,
-                            ...(result.pages === undefined ? [] : [`pages: ${result.pages}`]),
-                            `markdown: ${result.markdownPath}`,
-                            ...(result.assets === undefined
-                                ? []
-                                : [
-                                    `assets: ${result.assets.map((asset) => asset.path).join(", ")}`,
-                                ]),
-                            ...result.warnings.map(renderWarning),
-                            "---",
-                            result.markdown,
-                        ].join("\n"),
-                    },
-                ];
-            },
-        },
-        timeoutMs: options.runtime.config.docling.timeoutMs +
-            options.runtime.config.markitdown.timeoutMs +
-            30_000,
-        async execute(args, exec) {
-            const result = await options.runtime.toMarkdown(args, requireDocumentScope(exec));
-            return {
-                artifactId: result.artifactId,
-                markdown: result.markdown,
-                markdownPath: result.markdownPath,
-                ...(result.assets === undefined
-                    ? {}
-                    : {
-                        assets: result.assets.map((asset) => ({
-                            path: asset.path,
-                            mediaType: asset.mediaType,
-                        })),
-                    }),
-                ...(result.pages === undefined ? {} : { pages: result.pages }),
-                backend: result.backend,
-                warnings: toolWarnings(result.warnings),
-                manifestPath: result.manifestPath,
-            };
-        },
-    });
-}
-//# sourceMappingURL=to-markdown.js.map

package/lib/documents/tools/to-markdown.js.map

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

package/lib/documents/types.js

@@ -1,12 +0,0 @@
-/**
- * Public types of the QA Surface document pipeline.
- *
- * The shapes here are the contract the agent sees (tool inputs and results),
- * the contract the artifact store persists (manifest), and the contract the
- * providers implement. They are deliberately free of any backend vocabulary:
- * a tool result never names pandoc, LibreOffice or Docling, so a provider can
- * be replaced without touching a prompt, a skill or a workflow
- * (docs/specs/document-pipeline.md §4.1, §22).
- */
-export {};
-//# sourceMappingURL=types.js.map

package/lib/documents/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/documents/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/lib/types/client/settings/sections/documents.d.ts

@@ -1,13 +0,0 @@
-/**
- * Documents: the document pipeline's deployment knobs.
- *
- * Everything here is optional — the defaults are usable as they are — but two
- * of them decide whether the four document tools work at all in a given
- * deployment: the Docling endpoint and the executables the renderer needs.
- * The section therefore shows the effective values the Host resolved, not only
- * what this browser has written.
- */
-import { type ConfigProps } from "./common.js";
-/** Document creation, conversion and extraction. */
-export declare function DocumentsSection(props: ConfigProps): import("react/jsx-runtime").JSX.Element;
-//# sourceMappingURL=documents.d.ts.map

package/lib/types/documents/artifacts/ids.d.ts

@@ -1,14 +0,0 @@
-/**
- * ULID generation for artifact ids (§18).
- *
- * `doc_<ULID>` — 48 bits of time followed by 80 bits of randomness, encoded in
- * Crockford base32. The time prefix keeps a directory listing chronological,
- * and the randomness keeps ids unguessable without a UUID dependency.
- */
-/** A fresh ULID for the current millisecond. */
-export declare function createUlid(now?: number): string;
-/** A fresh artifact id: `doc_<ULID>`. */
-export declare function createArtifactId(now?: number): string;
-/** Whether a string is an artifact id this pipeline could have issued. */
-export declare function isArtifactId(value: string): boolean;
-//# sourceMappingURL=ids.d.ts.map

package/lib/types/documents/artifacts/manifest.d.ts

@@ -1,32 +0,0 @@
-/**
- * Manifest construction and persistence (§19).
- *
- * The manifest is the source of truth about an artifact: which operation,
- * which backends and versions, which template (and its hash), which files came
- * out, which warnings were raised, and which session/workspace the bundle
- * belongs to. Logical reproducibility rests on it, because byte-level
- * reproducibility of DOCX/PDF cannot be promised (§31).
- */
-import type { BackendInfo, DocumentFileResult, DocumentFormat, DocumentManifest, DocumentWarning } from "../types.js";
-import type { ArtifactStore } from "./store.js";
-export declare const MANIFEST_FILE = "manifest.json";
-export declare const MANIFEST_SCHEMA_VERSION: 1;
-export interface BuildManifestInput {
-    readonly artifactId: string;
-    readonly operation: DocumentManifest["operation"];
-    readonly createdAt: string;
-    readonly input: DocumentManifest["input"];
-    readonly outputs: DocumentManifest["outputs"];
-    readonly template?: string;
-    readonly templateSha256?: string;
-    readonly backends: Readonly<Record<string, BackendInfo>>;
-    readonly warnings: readonly DocumentWarning[];
-    readonly scope: DocumentManifest["scope"];
-}
-export declare function buildManifest(input: BuildManifestInput): DocumentManifest;
-export declare function writeManifest(store: ArtifactStore, artifactId: string, manifest: DocumentManifest): Promise<string>;
-export declare function readManifest(store: ArtifactStore, artifactId: string): Promise<DocumentManifest>;
-/** Project a tool-level file result onto the manifest's output record. */
-export declare function outputRecord(file: DocumentFileResult): DocumentManifest["outputs"][number];
-export declare function formatOfOperation(operation: DocumentManifest["operation"]): DocumentFormat | "unknown";
-//# sourceMappingURL=manifest.d.ts.map

package/lib/types/documents/artifacts/store.d.ts

@@ -1,67 +0,0 @@
-/**
- * Artifact bundle storage (§18, §47).
- *
- * One directory per operation:
- *
- * ```text
- * <root>/<artifact-id>/
- *   manifest.json
- *   source.md
- *   input/original.pdf
- *   assets/
- *   output.docx
- *   extracted.md
- * ```
- *
- * Everything the store writes goes through a root-relative path that is
- * validated first, and every file lands atomically (temp file + rename) so a
- * crashed host never leaves a half-written artifact that a later read would
- * trust. Job temp directories live under `<root>/.tmp` and are removed on both
- * success and failure (§47).
- */
-export interface FileFingerprint {
-    readonly path: string;
-    readonly size: number;
-    readonly sha256: string;
-}
-export declare function sha256Hex(data: string | Buffer): string;
-export declare function sha256OfFile(filePath: string): Promise<string>;
-export interface ArtifactStoreOptions {
-    /** Directory the bundles live in; created on demand. */
-    readonly root: string;
-}
-export declare class ArtifactStore {
-    readonly root: string;
-    constructor(options: ArtifactStoreOptions);
-    /** Absolute path of a root-relative artifact member, containment checked. */
-    path(relativePath: string): string;
-    artifactDir(artifactId: string): string;
-    /** Prepare a fresh bundle directory and return its id. */
-    create(now?: number): Promise<{
-        artifactId: string;
-        dir: string;
-    }>;
-    ensureDir(relativePath: string): Promise<string>;
-    /** Atomically write a root-relative member. */
-    write(relativePath: string, data: string | Buffer): Promise<FileFingerprint>;
-    read(relativePath: string): Promise<Buffer>;
-    fingerprint(relativePath: string): Promise<FileFingerprint>;
-    exists(relativePath: string): Promise<boolean>;
-    /** Job-scoped temp directory: never an artifact, always removed (§47). */
-    createWorkDir(jobId: string): Promise<string>;
-    removeWorkDir(dir: string): Promise<void>;
-    /** Bundle directories, newest first, with their modification time. */
-    list(): Promise<{
-        artifactId: string;
-        dir: string;
-        modifiedAt: Date;
-    }[]>;
-    /** Retention sweep (§41): drop bundles older than `maxAgeDays`. */
-    cleanup(options: {
-        readonly maxAgeDays: number;
-        readonly now?: Date;
-    }): Promise<{
-        removed: string[];
-    }>;
-}
-//# sourceMappingURL=store.d.ts.map

package/lib/types/documents/capabilities.d.ts

@@ -1,32 +0,0 @@
-/**
- * Capability discovery (§43) and backend health (§42).
- *
- * Health separates required from optional backends on purpose: a deployment
- * without Docling cannot extract PDFs, but it still creates documents, so the
- * subsystem reports `degraded` and names what is missing instead of declaring
- * itself down. An optional backend that was never enabled reports `disabled`,
- * which is not a fault.
- */
-import type { ResolvedQaDocumentsConfig } from "./config.js";
-import { type ProviderSeams, type ProviderSet } from "./providers/registry.js";
-import type { DocumentCapabilities, DocumentHealth } from "./types.js";
-import { type TemplateRegistry } from "./templates/registry.js";
-export interface HealthOptions {
-    readonly config: ResolvedQaDocumentsConfig;
-    readonly providers: ProviderSet;
-    /** Probe the two process-based backends; `false` answers from configuration. */
-    readonly probeProcessBackends?: boolean;
-}
-export declare function documentHealth(options: HealthOptions): Promise<DocumentHealth>;
-export declare function documentCapabilities(options: {
-    readonly config: ResolvedQaDocumentsConfig;
-    readonly providers: ProviderSet;
-    readonly templates: TemplateRegistry;
-}): DocumentCapabilities;
-/** Load the template registry of a workspace for capability reporting. */
-export declare function capabilitiesForRoot(options: {
-    readonly config: ResolvedQaDocumentsConfig;
-    readonly templateRoot: string | undefined;
-    readonly seams?: ProviderSeams;
-}): Promise<DocumentCapabilities>;
-//# sourceMappingURL=capabilities.d.ts.map

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

@@ -1,27 +0,0 @@
-/**
- * Configuration of the document subsystem (§20).
- *
- * The subsystem is part of the `qa-surface` namespace, so this resolver
- * follows the same shape as the other domains: it normalizes, validates and
- * freezes, and the schema in `src/config.ts` takes every default from
- * {@link DEFAULT_QA_DOCUMENTS_CONFIG} so an untouched deployment sends the
- * resolver nothing at all.
- *
- * Environment overrides are applied in `applyDocumentsEnvOverrides`, on the
- * way into the plugin, and only for the documented variables — a deployment
- * that injects secrets into the process environment does not thereby get to
- * reconfigure the pipeline.
- */
-import { type QaDocumentsConfig, type ResolvedQaDocumentsConfig } from "./defaults.js";
-export { DEFAULT_QA_DOCUMENTS_CONFIG, type QaDocumentsCommandConfig, type QaDocumentsConfig, type QaDocumentsCreateConfig, type QaDocumentsEndpointConfig, type QaDocumentsExtractionConfig, type QaDocumentsLimitsConfig, type QaDocumentsRetentionConfig, type QaDocumentsStorageConfig, type QaDocumentsTemplatesConfig, type QaDocumentsWorkersConfig, type ResolvedQaDocumentsConfig, } from "./defaults.js";
-/** Materialize and validate the document configuration. */
-export declare function resolveDocumentsConfig(input?: QaDocumentsConfig): ResolvedQaDocumentsConfig;
-/**
- * Apply the documented environment overrides (§20). Kept out of
- * {@link resolveDocumentsConfig} so the resolver stays a pure function of its
- * input — configuration tests never depend on the ambient environment.
- */
-export declare function applyDocumentsEnvOverrides(config: QaDocumentsConfig, env: NodeJS.ProcessEnv): QaDocumentsConfig;
-/** Milliseconds a retention sweep interval would wait. */
-export declare function retentionIntervalMs(config: ResolvedQaDocumentsConfig): number;
-//# sourceMappingURL=config.d.ts.map