@fugood/buttress-server 2.25.6 → 2.25.7

package/lib/agent/session-fs.d.ts

@@ -1,42 +1,3 @@
-import { FileError } from '@earendil-works/pi-agent-core';
-import type { Result } from '@earendil-works/pi-agent-core';
-/**
- * Minimal FileSystem implementation for the jsonl session repo, over node:fs.
- *
- * pi's NodeExecutionEnv classifies fs failures with `error instanceof Error`,
- * which breaks in vm-realm hosts (jest runs test code in a vm context, so
- * node-core errors come from another realm and ENOENT stops mapping to
- * not_found). This implementation reads `error.code` structurally — and also
- * skips pulling the exec-capable execution env into the server for what is
- * purely file storage.
- */
-type FileResult<T> = Promise<Result<T, FileError>>;
-declare const toFileInfo: (target: string, stats: import('node:fs').Stats) => {
-    name: string;
-    path: string;
-    kind: "directory" | "file" | "symlink";
-    size: number;
-    mtimeMs: number;
-};
-/** The `Pick<FileSystem, …>` surface JsonlSessionRepo requires. */
-export declare const createSessionFs: (rootDir: string) => {
-    absolutePath: (target: string) => FileResult<string>;
-    joinPath: (parts: string[]) => FileResult<string>;
-    readTextFile: (target: string) => FileResult<string>;
-    readTextLines: (target: string, options?: {
-        maxLines?: number;
-    }) => FileResult<string[]>;
-    writeFile: (target: string, content: string | Uint8Array) => FileResult<void>;
-    appendFile: (target: string, content: string | Uint8Array) => FileResult<void>;
-    renameFile: (source: string, destination: string) => FileResult<void>;
-    fileInfo: (target: string) => FileResult<ReturnType<typeof toFileInfo>>;
-    listDir: (target: string) => FileResult<ReturnType<typeof toFileInfo>[]>;
-    exists: (target: string) => FileResult<boolean>;
-    createDir: (target: string, options?: {
-        recursive?: boolean;
-    }) => FileResult<void>;
-    remove: (target: string, options?: {
-        recursive?: boolean;
-    }) => FileResult<void>;
-};
-export {};
+import type { FileSystem } from '@earendil-works/pi-agent-core';
+/** File storage for agent sessions that classifies errors structurally across vm realms. */
+export declare const createSessionFs: (rootDir: string) => FileSystem;

package/lib/agent/sessions.d.ts

@@ -1,15 +1,17 @@
-import { Session } from '@earendil-works/pi-agent-core';
-import type { AgentMessage } from '@earendil-works/pi-agent-core';
+import type { AgentMessage, Session } from '@earendil-works/pi-agent-core';
 import type { AgentSessionSummary, AgentsConfig } from './types';
 export type AgentSessionStore = {
     create: (agentName: string) => Promise<Session<any>>;
     /** Throws when the id is unknown within the agent's scope. */
     open: (agentName: string, sessionId: string) => Promise<Session<any>>;
     fork: (agentName: string, sessionId: string) => Promise<Session<any>>;
+    append: (session: Session<any>, message: AgentMessage) => Promise<string>;
+    close: (session: Session<any>) => Promise<void>;
     list: (agentName: string, limit?: number) => Promise<AgentSessionSummary[]>;
     /** Reconstruct the pi message history for continuing a session. */
     messages: (session: Session<any>) => Promise<AgentMessage[]>;
     /** Retention sweep across every configured agent scope. */
     sweep: (agentNames: string[]) => Promise<number>;
+    dispose: () => Promise<void>;
 };
 export declare const createAgentSessionStore: (config: AgentsConfig) => AgentSessionStore;