213 lines
12 KiB
TypeScript
213 lines
12 KiB
TypeScript
export const CLOUD_AGENTS_PATH = '/api/cloud-agents';
|
|
|
|
export interface CloudAgentDraft {
|
|
slug: string;
|
|
name: string;
|
|
purpose: string;
|
|
system_prompt: string;
|
|
draft_revision: number;
|
|
updated_at: string;
|
|
configuration: CloudAgentConfiguration;
|
|
published_version: number | null;
|
|
enabled: boolean;
|
|
archived?: boolean;
|
|
}
|
|
|
|
export interface CloudAgentPage {
|
|
agents: CloudAgentDraft[];
|
|
next_cursor: string | null;
|
|
}
|
|
|
|
export interface CreateCloudAgent {
|
|
operation_id: string;
|
|
name: string;
|
|
purpose: string;
|
|
}
|
|
|
|
export interface SaveCloudAgentDraft {
|
|
expected_revision: number;
|
|
name: string;
|
|
purpose: string;
|
|
system_prompt: string;
|
|
configuration?: CloudAgentConfiguration;
|
|
}
|
|
|
|
export interface CloudAgentConfiguration {
|
|
model: string;
|
|
tools: string[];
|
|
knowledges: string[];
|
|
mcps: string[];
|
|
skills: string[];
|
|
preload_skills: string[];
|
|
subagents: string[];
|
|
tool_approval_mode: 'default' | 'always_trust';
|
|
max_execution_steps: number;
|
|
max_output_tokens: number;
|
|
max_run_seconds: number;
|
|
}
|
|
|
|
export const EMPTY_CLOUD_CONFIGURATION: CloudAgentConfiguration = {
|
|
model: '', tools: [], knowledges: [], mcps: [], skills: [], preload_skills: [], subagents: [],
|
|
tool_approval_mode: 'default', max_execution_steps: 40, max_output_tokens: 4096, max_run_seconds: 600,
|
|
};
|
|
|
|
export interface CloudAgentEntry {
|
|
slug: string; name: string; purpose: string; published_version: number;
|
|
is_creator?: boolean; payer?: string;
|
|
}
|
|
export interface CloudResource { key: string; name: string; description?: string }
|
|
export interface CloudCatalog {
|
|
models: { id: string; name: string }[];
|
|
resources: Partial<Record<'tools' | 'knowledges' | 'mcps' | 'skills' | 'subagents', CloudResource[]>>;
|
|
pricing: { unit: string; usage_unit: string; unit_size: number; points_per_unit: string; version: number };
|
|
}
|
|
export interface CloudApplication { id: string; name: string; enabled: boolean }
|
|
export interface CloudKey { id: string; prefix: string; revoked_at: string | null }
|
|
export interface CloudAccess {
|
|
published_version: number | null; enabled: boolean; share_url: string;
|
|
versions: { version: number; draft_revision: number; created_at: string }[];
|
|
grants: { account_id: string; enabled: boolean }[];
|
|
applications: CloudApplication[];
|
|
api_url: string;
|
|
}
|
|
export interface CloudThread {
|
|
thread_id: string; client_thread_id: string | null; agent_slug: string; title: string;
|
|
mode: 'published' | 'preview'; updated_at: string; run_id: string | null; status: string; unread: boolean;
|
|
draft_revision?: number;
|
|
archived?: boolean;
|
|
}
|
|
export interface CloudVersion { version: number; created_at: string; name: string; purpose: string; system_prompt: string; configuration: CloudAgentConfiguration }
|
|
export interface CloudRun {
|
|
agent_run_id: string; request_id: string; thread_id: string; agent_slug: string;
|
|
status: string; output: string; version: string;
|
|
error?: { type: string; message: string };
|
|
interrupt?: CloudInterrupt;
|
|
}
|
|
export interface CloudInterrupt {
|
|
status?: string; message?: string; run_id?: string;
|
|
questions?: unknown[]; approval?: Record<string, unknown>; interrupt_info?: unknown;
|
|
}
|
|
export interface CloudMessage {
|
|
id: number; role: 'user' | 'assistant' | 'system'; content: string; request_id: string;
|
|
run_id: string | null; created_at: string;
|
|
}
|
|
export interface CloudHistory {
|
|
thread_id: string; messages: CloudMessage[]; run: CloudRun | null; next_offset: number | null;
|
|
queued_requests?: CloudRequest[];
|
|
schedule_proposals?: CloudScheduleProposal[];
|
|
}
|
|
export interface CloudScheduleProposal { id: string; name: string; prompt: string; cron_expression: string; timezone: string }
|
|
export interface CloudScheduleContext { version: number | null; enabled: boolean; configuration: CloudAgentConfiguration | null; result_destination: string; payer: string }
|
|
export interface CloudRequest {
|
|
request_id: string; thread_id: string; run_id: string | null; status: string; version: string;
|
|
}
|
|
export interface CloudPrompt {
|
|
request_id: string; thread_id: string; query: string; expected_revision?: number;
|
|
attachment_file_ids?: string[];
|
|
}
|
|
export interface CloudRecent {
|
|
slug: string;
|
|
thread_id?: string;
|
|
mode: 'published' | 'preview';
|
|
draft_revision?: number;
|
|
}
|
|
export interface CloudPendingOperation {
|
|
id: string; operation: string; input: Record<string, unknown>; created_at: string;
|
|
}
|
|
export interface CloudRecoveryState {
|
|
recent: CloudRecent | null;
|
|
pending: CloudPendingOperation[];
|
|
}
|
|
export interface CloudScheduleInput {
|
|
name: string; prompt: string; cron_expression: string; timezone: string; enabled: boolean;
|
|
}
|
|
export interface CloudSchedule extends CloudScheduleInput {
|
|
id: string; agent_slug: string; next_run_at: string | null;
|
|
runs?: { status: string; thread_id: string; error_message?: string; conversation_available: boolean }[];
|
|
}
|
|
export interface CloudCost {
|
|
id: string; status: string; reserved_points: string; actual_points: string | null; created_at: string;
|
|
context: { agent_slug: string; version: string; caller_kind: string; caller_id: string; creator_id?: string; run_id: string; request_id: string; source?: CloudCostSource | null };
|
|
}
|
|
export type CloudCostSource = 'self' | 'shared' | 'api' | 'scheduled' | 'preview' | 'knowledge';
|
|
export interface CloudCostPage { unit: string; items: CloudCost[]; next_offset: number | null; summary: { count: number; settled_points: string; pending_points: string } }
|
|
export interface CloudBudget { agent_slug: string; unit: string; timezone: string; request_limit_points: string | null; daily_limit_points: string | null; daily_committed_points: string; resets_at: string }
|
|
export interface CloudAttachment { file_id: string; file_name: string; file_size: number; path: string; original_path: string; request_id?: string | null }
|
|
export interface CloudUpload { object_name: string; file_name: string; file_type: string; parse_supported: boolean; parse_methods: string[] }
|
|
export interface CloudFile { name: string; path: string; directory_path: string; is_dir: boolean; size: number }
|
|
export interface CloudKnowledge { kb_id: string; name: string; description: string; embedding_model: string }
|
|
export interface CloudKnowledgeFile { file_id: string; name: string; size: number; status: string; error: string | null; chunk_count: number }
|
|
export interface CloudMcp { slug: string; name: string; description: string; transport: 'sse' | 'streamable_http'; url: string; enabled: boolean; has_credentials: boolean }
|
|
export interface CloudMcpInput { name: string; description: string; transport: 'sse' | 'streamable_http'; url: string; headers?: Record<string, string> | null }
|
|
export interface CloudChild { slug: string; name: string; purpose: string; system_prompt: string }
|
|
export interface CloudSkillDraft { draft_id: string; items: { slug: string; name: string; description: string; success?: boolean; error?: string }[] }
|
|
export interface CloudPersonalResources { mcps: CloudMcp[]; skills: { slug: string; name: string; description: string }[]; subagents: CloudChild[] }
|
|
type Op<Input, Output> = { input: Input; output: Output };
|
|
type Agent = { slug: string };
|
|
type Application = { application_id: string };
|
|
type Schedule = Agent & { job_id: string };
|
|
type Thread = { thread_id: string };
|
|
type Run = { run_id: string };
|
|
type Operation = { operation_id: string };
|
|
export interface CloudAgentOperations {
|
|
applicationCalls: Op<Application & { offset?: number }, { items: { request_id: string; request_status: string; run_id: string | null; run_status: string | null; version: string | null; created_at: string }[]; next_offset: number | null }>;
|
|
resources: Op<Record<string, never>, CloudPersonalResources>;
|
|
createMcp: Op<CloudMcpInput & Operation, CloudMcp>;
|
|
updateMcp: Op<CloudMcpInput & { key: string }, CloudMcp>;
|
|
enableMcp: Op<{ key: string; enabled: boolean }, CloudMcp>;
|
|
deleteMcp: Op<{ key: string }, { deleted: boolean }>;
|
|
createChild: Op<Omit<CloudChild, 'slug'> & Operation, CloudChild>;
|
|
updateChild: Op<Omit<CloudChild, 'slug'> & { key: string }, CloudChild>;
|
|
confirmSkill: Op<{ draft_id: string }, { items: { slug: string; success: boolean; error?: string }[] }>;
|
|
deleteSkill: Op<{ key: string }, { deleted: boolean }>;
|
|
deleteKnowledge: Op<Agent & { kb_id: string }, { deleted: boolean }>;
|
|
deleteKnowledgeFile: Op<Agent & { kb_id: string; file_id: string }, { deleted: boolean }>;
|
|
importKnowledgeAttachment: Op<Agent & Operation & { kb_id: string; thread_id: string; attachment_id: string }, CloudKnowledgeFile>;
|
|
archiveAgent: Op<Agent & { archived: boolean }, CloudAgentDraft>;
|
|
archiveThread: Op<Thread & { archived: boolean }, { thread_id: string; archived: boolean }>;
|
|
version: Op<Agent & { version: string }, CloudVersion>;
|
|
restoreVersion: Op<Agent & { version: string; expected_revision: number }, CloudAgentDraft>;
|
|
scheduleContext: Op<Agent, CloudScheduleContext>;
|
|
knowledge: Op<Agent, { databases: CloudKnowledge[]; models: { id: string; name: string; dimension: number }[] }>;
|
|
createKnowledge: Op<Agent & Operation & { name: string; embedding_model: string }, CloudKnowledge>;
|
|
knowledgeFiles: Op<Agent & { kb_id: string; offset?: number }, { files: CloudKnowledgeFile[]; next_offset: number | null }>;
|
|
processKnowledge: Op<Agent & Operation & { kb_id: string; file_id: string }, { task_id: string }>;
|
|
catalog: Op<Record<string, never>, CloudCatalog>;
|
|
received: Op<Record<string, never>, { agents: CloudAgentEntry[] }>;
|
|
entry: Op<Agent, CloudAgentEntry>;
|
|
publish: Op<Agent & Operation & { expected_revision: number }, { version: number; draft_revision: number }>;
|
|
access: Op<Agent, CloudAccess>;
|
|
setEnabled: Op<Agent & { enabled: boolean }, { enabled: boolean }>;
|
|
users: Op<{ query: string }, { users: { account_id: string; username: string; display_name: string }[] }>;
|
|
share: Op<Agent & { account_id: string; enabled: boolean }, { account_id: string; enabled: boolean }>;
|
|
createApplication: Op<Agent & Operation & { name: string }, CloudApplication>;
|
|
setApplicationEnabled: Op<Application & { enabled: boolean }, { enabled: boolean }>;
|
|
keys: Op<Application, { keys: CloudKey[] }>;
|
|
createKey: Op<Application & Operation, { id: string; prefix: string; secret: string }>;
|
|
revokeKey: Op<Application & { key_id: string }, { revoked: boolean }>;
|
|
costs: Op<{ slug?: string; offset?: number; started_at?: string; ended_at?: string; source?: CloudCostSource; application_id?: string }, CloudCostPage>;
|
|
budget: Op<Agent, CloudBudget>;
|
|
saveBudget: Op<Agent & { request_limit_points: string | null; daily_limit_points: string | null }, CloudBudget>;
|
|
threads: Op<{ slug?: string; offset?: number; archived?: boolean }, { threads: CloudThread[]; next_offset: number | null }>;
|
|
createThread: Op<Agent & Thread & { preview: boolean; expected_revision?: number }, { thread_id: string; client_thread_id: string }>;
|
|
history: Op<Thread & { offset?: number }, CloudHistory>;
|
|
viewed: Op<Thread & Run, { viewed: boolean }>;
|
|
submit: Op<Agent & CloudPrompt, CloudRequest>;
|
|
preview: Op<Agent & CloudPrompt, CloudRequest>;
|
|
request: Op<{ request_id: string }, CloudRequest>;
|
|
cancelRequest: Op<{ request_id: string }, { status: string }>;
|
|
run: Op<Run, CloudRun>;
|
|
cancelRun: Op<Run, { status: string }>;
|
|
resume: Op<Run & Operation & { decision: Record<string, unknown> }, { run_id: string; status: string }>;
|
|
schedules: Op<Agent, { jobs: CloudSchedule[] }>;
|
|
createSchedule: Op<Agent & Operation & CloudScheduleInput, CloudSchedule>;
|
|
updateSchedule: Op<Schedule & CloudScheduleInput, CloudSchedule>;
|
|
deleteSchedule: Op<Schedule, { deleted: boolean }>;
|
|
runSchedule: Op<Schedule & Operation, { thread_id: string; status: string }>;
|
|
attachments: Op<Thread, { attachments: CloudAttachment[] }>;
|
|
parseAttachment: Op<{ object_name: string; parse_method: string }, { parsed_object_name: string }>;
|
|
confirmAttachment: Op<Thread & { attachments: { object_name: string; file_type?: string; parsed_object_name?: string }[] }, { attachments: CloudAttachment[] }>;
|
|
deleteAttachment: Op<Thread & { file_id: string }, { message: string }>;
|
|
files: Op<Thread & { path: string }, { files: CloudFile[] }>;
|
|
}
|