pi2web 0.2.1 → 0.2.6

package/dist/metadata-store.js

@@ -1,8 +1,31 @@
 import Database from 'better-sqlite3';
 import { chmodSync, mkdirSync, statSync } from 'node:fs';
 import path from 'node:path';
-const asTime = (value) => { const time = value instanceof Date ? value.getTime() : typeof value === 'number' ? value : Date.parse(value ?? ''); return Number.isFinite(time) ? time : Date.now(); };
-/** SQLite-backed Remote Pi metadata. Pi conversation JSONL files remain the source of truth. */
+import { METADATA_DB_FILE } from './paths.js';
+const asTime = (value) => {
+    const time = value instanceof Date ? value.getTime() : typeof value === 'number' ? value : Date.parse(value ?? '');
+    return Number.isFinite(time) ? time : Date.now();
+};
+const parseTemplate = (value) => {
+    if (typeof value !== 'string' || !value)
+        return;
+    try {
+        const parsed = JSON.parse(value);
+        if (parsed &&
+            typeof parsed.id === 'string' &&
+            typeof parsed.systemPrompt === 'string' &&
+            (parsed.mode === 'replace' || parsed.mode === 'append'))
+            return {
+                id: parsed.id,
+                name: String(parsed.name ?? parsed.id),
+                mode: parsed.mode,
+                systemPrompt: parsed.systemPrompt
+            };
+    }
+    catch { }
+    return;
+};
+/** SQLite-backed pi2web metadata. Pi conversation JSONL files remain the source of truth. */
 export class MetadataStore {
     dataDir;
     db;
@@ -12,7 +35,9 @@ export class MetadataStore {
     constructor(dataDir) {
         this.dataDir = dataDir;
     }
-    get file() { return path.join(this.dataDir, 'remote-pi.db'); }
+    get file() {
+        return path.join(this.dataDir, METADATA_DB_FILE);
+    }
     init() {
         if (this.db)
             return;
@@ -21,7 +46,7 @@ export class MetadataStore {
             chmodSync(this.dataDir, 0o700);
         }
         catch { }
-        const db = this.db = new Database(this.file);
+        const db = (this.db = new Database(this.file));
         try {
             chmodSync(this.file, 0o600);
         }
@@ -46,6 +71,7 @@ export class MetadataStore {
         cwd TEXT NOT NULL,
         status TEXT NOT NULL,
         profile TEXT NOT NULL DEFAULT 'default',
+        template TEXT,
         created_at INTEGER NOT NULL,
         last_active_at INTEGER NOT NULL,
         archived_at INTEGER,
@@ -82,67 +108,175 @@ export class MetadataStore {
         const agentColumns = db.prepare('PRAGMA table_info(agents)').all();
         if (!agentColumns.some(column => column.name === 'profile'))
             db.exec("ALTER TABLE agents ADD COLUMN profile TEXT NOT NULL DEFAULT 'default'");
+        // System prompt template snapshot (JSON). Agents created before templates existed use Pi's prompt.
+        if (!agentColumns.some(column => column.name === 'template'))
+            db.exec('ALTER TABLE agents ADD COLUMN template TEXT');
         // Only stamp the initial version: later migrations (collaboration tables) raise it and must not be reset on restart.
         if (Number(db.pragma('user_version', { simple: true })) < 1)
             db.pragma('user_version = 1');
         this.archivedAgents = new Set(db.prepare('SELECT id FROM agents WHERE archived_at IS NOT NULL').all().map(row => row.id));
     }
-    get database() { if (!this.db)
-        throw new Error('Metadata store is not initialized'); return this.db; }
+    get database() {
+        if (!this.db)
+            throw new Error('Metadata store is not initialized');
+        return this.db;
+    }
     /** Shared handle so collaboration tables live in the same file and the same backup. */
-    get connection() { return this.database; }
-    getSetting(key) { const row = this.database.prepare('SELECT value FROM settings WHERE key=?').get(key); if (!row)
-        return; try {
-        return JSON.parse(row.value);
+    get connection() {
+        return this.database;
+    }
+    getSetting(key) {
+        const row = this.database.prepare('SELECT value FROM settings WHERE key=?').get(key);
+        if (!row)
+            return;
+        try {
+            return JSON.parse(row.value);
+        }
+        catch {
+            return;
+        }
+    }
+    setSetting(key, value) {
+        this.database
+            .prepare('INSERT INTO settings(key,value,updated_at) VALUES(?,?,?) ON CONFLICT(key) DO UPDATE SET value=excluded.value,updated_at=excluded.updated_at')
+            .run(key, JSON.stringify(value), Date.now());
+    }
+    listWorkspaces() {
+        return this.database
+            .prepare('SELECT id,label,root_path,created_at FROM workspaces ORDER BY created_at,id')
+            .all().map(row => ({
+            id: row.id,
+            label: row.label,
+            rootPath: row.root_path,
+            createdAt: new Date(row.created_at).toISOString()
+        }));
+    }
+    saveWorkspace(workspace) {
+        this.database
+            .prepare(`INSERT INTO workspaces(id,label,root_path,created_at) VALUES(?,?,?,?) ON CONFLICT(id) DO UPDATE SET label=excluded.label,root_path=excluded.root_path`)
+            .run(workspace.id, workspace.label, workspace.rootPath, asTime(workspace.createdAt));
+    }
+    listAgents() {
+        return this.database
+            .prepare('SELECT * FROM agents WHERE archived_at IS NULL ORDER BY last_active_at DESC,id DESC')
+            .all().map(row => ({
+            agentId: row.id,
+            workspaceId: row.workspace_id,
+            sessionId: row.session_id,
+            sessionFile: row.session_file ?? undefined,
+            sessionName: row.session_name ?? undefined,
+            cwd: row.cwd,
+            status: row.status,
+            profile: row.profile === 'collab' ? 'collab' : 'default',
+            ...(parseTemplate(row.template) ? { template: parseTemplate(row.template) } : {}),
+            createdAt: new Date(row.created_at).toISOString(),
+            lastActiveAt: new Date(row.last_active_at).toISOString()
+        }));
+    }
+    writeAgent(record, archivedAt) {
+        this.database
+            .prepare(
+        // `template` is written on insert only: an Agent's system prompt template never changes.
+        `INSERT INTO agents(id,workspace_id,session_id,session_file,session_name,cwd,status,profile,template,created_at,last_active_at,archived_at) VALUES(?,?,?,?,?,?,?,?,?,?,?,?) ON CONFLICT(id) DO UPDATE SET workspace_id=excluded.workspace_id,session_id=excluded.session_id,session_file=excluded.session_file,session_name=excluded.session_name,cwd=excluded.cwd,status=excluded.status,profile=excluded.profile,last_active_at=excluded.last_active_at,archived_at=excluded.archived_at`)
+            .run(record.agentId, record.workspaceId, record.sessionId, record.sessionFile ?? null, record.sessionName ?? null, record.cwd, record.status, record.profile ?? 'default', record.template ? JSON.stringify(record.template) : null, asTime(record.createdAt), asTime(record.lastActiveAt), archivedAt);
+    }
+    saveAgent(record) {
+        if (this.archivedAgents.has(record.agentId))
+            return;
+        this.pendingAgents.delete(record.agentId);
+        this.writeAgent(record, null);
+    }
+    scheduleAgent(record) {
+        if (this.archivedAgents.has(record.agentId))
+            return;
+        this.pendingAgents.set(record.agentId, { ...record });
+        if (!this.flushTimer)
+            this.flushTimer = setTimeout(() => this.flush(), 1000);
+    }
+    archiveAgent(record) {
+        this.archivedAgents.add(record.agentId);
+        this.pendingAgents.delete(record.agentId);
+        this.writeAgent(record, Date.now());
+    }
+    flush() {
+        if (this.flushTimer) {
+            clearTimeout(this.flushTimer);
+            this.flushTimer = undefined;
+        }
+        if (!this.pendingAgents.size)
+            return;
+        const records = [...this.pendingAgents.values()];
+        this.pendingAgents.clear();
+        this.database.transaction((items) => {
+            for (const item of items)
+                this.writeAgent(item, null);
+        })(records);
     }
-    catch {
-        return;
-    } }
-    setSetting(key, value) { this.database.prepare('INSERT INTO settings(key,value,updated_at) VALUES(?,?,?) ON CONFLICT(key) DO UPDATE SET value=excluded.value,updated_at=excluded.updated_at').run(key, JSON.stringify(value), Date.now()); }
-    listWorkspaces() { return this.database.prepare('SELECT id,label,root_path,created_at FROM workspaces ORDER BY created_at,id').all().map(row => ({ id: row.id, label: row.label, rootPath: row.root_path, createdAt: new Date(row.created_at).toISOString() })); }
-    saveWorkspace(workspace) { this.database.prepare(`INSERT INTO workspaces(id,label,root_path,created_at) VALUES(?,?,?,?) ON CONFLICT(id) DO UPDATE SET label=excluded.label,root_path=excluded.root_path`).run(workspace.id, workspace.label, workspace.rootPath, asTime(workspace.createdAt)); }
-    listAgents() { return this.database.prepare('SELECT * FROM agents WHERE archived_at IS NULL ORDER BY last_active_at DESC,id DESC').all().map(row => ({ agentId: row.id, workspaceId: row.workspace_id, sessionId: row.session_id, sessionFile: row.session_file ?? undefined, sessionName: row.session_name ?? undefined, cwd: row.cwd, status: row.status, profile: row.profile === 'collab' ? 'collab' : 'default', createdAt: new Date(row.created_at).toISOString(), lastActiveAt: new Date(row.last_active_at).toISOString() })); }
-    writeAgent(record, archivedAt) { this.database.prepare(`INSERT INTO agents(id,workspace_id,session_id,session_file,session_name,cwd,status,profile,created_at,last_active_at,archived_at) VALUES(?,?,?,?,?,?,?,?,?,?,?) ON CONFLICT(id) DO UPDATE SET workspace_id=excluded.workspace_id,session_id=excluded.session_id,session_file=excluded.session_file,session_name=excluded.session_name,cwd=excluded.cwd,status=excluded.status,profile=excluded.profile,last_active_at=excluded.last_active_at,archived_at=excluded.archived_at`).run(record.agentId, record.workspaceId, record.sessionId, record.sessionFile ?? null, record.sessionName ?? null, record.cwd, record.status, record.profile ?? 'default', asTime(record.createdAt), asTime(record.lastActiveAt), archivedAt); }
-    saveAgent(record) { if (this.archivedAgents.has(record.agentId))
-        return; this.pendingAgents.delete(record.agentId); this.writeAgent(record, null); }
-    scheduleAgent(record) { if (this.archivedAgents.has(record.agentId))
-        return; this.pendingAgents.set(record.agentId, { ...record }); if (!this.flushTimer)
-        this.flushTimer = setTimeout(() => this.flush(), 1000); }
-    archiveAgent(record) { this.archivedAgents.add(record.agentId); this.pendingAgents.delete(record.agentId); this.writeAgent(record, Date.now()); }
-    flush() { if (this.flushTimer) {
-        clearTimeout(this.flushTimer);
-        this.flushTimer = undefined;
-    } if (!this.pendingAgents.size)
-        return; const records = [...this.pendingAgents.values()]; this.pendingAgents.clear(); this.database.transaction((items) => { for (const item of items)
-        this.writeAgent(item, null); })(records); }
     syncSessions(workspaceId, cwd, sessions) {
         const db = this.database, upsert = db.prepare(`INSERT INTO sessions(session_id,session_file,workspace_id,cwd,name,parent_session_path,created_at,last_active_at,message_count,first_message,file_size,file_mtime,archived_at) VALUES(?,?,?,?,?,?,?,?,?,?,?,?,NULL) ON CONFLICT(session_id) DO UPDATE SET session_file=excluded.session_file,workspace_id=excluded.workspace_id,cwd=excluded.cwd,name=excluded.name,parent_session_path=excluded.parent_session_path,last_active_at=excluded.last_active_at,message_count=excluded.message_count,first_message=excluded.first_message,file_size=excluded.file_size,file_mtime=excluded.file_mtime,archived_at=NULL`);
         const remove = db.prepare('DELETE FROM sessions WHERE session_file=?');
-        db.transaction(() => { const paths = new Set(); for (const session of sessions) {
-            paths.add(session.path);
-            let size = 0, mtime = asTime(session.modified);
-            try {
-                const stat = statSync(session.path);
-                size = stat.size;
-                mtime = stat.mtimeMs;
+        db.transaction(() => {
+            const paths = new Set();
+            for (const session of sessions) {
+                paths.add(session.path);
+                let size = 0, mtime = asTime(session.modified);
+                try {
+                    const stat = statSync(session.path);
+                    size = stat.size;
+                    mtime = stat.mtimeMs;
+                }
+                catch { }
+                upsert.run(session.id, session.path, workspaceId, cwd, session.name ?? null, session.parentSessionPath ?? null, asTime(session.created), asTime(session.modified), session.messageCount, session.firstMessage, size, mtime);
             }
-            catch { }
-            upsert.run(session.id, session.path, workspaceId, cwd, session.name ?? null, session.parentSessionPath ?? null, asTime(session.created), asTime(session.modified), session.messageCount, session.firstMessage, size, mtime);
-        } for (const row of db.prepare('SELECT session_file FROM sessions WHERE cwd=? AND archived_at IS NULL').all(cwd))
-            if (!paths.has(row.session_file))
-                remove.run(row.session_file); })();
-    }
-    upsertSessionFromAgent(record, summary) { const sessionFile = typeof summary.sessionFile === 'string' ? summary.sessionFile : record.sessionFile; if (!sessionFile)
-        return; let size = 0, mtime = asTime(record.lastActiveAt); try {
-        const stat = statSync(sessionFile);
-        size = stat.size;
-        mtime = stat.mtimeMs;
-    }
-    catch {
-        return;
-    } const sessionId = typeof summary.sessionId === 'string' ? summary.sessionId : record.sessionId, name = typeof summary.sessionName === 'string' ? summary.sessionName : record.sessionName, messageCount = Number(summary.stats?.totalMessages) || 0; this.database.prepare(`INSERT INTO sessions(session_id,session_file,workspace_id,cwd,name,created_at,last_active_at,message_count,first_message,file_size,file_mtime,archived_at) VALUES(?,?,?,?,?,?,?,?,?,?,?,NULL) ON CONFLICT(session_id) DO UPDATE SET session_file=excluded.session_file,workspace_id=excluded.workspace_id,cwd=excluded.cwd,name=excluded.name,last_active_at=excluded.last_active_at,message_count=excluded.message_count,file_size=excluded.file_size,file_mtime=excluded.file_mtime,archived_at=NULL`).run(sessionId, sessionFile, record.workspaceId, record.cwd, name ?? null, asTime(record.createdAt), Math.max(asTime(record.lastActiveAt), mtime), messageCount, '', size, mtime); }
-    listSessions(cwd, limit, offset = 0) { const bounded = limit === undefined ? undefined : Math.min(200, Math.max(1, Math.trunc(limit))); const sql = `SELECT session_file AS path,session_id AS id,cwd,name,parent_session_path AS parentSessionPath,created_at,last_active_at,message_count AS messageCount,first_message AS firstMessage FROM sessions WHERE cwd=? AND archived_at IS NULL ORDER BY last_active_at DESC,session_id DESC${bounded === undefined ? '' : ' LIMIT ? OFFSET ?'}`; const rows = (bounded === undefined ? this.database.prepare(sql).all(cwd) : this.database.prepare(sql).all(cwd, bounded, Math.max(0, Math.trunc(offset)))); return rows.map(row => ({ ...row, created: new Date(row.created_at).toISOString(), modified: new Date(row.last_active_at).toISOString(), allMessagesText: '' })); }
-    hasSession(cwd, sessionFile) { return !!this.database.prepare('SELECT 1 FROM sessions WHERE cwd=? AND session_file=? AND archived_at IS NULL').get(cwd, sessionFile); }
-    close() { if (!this.db)
-        return; this.flush(); this.db.pragma('wal_checkpoint(TRUNCATE)'); this.db.close(); this.db = undefined; }
+            for (const row of db
+                .prepare('SELECT session_file FROM sessions WHERE cwd=? AND archived_at IS NULL')
+                .all(cwd))
+                if (!paths.has(row.session_file))
+                    remove.run(row.session_file);
+        })();
+    }
+    upsertSessionFromAgent(record, summary) {
+        const sessionFile = typeof summary.sessionFile === 'string' ? summary.sessionFile : record.sessionFile;
+        if (!sessionFile)
+            return;
+        let size = 0, mtime = asTime(record.lastActiveAt);
+        try {
+            const stat = statSync(sessionFile);
+            size = stat.size;
+            mtime = stat.mtimeMs;
+        }
+        catch {
+            return;
+        }
+        const sessionId = typeof summary.sessionId === 'string' ? summary.sessionId : record.sessionId, name = typeof summary.sessionName === 'string' ? summary.sessionName : record.sessionName, messageCount = Number(summary.stats?.totalMessages) || 0;
+        this.database
+            .prepare(`INSERT INTO sessions(session_id,session_file,workspace_id,cwd,name,created_at,last_active_at,message_count,first_message,file_size,file_mtime,archived_at) VALUES(?,?,?,?,?,?,?,?,?,?,?,NULL) ON CONFLICT(session_id) DO UPDATE SET session_file=excluded.session_file,workspace_id=excluded.workspace_id,cwd=excluded.cwd,name=excluded.name,last_active_at=excluded.last_active_at,message_count=excluded.message_count,file_size=excluded.file_size,file_mtime=excluded.file_mtime,archived_at=NULL`)
+            .run(sessionId, sessionFile, record.workspaceId, record.cwd, name ?? null, asTime(record.createdAt), Math.max(asTime(record.lastActiveAt), mtime), messageCount, '', size, mtime);
+    }
+    listSessions(cwd, limit, offset = 0) {
+        const bounded = limit === undefined ? undefined : Math.min(200, Math.max(1, Math.trunc(limit)));
+        const sql = `SELECT session_file AS path,session_id AS id,cwd,name,parent_session_path AS parentSessionPath,created_at,last_active_at,message_count AS messageCount,first_message AS firstMessage FROM sessions WHERE cwd=? AND archived_at IS NULL ORDER BY last_active_at DESC,session_id DESC${bounded === undefined ? '' : ' LIMIT ? OFFSET ?'}`;
+        const rows = (bounded === undefined
+            ? this.database.prepare(sql).all(cwd)
+            : this.database.prepare(sql).all(cwd, bounded, Math.max(0, Math.trunc(offset))));
+        return rows.map(row => ({
+            ...row,
+            created: new Date(row.created_at).toISOString(),
+            modified: new Date(row.last_active_at).toISOString(),
+            allMessagesText: ''
+        }));
+    }
+    hasSession(cwd, sessionFile) {
+        return !!this.database
+            .prepare('SELECT 1 FROM sessions WHERE cwd=? AND session_file=? AND archived_at IS NULL')
+            .get(cwd, sessionFile);
+    }
+    close() {
+        if (!this.db)
+            return;
+        this.flush();
+        this.db.pragma('wal_checkpoint(TRUNCATE)');
+        this.db.close();
+        this.db = undefined;
+    }
 }

package/dist/paths.js

@@ -0,0 +1,10 @@
+import { homedir } from 'node:os';
+import path from 'node:path';
+/**
+ * pi2web keeps its own state next to Pi's (`~/.pi/agent`): `~/.pi/pi2web` holds the metadata database,
+ * pairing-code hashes and the shareable Agent templates. `PI2WEB_DIR` or `--data-dir` override it.
+ */
+export const defaultDataDir = () => process.env.PI2WEB_DIR || path.join(homedir(), '.pi', 'pi2web');
+export const METADATA_DB_FILE = 'pi2web.db';
+/** Shareable Agent templates: one Markdown file per template, see `agent-templates.ts`. */
+export const AGENT_TEMPLATES_DIR = 'agent-templates';

package/dist/sdk-backend.js

@@ -17,11 +17,35 @@ export class SdkBackend {
         this.agentId = agentId;
         this.cwd = cwd;
     }
-    static async create(agentId, cwd, sessionFile, profile = 'default', collabBridge) {
+    static async create(agentId, cwd, sessionFile, profile = 'default', collabBridge, options = {}) {
         const sessionManager = sessionFile ? SessionManager.open(sessionFile) : SessionManager.create(cwd);
+        const { template, piDefaultPrompt } = options;
         // This factory is deliberately inline instead of auto-discovered: normal Pi and normal pi2web agents
         // never load the collaboration tools or their collaboration-specific system guidance.
-        const resourceLoader = profile === 'collab' && collabBridge ? new DefaultResourceLoader({ cwd, agentDir: getAgentDir(), extensionFactories: [{ name: 'pi2web-collab', factory: createCollabExtension(agentId, collabBridge) }] }) : undefined;
+        const extensionFactories = profile === 'collab' && collabBridge
+            ? [{ name: 'pi2web-collab', factory: createCollabExtension(agentId, collabBridge) }]
+            : [];
+        // A template behaves like Pi's own prompt files: `replace` stands in for SYSTEM.md, `append` follows
+        // APPEND_SYSTEM.md. `piDefaultPrompt` ignores both files to show what Pi itself would send.
+        const systemPromptOverride = piDefaultPrompt
+            ? () => undefined
+            : template?.mode === 'replace'
+                ? () => template.systemPrompt
+                : undefined;
+        const appendSystemPromptOverride = piDefaultPrompt
+            ? () => []
+            : template?.mode === 'append'
+                ? (base) => [...base, template.systemPrompt]
+                : undefined;
+        const resourceLoader = extensionFactories.length || systemPromptOverride || appendSystemPromptOverride
+            ? new DefaultResourceLoader({
+                cwd,
+                agentDir: getAgentDir(),
+                extensionFactories,
+                systemPromptOverride,
+                appendSystemPromptOverride
+            })
+            : undefined;
         if (resourceLoader)
             await resourceLoader.reload();
         const { session, modelFallbackMessage } = await createAgentSession({ cwd, sessionManager, resourceLoader });
@@ -35,29 +59,88 @@ export class SdkBackend {
     }
     // Slash commands, skills and prompt templates are expanded by prompt() itself (expandPromptTemplates defaults to true),
     // so `/name args` typed in the web composer behaves exactly like the Pi TUI.
-    prompt(message) { return this.session.prompt(message); }
+    prompt(message) {
+        return this.session.prompt(message);
+    }
     // Since pi 0.99 steer()/followUp() report whether the message reached the running turn (`handled`)
     // or waits for it (`queued`); the web composer shows that difference instead of guessing.
-    async steer(message) { return normalizeDisposition(await this.session.steer(message)); }
-    async followUp(message) { return normalizeDisposition(await this.session.followUp(message)); }
-    async getQueue() { return { steering: [...this.session.getSteeringMessages()], followUp: [...this.session.getFollowUpMessages()] }; }
+    async steer(message) {
+        return normalizeDisposition(await this.session.steer(message));
+    }
+    async followUp(message) {
+        return normalizeDisposition(await this.session.followUp(message));
+    }
+    async getQueue() {
+        return {
+            steering: [...this.session.getSteeringMessages()],
+            followUp: [...this.session.getFollowUpMessages()]
+        };
+    }
     /** Drop queued steering and follow-up messages and hand them back so a client can restore them to its composer. */
-    async clearQueue() { const cleared = this.session.clearQueue(); return { steering: [...cleared.steering], followUp: [...cleared.followUp] }; }
-    abort() { return this.session.abort(); }
-    async getState() { return { agentId: this.agentId, sessionId: this.session.sessionId, sessionFile: this.session.sessionFile, sessionName: this.session.sessionName, cwd: this.cwd, status: this.disposed ? 'stopped' : this.session.isStreaming ? 'streaming' : 'idle' }; }
-    async getMessages() { return [...this.session.state.messages]; }
+    async clearQueue() {
+        const cleared = this.session.clearQueue();
+        return { steering: [...cleared.steering], followUp: [...cleared.followUp] };
+    }
+    abort() {
+        return this.session.abort();
+    }
+    async getState() {
+        return {
+            agentId: this.agentId,
+            sessionId: this.session.sessionId,
+            sessionFile: this.session.sessionFile,
+            sessionName: this.session.sessionName,
+            cwd: this.cwd,
+            status: this.disposed ? 'stopped' : this.session.isStreaming ? 'streaming' : 'idle'
+        };
+    }
+    timeline() {
+        const manager = this.session.sessionManager;
+        return {
+            sessionId: this.session.sessionId,
+            leafId: manager.getLeafId(),
+            entries: () => manager.getBranch()
+        };
+    }
+    /** The effective system prompt Pi will send next, plus the prompt files that contributed to it. */
+    async getSystemPrompt() {
+        const loader = this.session.resourceLoader;
+        return {
+            systemPrompt: this.session.systemPrompt,
+            systemFile: loader.getSystemPromptSource()?.path,
+            appendFiles: loader.getAppendSystemPromptSources().map(source => source.path),
+            contextFiles: loader.getAgentsFiles().agentsFiles.map(file => file.path)
+        };
+    }
     async getCapabilities() {
         const current = this.session.model;
         // ModelRuntime.getAvailable() is async since 0.80.8 and may consult provider auth; the snapshot keeps
         // an unauthenticated or offline call from blocking the capabilities endpoint.
-        const available = await this.session.modelRuntime.getAvailable().catch(() => this.session.modelRuntime.getAvailableSnapshot());
-        return { model: current ? this.modelInfo(current) : null, models: available.map((model) => this.modelInfo(model)), thinkingLevel: this.session.thinkingLevel, thinkingLevels: this.session.getAvailableThinkingLevels(), supportsThinking: this.session.supportsThinking() };
+        const available = await this.session.modelRuntime
+            .getAvailable()
+            .catch(() => this.session.modelRuntime.getAvailableSnapshot());
+        return {
+            model: current ? this.modelInfo(current) : null,
+            models: available.map((model) => this.modelInfo(model)),
+            thinkingLevel: this.session.thinkingLevel,
+            thinkingLevels: this.session.getAvailableThinkingLevels(),
+            supportsThinking: this.session.supportsThinking()
+        };
     }
     /** Slash commands the composer can offer: file-based prompt templates and skills discovered for this cwd. */
     async listCommands() {
         const loader = this.session.resourceLoader;
-        const prompts = loader.getPrompts().prompts.map(prompt => ({ name: prompt.name, description: prompt.description, argumentHint: prompt.argumentHint, source: 'prompt' }));
-        const skills = loader.getSkills().skills.map(skill => ({ name: `skill:${skill.name}`, description: skill.description, source: 'skill' }));
+        const prompts = loader.getPrompts().prompts.map(prompt => ({
+            name: prompt.name,
+            description: prompt.description,
+            argumentHint: prompt.argumentHint,
+            source: 'prompt'
+        }));
+        const skills = loader.getSkills().skills.map(skill => ({
+            name: `skill:${skill.name}`,
+            description: skill.description,
+            source: 'skill'
+        }));
         return [...prompts, ...skills].sort((a, b) => a.name.localeCompare(b.name));
     }
     /** Run a command inside the Agent session so its output is recorded in the transcript (`!!` keeps it out of the model context). */
@@ -70,36 +153,100 @@ export class SdkBackend {
             return { id, ...result };
         }
         catch (error) {
-            this.events.emit('event', { type: 'bash_execution_end', id, command, isError: true, errorMessage: error instanceof Error ? error.message : String(error) });
+            this.events.emit('event', {
+                type: 'bash_execution_end',
+                id,
+                command,
+                isError: true,
+                errorMessage: error instanceof Error ? error.message : String(error)
+            });
             throw error;
         }
     }
-    abortBash() { this.session.abortBash(); }
-    async getSession() { return { ...await this.getSessionInfo(), leafId: this.session.sessionManager.getLeafId(), entries: this.session.sessionManager.getEntries(), tree: this.session.sessionManager.getTree(), userMessages: this.session.getUserMessagesForForking() }; }
-    async getSessionInfo() { return { sessionId: this.session.sessionId, sessionFile: this.session.sessionFile, sessionName: this.session.sessionName, stats: this.session.getSessionStats(), contextUsage: this.session.getContextUsage() }; }
-    compact(instructions) { return this.session.compact(instructions); }
-    async setModel(provider, modelId) { const model = this.session.modelRuntime.getModel(provider, modelId); if (!model)
-        throw Object.assign(new Error('Model not found'), { code: 'MODEL_NOT_FOUND' }); await this.session.setModel(model); }
-    async setThinkingLevel(level) { if (level !== 'off' && !this.session.getAvailableThinkingLevels().includes(level))
-        throw Object.assign(new Error('Invalid thinking level'), { code: 'INVALID_THINKING_LEVEL' }); this.session.setThinkingLevel(level); }
-    async setSessionName(name) { const value = name.trim(); if (!value || value.length > 200)
-        throw Object.assign(new Error('Session name must be 1-200 characters'), { code: 'INVALID_SESSION_NAME' }); this.session.setSessionName(value); }
-    navigate(entryId) { return this.session.navigateTree(entryId); }
-    async fork(entryId) { const entry = this.session.sessionManager.getEntry(entryId); if (!entry || entry.type !== 'message' || entry.message?.role !== 'user')
-        throw Object.assign(new Error('A user message entry is required'), { code: 'SESSION_ENTRY_NOT_FOUND' }); const content = entry.message.content; const selectedText = typeof content === 'string' ? content : Array.isArray(content) ? content.filter((part) => part.type === 'text').map((part) => part.text).join('\n') : ''; let sessionFile; if (entry.parentId) {
-        sessionFile = this.session.sessionManager.createBranchedSession(entry.parentId);
-    }
-    else {
-        const current = this.session.sessionFile;
-        if (!current)
-            throw Object.assign(new Error('Session persistence is disabled'), { code: 'SESSION_NOT_PERSISTED' });
-        sessionFile = SessionManager.create(this.cwd, this.session.sessionManager.getSessionDir(), { parentSession: current }).getSessionFile();
-    } return { sessionFile, selectedText }; }
+    abortBash() {
+        this.session.abortBash();
+    }
+    async getSession() {
+        return {
+            ...(await this.getSessionInfo()),
+            leafId: this.session.sessionManager.getLeafId(),
+            entries: this.session.sessionManager.getEntries(),
+            tree: this.session.sessionManager.getTree(),
+            userMessages: this.session.getUserMessagesForForking()
+        };
+    }
+    async getSessionInfo() {
+        return {
+            sessionId: this.session.sessionId,
+            sessionFile: this.session.sessionFile,
+            sessionName: this.session.sessionName,
+            stats: this.session.getSessionStats(),
+            contextUsage: this.session.getContextUsage()
+        };
+    }
+    compact(instructions) {
+        return this.session.compact(instructions);
+    }
+    async setModel(provider, modelId) {
+        const model = this.session.modelRuntime.getModel(provider, modelId);
+        if (!model)
+            throw Object.assign(new Error('Model not found'), { code: 'MODEL_NOT_FOUND' });
+        await this.session.setModel(model);
+    }
+    async setThinkingLevel(level) {
+        if (level !== 'off' && !this.session.getAvailableThinkingLevels().includes(level))
+            throw Object.assign(new Error('Invalid thinking level'), { code: 'INVALID_THINKING_LEVEL' });
+        this.session.setThinkingLevel(level);
+    }
+    async setSessionName(name) {
+        const value = name.trim();
+        if (!value || value.length > 200)
+            throw Object.assign(new Error('Session name must be 1-200 characters'), { code: 'INVALID_SESSION_NAME' });
+        this.session.setSessionName(value);
+    }
+    navigate(entryId) {
+        return this.session.navigateTree(entryId);
+    }
+    async fork(entryId) {
+        const entry = this.session.sessionManager.getEntry(entryId);
+        if (!entry || entry.type !== 'message' || entry.message?.role !== 'user')
+            throw Object.assign(new Error('A user message entry is required'), { code: 'SESSION_ENTRY_NOT_FOUND' });
+        const content = entry.message.content;
+        const selectedText = typeof content === 'string'
+            ? content
+            : Array.isArray(content)
+                ? content
+                    .filter((part) => part.type === 'text')
+                    .map((part) => part.text)
+                    .join('\n')
+                : '';
+        let sessionFile;
+        if (entry.parentId) {
+            sessionFile = this.session.sessionManager.createBranchedSession(entry.parentId);
+        }
+        else {
+            const current = this.session.sessionFile;
+            if (!current)
+                throw Object.assign(new Error('Session persistence is disabled'), { code: 'SESSION_NOT_PERSISTED' });
+            sessionFile = SessionManager.create(this.cwd, this.session.sessionManager.getSessionDir(), {
+                parentSession: current
+            }).getSessionFile();
+        }
+        return { sessionFile, selectedText };
+    }
     async extensionResponse(requestId, value) {
         if (!this.resolveUiRequest(requestId, value))
             throw Object.assign(new Error('Extension UI request not found'), { code: 'EXTENSION_REQUEST_NOT_FOUND' });
     }
-    subscribe(listener) { const fromSession = (event) => listener(event); const unsubscribe = this.session.subscribe(fromSession); this.events.on('event', listener); return () => { unsubscribe(); this.events.off('event', listener); }; }
+    subscribe(listener) {
+        const fromSession = (event) => listener(event);
+        const unsubscribe = this.session.subscribe(fromSession);
+        this.events.on('event', listener);
+        return () => {
+            unsubscribe();
+            this.events.off('event', listener);
+        };
+    }
     async dispose() {
         if (this.disposed)
             return;
@@ -109,7 +256,16 @@ export class SdkBackend {
         this.session.dispose();
         this.disposed = true;
     }
-    modelInfo(model) { return { provider: model.provider, id: model.id, name: model.name, reasoning: !!model.reasoning, contextWindow: model.contextWindow, maxTokens: model.maxTokens }; }
+    modelInfo(model) {
+        return {
+            provider: model.provider,
+            id: model.id,
+            name: model.name,
+            reasoning: !!model.reasoning,
+            contextWindow: model.contextWindow,
+            maxTokens: model.maxTokens
+        };
+    }
     resolveUiRequest(requestId, value) {
         const pending = this.pendingUi.get(requestId);
         if (!pending)
@@ -132,17 +288,37 @@ export class SdkBackend {
     }
     extensionUi() {
         return {
-            select: async (title, options, opts) => await this.request('select', { title, options, opts }),
+            select: async (title, options, opts) => (await this.request('select', { title, options, opts })),
             confirm: async (title, message, opts) => Boolean(await this.request('confirm', { title, message, opts })),
-            input: async (title, placeholder, opts) => await this.request('input', { title, placeholder, opts }),
-            editor: async (title, prefill) => await this.request('editor', { title, prefill }),
+            input: async (title, placeholder, opts) => (await this.request('input', { title, placeholder, opts })),
+            editor: async (title, prefill) => (await this.request('editor', { title, prefill })),
             notify: (message, type) => this.events.emit('event', { type: 'extension_ui_notify', message, notificationType: type ?? 'info' }),
             setStatus: (key, text) => this.events.emit('event', { type: 'extension_ui_status', key, text }),
-            setWidget: (key, content, options) => this.events.emit('event', { type: 'extension_ui_widget', key, content: Array.isArray(content) ? content : undefined, options }),
+            setWidget: (key, content, options) => this.events.emit('event', {
+                type: 'extension_ui_widget',
+                key,
+                content: Array.isArray(content) ? content : undefined,
+                options
+            }),
             setTitle: (title) => this.events.emit('event', { type: 'extension_ui_title', title }),
-            setWorkingMessage: (message) => this.events.emit('event', { type: 'extension_ui_working_message', message }), setWorkingVisible: () => { }, setWorkingIndicator: () => { }, setHiddenThinkingLabel: () => { },
-            onTerminalInput: () => () => { }, setFooter: () => { }, setHeader: () => { }, pasteToEditor: () => { }, setEditorText: () => { }, getEditorText: () => '', addAutocompleteProvider: () => { }, setEditorComponent: () => { }, custom: async () => { throw Object.assign(new Error('Custom extension components are unsupported'), { code: 'EXTENSION_CUSTOM_UI_UNSUPPORTED' }); }
+            setWorkingMessage: (message) => this.events.emit('event', { type: 'extension_ui_working_message', message }),
+            setWorkingVisible: () => { },
+            setWorkingIndicator: () => { },
+            setHiddenThinkingLabel: () => { },
+            onTerminalInput: () => () => { },
+            setFooter: () => { },
+            setHeader: () => { },
+            pasteToEditor: () => { },
+            setEditorText: () => { },
+            getEditorText: () => '',
+            addAutocompleteProvider: () => { },
+            setEditorComponent: () => { },
+            custom: async () => {
+                throw Object.assign(new Error('Custom extension components are unsupported'), {
+                    code: 'EXTENSION_CUSTOM_UI_UNSUPPORTED'
+                });
+            }
         };
     }
 }
-export const createSdkBackend = (agentId, cwd, sessionFile, profile = 'default', collabBridge) => SdkBackend.create(agentId, cwd, sessionFile, profile, collabBridge);
+export const createSdkBackend = (agentId, cwd, sessionFile, profile = 'default', collabBridge, options = {}) => SdkBackend.create(agentId, cwd, sessionFile, profile, collabBridge, options);