@farazirfan/costar-server-executor 1.0.0

package/dist/media/parse.js.map

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

package/dist/media/server.d.ts

@@ -0,0 +1,6 @@
+import type { Server } from "node:http";
+import { type Express } from "express";
+import { type RuntimeEnv } from "../runtime.js";
+export declare function attachMediaRoutes(app: Express, ttlMs?: number, _runtime?: RuntimeEnv): void;
+export declare function startMediaServer(port: number, ttlMs?: number, runtime?: RuntimeEnv): Promise<Server>;
+//# sourceMappingURL=server.d.ts.map

package/dist/media/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/media/server.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAgB,EAAE,KAAK,OAAO,EAAE,MAAM,SAAS,CAAC;AAEhD,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAiBhE,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,OAAO,EACZ,KAAK,SAAiB,EACtB,QAAQ,GAAE,UAA2B,QAwDtC;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,KAAK,SAAiB,EACtB,OAAO,GAAE,UAA2B,GACnC,OAAO,CAAC,MAAM,CAAC,CAWjB"}

package/dist/media/server.js

@@ -0,0 +1,89 @@
+import fs from "node:fs/promises";
+import express from "express";
+import { danger } from "../globals.js";
+import { defaultRuntime } from "../runtime.js";
+import { SafeOpenError, openFileWithinRoot } from "../infra/fs-safe.js";
+import { detectMime } from "./mime.js";
+import { cleanOldMedia, getMediaDir, MEDIA_MAX_BYTES } from "./store.js";
+const DEFAULT_TTL_MS = 2 * 60 * 1000;
+const MAX_MEDIA_ID_CHARS = 200;
+const MEDIA_ID_PATTERN = /^[\p{L}\p{N}._-]+$/u;
+const MAX_MEDIA_BYTES = MEDIA_MAX_BYTES;
+const isValidMediaId = (id) => {
+    if (!id)
+        return false;
+    if (id.length > MAX_MEDIA_ID_CHARS)
+        return false;
+    if (id === "." || id === "..")
+        return false;
+    return MEDIA_ID_PATTERN.test(id);
+};
+export function attachMediaRoutes(app, ttlMs = DEFAULT_TTL_MS, _runtime = defaultRuntime) {
+    const mediaDir = getMediaDir();
+    app.get("/media/:id", async (req, res) => {
+        const id = req.params.id;
+        if (!isValidMediaId(id)) {
+            res.status(400).send("invalid path");
+            return;
+        }
+        try {
+            const { handle, realPath, stat } = await openFileWithinRoot({
+                rootDir: mediaDir,
+                relativePath: id,
+            });
+            if (stat.size > MAX_MEDIA_BYTES) {
+                await handle.close().catch(() => { });
+                res.status(413).send("too large");
+                return;
+            }
+            if (Date.now() - stat.mtimeMs > ttlMs) {
+                await handle.close().catch(() => { });
+                await fs.rm(realPath).catch(() => { });
+                res.status(410).send("expired");
+                return;
+            }
+            const data = await handle.readFile();
+            await handle.close().catch(() => { });
+            const mime = await detectMime({ buffer: data, filePath: realPath });
+            if (mime)
+                res.type(mime);
+            res.send(data);
+            // best-effort single-use cleanup after response ends
+            res.on("finish", () => {
+                setTimeout(() => {
+                    fs.rm(realPath).catch(() => { });
+                }, 50);
+            });
+        }
+        catch (err) {
+            if (err instanceof SafeOpenError) {
+                if (err.code === "invalid-path") {
+                    res.status(400).send("invalid path");
+                    return;
+                }
+                if (err.code === "not-found") {
+                    res.status(404).send("not found");
+                    return;
+                }
+            }
+            res.status(404).send("not found");
+        }
+    });
+    // periodic cleanup
+    setInterval(() => {
+        void cleanOldMedia(ttlMs);
+    }, ttlMs).unref();
+}
+export async function startMediaServer(port, ttlMs = DEFAULT_TTL_MS, runtime = defaultRuntime) {
+    const app = express();
+    attachMediaRoutes(app, ttlMs, runtime);
+    return await new Promise((resolve, reject) => {
+        const server = app.listen(port);
+        server.once("listening", () => resolve(server));
+        server.once("error", (err) => {
+            runtime.error(danger(`Media server failed: ${String(err)}`));
+            reject(err);
+        });
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/media/server.js.map

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

package/dist/media/store.d.ts

@@ -0,0 +1,19 @@
+export declare const MEDIA_MAX_BYTES: number;
+/**
+ * Extract original filename from path if it matches the embedded format.
+ * Pattern: {original}---{uuid}.{ext} → returns "{original}.{ext}"
+ * Falls back to basename if no pattern match, or "file.bin" if empty.
+ */
+export declare function extractOriginalFilename(filePath: string): string;
+export declare function getMediaDir(): string;
+export declare function ensureMediaDir(): Promise<string>;
+export declare function cleanOldMedia(ttlMs?: number): Promise<void>;
+export type SavedMedia = {
+    id: string;
+    path: string;
+    size: number;
+    contentType?: string;
+};
+export declare function saveMediaSource(source: string, headers?: Record<string, string>, subdir?: string): Promise<SavedMedia>;
+export declare function saveMediaBuffer(buffer: Buffer, contentType?: string, subdir?: string, maxBytes?: number, originalFilename?: string): Promise<SavedMedia>;
+//# sourceMappingURL=store.d.ts.map

package/dist/media/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/media/store.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,eAAe,QAAkB,CAAC;AAiB/C;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAgBhE;AAED,wBAAgB,WAAW,WAE1B;AAED,wBAAsB,cAAc,oBAInC;AAED,wBAAsB,aAAa,CAAC,KAAK,SAAiB,iBAczD;AAgFD,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,MAAM,SAAK,GACV,OAAO,CAAC,UAAU,CAAC,CAmCrB;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,EACpB,MAAM,SAAY,EAClB,QAAQ,SAAY,EACpB,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,UAAU,CAAC,CAyBrB"}

package/dist/media/store.js

@@ -0,0 +1,201 @@
+import crypto from "node:crypto";
+import { createWriteStream } from "node:fs";
+import fs from "node:fs/promises";
+import { request as httpRequest } from "node:http";
+import { request as httpsRequest } from "node:https";
+import path from "node:path";
+import { pipeline } from "node:stream/promises";
+import { resolveConfigDir } from "../utils.js";
+import { resolvePinnedHostname } from "../infra/net/ssrf.js";
+import { detectMime, extensionForMime } from "./mime.js";
+const resolveMediaDir = () => path.join(resolveConfigDir(), "media");
+export const MEDIA_MAX_BYTES = 5 * 1024 * 1024; // 5MB default
+const MAX_BYTES = MEDIA_MAX_BYTES;
+const DEFAULT_TTL_MS = 2 * 60 * 1000; // 2 minutes
+/**
+ * Sanitize a filename for cross-platform safety.
+ * Removes chars unsafe on Windows/SharePoint/all platforms.
+ * Keeps: alphanumeric, dots, hyphens, underscores, Unicode letters/numbers.
+ */
+function sanitizeFilename(name) {
+    const trimmed = name.trim();
+    if (!trimmed)
+        return "";
+    const sanitized = trimmed.replace(/[^\p{L}\p{N}._-]+/gu, "_");
+    // Collapse multiple underscores, trim leading/trailing, limit length
+    return sanitized.replace(/_+/g, "_").replace(/^_|_$/g, "").slice(0, 60);
+}
+/**
+ * Extract original filename from path if it matches the embedded format.
+ * Pattern: {original}---{uuid}.{ext} → returns "{original}.{ext}"
+ * Falls back to basename if no pattern match, or "file.bin" if empty.
+ */
+export function extractOriginalFilename(filePath) {
+    const basename = path.basename(filePath);
+    if (!basename)
+        return "file.bin"; // Fallback for empty input
+    const ext = path.extname(basename);
+    const nameWithoutExt = path.basename(basename, ext);
+    // Check for ---{uuid} pattern (36 chars: 8-4-4-4-12 with hyphens)
+    const match = nameWithoutExt.match(/^(.+)---[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/i);
+    if (match?.[1]) {
+        return `${match[1]}${ext}`;
+    }
+    return basename; // Fallback: use as-is
+}
+export function getMediaDir() {
+    return resolveMediaDir();
+}
+export async function ensureMediaDir() {
+    const mediaDir = resolveMediaDir();
+    await fs.mkdir(mediaDir, { recursive: true, mode: 0o700 });
+    return mediaDir;
+}
+export async function cleanOldMedia(ttlMs = DEFAULT_TTL_MS) {
+    const mediaDir = await ensureMediaDir();
+    const entries = await fs.readdir(mediaDir).catch(() => []);
+    const now = Date.now();
+    await Promise.all(entries.map(async (file) => {
+        const full = path.join(mediaDir, file);
+        const stat = await fs.stat(full).catch(() => null);
+        if (!stat)
+            return;
+        if (now - stat.mtimeMs > ttlMs) {
+            await fs.rm(full).catch(() => { });
+        }
+    }));
+}
+function looksLikeUrl(src) {
+    return /^https?:\/\//i.test(src);
+}
+/**
+ * Download media to disk while capturing the first few KB for mime sniffing.
+ */
+async function downloadToFile(url, dest, headers, maxRedirects = 5) {
+    return await new Promise((resolve, reject) => {
+        let parsedUrl;
+        try {
+            parsedUrl = new URL(url);
+        }
+        catch {
+            reject(new Error("Invalid URL"));
+            return;
+        }
+        if (!["http:", "https:"].includes(parsedUrl.protocol)) {
+            reject(new Error(`Invalid URL protocol: ${parsedUrl.protocol}. Only HTTP/HTTPS allowed.`));
+            return;
+        }
+        const requestImpl = parsedUrl.protocol === "https:" ? httpsRequest : httpRequest;
+        resolvePinnedHostname(parsedUrl.hostname)
+            .then((pinned) => {
+            const req = requestImpl(parsedUrl, { headers, lookup: pinned.lookup }, (res) => {
+                // Follow redirects
+                if (res.statusCode && res.statusCode >= 300 && res.statusCode < 400) {
+                    const location = res.headers.location;
+                    if (!location || maxRedirects <= 0) {
+                        reject(new Error(`Redirect loop or missing Location header`));
+                        return;
+                    }
+                    const redirectUrl = new URL(location, url).href;
+                    resolve(downloadToFile(redirectUrl, dest, headers, maxRedirects - 1));
+                    return;
+                }
+                if (!res.statusCode || res.statusCode >= 400) {
+                    reject(new Error(`HTTP ${res.statusCode ?? "?"} downloading media`));
+                    return;
+                }
+                let total = 0;
+                const sniffChunks = [];
+                let sniffLen = 0;
+                const out = createWriteStream(dest, { mode: 0o600 });
+                res.on("data", (chunk) => {
+                    total += chunk.length;
+                    if (sniffLen < 16384) {
+                        sniffChunks.push(chunk);
+                        sniffLen += chunk.length;
+                    }
+                    if (total > MAX_BYTES) {
+                        req.destroy(new Error("Media exceeds 5MB limit"));
+                    }
+                });
+                pipeline(res, out)
+                    .then(() => {
+                    const sniffBuffer = Buffer.concat(sniffChunks, Math.min(sniffLen, 16384));
+                    const rawHeader = res.headers["content-type"];
+                    const headerMime = Array.isArray(rawHeader) ? rawHeader[0] : rawHeader;
+                    resolve({
+                        headerMime,
+                        sniffBuffer,
+                        size: total,
+                    });
+                })
+                    .catch(reject);
+            });
+            req.on("error", reject);
+            req.end();
+        })
+            .catch(reject);
+    });
+}
+export async function saveMediaSource(source, headers, subdir = "") {
+    const baseDir = resolveMediaDir();
+    const dir = subdir ? path.join(baseDir, subdir) : baseDir;
+    await fs.mkdir(dir, { recursive: true, mode: 0o700 });
+    await cleanOldMedia();
+    const baseId = crypto.randomUUID();
+    if (looksLikeUrl(source)) {
+        const tempDest = path.join(dir, `${baseId}.tmp`);
+        const { headerMime, sniffBuffer, size } = await downloadToFile(source, tempDest, headers);
+        const mime = await detectMime({
+            buffer: sniffBuffer,
+            headerMime,
+            filePath: source,
+        });
+        const ext = extensionForMime(mime) ?? path.extname(new URL(source).pathname);
+        const id = ext ? `${baseId}${ext}` : baseId;
+        const finalDest = path.join(dir, id);
+        await fs.rename(tempDest, finalDest);
+        return { id, path: finalDest, size, contentType: mime };
+    }
+    // local path
+    const stat = await fs.stat(source);
+    if (!stat.isFile()) {
+        throw new Error("Media path is not a file");
+    }
+    if (stat.size > MAX_BYTES) {
+        throw new Error("Media exceeds 5MB limit");
+    }
+    const buffer = await fs.readFile(source);
+    const mime = await detectMime({ buffer, filePath: source });
+    const ext = extensionForMime(mime) ?? path.extname(source);
+    const id = ext ? `${baseId}${ext}` : baseId;
+    const dest = path.join(dir, id);
+    await fs.writeFile(dest, buffer, { mode: 0o600 });
+    return { id, path: dest, size: stat.size, contentType: mime };
+}
+export async function saveMediaBuffer(buffer, contentType, subdir = "inbound", maxBytes = MAX_BYTES, originalFilename) {
+    if (buffer.byteLength > maxBytes) {
+        throw new Error(`Media exceeds ${(maxBytes / (1024 * 1024)).toFixed(0)}MB limit`);
+    }
+    const dir = path.join(resolveMediaDir(), subdir);
+    await fs.mkdir(dir, { recursive: true, mode: 0o700 });
+    const uuid = crypto.randomUUID();
+    const headerExt = extensionForMime(contentType?.split(";")[0]?.trim() ?? undefined);
+    const mime = await detectMime({ buffer, headerMime: contentType });
+    const ext = headerExt ?? extensionForMime(mime) ?? "";
+    let id;
+    if (originalFilename) {
+        // Embed original name: {sanitized}---{uuid}.ext
+        const base = path.parse(originalFilename).name;
+        const sanitized = sanitizeFilename(base);
+        id = sanitized ? `${sanitized}---${uuid}${ext}` : `${uuid}${ext}`;
+    }
+    else {
+        // Legacy: just UUID
+        id = ext ? `${uuid}${ext}` : uuid;
+    }
+    const dest = path.join(dir, id);
+    await fs.writeFile(dest, buffer, { mode: 0o600 });
+    return { id, path: dest, size: buffer.byteLength, contentType: mime };
+}
+//# sourceMappingURL=store.js.map

package/dist/media/store.js.map

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

package/dist/process/exec.d.ts

@@ -0,0 +1,23 @@
+export declare function runExec(command: string, args: string[], opts?: number | {
+    timeoutMs?: number;
+    maxBuffer?: number;
+}): Promise<{
+    stdout: string;
+    stderr: string;
+}>;
+export type SpawnResult = {
+    stdout: string;
+    stderr: string;
+    code: number | null;
+    signal: NodeJS.Signals | null;
+    killed: boolean;
+};
+export type CommandOptions = {
+    timeoutMs: number;
+    cwd?: string;
+    input?: string;
+    env?: NodeJS.ProcessEnv;
+    windowsVerbatimArguments?: boolean;
+};
+export declare function runCommandWithTimeout(argv: string[], optionsOrTimeout: number | CommandOptions): Promise<SpawnResult>;
+//# sourceMappingURL=exec.d.ts.map

package/dist/process/exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../src/process/exec.ts"],"names":[],"mappings":"AAWA,wBAAsB,OAAO,CAC3B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,GAAE,MAAM,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAW,GACjE,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAsB7C;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC,CAAC;AAEF,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,MAAM,EAAE,EACd,gBAAgB,EAAE,MAAM,GAAG,cAAc,GACxC,OAAO,CAAC,WAAW,CAAC,CAiEtB"}

package/dist/process/exec.js

@@ -0,0 +1,99 @@
+import { execFile, spawn } from "node:child_process";
+import path from "node:path";
+import { promisify } from "node:util";
+import { danger, shouldLogVerbose } from "../globals.js";
+import { logDebug, logError } from "../logger.js";
+import { resolveCommandStdio } from "./spawn-utils.js";
+const execFileAsync = promisify(execFile);
+// Simple promise-wrapped execFile with optional verbosity logging.
+export async function runExec(command, args, opts = 10_000) {
+    const options = typeof opts === "number"
+        ? { timeout: opts, encoding: "utf8" }
+        : {
+            timeout: opts.timeoutMs,
+            maxBuffer: opts.maxBuffer,
+            encoding: "utf8",
+        };
+    try {
+        const { stdout, stderr } = await execFileAsync(command, args, options);
+        if (shouldLogVerbose()) {
+            if (stdout.trim())
+                logDebug(stdout.trim());
+            if (stderr.trim())
+                logError(stderr.trim());
+        }
+        return { stdout, stderr };
+    }
+    catch (err) {
+        if (shouldLogVerbose()) {
+            logError(danger(`Command failed: ${command} ${args.join(" ")}`));
+        }
+        throw err;
+    }
+}
+export async function runCommandWithTimeout(argv, optionsOrTimeout) {
+    const options = typeof optionsOrTimeout === "number" ? { timeoutMs: optionsOrTimeout } : optionsOrTimeout;
+    const { timeoutMs, cwd, input, env } = options;
+    const { windowsVerbatimArguments } = options;
+    const hasInput = input !== undefined;
+    const shouldSuppressNpmFund = (() => {
+        const cmd = path.basename(argv[0] ?? "");
+        if (cmd === "npm" || cmd === "npm.cmd" || cmd === "npm.exe")
+            return true;
+        if (cmd === "node" || cmd === "node.exe") {
+            const script = argv[1] ?? "";
+            return script.includes("npm-cli.js");
+        }
+        return false;
+    })();
+    const resolvedEnv = env ? { ...process.env, ...env } : { ...process.env };
+    if (shouldSuppressNpmFund) {
+        if (resolvedEnv.NPM_CONFIG_FUND == null)
+            resolvedEnv.NPM_CONFIG_FUND = "false";
+        if (resolvedEnv.npm_config_fund == null)
+            resolvedEnv.npm_config_fund = "false";
+    }
+    const stdio = resolveCommandStdio({ hasInput, preferInherit: true });
+    const child = spawn(argv[0], argv.slice(1), {
+        stdio,
+        cwd,
+        env: resolvedEnv,
+        windowsVerbatimArguments,
+    });
+    // Spawn with inherited stdin (TTY) so tools like `pi` stay interactive when needed.
+    return await new Promise((resolve, reject) => {
+        let stdout = "";
+        let stderr = "";
+        let settled = false;
+        const timer = setTimeout(() => {
+            if (typeof child.kill === "function") {
+                child.kill("SIGKILL");
+            }
+        }, timeoutMs);
+        if (hasInput && child.stdin) {
+            child.stdin.write(input ?? "");
+            child.stdin.end();
+        }
+        child.stdout?.on("data", (d) => {
+            stdout += d.toString();
+        });
+        child.stderr?.on("data", (d) => {
+            stderr += d.toString();
+        });
+        child.on("error", (err) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            reject(err);
+        });
+        child.on("close", (code, signal) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            resolve({ stdout, stderr, code, signal, killed: child.killed });
+        });
+    });
+}
+//# sourceMappingURL=exec.js.map

package/dist/process/exec.js.map

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

package/dist/schema/typebox.d.ts

@@ -0,0 +1,40 @@
+import { OpenClawSchema } from "./zod-schema.js";
+export type ConfigUiHint = {
+    label?: string;
+    help?: string;
+    group?: string;
+    order?: number;
+    advanced?: boolean;
+    sensitive?: boolean;
+    placeholder?: string;
+    itemTemplate?: unknown;
+};
+export type ConfigUiHints = Record<string, ConfigUiHint>;
+export type ConfigSchema = ReturnType<typeof OpenClawSchema.toJSONSchema>;
+type JsonSchemaNode = Record<string, unknown>;
+export type ConfigSchemaResponse = {
+    schema: ConfigSchema;
+    uiHints: ConfigUiHints;
+    version: string;
+    generatedAt: string;
+};
+export type PluginUiMetadata = {
+    id: string;
+    name?: string;
+    description?: string;
+    configUiHints?: Record<string, Pick<ConfigUiHint, "label" | "help" | "advanced" | "sensitive" | "placeholder">>;
+    configSchema?: JsonSchemaNode;
+};
+export type ChannelUiMetadata = {
+    id: string;
+    label?: string;
+    description?: string;
+    configSchema?: JsonSchemaNode;
+    configUiHints?: Record<string, ConfigUiHint>;
+};
+export declare function buildConfigSchema(params?: {
+    plugins?: PluginUiMetadata[];
+    channels?: ChannelUiMetadata[];
+}): ConfigSchemaResponse;
+export {};
+//# sourceMappingURL=typebox.d.ts.map

package/dist/schema/typebox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typebox.d.ts","sourceRoot":"","sources":["../../src/schema/typebox.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAEzD,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,YAAY,CAAC,CAAC;AAE1E,KAAK,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE9C,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CACpB,MAAM,EACN,IAAI,CAAC,YAAY,EAAE,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,aAAa,CAAC,CAChF,CAAC;IACF,YAAY,CAAC,EAAE,cAAc,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,cAAc,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CAC9C,CAAC;AA45BF,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE;IACzC,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAChC,GAAG,oBAAoB,CAiBvB"}