@runmark/sdk 0.1.0

package/README.md

@@ -0,0 +1,219 @@
+# @skyforge-ai/sdk
+
+Server-side TypeScript SDK for Skyforge agent chat integrations.
+
+This package is internal for now and is not published to npm. `private: true`
+is intentionally retained until a release process, package metadata, and npm
+publishing policy are approved.
+
+## Runtime
+
+- Node.js 24.17.0 or newer.
+- Server-only. The SDK throws in browser-like environments.
+- Zero runtime dependencies.
+- Uses native `fetch`, `FormData`, `ReadableStream`, and `AbortSignal`.
+
+## Authentication
+
+Every request uses the existing Skyforge chat routes and sends:
+
+```http
+Authorization: Bearer <skyforge_api_token>
+```
+
+The SDK does not set cookies, `X-CSRF-Token`, `credentials: "include"`, or call
+`/api/auth/csrf`.
+
+## Response Shape
+
+SDK method inputs use camelCase. Request bodies are serialized to the existing
+backend field names.
+
+V1 response payloads intentionally mirror the backend DTOs, including snake_case
+fields such as `chat_id`, `agent_branch_id`, and `pending_human_actions`. The SDK
+does not translate response fields to camelCase.
+
+## Usage
+
+```ts
+import { SkyforgeClient } from "@skyforge-ai/sdk";
+
+const skyforge = new SkyforgeClient({
+  apiKey: process.env.SKYFORGE_API_TOKEN!,
+  baseUrl: "https://api.skyforge.ai",
+});
+```
+
+### Get Agent Branch State
+
+```ts
+const state = await skyforge.agentBranches.getState({
+  agentBranchId: "11111111-1111-1111-1111-111111111111",
+  chatId: "22222222-2222-2222-2222-222222222222",
+});
+
+console.log(state.chat_id, state.messages);
+```
+
+### Send Message
+
+```ts
+const response = await skyforge.agentBranches.sendMessage({
+  agentBranchId: "11111111-1111-1111-1111-111111111111",
+  chatId: "22222222-2222-2222-2222-222222222222",
+  message: "Summarize the latest run.",
+  structuredContext: {
+    priority: "high",
+  },
+});
+
+console.log(response.chat_id, response.agent_run_id);
+```
+
+### Stream Run Events
+
+```ts
+const events = await skyforge.agentRuns.streamEvents({
+  agentRunId: "33333333-3333-3333-3333-333333333333",
+  afterSequence: 12,
+});
+
+for await (const event of events) {
+  console.log(event.sequence, event.event.type);
+}
+```
+
+Breaking out of the loop cancels the underlying response reader.
+
+### Submit Human Action
+
+```ts
+await skyforge.humanActions.submit({
+  humanActionRequestId: "44444444-4444-4444-4444-444444444444",
+  values: {
+    approved: true,
+  },
+});
+```
+
+### Uploaded Files
+
+```ts
+const upload = await skyforge.uploadedFiles.upload({
+  agentBranchId: "11111111-1111-1111-1111-111111111111",
+  chatId: "22222222-2222-2222-2222-222222222222",
+  file: new Blob(["notes"], { type: "text/plain" }),
+  filename: "notes.txt",
+  contentType: "text/plain",
+});
+
+const files = await skyforge.uploadedFiles.list({
+  agentBranchId: upload.file.agent_branch_id,
+  chatId: upload.chat_id,
+});
+
+await skyforge.uploadedFiles.delete({
+  agentBranchId: upload.file.agent_branch_id,
+  chatId: upload.chat_id,
+  fileContextId: upload.file.id,
+});
+```
+
+`filename` is required and must not be blank.
+
+## Tests
+
+Run the fast SDK unit tests:
+
+```bash
+cd packages/skyforge-sdk
+npm test
+```
+
+The opt-in live suite requires a running local Skyforge backend and a valid
+local API token with access to the selected agent branch. It uses only
+`Authorization: Bearer <skyforge_api_token>` through the existing
+`/api/skyforge-chat/...` routes.
+
+Live test environment variables can be stored in `.e2e.env` at the package
+root. Copy the example file and fill in your local token:
+
+```bash
+cd packages/skyforge-sdk
+cp .e2e.env.example .e2e.env
+```
+
+`.e2e.env` is ignored by git. Shell environment variables take precedence over
+values in the file.
+
+```bash
+cd packages/skyforge-sdk
+
+SKYFORGE_SDK_LIVE=1 \
+SKYFORGE_API_BASE_URL=http://localhost:3000 \
+SKYFORGE_API_TOKEN=... \
+SKYFORGE_AGENT_BRANCH_ID=... \
+npm run test:live
+```
+
+With `.e2e.env` populated, this is enough:
+
+```bash
+npm run test:live
+```
+
+Optional live test controls:
+
+```bash
+SKYFORGE_SDK_LIVE_UPLOADS=1
+SKYFORGE_SDK_LIVE_HITL_REQUEST_ID=...
+SKYFORGE_SDK_LIVE_EXISTING_CHAT_ID=...
+SKYFORGE_SDK_LIVE_TIMEOUT_MS=60000
+SKYFORGE_SDK_LIVE_HITL_TIMEOUT_MS=120000
+SKYFORGE_SDK_LIVE_EVENT_TIMEOUT_MS=15000
+SKYFORGE_SDK_LIVE_MESSAGE="SDK live smoke test. Reply with a short confirmation."
+SKYFORGE_SDK_LIVE_EXPECT_PENDING_HITL=1
+SKYFORGE_SDK_LIVE_EXPECT_BUBBLED_HITL=1
+SKYFORGE_SDK_LIVE_SUBMIT_PENDING_HITL=1
+SKYFORGE_SDK_LIVE_HITL_VALUES='{"decision":"approve","notes":"Approved by SDK live test."}'
+```
+
+### HITL Bubbling Demo
+
+The repository seed includes a TailYew `hitl-bubbling-demo` parent agent. The
+SDK package has a convenience live command for that seeded local fixture:
+
+```bash
+cd packages/skyforge-sdk
+
+SKYFORGE_API_TOKEN=... \
+npm run test:live:hitl-bubbling-demo
+```
+
+If `.e2e.env` contains `SKYFORGE_API_TOKEN`, you can run:
+
+```bash
+npm run test:live:hitl-bubbling-demo
+```
+
+This command sets:
+
+```bash
+SKYFORGE_SDK_LIVE=1
+SKYFORGE_API_BASE_URL=http://127.0.0.1:3000
+SKYFORGE_AGENT_BRANCH_ID=9ab14d38-55d1-4a9c-bc56-0df2c03aee02
+SKYFORGE_SDK_LIVE_MESSAGE="Use ask_skyforge_agent to ask the human-workflow-demo child agent to look up Bulbasaur. Do not answer without calling the child agent."
+SKYFORGE_SDK_LIVE_TIMEOUT_MS=180000
+SKYFORGE_SDK_LIVE_HITL_TIMEOUT_MS=120000
+SKYFORGE_SDK_LIVE_EVENT_TIMEOUT_MS=15000
+SKYFORGE_SDK_LIVE_EXPECT_PENDING_HITL=1
+SKYFORGE_SDK_LIVE_EXPECT_BUBBLED_HITL=1
+SKYFORGE_SDK_LIVE_SUBMIT_PENDING_HITL=1
+```
+
+`SKYFORGE_API_TOKEN` is still required and is not set by the script. Use a valid
+local API token with access to the seeded TailYew repository/branch. You can
+override the base URL, branch ID, message, HITL values, or timeout by setting
+the same environment variables before running the command.
+
+Do not expose Skyforge API tokens in browser code. This SDK is server-side only.

package/dist/client.d.ts

@@ -0,0 +1,29 @@
+import type { DeleteUploadedFileParams, GetAgentBranchStateParams, SendMessageParams, SkyforgeAgentRunEventEnvelope, SkyforgeChatMessageResponse, SkyforgeChatStateResponse, SkyforgeChatUploadedFileListResponse, SkyforgeChatUploadedFileUploadResponse, SkyforgeClientOptions, StreamAgentRunEventsParams, SubmitHumanActionParams, UploadFileParams, ListUploadedFilesParams } from "./types.js";
+export declare class SkyforgeClient {
+    readonly agentBranches: {
+        getState: (params: GetAgentBranchStateParams) => Promise<SkyforgeChatStateResponse>;
+        sendMessage: (params: SendMessageParams) => Promise<SkyforgeChatMessageResponse>;
+    };
+    readonly agentRuns: {
+        streamEvents: (params: StreamAgentRunEventsParams) => Promise<AsyncIterable<SkyforgeAgentRunEventEnvelope>>;
+    };
+    readonly humanActions: {
+        submit: (params: SubmitHumanActionParams) => Promise<SkyforgeChatMessageResponse>;
+    };
+    readonly uploadedFiles: {
+        list: (params: ListUploadedFilesParams) => Promise<SkyforgeChatUploadedFileListResponse>;
+        upload: (params: UploadFileParams) => Promise<SkyforgeChatUploadedFileUploadResponse>;
+        delete: (params: DeleteUploadedFileParams) => Promise<SkyforgeChatUploadedFileListResponse>;
+    };
+    private readonly baseUrl;
+    private readonly http;
+    constructor(options: SkyforgeClientOptions);
+    private getAgentBranchState;
+    private sendMessage;
+    private streamEvents;
+    private submitHumanAction;
+    private listUploadedFiles;
+    private uploadFile;
+    private deleteUploadedFile;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,wBAAwB,EACxB,yBAAyB,EACzB,iBAAiB,EACjB,6BAA6B,EAC7B,2BAA2B,EAC3B,yBAAyB,EACzB,oCAAoC,EACpC,sCAAsC,EACtC,qBAAqB,EAErB,0BAA0B,EAC1B,uBAAuB,EAEvB,gBAAgB,EAChB,uBAAuB,EACxB,MAAM,YAAY,CAAC;AAIpB,qBAAa,cAAc;IACzB,QAAQ,CAAC,aAAa,EAAE;QACtB,QAAQ,EAAE,CAAC,MAAM,EAAE,yBAAyB,KAAK,OAAO,CAAC,yBAAyB,CAAC,CAAC;QACpF,WAAW,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,OAAO,CAAC,2BAA2B,CAAC,CAAC;KAClF,CAAC;IACF,QAAQ,CAAC,SAAS,EAAE;QAClB,YAAY,EAAE,CACZ,MAAM,EAAE,0BAA0B,KAC/B,OAAO,CAAC,aAAa,CAAC,6BAA6B,CAAC,CAAC,CAAC;KAC5D,CAAC;IACF,QAAQ,CAAC,YAAY,EAAE;QACrB,MAAM,EAAE,CAAC,MAAM,EAAE,uBAAuB,KAAK,OAAO,CAAC,2BAA2B,CAAC,CAAC;KACnF,CAAC;IACF,QAAQ,CAAC,aAAa,EAAE;QACtB,IAAI,EAAE,CAAC,MAAM,EAAE,uBAAuB,KAAK,OAAO,CAAC,oCAAoC,CAAC,CAAC;QACzF,MAAM,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,OAAO,CAAC,sCAAsC,CAAC,CAAC;QACtF,MAAM,EAAE,CAAC,MAAM,EAAE,wBAAwB,KAAK,OAAO,CAAC,oCAAoC,CAAC,CAAC;KAC7F,CAAC;IAEF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;gBAEtB,OAAO,EAAE,qBAAqB;IAmC1C,OAAO,CAAC,mBAAmB;IAS3B,OAAO,CAAC,WAAW;YAeL,YAAY;IAU1B,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,UAAU;IAmBlB,OAAO,CAAC,kBAAkB;CAa3B"}

package/dist/client.js

@@ -0,0 +1,101 @@
+import { HttpClient } from "./http.js";
+import { parseSkyforgeEventStream } from "./sse.js";
+import { chatStateUrl, humanActionSubmitUrl, runEventStreamUrl, sendMessageUrl, uploadedFileDeleteUrl, uploadedFilesUrl, } from "./routes.js";
+const DEFAULT_BASE_URL = "https://api.skyforge.ai";
+export class SkyforgeClient {
+    agentBranches;
+    agentRuns;
+    humanActions;
+    uploadedFiles;
+    baseUrl;
+    http;
+    constructor(options) {
+        assertServerEnvironment();
+        if (options.apiKey.trim().length === 0) {
+            throw new Error("Skyforge apiKey is required.");
+        }
+        const fetchFn = options.fetch ?? globalThis.fetch;
+        if (fetchFn === undefined) {
+            throw new Error("Skyforge SDK requires a fetch implementation.");
+        }
+        this.baseUrl = options.baseUrl ?? DEFAULT_BASE_URL;
+        this.http = new HttpClient({
+            apiKey: options.apiKey,
+            fetch: fetchFn,
+        });
+        this.agentBranches = {
+            getState: (params) => this.getAgentBranchState(params),
+            sendMessage: (params) => this.sendMessage(params),
+        };
+        this.agentRuns = {
+            streamEvents: (params) => this.streamEvents(params),
+        };
+        this.humanActions = {
+            submit: (params) => this.submitHumanAction(params),
+        };
+        this.uploadedFiles = {
+            list: (params) => this.listUploadedFiles(params),
+            upload: (params) => this.uploadFile(params),
+            delete: (params) => this.deleteUploadedFile(params),
+        };
+    }
+    getAgentBranchState(params) {
+        return this.http.getJson(chatStateUrl(this.baseUrl, params.agentBranchId, params.chatId), params.signal);
+    }
+    sendMessage(params) {
+        return this.http.postJson(sendMessageUrl(this.baseUrl, params.agentBranchId), compactBody({
+            message: params.message,
+            chat_id: params.chatId,
+            retried_from_agent_run_id: params.retriedFromAgentRunId,
+            source_user_message_id: params.sourceUserMessageId,
+            structured_context: params.structuredContext,
+            retrieval_scope: params.retrievalScope,
+        }), params.signal);
+    }
+    async streamEvents(params) {
+        const response = await this.http.stream(runEventStreamUrl(this.baseUrl, params.agentRunId, params.afterSequence), params.signal);
+        return parseSkyforgeEventStream(response.body);
+    }
+    submitHumanAction(params) {
+        return this.http.postJson(humanActionSubmitUrl(this.baseUrl, params.humanActionRequestId), { values: params.values }, params.signal);
+    }
+    listUploadedFiles(params) {
+        return this.http.getJson(uploadedFilesUrl(this.baseUrl, params.agentBranchId, params.chatId), params.signal);
+    }
+    uploadFile(params) {
+        if (params.filename === undefined || params.filename.trim().length === 0) {
+            throw new Error("Skyforge uploaded file filename is required.");
+        }
+        const form = new FormData();
+        if (params.chatId !== undefined) {
+            form.append("chat_id", params.chatId);
+        }
+        form.append("file", toUploadBlob(params.file, params.contentType), params.filename);
+        return this.http.postForm(uploadedFilesUrl(this.baseUrl, params.agentBranchId), form, params.signal);
+    }
+    deleteUploadedFile(params) {
+        return this.http.deleteJson(uploadedFileDeleteUrl(this.baseUrl, params.agentBranchId, params.fileContextId, params.chatId), params.signal);
+    }
+}
+function toUploadBlob(file, contentType) {
+    const options = contentType === undefined ? undefined : { type: contentType };
+    if (file instanceof Blob) {
+        return contentType === undefined || file.type === contentType ? file : new Blob([file], options);
+    }
+    if (file instanceof ArrayBuffer) {
+        return new Blob([file], options);
+    }
+    const bytes = new Uint8Array(file.byteLength);
+    bytes.set(file);
+    return new Blob([bytes.buffer], options);
+}
+function compactBody(input) {
+    return Object.fromEntries(Object.entries(input).filter(([, value]) => value !== undefined));
+}
+function assertServerEnvironment() {
+    const globalObject = globalThis;
+    if (globalObject.window !== undefined && globalObject.document !== undefined) {
+        throw new Error("@skyforge-ai/sdk is server-only and cannot run in a browser.");
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,20 @@
+export interface SkyforgeApiErrorOptions {
+    method: string;
+    url: string;
+    status: number;
+    statusText: string;
+    requestId?: string;
+    responseBody?: unknown;
+    responseText?: string;
+}
+export declare class SkyforgeApiError extends Error {
+    readonly method: string;
+    readonly url: string;
+    readonly status: number;
+    readonly statusText: string;
+    readonly requestId?: string;
+    readonly responseBody?: unknown;
+    readonly responseText?: string;
+    constructor(message: string, options: SkyforgeApiErrorOptions);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;gBAEnB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB;CAW9D"}

package/dist/errors.js

@@ -0,0 +1,21 @@
+export class SkyforgeApiError extends Error {
+    method;
+    url;
+    status;
+    statusText;
+    requestId;
+    responseBody;
+    responseText;
+    constructor(message, options) {
+        super(message);
+        this.name = "SkyforgeApiError";
+        this.method = options.method;
+        this.url = options.url;
+        this.status = options.status;
+        this.statusText = options.statusText;
+        this.requestId = options.requestId;
+        this.responseBody = options.responseBody;
+        this.responseText = options.responseText;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAUA,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAChC,MAAM,CAAS;IACf,GAAG,CAAS;IACZ,MAAM,CAAS;IACf,UAAU,CAAS;IACnB,SAAS,CAAU;IACnB,YAAY,CAAW;IACvB,YAAY,CAAU;IAE/B,YAAY,OAAe,EAAE,OAAgC;QAC3D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;QACzC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAC3C,CAAC;CACF"}

package/dist/http.d.ts

@@ -0,0 +1,19 @@
+import type { SkyforgeFetch } from "./types.js";
+export interface HttpClientOptions {
+    apiKey: string;
+    fetch: SkyforgeFetch;
+}
+export declare class HttpClient {
+    private readonly apiKey;
+    private readonly fetchFn;
+    constructor(options: HttpClientOptions);
+    getJson<T>(url: string, signal?: AbortSignal): Promise<T>;
+    postJson<T>(url: string, body: unknown, signal?: AbortSignal): Promise<T>;
+    deleteJson<T>(url: string, signal?: AbortSignal): Promise<T>;
+    postForm<T>(url: string, body: FormData, signal?: AbortSignal): Promise<T>;
+    stream(url: string, signal?: AbortSignal): Promise<Response>;
+    private requestJson;
+    private authHeaders;
+}
+export declare function throwIfError(response: Response, method: string, url: string): Promise<void>;
+//# 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":"AACA,OAAO,KAAK,EAAE,aAAa,EAA2B,MAAM,YAAY,CAAC;AAEzE,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,aAAa,CAAC;CACtB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;gBAE5B,OAAO,EAAE,iBAAiB;IAKhC,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IAIzD,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IAIzE,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IAI5D,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IAU1E,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;YAUpD,WAAW;IAqBzB,OAAO,CAAC,WAAW;CAMpB;AAkBD,wBAAsB,YAAY,CAChC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/dist/http.js

@@ -0,0 +1,129 @@
+import { SkyforgeApiError } from "./errors.js";
+export class HttpClient {
+    apiKey;
+    fetchFn;
+    constructor(options) {
+        this.apiKey = options.apiKey;
+        this.fetchFn = options.fetch;
+    }
+    async getJson(url, signal) {
+        return this.requestJson("GET", url, undefined, signal);
+    }
+    async postJson(url, body, signal) {
+        return this.requestJson("POST", url, JSON.stringify(body), signal);
+    }
+    async deleteJson(url, signal) {
+        return this.requestJson("DELETE", url, undefined, signal);
+    }
+    async postForm(url, body, signal) {
+        const response = await this.fetchFn(url, {
+            method: "POST",
+            headers: this.authHeaders("application/json"),
+            body,
+            signal,
+        });
+        return parseJsonEnvelopeResponse(response, "POST", url);
+    }
+    async stream(url, signal) {
+        const response = await this.fetchFn(url, {
+            method: "GET",
+            headers: this.authHeaders("text/event-stream"),
+            signal,
+        });
+        await throwIfError(response, "GET", url);
+        return response;
+    }
+    async requestJson(method, url, body, signal) {
+        const headers = this.authHeaders("application/json");
+        if (body !== undefined) {
+            headers["Content-Type"] = "application/json";
+        }
+        const response = await this.fetchFn(url, {
+            method,
+            headers,
+            body,
+            signal,
+        });
+        return parseJsonEnvelopeResponse(response, method, url);
+    }
+    authHeaders(accept) {
+        return {
+            Authorization: `Bearer ${this.apiKey}`,
+            Accept: accept,
+        };
+    }
+}
+async function parseJsonEnvelopeResponse(response, method, url) {
+    const text = await response.text();
+    const parsed = parseJson(text);
+    if (!response.ok) {
+        throw apiErrorFromResponse(response, method, url, text, parsed);
+    }
+    const envelope = parsed;
+    return envelope?.data;
+}
+export async function throwIfError(response, method, url) {
+    if (response.ok) {
+        return;
+    }
+    const text = await response.text();
+    throw apiErrorFromResponse(response, method, url, text, parseJson(text));
+}
+function apiErrorFromResponse(response, method, url, responseText, responseBody) {
+    return new SkyforgeApiError(errorMessage(response, responseText, responseBody), {
+        method,
+        url,
+        status: response.status,
+        statusText: response.statusText,
+        requestId: requestId(response.headers),
+        responseBody,
+        responseText,
+    });
+}
+function parseJson(text) {
+    if (text.trim().length === 0) {
+        return undefined;
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return undefined;
+    }
+}
+function errorMessage(response, responseText, responseBody) {
+    if (isRecord(responseBody)) {
+        const message = stringField(responseBody, "message");
+        if (message !== undefined) {
+            return message;
+        }
+        const error = responseBody.error;
+        if (typeof error === "string") {
+            return error;
+        }
+        if (isRecord(error)) {
+            const nestedMessage = stringField(error, "message") ?? stringField(error, "error");
+            if (nestedMessage !== undefined) {
+                return nestedMessage;
+            }
+        }
+    }
+    if (responseText.trim().length > 0) {
+        return responseText;
+    }
+    return response.statusText || `Skyforge request failed with status ${response.status}`;
+}
+function requestId(headers) {
+    return (headers.get("x-request-id") ??
+        headers.get("x-skyforge-request-id") ??
+        headers.get("x-correlation-id") ??
+        undefined);
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function stringField(record, key) {
+    const value = record[key];
+    return typeof value === "string" ? value : undefined;
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { SkyforgeClient } from "./client.js";
+export { SkyforgeApiError } from "./errors.js";
+export { joinSkyforgeApiPath } from "./routes.js";
+export type { DeleteUploadedFileParams, GetAgentBranchStateParams, HumanActionRequestDto, JsonObject, JsonValue, ListUploadedFilesParams, SendMessageParams, SkyforgeAgentRunEventEnvelope, SkyforgeChatMessageDto, SkyforgeChatMessageResponse, SkyforgeChatStateResponse, SkyforgeChatUploadedFileContextDto, SkyforgeChatUploadedFileListResponse, SkyforgeChatUploadedFileUploadResponse, SkyforgeClientOptions, SkyforgeFetch, StreamAgentRunEventsParams, SubmitHumanActionParams, UploadFileParams, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,YAAY,EACV,wBAAwB,EACxB,yBAAyB,EACzB,qBAAqB,EACrB,UAAU,EACV,SAAS,EACT,uBAAuB,EACvB,iBAAiB,EACjB,6BAA6B,EAC7B,sBAAsB,EACtB,2BAA2B,EAC3B,yBAAyB,EACzB,kCAAkC,EAClC,oCAAoC,EACpC,sCAAsC,EACtC,qBAAqB,EACrB,aAAa,EACb,0BAA0B,EAC1B,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { SkyforgeClient } from "./client.js";
+export { SkyforgeApiError } from "./errors.js";
+export { joinSkyforgeApiPath } from "./routes.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}

package/dist/routes.d.ts

@@ -0,0 +1,8 @@
+export declare function joinSkyforgeApiPath(apiBaseUrl: string, path: string): string;
+export declare function chatStateUrl(apiBaseUrl: string, agentBranchId: string, chatId?: string): string;
+export declare function sendMessageUrl(apiBaseUrl: string, agentBranchId: string): string;
+export declare function humanActionSubmitUrl(apiBaseUrl: string, humanActionRequestId: string): string;
+export declare function runEventStreamUrl(apiBaseUrl: string, agentRunId: string, afterSequence?: number): string;
+export declare function uploadedFilesUrl(apiBaseUrl: string, agentBranchId: string, chatId?: string): string;
+export declare function uploadedFileDeleteUrl(apiBaseUrl: string, agentBranchId: string, fileContextId: string, chatId: string): string;
+//# sourceMappingURL=routes.d.ts.map

package/dist/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAIA,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAa5E;AAUD,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAQR;AAED,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAKhF;AAED,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,oBAAoB,EAAE,MAAM,GAC3B,MAAM,CAKR;AAED,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,aAAa,CAAC,EAAE,MAAM,GACrB,MAAM,CAQR;AAED,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAQR;AAED,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,GACb,MAAM,CAQR"}

package/dist/routes.js

@@ -0,0 +1,41 @@
+function normalizePath(path) {
+    return path.startsWith("/") ? path : `/${path}`;
+}
+export function joinSkyforgeApiPath(apiBaseUrl, path) {
+    const base = apiBaseUrl.replace(/\/+$/, "");
+    let normalizedPath = normalizePath(path);
+    if (base.endsWith("/api")) {
+        if (normalizedPath.startsWith("/api/")) {
+            normalizedPath = normalizedPath.slice("/api".length);
+        }
+        else if (normalizedPath === "/api") {
+            normalizedPath = "";
+        }
+    }
+    return base.length === 0 ? normalizedPath : `${base}${normalizedPath}`;
+}
+function appendQuery(url, query) {
+    const parts = Object.entries(query)
+        .filter(([, value]) => value !== undefined)
+        .map(([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`);
+    return parts.length === 0 ? url : `${url}?${parts.join("&")}`;
+}
+export function chatStateUrl(apiBaseUrl, agentBranchId, chatId) {
+    return appendQuery(joinSkyforgeApiPath(apiBaseUrl, `/api/skyforge-chat/agent_branches/${encodeURIComponent(agentBranchId)}/state`), { chat_id: chatId });
+}
+export function sendMessageUrl(apiBaseUrl, agentBranchId) {
+    return joinSkyforgeApiPath(apiBaseUrl, `/api/skyforge-chat/agent_branches/${encodeURIComponent(agentBranchId)}/messages`);
+}
+export function humanActionSubmitUrl(apiBaseUrl, humanActionRequestId) {
+    return joinSkyforgeApiPath(apiBaseUrl, `/api/skyforge-chat/human-actions/${encodeURIComponent(humanActionRequestId)}/submit`);
+}
+export function runEventStreamUrl(apiBaseUrl, agentRunId, afterSequence) {
+    return appendQuery(joinSkyforgeApiPath(apiBaseUrl, `/api/skyforge-chat/agent_runs/${encodeURIComponent(agentRunId)}/events`), { after_sequence: afterSequence });
+}
+export function uploadedFilesUrl(apiBaseUrl, agentBranchId, chatId) {
+    return appendQuery(joinSkyforgeApiPath(apiBaseUrl, `/api/skyforge-chat/agent_branches/${encodeURIComponent(agentBranchId)}/uploaded-files`), { chat_id: chatId });
+}
+export function uploadedFileDeleteUrl(apiBaseUrl, agentBranchId, fileContextId, chatId) {
+    return appendQuery(joinSkyforgeApiPath(apiBaseUrl, `/api/skyforge-chat/agent_branches/${encodeURIComponent(agentBranchId)}/uploaded-files/${encodeURIComponent(fileContextId)}`), { chat_id: chatId });
+}
+//# sourceMappingURL=routes.js.map

package/dist/routes.js.map

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

package/dist/sse.d.ts

@@ -0,0 +1,3 @@
+import type { SkyforgeAgentRunEventEnvelope } from "./types.js";
+export declare function parseSkyforgeEventStream(body: ReadableStream<Uint8Array> | null): AsyncIterable<SkyforgeAgentRunEventEnvelope>;
+//# sourceMappingURL=sse.d.ts.map

package/dist/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../src/sse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAEhE,wBAAuB,wBAAwB,CAC7C,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,GACtC,aAAa,CAAC,6BAA6B,CAAC,CA2C9C"}

package/dist/sse.js

@@ -0,0 +1,57 @@
+export async function* parseSkyforgeEventStream(body) {
+    if (body === null) {
+        return;
+    }
+    const reader = body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    let streamCompleted = false;
+    try {
+        while (true) {
+            const { value, done } = await reader.read();
+            if (done) {
+                streamCompleted = true;
+                break;
+            }
+            buffer += decoder.decode(value, { stream: true });
+            const events = drainEvents(buffer);
+            buffer = events.remainder;
+            for (const event of events.blocks) {
+                const parsed = parseEventBlock(event);
+                if (parsed !== undefined) {
+                    yield parsed;
+                }
+            }
+        }
+        buffer += decoder.decode();
+        if (buffer.trim().length > 0) {
+            const parsed = parseEventBlock(buffer);
+            if (parsed !== undefined) {
+                yield parsed;
+            }
+        }
+    }
+    finally {
+        if (!streamCompleted) {
+            await reader.cancel().catch(() => undefined);
+        }
+        reader.releaseLock();
+    }
+}
+function drainEvents(buffer) {
+    const normalized = buffer.replace(/\r\n/g, "\n");
+    const parts = normalized.split("\n\n");
+    const remainder = parts.pop() ?? "";
+    return { blocks: parts, remainder };
+}
+function parseEventBlock(block) {
+    const dataLines = block
+        .split("\n")
+        .filter((line) => line.startsWith("data:"))
+        .map((line) => line.slice("data:".length).trimStart());
+    if (dataLines.length === 0) {
+        return undefined;
+    }
+    return JSON.parse(dataLines.join("\n"));
+}
+//# sourceMappingURL=sse.js.map

package/dist/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../src/sse.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,wBAAwB,CAC7C,IAAuC;IAEvC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;IAChC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,eAAe,GAAG,KAAK,CAAC;IAE5B,IAAI,CAAC;QACH,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5C,IAAI,IAAI,EAAE,CAAC;gBACT,eAAe,GAAG,IAAI,CAAC;gBACvB,MAAM;YACR,CAAC;YAED,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YAClD,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;YACnC,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC;YAE1B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAClC,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;gBACtC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;oBACzB,MAAM,MAAM,CAAC;gBACf,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QAC3B,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;YACvC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,MAAM,MAAM,CAAC;YACf,CAAC;QACH,CAAC;IACH,CAAC;YAAS,CAAC;QACT,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC/C,CAAC;QACD,MAAM,CAAC,WAAW,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,MAAc;IACjC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;IACpC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AACtC,CAAC;AAED,SAAS,eAAe,CAAC,KAAa;IACpC,MAAM,SAAS,GAAG,KAAK;SACpB,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;SAC1C,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;IAEzD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAkC,CAAC;AAC3E,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,160 @@
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
+export interface JsonObject {
+    [key: string]: JsonValue;
+}
+export interface SkyforgeClientOptions {
+    apiKey: string;
+    baseUrl?: string;
+    fetch?: SkyforgeFetch;
+}
+export type SkyforgeFetch = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
+export interface RequestOptions {
+    signal?: AbortSignal;
+}
+export interface GetAgentBranchStateParams extends RequestOptions {
+    agentBranchId: string;
+    chatId?: string;
+}
+export interface SkyforgeChatRetrievalScopeRequest {
+    context_ids?: string[];
+    context_release_ids?: string[];
+}
+export interface SendMessageParams extends RequestOptions {
+    agentBranchId: string;
+    message: string;
+    chatId?: string;
+    retriedFromAgentRunId?: string;
+    sourceUserMessageId?: string;
+    structuredContext?: JsonObject;
+    retrievalScope?: SkyforgeChatRetrievalScopeRequest;
+}
+export interface StreamAgentRunEventsParams extends RequestOptions {
+    agentRunId: string;
+    afterSequence?: number;
+}
+export interface SubmitHumanActionParams extends RequestOptions {
+    humanActionRequestId: string;
+    values: JsonValue;
+}
+export interface ListUploadedFilesParams extends RequestOptions {
+    agentBranchId: string;
+    chatId: string;
+}
+export type UploadFileBody = Blob | ArrayBuffer | Uint8Array;
+export interface UploadFileParams extends RequestOptions {
+    agentBranchId: string;
+    chatId?: string;
+    file: UploadFileBody;
+    filename: string;
+    contentType?: string;
+}
+export interface DeleteUploadedFileParams extends RequestOptions {
+    agentBranchId: string;
+    fileContextId: string;
+    chatId: string;
+}
+export interface SkyforgeSuccessResponse<T> {
+    message: string;
+    data?: T | null;
+}
+export type AgentRuntimeMode = "turn_based" | "run_based" | string;
+export type SkyforgeChatMessageRole = "assistant" | "user" | "system" | "tool" | "error" | string;
+export interface SkyforgeChatMessageDto {
+    id: string;
+    role: SkyforgeChatMessageRole;
+    content: string;
+    relevant_chunks?: string | null;
+    external_tool_call_id?: string | null;
+    group_id?: string | null;
+    is_displayable?: boolean;
+    agent_run_id?: string | null;
+    [key: string]: unknown;
+}
+export interface HumanActionRequestDto {
+    id: string;
+    kind?: string;
+    agent_run_id?: string;
+    chat_id?: string;
+    source_agent_run_id?: string;
+    source_chat_id?: string;
+    visible_chat_id?: string | null;
+    waiting_parent_agent_run_id?: string | null;
+    source_agent_name?: string | null;
+    source_agent_branch_name?: string | null;
+    is_bubbled?: boolean;
+    tool_call_id: string;
+    tool_name: string;
+    tool_arguments?: JsonValue;
+    bubbled_parent_tool_call_metadata?: JsonValue | null;
+    title?: string | null;
+    description?: string | null;
+    submit_label?: string | null;
+    form_schema: JsonValue;
+    status: string;
+    created_at: string;
+    [key: string]: unknown;
+}
+export interface SkyforgeChatStateResponse {
+    agent_branch_id: string;
+    runtime_mode: AgentRuntimeMode;
+    chat_id?: string | null;
+    can_send_messages: boolean;
+    start_message?: string | null;
+    messages: SkyforgeChatMessageDto[];
+    latest_agent_run_id?: string | null;
+    agent_title?: string | null;
+    agent_subtitle?: string | null;
+    pending_human_actions?: HumanActionRequestDto[];
+    [key: string]: unknown;
+}
+export interface SkyforgeChatMessageResponse {
+    runtime_mode: AgentRuntimeMode;
+    chat_id: string;
+    chat_title?: string | null;
+    agent_run_id?: string | null;
+    source_user_message_id?: string | null;
+    retried_from_agent_run_id?: string | null;
+    messages: SkyforgeChatMessageDto[];
+    pending_human_actions?: HumanActionRequestDto[];
+    terminal: boolean;
+    [key: string]: unknown;
+}
+export interface SkyforgeChatUploadedFileContextDto {
+    id: string;
+    chat_id: string;
+    agent_branch_id: string;
+    filename: string;
+    content_type?: string | null;
+    file_size_bytes: number;
+    file_type: string;
+    extracted_char_count: number;
+    status: string;
+    prompt_char_count?: number | null;
+    prompt_truncated?: boolean;
+    created_at: string;
+    expires_at: string;
+    [key: string]: unknown;
+}
+export interface SkyforgeChatUploadedFileListResponse {
+    files: SkyforgeChatUploadedFileContextDto[];
+}
+export interface SkyforgeChatUploadedFileUploadResponse {
+    chat_id: string;
+    file: SkyforgeChatUploadedFileContextDto;
+    preview_text?: string | null;
+}
+export interface SkyforgeAgentRunEventStep {
+    id: string;
+    name: string;
+}
+export interface SkyforgeAgentRunEventEnvelope {
+    event_id: string;
+    agent_run_id: string;
+    sequence: number;
+    occurred_at: string;
+    step?: SkyforgeAgentRunEventStep | null;
+    event: JsonObject;
+    [key: string]: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@runmark/sdk",
+  "version": "0.1.0",
+  "description": "Server-side SDK for agent chat routes.",
+  "type": "module",
+  "license": "MIT",
+  "private": false,
+  "engines": {
+    "node": ">=24.17.0"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "npm run build && node --test test/*.test.mjs",
+    "test:live": "npm run build && node --test test/live/*.live.test.mjs",
+    "test:live:hitl-bubbling-demo": "node test/live/run-hitl-bubbling-demo.mjs"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^5.7.2"
+  }
+}