@termfleet/core 0.1.2 → 0.1.4

package/README.md

@@ -55,7 +55,8 @@ const session = readLocalAgentSession({
   sessionId: "claude:0f9c…",         // or "codex:…", "gemini:…", or a bare Claude uuid
 });
 
-console.log(session.agentSessionId);   // "claude:0f9c…"
+console.log(session.sessionId);        // "claude:0f9c…" (prefixed)
+console.log(session.agentSessionId);   // "0f9c…" (bare id, no prefix)
 console.log(session.lastAssistantText);
 console.log(session.endOfTurn);        // is the turn finished?
 for (const item of session.timeline) {
@@ -101,10 +102,18 @@ const off = client.onSnapshot((snapshot) => { /* … */ });
 
 // create a fresh agent window (boot a claude/codex/gemini session)
 await client.createAgentWindow({ /* AgentWindowCreateOptions */ });
+
+// terminals + files: capture/send, and read/write through the provider filesystem
+const { content } = await client.captureTerminal("term-1", 40);
+await client.sendTerminalInput("term-1", "echo hi\n", { breakGlass: true });
+const bytes = await client.readFile("term-1", "/path/file");  // Uint8Array (browser-safe)
+const text = new TextDecoder().decode(bytes);                 // node: or Buffer.from(bytes)
 ```
 
 Pass `{ authToken }` for an authenticated/shared provider, or a `urlResolver`
-when proxying through a console; omit both for a direct connection.
+when proxying through a console; omit both for a direct connection. `readFile`
+returns a `Uint8Array` (not a node `Buffer`, since this client also runs in the
+browser) — decode with `new TextDecoder().decode(bytes)` or `Buffer.from(bytes)`.
 
 ## What's inside
 

package/dist/local-tunnel.js

@@ -84,9 +84,12 @@ function startLocalTunnel(src, options) {
     if (!Number.isInteger(port) || port < 1 || port > 65535) {
         throw new Error(`Cannot tunnel iframe URL with invalid local port: ${src.href}`);
     }
-    const bin = process.env.TERMFLEET_LOCAL_TUNNEL_BIN ?? "volter-tunnel";
+    const bin = process.env.TERMFLEET_LOCAL_TUNNEL_BIN;
+    if (!bin) {
+        throw new Error("Tunneling requires a tunnel client. Set TERMFLEET_LOCAL_TUNNEL_BIN to your tunnel client binary (or use a standalone tunnel like ngrok/cloudflared — see the README).");
+    }
     if (!commandExists(bin)) {
-        throw new Error(`Opening localhost iframe panels requires ${bin} on PATH. Set TERMFLEET_LOCAL_TUNNEL_BIN to your tunnel client.`);
+        throw new Error(`Tunnel client "${bin}" (TERMFLEET_LOCAL_TUNNEL_BIN) is not on PATH.`);
     }
     const tunnelServerUrl = process.env.TUNNEL_SERVER_URL ?? process.env.TERMFLEET_TUNNEL_SERVER_URL;
     if (!tunnelServerUrl) {

package/dist/provider-client.d.ts

@@ -120,15 +120,15 @@ export declare class ProviderClient {
     }): Promise<CommandAck<T>>;
     listDirectory(terminalId: string, path: string): Promise<ProviderDirectoryList>;
     listDirectoryByFilesystem(filesystemId: string, path: string): Promise<ProviderDirectoryList>;
-    readFile(terminalId: string, path: string): Promise<Buffer>;
-    readFileByFilesystem(filesystemId: string, path: string): Promise<Buffer>;
+    readFile(terminalId: string, path: string): Promise<Uint8Array>;
+    readFileByFilesystem(filesystemId: string, path: string): Promise<Uint8Array>;
     statFile(terminalId: string, path: string): Promise<ProviderFileStat>;
     statFileByFilesystem(filesystemId: string, path: string): Promise<ProviderFileStat>;
-    writeFile(terminalId: string, path: string, data: Buffer, options?: {
+    writeFile(terminalId: string, path: string, data: Uint8Array, options?: {
         mkdirs?: boolean;
         mode?: string;
     }): Promise<ProviderFileWriteResult>;
-    writeFileByFilesystem(filesystemId: string, path: string, data: Buffer, options?: {
+    writeFileByFilesystem(filesystemId: string, path: string, data: Uint8Array, options?: {
         mkdirs?: boolean;
         mode?: string;
     }): Promise<ProviderFileWriteResult>;

package/dist/provider-client.js

@@ -385,6 +385,9 @@ export class ProviderClient {
         }
         return await response.json();
     }
+    // Returns raw bytes as a Uint8Array (browser-safe — this client also runs in the
+    // browser, where node's Buffer is absent). Node consumers decode with
+    // `Buffer.from(bytes)` or `new TextDecoder().decode(bytes)`.
     async readFile(terminalId, path) {
         const url = new URL(`${this.apiBase}/api/files`);
         url.searchParams.set("terminalId", terminalId);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@termfleet/core",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Termfleet core: contracts, the provider SDK, and the agent-transcript/session library (Claude Code / Codex / Gemini). The reusable layer, usable beyond the console.",
   "keywords": [
     "claude-code",
@@ -37,7 +37,7 @@
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json",
-    "prepare": "tsc -p tsconfig.json"
+    "prepack": "tsc -p tsconfig.json"
   },
   "dependencies": {
     "socket.io-client": "^4.8.3",