@rool-dev/sdk 0.12.5 → 2.0.0-dev.0745af4

package/assets/rool-logo.svg

@@ -0,0 +1,5 @@
+<svg width="424" height="424" viewBox="0 0 424 424" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M261.985 0C326.485 0 358.735 -0.000114441 382.009 15.2881C392.64 22.2717 401.728 31.3597 408.712 41.9912C424 65.2653 424 97.5154 424 162.015V261.985C424 326.485 424 358.735 408.712 382.009C401.728 392.64 392.64 401.728 382.009 408.712C358.735 424 326.485 424 261.985 424H162.015C97.5154 424 65.2653 424 41.9912 408.712C31.3597 401.728 22.2717 392.64 15.2881 382.009C-0.000114441 358.735 0 326.485 0 261.985V162.015C0 97.5154 -0.000128746 65.2653 15.2881 41.9912C22.2717 31.3597 31.3597 22.2717 41.9912 15.2881C65.2653 -0.000128746 97.5154 0 162.015 0H261.985Z" fill="black"/>
+<path d="M161.583 119.289C190.445 119.289 213.843 142.686 213.843 171.549V264.457C213.843 293.319 190.445 316.717 161.583 316.717C132.72 316.717 109.322 293.32 109.322 264.457V171.549C109.322 142.686 132.72 119.289 161.583 119.289Z" fill="white"/>
+<path d="M280.739 119.289C309.602 119.289 332.999 142.686 332.999 171.549C332.999 200.411 309.602 223.809 280.739 223.81C251.877 223.81 228.479 200.411 228.479 171.549C228.479 142.686 251.877 119.289 280.739 119.289Z" fill="white"/>
+</svg>

package/assets/rool-wordmark-dark.svg

@@ -0,0 +1,7 @@
+<svg width="2706" height="1190" viewBox="780 535 2706 1190" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M3338.88 572.35V562.079H3387.27V572.35H3369.23V621H3356.92V572.35H3338.88ZM3396.86 562.079H3412.22L3428.45 601.667H3429.14L3445.36 562.079H3460.73V621H3448.64V582.65H3448.15L3432.91 620.712H3424.68L3409.43 582.506H3408.94V621H3396.86V562.079Z" fill="white"/>
+<rect x="3138.39" y="560" width="151" height="1120" fill="white"/>
+<path d="M1604.89 876C1831.06 876 2014.39 1060.46 2014.39 1288C2014.39 1515.54 1831.06 1700 1604.89 1700C1378.73 1700 1195.39 1515.54 1195.39 1288C1195.39 1060.46 1378.73 876 1604.89 876ZM1605.39 1019C1460.7 1019 1343.39 1139.44 1343.39 1288C1343.39 1436.56 1460.7 1557 1605.39 1557C1750.09 1557 1867.39 1436.56 1867.39 1288C1867.39 1139.44 1750.09 1019 1605.39 1019Z" fill="white"/>
+<path d="M2555.89 876C2782.06 876 2965.39 1060.46 2965.39 1288C2965.39 1515.54 2782.06 1700 2555.89 1700C2329.73 1700 2146.39 1515.54 2146.39 1288C2146.39 1060.46 2329.73 876 2555.89 876ZM2556.39 1019C2411.14 1019 2293.39 1139.44 2293.39 1288C2293.39 1436.56 2411.14 1557 2556.39 1557C2701.65 1557 2819.39 1436.56 2819.39 1288C2819.39 1139.44 2701.65 1019 2556.39 1019Z" fill="white"/>
+<path d="M1068 1029.28C1002.53 1049.7 955 1110.8 955 1183V1193L955.006 1193V1680H804.006V1184.45C804.004 1183.97 804 1183.48 804 1183C804 1027.01 918.476 897.76 1068 874.672V1029.28Z" fill="white"/>
+</svg>

package/assets/rool-wordmark.svg

@@ -0,0 +1,7 @@
+<svg width="2706" height="1190" viewBox="780 535 2706 1190" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M3338.88 572.35V562.079H3387.27V572.35H3369.23V621H3356.92V572.35H3338.88ZM3396.86 562.079H3412.22L3428.45 601.667H3429.14L3445.36 562.079H3460.73V621H3448.64V582.65H3448.15L3432.91 620.712H3424.68L3409.43 582.506H3408.94V621H3396.86V562.079Z" fill="black"/>
+<rect x="3138.39" y="560" width="151" height="1120" fill="black"/>
+<path d="M1604.89 876C1831.06 876 2014.39 1060.46 2014.39 1288C2014.39 1515.54 1831.06 1700 1604.89 1700C1378.73 1700 1195.39 1515.54 1195.39 1288C1195.39 1060.46 1378.73 876 1604.89 876ZM1605.39 1019C1460.7 1019 1343.39 1139.44 1343.39 1288C1343.39 1436.56 1460.7 1557 1605.39 1557C1750.09 1557 1867.39 1436.56 1867.39 1288C1867.39 1139.44 1750.09 1019 1605.39 1019Z" fill="black"/>
+<path d="M2555.89 876C2782.06 876 2965.39 1060.46 2965.39 1288C2965.39 1515.54 2782.06 1700 2555.89 1700C2329.73 1700 2146.39 1515.54 2146.39 1288C2146.39 1060.46 2329.73 876 2555.89 876ZM2556.39 1019C2411.14 1019 2293.39 1139.44 2293.39 1288C2293.39 1436.56 2411.14 1557 2556.39 1557C2701.65 1557 2819.39 1436.56 2819.39 1288C2819.39 1139.44 2701.65 1019 2556.39 1019Z" fill="black"/>
+<path d="M1068 1029.28C1002.53 1049.7 955 1110.8 955 1183V1193L955.006 1193V1680H804.006V1184.45C804.004 1183.97 804 1183.48 804 1183C804 1027.01 918.476 897.76 1068 874.672V1029.28Z" fill="black"/>
+</svg>

package/dist/agents.d.ts

@@ -0,0 +1,143 @@
+import type { RoolClientEvent } from "./events.js";
+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 MachineConversationTurn {
+    id: string;
+    userId?: string;
+    createdAt: string;
+    role: MachineConversationTurnRole;
+    content: MachineConversationContentPart[];
+    request?: Record<string, unknown>;
+    finish?: MachineAssistantFinish;
+    error?: string;
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+    aside?: boolean;
+}
+export interface MachineAgentDefinition {
+    /** Instructions added after Rool's built-in machine context. */
+    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 MachineConversationView {
+    readonly turns: readonly MachineConversationTurn[];
+    readonly output: readonly MachineConversationContentPart[];
+    readonly isRunning: boolean;
+    readonly loading: boolean;
+    readonly error: unknown;
+}
+export type MachineConversationListener = (view: MachineConversationView) => void;
+export interface MachineConversation {
+    readonly id: string;
+    readonly agent: MachineAgent;
+    get(options?: AgentRequestOptions): Promise<MachineConversationState | undefined>;
+    listTurns(options?: AgentRequestOptions): Promise<MachineConversationTurn[]>;
+    watch(listener: MachineConversationListener): () => void;
+    replace(metadata: MachineConversationMetadataInput, options?: AgentRequestOptions): Promise<MachineConversationMetadata>;
+    /** Return conversation-specific instructions; an empty string means none. */
+    getInstructions(options?: AgentRequestOptions): Promise<string>;
+    /** Replace conversation-specific instructions; pass an empty string to clear. */
+    replaceInstructions(instructions: string, options?: AgentRequestOptions): Promise<string>;
+    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>;
+    subscribeEvents(listener: (event: RoolClientEvent) => void): () => void;
+}
+export declare function createMachineAgents(machineId: string, 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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"}