@qearlyao/familiar 0.2.0 → 0.2.2

package/README.md

@@ -8,6 +8,16 @@ optional real-browser control in one workspace.
 This project is still early. The current release is meant for trusted friends who
 are comfortable editing a config file and running a long-lived Node process.
 
+## Credits
+
+Familiar builds on the [pi](https://github.com/earendil-works/pi)
+stack, including `@earendil-works/pi-ai`, `@earendil-works/pi-agent-core`, and
+`@earendil-works/pi-coding-agent`.
+
+It also borrows ideas and structure from
+[lossless-claw](https://github.com/Martian-Engineering/lossless-claw) and
+[pi-lcm-memory](https://github.com/sharkone/pi-lcm-memory).
+
 ## Requirements
 
 - Node.js 22 or newer. Node.js 24 LTS is recommended and is the primary tested runtime.

package/dist/browser-tools.js

@@ -1,6 +1,7 @@
 import { spawn } from "node:child_process";
 import { randomUUID } from "node:crypto";
 import { stat } from "node:fs/promises";
+import { platform } from "node:os";
 import { basename, extname, resolve } from "node:path";
 import { Type } from "typebox";
 import { ensureBrowserScreenshotsDir } from "./generated-media.js";
@@ -102,12 +103,36 @@ const browserSchema = Type.Object({
         description: "Site-command positional arguments, in OpenCLI usage order, such as twitter post text.",
     })),
 }, { additionalProperties: false });
+function quoteWindowsShellArg(value) {
+    const escaped = value
+        .replace(/%/g, "%%")
+        .replace(/(\\*)"/g, '$1$1\\"')
+        .replace(/(\\+)$/g, "$1$1");
+    return `"${escaped}"`;
+}
+function buildSpawnInvocation(spec, currentPlatform = platform(), comSpec = process.env.ComSpec ?? "cmd.exe") {
+    const options = {
+        stdio: [spec.stdin ? "pipe" : "ignore", "pipe", "pipe"],
+        env: spec.env,
+    };
+    if (currentPlatform !== "win32")
+        return { command: spec.command, args: spec.args, options };
+    const commandLine = [spec.command, ...spec.args].map(quoteWindowsShellArg).join(" ");
+    return {
+        command: comSpec,
+        // cmd.exe strips one outer quote pair from the /c string. Wrap the whole
+        // already-quoted command so .cmd shims with spaced paths still receive argv.
+        args: ["/d", "/s", "/c", `"${commandLine}"`],
+        options: {
+            ...options,
+            windowsVerbatimArguments: true,
+        },
+    };
+}
 function defaultBrowserRunner() {
     return (spec, options) => new Promise((resolvePromise, reject) => {
-        const child = spawn(spec.command, spec.args, {
-            stdio: [spec.stdin ? "pipe" : "ignore", "pipe", "pipe"],
-            env: spec.env,
-        });
+        const invocation = buildSpawnInvocation(spec);
+        const child = spawn(invocation.command, invocation.args, invocation.options);
         const timeout = setTimeout(() => {
             child.kill("SIGTERM");
             reject(new Error(`Browser command timed out after ${options.timeoutMs}ms.`));
@@ -685,6 +710,7 @@ export function createBrowserTools(config, mediaSink, runner = defaultBrowserRun
     ];
 }
 export const __browserToolsTest = {
+    buildSpawnInvocation,
     buildHarnessSpec,
     buildPageArgs,
     buildRunSpec,

package/dist/discord.js

@@ -1,5 +1,6 @@
 import { randomUUID } from "node:crypto";
 import { once } from "node:events";
+import { readFile } from "node:fs/promises";
 import { ApplicationCommandOptionType, ApplicationCommandType, ApplicationIntegrationType, ChannelType, Client, Events, GatewayIntentBits, InteractionContextType, MessageFlags, Partials, } from "discord.js";
 import { createAgentEventRecorder, storedAgentEventFromAgentEvent, thinkingDurationMs, updateAgentEventSummary, } from "./agent-events.js";
 import { chatChannelKey, createChatLog } from "./chat-log.js";
@@ -326,6 +327,26 @@ async function delayBetweenBurstChunks(config, channel) {
 function normalizeOutboundText(text) {
     return text.trim() || "(empty response)";
 }
+async function discordAttachmentPayload(attachment) {
+    if (!attachment.localPath)
+        return undefined;
+    return {
+        attachment: await readFile(attachment.localPath),
+        name: attachment.name,
+    };
+}
+async function discordAttachmentPayloads(attachments) {
+    const payloads = [];
+    for (const attachment of attachments) {
+        const payload = await discordAttachmentPayload(attachment);
+        if (payload)
+            payloads.push(payload);
+    }
+    return payloads;
+}
+export const __test = {
+    discordAttachmentPayloads,
+};
 function parseAgentReply(text) {
     const normalized = text.replace(/\r\n/g, "\n").trim();
     if (normalized === SILENT_RESPONSE_MARKER) {
@@ -344,7 +365,7 @@ async function sendReply(config, message, text, replyToMessageId, attachments =
     for (const [index, chunk] of chunks.entries()) {
         if (index > 0)
             await delayBetweenBurstChunks(config, message.channel);
-        const files = index === 0 ? attachments.flatMap((attachment) => (attachment.localPath ? [attachment.localPath] : [])) : [];
+        const files = index === 0 ? await discordAttachmentPayloads(attachments) : [];
         let sent;
         if (index === 0 && config.discord.replyMode === "reply") {
             try {
@@ -379,7 +400,7 @@ async function sendChannelMessage(config, channel, text, attachments = []) {
     for (const [index, chunk] of chunks.entries()) {
         if (index > 0)
             await delayBetweenBurstChunks(config, channel);
-        const files = index === 0 ? attachments.flatMap((attachment) => (attachment.localPath ? [attachment.localPath] : [])) : [];
+        const files = index === 0 ? await discordAttachmentPayloads(attachments) : [];
         const sent = await channel.send(files.length > 0 ? { content: chunk, files } : chunk);
         sentIds.push(sent.id);
     }

package/dist/memory/lcm/context-transformer.js

@@ -599,8 +599,13 @@ function lcmRecordPartsFromAgentMessage(message) {
         return [];
     const parts = [];
     for (const item of content) {
-        if (item.type === "text")
-            parts.push({ kind: "text", text: item.text });
+        if (item.type === "text") {
+            parts.push({
+                kind: "text",
+                text: item.text,
+                ...(item.textSignature ? { signature: item.textSignature } : {}),
+            });
+        }
         else if (item.type === "thinking") {
             parts.push({
                 kind: "thinking",
@@ -609,7 +614,13 @@ function lcmRecordPartsFromAgentMessage(message) {
             });
         }
         else if (item.type === "toolCall") {
-            parts.push({ kind: "tool_call", toolCallId: item.id, toolName: item.name, arguments: item.arguments });
+            parts.push({
+                kind: "tool_call",
+                toolCallId: item.id,
+                toolName: item.name,
+                arguments: item.arguments,
+                ...(item.thoughtSignature ? { signature: item.thoughtSignature } : {}),
+            });
         }
         else if (item.type === "image") {
             parts.push({ kind: "text", text: `[image: ${item.mimeType}]` });

package/dist/memory/lcm/context.js

@@ -114,13 +114,18 @@ function estimateUserMessageTokens(message) {
 function estimateAssistantMessageTokens(message) {
     let tokens = MESSAGE_OVERHEAD_TOKENS;
     for (const block of message.content) {
-        if (block.type === "text")
+        if (block.type === "text") {
             tokens += estimateTextTokens(block.text);
-        else if (block.type === "thinking")
+            tokens += estimateTextTokens(block.textSignature ?? "");
+        }
+        else if (block.type === "thinking") {
             tokens += estimateTextTokens(block.thinking);
+            tokens += estimateTextTokens(block.thinkingSignature ?? "");
+        }
         else if (block.type === "toolCall") {
             tokens += estimateTextTokens(block.name);
             tokens += estimateJsonTokens(block.arguments);
+            tokens += estimateTextTokens(block.thoughtSignature ?? "");
         }
     }
     return tokens;
@@ -319,8 +324,13 @@ function structuredLcmRecordToAgentMessage(record, timestamp) {
 function structuredAssistantContent(parts) {
     const content = [];
     for (const part of parts) {
-        if (part.kind === "text" && part.text)
-            content.push({ type: "text", text: part.text });
+        if (part.kind === "text" && part.text) {
+            content.push({
+                type: "text",
+                text: part.text,
+                ...(part.signature ? { textSignature: part.signature } : {}),
+            });
+        }
         else if (part.kind === "thinking" && part.text) {
             content.push({
                 type: "thinking",
@@ -334,6 +344,7 @@ function structuredAssistantContent(parts) {
                 id: part.toolCallId,
                 name: part.toolName,
                 arguments: normalizeToolArguments(part.arguments),
+                ...(part.signature ? { thoughtSignature: part.signature } : {}),
             });
         }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@qearlyao/familiar",
-	"version": "0.2.0",
+	"version": "0.2.2",
 	"license": "MIT",
 	"type": "module",
 	"repository": {