@agent-api/app-engine 0.0.1

package/dist/workbench/view-model.js

@@ -0,0 +1,121 @@
+export function buildTranscriptViewModel(input) {
+    const lines = buildTranscriptLines(input.messages, {
+        activeAssistantMessageId: input.activeAssistantMessageId,
+        busy: input.busy,
+        renderMode: input.renderMode,
+        spinnerFrame: input.spinnerFrame,
+        width: input.width,
+    });
+    const maxOffset = Math.max(0, lines.length - input.viewportHeight);
+    const offset = Math.min(input.offset, maxOffset);
+    const start = Math.max(0, lines.length - input.viewportHeight - offset);
+    return {
+        lines,
+        visibleLines: lines.slice(start, start + input.viewportHeight),
+        maxOffset,
+        offset,
+        viewportHeight: input.viewportHeight,
+    };
+}
+export function buildTranscriptLines(messages, options) {
+    const lines = [];
+    for (const message of messages) {
+        const waiting = message.role === "assistant" && options.busy && message.id === options.activeAssistantMessageId && !message.text;
+        lines.push({
+            id: `${message.id}:role`,
+            text: roleLabel(message.role),
+            color: roleColor(message.role),
+        });
+        const content = message.text || (waiting ? `${spinnerGlyph(options.spinnerFrame)} thinking ${elapsedDots(options.spinnerFrame)}` : "");
+        const rendered = options.renderMode === "raw"
+            ? rawTranscriptLines(content, options.width)
+            : markdownTranscriptLines(content, options.width);
+        rendered.forEach((line, index) => {
+            lines.push({
+                ...line,
+                id: `${message.id}:line:${index}`,
+            });
+        });
+        if (message.role !== "system") {
+            lines.push({ id: `${message.id}:space`, text: "" });
+        }
+    }
+    return lines;
+}
+export function spinnerGlyph(frame) {
+    return ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"][frame % 10];
+}
+export function elapsedDots(frame) {
+    return ".".repeat((Math.floor(frame / 4) % 3) + 1);
+}
+function rawTranscriptLines(text, width) {
+    const source = text ? text.split(/\r?\n/) : [""];
+    return source.flatMap((line) => wrapTranscriptText(line, width).map((text) => ({ text })));
+}
+function markdownTranscriptLines(text, width) {
+    const source = text ? text.split(/\r?\n/) : [""];
+    const lines = [];
+    let inCode = false;
+    for (const sourceLine of source) {
+        if (/^\s*```/.test(sourceLine)) {
+            inCode = !inCode;
+            lines.push(...wrapTranscriptText(sourceLine, width).map((line) => ({ text: line, color: "gray" })));
+            continue;
+        }
+        lines.push(...markdownTranscriptLine(sourceLine, { code: inCode, width }));
+    }
+    return lines;
+}
+function markdownTranscriptLine(line, options) {
+    if (line === "")
+        return [{ text: "" }];
+    if (options.code)
+        return wrapTranscriptText(line, options.width).map((text) => ({ text, color: "gray" }));
+    const heading = /^(#{1,6})\s+(.+)$/.exec(line);
+    if (heading) {
+        const color = heading[1].length <= 2 ? "cyan" : "blue";
+        return wrapTranscriptText(heading[2], options.width).map((text) => ({ text, bold: true, color }));
+    }
+    if (/^\s*---+\s*$/.test(line))
+        return [{ text: "─".repeat(Math.min(48, options.width)), color: "gray" }];
+    const bullet = /^(\s*)[-*]\s+(.+)$/.exec(line);
+    if (bullet)
+        return wrapTranscriptText(`${bullet[1]}• ${bullet[2]}`, options.width).map((text) => ({ text }));
+    const numbered = /^(\s*)(\d+\.)\s+(.+)$/.exec(line);
+    if (numbered)
+        return wrapTranscriptText(`${numbered[1]}${numbered[2]} ${numbered[3]}`, options.width).map((text) => ({ text }));
+    const quote = /^\s*>\s?(.+)$/.exec(line);
+    if (quote)
+        return wrapTranscriptText(`│ ${quote[1]}`, options.width).map((text) => ({ text, color: "gray" }));
+    return wrapTranscriptText(line, options.width).map((text) => ({ text }));
+}
+function wrapTranscriptText(text, width) {
+    const max = Math.max(12, width);
+    if (text.length === 0)
+        return [""];
+    const lines = [];
+    let rest = text;
+    while (rest.length > max) {
+        const hard = rest.slice(0, max);
+        const softBreak = Math.max(hard.lastIndexOf(" "), hard.lastIndexOf("\t"));
+        const index = softBreak > Math.floor(max * 0.45) ? softBreak : max;
+        lines.push(rest.slice(0, index).trimEnd());
+        rest = rest.slice(index).trimStart();
+    }
+    lines.push(rest);
+    return lines;
+}
+function roleLabel(role) {
+    if (role === "user")
+        return "You";
+    if (role === "assistant")
+        return "Agent";
+    return "System";
+}
+function roleColor(role) {
+    if (role === "user")
+        return "green";
+    if (role === "assistant")
+        return "cyan";
+    return "gray";
+}

package/dist/workdir/index.d.ts

@@ -0,0 +1,22 @@
+import { type LocalContextManifest, type LocalSummary, type LocalWorkdir, type LocalWorkdirSnapshot } from "@agent-api/sdk/local";
+export interface WorkdirOptions {
+    path?: string;
+    name?: string;
+}
+export interface WorkdirContextOptions extends WorkdirOptions {
+    query?: string;
+    maxFiles?: number;
+    maxBytes?: number;
+    includeContent?: boolean;
+}
+export interface WorkdirService {
+    root: string;
+    name: string;
+    workdir: LocalWorkdir;
+    summarize(): Promise<LocalSummary>;
+    snapshot(): Promise<LocalWorkdirSnapshot>;
+    packageContext(options?: Omit<WorkdirContextOptions, "path" | "name">): Promise<LocalContextManifest>;
+    contextBlock(options?: Omit<WorkdirContextOptions, "path" | "name">): Promise<string>;
+}
+export declare function openWorkdir(options?: WorkdirOptions): Promise<WorkdirService>;
+export declare function buildWorkdirContextBlock(options: WorkdirContextOptions): Promise<string>;

package/dist/workdir/index.js

@@ -0,0 +1,46 @@
+import { createLocalContextPackage, } from "@agent-api/sdk/local";
+import { resolve } from "node:path";
+import { runtime } from "../runtime/index.js";
+export async function openWorkdir(options = {}) {
+    await runtime.ensure();
+    const root = resolve(options.path || process.cwd());
+    const name = options.name || root.split(/[\\/]/).filter(Boolean).at(-1) || "workdir";
+    const workdir = runtime.workdir(root, {
+        name,
+        trusted: true,
+        gitignore: true,
+    });
+    return {
+        root,
+        name,
+        workdir,
+        summarize: () => workdir.summarize(),
+        snapshot: () => workdir.snapshot({ hash: true }),
+        packageContext: (contextOptions = {}) => createLocalContextPackage(workdir, {
+            query: contextOptions.query,
+            includeSearch: Boolean(contextOptions.query),
+            maxFiles: contextOptions.maxFiles,
+            maxBytes: contextOptions.maxBytes,
+            includeContent: contextOptions.includeContent,
+        }),
+        contextBlock: async (contextOptions = {}) => {
+            const context = await createLocalContextPackage(workdir, {
+                query: contextOptions.query,
+                includeSearch: Boolean(contextOptions.query),
+                maxFiles: contextOptions.maxFiles,
+                maxBytes: contextOptions.maxBytes,
+                includeContent: contextOptions.includeContent,
+            });
+            return [
+                "Local workdir context follows. Use it as user-provided project context; do not assume files outside this manifest exist.",
+                "```json",
+                JSON.stringify(context, null, 2),
+                "```",
+            ].join("\n");
+        },
+    };
+}
+export async function buildWorkdirContextBlock(options) {
+    const service = await openWorkdir(options);
+    return service.contextBlock(options);
+}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@agent-api/app-engine",
+  "version": "0.0.1",
+  "description": "Renderer-neutral application engine for Agent API apps",
+  "license": "MIT",
+  "homepage": "https://github.com/scalebox-dev/agent-tui#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/scalebox-dev/agent-tui.git",
+    "directory": "packages/app-engine"
+  },
+  "bugs": {
+    "url": "https://github.com/scalebox-dev/agent-tui/issues"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
+    "build": "npm run clean && tsc -p tsconfig.json",
+    "smoke": "node test/smoke.mjs",
+    "test": "npm run build && npm run smoke",
+    "prepack": "npm run build",
+    "pack:local": "npm pack --pack-destination ./artifacts"
+  },
+  "dependencies": {
+    "@agent-api/sdk": "^1.3.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "package.json"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}