longer-agent 0.1.0

package/dist/ephemeral-log.js

@@ -0,0 +1,173 @@
+import { LogIdAllocator, createAssistantText, createNoReply, createReasoning, createSystemPrompt, createToolCall, createToolResult, createUserMessage, } from "./log-entry.js";
+import { allocateContextId, stripContextTags } from "./context-rendering.js";
+import { projectToApiMessages } from "./log-projection.js";
+export function createEphemeralLogState(initialMessages, opts) {
+    const entries = [];
+    const idAllocator = new LogIdAllocator();
+    const usedContextIds = new Set();
+    const turnIndex = opts?.turnIndex ?? 0;
+    let nextRoundIndex = 0;
+    let lastAssistantRoundIndex = 0;
+    let sawSystemPrompt = false;
+    const allocContextId = () => allocateContextId(usedContextIds);
+    const trackContextId = (value) => {
+        if (value === undefined || value === null)
+            return undefined;
+        const normalized = String(value);
+        if (normalized)
+            usedContextIds.add(normalized);
+        return normalized || undefined;
+    };
+    const appendImportedEntry = (entry) => {
+        const ctxId = entry.meta["contextId"];
+        if (ctxId !== undefined && ctxId !== null) {
+            usedContextIds.add(String(ctxId));
+        }
+        entries.push(entry);
+    };
+    for (const msg of initialMessages) {
+        const role = String(msg["role"] ?? "");
+        if (role === "system") {
+            const content = normalizeTextContent(msg["content"]);
+            if (!sawSystemPrompt) {
+                appendImportedEntry(createSystemPrompt(idAllocator.next("system_prompt"), content));
+                sawSystemPrompt = true;
+            }
+            else {
+                appendImportedEntry(createUserMessage(idAllocator.next("user_message"), turnIndex, summarizeContentForDisplay(content), content, trackContextId(msg["_context_id"]) ?? allocContextId()));
+            }
+            continue;
+        }
+        if (role === "user") {
+            const content = cloneContent(msg["content"]);
+            appendImportedEntry(createUserMessage(idAllocator.next("user_message"), turnIndex, summarizeContentForDisplay(content), content, trackContextId(msg["_context_id"]) ?? allocContextId()));
+            continue;
+        }
+        if (role === "assistant") {
+            const roundIndex = nextRoundIndex++;
+            lastAssistantRoundIndex = roundIndex;
+            const contextId = trackContextId(msg["_context_id"]);
+            const reasoningContent = msg["reasoning_content"];
+            if (reasoningContent !== undefined && reasoningContent !== null) {
+                const normalizedReasoning = normalizeTextContent(reasoningContent);
+                appendImportedEntry(createReasoning(idAllocator.next("reasoning"), turnIndex, roundIndex, normalizedReasoning, normalizedReasoning, msg["_reasoning_state"], contextId));
+            }
+            const toolCalls = Array.isArray(msg["tool_calls"])
+                ? msg["tool_calls"]
+                : [];
+            const assistantText = resolveAssistantText(msg);
+            if (toolCalls.length > 0) {
+                if (assistantText) {
+                    appendImportedEntry(createAssistantText(idAllocator.next("assistant_text"), turnIndex, roundIndex, stripContextTags(assistantText), assistantText, contextId));
+                }
+                for (const tc of toolCalls) {
+                    const toolCallId = String(tc["id"] ?? "");
+                    const toolName = String(tc["name"] ?? "");
+                    appendImportedEntry(createToolCall(idAllocator.next("tool_call"), turnIndex, roundIndex, toolName, {
+                        id: toolCallId,
+                        name: toolName,
+                        arguments: asRecord(tc["arguments"]),
+                    }, {
+                        toolCallId,
+                        toolName,
+                        agentName: "",
+                        contextId,
+                    }));
+                }
+                continue;
+            }
+            if (assistantText) {
+                if (assistantText.trim() === "<NO_REPLY>") {
+                    appendImportedEntry(createNoReply(idAllocator.next("no_reply"), turnIndex, roundIndex, assistantText, contextId));
+                }
+                else {
+                    appendImportedEntry(createAssistantText(idAllocator.next("assistant_text"), turnIndex, roundIndex, stripContextTags(assistantText), assistantText, contextId));
+                }
+            }
+            continue;
+        }
+        if (role === "tool_result") {
+            const content = normalizeTextContent(msg["content"]);
+            appendImportedEntry(createToolResult(idAllocator.next("tool_result"), turnIndex, lastAssistantRoundIndex, {
+                toolCallId: String(msg["tool_call_id"] ?? ""),
+                toolName: String(msg["tool_name"] ?? ""),
+                content,
+                toolSummary: String(msg["tool_summary"] ?? msg["tool_name"] ?? ""),
+            }, {
+                isError: content.startsWith("ERROR:"),
+                contextId: trackContextId(msg["_context_id"]),
+            }));
+        }
+    }
+    return {
+        entries,
+        getMessages: () => projectToApiMessages(entries, {
+            requiresAlternatingRoles: opts?.requiresAlternatingRoles,
+        }),
+        appendEntry: (entry) => {
+            const ctxId = entry.meta["contextId"];
+            if (ctxId !== undefined && ctxId !== null) {
+                usedContextIds.add(String(ctxId));
+            }
+            entries.push(entry);
+        },
+        allocId: (type) => idAllocator.next(type),
+        allocateContextId: allocContextId,
+        computeNextRoundIndex: () => {
+            let maxRound = -1;
+            for (const entry of entries) {
+                if (entry.roundIndex !== undefined) {
+                    maxRound = Math.max(maxRound, entry.roundIndex);
+                }
+            }
+            return maxRound + 1;
+        },
+    };
+}
+function resolveAssistantText(message) {
+    if (typeof message["text"] === "string")
+        return message["text"];
+    return normalizeTextContent(message["content"]);
+}
+function normalizeTextContent(content) {
+    if (typeof content === "string")
+        return content;
+    if (Array.isArray(content)) {
+        const text = content
+            .filter((block) => block && typeof block === "object")
+            .map((block) => {
+            const record = block;
+            return record["type"] === "text" ? String(record["text"] ?? "") : "";
+        })
+            .filter(Boolean)
+            .join("\n");
+        return text || JSON.stringify(content);
+    }
+    if (content === undefined || content === null)
+        return "";
+    return String(content);
+}
+function summarizeContentForDisplay(content) {
+    if (typeof content === "string")
+        return stripContextTags(content);
+    if (Array.isArray(content)) {
+        const text = normalizeTextContent(content).trim();
+        return text || "[multimodal message]";
+    }
+    return String(content ?? "");
+}
+function cloneContent(content) {
+    if (Array.isArray(content)) {
+        return content.map((block) => block && typeof block === "object"
+            ? { ...block }
+            : block);
+    }
+    return content;
+}
+function asRecord(value) {
+    if (value && typeof value === "object" && !Array.isArray(value)) {
+        return { ...value };
+    }
+    return {};
+}
+//# sourceMappingURL=ephemeral-log.js.map

package/dist/ephemeral-log.js.map

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

package/dist/file-attach.d.ts

@@ -0,0 +1,89 @@
+/**
+ * File attachment support for @filename references.
+ *
+ * Parses `@path/to/file` references in user input, reads and summarizes
+ * file contents, and renders them as `<context label="User Files">` blocks
+ * for injection into Talker messages.
+ *
+ * Usage:
+ *
+ *   import { process } from "./file-attach.js";
+ *
+ *   const result = process("Review @src/main.ts and fix bugs");
+ *   // result.cleanedText  -> "Review and fix bugs"
+ *   // result.contextStr   -> '<context label="User Files">...</context>'
+ *   // result.files         -> [FileInfo, ...]
+ */
+export declare const IMAGE_MEDIA_TYPES: Record<string, string>;
+/**
+ * Scan `cwd` for files matching `prefix`, return relative path strings.
+ *
+ * - Empty prefix: list top-level files only (no recursion).
+ * - Non-empty prefix: recursive scan up to `maxDepth`, matching paths
+ *   that start with the prefix.
+ * - Directories in `SCAN_EXCLUDE_DIRS` are skipped.
+ * - Results sorted by path length (shortest first), capped at `maxResults`.
+ */
+export declare function scanCandidates(prefix: string, cwd?: string, maxResults?: number, maxDepth?: number): string[];
+/** Metadata and content for a single attached file. */
+export interface FileInfo {
+    originalRef: string;
+    path: string;
+    exists: boolean;
+    isImage: boolean;
+    isBinary: boolean;
+    projectedDocumentType: string | null;
+    sizeBytes: number;
+    charCount: number;
+    lineCount: number;
+    content: string;
+    isPreview: boolean;
+    isCode: boolean;
+    error: string;
+    imageData: string | null;
+    imageMediaType: string | null;
+}
+/** Result of processing @file references in user input. */
+export interface FileAttachResult {
+    cleanedText: string;
+    contextStr: string;
+    files: FileInfo[];
+    warnings: string[];
+}
+/** Whether any files were attached. */
+export declare function hasFiles(result: FileAttachResult): boolean;
+/** Whether any attached file has base64 image data for multimodal. */
+export declare function hasImages(result: FileAttachResult): boolean;
+/**
+ * Extract @path references and return [cleanedText, paths].
+ *
+ * Email-like patterns (user@example.com) are not matched because
+ * the regex requires @ to be preceded by whitespace or line start.
+ */
+export declare function parseReferences(text: string): [string, string[]];
+/**
+ * Resolve a raw path string to an absolute path.
+ */
+export declare function resolvePath(raw: string, cwd?: string): string;
+/**
+ * Classify a file by extension.
+ * Returns `[isImage, isBinary, projectedDocumentType]`.
+ */
+export declare function classifyFile(filePath: string): [boolean, boolean, string | null];
+/**
+ * Read a file and produce a FileInfo with content/summary.
+ */
+export declare function readAndSummarize(filePath: string, isImage?: boolean, isBinary?: boolean, projectedDocumentType?: string | null, supportsMultimodal?: boolean, artifactsDir?: string): Promise<FileInfo>;
+/**
+ * Format a list of FileInfo into numbered text entries.
+ */
+export declare function formatContextBlock(files: FileInfo[]): string;
+/**
+ * Process `@file` references in user input.
+ *
+ * This is the main entry point. It parses references, reads files,
+ * and returns a FileAttachResult with cleaned text and a
+ * rendered `<context>` block.
+ */
+export declare function processFileAttachments(userInput: string, cwd?: string, supportsMultimodal?: boolean, baseDir?: string, allowedExternalBaseDirs?: string[], artifactsDir?: string): Promise<FileAttachResult>;
+//# sourceMappingURL=file-attach.d.ts.map

package/dist/file-attach.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-attach.d.ts","sourceRoot":"","sources":["../src/file-attach.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AA+CH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAUpD,CAAC;AAYF;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,GAAG,CAAC,EAAE,MAAM,EACZ,UAAU,SAAK,EACf,QAAQ,SAAI,GACX,MAAM,EAAE,CA0EV;AAMD,uDAAuD;AACvD,MAAM,WAAW,QAAQ;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAqDD,2DAA2D;AAC3D,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,uCAAuC;AACvC,wBAAgB,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAE1D;AAED,sEAAsE;AACtE,wBAAgB,SAAS,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAE3D;AAMD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAYhE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAI7D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,GACf,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC,CAMnC;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,OAAO,UAAQ,EACf,QAAQ,UAAQ,EAChB,qBAAqB,GAAE,MAAM,GAAG,IAAW,EAC3C,kBAAkB,UAAQ,EAC1B,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,QAAQ,CAAC,CAqJnB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CA4E5D;AAMD;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,EACjB,GAAG,CAAC,EAAE,MAAM,EACZ,kBAAkB,UAAQ,EAC1B,OAAO,CAAC,EAAE,MAAM,EAChB,uBAAuB,CAAC,EAAE,MAAM,EAAE,EAClC,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,gBAAgB,CAAC,CA6G3B"}