@intfunc/sdk 0.0.0

package/README.md

@@ -0,0 +1,169 @@
+# @intfunc/sdk
+
+Official TypeScript client for the **Intelligent Functions** API. An intelligent
+function is a stateless, versioned function backed by a single LLM call: you give
+it a typed input, it returns a typed, schema-validated output.
+
+```ts
+const summarize = client.fn<{ text: string }, { summary: string }>("blog/summarize");
+const { summary } = await summarize({ text: article });
+```
+
+## Install
+
+```sh
+npm install @intfunc/sdk
+```
+
+Requires a runtime with a global `fetch` (Node 18+, Bun, Deno, Cloudflare
+Workers, or the browser). To use a custom implementation, pass `options.fetch`.
+
+## Quickstart
+
+```ts
+import { IntelligentFunctions } from "@intfunc/sdk";
+
+// Reads INTFUNC_API_KEY (and optional INTFUNC_BASE_URL) from the environment.
+const client = new IntelligentFunctions();
+
+// Bind a "projectSlug/functionSlug" key to a reusable, typed handle.
+const sentiment = client.fn<{ text: string }, { label: string; score: number }>(
+  "blog/sentiment",
+);
+
+// Call it like a local async function — you get just the output.
+const { label, score } = await sentiment({ text: "I love this!" });
+```
+
+The `fn()` handle is the recommended way to call functions: define it once, then
+invoke it anywhere. Provide the input/output type parameters and every call site
+is fully typed.
+
+## Configuration
+
+`new IntelligentFunctions(options?)` — every option is optional and falls back to
+an environment variable or a default.
+
+| Option       | Env var             | Default                    | Description                                        |
+| ------------ | ------------------- | -------------------------- | -------------------------------------------------- |
+| `apiKey`     | `INTFUNC_API_KEY`   | —                          | Project API key issued from the console.           |
+| `baseUrl`    | `INTFUNC_BASE_URL`  | `https://api.intfunc.com`  | API base URL.                                      |
+| `timeout`    | —                   | `120000` (ms)              | Per-request timeout; aborts and retries if exceeded. |
+| `maxRetries` | —                   | `2`                        | Retries on network errors, 408, 429, and 5xx.      |
+| `fetch`      | —                   | `globalThis.fetch`         | Custom fetch implementation.                       |
+
+```ts
+const client = new IntelligentFunctions({
+  apiKey: "sk_...",
+  timeout: 60_000,
+  maxRetries: 3,
+});
+```
+
+An API key is scoped to a single project, so a handle can only invoke functions
+in that key's own project — a mismatched `projectSlug` returns
+`FunctionNotFoundError`.
+
+## Calling functions
+
+### Handles (recommended)
+
+```ts
+const classify = client.fn<{ text: string }, { category: string }>("support/classify");
+
+await classify({ text });            // -> { category }            (just the output)
+await classify.run({ text });        // -> { output, provider, model, version, usage, runId }
+const v3 = classify.pin(3);          // a handle locked to version 3
+await v3({ text });                  // always runs version 3
+```
+
+- **`handle(input, options?)`** — returns the output only. The 90% case.
+- **`handle.run(input, options?)`** — returns the full envelope with token
+  `usage`, the resolved `version`, and the captured dataset `runId`.
+- **`handle.pin(version)`** — a new handle bound to a fixed version. Without a
+  pin, calls always use the latest published version.
+
+Per-call `options`:
+
+```ts
+const controller = new AbortController();
+await classify({ text }, {
+  version: 2,               // one-off version override
+  timeout: 30_000,          // override the client timeout for this call
+  signal: controller.signal // cancel in flight
+});
+```
+
+### Direct method
+
+If you prefer not to bind a handle:
+
+```ts
+const result = await client.runFunction<{ category: string }>(
+  "support", "classify", { text }, { version: 2 },
+);
+result.output; // { category }
+```
+
+## Errors
+
+Every non-2xx response throws an `ApiError`, or a subclass you can branch on
+without inspecting `.status`:
+
+```ts
+import {
+  InputValidationError, // 400 — input didn't match the function's schema
+  AuthError,            // 401 — missing/invalid/revoked API key
+  FunctionNotFoundError,// 404 — no such function (or wrong project)
+  FunctionRunError,     // 502 — the model call failed / produced no valid output
+  ApiError,             // base — any other status
+} from "@intfunc/sdk";
+
+try {
+  await sentiment({ text });
+} catch (err) {
+  if (err instanceof InputValidationError) {
+    // fix the input
+  } else if (err instanceof FunctionRunError) {
+    // transient model failure — surface or retry manually
+  } else if (err instanceof ApiError) {
+    console.error(err.status, err.message, err.body);
+  }
+}
+```
+
+## Retries & timeouts
+
+Requests are retried automatically with exponential backoff (plus jitter, and
+honoring a `Retry-After` header) on network errors, timeouts, `408`, `429`, and
+`5xx` responses — up to `maxRetries` times. A caller-initiated `AbortSignal` is
+never retried. Set `maxRetries: 0` to disable.
+
+## Managing functions
+
+```ts
+await client.listFunctions({ project: "blog" });
+await client.getFunction("blog", "summarize", { version: 2 });
+await client.createFunction({
+  projectId: "prj_...",
+  name: "Summarize",
+  provider: "anthropic",
+  model: "claude-sonnet-5",
+  prompt: "Summarize the input article in one sentence.",
+  inputSchema: { type: "object", properties: { text: { type: "string" } }, required: ["text"] },
+  outputSchema: { type: "object", properties: { summary: { type: "string" } }, required: ["summary"] },
+});
+```
+
+Creating a function with an existing `slug` publishes the next **version** of it.
+
+## API reference
+
+| Member                                            | Returns                    |
+| ------------------------------------------------- | -------------------------- |
+| `fn<In, Out>(key, { version? })`                  | `FunctionHandle<In, Out>`  |
+| `runFunction<T>(project, fn, input, options?)`    | `RunIFunctionResult<T>`    |
+| `getFunction(project, fn, { version? })`          | `IFunction`                |
+| `listFunctions({ project? })`                     | `IFunction[]`              |
+| `createFunction(input)`                           | `IFunction`                |
+| `health()`                                        | `{ status: string }`       |

package/dist/client.d.ts

@@ -0,0 +1,149 @@
+export interface ClientOptions {
+    /**
+     * Base URL of the API, e.g. https://api.intfunc.com.
+     * Falls back to `INTFUNC_BASE_URL`, then the hosted default.
+     */
+    baseUrl?: string;
+    /** API key issued from the console. Falls back to `INTFUNC_API_KEY`. */
+    apiKey?: string;
+    /**
+     * Per-request timeout in milliseconds (default 120_000). The request is
+     * aborted and — if retries remain — retried when it exceeds this.
+     */
+    timeout?: number;
+    /**
+     * How many times to retry a failed request (default 2). Retries apply to
+     * network errors, timeouts, 408, 429, and 5xx responses, with backoff.
+     */
+    maxRetries?: number;
+    /** Optional custom fetch implementation (defaults to global fetch). */
+    fetch?: typeof fetch;
+}
+/** Per-call overrides for a function invocation. */
+export interface RunOptions {
+    /** Pin to a specific function version (defaults to latest). */
+    version?: number;
+    /** Abort the call early. Composes with the client-level timeout. */
+    signal?: AbortSignal;
+    /** Override the client-level timeout for this call, in milliseconds. */
+    timeout?: number;
+}
+export interface User {
+    id: string;
+    email: string;
+    name: string | null;
+    createdAt: string;
+}
+/** An intelligent function: a stateless function backed by a single LLM call. */
+export interface IFunction {
+    id: string;
+    userId: string;
+    projectId: string;
+    slug: string;
+    name: string | null;
+    provider: string;
+    model: string;
+    prompt: string;
+    inputSchema: Record<string, unknown>;
+    outputSchema: Record<string, unknown>;
+    version: number;
+    createdAt: string;
+}
+export interface CreateIFunctionInput {
+    /** The project this function belongs to. */
+    projectId: string;
+    /** Optional; when omitted the slug is derived from `name` server-side. */
+    slug?: string;
+    name?: string;
+    provider: string;
+    model: string;
+    prompt: string;
+    inputSchema: Record<string, unknown>;
+    outputSchema: Record<string, unknown>;
+}
+export interface RunIFunctionResult<T = unknown> {
+    output: T;
+    provider: string;
+    model: string;
+    version: number;
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+    /** Id of the captured dataset row for this run (when capture is enabled). */
+    runId?: string;
+}
+/**
+ * A reusable, typed reference to a single function. Call it like a function to
+ * get just the output; call `.run()` for the full result envelope.
+ *
+ * @example
+ * const sentiment = client.fn<{ text: string }, { label: string }>("blog/sentiment");
+ * const { label } = await sentiment({ text: "great post" });   // just the output
+ * const full = await sentiment.run({ text: "great post" });    // + usage, version, runId
+ * const v3 = sentiment.pin(3);                                 // handle locked to version 3
+ */
+export interface FunctionHandle<In extends Record<string, unknown>, Out> {
+    (input: In, options?: RunOptions): Promise<Out>;
+    /** Invoke and return the full result envelope (output + metadata). */
+    run(input: In, options?: RunOptions): Promise<RunIFunctionResult<Out>>;
+    /** A new handle to the same function, pinned to `version`. */
+    pin(version: number): FunctionHandle<In, Out>;
+    /** The `projectSlug/functionSlug` key this handle points at. */
+    readonly key: string;
+    readonly projectSlug: string;
+    readonly functionSlug: string;
+    /** The pinned version, or `undefined` for "latest". */
+    readonly version: number | undefined;
+}
+/**
+ * Official client for the IntelligentFunctions API.
+ *
+ * @example
+ * // Reads INTFUNC_API_KEY / INTFUNC_BASE_URL from the environment.
+ * const client = new IntelligentFunctions();
+ *
+ * const summarize = client.fn<{ text: string }, { summary: string }>("blog/summarize");
+ * const { summary } = await summarize({ text: article });
+ */
+export declare class IntelligentFunctions {
+    private readonly baseUrl;
+    private readonly apiKey?;
+    private readonly timeout;
+    private readonly maxRetries;
+    private readonly fetchImpl;
+    constructor(options?: ClientOptions);
+    /**
+     * Bind a `projectSlug/functionSlug` key to a reusable, typed handle. This is
+     * the recommended way to call a function: define the handle once, then invoke
+     * it like a local async function.
+     */
+    fn<In extends Record<string, unknown> = Record<string, unknown>, Out = unknown>(key: string, options?: {
+        version?: number;
+    }): FunctionHandle<In, Out>;
+    health(): Promise<{
+        status: string;
+    }>;
+    listUsers(): Promise<User[]>;
+    /** Create a function, or a new version of an existing one (same project + slug). */
+    createFunction(input: CreateIFunctionInput): Promise<IFunction>;
+    /** List functions, optionally filtered to a single project by slug. */
+    listFunctions(options?: {
+        project?: string;
+    }): Promise<IFunction[]>;
+    /**
+     * Fetch a function by its `{projectSlug}/{functionSlug}` key (latest version,
+     * or a pinned `version`).
+     */
+    getFunction(projectSlug: string, functionSlug: string, options?: {
+        version?: number;
+    }): Promise<IFunction>;
+    /**
+     * Run a function against a real input and return its structured output plus
+     * metadata. For a terser call site, prefer {@link fn} handles.
+     */
+    runFunction<T = unknown>(projectSlug: string, functionSlug: string, input: Record<string, unknown>, options?: RunOptions): Promise<RunIFunctionResult<T>>;
+    private request;
+}
+export { ApiError, AuthError, FunctionNotFoundError, InputValidationError, FunctionRunError, } from "./errors.js";
+//# 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":"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"}

package/dist/client.js

@@ -0,0 +1,198 @@
+import { errorFromResponse } from "./errors.js";
+const DEFAULT_BASE_URL = "https://api.intfunc.com";
+const DEFAULT_TIMEOUT_MS = 120_000;
+const DEFAULT_MAX_RETRIES = 2;
+/**
+ * Official client for the IntelligentFunctions API.
+ *
+ * @example
+ * // Reads INTFUNC_API_KEY / INTFUNC_BASE_URL from the environment.
+ * const client = new IntelligentFunctions();
+ *
+ * const summarize = client.fn<{ text: string }, { summary: string }>("blog/summarize");
+ * const { summary } = await summarize({ text: article });
+ */
+export class IntelligentFunctions {
+    baseUrl;
+    apiKey;
+    timeout;
+    maxRetries;
+    fetchImpl;
+    constructor(options = {}) {
+        const env = readEnv();
+        this.baseUrl = (options.baseUrl ?? env.INTFUNC_BASE_URL ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+        this.apiKey = options.apiKey ?? env.INTFUNC_API_KEY;
+        this.timeout = options.timeout ?? DEFAULT_TIMEOUT_MS;
+        this.maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
+        this.fetchImpl = options.fetch ?? globalThis.fetch;
+        if (!this.fetchImpl) {
+            throw new Error("No fetch implementation available; pass options.fetch.");
+        }
+    }
+    /**
+     * Bind a `projectSlug/functionSlug` key to a reusable, typed handle. This is
+     * the recommended way to call a function: define the handle once, then invoke
+     * it like a local async function.
+     */
+    fn(key, options) {
+        const { projectSlug, functionSlug } = parseKey(key);
+        const pinned = options?.version;
+        const run = (input, opts) => this.runFunction(projectSlug, functionSlug, input, { version: pinned, ...opts });
+        const handle = ((input, opts) => run(input, opts).then((r) => r.output));
+        handle.run = run;
+        handle.pin = (version) => this.fn(key, { version });
+        Object.defineProperties(handle, {
+            key: { value: key, enumerable: true },
+            projectSlug: { value: projectSlug, enumerable: true },
+            functionSlug: { value: functionSlug, enumerable: true },
+            version: { value: pinned, enumerable: true },
+        });
+        return handle;
+    }
+    async health() {
+        return this.request("GET", "/health");
+    }
+    async listUsers() {
+        return this.request("GET", "/v1/users");
+    }
+    /** Create a function, or a new version of an existing one (same project + slug). */
+    async createFunction(input) {
+        return this.request("POST", "/v1/functions", { body: input });
+    }
+    /** List functions, optionally filtered to a single project by slug. */
+    async listFunctions(options) {
+        const query = options?.project ? `?project=${encodeURIComponent(options.project)}` : "";
+        return this.request("GET", `/v1/functions${query}`);
+    }
+    /**
+     * Fetch a function by its `{projectSlug}/{functionSlug}` key (latest version,
+     * or a pinned `version`).
+     */
+    async getFunction(projectSlug, functionSlug, options) {
+        return this.request("GET", `${functionPath(projectSlug, functionSlug)}${versionQuery(options?.version)}`);
+    }
+    /**
+     * Run a function against a real input and return its structured output plus
+     * metadata. For a terser call site, prefer {@link fn} handles.
+     */
+    async runFunction(projectSlug, functionSlug, input, options) {
+        return this.request("POST", `${functionPath(projectSlug, functionSlug)}/run${versionQuery(options?.version)}`, { body: { input }, signal: options?.signal, timeout: options?.timeout });
+    }
+    async request(method, path, opts = {}) {
+        const { body, signal } = opts;
+        const timeout = opts.timeout ?? this.timeout;
+        const url = `${this.baseUrl}${path}`;
+        const headers = { accept: "application/json" };
+        if (this.apiKey)
+            headers["authorization"] = `Bearer ${this.apiKey}`;
+        if (body !== undefined)
+            headers["content-type"] = "application/json";
+        const payload = body !== undefined ? JSON.stringify(body) : undefined;
+        for (let attempt = 0;; attempt++) {
+            const { controller, cleanup } = linkAbort(signal, timeout);
+            let res;
+            try {
+                res = await this.fetchImpl(url, { method, headers, body: payload, signal: controller.signal });
+            }
+            catch (err) {
+                cleanup();
+                // A user-initiated abort is final; never retry or reshape it.
+                if (signal?.aborted)
+                    throw err;
+                if (attempt < this.maxRetries) {
+                    await sleep(backoffMs(attempt));
+                    continue;
+                }
+                throw err;
+            }
+            cleanup();
+            if (!res.ok) {
+                if (isRetriable(res.status) && attempt < this.maxRetries) {
+                    await res.body?.cancel().catch(() => { });
+                    await sleep(retryAfterMs(res) ?? backoffMs(attempt));
+                    continue;
+                }
+                const data = await readBody(res);
+                throw errorFromResponse(res.status, extractError(data, res.status), data);
+            }
+            return (await readBody(res));
+        }
+    }
+}
+// Re-export the error surface so `import { ApiError } from "@intfunc/sdk"` works.
+export { ApiError, AuthError, FunctionNotFoundError, InputValidationError, FunctionRunError, } from "./errors.js";
+function functionPath(projectSlug, functionSlug) {
+    return `/v1/functions/${encodeURIComponent(projectSlug)}/${encodeURIComponent(functionSlug)}`;
+}
+function versionQuery(version) {
+    return version !== undefined ? `?version=${version}` : "";
+}
+function parseKey(key) {
+    const parts = key.split("/");
+    if (parts.length !== 2 || !parts[0] || !parts[1]) {
+        throw new Error(`Invalid function key "${key}"; expected "projectSlug/functionSlug".`);
+    }
+    return { projectSlug: parts[0], functionSlug: parts[1] };
+}
+/** Wire a per-request timeout and an optional caller signal into one controller. */
+function linkAbort(signal, timeout) {
+    const controller = new AbortController();
+    const timer = timeout > 0
+        ? setTimeout(() => controller.abort(new DOMException("Request timed out", "TimeoutError")), timeout)
+        : undefined;
+    const onAbort = () => controller.abort(signal?.reason);
+    if (signal) {
+        if (signal.aborted)
+            controller.abort(signal.reason);
+        else
+            signal.addEventListener("abort", onAbort, { once: true });
+    }
+    return {
+        controller,
+        cleanup: () => {
+            if (timer)
+                clearTimeout(timer);
+            signal?.removeEventListener("abort", onAbort);
+        },
+    };
+}
+function isRetriable(status) {
+    return status === 408 || status === 429 || status >= 500;
+}
+/** Exponential backoff with jitter: ~0.5s, 1s, 2s, … capped at 8s. */
+function backoffMs(attempt) {
+    const base = Math.min(8_000, 500 * 2 ** attempt);
+    return base + Math.random() * 250;
+}
+function retryAfterMs(res) {
+    const header = res.headers.get("retry-after");
+    if (!header)
+        return undefined;
+    const seconds = Number(header);
+    return Number.isFinite(seconds) ? seconds * 1_000 : undefined;
+}
+function extractError(data, status) {
+    if (data && typeof data === "object" && "error" in data) {
+        return String(data.error);
+    }
+    return `Request failed with status ${status}`;
+}
+async function readBody(res) {
+    const text = await res.text();
+    return text ? safeJsonParse(text) : undefined;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function readEnv() {
+    return globalThis.process?.env ?? {};
+}
+function safeJsonParse(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+//# 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,46 @@
+/**
+ * Error hierarchy for the IntelligentFunctions API.
+ *
+ * Every failed request throws an {@link ApiError} (or a subclass). Catch the
+ * subclass to branch on the failure kind without inspecting `.status`:
+ *
+ * @example
+ * try {
+ *   await sentiment({ text });
+ * } catch (err) {
+ *   if (err instanceof InputValidationError) { ... }   // 400
+ *   else if (err instanceof AuthError) { ... }         // 401
+ *   else if (err instanceof FunctionNotFoundError) { ... } // 404
+ *   else if (err instanceof FunctionRunError) { ... }  // 502 (model failed)
+ * }
+ */
+export declare class ApiError extends Error {
+    /** HTTP status code returned by the API. */
+    readonly status: number;
+    /** Parsed response body, when the server returned one. */
+    readonly body?: unknown;
+    constructor(
+    /** HTTP status code returned by the API. */
+    status: number, message: string, 
+    /** Parsed response body, when the server returned one. */
+    body?: unknown);
+}
+/** 401 — the API key was missing, invalid, or revoked. */
+export declare class AuthError extends ApiError {
+    constructor(message: string, body?: unknown);
+}
+/** 404 — no such function, or it belongs to another project. */
+export declare class FunctionNotFoundError extends ApiError {
+    constructor(message: string, body?: unknown);
+}
+/** 400 — the input did not satisfy the function's input schema. */
+export declare class InputValidationError extends ApiError {
+    constructor(message: string, body?: unknown);
+}
+/** 502 — the underlying model call failed or produced no valid output. */
+export declare class FunctionRunError extends ApiError {
+    constructor(message: string, body?: unknown);
+}
+/** Map an HTTP status to the most specific error class available. */
+export declare function errorFromResponse(status: number, message: string, body?: unknown): ApiError;
+//# 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;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,QAAS,SAAQ,KAAK;IAE/B,4CAA4C;aAC5B,MAAM,EAAE,MAAM;IAE9B,0DAA0D;aAC1C,IAAI,CAAC,EAAE,OAAO;IALhC;IACE,4CAA4C;IAC5B,MAAM,EAAE,MAAM,EAC9B,OAAO,EAAE,MAAM;IACf,0DAA0D;IAC1C,IAAI,CAAC,EAAE,OAAO,EAI/B;CACF;AAED,0DAA0D;AAC1D,qBAAa,SAAU,SAAQ,QAAQ;IACrC,YAAY,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAG1C;CACF;AAED,gEAAgE;AAChE,qBAAa,qBAAsB,SAAQ,QAAQ;IACjD,YAAY,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAG1C;CACF;AAED,mEAAmE;AACnE,qBAAa,oBAAqB,SAAQ,QAAQ;IAChD,YAAY,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAG1C;CACF;AAED,0EAA0E;AAC1E,qBAAa,gBAAiB,SAAQ,QAAQ;IAC5C,YAAY,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAG1C;CACF;AAED,qEAAqE;AACrE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,CAa3F"}

package/dist/errors.js

@@ -0,0 +1,74 @@
+/**
+ * Error hierarchy for the IntelligentFunctions API.
+ *
+ * Every failed request throws an {@link ApiError} (or a subclass). Catch the
+ * subclass to branch on the failure kind without inspecting `.status`:
+ *
+ * @example
+ * try {
+ *   await sentiment({ text });
+ * } catch (err) {
+ *   if (err instanceof InputValidationError) { ... }   // 400
+ *   else if (err instanceof AuthError) { ... }         // 401
+ *   else if (err instanceof FunctionNotFoundError) { ... } // 404
+ *   else if (err instanceof FunctionRunError) { ... }  // 502 (model failed)
+ * }
+ */
+export class ApiError extends Error {
+    status;
+    body;
+    constructor(
+    /** HTTP status code returned by the API. */
+    status, message, 
+    /** Parsed response body, when the server returned one. */
+    body) {
+        super(message);
+        this.status = status;
+        this.body = body;
+        this.name = "ApiError";
+    }
+}
+/** 401 — the API key was missing, invalid, or revoked. */
+export class AuthError extends ApiError {
+    constructor(message, body) {
+        super(401, message, body);
+        this.name = "AuthError";
+    }
+}
+/** 404 — no such function, or it belongs to another project. */
+export class FunctionNotFoundError extends ApiError {
+    constructor(message, body) {
+        super(404, message, body);
+        this.name = "FunctionNotFoundError";
+    }
+}
+/** 400 — the input did not satisfy the function's input schema. */
+export class InputValidationError extends ApiError {
+    constructor(message, body) {
+        super(400, message, body);
+        this.name = "InputValidationError";
+    }
+}
+/** 502 — the underlying model call failed or produced no valid output. */
+export class FunctionRunError extends ApiError {
+    constructor(message, body) {
+        super(502, message, body);
+        this.name = "FunctionRunError";
+    }
+}
+/** Map an HTTP status to the most specific error class available. */
+export function errorFromResponse(status, message, body) {
+    switch (status) {
+        case 400:
+            return new InputValidationError(message, body);
+        case 401:
+            return new AuthError(message, body);
+        case 404:
+            return new FunctionNotFoundError(message, body);
+        case 502:
+            return new FunctionRunError(message, body);
+        default:
+            return new ApiError(status, message, body);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IAGf,MAAM;IAGN,IAAI;IALtB;IACE,4CAA4C;IAC5B,MAAc,EAC9B,OAAe;IACf,0DAA0D;IAC1C,IAAc;QAE9B,KAAK,CAAC,OAAO,CAAC,CAAC;sBALC,MAAM;oBAGN,IAAI;QAGpB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAED,0DAA0D;AAC1D,MAAM,OAAO,SAAU,SAAQ,QAAQ;IACrC,YAAY,OAAe,EAAE,IAAc;QACzC,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AAED,gEAAgE;AAChE,MAAM,OAAO,qBAAsB,SAAQ,QAAQ;IACjD,YAAY,OAAe,EAAE,IAAc;QACzC,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED,mEAAmE;AACnE,MAAM,OAAO,oBAAqB,SAAQ,QAAQ;IAChD,YAAY,OAAe,EAAE,IAAc;QACzC,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED,0EAA0E;AAC1E,MAAM,OAAO,gBAAiB,SAAQ,QAAQ;IAC5C,YAAY,OAAe,EAAE,IAAc;QACzC,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,qEAAqE;AACrE,MAAM,UAAU,iBAAiB,CAAC,MAAc,EAAE,OAAe,EAAE,IAAc;IAC/E,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,GAAG;YACN,OAAO,IAAI,oBAAoB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACjD,KAAK,GAAG;YACN,OAAO,IAAI,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACtC,KAAK,GAAG;YACN,OAAO,IAAI,qBAAqB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAClD,KAAK,GAAG;YACN,OAAO,IAAI,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC7C;YACE,OAAO,IAAI,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { IntelligentFunctions } from "./client.js";
+export type { ClientOptions, RunOptions, FunctionHandle, User, IFunction, CreateIFunctionInput, RunIFunctionResult, } from "./client.js";
+export { ApiError, AuthError, FunctionNotFoundError, InputValidationError, FunctionRunError, errorFromResponse, } from "./errors.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,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EACV,aAAa,EACb,UAAU,EACV,cAAc,EACd,IAAI,EACJ,SAAS,EACT,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,QAAQ,EACR,SAAS,EACT,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { IntelligentFunctions } from "./client.js";
+export { ApiError, AuthError, FunctionNotFoundError, InputValidationError, FunctionRunError, errorFromResponse, } from "./errors.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,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAUnD,OAAO,EACL,QAAQ,EACR,SAAS,EACT,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,aAAa,CAAC"}

package/dist/slug.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Canonical slug utilities. A slug is the human-friendly, URL-safe identifier
+ * that forms the function invocation key `{projectSlug}/{functionSlug}`, so this
+ * normalization is the single source of truth: the API validates with it, the
+ * console suggests with it, and SDK consumers can pre-derive slugs client-side.
+ */
+/** A valid slug: lowercase alphanumerics in hyphen-separated groups, no spaces. */
+export declare const SLUG_REGEX: RegExp;
+/** Max slug length; keeps keys and URLs reasonable. */
+export declare const MAX_SLUG_LENGTH = 64;
+/**
+ * Convert an arbitrary string (e.g. a display name) into a slug:
+ * lowercased, diacritics stripped, every run of non-`[a-z0-9]` collapsed to a
+ * single `-`, trimmed of leading/trailing `-`, and capped at {@link MAX_SLUG_LENGTH}.
+ *
+ * Returns `""` when the input has no slug-able characters — callers deriving a
+ * required slug should fall back (or reject) on an empty result.
+ *
+ * @example slugify("Summarize Ticket!") // "summarize-ticket"
+ * @example slugify("  Héllo  World  ")  // "hello-world"
+ */
+export declare function slugify(input: string): string;
+/** Whether `value` is already a well-formed slug. */
+export declare function isValidSlug(value: string): boolean;
+/**
+ * Return `base` if free, otherwise `base-2`, `base-3`, … until one is not taken.
+ * `taken` may be a Set of existing slugs or a predicate.
+ */
+export declare function uniqueSlug(base: string, taken: Set<string> | ((slug: string) => boolean)): string;
+//# sourceMappingURL=slug.d.ts.map

package/dist/slug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug.d.ts","sourceRoot":"","sources":["../src/slug.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,mFAAmF;AACnF,eAAO,MAAM,UAAU,QAA+B,CAAC;AAEvD,uDAAuD;AACvD,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAS7C;AAED,qDAAqD;AACrD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,MAAM,CAOjG"}

package/dist/slug.js

@@ -0,0 +1,50 @@
+/**
+ * Canonical slug utilities. A slug is the human-friendly, URL-safe identifier
+ * that forms the function invocation key `{projectSlug}/{functionSlug}`, so this
+ * normalization is the single source of truth: the API validates with it, the
+ * console suggests with it, and SDK consumers can pre-derive slugs client-side.
+ */
+/** A valid slug: lowercase alphanumerics in hyphen-separated groups, no spaces. */
+export const SLUG_REGEX = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+/** Max slug length; keeps keys and URLs reasonable. */
+export const MAX_SLUG_LENGTH = 64;
+/**
+ * Convert an arbitrary string (e.g. a display name) into a slug:
+ * lowercased, diacritics stripped, every run of non-`[a-z0-9]` collapsed to a
+ * single `-`, trimmed of leading/trailing `-`, and capped at {@link MAX_SLUG_LENGTH}.
+ *
+ * Returns `""` when the input has no slug-able characters — callers deriving a
+ * required slug should fall back (or reject) on an empty result.
+ *
+ * @example slugify("Summarize Ticket!") // "summarize-ticket"
+ * @example slugify("  Héllo  World  ")  // "hello-world"
+ */
+export function slugify(input) {
+    return input
+        .normalize("NFKD")
+        .replace(/[̀-ͯ]/g, "") // strip combining diacritical marks
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-") // any run of non-slug chars -> single hyphen
+        .replace(/^-+|-+$/g, "") // trim leading/trailing hyphens
+        .slice(0, MAX_SLUG_LENGTH)
+        .replace(/-+$/g, ""); // re-trim in case the slice ended on a hyphen
+}
+/** Whether `value` is already a well-formed slug. */
+export function isValidSlug(value) {
+    return value.length > 0 && value.length <= MAX_SLUG_LENGTH && SLUG_REGEX.test(value);
+}
+/**
+ * Return `base` if free, otherwise `base-2`, `base-3`, … until one is not taken.
+ * `taken` may be a Set of existing slugs or a predicate.
+ */
+export function uniqueSlug(base, taken) {
+    const isTaken = typeof taken === "function" ? taken : (slug) => taken.has(slug);
+    if (!isTaken(base))
+        return base;
+    for (let n = 2;; n++) {
+        const candidate = `${base}-${n}`;
+        if (!isTaken(candidate))
+            return candidate;
+    }
+}
+//# sourceMappingURL=slug.js.map

package/dist/slug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug.js","sourceRoot":"","sources":["../src/slug.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,mFAAmF;AACnF,MAAM,CAAC,MAAM,UAAU,GAAG,4BAA4B,CAAC;AAEvD,uDAAuD;AACvD,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAC;AAElC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,OAAO,KAAK;SACT,SAAS,CAAC,MAAM,CAAC;SACjB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,oCAAoC;SAC1D,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,6CAA6C;SACzE,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,gCAAgC;SACxD,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC;SACzB,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,8CAA8C;AACxE,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,IAAI,eAAe,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACvF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,KAAgD;IACvF,MAAM,OAAO,GAAG,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACxF,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAChC,KAAK,IAAI,CAAC,GAAG,CAAC,GAAI,CAAC,EAAE,EAAE,CAAC;QACtB,MAAM,SAAS,GAAG,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC;QACjC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;IAC5C,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@intfunc/sdk",
+  "version": "0.0.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "devDependencies": {
+    "typescript": "^7.0.2"
+  }
+}