@maudecode/talaria-web 0.0.0

package/dist/mcp/server.js

@@ -0,0 +1,221 @@
+/**
+ * `talaria-web-mcp`: the seven project/session tools of Python `mcp_server.py`,
+ * served over MCP. Every tool goes through the Web HTTP API (no in-process
+ * state reads): a password from `HERMES_WEBUI_PASSWORD` logs in once and the
+ * session cookie is reused; `--profile` pins the profile cookie. With auth on,
+ * the server only honours a profile cookie signed to the session, so the
+ * client obtains it from `/api/profile/switch` after login instead of
+ * synthesizing one.
+ */
+import { readCapped } from '../http/capped.js';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+const COLOR_RE = /^#[0-9a-fA-F]{3,8}$/;
+const AUTH_REUSE_S = 25 * 86400;
+/** Thin authenticated HTTP client mirroring `_api_auth` / `_api_post`. */
+export class WebApiClient {
+    opts;
+    cookie = null;
+    cookieExpires = 0;
+    profileCookie = null;
+    fetchImpl;
+    now;
+    constructor(opts) {
+        this.opts = opts;
+        this.fetchImpl = opts.fetch ?? fetch;
+        this.now = opts.now ?? (() => Date.now() / 1000);
+    }
+    async auth() {
+        if (!this.opts.password)
+            return null;
+        if (this.cookie && this.now() < this.cookieExpires)
+            return this.cookie;
+        try {
+            const res = await this.fetchImpl(`${this.opts.baseUrl}/api/auth/login`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ password: this.opts.password }), signal: AbortSignal.timeout(5000) });
+            const cookie = setCookies(res).find((c) => c.includes('='));
+            if (cookie) {
+                this.profileCookie = this.opts.profile ? await this.signedProfileCookie(cookie) : null;
+                this.cookie = cookie;
+                this.cookieExpires = this.now() + AUTH_REUSE_S;
+                return cookie;
+            }
+        }
+        catch {
+            this.cookie = null;
+        }
+        return null;
+    }
+    /** The session-signed profile cookie the switch route issues; null when the profile cannot be selected. */
+    async signedProfileCookie(sessionCookie) {
+        const res = await this.fetchImpl(`${this.opts.baseUrl}/api/profile/switch`, { method: 'POST', headers: { 'Content-Type': 'application/json', Cookie: sessionCookie }, body: JSON.stringify({ name: this.opts.profile }), signal: AbortSignal.timeout(5000) });
+        if (!res.ok)
+            return null;
+        const sessionName = sessionCookie.split('=')[0] ?? '';
+        return setCookies(res).find((c) => c.includes('=') && c.split('=')[0] !== sessionName) ?? null;
+    }
+    async headers(json) {
+        const headers = json ? { 'Content-Type': 'application/json' } : {};
+        const cookies = [];
+        const auth = await this.auth();
+        if (auth) {
+            cookies.push(auth);
+            if (this.opts.profile) {
+                // Never fall through to the process-default profile: an unsigned cookie is ignored once auth is on.
+                if (!this.profileCookie)
+                    throw new Error(`Profile '${this.opts.profile}' could not be selected`);
+                cookies.push(this.profileCookie);
+            }
+        }
+        else if (this.opts.profile)
+            cookies.push(`hermes_profile=${encodeURIComponent(this.opts.profile)}`);
+        if (cookies.length)
+            headers.Cookie = cookies.join('; ');
+        return headers;
+    }
+    async request(method, path, body) {
+        let res;
+        try {
+            const headers = await this.headers(body !== undefined);
+            res = await this.fetchImpl(`${this.opts.baseUrl}${path}`, { method, headers, ...(body !== undefined ? { body: JSON.stringify(body) } : {}), signal: AbortSignal.timeout(5000) });
+        }
+        catch (error) {
+            return { error: `API unreachable: ${error.message}` };
+        }
+        let payload = null;
+        try {
+            const raw = await readCapped(res, 8 * 1024 * 1024);
+            payload = raw ? JSON.parse(raw.toString('utf8')) : null;
+        }
+        catch {
+            payload = null;
+        }
+        const data = payload && typeof payload === 'object' && !Array.isArray(payload) ? payload : {};
+        if (!res.ok)
+            return { error: `API ${String(res.status)}: ${typeof data.error === 'string' ? data.error : 'unknown'}` };
+        return data;
+    }
+    get(path) { return this.request('GET', path); }
+    post(path, body) { return this.request('POST', path, body); }
+    hasAuth() { return Boolean(this.opts.password); }
+}
+function setCookies(res) {
+    return res.headers.getSetCookie().map((c) => c.split(';')[0] ?? '');
+}
+const text = (value) => ({ content: [{ type: 'text', text: JSON.stringify(value, null, 2) }] });
+const errorText = (message) => text({ error: message });
+function sessionCompact(row) {
+    return { session_id: row.session_id, title: row.title, project_id: row.project_id ?? null, workspace: row.workspace, model: row.model, message_count: row.message_count ?? 0, source_tag: row.source_tag ?? null, is_cli_session: row.is_cli_session ?? false, profile: row.profile };
+}
+/** Every session of the profile, including empty drafts (Python read the raw index; the search route is the API equivalent). */
+async function allSessions(api) {
+    const res = await api.get('/api/sessions/search?q=&content=0');
+    if (typeof res.error === 'string')
+        return { error: res.error };
+    return Array.isArray(res.sessions) ? res.sessions.filter((s) => s.session_id) : [];
+}
+export function createTalariaMcpServer(opts) {
+    const api = new WebApiClient(opts);
+    const server = new McpServer({ name: 'hermes-webui', version: '1.0.0' });
+    server.registerTool('list_projects', { description: 'List all session projects with their IDs, names, colors, and session counts (scoped to active profile).', inputSchema: {} }, async () => {
+        const projects = await api.get('/api/projects');
+        if (typeof projects.error === 'string')
+            return errorText(projects.error);
+        const sessions = await allSessions(api);
+        const counts = new Map();
+        if (Array.isArray(sessions))
+            for (const s of sessions) {
+                const pid = typeof s.project_id === 'string' ? s.project_id : '';
+                if (pid)
+                    counts.set(pid, (counts.get(pid) ?? 0) + 1);
+            }
+        return text((Array.isArray(projects.projects) ? projects.projects : []).map((p) => ({ ...p, session_count: counts.get(String(p.project_id)) ?? 0 })));
+    });
+    server.registerTool('create_project', { description: 'Create a new project for organizing sessions (profile-scoped).', inputSchema: { name: z.string().describe('Project name (max 128 chars)'), color: z.string().optional().describe('Optional hex color (#RGB, #RRGGBB, or #RRGGBBAA)') } }, async ({ name, color }) => {
+        const trimmed = name.trim().slice(0, 128);
+        if (!trimmed)
+            return errorText('name is required');
+        if (color !== undefined && !COLOR_RE.test(color))
+            return errorText('Invalid color format (use #RGB, #RRGGBB, or #RRGGBBAA)');
+        const existing = await api.get('/api/projects');
+        if (typeof existing.error === 'string')
+            return errorText(existing.error);
+        if ((Array.isArray(existing.projects) ? existing.projects : []).some((p) => p.name === trimmed))
+            return errorText(`Project '${trimmed}' already exists`);
+        const created = await api.post('/api/projects/create', { name: trimmed, color: color ?? null });
+        if (typeof created.error === 'string')
+            return errorText(created.error);
+        return text({ ...created.project, session_count: 0 });
+    });
+    server.registerTool('rename_project', { description: 'Rename a project and optionally change its color (profile-checked).', inputSchema: { project_id: z.string().describe('12-char project ID'), name: z.string().describe('New name (max 128 chars)'), color: z.string().optional().describe('Optional new hex color') } }, async ({ project_id, name, color }) => {
+        const trimmed = name.trim().slice(0, 128);
+        if (!project_id || !trimmed)
+            return errorText('project_id and name are required');
+        if (color !== undefined && !COLOR_RE.test(color))
+            return errorText('Invalid color format (use #RGB, #RRGGBB, or #RRGGBBAA)');
+        const renamed = await api.post('/api/projects/rename', { project_id, name: trimmed, ...(color !== undefined ? { color } : {}) });
+        if (typeof renamed.error === 'string')
+            return errorText(renamed.error.replace(/^API 404: /, ''));
+        return text(renamed.project);
+    });
+    server.registerTool('delete_project', { description: 'Delete a project and unassign all its sessions (profile-checked).', inputSchema: { project_id: z.string().describe('12-char project ID to delete') } }, async ({ project_id }) => {
+        if (!project_id)
+            return errorText('project_id is required');
+        const projects = await api.get('/api/projects');
+        if (typeof projects.error === 'string')
+            return errorText(projects.error);
+        const proj = (Array.isArray(projects.projects) ? projects.projects : []).find((p) => p.project_id === project_id);
+        if (!proj)
+            return errorText('Project not found');
+        // The delete route unassigns every session of the project itself (cache-safe, whether or not auth is on), so the
+        // count is what the server listed under the project right before the delete — the Python MCP only ever had to
+        // move sessions by hand because it edited the projects file directly.
+        const sessions = await allSessions(api);
+        const unassigned = Array.isArray(sessions) ? sessions.filter((row) => row.project_id === project_id).length : null;
+        const deleted = await api.post('/api/projects/delete', { project_id });
+        if (typeof deleted.error === 'string')
+            return errorText(deleted.error.replace(/^API 404: /, ''));
+        const result = { ok: true, deleted: proj.name, unassigned_sessions: unassigned ?? 0 };
+        if (unassigned === null)
+            result.warning = 'The session list could not be read before the delete; the project was deleted and its sessions unassigned, but the count is unknown.';
+        return text(result);
+    });
+    server.registerTool('rename_session', { description: 'Rename a session (updates sidebar via authenticated API, cache-safe).', inputSchema: { session_id: z.string().describe('Session ID'), title: z.string().describe('New title (max 80 chars)') } }, async ({ session_id, title }) => {
+        const trimmed = title.trim().slice(0, 80);
+        if (!session_id || !trimmed)
+            return errorText('session_id and title are required');
+        const result = await api.post('/api/session/rename', { session_id, title: trimmed });
+        if (typeof result.error === 'string')
+            return text(result);
+        const session = (result.session ?? {});
+        return text({ ok: true, session_id, title: session.title ?? trimmed, method: 'api' });
+    });
+    server.registerTool('move_session', { description: 'Assign a session to a project. Pass project_id=null to unassign. Uses authenticated API for cache safety (profile-checked).', inputSchema: { session_id: z.string().describe('Session ID'), project_id: z.string().nullable().describe('Project ID (or null to unassign)') } }, async ({ session_id, project_id }) => {
+        if (!session_id)
+            return errorText('session_id is required');
+        if (project_id !== null) {
+            const projects = await api.get('/api/projects');
+            if (typeof projects.error === 'string')
+                return errorText(projects.error);
+            if (!(Array.isArray(projects.projects) ? projects.projects : []).some((p) => p.project_id === project_id))
+                return errorText('Project not found');
+        }
+        const result = await api.post('/api/session/move', { session_id, project_id });
+        if (typeof result.error === 'string')
+            return text(result);
+        const session = (result.session ?? {});
+        return text({ ok: true, session_id, project_id, title: session.title ?? null, method: 'api' });
+    });
+    server.registerTool('list_sessions', { description: 'List sessions, optionally filtered by project or unassigned status (profile-scoped).', inputSchema: { project_id: z.string().optional().describe('Filter sessions by project ID'), unassigned: z.boolean().optional().describe('Show only sessions with no project'), limit: z.number().int().optional().describe('Max results (default: 50, max: 500)') } }, async ({ project_id, unassigned, limit }) => {
+        const sessions = await allSessions(api);
+        if (!Array.isArray(sessions))
+            return errorText(sessions.error);
+        let rows = sessions.map(sessionCompact);
+        if (unassigned)
+            rows = rows.filter((r) => !r.project_id);
+        else if (project_id)
+            rows = rows.filter((r) => r.project_id === project_id);
+        return text(rows.slice(0, Math.max(1, Math.min(500, limit ?? 50))));
+    });
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACnE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAWvB,MAAM,QAAQ,GAAG,qBAAqB,CAAA;AACtC,MAAM,YAAY,GAAG,EAAE,GAAG,KAAK,CAAA;AAE/B,0EAA0E;AAC1E,MAAM,OAAO,YAAY;IAOM;IANrB,MAAM,GAAkB,IAAI,CAAA;IAC5B,aAAa,GAAG,CAAC,CAAA;IACjB,aAAa,GAAkB,IAAI,CAAA;IAC1B,SAAS,CAAc;IACvB,GAAG,CAAc;IAElC,YAA6B,IAAsB;QAAtB,SAAI,GAAJ,IAAI,CAAkB;QACjD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,IAAI,KAAK,CAAA;QACpC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAA;IAClD,CAAC;IAEO,KAAK,CAAC,IAAI;QAChB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAA;QACpC,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,aAAa;YAAE,OAAO,IAAI,CAAC,MAAM,CAAA;QACtE,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,iBAAiB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YACvO,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAA;YAC3D,IAAI,MAAM,EAAE,CAAC;gBACX,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;gBACtF,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;gBACpB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,YAAY,CAAA;gBAC9C,OAAO,MAAM,CAAA;YACf,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;QAAC,CAAC;QAC9B,OAAO,IAAI,CAAA;IACb,CAAC;IAED,2GAA2G;IACnG,KAAK,CAAC,mBAAmB,CAAC,aAAqB;QACrD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,qBAAqB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAC7P,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,IAAI,CAAA;QACxB,MAAM,WAAW,GAAG,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;QACrD,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,IAAI,IAAI,CAAA;IAChG,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,IAAa;QACjC,MAAM,OAAO,GAA2B,IAAI,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QAC1F,MAAM,OAAO,GAAa,EAAE,CAAA;QAC5B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAA;QAC9B,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAClB,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACtB,oGAAoG;gBACpG,IAAI,CAAC,IAAI,CAAC,aAAa;oBAAE,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,CAAC,IAAI,CAAC,OAAO,yBAAyB,CAAC,CAAA;gBAChG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;YAClC,CAAC;QACH,CAAC;aAAM,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,CAAC,IAAI,CAAC,kBAAkB,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;QACrG,IAAI,OAAO,CAAC,MAAM;YAAE,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACvD,OAAO,OAAO,CAAA;IAChB,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,MAAsB,EAAE,IAAY,EAAE,IAAc;QACxE,IAAI,GAAa,CAAA;QACjB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAA;YACtD,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAClL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,KAAK,EAAE,oBAAqB,KAAe,CAAC,OAAO,EAAE,EAAE,CAAA;QAClE,CAAC;QACD,IAAI,OAAO,GAAY,IAAI,CAAA;QAC3B,IAAI,CAAC;YAAC,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC;YAAC,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,GAAG,IAAI,CAAA;QAAC,CAAC;QAC5I,MAAM,IAAI,GAAG,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAE,OAAgB,CAAC,CAAC,CAAC,EAAE,CAAA;QACvG,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,EAAE,KAAK,EAAE,OAAO,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,EAAE,EAAE,CAAA;QACtH,OAAO,IAAI,CAAA;IACb,CAAC;IAED,GAAG,CAAC,IAAY,IAAmB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA,CAAC,CAAC;IACrE,IAAI,CAAC,IAAY,EAAE,IAAa,IAAmB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA,CAAC,CAAC;IAC5F,OAAO,KAAc,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA,CAAC,CAAC;CAC1D;AAED,SAAS,UAAU,CAAC,GAAa;IAC/B,OAAO,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;AACrE,CAAC;AAED,MAAM,IAAI,GAAG,CAAC,KAAc,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;AACjH,MAAM,SAAS,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAA;AAE/D,SAAS,cAAc,CAAC,GAAS;IAC/B,OAAO,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,IAAI,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,CAAC,aAAa,IAAI,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,IAAI,EAAE,cAAc,EAAE,GAAG,CAAC,cAAc,IAAI,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAA;AACvR,CAAC;AAED,gIAAgI;AAChI,KAAK,UAAU,WAAW,CAAC,GAAiB;IAC1C,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAA;IAC9D,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAA;IAC9D,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,QAAmB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AAChG,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAAsB;IAC3D,MAAM,GAAG,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,CAAA;IAClC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAA;IAExE,MAAM,CAAC,YAAY,CAAC,eAAe,EAAE,EAAE,WAAW,EAAE,yGAAyG,EAAE,WAAW,EAAE,EAAE,EAAE,EAAE,KAAK,IAAI,EAAE;QAC3L,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,CAAA;QAC/C,IAAI,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;QACxE,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAA;QACvC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAA;QACxC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;YAAE,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;gBAAC,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;gBAAC,IAAI,GAAG;oBAAE,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;YAAC,CAAC;QACjL,OAAO,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAE,QAAQ,CAAC,QAAmB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IACnK,CAAC,CAAC,CAAA;IAEF,MAAM,CAAC,YAAY,CAAC,gBAAgB,EAAE,EAAE,WAAW,EAAE,gEAAgE,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;QACxT,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;QACzC,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC,kBAAkB,CAAC,CAAA;QAClD,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC,wDAAwD,CAAC,CAAA;QAC5H,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,CAAA;QAC/C,IAAI,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;QACxE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAE,QAAQ,CAAC,QAAmB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC;YAAE,OAAO,SAAS,CAAC,YAAY,OAAO,kBAAkB,CAAC,CAAA;QACpK,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,IAAI,IAAI,EAAE,CAAC,CAAA;QAC/F,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QACtE,OAAO,IAAI,CAAC,EAAE,GAAI,OAAO,CAAC,OAAgB,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC,CAAA;IACjE,CAAC,CAAC,CAAA;IAEF,MAAM,CAAC,YAAY,CAAC,gBAAgB,EAAE,EAAE,WAAW,EAAE,qEAAqE,EAAE,WAAW,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;QAClW,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;QACzC,IAAI,CAAC,UAAU,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC,kCAAkC,CAAC,CAAA;QACjF,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC,wDAAwD,CAAC,CAAA;QAC5H,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;QAChI,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,CAAA;QAChG,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IAC9B,CAAC,CAAC,CAAA;IAEF,MAAM,CAAC,YAAY,CAAC,gBAAgB,EAAE,EAAE,WAAW,EAAE,mEAAmE,EAAE,WAAW,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;QACrO,IAAI,CAAC,UAAU;YAAE,OAAO,SAAS,CAAC,wBAAwB,CAAC,CAAA;QAC3D,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,CAAA;QAC/C,IAAI,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;QACxE,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAE,QAAQ,CAAC,QAAmB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,UAAU,CAAC,CAAA;QAC7H,IAAI,CAAC,IAAI;YAAE,OAAO,SAAS,CAAC,mBAAmB,CAAC,CAAA;QAChD,iHAAiH;QACjH,8GAA8G;QAC9G,sEAAsE;QACtE,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAA;QACvC,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAA;QAClH,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,UAAU,EAAE,CAAC,CAAA;QACtE,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,CAAA;QAChG,MAAM,MAAM,GAAS,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,mBAAmB,EAAE,UAAU,IAAI,CAAC,EAAE,CAAA;QAC3F,IAAI,UAAU,KAAK,IAAI;YAAE,MAAM,CAAC,OAAO,GAAG,sIAAsI,CAAA;QAChL,OAAO,IAAI,CAAC,MAAM,CAAC,CAAA;IACrB,CAAC,CAAC,CAAA;IAEF,MAAM,CAAC,YAAY,CAAC,gBAAgB,EAAE,EAAE,WAAW,EAAE,uEAAuE,EAAE,WAAW,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE;QACtR,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;QACzC,IAAI,CAAC,UAAU,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC,mCAAmC,CAAC,CAAA;QAClF,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAA;QACpF,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC,MAAM,CAAC,CAAA;QACzD,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAS,CAAA;QAC9C,OAAO,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAA;IACvF,CAAC,CAAC,CAAA;IAEF,MAAM,CAAC,YAAY,CAAC,cAAc,EAAE,EAAE,WAAW,EAAE,6HAA6H,EAAE,WAAW,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,UAAU,EAAE,EAAE,EAAE;QACvW,IAAI,CAAC,UAAU;YAAE,OAAO,SAAS,CAAC,wBAAwB,CAAC,CAAA;QAC3D,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YACxB,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,CAAA;YAC/C,IAAI,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;YACxE,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAE,QAAQ,CAAC,QAAmB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,UAAU,CAAC;gBAAE,OAAO,SAAS,CAAC,mBAAmB,CAAC,CAAA;QAC9J,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,CAAA;QAC9E,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC,MAAM,CAAC,CAAA;QACzD,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAS,CAAA;QAC9C,OAAO,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAA;IAChG,CAAC,CAAC,CAAA;IAEF,MAAM,CAAC,YAAY,CAAC,eAAe,EAAE,EAAE,WAAW,EAAE,sFAAsF,EAAE,WAAW,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE;QAC7b,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAA;QACvC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;YAAE,OAAO,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;QAC9D,IAAI,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;QACvC,IAAI,UAAU;YAAE,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAA;aACnD,IAAI,UAAU;YAAE,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,UAAU,CAAC,CAAA;QAC3E,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;IACrE,CAAC,CAAC,CAAA;IAEF,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/onboarding.d.ts

@@ -0,0 +1,57 @@
+import type { SidecarLike } from './sidecar/client.js';
+import type { AgentConfig, Config, Dict } from './config/agent-config.js';
+import type { ModelsCatalog } from './providers/catalog.js';
+import type { SettingsStore } from './settings.js';
+export declare class OnboardingError extends Error {
+    readonly status: number;
+    constructor(message: string, status?: number);
+}
+export interface OnboardingDeps {
+    settings: SettingsStore;
+    config: AgentConfig;
+    env: Record<string, string | undefined>;
+    profileHome: () => string;
+    isRootProfileHome: (home: string) => boolean;
+    sidecar: () => SidecarLike | null;
+    /** Whether the Agent runtime imports (sidecar handshake compatible). */
+    agentStatus: () => {
+        found: boolean;
+        importsOk: boolean;
+        missing: string[];
+        errors: Record<string, string>;
+    };
+    isAuthEnabled: () => Promise<boolean>;
+    workspaces: () => {
+        items: {
+            path: string;
+            name: string;
+        }[];
+        last: string | null;
+    };
+    models: (profileHome: string) => Promise<ModelsCatalog>;
+    defaultWorkspace: () => string;
+    defaultModel: () => string;
+    fetch?: typeof fetch;
+    log: (line: string) => void;
+}
+/** Python `_provider_api_key_present`. */
+export declare function providerApiKeyPresent(provider: string, cfg: Config, envValues: Record<string, string>): boolean;
+/** Python `_provider_oauth_authenticated`: reads the profile's auth.json directly. */
+export declare function providerOauthAuthenticated(providerRaw: string, home: string): boolean;
+export declare class Onboarding {
+    private readonly deps;
+    constructor(deps: OnboardingDeps);
+    private skipRequested;
+    private runtimeStatus;
+    private setupCatalog;
+    status(): Promise<Dict>;
+    complete(): Promise<Dict>;
+    /** Python `apply_onboarding_setup`. */
+    setup(body: Dict): Promise<Dict>;
+    /** A root-profile key written by setup reaches the running process and sidecar like a settings-panel edit does. */
+    private writeCredential;
+    /** Python `apply_self_hosted_provider_setup`. */
+    selfHosted(body: Dict): Promise<Dict>;
+    /** Python `probe_provider_endpoint`: one GET of `<base_url>/models`, no redirects, 5 s, 256 KB. */
+    probe(baseUrlRaw: string, apiKey: string | null): Promise<Dict>;
+}