287 lines
10 KiB
TypeScript
287 lines
10 KiB
TypeScript
import type {
|
|
Project,
|
|
AvailableProject,
|
|
Session,
|
|
Chat,
|
|
Message,
|
|
ModelInfo,
|
|
SidebarResponse,
|
|
ListDirResult,
|
|
ViewFileResult,
|
|
AgentsResponse,
|
|
GitMeta,
|
|
Skill,
|
|
AskUserAnswer,
|
|
} from './types';
|
|
|
|
export class ApiError extends Error {
|
|
constructor(
|
|
public status: number,
|
|
public body: unknown
|
|
) {
|
|
super(typeof body === 'object' && body && 'error' in body ? String((body as { error: unknown }).error) : `HTTP ${status}`);
|
|
}
|
|
}
|
|
|
|
async function request<T>(
|
|
path: string,
|
|
init: RequestInit = {}
|
|
): Promise<T> {
|
|
const res = await fetch(path, {
|
|
...init,
|
|
headers: {
|
|
'Content-Type': 'application/json',
|
|
...(init.headers ?? {}),
|
|
},
|
|
});
|
|
if (res.status === 204) return undefined as T;
|
|
const text = await res.text();
|
|
const data = text ? JSON.parse(text) : undefined;
|
|
if (!res.ok) throw new ApiError(res.status, data);
|
|
return data as T;
|
|
}
|
|
|
|
export const api = {
|
|
health: () => request<{ status: string; db: boolean }>('/api/health'),
|
|
|
|
projects: {
|
|
list: (params?: { status?: 'open' | 'archived' }) =>
|
|
request<Project[]>(`/api/projects${params?.status ? `?status=${params.status}` : ''}`),
|
|
available: () => request<AvailableProject[]>('/api/projects/available'),
|
|
add: (body: { path: string; name?: string }) =>
|
|
request<Project>('/api/projects', {
|
|
method: 'POST',
|
|
body: JSON.stringify(body),
|
|
}),
|
|
update: (
|
|
id: string,
|
|
body: Partial<Pick<Project, 'name' | 'default_system_prompt' | 'default_web_search_enabled'>>,
|
|
) =>
|
|
request<Project>(`/api/projects/${id}`, {
|
|
method: 'PATCH',
|
|
body: JSON.stringify(body),
|
|
}),
|
|
get: (id: string) => request<Project>(`/api/projects/${id}`),
|
|
archive: (id: string) =>
|
|
request<void>(`/api/projects/${id}/archive`, { method: 'POST' }),
|
|
unarchive: (id: string) =>
|
|
request<Project>(`/api/projects/${id}/unarchive`, { method: 'POST' }),
|
|
// v1.9: bulk-archive every open session in this project. Server publishes
|
|
// one session_archived frame per affected id, so the sidebar reducer
|
|
// updates incrementally rather than waiting for a refetch.
|
|
archiveAllSessions: (id: string) =>
|
|
request<{ archived: number; ids: string[] }>(
|
|
`/api/projects/${id}/sessions/archive-all`,
|
|
{ method: 'POST' },
|
|
),
|
|
openSessionsCount: (id: string) =>
|
|
request<{ count: number }>(`/api/projects/${id}/sessions/open-count`),
|
|
create: (body: {
|
|
name: string;
|
|
commit_message?: string;
|
|
visibility?: 'private' | 'public';
|
|
create_gitea_remote?: boolean;
|
|
}) =>
|
|
request<{
|
|
project: Project;
|
|
bootstrap: {
|
|
folder_created: boolean;
|
|
git_initialized: boolean;
|
|
first_commit: boolean;
|
|
gitea_remote_created: boolean;
|
|
gitea_pushed: boolean;
|
|
warnings: string[];
|
|
};
|
|
}>(`/api/projects/create`, {
|
|
method: 'POST',
|
|
body: JSON.stringify(body),
|
|
}),
|
|
remove: (id: string) =>
|
|
request<void>(`/api/projects/${id}`, { method: 'DELETE' }),
|
|
listDir: (id: string, path: string) =>
|
|
request<ListDirResult>(`/api/projects/${id}/list_dir?path=${encodeURIComponent(path)}`),
|
|
viewFile: (id: string, path: string) =>
|
|
request<ViewFileResult>(`/api/projects/${id}/view_file?path=${encodeURIComponent(path)}`),
|
|
files: (id: string) =>
|
|
request<{ files: string[] }>(`/api/projects/${id}/files`),
|
|
git: (id: string) =>
|
|
request<GitMeta>(`/api/projects/${id}/git`),
|
|
},
|
|
|
|
sessions: {
|
|
listForProject: (projectId: string, status?: 'open' | 'archived') =>
|
|
request<Session[]>(`/api/projects/${projectId}/sessions${status ? `?status=${status}` : ''}`),
|
|
create: (
|
|
projectId: string,
|
|
body: { name?: string; model?: string; system_prompt?: string; agent_id?: string | null }
|
|
) =>
|
|
request<Session>(`/api/projects/${projectId}/sessions`, {
|
|
method: 'POST',
|
|
body: JSON.stringify(body),
|
|
}),
|
|
get: (id: string) => request<Session>(`/api/sessions/${id}`),
|
|
update: (
|
|
id: string,
|
|
body: Partial<Pick<Session, 'name' | 'model' | 'system_prompt' | 'agent_id' | 'web_search_enabled'>>
|
|
) =>
|
|
request<Session>(`/api/sessions/${id}`, {
|
|
method: 'PATCH',
|
|
body: JSON.stringify(body),
|
|
}),
|
|
remove: (id: string) =>
|
|
request<void>(`/api/sessions/${id}`, { method: 'DELETE' }),
|
|
archive: (id: string) =>
|
|
request<void>(`/api/sessions/${id}/archive`, { method: 'POST' }),
|
|
unarchive: (id: string) =>
|
|
request<Session>(`/api/sessions/${id}/unarchive`, { method: 'POST' }),
|
|
// v1.9: bulk-archive every open chat in this session. Same pattern as
|
|
// archiveAllSessions — server publishes one chat_archived per id.
|
|
archiveAllChats: (id: string) =>
|
|
request<{ archived: number; ids: string[] }>(
|
|
`/api/sessions/${id}/chats/archive-all`,
|
|
{ method: 'POST' },
|
|
),
|
|
openChatsCount: (id: string) =>
|
|
request<{ count: number }>(`/api/sessions/${id}/chats/open-count`),
|
|
},
|
|
|
|
chats: {
|
|
listForSession: (sessionId: string, params?: { status?: 'open' | 'archived' }) =>
|
|
request<Chat[]>(
|
|
`/api/sessions/${sessionId}/chats${params?.status ? `?status=${params.status}` : ''}`
|
|
),
|
|
create: (sessionId: string, body?: { name?: string }) =>
|
|
request<Chat>(`/api/sessions/${sessionId}/chats`, {
|
|
method: 'POST',
|
|
body: JSON.stringify(body ?? {}),
|
|
}),
|
|
update: (chatId: string, body: { name: string }) =>
|
|
request<Chat>(`/api/chats/${chatId}`, {
|
|
method: 'PATCH',
|
|
body: JSON.stringify(body),
|
|
}),
|
|
archive: (chatId: string) =>
|
|
request<void>(`/api/chats/${chatId}/archive`, { method: 'POST' }),
|
|
unarchive: (chatId: string) =>
|
|
request<Chat>(`/api/chats/${chatId}/unarchive`, { method: 'POST' }),
|
|
remove: (chatId: string) =>
|
|
request<void>(`/api/chats/${chatId}`, { method: 'DELETE' }),
|
|
messages: (chatId: string) =>
|
|
request<Message[]>(`/api/chats/${chatId}/messages`),
|
|
compact: (chatId: string) =>
|
|
request<{ compact_message_id: string }>(`/api/chats/${chatId}/compact`, { method: 'POST' }),
|
|
stop: (chatId: string) =>
|
|
request<{ stopped: boolean }>(`/api/chats/${chatId}/stop`, { method: 'POST' }),
|
|
forceSend: (chatId: string, content: string) =>
|
|
request<{ user_message_id: string; assistant_message_id: string }>(
|
|
`/api/chats/${chatId}/force_send`,
|
|
{ method: 'POST', body: JSON.stringify({ content }) }
|
|
),
|
|
// v1.8.2: extend an inference that hit the tool budget. `sentinelMessageId`
|
|
// is the cap-hit sentinel message the user clicked Continue on.
|
|
continue: (chatId: string, sentinelMessageId: string) =>
|
|
request<{ assistant_message_id: string }>(
|
|
`/api/chats/${chatId}/continue`,
|
|
{ method: 'POST', body: JSON.stringify({ sentinel_message_id: sentinelMessageId }) }
|
|
),
|
|
fork: (chatId: string, body: { messageId: string; name?: string }) =>
|
|
request<Chat>(`/api/chats/${chatId}/fork`, {
|
|
method: 'POST',
|
|
body: JSON.stringify({ message_id: body.messageId, name: body.name }),
|
|
}),
|
|
// Batch 9.6: slash-command invocation. Server loads the skill body
|
|
// authoritatively (client doesn't get to forge file contents), persists
|
|
// a synthetic skill_use tool_use + tool_result + user message + streaming
|
|
// assistant, and enqueues inference. Returns all 4 new message IDs.
|
|
skillInvoke: (chatId: string, skillName: string, userMessage: string | null) =>
|
|
request<{
|
|
synth_assistant_id: string;
|
|
tool_message_id: string;
|
|
user_message_id: string;
|
|
assistant_message_id: string;
|
|
}>(`/api/chats/${chatId}/skill_invoke`, {
|
|
method: 'POST',
|
|
body: JSON.stringify({ skill_name: skillName, user_message: userMessage }),
|
|
}),
|
|
// Batch 9.7: submit answers for a paused ask_user_input call. Server
|
|
// validates against the question shape, UPDATEs the pending tool row,
|
|
// publishes the deferred tool_result frame, and enqueues the next turn.
|
|
answerUserInput: (chatId: string, toolCallId: string, answers: AskUserAnswer[]) =>
|
|
request<{ tool_message_id: string; assistant_message_id: string }>(
|
|
`/api/chats/${chatId}/answer_user_input`,
|
|
{
|
|
method: 'POST',
|
|
body: JSON.stringify({ tool_call_id: toolCallId, answers }),
|
|
},
|
|
),
|
|
},
|
|
|
|
messages: {
|
|
list: (sessionId: string) =>
|
|
request<Message[]>(`/api/sessions/${sessionId}/messages`),
|
|
send: (chatId: string, content: string) =>
|
|
request<{ user_message_id: string; assistant_message_id: string }>(
|
|
`/api/chats/${chatId}/messages`,
|
|
{
|
|
method: 'POST',
|
|
body: JSON.stringify({ content }),
|
|
}
|
|
),
|
|
regenerate: (chatId: string, messageId: string) =>
|
|
request<{ assistant_message_id: string }>(
|
|
`/api/chats/${chatId}/messages/${messageId}/regenerate`,
|
|
{ method: 'POST' }
|
|
),
|
|
remove: (chatId: string, messageId: string) =>
|
|
request<void>(`/api/chats/${chatId}/messages/${messageId}`, {
|
|
method: 'DELETE',
|
|
}),
|
|
},
|
|
|
|
models: () => request<ModelInfo[]>('/api/models'),
|
|
|
|
agents: {
|
|
list: (projectId: string) =>
|
|
request<AgentsResponse>(`/api/projects/${projectId}/agents`),
|
|
},
|
|
|
|
skills: {
|
|
list: () => request<{ skills: Skill[] }>('/api/skills'),
|
|
},
|
|
|
|
settings: {
|
|
get: () => request<Record<string, unknown>>('/api/settings'),
|
|
patch: (body: Record<string, unknown>) =>
|
|
request<Record<string, unknown>>('/api/settings', {
|
|
method: 'PATCH',
|
|
body: JSON.stringify(body),
|
|
}),
|
|
},
|
|
|
|
sidebar: {
|
|
get: () => request<SidebarResponse>('/api/sidebar'),
|
|
},
|
|
|
|
// v1.10 booterm: REST control plane for terminal panes. WebSocket attach
|
|
// lives at /ws/term/sessions/:sid/panes/:pid (handled directly by
|
|
// TerminalPane). All three endpoints are tolerant of empty bodies on the
|
|
// POSTs that don't take parameters.
|
|
terminals: {
|
|
start: (sessionId: string, paneId: string) =>
|
|
request<{ tmux_window: string }>(
|
|
`/api/term/sessions/${sessionId}/panes/${paneId}/start`,
|
|
{ method: 'POST' },
|
|
),
|
|
resize: (sessionId: string, paneId: string, cols: number, rows: number) =>
|
|
request<{ ok: true }>(
|
|
`/api/term/sessions/${sessionId}/panes/${paneId}/resize`,
|
|
{ method: 'POST', body: JSON.stringify({ cols, rows }) },
|
|
),
|
|
kill: (sessionId: string, paneId: string) =>
|
|
request<{ ok: true }>(
|
|
`/api/term/sessions/${sessionId}/panes/${paneId}/kill`,
|
|
{ method: 'POST' },
|
|
),
|
|
},
|
|
};
|