@flowscale/sdk 1.0.0 → 1.2.0

package/README.md

@@ -0,0 +1,430 @@
+# @flowscale/sdk — External App Guide
+
+This guide covers building apps that run **outside** FlowScale using the HTTP transport. You can use any language or framework — Node.js scripts, Express servers, Next.js apps, Python backends calling a Node wrapper, anything that can make HTTP requests.
+
+> **Prerequisite:** A running FlowScale AIOS instance. Default local address: `http://localhost:14173`.
+
+---
+
+## Installation
+
+```bash
+npm install @flowscale/sdk
+# or
+pnpm add @flowscale/sdk
+```
+
+Requires Node.js 18+ (uses the native `fetch` API).
+
+---
+
+## Authentication
+
+Every request requires a session. Call `login()` once to get a token, then pass it to `createClient()`. Tokens are valid for **7 days**.
+
+```ts
+import { login, createClient } from '@flowscale/sdk'
+
+const token = await login({
+  baseUrl: 'http://localhost:14173',
+  username: 'admin',
+  password: 'your-password',
+})
+
+const client = createClient({
+  baseUrl: 'http://localhost:14173',
+  sessionToken: token,
+})
+```
+
+> `login()` reads the session token from the `Set-Cookie` response header. This works in **Node.js** (`fetch` exposes `Set-Cookie`). In a browser context, the browser handles the cookie automatically and you do not need to call `login()` — just make requests with `credentials: 'include'` against `http://localhost:14173` directly.
+
+### Persisting the token
+
+```ts
+import { writeFileSync, readFileSync, existsSync } from 'fs'
+
+const TOKEN_FILE = '.flowscale-token'
+
+async function getToken(): Promise<string> {
+  if (existsSync(TOKEN_FILE)) {
+    return readFileSync(TOKEN_FILE, 'utf-8').trim()
+  }
+  const token = await login({
+    baseUrl: 'http://localhost:14173',
+    username: 'admin',
+    password: process.env.FS_PASSWORD!,
+  })
+  writeFileSync(TOKEN_FILE, token)
+  return token
+}
+```
+
+---
+
+## Creating a client
+
+```ts
+const client = createClient({
+  baseUrl: 'http://localhost:14173',  // required
+  sessionToken: token,                 // required
+
+  // Optional:
+  timeout: 300_000,    // ms to wait for a tool to finish (default: 5 minutes)
+  pollInterval: 2_000, // ms between status polls for API-engine tools (default: 2s)
+})
+```
+
+---
+
+## Listing tools
+
+`client.tools.list()` returns all tools with `status = 'production'`. Each row is the raw DB record — the key field for running tools is `id`, and `schemaJson` (a JSON string) describes the inputs.
+
+```ts
+const tools = await client.tools.list()
+
+for (const tool of tools) {
+  console.log(tool.id, tool.name, tool.description)
+}
+```
+
+---
+
+## Inspecting a tool's inputs
+
+The `schemaJson` field on each tool is a JSON string containing an array of `WorkflowIO` objects — one per configurable input or output node.
+
+```ts
+const tool = await client.tools.get('your-tool-id')
+
+interface WorkflowIO {
+  nodeId: string      // ComfyUI node ID, e.g. "6"
+  nodeType: string    // e.g. "CLIPTextEncode"
+  nodeTitle: string   // human label, e.g. "Positive Prompt"
+  paramName: string   // e.g. "text"
+  paramType: 'string' | 'number' | 'boolean' | 'image' | 'select'
+  defaultValue?: unknown
+  options?: string[]  // for paramType 'select'
+  isInput: boolean    // false = output node
+}
+
+const schema: WorkflowIO[] = JSON.parse(tool.schemaJson)
+const inputs = schema.filter(f => f.isInput)
+
+for (const field of inputs) {
+  console.log(`${field.nodeId}__${field.paramName}`, field.paramType, field.defaultValue)
+}
+```
+
+---
+
+## Running a tool
+
+### Input key format
+
+Input keys are always **`"${nodeId}__${paramName}"`** (double underscore). You can see the exact keys by inspecting `schemaJson` as shown above, or read them from the tool's form in the FlowScale UI.
+
+```ts
+const result = await client.tools.run('your-tool-id', {
+  '6__text': 'a photorealistic cat on the moon, cinematic lighting',
+  '7__text': 'blurry, low quality, watermark',
+  '5__width': 1024,
+  '5__height': 1024,
+  '3__steps': 20,
+  '3__cfg': 7,
+})
+```
+
+`tools.run()` blocks until the tool finishes and returns a `ToolRunResult`:
+
+```ts
+interface ToolRunResult {
+  executionId: string
+  toolId: string
+  status: 'completed'
+  outputs: ToolOutputItem[]
+}
+
+interface ToolOutputItem {
+  kind: 'image' | 'video' | 'audio' | 'file'
+  filename: string
+  subfolder: string
+  path: string  // relative URL, e.g. /api/outputs/tool-id/abc12345_output.png
+}
+```
+
+### Accessing outputs
+
+Output `path` values are **relative URLs**. Use `client.resolveUrl()` to get the full URL for downloading or displaying:
+
+```ts
+for (const output of result.outputs) {
+  const url = client.resolveUrl(output.path)
+  console.log(output.kind, url)
+  // e.g. image http://localhost:14173/api/outputs/tool-id/abc12345_output.png
+}
+```
+
+### Downloading an output to disk
+
+```ts
+import { writeFileSync } from 'fs'
+import path from 'path'
+
+for (const output of result.outputs) {
+  const url = client.resolveUrl(output.path)
+  const res = await fetch(url, {
+    headers: { Cookie: `fs_session=${token}` },
+  })
+  const buffer = Buffer.from(await res.arrayBuffer())
+  writeFileSync(path.basename(output.filename), buffer)
+  console.log('Saved', output.filename)
+}
+```
+
+### Progress callback
+
+```ts
+const result = await client.tools.run('your-tool-id', inputs, {
+  onProgress: (status) => console.log('[progress]', status),
+  timeout: 120_000, // override the client default for this call
+})
+```
+
+`onProgress` is called with `'running'` when the job starts and `'completed'` when it finishes. For API-engine tools it is also called on each poll cycle.
+
+---
+
+## Error handling
+
+`tools.run()` throws a plain `Error` on failure. The message is either the error from FlowScale or a timeout message.
+
+```ts
+try {
+  const result = await client.tools.run('your-tool-id', inputs)
+  console.log('outputs:', result.outputs)
+} catch (err) {
+  if (err instanceof Error) {
+    console.error('Tool failed:', err.message)
+    // Possible messages:
+    // - 'Tool not found'
+    // - 'No ComfyUI port configured for this tool'
+    // - 'ComfyUI reported an error'
+    // - 'Execution timed out after 300s'
+    // - Node-level error details from ComfyUI
+  }
+}
+```
+
+`login()` throws with the server's error message on bad credentials, disabled account, or network failure.
+
+---
+
+## Image inputs
+
+For tools with `paramType: 'image'` inputs, you need to upload the image to the ComfyUI instance first, then pass the returned filename as the input value.
+
+First discover which ComfyUI port the tool uses:
+
+```ts
+const tool = await client.tools.get('your-tool-id')
+const comfyPort = tool.comfyPort  // e.g. 8188
+```
+
+Then upload the image via the ComfyUI proxy:
+
+```ts
+import { readFileSync } from 'fs'
+
+async function uploadImage(
+  baseUrl: string,
+  token: string,
+  comfyPort: number,
+  filePath: string,
+): Promise<string> {
+  const fileBuffer = readFileSync(filePath)
+  const filename = path.basename(filePath)
+
+  const form = new FormData()
+  form.append('image', new Blob([fileBuffer]), filename)
+  form.append('overwrite', 'true')
+
+  const res = await fetch(`${baseUrl}/api/comfy/${comfyPort}/upload/image`, {
+    method: 'POST',
+    headers: { Cookie: `fs_session=${token}` },
+    body: form,
+  })
+  if (!res.ok) throw new Error(`Upload failed: ${res.statusText}`)
+  const data = await res.json() as { name: string }
+  return data.name  // filename to pass as input
+}
+
+// Then run the tool:
+const uploadedFilename = await uploadImage(
+  'http://localhost:14173',
+  token,
+  tool.comfyPort,
+  './photo.jpg',
+)
+
+const result = await client.tools.run('your-tool-id', {
+  '10__image': uploadedFilename,
+})
+```
+
+---
+
+## Full example — text-to-image script
+
+```ts
+import { login, createClient } from '@flowscale/sdk'
+import { writeFileSync } from 'fs'
+import path from 'path'
+
+const BASE = 'http://localhost:14173'
+
+async function main() {
+  // 1. Authenticate
+  const token = await login({ baseUrl: BASE, username: 'admin', password: 'your-password' })
+  const client = createClient({ baseUrl: BASE, sessionToken: token })
+
+  // 2. List available tools
+  const tools = await client.tools.list()
+  console.log('Available tools:', tools.map(t => `${t.name} (${t.id})`))
+
+  // 3. Inspect a tool's inputs
+  const tool = tools[0]
+  const schema = JSON.parse(tool.schemaJson)
+  console.log('Inputs:')
+  for (const field of schema.filter((f: { isInput: boolean }) => f.isInput)) {
+    console.log(` ${field.nodeId}__${field.paramName} (${field.paramType})`)
+  }
+
+  // 4. Run the tool
+  const result = await client.tools.run(tool.id, {
+    '6__text': 'a majestic mountain landscape at golden hour',
+    '7__text': 'blurry, noise, watermark',
+    '5__width': 1024,
+    '5__height': 1024,
+    '3__steps': 20,
+  }, {
+    onProgress: (s) => process.stdout.write(`\r${s}...`),
+  })
+
+  console.log('\nDone. Outputs:')
+
+  // 5. Download outputs
+  for (const output of result.outputs) {
+    const url = client.resolveUrl(output.path)
+    const res = await fetch(url, { headers: { Cookie: `fs_session=${token}` } })
+    const buffer = Buffer.from(await res.arrayBuffer())
+    const outFile = `output_${output.filename}`
+    writeFileSync(outFile, buffer)
+    console.log(` Saved ${outFile} (${output.kind})`)
+  }
+}
+
+main().catch(console.error)
+```
+
+---
+
+## Full example — Express server wrapping a tool
+
+```ts
+import express from 'express'
+import { login, createClient } from '@flowscale/sdk'
+
+const app = express()
+app.use(express.json())
+
+const BASE = 'http://localhost:14173'
+let client: Awaited<ReturnType<typeof createClient>> | null = null
+
+async function getClient() {
+  if (!client) {
+    const token = await login({ baseUrl: BASE, username: 'admin', password: process.env.FS_PASSWORD! })
+    client = createClient({ baseUrl: BASE, sessionToken: token })
+  }
+  return client
+}
+
+app.post('/generate', async (req, res) => {
+  try {
+    const { prompt, negativePrompt = '' } = req.body as { prompt: string; negativePrompt?: string }
+    const c = await getClient()
+
+    const result = await c.tools.run('your-tool-id', {
+      '6__text': prompt,
+      '7__text': negativePrompt,
+    })
+
+    const urls = result.outputs.map(o => ({
+      kind: o.kind,
+      url: c.resolveUrl(o.path),
+    }))
+
+    res.json({ executionId: result.executionId, outputs: urls })
+  } catch (err) {
+    const message = err instanceof Error ? err.message : 'Unknown error'
+    res.status(500).json({ error: message })
+  }
+})
+
+app.listen(3000, () => console.log('Server running on http://localhost:3000'))
+```
+
+---
+
+## API reference
+
+### `login(opts)`
+
+```ts
+login({
+  baseUrl: string,
+  username: string,
+  password: string,
+}): Promise<string>  // returns session token
+```
+
+Throws if credentials are invalid, the account is pending/disabled, or the server is unreachable.
+
+### `createClient(opts)`
+
+```ts
+createClient({
+  baseUrl: string,
+  sessionToken: string,
+  timeout?: number,      // default 300_000 ms
+  pollInterval?: number, // default 2_000 ms
+}): HttpClient
+```
+
+### `client.resolveUrl(path)`
+
+Prepends `baseUrl` to a relative path. Returns the path unchanged if it is already an absolute URL.
+
+### `client.tools.list()`
+
+Returns all tools with `status = 'production'`. Each item includes the raw DB row with `id`, `name`, `description`, `schemaJson`, `comfyPort`, `engine`, etc.
+
+### `client.tools.get(id)`
+
+Returns a single tool by ID. Throws `'Tool not found'` (HTTP 404) if it does not exist.
+
+### `client.tools.run(id, inputs, options?)`
+
+```ts
+client.tools.run(
+  id: string,
+  inputs: Record<string, unknown>,
+  options?: {
+    timeout?: number,
+    onProgress?: (status: string) => void,
+  }
+): Promise<ToolRunResult>
+```
+
+Blocks until the tool completes. Input keys are `"${nodeId}__${paramName}"`. Throws on error or timeout.

package/dist/http.d.ts

@@ -0,0 +1,87 @@
+/**
+ * HTTP transport for the FlowScale SDK.
+ *
+ * Use this when building apps that run **outside** FlowScale (e.g. a standalone
+ * web app, a Node.js script, or a CLI tool). It talks to a running FlowScale
+ * AIOS instance via its REST API instead of the iframe postMessage bridge.
+ *
+ * @example
+ * ```ts
+ * import { createClient } from '@flowscale/sdk/http'
+ *
+ * const client = createClient({
+ *   baseUrl: 'http://localhost:14173',
+ *   sessionToken: '<your-fs_session-cookie>',  // POST /api/auth/login to obtain one
+ * })
+ *
+ * const result = await client.tools.run('sdxl-txt2img', {
+ *   '6.text': 'a cat on the moon',
+ * })
+ * console.log(result.outputs) // [{ kind, filename, path }]
+ *
+ * // Prepend baseUrl to relative paths for direct access:
+ * const imageUrl = client.resolveUrl(result.outputs[0].path)
+ * ```
+ */
+import type { ToolDefinition, ToolRunResult } from './types';
+export interface HttpClientOptions {
+    /**
+     * Base URL of your FlowScale AIOS instance.
+     * @example 'http://localhost:14173'
+     */
+    baseUrl: string;
+    /**
+     * API key generated in FlowScale Settings → API Keys.
+     * Sent as `Authorization: Bearer <apiKey>` on every request.
+     * Use this instead of `sessionToken` for keyless external access.
+     * @example 'fs_abc123...'
+     */
+    apiKey?: string;
+    /**
+     * Session token obtained from `POST /api/auth/login`.
+     * Sent as the `fs_session` cookie on every request.
+     * Not needed when using `apiKey`.
+     */
+    sessionToken?: string;
+    /**
+     * How long (ms) to wait for a tool execution to complete before timing out.
+     * @default 300_000 (5 minutes)
+     */
+    timeout?: number;
+    /**
+     * How often (ms) to poll for execution status.
+     * @default 2_000
+     */
+    pollInterval?: number;
+}
+export interface LoginOptions {
+    baseUrl: string;
+    username: string;
+    password: string;
+}
+/** Log in and return a session token without creating a full client. */
+export declare function login(opts: LoginOptions): Promise<string>;
+export interface HttpClient {
+    /** Resolve a relative output path (e.g. `/api/outputs/...`) to a full URL. */
+    resolveUrl(path: string): string;
+    tools: {
+        /** List all production tools. */
+        list(): Promise<ToolDefinition[]>;
+        /** Get a single tool by ID. */
+        get(id: string): Promise<ToolDefinition>;
+        /**
+         * Run a tool and wait for it to complete.
+         *
+         * For ComfyUI tools, inputs use `"${nodeId}__${paramName}"` keys.
+         * For registry tools, inputs use `"${nodeId}.${paramName}"` keys.
+         * Image inputs can be passed as base64 data URLs (`data:image/png;base64,...`).
+         */
+        run(id: string, inputs: Record<string, unknown>, options?: {
+            timeout?: number;
+            onProgress?: (status: string) => void;
+        }): Promise<ToolRunResult>;
+    };
+}
+/** Create an HTTP client connected to a FlowScale AIOS instance. */
+export declare function createClient(options: HttpClientOptions): HttpClient;
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAkB,MAAM,SAAS,CAAC;AAE7E,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wEAAwE;AACxE,wBAAsB,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAe/D;AAED,MAAM,WAAW,UAAU;IACzB,8EAA8E;IAC9E,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,KAAK,EAAE;QACL,iCAAiC;QACjC,IAAI,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;QAClC,+BAA+B;QAC/B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;QACzC;;;;;;WAMG;QACH,GAAG,CACD,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,CAAC,EAAE;YAAE,OAAO,CAAC,EAAE,MAAM,CAAC;YAAC,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;SAAE,GACpE,OAAO,CAAC,aAAa,CAAC,CAAC;KAC3B,CAAC;CACH;AAMD,oEAAoE;AACpE,wBAAgB,YAAY,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAoHnE"}

package/dist/http.js

@@ -0,0 +1,140 @@
+"use strict";
+/**
+ * HTTP transport for the FlowScale SDK.
+ *
+ * Use this when building apps that run **outside** FlowScale (e.g. a standalone
+ * web app, a Node.js script, or a CLI tool). It talks to a running FlowScale
+ * AIOS instance via its REST API instead of the iframe postMessage bridge.
+ *
+ * @example
+ * ```ts
+ * import { createClient } from '@flowscale/sdk/http'
+ *
+ * const client = createClient({
+ *   baseUrl: 'http://localhost:14173',
+ *   sessionToken: '<your-fs_session-cookie>',  // POST /api/auth/login to obtain one
+ * })
+ *
+ * const result = await client.tools.run('sdxl-txt2img', {
+ *   '6.text': 'a cat on the moon',
+ * })
+ * console.log(result.outputs) // [{ kind, filename, path }]
+ *
+ * // Prepend baseUrl to relative paths for direct access:
+ * const imageUrl = client.resolveUrl(result.outputs[0].path)
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.login = login;
+exports.createClient = createClient;
+/** Log in and return a session token without creating a full client. */
+async function login(opts) {
+    const res = await fetch(`${opts.baseUrl}/api/auth/login`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ username: opts.username, password: opts.password }),
+    });
+    if (!res.ok) {
+        const err = await res.json().catch(() => ({ error: res.statusText }));
+        throw new Error(err.error ?? `Login failed: HTTP ${res.status}`);
+    }
+    // Session token comes back as a Set-Cookie header (fs_session=<token>)
+    const cookie = res.headers.get('set-cookie') ?? '';
+    const match = cookie.match(/fs_session=([^;]+)/);
+    if (!match)
+        throw new Error('No session token in login response');
+    return match[1];
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/** Create an HTTP client connected to a FlowScale AIOS instance. */
+function createClient(options) {
+    const { baseUrl, sessionToken, apiKey, timeout: defaultTimeout = 300000, pollInterval = 2000, } = options;
+    if (!apiKey && !sessionToken) {
+        throw new Error('createClient requires either apiKey or sessionToken');
+    }
+    const authHeaders = apiKey
+        ? { Authorization: `Bearer ${apiKey}` }
+        : { Cookie: `fs_session=${sessionToken}` };
+    async function apiFetch(path, init) {
+        const res = await fetch(`${baseUrl}${path}`, {
+            ...init,
+            headers: {
+                'Content-Type': 'application/json',
+                ...authHeaders,
+                ...(init?.headers ?? {}),
+            },
+        });
+        if (!res.ok) {
+            const err = await res.json().catch(() => ({ error: res.statusText }));
+            throw new Error(err.error ?? `HTTP ${res.status} ${path}`);
+        }
+        return res.json();
+    }
+    function resolveUrl(path) {
+        if (path.startsWith('http://') || path.startsWith('https://'))
+            return path;
+        return `${baseUrl}${path}`;
+    }
+    const tools = {
+        async list() {
+            return apiFetch('/api/tools?status=production');
+        },
+        async get(id) {
+            return apiFetch(`/api/tools/${id}`);
+        },
+        async run(id, inputs, runOptions = {}) {
+            const { timeout = defaultTimeout, onProgress } = runOptions;
+            onProgress?.('running');
+            // ?wait=true — server polls ComfyUI internally and returns only when done.
+            // For API-engine tools the server also runs to completion before responding.
+            // Either way we get back a finished execution row directly.
+            const execution = await apiFetch(`/api/tools/${id}/executions?wait=true`, {
+                method: 'POST',
+                body: JSON.stringify({ inputs }),
+                signal: AbortSignal.timeout(timeout),
+            });
+            if (execution.error)
+                throw new Error(execution.error);
+            // API-engine tools still return 202 immediately — poll the execution record
+            if (execution.status === 'running' && execution.executionId) {
+                const executionId = execution.executionId;
+                const deadline = Date.now() + timeout;
+                while (Date.now() < deadline) {
+                    await sleep(pollInterval);
+                    const row = await apiFetch(`/api/executions/${executionId}`);
+                    if (row.status === 'completed') {
+                        onProgress?.('completed');
+                        let outputs = [];
+                        try {
+                            outputs = JSON.parse(row.outputsJson ?? '[]');
+                        }
+                        catch { /* empty */ }
+                        return { executionId, toolId: id, status: 'completed', outputs };
+                    }
+                    if (row.status === 'error')
+                        throw new Error(row.errorMessage ?? 'Execution failed');
+                    onProgress?.(row.status);
+                }
+                throw new Error(`Execution timed out after ${timeout / 1000}s`);
+            }
+            if (execution.status === 'error')
+                throw new Error(execution.errorMessage ?? 'Execution failed');
+            onProgress?.('completed');
+            let outputs = [];
+            try {
+                outputs = JSON.parse(execution.outputsJson ?? '[]');
+            }
+            catch { /* empty */ }
+            return {
+                executionId: execution.id,
+                toolId: id,
+                status: 'completed',
+                outputs,
+            };
+        },
+    };
+    return { resolveUrl, tools };
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;;AA0CH,sBAeC;AA8BD,oCAoHC;AAlKD,wEAAwE;AACjE,KAAK,UAAU,KAAK,CAAC,IAAkB;IAC5C,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,iBAAiB,EAAE;QACxD,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;KAC3E,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC,CAAuB,CAAC;QAC5F,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,sBAAsB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IACnE,CAAC;IACD,uEAAuE;IACvE,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;IACnD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACjD,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IAClE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAyBD,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,oEAAoE;AACpE,SAAgB,YAAY,CAAC,OAA0B;IACrD,MAAM,EACJ,OAAO,EACP,YAAY,EACZ,MAAM,EACN,OAAO,EAAE,cAAc,GAAG,MAAO,EACjC,YAAY,GAAG,IAAK,GACrB,GAAG,OAAO,CAAC;IAEZ,IAAI,CAAC,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,WAAW,GAA2B,MAAM;QAChD,CAAC,CAAC,EAAE,aAAa,EAAE,UAAU,MAAM,EAAE,EAAE;QACvC,CAAC,CAAC,EAAE,MAAM,EAAE,cAAc,YAAY,EAAE,EAAE,CAAC;IAE7C,KAAK,UAAU,QAAQ,CAAI,IAAY,EAAE,IAAkB;QACzD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,GAAG,IAAI,EAAE,EAAE;YAC3C,GAAG,IAAI;YACP,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,GAAG,WAAW;gBACd,GAAG,CAAC,IAAI,EAAE,OAAO,IAAI,EAAE,CAAC;aACzB;SACF,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC,CAAuB,CAAC;YAC5F,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,QAAQ,GAAG,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC;QAC7D,CAAC;QACD,OAAO,GAAG,CAAC,IAAI,EAAgB,CAAC;IAClC,CAAC;IAED,SAAS,UAAU,CAAC,IAAY;QAC9B,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,OAAO,IAAI,CAAC;QAC3E,OAAO,GAAG,OAAO,GAAG,IAAI,EAAE,CAAC;IAC7B,CAAC;IAED,MAAM,KAAK,GAAG;QACZ,KAAK,CAAC,IAAI;YACR,OAAO,QAAQ,CAAmB,8BAA8B,CAAC,CAAC;QACpE,CAAC;QAED,KAAK,CAAC,GAAG,CAAC,EAAU;YAClB,OAAO,QAAQ,CAAiB,cAAc,EAAE,EAAE,CAAC,CAAC;QACtD,CAAC;QAED,KAAK,CAAC,GAAG,CACP,EAAU,EACV,MAA+B,EAC/B,aAA0E,EAAE;YAE5E,MAAM,EAAE,OAAO,GAAG,cAAc,EAAE,UAAU,EAAE,GAAG,UAAU,CAAC;YAE5D,UAAU,EAAE,CAAC,SAAS,CAAC,CAAC;YAExB,2EAA2E;YAC3E,6EAA6E;YAC7E,4DAA4D;YAC5D,MAAM,SAAS,GAAG,MAAM,QAAQ,CAS7B,cAAc,EAAE,uBAAuB,EAAE;gBAC1C,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;gBAChC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC;aACrC,CAAC,CAAC;YAEH,IAAI,SAAS,CAAC,KAAK;gBAAE,MAAM,IAAI,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAEtD,4EAA4E;YAC5E,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC;gBAC5D,MAAM,WAAW,GAAG,SAAS,CAAC,WAAW,CAAC;gBAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC;gBAEtC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;oBAC7B,MAAM,KAAK,CAAC,YAAY,CAAC,CAAC;oBAC1B,MAAM,GAAG,GAAG,MAAM,QAAQ,CAIvB,mBAAmB,WAAW,EAAE,CAAC,CAAC;oBAErC,IAAI,GAAG,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;wBAC/B,UAAU,EAAE,CAAC,WAAW,CAAC,CAAC;wBAC1B,IAAI,OAAO,GAAqB,EAAE,CAAC;wBACnC,IAAI,CAAC;4BAAC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,IAAI,IAAI,CAAqB,CAAC;wBAAC,CAAC;wBAAC,MAAM,CAAC,CAAC,WAAW,CAAC,CAAC;wBAChG,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;oBACnE,CAAC;oBACD,IAAI,GAAG,CAAC,MAAM,KAAK,OAAO;wBAAE,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,YAAY,IAAI,kBAAkB,CAAC,CAAC;oBACpF,UAAU,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBAC3B,CAAC;gBACD,MAAM,IAAI,KAAK,CAAC,6BAA6B,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC;YAClE,CAAC;YAED,IAAI,SAAS,CAAC,MAAM,KAAK,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,SAAS,CAAC,YAAY,IAAI,kBAAkB,CAAC,CAAC;YAEhG,UAAU,EAAE,CAAC,WAAW,CAAC,CAAC;YAC1B,IAAI,OAAO,GAAqB,EAAE,CAAC;YACnC,IAAI,CAAC;gBAAC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,WAAW,IAAI,IAAI,CAAqB,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,WAAW,CAAC,CAAC;YACtG,OAAO;gBACL,WAAW,EAAE,SAAS,CAAC,EAAE;gBACzB,MAAM,EAAE,EAAE;gBACV,MAAM,EAAE,WAAW;gBACnB,OAAO;aACR,CAAC;QACJ,CAAC;KACF,CAAC;IAEF,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;AAC/B,CAAC"}

package/dist/index.d.ts

@@ -4,10 +4,13 @@ export { providers } from './providers';
 export { storage } from './storage';
 export { ui } from './ui';
 export { app } from './app';
+export { createClient, login } from './http';
+export type { HttpClient, HttpClientOptions, LoginOptions } from './http';
 export * from './types';
 /** Convenience default export with all namespaces. */
 declare const FlowScale: {
     readonly tools: {
+        outputRef(output: import("./types").ToolOutputItem): import("./types").OutputRef;
         list(): Promise<import("./types").ToolDefinition[]>;
         get(id: string): Promise<import("./types").ToolDefinition>;
         run(id: string, inputs: Record<string, unknown>, options?: import("./types").ToolRunOptions): Promise<import("./types").ToolRunResult>;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC;AAC1B,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,cAAc,SAAS,CAAC;AAQxB,sDAAsD;AACtD,QAAA,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAkD,CAAC;AAClE,eAAe,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC;AAC1B,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAC7C,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAC1E,cAAc,SAAS,CAAC;AAQxB,sDAAsD;AACtD,QAAA,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAkD,CAAC;AAClE,eAAe,SAAS,CAAC"}

package/dist/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.app = exports.ui = exports.storage = exports.providers = exports.tools = exports.bridge = void 0;
+exports.login = exports.createClient = exports.app = exports.ui = exports.storage = exports.providers = exports.tools = exports.bridge = void 0;
 var bridge_1 = require("./bridge");
 Object.defineProperty(exports, "bridge", { enumerable: true, get: function () { return bridge_1.bridge; } });
 var tools_1 = require("./tools");
@@ -27,6 +27,9 @@ var ui_1 = require("./ui");
 Object.defineProperty(exports, "ui", { enumerable: true, get: function () { return ui_1.ui; } });
 var app_1 = require("./app");
 Object.defineProperty(exports, "app", { enumerable: true, get: function () { return app_1.app; } });
+var http_1 = require("./http");
+Object.defineProperty(exports, "createClient", { enumerable: true, get: function () { return http_1.createClient; } });
+Object.defineProperty(exports, "login", { enumerable: true, get: function () { return http_1.login; } });
 __exportStar(require("./types"), exports);
 const tools_2 = require("./tools");
 const providers_2 = require("./providers");

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,mCAAkC;AAAzB,gGAAA,MAAM,OAAA;AACf,iCAAgC;AAAvB,8FAAA,KAAK,OAAA;AACd,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AAClB,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAChB,2BAA0B;AAAjB,wFAAA,EAAE,OAAA;AACX,6BAA4B;AAAnB,0FAAA,GAAG,OAAA;AACZ,0CAAwB;AAExB,mCAAgC;AAChC,2CAAwC;AACxC,uCAAoC;AACpC,6BAA0B;AAC1B,+BAA4B;AAE5B,sDAAsD;AACtD,MAAM,SAAS,GAAG,EAAE,KAAK,EAAL,aAAK,EAAE,SAAS,EAAT,qBAAS,EAAE,OAAO,EAAP,iBAAO,EAAE,EAAE,EAAF,OAAE,EAAE,GAAG,EAAH,SAAG,EAAW,CAAC;AAClE,kBAAe,SAAS,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,mCAAkC;AAAzB,gGAAA,MAAM,OAAA;AACf,iCAAgC;AAAvB,8FAAA,KAAK,OAAA;AACd,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AAClB,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAChB,2BAA0B;AAAjB,wFAAA,EAAE,OAAA;AACX,6BAA4B;AAAnB,0FAAA,GAAG,OAAA;AACZ,+BAA6C;AAApC,oGAAA,YAAY,OAAA;AAAE,6FAAA,KAAK,OAAA;AAE5B,0CAAwB;AAExB,mCAAgC;AAChC,2CAAwC;AACxC,uCAAoC;AACpC,6BAA0B;AAC1B,+BAA4B;AAE5B,sDAAsD;AACtD,MAAM,SAAS,GAAG,EAAE,KAAK,EAAL,aAAK,EAAE,SAAS,EAAT,qBAAS,EAAE,OAAO,EAAP,iBAAO,EAAE,EAAE,EAAF,OAAE,EAAE,GAAG,EAAH,SAAG,EAAW,CAAC;AAClE,kBAAe,SAAS,CAAC"}

package/dist/tools.d.ts

@@ -1,5 +1,11 @@
-import { ToolDefinition, ToolRunOptions, ToolRunResult } from './types';
+import { ToolDefinition, ToolOutputItem, ToolRunOptions, ToolRunResult, OutputRef } from './types';
 export declare const tools: {
+    /**
+     * Create an output reference for chaining one tool's output into another's input.
+     * Pass the returned value as an image input to the next tools.run() call.
+     * The bridge handles the ComfyUI output→input transfer server-side.
+     */
+    outputRef(output: ToolOutputItem): OutputRef;
     /** List all tools available to this app. */
     list(): Promise<ToolDefinition[]>;
     /** Get a single tool by ID. */

package/dist/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExE,eAAO,MAAM,KAAK;IAChB,4CAA4C;YAC9B,OAAO,CAAC,cAAc,EAAE,CAAC;IAIvC,+BAA+B;YACjB,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAI9C,2CAA2C;YAErC,MAAM,UACF,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YACtB,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC;CAiB1B,CAAC"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEnG,eAAO,MAAM,KAAK;IAChB;;;;OAIG;sBACe,cAAc,GAAG,SAAS;IAI5C,4CAA4C;YAC9B,OAAO,CAAC,cAAc,EAAE,CAAC;IAIvC,+BAA+B;YACjB,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAI9C,2CAA2C;YAErC,MAAM,UACF,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YACtB,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC;CAiB1B,CAAC"}

package/dist/tools.js

@@ -3,6 +3,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.tools = void 0;
 const bridge_1 = require("./bridge");
 exports.tools = {
+    /**
+     * Create an output reference for chaining one tool's output into another's input.
+     * Pass the returned value as an image input to the next tools.run() call.
+     * The bridge handles the ComfyUI output→input transfer server-side.
+     */
+    outputRef(output) {
+        return { __comfy_output__: { filename: output.filename, subfolder: output.subfolder } };
+    },
     /** List all tools available to this app. */
     async list() {
         return bridge_1.bridge.call('tools.list');

package/dist/tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":";;;AAAA,qCAAkC;AAGrB,QAAA,KAAK,GAAG;IACnB,4CAA4C;IAC5C,KAAK,CAAC,IAAI;QACR,OAAO,eAAM,CAAC,IAAI,CAAmB,YAAY,CAAC,CAAC;IACrD,CAAC;IAED,+BAA+B;IAC/B,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,OAAO,eAAM,CAAC,IAAI,CAAiB,WAAW,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,2CAA2C;IAC3C,KAAK,CAAC,GAAG,CACP,EAAU,EACV,MAA+B,EAC/B,UAA0B,EAAE;QAE5B,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;QAExC,IAAI,WAAqC,CAAC;QAC1C,IAAI,UAAU,EAAE,CAAC;YACf,WAAW,GAAG,eAAM,CAAC,EAAE,CAAC,kBAAkB,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,EAAE;gBACzD,MAAM,CAAC,GAAG,MAAgD,CAAC;gBAC3D,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;YACpC,CAAC,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC;YACH,OAAO,MAAM,eAAM,CAAC,IAAI,CAAgB,WAAW,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;QAChF,CAAC;gBAAS,CAAC;YACT,WAAW,EAAE,EAAE,CAAC;QAClB,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":";;;AAAA,qCAAkC;AAGrB,QAAA,KAAK,GAAG;IACnB;;;;OAIG;IACH,SAAS,CAAC,MAAsB;QAC9B,OAAO,EAAE,gBAAgB,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC;IAC1F,CAAC;IAED,4CAA4C;IAC5C,KAAK,CAAC,IAAI;QACR,OAAO,eAAM,CAAC,IAAI,CAAmB,YAAY,CAAC,CAAC;IACrD,CAAC;IAED,+BAA+B;IAC/B,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,OAAO,eAAM,CAAC,IAAI,CAAiB,WAAW,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,2CAA2C;IAC3C,KAAK,CAAC,GAAG,CACP,EAAU,EACV,MAA+B,EAC/B,UAA0B,EAAE;QAE5B,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;QAExC,IAAI,WAAqC,CAAC;QAC1C,IAAI,UAAU,EAAE,CAAC;YACf,WAAW,GAAG,eAAM,CAAC,EAAE,CAAC,kBAAkB,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,EAAE;gBACzD,MAAM,CAAC,GAAG,MAAgD,CAAC;gBAC3D,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;YACpC,CAAC,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC;YACH,OAAO,MAAM,eAAM,CAAC,IAAI,CAAgB,WAAW,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;QAChF,CAAC;gBAAS,CAAC;YACT,WAAW,EAAE,EAAE,CAAC;QAClB,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/types.d.ts

@@ -53,9 +53,34 @@ export interface ToolRunOptions {
     timeout?: number;
     onProgress?: (progress: number, message?: string) => void;
 }
+export interface ToolOutputItem {
+    kind: 'image' | 'video' | 'audio' | 'file';
+    filename: string;
+    subfolder: string;
+    /** Relative URL served by the host — use directly in <img src> or fetch() */
+    path: string;
+}
+/**
+ * Pass as an image input to FlowScale.tools.run() to chain the output of one
+ * step into the input of the next. The bridge handles the transfer server-side.
+ *
+ * @example
+ * const step1 = await FlowScale.tools.run(TOOL_A, { '1__image': dataUrl })
+ * const step2 = await FlowScale.tools.run(TOOL_B, {
+ *   '1__image': FlowScale.tools.outputRef(step1.outputs[0]),
+ * })
+ */
+export interface OutputRef {
+    __comfy_output__: {
+        filename: string;
+        subfolder: string;
+    };
+}
 export interface ToolRunResult {
-    outputs: Record<string, unknown>;
-    executionId?: string;
+    executionId: string;
+    toolId: string;
+    status: 'completed';
+    outputs: ToolOutputItem[];
 }
 export type ProviderName = 'fal' | 'replicate' | 'openrouter' | 'huggingface';
 export interface ProviderStatus {

package/dist/types.d.ts.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@flowscale/sdk",
-  "version": "1.0.0",
-  "description": "FlowScale EIOS SDK — build apps that run inside FlowScale AI OS",
+  "version": "1.2.0",
+  "description": "FlowScale AIOS SDK — build apps inside FlowScale or externally via HTTP",
   "license": "AGPL-3.0-only",
   "files": [
     "dist"
@@ -26,7 +26,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/FlowScale-AI/flowscale-eios.git"
+    "url": "git+https://github.com/FlowScale-AI/flowscale-aios.git"
   },
   "devDependencies": {
     "typescript": "^5.8.3"