@rool-dev/sdk 0.12.4 → 2.0.0-dev.4adc2c2

package/dist/agents.d.ts

@@ -0,0 +1,130 @@
+import type { MachineFilePath } from "./files.js";
+export type MachinePromptEffort = "quick" | "standard" | "reasoning" | "research";
+export type MachineAssistantFinish = "stop" | "tool_calls" | "length" | "safety" | "error" | "credits" | "cancelled";
+export type MachineConversationTurnRole = "system" | "user" | "tool" | "assistant";
+export type MachineConversationVisibility = "private" | "shared";
+export type MachineConversationContentPart = {
+    type: "text";
+    text: string;
+} | {
+    type: "attachment";
+    path: MachineFilePath;
+    mime?: string;
+} | {
+    type: "tool_call";
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+} | {
+    type: "tool_result";
+    id: string;
+    content: MachineConversationContentPart[];
+    error?: boolean;
+} | {
+    type: "json";
+    value: unknown;
+};
+export interface MachineConversationTurnBody {
+    role: MachineConversationTurnRole;
+    content: MachineConversationContentPart[];
+    request?: Record<string, unknown>;
+    finish?: MachineAssistantFinish;
+    error?: string;
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+    aside?: boolean;
+}
+export interface MachineConversationTurn {
+    id: string;
+    userId?: string;
+    createdAt: string;
+    body: MachineConversationTurnBody;
+}
+export interface MachineAgentDefinition {
+    system: string;
+}
+export type MachineAgentCreateInput = MachineAgentDefinition;
+export interface MachineConversationMetadataInput {
+    name?: string;
+    visibility: MachineConversationVisibility;
+}
+export interface MachineConversationMetadata extends MachineConversationMetadataInput {
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly isRunning: boolean;
+}
+export interface MachineConversationState extends MachineConversationMetadata {
+    turns: MachineConversationTurn[];
+}
+export interface MachineConversationSummary extends MachineConversationMetadata {
+    id: string;
+}
+export type MachineRunEvent = {
+    type: "keepalive";
+} | {
+    type: "output.delta";
+    content: MachineConversationContentPart;
+} | {
+    type: "completed";
+    finish?: MachineAssistantFinish;
+} | {
+    type: "cancelled";
+} | {
+    type: "error";
+    code: string;
+    detail: string;
+};
+export interface AgentRequestOptions {
+    signal?: AbortSignal;
+}
+export interface MachineConversationCreateOptions extends AgentRequestOptions {
+    id?: string;
+    name?: string;
+    visibility?: MachineConversationVisibility;
+}
+export interface MachineConversationPromptOptions extends AgentRequestOptions {
+    effort?: MachinePromptEffort;
+    readOnly?: boolean;
+    attachments?: readonly MachineFilePath[];
+    responseSchema?: Record<string, unknown>;
+    replaceTurnId?: string;
+}
+export interface MachineConversationFollowOptions extends AgentRequestOptions {
+    onEvent?: (event: MachineRunEvent) => void;
+}
+export type MachineConversationCancelOptions = AgentRequestOptions;
+export interface MachineConversation {
+    readonly id: string;
+    readonly agent: MachineAgent;
+    get(options?: AgentRequestOptions): Promise<MachineConversationState | undefined>;
+    listTurns(options?: AgentRequestOptions): Promise<MachineConversationTurn[]>;
+    replace(metadata: MachineConversationMetadataInput, options?: AgentRequestOptions): Promise<MachineConversationMetadata>;
+    prompt(text: string, options?: MachineConversationPromptOptions): Promise<void>;
+    follow(options?: MachineConversationFollowOptions): Promise<boolean>;
+    cancel(options?: MachineConversationCancelOptions): Promise<boolean>;
+    rename(name: string | null, options?: AgentRequestOptions): Promise<void>;
+    delete(options?: AgentRequestOptions): Promise<void>;
+}
+export interface MachineAgent {
+    readonly id: string;
+    readonly definition: MachineAgentDefinition;
+    conversation(id: string): MachineConversation;
+    createConversation(options?: MachineConversationCreateOptions): Promise<MachineConversation>;
+    listConversations(options?: AgentRequestOptions): Promise<MachineConversationSummary[]>;
+    replace(definition: MachineAgentDefinition, options?: AgentRequestOptions): Promise<MachineAgent>;
+    delete(options?: AgentRequestOptions): Promise<void>;
+}
+export interface MachineAgents {
+    list(options?: AgentRequestOptions): Promise<MachineAgent[]>;
+    get(id: string, options?: AgentRequestOptions): Promise<MachineAgent | undefined>;
+    create(id: string, definition: MachineAgentDefinition, options?: AgentRequestOptions): Promise<MachineAgent>;
+}
+interface AgentTransport {
+    request(path: string, init?: RequestInit, allowHttpErrors?: boolean): Promise<Response>;
+    requestJson<T>(path: string, init?: RequestInit): Promise<T>;
+}
+export declare function createMachineAgents(machinePath: string, transport: AgentTransport): MachineAgents;
+export {};
+//# sourceMappingURL=agents.d.ts.map

package/dist/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"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"}

package/dist/agents.js

@@ -0,0 +1,348 @@
+import { throwProblemResponse } from "./problem.js";
+const VALID_ID = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/;
+const MAX_EVENT_BYTES = 1024 * 1024;
+class MachineAgentState {
+    machinePath;
+    transport;
+    agents = new Map();
+    constructor(machinePath, transport) {
+        this.machinePath = machinePath;
+        this.transport = transport;
+    }
+    async list(options = {}) {
+        const { agents } = await this.transport.requestJson(`${this.machinePath}/agents`, { signal: options.signal });
+        return Promise.all(agents.map(async (id) => {
+            const agent = await this.get(id, options);
+            if (!agent)
+                throw new Error(`Listed agent ${id} is unavailable`);
+            return agent;
+        }));
+    }
+    async get(id, options = {}) {
+        validateId(id, "agentId");
+        const response = await this.transport.request(this.agentPath(id), { signal: options.signal }, true);
+        if (response.status === 404)
+            return undefined;
+        if (!response.ok)
+            await throwProblemResponse(response);
+        return this.agent(id, (await response.json()));
+    }
+    async create(id, definition, options = {}) {
+        validateId(id, "agentId");
+        validateDefinition(definition);
+        const written = await this.transport.requestJson(this.agentPath(id), jsonRequest("PUT", definition, options.signal));
+        return this.agent(id, written);
+    }
+    conversation(agent, id) {
+        validateId(id, "conversationId");
+        return agent.cachedConversation(id, () => new ConversationClient(agent, id, this));
+    }
+    async createConversation(agent, options = {}) {
+        const id = options.id ?? randomId();
+        const conversation = this.conversation(agent, id);
+        await conversation.replace({
+            ...(options.name ? { name: options.name } : {}),
+            visibility: options.visibility ?? "private",
+        }, options);
+        return conversation;
+    }
+    async listConversations(agent, options = {}) {
+        const collection = await this.transport.requestJson(`${this.agentPath(agent.id)}/conversations`, { signal: options.signal });
+        return Object.entries(collection.conversations).map(([id, metadata]) => ({
+            id,
+            ...metadata,
+        }));
+    }
+    async replaceAgent(agent, definition, options = {}) {
+        validateDefinition(definition);
+        const written = await this.transport.requestJson(this.agentPath(agent.id), jsonRequest("PUT", definition, options.signal));
+        agent.updateDefinition(written);
+        return agent;
+    }
+    async deleteAgent(agent, options = {}) {
+        await this.transport.request(this.agentPath(agent.id), {
+            method: "DELETE",
+            signal: options.signal,
+        });
+        this.agents.delete(agent.id);
+    }
+    async getConversation(agentId, conversationId, options) {
+        const response = await this.transport.request(this.conversationPath(agentId, conversationId), { signal: options.signal }, true);
+        if (response.status === 404)
+            return undefined;
+        if (!response.ok)
+            await throwProblemResponse(response);
+        const metadata = (await response.json());
+        const turns = await this.listTurns(agentId, conversationId, options);
+        return { ...metadata, turns };
+    }
+    async listTurns(agentId, conversationId, options = {}) {
+        const { turns } = await this.transport.requestJson(`${this.conversationPath(agentId, conversationId)}/turns`, { signal: options.signal });
+        return turns.map(turnFromWire);
+    }
+    replaceConversation(agentId, conversationId, metadata, options = {}) {
+        validateMetadata(metadata);
+        return this.transport.requestJson(this.conversationPath(agentId, conversationId), jsonRequest("PUT", metadata, options.signal));
+    }
+    async deleteConversation(agent, conversationId, options = {}) {
+        await this.transport.request(this.conversationPath(agent.id, conversationId), { method: "DELETE", signal: options.signal });
+        agent.forgetConversation(conversationId);
+    }
+    async prompt(agentId, conversationId, text, options) {
+        if (!text)
+            throw new Error("Prompt text is required");
+        const attachments = options.attachments ?? [];
+        for (const path of attachments)
+            validateAttachment(path);
+        const input = {
+            content: [
+                { type: "text", text },
+                ...attachments.map((path) => ({ type: "attachment", path })),
+            ],
+            ...(options.effort ? { effort: options.effort } : {}),
+            ...(options.readOnly !== undefined ? { readOnly: options.readOnly } : {}),
+            ...(options.responseSchema !== undefined
+                ? { responseSchema: options.responseSchema }
+                : {}),
+            ...(options.replaceTurnId
+                ? { replaceTurnId: options.replaceTurnId }
+                : {}),
+        };
+        const runPath = `${this.conversationPath(agentId, conversationId)}/run`;
+        await this.transport.request(runPath, jsonRequest("POST", input, options.signal));
+    }
+    async follow(agentId, conversationId, options = {}) {
+        const runPath = `${this.conversationPath(agentId, conversationId)}/run`;
+        const response = await this.transport.request(runPath, {
+            headers: { Accept: "application/x-ndjson" },
+            signal: options.signal,
+        }, true);
+        if (response.status === 404)
+            return false;
+        if (!response.ok)
+            await throwProblemResponse(response);
+        if (!response.body)
+            throw new Error("Current run response has no body");
+        await this.consumeRunEvents(response.body, options);
+        return true;
+    }
+    async cancel(agentId, conversationId, options = {}) {
+        const response = await this.transport.request(`${this.conversationPath(agentId, conversationId)}/run`, { method: "DELETE", signal: options.signal }, true);
+        if (response.status === 404)
+            return false;
+        if (!response.ok)
+            await throwProblemResponse(response);
+        return true;
+    }
+    async consumeRunEvents(body, options) {
+        const reader = body.getReader();
+        const decoder = new TextDecoder("utf-8", { fatal: true });
+        let buffered = "";
+        try {
+            while (true) {
+                const result = await reader.read();
+                buffered += decoder.decode(result.value, { stream: !result.done });
+                if (new TextEncoder().encode(buffered).byteLength > MAX_EVENT_BYTES) {
+                    throw new Error("Current run event is too large");
+                }
+                const lines = buffered.split("\n");
+                buffered = lines.pop() ?? "";
+                for (const line of lines) {
+                    const event = line ? parseRunEvent(line) : undefined;
+                    if (event)
+                        options.onEvent?.(event);
+                }
+                if (result.done)
+                    break;
+            }
+            if (buffered.trim()) {
+                const event = parseRunEvent(buffered);
+                if (event)
+                    options.onEvent?.(event);
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+    }
+    agent(id, definition) {
+        let agent = this.agents.get(id);
+        if (!agent) {
+            agent = new AgentClient(id, definition, this);
+            this.agents.set(id, agent);
+        }
+        else {
+            agent.updateDefinition(definition);
+        }
+        return agent;
+    }
+    agentPath(agentId) {
+        return `${this.machinePath}/agents/${encodeURIComponent(agentId)}`;
+    }
+    conversationPath(agentId, conversationId) {
+        return `${this.agentPath(agentId)}/conversations/${encodeURIComponent(conversationId)}`;
+    }
+}
+class AgentClient {
+    id;
+    state;
+    currentDefinition;
+    conversations = new Map();
+    constructor(id, definition, state) {
+        this.id = id;
+        this.state = state;
+        this.currentDefinition = definition;
+    }
+    get definition() {
+        return { ...this.currentDefinition };
+    }
+    conversation(id) {
+        return this.state.conversation(this, id);
+    }
+    createConversation(options) {
+        return this.state.createConversation(this, options);
+    }
+    listConversations(options) {
+        return this.state.listConversations(this, options);
+    }
+    replace(definition, options) {
+        return this.state.replaceAgent(this, definition, options);
+    }
+    delete(options) {
+        return this.state.deleteAgent(this, options);
+    }
+    updateDefinition(definition) {
+        this.currentDefinition = definition;
+    }
+    cachedConversation(id, create) {
+        let conversation = this.conversations.get(id);
+        if (!conversation) {
+            conversation = create();
+            this.conversations.set(id, conversation);
+        }
+        return conversation;
+    }
+    forgetConversation(id) {
+        this.conversations.delete(id);
+    }
+}
+class ConversationClient {
+    agent;
+    id;
+    state;
+    constructor(agent, id, state) {
+        this.agent = agent;
+        this.id = id;
+        this.state = state;
+    }
+    get(options = {}) {
+        return this.state.getConversation(this.agent.id, this.id, options);
+    }
+    listTurns(options = {}) {
+        return this.state.listTurns(this.agent.id, this.id, options);
+    }
+    replace(metadata, options) {
+        return this.state.replaceConversation(this.agent.id, this.id, metadata, options);
+    }
+    prompt(text, options = {}) {
+        return this.state.prompt(this.agent.id, this.id, text, options);
+    }
+    follow(options) {
+        return this.state.follow(this.agent.id, this.id, options);
+    }
+    cancel(options) {
+        return this.state.cancel(this.agent.id, this.id, options);
+    }
+    async rename(name, options = {}) {
+        const current = await this.get(options);
+        if (!current)
+            throw new Error(`Conversation ${this.id} is unavailable`);
+        await this.replace({
+            ...(name ? { name } : {}),
+            visibility: current.visibility,
+        }, options);
+    }
+    delete(options) {
+        return this.state.deleteConversation(this.agent, this.id, options);
+    }
+}
+export function createMachineAgents(machinePath, transport) {
+    return new MachineAgentState(machinePath, transport);
+}
+function turnFromWire(turn) {
+    return {
+        id: turn.id,
+        ...(turn.userId ? { userId: turn.userId } : {}),
+        createdAt: turn.createdAt,
+        body: {
+            role: turn.role,
+            content: turn.content,
+            ...(turn.request ? { request: turn.request } : {}),
+            ...(turn.finish ? { finish: turn.finish } : {}),
+            ...(turn.error ? { error: turn.error } : {}),
+            ...(turn.usage ? { usage: turn.usage } : {}),
+            ...(turn.aside !== undefined ? { aside: turn.aside } : {}),
+        },
+    };
+}
+function parseRunEvent(line) {
+    const value = JSON.parse(line);
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error("Current run event must be a JSON object");
+    }
+    const event = value;
+    if (event.type === "keepalive")
+        return { type: "keepalive" };
+    if (event.type === "output.delta" &&
+        event.content &&
+        typeof event.content === "object" &&
+        !Array.isArray(event.content)) {
+        return event;
+    }
+    if (event.type === "completed")
+        return event;
+    if (event.type === "cancelled")
+        return { type: "cancelled" };
+    if (event.type === "error" &&
+        typeof event.code === "string" &&
+        typeof event.detail === "string") {
+        return event;
+    }
+    return undefined;
+}
+function validateDefinition(definition) {
+    if (!definition || typeof definition.system !== "string") {
+        throw new Error("Agent system prompt must be a string");
+    }
+}
+function validateMetadata(metadata) {
+    if (metadata.visibility !== "private" && metadata.visibility !== "shared") {
+        throw new Error("Conversation visibility must be private or shared");
+    }
+    if (metadata.name !== undefined && typeof metadata.name !== "string") {
+        throw new Error("Conversation name must be a string");
+    }
+}
+function validateAttachment(path) {
+    const supported = path.startsWith("/space/") || path.startsWith("/rool-drive/");
+    if (!supported) {
+        throw new Error(`Prompt attachments must be under /space or /rool-drive: ${path}`);
+    }
+}
+function validateId(value, label) {
+    if (VALID_ID.test(value))
+        return;
+    throw new Error(`${label} must start with an alphanumeric character and contain at most 128 letters, digits, dots, hyphens, or underscores`);
+}
+function jsonRequest(method, body, signal) {
+    return {
+        method,
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body),
+        signal,
+    };
+}
+function randomId() {
+    return globalThis.crypto.randomUUID();
+}
+//# sourceMappingURL=agents.js.map

package/dist/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"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"}

package/dist/auth-base.d.ts

@@ -1,101 +1,56 @@
-import type { AuthProvider, AuthTokens, AuthUser } from './types.js';
-import { type Logger } from './logger.js';
-export interface BaseTokenAuthConfig {
-    /** Auth URL (e.g. https://rool.dev/auth). Injected by RoolClient if omitted. */
-    authUrl?: string;
-    /** Injected by RoolClient if omitted. */
-    logger?: Logger;
-    /** Injected by RoolClient if omitted, so auth-state reaches client events. */
-    onAuthStateChanged?: (authenticated: boolean) => void;
+import { type AuthEndpointConfig } from "./auth-url.js";
+import type { RoolAuth, RoolRequestTokens } from "./types.js";
+export interface TokenAuthConfig extends AuthEndpointConfig {
+    fetch?: typeof globalThis.fetch;
 }
-export declare abstract class BaseTokenAuthProvider implements AuthProvider {
-    protected logger: Logger;
-    private _authUrl;
-    private _onAuthStateChanged;
+export interface AuthTokenResponse {
+    id_token?: unknown;
+    refresh_token?: unknown;
+    rool_token?: unknown;
+    expires_in?: unknown;
+}
+export type EmailChangeErrorCode = "missing_token" | "invalid_token" | "missing_email" | "invalid_email" | "account_not_found" | "account_suspended" | "same_email" | "email_in_use" | "send_failed" | "internal_error";
+export declare class EmailChangeError extends Error {
+    readonly code: EmailChangeErrorCode;
+    constructor(code: EmailChangeErrorCode, message: string);
+}
+export declare abstract class TokenAuth implements RoolAuth {
+    private readonly authUrl;
+    private readonly fetchRequest;
+    private readonly listeners;
     private refreshPromise;
-    private refreshTimeoutId;
-    private boundVisibilityHandler;
-    constructor(config?: BaseTokenAuthConfig);
-    setAuthUrl(url: string): void;
-    setLogger(logger: Logger): void;
-    setAuthStateChangedHandler(handler: (authenticated: boolean) => void): void;
-    abstract initialize(): boolean;
-    abstract login(appName: string, params?: Record<string, string>): Promise<void> | void;
-    abstract signup(appName: string, params?: Record<string, string>): Promise<void> | void;
-    /**
-     * Check if user is currently authenticated.
-     *
-     * This reports identity (do we hold credentials), NOT server reachability.
-     * It deliberately does not perform a network refresh: a backend outage must
-     * not read as "logged out". A genuinely invalid/expired refresh token
-     * surfaces later as a 401 on first real use, which clears tokens and fires
-     * onAuthStateChanged(false) — the only path that ends the session.
-     */
+    constructor(config?: TokenAuthConfig);
+    abstract initialize(): Promise<boolean>;
+    abstract login(appName: string, params?: Record<string, string>): Promise<void>;
+    abstract signup(appName: string, params?: Record<string, string>): Promise<void>;
     isAuthenticated(): Promise<boolean>;
-    /**
-     * Get current access token and rool token, refreshing if expired.
-     * Returns undefined if not authenticated.
-     */
-    getTokens(): Promise<{
-        accessToken: string;
-        roolToken: string;
-    } | undefined>;
-    /**
-     * Get auth identity decoded from JWT token.
-     */
-    getAuthUser(): AuthUser;
-    /**
-     * Complete an email verification flow. Exchanges a verify JWT (from the
-     * verification email link) for a fresh token set and signs the user in.
-     */
+    readonly getTokens: () => Promise<RoolRequestTokens | undefined>;
+    readonly logout: () => Promise<void>;
+    onAuthStateChanged(listener: (authenticated: boolean) => void): () => void;
     verify(token: string): Promise<boolean>;
-    replaceTokens(tokens: AuthTokens): void;
-    /**
-     * Logout - clear all tokens and state.
-     */
-    logout(): void;
-    /**
-     * Destroy auth manager - clear refresh timers and listeners.
-     */
-    destroy(): void;
-    /** Auth URL without trailing slash */
+    setPassword(password: string): Promise<void>;
+    requestEmailChange(newEmail: string): Promise<void>;
     protected get authBaseUrl(): string;
-    protected notifyAuthState(authenticated: boolean): void;
-    /** Persist a fresh token set and (re)arm the background refresh timer. */
-    protected acceptTokens(accessToken: string, refreshToken: string | null, roolToken: string | null, expiresAt: number): void;
-    /** Arm auto-refresh + visibility re-scheduling. Call from initialize(). */
-    protected initBase(): void;
-    /**
-     * Overridable hook: clear subclass-owned transient state on logout/cancel
-     * (e.g. an in-flight OAuth `state` or PKCE verifier). No-op by default.
-     */
+    protected fetchAuth(path: string, init: RequestInit): Promise<Response>;
+    protected acceptTokenResponse(data: AuthTokenResponse, fallback?: {
+        refreshToken?: string | null;
+        roolToken?: string | null;
+    }): boolean;
+    protected emitAuthState(authenticated: boolean): void;
     protected clearTransientState(): void;
-    protected get storagePrefix(): string;
-    /** Build a storage key scoped to this auth endpoint. */
     protected keyFor(name: string): string;
-    protected get storageKeys(): {
-        readonly access: `${string}access_token`;
-        readonly refresh: `${string}refresh_token`;
-        readonly rool: `${string}rool_token`;
-        readonly expiresAt: `${string}token_expires_at`;
-    };
     protected readString(key: string): string | null;
     protected writeString(key: string, value: string): void;
     protected removeString(key: string): void;
-    protected scheduleTokenRefresh(): void;
-    protected writeTokens(accessToken: string | null, refreshToken: string | null, expiresAt: number | null): void;
-    protected writeRoolToken(token: string | null): void;
-    protected clearTokens(): void;
-    protected readAccessToken(): string | null;
-    protected readRoolToken(): string;
-    protected readExpiresAt(): number | null;
-    /**
-     * Get a short hash of the auth URL for scoping storage by endpoint.
-     */
+    private get storageKeys();
     private get endpointHash();
-    private tryRefreshToken;
-    private listenForVisibility;
-    private cancelScheduledRefresh;
-    private decodeAuthUser;
+    private readAccessToken;
+    private readRoolToken;
+    private readExpiresAt;
+    private writeTokens;
+    private writeOrRemove;
+    private clearTokens;
+    private refresh;
+    private performRefresh;
 }
 //# sourceMappingURL=auth-base.d.ts.map