@geohar/un-bien 0.7.0 → 0.9.0

package/dist/enrich_tool_args.js

@@ -0,0 +1,171 @@
+import { resolve } from "node:path";
+import { readFileSync } from "node:fs";
+export function _enrichToolArgs(tool, args, cwd = process.cwd()) {
+    if (!args || typeof args !== "object")
+        return {};
+    const base = args;
+    switch (tool.toLowerCase()) {
+        case "edit":
+            return _enrichEditToolArgs(base, cwd);
+        default:
+            return base;
+    }
+}
+function _enrichEditToolArgs(base, cwd) {
+    const filePath = _stringArg(base, ["path", "file_path"]);
+    const rawEdits = base["edits"];
+    const edits = Array.isArray(rawEdits) ? rawEdits : [base];
+    const text = _readToolFile(filePath, cwd);
+    const hunks = [];
+    let searchFrom = 0;
+    for (const rawEdit of edits) {
+        if (!rawEdit || typeof rawEdit !== "object")
+            continue;
+        const edit = rawEdit;
+        const oldText = _stringArg(edit, [
+            "oldText",
+            "old_text",
+            "old_string",
+            "oldString",
+        ]);
+        const newText = _stringArg(edit, [
+            "newText",
+            "new_text",
+            "new_string",
+            "newString",
+        ]);
+        if (!oldText && !newText)
+            continue;
+        const matchAt = oldText && text !== null ? text.indexOf(oldText, searchFrom) : -1;
+        const fallbackAt = oldText && matchAt < 0 && text !== null ? text.indexOf(oldText) : matchAt;
+        const startOffset = fallbackAt >= 0 ? fallbackAt : searchFrom;
+        if (text === null)
+            continue;
+        const hunk = _buildEditHunk(text, startOffset, oldText, newText);
+        if (hunk.length > 0)
+            hunks.push({ lines: hunk });
+        searchFrom = startOffset + Math.max(oldText.length, 1);
+    }
+    return hunks.length === 0 ? base : { ...base, hunks };
+}
+function _readToolFile(filePath, cwd) {
+    if (!filePath)
+        return null;
+    const homePath = filePath.startsWith("~/") && process.env.HOME
+        ? resolve(process.env.HOME, filePath.slice(2))
+        : null;
+    const candidates = [
+        filePath,
+        resolve(cwd, filePath),
+        resolve(process.cwd(), filePath),
+        homePath,
+    ].filter((p) => typeof p === "string");
+    for (const candidate of candidates) {
+        try {
+            return readFileSync(candidate, "utf8");
+        }
+        catch {
+            // try next candidate
+        }
+    }
+    return null;
+}
+function _buildEditHunk(fileText, startOffset, oldText, newText) {
+    const context = 4;
+    const fileLines = fileText.split("\n");
+    const oldLines = _splitPreviewLines(oldText);
+    const newLines = _splitPreviewLines(newText);
+    const oldStart = _lineNumberAt(fileText, startOffset);
+    const newStart = oldStart;
+    const startIndex = oldStart - 1;
+    const beforeStart = Math.max(0, startIndex - context);
+    const afterStart = startIndex + oldLines.length;
+    const afterEnd = Math.min(fileLines.length, afterStart + context);
+    const out = [];
+    if (beforeStart > 0)
+        out.push({ kind: "ellipsis" });
+    for (let i = beforeStart; i < startIndex; i++) {
+        out.push({
+            kind: "context",
+            oldLine: i + 1,
+            newLine: i + 1,
+            text: fileLines[i] ?? "",
+        });
+    }
+    let commonPrefix = 0;
+    while (commonPrefix < oldLines.length &&
+        commonPrefix < newLines.length &&
+        oldLines[commonPrefix] === newLines[commonPrefix]) {
+        commonPrefix++;
+    }
+    let commonSuffix = 0;
+    while (commonSuffix < oldLines.length - commonPrefix &&
+        commonSuffix < newLines.length - commonPrefix &&
+        oldLines[oldLines.length - 1 - commonSuffix] ===
+            newLines[newLines.length - 1 - commonSuffix]) {
+        commonSuffix++;
+    }
+    for (let i = 0; i < commonPrefix; i++) {
+        out.push({
+            kind: "context",
+            oldLine: oldStart + i,
+            newLine: newStart + i,
+            text: oldLines[i] ?? "",
+        });
+    }
+    for (let i = commonPrefix; i < oldLines.length - commonSuffix; i++) {
+        out.push({
+            kind: "remove",
+            oldLine: oldStart + i,
+            text: oldLines[i] ?? "",
+        });
+    }
+    for (let i = commonPrefix; i < newLines.length - commonSuffix; i++) {
+        out.push({ kind: "add", newLine: newStart + i, text: newLines[i] ?? "" });
+    }
+    for (let i = oldLines.length - commonSuffix; i < oldLines.length; i++) {
+        const newLine = newStart + newLines.length - (oldLines.length - i);
+        out.push({
+            kind: "context",
+            oldLine: oldStart + i,
+            newLine,
+            text: oldLines[i] ?? "",
+        });
+    }
+    for (let i = afterStart; i < afterEnd; i++) {
+        const newLine = newStart + newLines.length + (i - afterStart);
+        out.push({
+            kind: "context",
+            oldLine: i + 1,
+            newLine,
+            text: fileLines[i] ?? "",
+        });
+    }
+    if (afterEnd < fileLines.length)
+        out.push({ kind: "ellipsis" });
+    return out;
+}
+function _lineNumberAt(text, offset) {
+    let line = 1;
+    for (let i = 0; i < Math.max(0, offset); i++)
+        if (text[i] === "\n")
+            line++;
+    return line;
+}
+function _splitPreviewLines(text) {
+    if (!text)
+        return [];
+    const lines = text.split("\n");
+    if (lines.length > 0 && lines[lines.length - 1] === "")
+        lines.pop();
+    return lines;
+}
+function _stringArg(args, keys) {
+    for (const key of keys) {
+        const value = args[key];
+        if (typeof value === "string")
+            return value;
+    }
+    return "";
+}
+//# sourceMappingURL=enrich_tool_args.js.map

package/dist/enrich_tool_args.js.map

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

package/dist/image_codec.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Image codec + on-disk preview paths for received images — the pure(ish)
+ * encode/decode/validate/path layer, split from the stateful preview-DELIVERY
+ * logic (queueing/broadcast) that stays in index.ts. Owns its own temp-dir
+ * cache. `convertToPng` normalizes any supported mime to a PNG preview.
+ */
+export declare const RECEIVED_IMAGE_MAX_BYTES: number;
+export declare const IMAGE_PREVIEW_MIME = "image/png";
+export declare function _imageCacheRootDir(): string;
+export declare function _imageExtension(mime: string): string | undefined;
+export declare function _safeFilenameToken(value: string): string;
+export declare function _safePreviewPath(dir: string, messageId: string, index: number): string;
+export declare function _cleanupPreviewFile(previewPath: string): void;
+export declare function _renderablePngPathFromImage(imageData: string, mime: string, previewPath: string): Promise<string | undefined>;
+export declare function _decodeImagePayload(data: string, mime: string): {
+    ok: true;
+    decoded: Buffer;
+    size: number;
+} | {
+    ok: false;
+    reason: string;
+};

package/dist/image_codec.js

@@ -0,0 +1,149 @@
+import { convertToPng } from "@earendil-works/pi-coding-agent";
+import { chmodSync, existsSync, mkdirSync, mkdtempSync, unlinkSync, writeFileSync, } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+/**
+ * Image codec + on-disk preview paths for received images — the pure(ish)
+ * encode/decode/validate/path layer, split from the stateful preview-DELIVERY
+ * logic (queueing/broadcast) that stays in index.ts. Owns its own temp-dir
+ * cache. `convertToPng` normalizes any supported mime to a PNG preview.
+ */
+export const RECEIVED_IMAGE_MAX_BYTES = 10 * 1024 * 1024;
+export const IMAGE_PREVIEW_MIME = "image/png";
+const IMAGE_CACHE_PREFIX = "pi-app-";
+let _imageCacheDir;
+function _isBase64Char(code) {
+    return ((code >= 48 && code <= 57) || // 0-9
+        (code >= 65 && code <= 90) || // A-Z
+        (code >= 97 && code <= 122) || // a-z
+        code === 43 || // +
+        code === 47); // /
+}
+function _isStrictBase64(data) {
+    if (data.length === 0 || data.length % 4 !== 0)
+        return false;
+    if (data.startsWith("="))
+        return false;
+    const padding = data.endsWith("==") ? 2 : data.endsWith("=") ? 1 : 0;
+    for (let i = 0; i < data.length; i += 1) {
+        const code = data.charCodeAt(i);
+        if (i >= data.length - padding) {
+            if (code !== 61)
+                return false;
+            continue;
+        }
+        if (!_isBase64Char(code))
+            return false;
+    }
+    return true;
+}
+export function _imageCacheRootDir() {
+    if (_imageCacheDir) {
+        try {
+            mkdirSync(_imageCacheDir, { recursive: true, mode: 0o700 });
+        }
+        catch { }
+        try {
+            chmodSync(_imageCacheDir, 0o700);
+        }
+        catch {
+            /* best-effort permission hardening */
+        }
+        return _imageCacheDir;
+    }
+    const dir = mkdtempSync(join(tmpdir(), IMAGE_CACHE_PREFIX));
+    try {
+        chmodSync(dir, 0o700);
+    }
+    catch {
+        /* best-effort permission hardening */
+    }
+    _imageCacheDir = dir;
+    return dir;
+}
+export function _imageExtension(mime) {
+    if (mime === "image/jpeg")
+        return "jpg";
+    if (mime === "image/png")
+        return "png";
+    if (mime === "image/webp")
+        return "webp";
+    if (mime === "image/gif")
+        return "gif";
+    return undefined;
+}
+export function _safeFilenameToken(value) {
+    return (value
+        .trim()
+        .replace(/[^A-Za-z0-9._-]+/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-+|-+$/g, "") || "message");
+}
+export function _safePreviewPath(dir, messageId, index) {
+    return join(dir, `${_safeFilenameToken(messageId)}-${index}.preview.png`);
+}
+export function _cleanupPreviewFile(previewPath) {
+    try {
+        if (existsSync(previewPath))
+            unlinkSync(previewPath);
+    }
+    catch {
+        // best effort
+    }
+}
+export async function _renderablePngPathFromImage(imageData, mime, previewPath) {
+    if (mime === IMAGE_PREVIEW_MIME)
+        return undefined;
+    try {
+        const converted = await convertToPng(imageData, mime);
+        if (!converted ||
+            converted.mimeType !== IMAGE_PREVIEW_MIME ||
+            !converted.data) {
+            return undefined;
+        }
+        const previewBytes = Buffer.from(converted.data, "base64");
+        if (previewBytes.length === 0 ||
+            previewBytes.length > RECEIVED_IMAGE_MAX_BYTES) {
+            return undefined;
+        }
+        try {
+            writeFileSync(previewPath, previewBytes, { mode: 0o600 });
+            try {
+                chmodSync(previewPath, 0o600);
+            }
+            catch {
+                /* best-effort permission hardening */
+            }
+            return previewPath;
+        }
+        catch {
+            _cleanupPreviewFile(previewPath);
+        }
+    }
+    catch {
+        _cleanupPreviewFile(previewPath);
+    }
+    return undefined;
+}
+export function _decodeImagePayload(data, mime) {
+    if (!_imageExtension(mime))
+        return { ok: false, reason: `unsupported mime: ${mime}` };
+    if (data.startsWith("data:"))
+        return { ok: false, reason: "data URI payloads are not supported" };
+    if (!_isStrictBase64(data))
+        return { ok: false, reason: "invalid base64 payload" };
+    const padding = data.endsWith("==") ? 2 : data.endsWith("=") ? 1 : 0;
+    const estimate = (data.length / 4) * 3 - padding;
+    if (estimate > RECEIVED_IMAGE_MAX_BYTES) {
+        return { ok: false, reason: `image too large (${estimate} bytes)` };
+    }
+    const decoded = Buffer.from(data, "base64");
+    if (decoded.length === 0 || decoded.length > RECEIVED_IMAGE_MAX_BYTES) {
+        return {
+            ok: false,
+            reason: `invalid decoded image size (${decoded.length} bytes)`,
+        };
+    }
+    return { ok: true, decoded, size: decoded.length };
+}
+//# sourceMappingURL=image_codec.js.map

package/dist/image_codec.js.map

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

package/dist/index.d.ts

@@ -141,9 +141,6 @@ export declare function _handleControl(cmd: string): Promise<void>;
  * singleton semantics.
  */
 export declare function _onPeerDisconnect(appPeerId?: string): void;
-/** Build the argv for a detached tmux launch of `pi` in `cwd`. Args are an
- *  ARRAY (never a shell string) so cwd/name can't inject. Exported for tests. */
-export declare function _buildTmuxLaunchArgs(name: string, cwd: string): string[];
 declare const extension: ExtensionFactory;
 export default extension;
 /** Test-only entry point for verifying mesh-to-agent delivery semantics. */
@@ -155,29 +152,6 @@ export declare function _routeClientMessageFrom(sender: PlainPeerChannel, msg: C
  * mirroring the pre-W2D singleton behavior.
  */
 export declare function routeClientMessage(msg: ClientMessage, ctx: Pick<ExtensionContext, "abort">): void;
-type ToolArgs = Record<string, unknown>;
-export declare function _enrichToolArgs(tool: string, args: unknown): ToolArgs;
-/**
- * `unbien restart-supervisor` — restarts the `pi-supervisord` PROCESS
- * (not the daemons). The supervisor is a long-running Node process with no
- * hot-reload, so after a `dist` rebuild the old code keeps running until the
- * process is restarted. The Cockpit "Restart supervisor" button shells out to
- * this; the OS-specific restart lives here so the app stays cross-platform.
- *
- * Restarting the supervisor re-spawns every daemon as a side effect. Exits 0
- * on success, non-zero on failure (the Cockpit detects failure by exit code).
- */
-/** One step of a restart sequence. `ignoreFailure` steps (e.g. `schtasks /End`
- *  when the task isn't running) don't abort the sequence. */
-export interface RestartStep {
-    cmd: string;
-    args: string[];
-    ignoreFailure?: boolean;
-}
-/** Pure: the OS command sequence that restarts the supervisor service, or null
- *  when the platform isn't supported. Most platforms are 1 step; Windows is 2
- *  (`schtasks /End` then `/Run`). Exported for tests. */
-export declare function _restartSupervisorCommand(platform: NodeJS.Platform, uid: number): RestartStep[] | null;
 /**
  * Read-only probe of the local UDS broker for the mesh roster, backing
  * `unbien peers`. Opens a raw connection to `sockPath`, sends a single