@palai/sdk 0.1.0

package/dist/client.js

@@ -0,0 +1,296 @@
+// Importing the API-key client marks this module server-only: bundling it for the browser
+// throws rather than shipping the secret (see ./server-only.ts).
+import "./server-only.js";
+import { errorForResponse, isRetryableStatus, PalaiConnectionError } from "./errors.js";
+import { delay, fullJitterBackoff } from "./stream.js";
+import { Responses } from "./resources/responses.js";
+import { Sessions } from "./resources/sessions.js";
+import { Skills } from "./resources/skills.js";
+import { Agents } from "./resources/agents.js";
+import { Approvals } from "./resources/approvals.js";
+import { Artifacts } from "./resources/artifacts.js";
+import { MCPConnections, ModelConnections, RepositoryBindings, Tools, Triggers } from "./resources/reads.js";
+import { SecretRefs } from "./resources/secret-refs.js";
+import { ModelRoutes } from "./resources/model-routes.js";
+// APIVersion is the dated contract this SDK speaks; it rides every request (spec §20.13).
+export const APIVersion = "2026-07-16";
+// Palai is the transport client: Bearer auth, the dated API version, idempotent retry, and
+// typed RFC 9457 errors. Resource groups (responses) hang off it. It implements
+// StreamTransport so the streaming layer opens SSE connections through the same auth.
+export class Palai {
+    baseURL;
+    project;
+    responses;
+    modelConnections;
+    sessions;
+    agents;
+    // skills is the untrusted-content surface: install, review the quarantine, enable.
+    skills;
+    // approvals is the human-in-the-loop surface: what is parked, and the answer. A program that starts runs
+    // has to be able to answer them, or a gated call sits until its TTL expires.
+    approvals;
+    artifacts;
+    repositoryBindings;
+    tools;
+    mcpConnections;
+    triggers;
+    secretRefs;
+    modelRoutes;
+    // THERE IS NO `projects` OR `apiKeys` HERE, and their removal is the substance of the consumer/operator
+    // split rather than a tidy-up. Both routes demand a `system` or `provision` capability that a customer's
+    // project key does not carry, so the properties could only ever have handed a customer a 403 their key
+    // can never satisfy. Deleting the EXPORTS alone would not have removed the surface — these two lines are
+    // what made it reachable as `palai.projects.create(...)`, and a guard that enumerated the module's
+    // exports would have gone green with the surface still live.
+    #apiKey;
+    #fetch;
+    #maxRetries;
+    #timeoutMs;
+    #backoffBaseMs;
+    #backoffMaxMs;
+    constructor(options = {}) {
+        // Precedence: explicit option, then the Palai-scoped environment. No other provider's
+        // environment is ever read — the SDK never silently picks up an unrelated key.
+        const apiKey = options.apiKey ?? env("PALAI_API_KEY");
+        if (!apiKey) {
+            throw new Error("@palai/sdk: an API key is required — pass { apiKey } or set PALAI_API_KEY. " +
+                "Keep it server-side; never expose it to the browser.");
+        }
+        this.#apiKey = apiKey;
+        this.baseURL = trimTrailingSlash(options.baseURL ?? env("PALAI_BASE_URL") ?? "http://localhost:8080");
+        this.project = options.project ?? env("PALAI_PROJECT");
+        this.#fetch = options.fetch ?? globalThis.fetch;
+        this.#maxRetries = options.maxRetries ?? 2;
+        this.#timeoutMs = options.timeoutMs ?? 60_000;
+        this.#backoffBaseMs = options.backoffBaseMs ?? 200;
+        this.#backoffMaxMs = options.backoffMaxMs ?? 10_000;
+        this.responses = new Responses(this);
+        this.modelConnections = new ModelConnections(this);
+        this.sessions = new Sessions(this);
+        this.agents = new Agents(this);
+        this.skills = new Skills(this);
+        this.approvals = new Approvals(this);
+        this.artifacts = new Artifacts(this);
+        this.repositoryBindings = new RepositoryBindings(this);
+        this.tools = new Tools(this);
+        this.mcpConnections = new MCPConnections(this);
+        this.triggers = new Triggers(this);
+        this.secretRefs = new SecretRefs(this);
+        this.modelRoutes = new ModelRoutes(this);
+    }
+    async request(method, path, options = {}) {
+        const url = this.baseURL + path;
+        const headers = {
+            Authorization: `Bearer ${this.#apiKey}`,
+            "API-Version": APIVersion,
+            Accept: options.accept ?? "application/json",
+        };
+        // The idempotency key is built once and rides every retry, so a create that is retried
+        // after a network blip settles exactly one response (spec §20.9, §35.3).
+        if (options.idempotencyKey !== undefined) {
+            headers["Idempotency-Key"] = options.idempotencyKey;
+        }
+        let bodyText;
+        if (options.bytes !== undefined) {
+            // ‼️ RAW BYTES, AND THE CONTENT TYPE IS THE SERVER'S TO DECIDE. POST /v1/artifacts takes the object
+            // itself as the body and SNIFFS its media type (http.DetectContentType), refusing anything outside
+            // its allow-list. A client-declared type would be a claim the server ignores — a lie in a function
+            // signature — so none is sent.
+            bodyText = options.bytes;
+        }
+        else if (options.body !== undefined) {
+            bodyText = JSON.stringify(options.body);
+            headers["Content-Type"] = "application/json";
+        }
+        // A network-level failure may have already committed on the server, so it is only re-sent when the
+        // request is idempotent: a safe method, an Idempotency-Key create, or a body-idempotent op that
+        // opts in. A non-idempotent create is NOT re-sent, so a connection torn after its 201 cannot
+        // double-provision a tenant/secret/route (SHOULD-1). Response-level (429/5xx) retry is unaffected.
+        const idempotent = isSafeMethod(method) || options.idempotencyKey !== undefined || options.idempotent === true;
+        const maxRetries = options.maxRetries ?? this.#maxRetries;
+        const deadline = Date.now() + (options.timeoutMs ?? this.#timeoutMs);
+        let attempt = 0;
+        for (;;) {
+            const remaining = deadline - Date.now();
+            if (remaining <= 0) {
+                throw new PalaiConnectionError(`${method} ${path} exceeded its ${options.timeoutMs ?? this.#timeoutMs}ms deadline`);
+            }
+            const signal = combineSignals(options.signal, AbortSignal.timeout(remaining));
+            let response;
+            try {
+                response = await this.#fetch(url, {
+                    method,
+                    headers,
+                    signal,
+                    ...(bodyText !== undefined ? { body: bodyText } : {}),
+                });
+            }
+            catch (cause) {
+                if (options.signal?.aborted) {
+                    throw new PalaiConnectionError(`${method} ${path} was canceled`, { cause });
+                }
+                // Network failure or a per-attempt timeout: retry within budget — but only for an idempotent
+                // request, so a non-idempotent create fails closed instead of risking a double-commit.
+                if (!idempotent || attempt >= maxRetries || !withinBudget(deadline, attempt, this.#backoffBaseMs, this.#backoffMaxMs)) {
+                    throw new PalaiConnectionError(`${method} ${path} failed to reach the server`, { cause });
+                }
+                try {
+                    await delay(fullJitterBackoff(attempt, this.#backoffBaseMs, this.#backoffMaxMs), options.signal);
+                }
+                catch (abortCause) {
+                    // A cancel landing inside the backoff sleep must surface as a PalaiError, not the
+                    // raw DOMException delay() rejects with.
+                    throw new PalaiConnectionError(`${method} ${path} was canceled`, { cause: abortCause });
+                }
+                attempt += 1;
+                continue;
+            }
+            if (response.ok) {
+                return await parseJSON(response);
+            }
+            if (isRetryableStatus(response.status) && attempt < maxRetries) {
+                const wait = retryAfterMs(response) ?? fullJitterBackoff(attempt, this.#backoffBaseMs, this.#backoffMaxMs);
+                if (Date.now() + wait < deadline) {
+                    await response.body?.cancel().catch(() => { });
+                    try {
+                        await delay(wait, options.signal);
+                    }
+                    catch (cause) {
+                        // A cancel landing inside the backoff sleep must surface as a PalaiError, not the
+                        // raw DOMException delay() rejects with.
+                        throw new PalaiConnectionError(`${method} ${path} was canceled`, { cause });
+                    }
+                    attempt += 1;
+                    continue;
+                }
+            }
+            const text = await response.text();
+            throw errorForResponse(response.status, text, response.headers.get("Request-Id") ?? undefined);
+        }
+    }
+    // openEventStream opens the raw SSE response for a session with Bearer auth and, on a
+    // resume, the Last-Event-ID cursor. It does not retry — ResponseStream owns reconnection.
+    openEventStream(sessionID, lastEventId, signal) {
+        const headers = {
+            Authorization: `Bearer ${this.#apiKey}`,
+            "API-Version": APIVersion,
+            Accept: "text/event-stream",
+        };
+        if (lastEventId !== null) {
+            headers["Last-Event-ID"] = lastEventId;
+        }
+        return this.#fetch(`${this.baseURL}/v1/sessions/${encodeURIComponent(sessionID)}/events`, {
+            method: "GET",
+            headers,
+            cache: "no-store",
+            ...(signal ? { signal } : {}),
+        });
+    }
+    retrieveResponse(responseID) {
+        return this.responses.retrieve(responseID);
+    }
+    /**
+     * One prompt in, the model's text out.
+     *
+     * The whole vertical collapsed to a single call — create, wait, read — for the case where a
+     * caller wants an answer and nothing else. Everything it hides stays reachable: `responses.run`
+     * returns the full Response, `responses.stream` gives the journal.
+     */
+    async ask(prompt, options = {}) {
+        const request = {
+            input: prompt,
+            ...(options.model !== undefined ? { model: options.model } : {}),
+            ...(options.effort !== undefined ? { effort: options.effort } : {}),
+        };
+        const response = await this.responses.run(request, options.deadlineMs !== undefined ? { deadlineMs: options.deadlineMs } : {});
+        const output = response.output ?? [];
+        return output.map((part) => (typeof part.content === "string" ? part.content : "")).join("");
+    }
+    // openDownload opens an authenticated GET whose body is raw bytes (an artifact download), not JSON.
+    // It applies the same Bearer auth + dated version as request() and maps a non-2xx to the typed RFC
+    // 9457 error, but returns the raw Response so the caller streams the body without buffering it.
+    //
+    // timeoutMs bounds the CONNECT phase only: the timer is cleared the moment headers arrive, so the
+    // byte stream that follows is governed solely by the caller's signal — a multi-GB object never trips
+    // a wall-clock connect deadline mid-transfer (SHOULD-2). A connect timeout surfaces as a typed
+    // PalaiConnectionError, never a raw AbortError.
+    // ponytail: single attempt — a partially-drained stream is not safely retryable; add a bounded
+    // open-retry only when a caller measurably needs one.
+    async openDownload(path, options = {}) {
+        const headers = {
+            Authorization: `Bearer ${this.#apiKey}`,
+            "API-Version": APIVersion,
+            Accept: "application/octet-stream",
+        };
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), options.timeoutMs ?? this.#timeoutMs);
+        const signal = combineSignals(options.signal, controller.signal);
+        let response;
+        try {
+            response = await this.#fetch(this.baseURL + path, { method: "GET", headers, cache: "no-store", signal });
+        }
+        catch (cause) {
+            if (options.signal?.aborted) {
+                throw new PalaiConnectionError(`GET ${path} was canceled`, { cause });
+            }
+            throw new PalaiConnectionError(`GET ${path} failed to reach the server`, { cause });
+        }
+        finally {
+            // Headers are in (or the connect failed): stop the connect timeout so it never aborts the body.
+            clearTimeout(timer);
+        }
+        if (!response.ok) {
+            const text = await response.text();
+            throw errorForResponse(response.status, text, response.headers.get("Request-Id") ?? undefined);
+        }
+        return response;
+    }
+    // defineAgent is agents.defineAgent hoisted to the client, because "define an agent" is something a
+    // caller does to the PLATFORM rather than to a sub-resource — and because the three-call shape it
+    // replaces is the one a caller most often gets wrong, silently.
+    defineAgent(params, options = {}) {
+        return this.agents.defineAgent(params, options);
+    }
+}
+// env reads a Palai-scoped variable, trimmed, or undefined. It never throws in a runtime
+// without process (the browser-safe entrypoint never constructs this client).
+function env(name) {
+    if (typeof process === "undefined" || process.env === undefined) {
+        return undefined;
+    }
+    const value = process.env[name];
+    return value && value.trim() !== "" ? value.trim() : undefined;
+}
+function trimTrailingSlash(url) {
+    return url.endsWith("/") ? url.slice(0, -1) : url;
+}
+// isSafeMethod reports whether a method has no side effect, so re-sending it after a network failure
+// cannot double-apply anything (RFC 9110 §9.2.1). Every SDK read is a GET; nothing else is auto-safe.
+function isSafeMethod(method) {
+    return method === "GET" || method === "HEAD";
+}
+// combineSignals joins the caller's cancel signal with the per-attempt timeout so either
+// aborts the fetch; with no caller signal it is just the timeout.
+function combineSignals(caller, timeout) {
+    return caller ? AbortSignal.any([caller, timeout]) : timeout;
+}
+// withinBudget reports whether the next backoff would still leave time before the deadline.
+function withinBudget(deadline, attempt, baseMs, maxMs) {
+    return Date.now() + fullJitterBackoff(attempt, baseMs, maxMs) < deadline;
+}
+// retryAfterMs honors a server Retry-After header (delta-seconds) so the client backs off
+// as instructed rather than on its own schedule; a non-numeric value is ignored.
+function retryAfterMs(response) {
+    const header = response.headers.get("Retry-After");
+    if (header === null) {
+        return null;
+    }
+    const seconds = Number(header);
+    return Number.isFinite(seconds) && seconds >= 0 ? seconds * 1000 : null;
+}
+async function parseJSON(response) {
+    const text = await response.text();
+    const body = (text === "" ? undefined : JSON.parse(text));
+    return { status: response.status, headers: response.headers, body };
+}
+//# 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,40 @@
+import type { Problem } from "./generated/types.ts";
+export type ProblemCode = "invalid_request" | "invalid_state" | "unsupported_content" | "missing_idempotency_key" | "authentication_required" | "invalid_token" | "expired_token" | "permission_denied" | "capability_denied" | "policy_denied" | "region_denied" | "not_found" | "revision_conflict" | "idempotency_mismatch" | "idempotency_in_progress" | "active_run_conflict" | "lease_conflict" | "gone" | "idempotency_result_expired" | "retention_expired" | "precondition_failed" | "payload_too_large" | "context_too_large" | "schema_validation_failed" | "unsupported_model_capability" | "unknown_connection" | "unsupported_model" | "model_not_allowed" | "rate_limited" | "quota_exceeded" | "concurrency_exceeded" | "internal_error" | "provider_error" | "tool_transport_error" | "runner_error" | "capacity_unavailable" | "dependency_unavailable" | "maintenance" | "operation_timed_out" | (string & {});
+export declare class PalaiError extends Error {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+export declare class PalaiConnectionError extends PalaiError {
+    readonly retryable = true;
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+export declare class PalaiAPIError extends PalaiError {
+    readonly status: number;
+    readonly code: ProblemCode;
+    readonly problem: Problem;
+    readonly requestId: string | undefined;
+    readonly retryable: boolean;
+    constructor(status: number, problem: Problem, requestId?: string);
+}
+export declare class InvalidRequestError extends PalaiAPIError {
+}
+export declare class AuthenticationError extends PalaiAPIError {
+}
+export declare class PermissionDeniedError extends PalaiAPIError {
+}
+export declare class NotFoundError extends PalaiAPIError {
+}
+export declare class ConflictError extends PalaiAPIError {
+}
+export declare class GoneError extends PalaiAPIError {
+}
+export declare class RateLimitError extends PalaiAPIError {
+}
+export declare class InternalServerError extends PalaiAPIError {
+}
+export declare function isRetryableStatus(status: number): boolean;
+export declare function errorForResponse(status: number, bodyText: string, requestId?: string): PalaiAPIError;
+//# 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,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAKpD,MAAM,MAAM,WAAW,GACnB,iBAAiB,GACjB,eAAe,GACf,qBAAqB,GACrB,yBAAyB,GACzB,yBAAyB,GACzB,eAAe,GACf,eAAe,GACf,mBAAmB,GACnB,mBAAmB,GACnB,eAAe,GACf,eAAe,GACf,WAAW,GACX,mBAAmB,GACnB,sBAAsB,GACtB,yBAAyB,GACzB,qBAAqB,GACrB,gBAAgB,GAChB,MAAM,GACN,4BAA4B,GAC5B,mBAAmB,GACnB,qBAAqB,GACrB,mBAAmB,GACnB,mBAAmB,GACnB,0BAA0B,GAC1B,8BAA8B,GAO9B,oBAAoB,GACpB,mBAAmB,GACnB,mBAAmB,GACnB,cAAc,GACd,gBAAgB,GAChB,sBAAsB,GACtB,gBAAgB,GAChB,gBAAgB,GAChB,sBAAsB,GACtB,cAAc,GACd,sBAAsB,GACtB,wBAAwB,GACxB,aAAa,GACb,qBAAqB,GAGrB,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAIlB,qBAAa,UAAW,SAAQ,KAAK;IACnC,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,EAGzD;CACF;AAID,qBAAa,oBAAqB,SAAQ,UAAU;IAClD,QAAQ,CAAC,SAAS,QAAQ;IAC1B,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,EAEzD;CACF;AAKD,qBAAa,aAAc,SAAQ,UAAU;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAE5B,YAAY,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,EAQ/D;CACF;AAID,qBAAa,mBAAoB,SAAQ,aAAa;CAAG;AACzD,qBAAa,mBAAoB,SAAQ,aAAa;CAAG;AACzD,qBAAa,qBAAsB,SAAQ,aAAa;CAAG;AAC3D,qBAAa,aAAc,SAAQ,aAAa;CAAG;AACnD,qBAAa,aAAc,SAAQ,aAAa;CAAG;AACnD,qBAAa,SAAU,SAAQ,aAAa;CAAG;AAC/C,qBAAa,cAAe,SAAQ,aAAa;CAAG;AACpD,qBAAa,mBAAoB,SAAQ,aAAa;CAAG;AAIzD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEzD;AA8BD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,aAAa,CAIpG"}

package/dist/errors.js

@@ -0,0 +1,143 @@
+// PalaiError is the base for everything the SDK throws, so a caller can catch the whole
+// surface with one `instanceof`.
+export class PalaiError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = new.target.name;
+    }
+}
+// PalaiConnectionError is a transport failure before any HTTP status was seen — a dropped
+// socket, DNS failure, or an aborted per-attempt timeout. It is always retryable.
+export class PalaiConnectionError extends PalaiError {
+    retryable = true;
+    constructor(message, options) {
+        super(message, options);
+    }
+}
+// PalaiAPIError is a typed RFC 9457 problem response. It carries the parsed Problem, the
+// HTTP status, the stable code, the correlation request id, and whether the class of
+// failure is retryable (§23.7).
+export class PalaiAPIError extends PalaiError {
+    status;
+    code;
+    problem;
+    requestId;
+    retryable;
+    constructor(status, problem, requestId) {
+        super(problem.detail || problem.title || problem.code || `HTTP ${status}`);
+        this.status = status;
+        this.problem = problem;
+        this.code = problem.code;
+        this.requestId = problem.request_id || requestId;
+        // The server's explicit retryable wins; otherwise fall back to the status class.
+        this.retryable = problem.retryable ?? isRetryableStatus(status);
+    }
+}
+// Family subclasses give ergonomic `instanceof` discrimination for the common HTTP
+// classes without a class per stable code; the exact code is always on `.code`.
+export class InvalidRequestError extends PalaiAPIError {
+}
+export class AuthenticationError extends PalaiAPIError {
+}
+export class PermissionDeniedError extends PalaiAPIError {
+}
+export class NotFoundError extends PalaiAPIError {
+}
+export class ConflictError extends PalaiAPIError {
+}
+export class GoneError extends PalaiAPIError {
+}
+export class RateLimitError extends PalaiAPIError {
+}
+export class InternalServerError extends PalaiAPIError {
+}
+// isRetryableStatus is the SDK's default retry predicate (§23.7): a request timeout, a
+// rate limit, or any server-side 5xx may be retried; everything else is terminal.
+export function isRetryableStatus(status) {
+    return status === 408 || status === 429 || status >= 500;
+}
+// apiErrorClass picks the family subclass for an HTTP status so callers can branch on the
+// error type. An unmapped status falls back to the base PalaiAPIError.
+function apiErrorClass(status) {
+    switch (status) {
+        case 400:
+        case 422:
+            return InvalidRequestError;
+        case 401:
+            return AuthenticationError;
+        case 403:
+            return PermissionDeniedError;
+        case 404:
+            return NotFoundError;
+        case 409:
+            return ConflictError;
+        case 410:
+            return GoneError;
+        case 429:
+            return RateLimitError;
+        default:
+            return status >= 500 ? InternalServerError : PalaiAPIError;
+    }
+}
+// errorForResponse builds the typed error for a non-2xx response. A well-formed
+// application/problem+json body is parsed into a Problem; a body that is missing or not a
+// problem document degrades to a synthesized Problem carrying the stable code the status
+// implies, so a gateway's plain-text 502 still throws a typed, retryable error.
+export function errorForResponse(status, bodyText, requestId) {
+    const problem = parseProblem(bodyText) ?? syntheticProblem(status, requestId);
+    const Cls = apiErrorClass(status);
+    return new Cls(status, problem, requestId);
+}
+function parseProblem(bodyText) {
+    if (!bodyText) {
+        return null;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(bodyText);
+    }
+    catch {
+        return null;
+    }
+    if (typeof parsed !== "object" || parsed === null) {
+        return null;
+    }
+    const candidate = parsed;
+    if (typeof candidate.code !== "string" || typeof candidate.status !== "number") {
+        return null;
+    }
+    return parsed;
+}
+function syntheticProblem(status, requestId) {
+    const code = statusCode(status);
+    return {
+        type: `https://docs.palai.dev/problems/${code}`,
+        title: code,
+        status,
+        code,
+        request_id: requestId ?? "",
+    };
+}
+function statusCode(status) {
+    switch (status) {
+        case 401:
+            return "authentication_required";
+        case 403:
+            return "permission_denied";
+        case 404:
+            return "not_found";
+        case 409:
+            return "active_run_conflict";
+        case 410:
+            return "gone";
+        case 429:
+            return "rate_limited";
+        case 503:
+            return "capacity_unavailable";
+        case 504:
+            return "operation_timed_out";
+        default:
+            return status >= 500 ? "internal_error" : "invalid_request";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/generated/tools.d.ts

@@ -0,0 +1,39 @@
+export declare const tools: {
+    readonly workspace: {
+        readonly file: "palai.workspace.file";
+        readonly glob: "palai.workspace.glob";
+        readonly grep: "palai.workspace.grep";
+        readonly shell: "palai.workspace.shell";
+        readonly backgroundKill: "palai.workspace.background_kill";
+        readonly showMedia: "palai.workspace.show_media";
+        readonly fetchArchive: "palai.workspace.fetch_archive";
+        readonly commit: "palai.workspace.commit";
+    };
+    readonly strReplaceBasedEditTool: "str_replace_based_edit_tool";
+    readonly preview: {
+        readonly build: "palai.preview.build";
+    };
+    readonly research: {
+        readonly fetch: "palai.research.fetch";
+    };
+    readonly knowledge: {
+        readonly retrieve: "palai.knowledge.retrieve";
+    };
+    readonly agent: {
+        readonly spawn: "palai.agent.spawn";
+        readonly status: "palai.agent.status";
+        readonly stop: "palai.agent.stop";
+        readonly send: "palai.agent.send";
+        readonly notify: "palai.agent.notify";
+    };
+    readonly skill: {
+        readonly load: "palai.skill.load";
+    };
+    readonly publish: {
+        readonly push: "palai.publish.push";
+        readonly pullRequest: "palai.publish.pull_request";
+        readonly mergePullRequest: "palai.publish.merge_pull_request";
+    };
+};
+export type ToolName = typeof tools extends infer T ? T[keyof T] extends string ? T[keyof T] : never : never;
+//# sourceMappingURL=tools.d.ts.map

package/dist/generated/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/generated/tools.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,KAAK;aAChB,SAAS;iBACP,IAAI,EAAE,sBAAsB;iBAC5B,IAAI,EAAE,sBAAsB;iBAC5B,IAAI,EAAE,sBAAsB;iBAC5B,KAAK,EAAE,uBAAuB;iBAC9B,cAAc,EAAE,iCAAiC;iBACjD,SAAS,EAAE,4BAA4B;iBACvC,YAAY,EAAE,+BAA+B;iBAC7C,MAAM,EAAE,wBAAwB;;aAElC,uBAAuB,EAAE,6BAA6B;aACtD,OAAO;iBACL,KAAK,EAAE,qBAAqB;;aAE9B,QAAQ;iBACN,KAAK,EAAE,sBAAsB;;aAE/B,SAAS;iBACP,QAAQ,EAAE,0BAA0B;;aAEtC,KAAK;iBACH,KAAK,EAAE,mBAAmB;iBAC1B,MAAM,EAAE,oBAAoB;iBAC5B,IAAI,EAAE,kBAAkB;iBACxB,IAAI,EAAE,kBAAkB;iBACxB,MAAM,EAAE,oBAAoB;;aAE9B,KAAK;iBACH,IAAI,EAAE,kBAAkB;;aAE1B,OAAO;iBACL,IAAI,EAAE,oBAAoB;iBAC1B,WAAW,EAAE,4BAA4B;iBACzC,gBAAgB,EAAE,kCAAkC;;CAE9C,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,OAAO,KAAK,SAAS,MAAM,CAAC,GAC/C,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,GAC9C,KAAK,CAAC"}

package/dist/generated/tools.js

@@ -0,0 +1,44 @@
+// GENERATED FILE — do not edit. Source: packages/toolset/toolset.go
+// Regenerate with: npm run generate:tools
+//
+// The names a run can be granted, as constants rather than strings a caller retypes. A typo in a tool
+// name is otherwise silent: the effective set simply omits it and the model is never offered the tool,
+// with nothing anywhere saying why.
+export const tools = {
+    workspace: {
+        file: "palai.workspace.file",
+        glob: "palai.workspace.glob",
+        grep: "palai.workspace.grep",
+        shell: "palai.workspace.shell",
+        backgroundKill: "palai.workspace.background_kill",
+        showMedia: "palai.workspace.show_media",
+        fetchArchive: "palai.workspace.fetch_archive",
+        commit: "palai.workspace.commit",
+    },
+    strReplaceBasedEditTool: "str_replace_based_edit_tool",
+    preview: {
+        build: "palai.preview.build",
+    },
+    research: {
+        fetch: "palai.research.fetch",
+    },
+    knowledge: {
+        retrieve: "palai.knowledge.retrieve",
+    },
+    agent: {
+        spawn: "palai.agent.spawn",
+        status: "palai.agent.status",
+        stop: "palai.agent.stop",
+        send: "palai.agent.send",
+        notify: "palai.agent.notify",
+    },
+    skill: {
+        load: "palai.skill.load",
+    },
+    publish: {
+        push: "palai.publish.push",
+        pullRequest: "palai.publish.pull_request",
+        mergePullRequest: "palai.publish.merge_pull_request",
+    },
+};
+//# sourceMappingURL=tools.js.map

package/dist/generated/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/generated/tools.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,0CAA0C;AAC1C,EAAE;AACF,sGAAsG;AACtG,uGAAuG;AACvG,oCAAoC;AACpC,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,SAAS,EAAE;QACT,IAAI,EAAE,sBAAsB;QAC5B,IAAI,EAAE,sBAAsB;QAC5B,IAAI,EAAE,sBAAsB;QAC5B,KAAK,EAAE,uBAAuB;QAC9B,cAAc,EAAE,iCAAiC;QACjD,SAAS,EAAE,4BAA4B;QACvC,YAAY,EAAE,+BAA+B;QAC7C,MAAM,EAAE,wBAAwB;KACjC;IACD,uBAAuB,EAAE,6BAA6B;IACtD,OAAO,EAAE;QACP,KAAK,EAAE,qBAAqB;KAC7B;IACD,QAAQ,EAAE;QACR,KAAK,EAAE,sBAAsB;KAC9B;IACD,SAAS,EAAE;QACT,QAAQ,EAAE,0BAA0B;KACrC;IACD,KAAK,EAAE;QACL,KAAK,EAAE,mBAAmB;QAC1B,MAAM,EAAE,oBAAoB;QAC5B,IAAI,EAAE,kBAAkB;QACxB,IAAI,EAAE,kBAAkB;QACxB,MAAM,EAAE,oBAAoB;KAC7B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,kBAAkB;KACzB;IACD,OAAO,EAAE;QACP,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EAAE,4BAA4B;QACzC,gBAAgB,EAAE,kCAAkC;KACrD;CACO,CAAC"}