@anionex/dsh-vision-toolkit 0.1.5

package/lib/artifact-access.js

@@ -0,0 +1,369 @@
+/**
+ * Capability-gated HTTP delivery for managed Vision Toolkit artifacts.
+ * Signed tokens are durable across process restarts, expose no secret, and
+ * are accepted only for the exact artifact facts projected into a tool result.
+ * @module dsh-vision-toolkit/artifact-access
+ */
+import { createHmac, randomBytes, timingSafeEqual } from 'node:crypto';
+import { constants as fsConstants } from 'node:fs';
+import { chmod, lstat, mkdir, open, readFile, realpath, writeFile } from 'node:fs/promises';
+import { basename, dirname, extname, isAbsolute, join, relative, sep } from 'node:path';
+import { isWithin } from "./paths.js";
+import { visionToolkitStateRoot } from "./runtime-install.js";
+/** Prefix owned by the plugin's artifact capability route. */
+export const ARTIFACT_ROUTE_PREFIX = '/_dsh/vision-toolkit/artifacts';
+/** Presentation metadata key reserved by the browser half of this package. */
+export const PRESENTATION_META_KEY = '$dshVisionToolkit';
+const KEY_BYTES = 32;
+const TOKEN_PATTERN = /^[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+$/;
+const MAX_TOKEN_LENGTH = 16 * 1024;
+const MIME_BY_EXTENSION = new Map([
+    ['.png', { mimeType: 'image/png', kind: 'image' }],
+    ['.jpg', { mimeType: 'image/jpeg', kind: 'image' }],
+    ['.jpeg', { mimeType: 'image/jpeg', kind: 'image' }],
+    ['.gif', { mimeType: 'image/gif', kind: 'image' }],
+    ['.webp', { mimeType: 'image/webp', kind: 'image' }],
+    ['.svg', { mimeType: 'image/svg+xml', kind: 'svg' }],
+    ['.md', { mimeType: 'text/markdown', kind: 'markdown' }],
+    ['.json', { mimeType: 'application/json', kind: 'json' }],
+]);
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function isArtifactKind(value) {
+    return value === 'image' || value === 'svg' || value === 'markdown' || value === 'json';
+}
+function artifactFrom(value) {
+    if (!isRecord(value))
+        return undefined;
+    if (typeof value.path !== 'string'
+        || typeof value.filename !== 'string'
+        || typeof value.mimeType !== 'string'
+        || !isArtifactKind(value.kind)
+        || typeof value.description !== 'string'
+        || typeof value.sourceTool !== 'string'
+        || (value.previewIntent !== 'image' && value.previewIntent !== 'svg' && value.previewIntent !== 'text' && value.previewIntent !== 'download')
+        || typeof value.bytes !== 'number'
+        || !Number.isSafeInteger(value.bytes)
+        || value.bytes < 0)
+        return undefined;
+    return value;
+}
+function collectArtifacts(value, found, depth = 0) {
+    if (depth > 16)
+        return;
+    const artifact = artifactFrom(value);
+    if (artifact !== undefined) {
+        found.set(artifact.path, artifact);
+        return;
+    }
+    if (Array.isArray(value)) {
+        for (const entry of value)
+            collectArtifacts(entry, found, depth + 1);
+        return;
+    }
+    if (!isRecord(value))
+        return;
+    for (const entry of Object.values(value))
+        collectArtifacts(entry, found, depth + 1);
+}
+function parsePayload(value) {
+    if (!isRecord(value))
+        return undefined;
+    if (value.v !== 1
+        || typeof value.path !== 'string'
+        || !isAbsolute(value.path)
+        || typeof value.filename !== 'string'
+        || basename(value.path) !== value.filename
+        || typeof value.mimeType !== 'string'
+        || !isArtifactKind(value.kind)
+        || typeof value.bytes !== 'number'
+        || !Number.isSafeInteger(value.bytes)
+        || value.bytes < 0)
+        return undefined;
+    const expected = MIME_BY_EXTENSION.get(extname(value.path).toLowerCase());
+    if (expected === undefined || expected.mimeType !== value.mimeType || expected.kind !== value.kind)
+        return undefined;
+    return value;
+}
+function mac(key, payload) {
+    return createHmac('sha256', key).update(payload).digest();
+}
+function safeEqual(left, right) {
+    return left.length === right.length && timingSafeEqual(left, right);
+}
+async function readKey(path) {
+    const info = await lstat(path);
+    if (info.isSymbolicLink() || !info.isFile())
+        throw new Error('artifact access key is not a regular file');
+    const key = await readFile(path);
+    if (key.length !== KEY_BYTES)
+        throw new Error('artifact access key has an invalid length');
+    await chmod(path, 0o600);
+    return key;
+}
+/**
+ * Load or atomically create the per-DSH-home signing key.
+ * @param root - state root override used by tests; defaults to the plugin cache.
+ * @returns the 32-byte signing key.
+ */
+export async function prepareArtifactAccessKey(root = visionToolkitStateRoot()) {
+    await mkdir(root, { recursive: true, mode: 0o700 });
+    const path = join(root, 'artifact-access.key');
+    try {
+        return await readKey(path);
+    }
+    catch (error) {
+        if (error.code !== 'ENOENT')
+            throw error;
+    }
+    const candidate = randomBytes(KEY_BYTES);
+    try {
+        await writeFile(path, candidate, { flag: 'wx', mode: 0o600 });
+        return candidate;
+    }
+    catch (error) {
+        if (error.code !== 'EEXIST')
+            throw error;
+        return readKey(path);
+    }
+}
+function artifactRoot(path) {
+    let current = dirname(path);
+    while (true) {
+        if (basename(current) === 'artifacts' && basename(dirname(current)) === '.dsh-vision-toolkit')
+            return current;
+        const parent = dirname(current);
+        if (parent === current)
+            return undefined;
+        current = parent;
+    }
+}
+async function assertNoSymlinkPath(root, path) {
+    const rootInfo = await lstat(root);
+    if (rootInfo.isSymbolicLink() || !rootInfo.isDirectory())
+        throw new Error('artifact root is not a real directory');
+    const rel = relative(root, path);
+    if (rel === '' || rel === '..' || rel.startsWith(`..${sep}`) || isAbsolute(rel)) {
+        throw new Error('artifact path escaped its managed root');
+    }
+    let current = root;
+    const parts = rel.split(sep);
+    for (let index = 0; index < parts.length; index += 1) {
+        const part = parts[index];
+        if (part === undefined || part.length === 0 || part === '.' || part === '..')
+            throw new Error('artifact path is malformed');
+        current = join(current, part);
+        const info = await lstat(current);
+        if (info.isSymbolicLink())
+            throw new Error('artifact path contains a symbolic link');
+        const final = index === parts.length - 1;
+        if (final ? !info.isFile() : !info.isDirectory())
+            throw new Error('artifact path contains an unexpected entry type');
+    }
+    const [realRoot, realFile] = await Promise.all([realpath(root), realpath(path)]);
+    if (!isWithin(realRoot, realFile))
+        throw new Error('artifact path escaped its managed root');
+}
+function sameFile(opened, current) {
+    if (opened.dev === 0 || current.dev === 0 || opened.ino === 0 || current.ino === 0)
+        return true;
+    return opened.dev === current.dev && opened.ino === current.ino;
+}
+async function openVerifiedArtifact(payload) {
+    const root = artifactRoot(payload.path);
+    if (root === undefined)
+        throw new Error('artifact path is outside the managed delivery tree');
+    await assertNoSymlinkPath(root, payload.path);
+    const noFollow = typeof fsConstants.O_NOFOLLOW === 'number' ? fsConstants.O_NOFOLLOW : 0;
+    const handle = await open(payload.path, fsConstants.O_RDONLY | noFollow);
+    try {
+        const info = await handle.stat();
+        if (!info.isFile() || info.size !== payload.bytes)
+            throw new Error('artifact no longer matches its delivered descriptor');
+        const current = await lstat(payload.path);
+        if (current.isSymbolicLink() || !current.isFile() || !sameFile(info, current)) {
+            throw new Error('artifact changed while it was being opened');
+        }
+        await assertNoSymlinkPath(root, payload.path);
+        return { handle, info };
+    }
+    catch (error) {
+        await handle.close().catch(() => { });
+        throw error;
+    }
+}
+function asciiFilename(filename) {
+    const fallback = filename.replace(/[^A-Za-z0-9._-]/g, '_').slice(0, 160);
+    return fallback.length === 0 ? 'artifact' : fallback;
+}
+function contentDisposition(filename, download) {
+    const mode = download ? 'attachment' : 'inline';
+    return `${mode}; filename="${asciiFilename(filename)}"; filename*=UTF-8''${encodeURIComponent(filename)}`;
+}
+function securityHeaders(res, payload, download) {
+    res.setHeader('Content-Type', payload.mimeType);
+    res.setHeader('Content-Length', String(payload.bytes));
+    res.setHeader('Content-Disposition', contentDisposition(payload.filename, download));
+    res.setHeader('X-Content-Type-Options', 'nosniff');
+    res.setHeader('Cache-Control', 'private, no-store, max-age=0');
+    res.setHeader('Referrer-Policy', 'no-referrer');
+    res.setHeader('Cross-Origin-Resource-Policy', 'same-origin');
+    res.setHeader('Content-Security-Policy', payload.kind === 'svg'
+        ? "sandbox; default-src 'none'; img-src data:; style-src 'unsafe-inline'"
+        : "sandbox; default-src 'none'");
+}
+/** Signed-capability encoder and safe Artifact route handler. */
+export class ArtifactAccessController {
+    key;
+    routeCount = 0;
+    constructor(key) {
+        this.key = key;
+        if (key.length !== KEY_BYTES)
+            throw new TypeError(`artifact access key must be ${KEY_BYTES} bytes`);
+    }
+    /** Whether at least one HTTP carrier currently owns the route. */
+    get routeAvailable() {
+        return this.routeCount > 0;
+    }
+    /** Mark one route attachment; the returned disposer removes that attachment. */
+    attachRoute() {
+        this.routeCount += 1;
+        let active = true;
+        return () => {
+            if (!active)
+                return;
+            active = false;
+            this.routeCount -= 1;
+        };
+    }
+    /**
+     * Purely enrich a canonical tool-result value with browser access grants.
+     * @param value - schema-validated tool result.
+     * @returns the unchanged value when no route/artifact exists, otherwise a detached metadata envelope.
+     */
+    presentationMeta(value) {
+        if (!this.routeAvailable || !isRecord(value))
+            return value;
+        const artifacts = new Map();
+        collectArtifacts(value, artifacts);
+        if (artifacts.size === 0)
+            return value;
+        const grants = [...artifacts.values()].map((artifact) => {
+            const token = this.sign(artifact);
+            const previewUrl = `${ARTIFACT_ROUTE_PREFIX}/${token}`;
+            return { path: artifact.path, previewUrl, downloadUrl: `${previewUrl}?download=1` };
+        });
+        const envelope = { schemaVersion: 1, artifacts: grants };
+        return { ...value, [PRESENTATION_META_KEY]: envelope };
+    }
+    /** Mint a deterministic, tamper-evident capability for one descriptor. */
+    sign(artifact) {
+        const payload = {
+            v: 1,
+            path: artifact.path,
+            filename: artifact.filename,
+            mimeType: artifact.mimeType,
+            kind: artifact.kind,
+            bytes: artifact.bytes,
+        };
+        const encoded = Buffer.from(JSON.stringify(payload)).toString('base64url');
+        return `${encoded}.${mac(this.key, encoded).toString('base64url')}`;
+    }
+    /** Verify and decode one capability without touching the filesystem. */
+    verify(token) {
+        if (token.length === 0 || token.length > MAX_TOKEN_LENGTH || !TOKEN_PATTERN.test(token))
+            return undefined;
+        const [encoded, signature] = token.split('.');
+        if (encoded === undefined || signature === undefined)
+            return undefined;
+        let supplied;
+        try {
+            supplied = Buffer.from(signature, 'base64url');
+        }
+        catch {
+            return undefined;
+        }
+        if (!safeEqual(mac(this.key, encoded), supplied))
+            return undefined;
+        try {
+            return parsePayload(JSON.parse(Buffer.from(encoded, 'base64url').toString('utf8')));
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /**
+     * Serve one GET/HEAD capability request with MIME, CSP, and symlink checks.
+     * @param req - Node HTTP request matched under {@link ARTIFACT_ROUTE_PREFIX}.
+     * @param res - response owned by this handler.
+     */
+    async handle(req, res) {
+        if (req.method !== 'GET' && req.method !== 'HEAD') {
+            res.setHeader('Allow', 'GET, HEAD');
+            res.writeHead(405);
+            res.end();
+            return;
+        }
+        let url;
+        try {
+            url = new URL(req.url ?? '/', 'http://dsh.local');
+        }
+        catch {
+            res.writeHead(400);
+            res.end();
+            return;
+        }
+        const prefix = `${ARTIFACT_ROUTE_PREFIX}/`;
+        if (!url.pathname.startsWith(prefix) || url.pathname.slice(prefix.length).includes('/')) {
+            res.writeHead(404);
+            res.end();
+            return;
+        }
+        let token;
+        try {
+            token = decodeURIComponent(url.pathname.slice(prefix.length));
+        }
+        catch {
+            res.writeHead(404);
+            res.end();
+            return;
+        }
+        const payload = this.verify(token);
+        if (payload === undefined) {
+            res.writeHead(404);
+            res.end();
+            return;
+        }
+        const downloadValue = url.searchParams.get('download');
+        if ([...url.searchParams.keys()].some(key => key !== 'download') || (downloadValue !== null && downloadValue !== '1')) {
+            res.writeHead(400);
+            res.end();
+            return;
+        }
+        let opened;
+        try {
+            opened = await openVerifiedArtifact(payload);
+        }
+        catch {
+            res.writeHead(404);
+            res.end();
+            return;
+        }
+        securityHeaders(res, payload, downloadValue === '1');
+        res.writeHead(200);
+        if (req.method === 'HEAD') {
+            await opened.handle.close().catch(() => { });
+            res.end();
+            return;
+        }
+        const stream = opened.handle.createReadStream({ autoClose: true });
+        stream.on('error', () => {
+            if (!res.headersSent)
+                res.writeHead(500);
+            res.destroy();
+        });
+        stream.pipe(res);
+    }
+}
+//# sourceMappingURL=artifact-access.js.map

package/lib/artifact-access.js.map

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

package/lib/artifacts.js

@@ -0,0 +1,56 @@
+/**
+ * Stable file-delivery descriptors owned by the plugin. DSH Core currently
+ * has no reusable Artifact service, so every file-producing tool returns this
+ * lossless contract and keeps the file inside the plugin-managed artifact
+ * directory for Web, Headless, and later tool calls alike.
+ * @module dsh-vision-toolkit/artifacts
+ */
+import { lstat, realpath, stat } from 'node:fs/promises';
+import { basename } from 'node:path';
+import { VisionToolkitError } from "./errors.js";
+import { isWithin } from "./paths.js";
+/**
+ * Validate and describe one committed regular file under the active artifact
+ * root. Symbolic links are rejected even when their targets remain in-bounds,
+ * so a later preview/download can never be redirected after delivery.
+ * @param path - final managed artifact path.
+ * @param policy - active workspace path policy.
+ * @param description - stable type and presentation facts.
+ * @returns a complete descriptor with the committed byte size.
+ */
+export async function describeArtifact(path, policy, description) {
+    let linkInfo;
+    try {
+        linkInfo = await lstat(path);
+    }
+    catch (error) {
+        throw new VisionToolkitError('output', `artifact was not created: ${basename(path)}`, { cause: error });
+    }
+    if (linkInfo.isSymbolicLink()) {
+        throw new VisionToolkitError('path', `artifact must not be a symbolic link: ${basename(path)}`);
+    }
+    let real;
+    try {
+        real = await realpath(path);
+    }
+    catch (error) {
+        throw new VisionToolkitError('output', `artifact is not accessible: ${basename(path)}`, { cause: error });
+    }
+    if (!isWithin(policy.outputDir, real)) {
+        throw new VisionToolkitError('path', `artifact escaped the managed output directory: ${basename(path)}`);
+    }
+    const info = await stat(real);
+    if (!info.isFile())
+        throw new VisionToolkitError('output', `artifact is not a regular file: ${basename(path)}`);
+    return {
+        path,
+        filename: basename(path),
+        mimeType: description.mimeType,
+        kind: description.kind,
+        description: description.description,
+        sourceTool: description.sourceTool,
+        previewIntent: description.previewIntent,
+        bytes: info.size,
+    };
+}
+//# sourceMappingURL=artifacts.js.map

package/lib/artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../src/artifacts.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAE,QAAQ,EAAmB,MAAM,YAAY,CAAA;AA6BtD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAAY,EACZ,MAAkB,EAClB,WAAgC;IAEhC,IAAI,QAAQ,CAAA;IACZ,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAA;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,kBAAkB,CAAC,QAAQ,EAAE,6BAA6B,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;IACzG,CAAC;IACD,IAAI,QAAQ,CAAC,cAAc,EAAE,EAAE,CAAC;QAC9B,MAAM,IAAI,kBAAkB,CAAC,MAAM,EAAE,yCAAyC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACjG,CAAC;IACD,IAAI,IAAY,CAAA;IAChB,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAA;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,kBAAkB,CAAC,QAAQ,EAAE,+BAA+B,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;IAC3G,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,kBAAkB,CAAC,MAAM,EAAE,kDAAkD,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAC1G,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAA;IAC7B,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;QAAE,MAAM,IAAI,kBAAkB,CAAC,QAAQ,EAAE,mCAAmC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAC/G,OAAO;QACL,IAAI;QACJ,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC;QACxB,QAAQ,EAAE,WAAW,CAAC,QAAQ;QAC9B,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,WAAW,EAAE,WAAW,CAAC,WAAW;QACpC,UAAU,EAAE,WAAW,CAAC,UAAU;QAClC,aAAa,EAAE,WAAW,CAAC,aAAa;QACxC,KAAK,EAAE,IAAI,CAAC,IAAI;KACjB,CAAA;AACH,CAAC"}