@astralform/js 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,526 @@
+interface AstralformConfig {
+    apiKey: string;
+    baseURL?: string;
+    userId: string;
+    fetch?: typeof globalThis.fetch;
+}
+interface MessageStartEvent {
+    type: "message_start";
+    message_id: string;
+    conversation_id: string;
+    model_display_name?: string;
+    agent_name?: string;
+    agent_display_name?: string;
+}
+interface ContentBlockDeltaEvent {
+    type: "content_block_delta";
+    index: number;
+    delta: {
+        type: "text_delta";
+        text: string;
+    };
+}
+interface ToolUseStartEvent {
+    type: "tool_use_start";
+    index: number;
+    call_id: string;
+    tool: string;
+    display_name?: string;
+    description?: string;
+    arguments: Record<string, unknown>;
+    is_client_tool: boolean;
+}
+interface ToolUseEndEvent {
+    type: "tool_use_end";
+    call_id: string;
+    tool: string;
+}
+interface AgentStartEvent {
+    type: "agent_start";
+    agent_name: string;
+    agent_display_name?: string;
+    avatar_url?: string;
+}
+interface AgentEndEvent {
+    type: "agent_end";
+    agent_name: string;
+}
+interface SubagentStartEvent {
+    type: "subagent_start";
+    agent_name: string;
+    display_name: string;
+    tool_call_id: string;
+    avatar_url?: string;
+    description?: string;
+}
+interface SubagentContentDeltaEvent {
+    type: "subagent_content_delta";
+    agent_name: string;
+    tool_call_id: string;
+    delta: {
+        type: "text_delta";
+        text: string;
+    };
+}
+interface SubagentUpdateEvent {
+    type: "subagent_update";
+    agent_name: string;
+    display_name: string;
+    tool_call_id: string;
+}
+interface SubagentEndEvent {
+    type: "subagent_end";
+    agent_name: string;
+    display_name: string;
+    tool_call_id: string;
+}
+interface ThinkingDeltaEvent {
+    type: "thinking_delta";
+    delta: {
+        type: "thinking";
+        text: string;
+    };
+}
+interface ThinkingCompleteEvent {
+    type: "thinking_complete";
+}
+interface SourcesEvent {
+    type: "sources";
+    sources: Array<{
+        title: string;
+        url: string;
+    }>;
+}
+interface CapsuleOutputEvent {
+    type: "capsule_output";
+    tool_name: string;
+    agent_name: string;
+    command?: string;
+    output: string;
+    duration_ms?: number;
+}
+interface TodoUpdateEvent {
+    type: "todo_update";
+    todos: TodoItem[];
+}
+interface MessageStopEvent {
+    type: "message_stop";
+    stop_reason: "end_turn" | "tool_use";
+    title?: string;
+}
+interface SSEErrorEvent {
+    type: "error";
+    code: string;
+    message: string;
+}
+interface SubagentToolUseEvent {
+    type: "subagent_tool_use";
+    agent_name: string;
+    tool: string;
+    tool_call_id: string;
+    result?: string;
+}
+interface AssetCreatedEvent {
+    type: "asset_created";
+    asset_id: string;
+    name: string;
+    url: string;
+    media_type: string;
+    size_bytes: number;
+}
+interface RetryEvent {
+    type: "retry";
+    attempt: number;
+    max_attempts: number;
+    delay_seconds: number;
+}
+type SSEEvent = MessageStartEvent | ContentBlockDeltaEvent | ToolUseStartEvent | ToolUseEndEvent | AgentStartEvent | AgentEndEvent | SubagentStartEvent | SubagentContentDeltaEvent | SubagentUpdateEvent | SubagentEndEvent | SubagentToolUseEvent | ThinkingDeltaEvent | ThinkingCompleteEvent | SourcesEvent | CapsuleOutputEvent | TodoUpdateEvent | MessageStopEvent | AssetCreatedEvent | RetryEvent | SSEErrorEvent;
+type ChatEvent = {
+    type: "connected";
+} | {
+    type: "chunk";
+    text: string;
+} | {
+    type: "tool_call";
+    request: ToolCallRequest;
+} | {
+    type: "tool_executing";
+    name: string;
+} | {
+    type: "tool_completed";
+    name: string;
+    result: string;
+} | {
+    type: "tool_end";
+    callId: string;
+    toolName: string;
+} | {
+    type: "agent_start";
+    agentName: string;
+    agentDisplayName?: string;
+    avatarUrl?: string;
+} | {
+    type: "agent_end";
+    agentName: string;
+} | {
+    type: "thinking_delta";
+    text: string;
+} | {
+    type: "thinking_complete";
+} | {
+    type: "subagent_start";
+    agentName: string;
+    displayName: string;
+    toolCallId: string;
+    avatarUrl?: string;
+    description?: string;
+} | {
+    type: "subagent_chunk";
+    agentName: string;
+    toolCallId: string;
+    text: string;
+} | {
+    type: "subagent_update";
+    agentName: string;
+    displayName: string;
+    toolCallId: string;
+} | {
+    type: "subagent_end";
+    agentName: string;
+    displayName: string;
+    toolCallId: string;
+} | {
+    type: "sources";
+    sources: Array<{
+        title: string;
+        url: string;
+    }>;
+} | {
+    type: "capsule_output";
+    toolName: string;
+    agentName: string;
+    command?: string;
+    output: string;
+    durationMs?: number;
+} | {
+    type: "todo_update";
+    todos: TodoItem[];
+} | {
+    type: "complete";
+    content: string;
+    conversationId: string;
+    messageId: string;
+    title?: string;
+} | {
+    type: "subagent_tool_use";
+    agentName: string;
+    toolName: string;
+    toolCallId: string;
+    result?: string;
+} | {
+    type: "asset_created";
+    assetId: string;
+    name: string;
+    url: string;
+    mediaType: string;
+    sizeBytes: number;
+} | {
+    type: "retry";
+    attempt: number;
+    maxAttempts: number;
+    delaySeconds: number;
+} | {
+    type: "model_info";
+    name: string;
+} | {
+    type: "error";
+    error: Error;
+} | {
+    type: "disconnected";
+};
+interface Conversation {
+    id: string;
+    title: string;
+    messageCount: number;
+    createdAt: string;
+    updatedAt: string;
+}
+interface Message {
+    id: string;
+    conversationId: string;
+    role: "user" | "assistant" | "system";
+    content: string;
+    parentId?: string;
+    status: "sending" | "streaming" | "complete" | "error";
+    createdAt: string;
+    toolCalls?: ToolCallRequest[];
+}
+interface ProjectStatus {
+    isReady: boolean;
+    llmConfigured: boolean;
+    llmProvider?: string;
+    llmModel?: string;
+    message: string;
+}
+interface AgentInfo {
+    name: string;
+    displayName: string;
+    description: string;
+    isOrchestrator: boolean;
+    isEnabled: boolean;
+    avatarUrl?: string;
+}
+interface SkillInfo {
+    name: string;
+    displayName: string;
+    description: string;
+    isEnabled: boolean;
+}
+interface SubagentState {
+    agentName: string;
+    displayName: string;
+    avatarUrl?: string;
+    description?: string;
+    content: string;
+    isActive: boolean;
+}
+interface ToolState {
+    toolName: string;
+    displayName?: string;
+    description?: string;
+    arguments?: Record<string, unknown>;
+    callId: string;
+    status: "calling" | "executing" | "completed";
+    isClientTool: boolean;
+}
+interface CapsuleOutput {
+    toolName: string;
+    agentName: string;
+    command?: string;
+    output: string;
+    durationMs?: number;
+}
+interface Source {
+    title: string;
+    url: string;
+}
+interface TodoItem {
+    content: string;
+    status: "pending" | "in_progress" | "completed";
+    id?: string;
+}
+interface JobCreateResponse {
+    job_id: string;
+    conversation_id: string;
+    message_id: string;
+    status: string;
+}
+interface ChatStreamRequest {
+    message?: string;
+    conversation_id?: string;
+    mcp_manifest?: ToolDefinition[];
+    enabled_mcp?: string[];
+    continue_from_message?: string;
+    resend_from?: string;
+    upload_ids?: string[];
+    agent_name?: string;
+}
+interface ToolResultRequest {
+    conversation_id: string;
+    message_id: string;
+    tool_results: ToolResult[];
+}
+interface ToolResult {
+    call_id: string;
+    tool_name: string;
+    result: string;
+    is_error: boolean;
+}
+interface ToolDefinition {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+}
+interface ToolCallRequest {
+    callId: string;
+    toolName: string;
+    displayName?: string;
+    description?: string;
+    arguments: Record<string, unknown>;
+    isClientTool: boolean;
+}
+interface StreamJobSSEOptions {
+    url: string;
+    headers: Record<string, string>;
+    signal?: AbortSignal;
+    fetchFn: typeof globalThis.fetch;
+}
+interface ChatStreamEvent {
+    event: string;
+    data: string;
+}
+interface SendOptions {
+    conversationId?: string;
+    enabledClientTools?: string[];
+    uploadIds?: string[];
+    agentName?: string;
+}
+interface ConversationAsset {
+    id: string;
+    kind: "upload" | "output";
+    originalName: string;
+    mediaType: string;
+    sizeBytes: number;
+    workspacePath?: string;
+    sourceMessageId?: string;
+    agentName?: string;
+    createdAt: string;
+}
+
+declare class AstralformClient {
+    private readonly apiKey;
+    private readonly baseURL;
+    private readonly userId;
+    private readonly fetchFn;
+    constructor(config: AstralformConfig);
+    private get headers();
+    private request;
+    private get;
+    private post;
+    private del;
+    private handleError;
+    getHealth(): Promise<{
+        status: string;
+        version: string;
+        ollama_connected: boolean;
+    }>;
+    getProjectStatus(): Promise<ProjectStatus>;
+    getConversations(limit?: number, offset?: number): Promise<Conversation[]>;
+    getMessages(conversationId: string): Promise<Message[]>;
+    deleteConversation(id: string): Promise<void>;
+    getAgents(): Promise<AgentInfo[]>;
+    getSkills(): Promise<SkillInfo[]>;
+    submitToolResult(request: ToolResultRequest): Promise<void>;
+    private mapAsset;
+    uploadFile(conversationId: string, file: Blob, filename?: string): Promise<ConversationAsset>;
+    listUploads(conversationId: string): Promise<ConversationAsset[]>;
+    listOutputs(conversationId: string): Promise<ConversationAsset[]>;
+    createJob(request: ChatStreamRequest): Promise<JobCreateResponse>;
+    streamJobEvents(jobId: string, afterSeq?: number, signal?: AbortSignal): AsyncGenerator<ChatStreamEvent>;
+    cancelJob(jobId: string): Promise<void>;
+}
+
+interface ChatStorage {
+    fetchConversations(): Promise<Conversation[]>;
+    fetchConversation(id: string): Promise<Conversation | null>;
+    createConversation(id: string, title: string): Promise<Conversation>;
+    updateConversationTitle(id: string, title: string): Promise<void>;
+    deleteConversation(id: string): Promise<void>;
+    fetchMessages(conversationId: string): Promise<Message[]>;
+    addMessage(message: Message, conversationId: string): Promise<void>;
+    updateMessageStatus(id: string, status: Message["status"]): Promise<void>;
+    deleteMessage(id: string): Promise<void>;
+}
+declare class InMemoryStorage implements ChatStorage {
+    private conversations;
+    private messages;
+    fetchConversations(): Promise<Conversation[]>;
+    fetchConversation(id: string): Promise<Conversation | null>;
+    createConversation(id: string, title: string): Promise<Conversation>;
+    updateConversationTitle(id: string, title: string): Promise<void>;
+    deleteConversation(id: string): Promise<void>;
+    fetchMessages(conversationId: string): Promise<Message[]>;
+    addMessage(message: Message, conversationId: string): Promise<void>;
+    updateMessageStatus(id: string, status: Message["status"]): Promise<void>;
+    deleteMessage(id: string): Promise<void>;
+}
+
+type ToolHandler = (args: Record<string, unknown>) => Promise<string>;
+declare class ToolRegistry {
+    private tools;
+    registerTool(name: string, description: string, inputSchema: Record<string, unknown>, handler: ToolHandler): void;
+    unregisterTool(name: string): boolean;
+    hasTool(name: string): boolean;
+    executeTool(request: ToolCallRequest): Promise<ToolResult>;
+    getManifest(): ToolDefinition[];
+    getToolNames(): string[];
+    clear(): void;
+}
+
+type ChatEventHandler = (event: ChatEvent) => void;
+declare class ChatSession {
+    readonly client: AstralformClient;
+    readonly toolRegistry: ToolRegistry;
+    readonly storage: ChatStorage;
+    conversationId: string | null;
+    conversations: Conversation[];
+    messages: Message[];
+    streamingContent: string;
+    isStreaming: boolean;
+    executingTool: string | null;
+    projectStatus: ProjectStatus | null;
+    agents: AgentInfo[];
+    skills: SkillInfo[];
+    enabledClientTools: Set<string>;
+    modelDisplayName: string | null;
+    thinkingContent: string;
+    isThinking: boolean;
+    activeSubagents: Map<string, SubagentState>;
+    sources: Source[];
+    capsuleOutputs: CapsuleOutput[];
+    todos: TodoItem[];
+    activeTools: Map<string, ToolState>;
+    private handlers;
+    private abortController;
+    constructor(config: AstralformConfig, storage?: ChatStorage);
+    on(handler: ChatEventHandler): () => void;
+    private emit;
+    connect(): Promise<void>;
+    send(content: string, options?: SendOptions): Promise<void>;
+    resendFromCheckpoint(messageId: string, newContent: string): Promise<void>;
+    private processStream;
+    /** Last received sequence number for resumable reconnection */
+    private lastSeq;
+    /** Current job ID for cancellation */
+    private currentJobId;
+    private consumeJobStream;
+    private executeClientTools;
+    private completeStream;
+    disconnect(): void;
+    createNewConversation(): Promise<string>;
+    switchConversation(id: string): Promise<void>;
+    deleteConversation(id: string): Promise<void>;
+    toggleClientTool(name: string): boolean;
+}
+
+declare class AstralformError extends Error {
+    code: string;
+    constructor(message: string, code: string);
+}
+declare class AuthenticationError extends AstralformError {
+    constructor(message?: string);
+}
+declare class RateLimitError extends AstralformError {
+    constructor(message?: string);
+}
+declare class LLMNotConfiguredError extends AstralformError {
+    constructor(message?: string);
+}
+declare class ServerError extends AstralformError {
+    constructor(message?: string);
+}
+declare class ConnectionError extends AstralformError {
+    constructor(message?: string);
+}
+declare class StreamAbortedError extends AstralformError {
+    constructor(message?: string);
+}
+
+declare function generateId(): string;
+
+/**
+ * GET-based SSE stream for job events.
+ */
+declare function streamJobSSE(options: StreamJobSSEOptions): AsyncGenerator<ChatStreamEvent>;
+
+export { type AgentEndEvent, type AgentInfo, type AgentStartEvent, AstralformClient, type AstralformConfig, AstralformError, AuthenticationError, type CapsuleOutput, type CapsuleOutputEvent, type ChatEvent, ChatSession, type ChatStorage, type ChatStreamEvent, type ChatStreamRequest, ConnectionError, type ContentBlockDeltaEvent, type Conversation, type ConversationAsset, InMemoryStorage, type JobCreateResponse, LLMNotConfiguredError, type Message, type MessageStartEvent, type MessageStopEvent, type ProjectStatus, RateLimitError, type RetryEvent, type SSEErrorEvent, type SSEEvent, type SendOptions, ServerError, type SkillInfo, type Source, type SourcesEvent, StreamAbortedError, type StreamJobSSEOptions, type SubagentContentDeltaEvent, type SubagentEndEvent, type SubagentStartEvent, type SubagentState, type SubagentToolUseEvent, type ThinkingCompleteEvent, type ThinkingDeltaEvent, type TodoItem, type TodoUpdateEvent, type ToolCallRequest, type ToolDefinition, type ToolHandler, ToolRegistry, type ToolResult, type ToolResultRequest, type ToolState, type ToolUseEndEvent, type ToolUseStartEvent, generateId, streamJobSSE };