@tidblink/server 0.0.0-stage → 0.3.0-rc.0

package/dist/http.js

@@ -0,0 +1,282 @@
+import { TiDBLinkApiError, TiDBLinkError, ConflictError, ConnectionError, OutcomeUnknownError, } from "./errors.js";
+const RETRYABLE_STATUS = new Set([408, 429, 500, 502, 503, 504]);
+const MAX_ATTEMPTS = 3;
+export const paginationQuery = (options) => {
+    if (options)
+        requireKnownKeys(options, ["limit", "cursor", "signal", "requestId"], "List options");
+    const query = new URLSearchParams();
+    if (options?.limit !== undefined)
+        query.set("limit", String(options.limit));
+    if (options?.cursor !== undefined)
+        query.set("cursor", options.cursor);
+    return query.size ? `?${query}` : "";
+};
+export function requireCreationKey(value) {
+    if (typeof value !== "string" ||
+        !/^[A-Za-z0-9][A-Za-z0-9_.:-]{0,127}$/.test(value))
+        throw new TypeError("Creation requires a stable idempotencyKey (1-128 safe characters)");
+}
+export const requireEtag = (result) => {
+    if (!result.etag) {
+        throw new TiDBLinkError("TiDB Link response omitted a required ETag", {
+            requestId: result.requestId,
+        });
+    }
+    return result.etag;
+};
+const requestId = () => crypto.randomUUID();
+const REQUEST_ID = /^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}$/;
+export const sleep = (milliseconds, signal) => {
+    if (signal?.aborted)
+        return Promise.reject(signal.reason);
+    return new Promise((resolve, reject) => {
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(signal?.reason);
+        };
+        const timer = setTimeout(() => {
+            signal?.removeEventListener("abort", onAbort);
+            resolve();
+        }, milliseconds);
+        signal?.addEventListener("abort", onAbort, { once: true });
+    });
+};
+const pauseBeforeRetry = async (milliseconds, options, requestId) => {
+    try {
+        await sleep(milliseconds, options.signal);
+    }
+    catch (cause) {
+        if (!options.outcomeUnknown)
+            throw cause;
+        throw new OutcomeUnknownError("TiDB Link request outcome is unknown after local waiting stopped; recover with the same creation key", { requestId, cause });
+    }
+};
+const errorInput = async (response, fallbackRequestId) => {
+    let value;
+    try {
+        value = await response.json();
+    }
+    catch {
+        value = undefined;
+    }
+    const envelope = value;
+    const error = typeof envelope?.error === "object" && envelope.error !== null
+        ? envelope.error
+        : undefined;
+    return {
+        status: response.status,
+        code: typeof error?.code === "string" ? error.code : "http_error",
+        message: typeof error?.message === "string"
+            ? error.message
+            : `TiDB Link request failed with status ${response.status}`,
+        requestId: response.headers.get("x-request-id") ??
+            (typeof error?.requestId === "string"
+                ? error.requestId
+                : fallbackRequestId),
+        ...(error && "details" in error ? { details: error.details } : {}),
+        ...(response.headers.has("retry-after")
+            ? { retryAfter: response.headers.get("retry-after") }
+            : {}),
+    };
+};
+const normalizeBaseUrl = (value) => {
+    const url = new URL(value);
+    if ((url.protocol !== "http:" && url.protocol !== "https:") ||
+        url.username ||
+        url.password ||
+        url.search ||
+        url.hash) {
+        throw new TypeError("baseUrl must be an HTTP(S) URL without credentials");
+    }
+    return url.toString().replace(/\/$/, "");
+};
+export function requireKnownKeys(value, allowed, label) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new TypeError(`${label} must be an object`);
+    }
+    const unknown = Object.keys(value).find((key) => !allowed.includes(key));
+    if (unknown)
+        throw new TypeError(`${label}.${unknown} is not supported`);
+}
+export const requestOptions = (options = {}) => {
+    requireKnownKeys(options, ["requestId", "signal"], "Request options");
+    return { ...options };
+};
+/** Check the frozen wire grammar without retaining or exposing the credential. */
+export const isApiKey = (value, kind) => {
+    if (typeof value !== "string")
+        return false;
+    const match = /^ti_(org|user)_[A-Za-z0-9]{1,64}_[A-Za-z0-9_-]{43}$/u.exec(value);
+    return match !== null && match[0] === value && match[1] === kind;
+};
+export class HttpClient {
+    #apiKey;
+    #baseUrl;
+    #ownerPrefix;
+    constructor(input) {
+        this.#baseUrl = normalizeBaseUrl(input.baseUrl);
+        this.#apiKey = input.apiKey;
+        this.#ownerPrefix =
+            input.userId === undefined
+                ? undefined
+                : `/api/v1/org/users/${encodeURIComponent(input.userId)}`;
+    }
+    forUser(userId) {
+        if (typeof userId !== "string" || !/^[a-z0-9_-]{1,64}$/.test(userId))
+            throw new TypeError("Organization resources require an explicit User ID");
+        return new HttpClient({
+            baseUrl: this.#baseUrl,
+            apiKey: this.#apiKey,
+            userId,
+        });
+    }
+    resourcePath(path) {
+        if (this.#ownerPrefix === undefined)
+            return path;
+        if (path.startsWith("/api/v1/user/"))
+            return this.#ownerPrefix + path.slice("/api/v1/user".length);
+        if (/^\/api\/v1\/(files|schedulers|agent-models|realtime-models)([/?]|$)/.test(path))
+            return this.#ownerPrefix + path.slice("/api/v1".length);
+        throw new TypeError("Unsupported Organization User resource path");
+    }
+    resolveUrl(value) {
+        return new URL(value, `${this.#baseUrl}/`);
+    }
+    get(path, options) {
+        return this.request(path, { ...options, retry: "safe" });
+    }
+    getResponse(path, options) {
+        return this.response(path, { ...options, retry: "safe" });
+    }
+    post(path, body, options) {
+        return this.request(path, {
+            ...options,
+            method: "POST",
+            body,
+            retry: options?.idempotent ? "safe" : "never",
+        });
+    }
+    postResponse(path, body, options) {
+        return this.response(path, {
+            ...options,
+            method: "POST",
+            body,
+            retry: options?.idempotent ? "safe" : "never",
+        });
+    }
+    patchResponse(path, body, options) {
+        return this.response(path, { ...options, method: "PATCH", body });
+    }
+    deleteResponse(path, options) {
+        return this.response(path, { ...options, method: "DELETE" });
+    }
+    async request(path, options = {}) {
+        return (await this.response(path, options)).data;
+    }
+    async response(path, options = {}) {
+        const { body, ...requestOptions } = options;
+        const { response, requestId } = await this.rawResponse(path, {
+            ...requestOptions,
+            ...(body === undefined
+                ? {}
+                : {
+                    body: JSON.stringify(body),
+                    headers: { "content-type": "application/json" },
+                }),
+        });
+        let data;
+        try {
+            data =
+                response.status === 204
+                    ? undefined
+                    : (await response.json());
+        }
+        catch (cause) {
+            const ErrorClass = options.outcomeUnknown
+                ? OutcomeUnknownError
+                : TiDBLinkError;
+            throw new ErrorClass(options.outcomeUnknown
+                ? "TiDB Link accepted the request but returned an unusable response"
+                : "TiDB Link returned invalid JSON", { requestId, cause });
+        }
+        return { data, etag: response.headers.get("etag") ?? undefined, requestId };
+    }
+    /** Raw bytes and event streams retain the same credential, redirect and error boundary. */
+    async rawResponse(path, options = {}) {
+        const stableRequestId = options.requestId ?? requestId();
+        if (!REQUEST_ID.test(stableRequestId)) {
+            throw new TypeError("requestId must be 1-64 safe characters");
+        }
+        if (options.idempotencyKey !== undefined &&
+            (options.idempotencyKey.length > 255 ||
+                !/^[\x20-\x7e]+$/.test(options.idempotencyKey))) {
+            throw new TypeError("idempotencyKey must be 1-255 visible ASCII characters");
+        }
+        options.signal?.throwIfAborted();
+        const attempts = options.retry === "safe" ? MAX_ATTEMPTS : 1;
+        for (let attempt = 1; attempt <= attempts; attempt += 1) {
+            let response;
+            try {
+                response = await fetch(`${this.#baseUrl}${this.resourcePath(path)}`, {
+                    method: options.method ?? "GET",
+                    redirect: "error",
+                    headers: {
+                        accept: "application/json",
+                        ...options.headers,
+                        authorization: `Bearer ${this.#apiKey}`,
+                        "x-request-id": stableRequestId,
+                        ...(options.idempotencyKey
+                            ? { "idempotency-key": options.idempotencyKey }
+                            : {}),
+                        ...(options.ifMatch ? { "if-match": options.ifMatch } : {}),
+                    },
+                    ...(options.body === undefined ? {} : { body: options.body }),
+                    ...(options.signal ? { signal: options.signal } : {}),
+                });
+            }
+            catch (cause) {
+                if (options.signal?.aborted && !options.outcomeUnknown)
+                    throw cause;
+                if (attempt < attempts && !options.signal?.aborted) {
+                    await pauseBeforeRetry(100 * 2 ** (attempt - 1), options, stableRequestId);
+                    continue;
+                }
+                const ErrorClass = options.outcomeUnknown
+                    ? OutcomeUnknownError
+                    : ConnectionError;
+                throw new ErrorClass(options.outcomeUnknown
+                    ? "TiDB Link request outcome is unknown; do not repeat it automatically"
+                    : "Could not reach TiDB Link", {
+                    requestId: stableRequestId,
+                    cause,
+                });
+            }
+            if (response.ok)
+                return {
+                    response,
+                    requestId: response.headers.get("x-request-id") ?? stableRequestId,
+                };
+            if (attempt < attempts && RETRYABLE_STATUS.has(response.status)) {
+                await response.arrayBuffer().catch(() => undefined);
+                await pauseBeforeRetry(100 * 2 ** (attempt - 1), options, stableRequestId);
+                continue;
+            }
+            const input = await errorInput(response, stableRequestId);
+            const error = input.status === 409 || input.status === 412
+                ? new ConflictError(input)
+                : new TiDBLinkApiError(input);
+            if (options.outcomeUnknown &&
+                (input.status >= 500 || input.status === 408)) {
+                throw new OutcomeUnknownError("TiDB Link could not confirm the mutation outcome", {
+                    ...(input.requestId === undefined
+                        ? {}
+                        : { requestId: input.requestId }),
+                    cause: error,
+                });
+            }
+            throw error;
+        }
+        throw new Error("unreachable");
+    }
+}
+//# 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,26 @@
+/** TiDB Link OpenAPI version supported by this SDK release. */
+export declare const TIDB_LINK_API_VERSION: "0.0.1";
+/** Exact service baseline for the supported refreshed SDK surface. */
+export declare const TIDB_LINK_REVISION: "882287809f91d9a3fdf60537460431d9f0fc23e7";
+export { TiDBLinkApiError, TiDBLinkError, ConflictError, ConnectionError, TurnWaitTimeoutError, InputNotAppliedError, OutcomeUnknownError, ObservationStoppedError, TurnFailedError, TurnInterruptedError, } from "./errors.js";
+export { OrganizationClient } from "./organization.js";
+export type { Organization, EndUser, CreateEndUserInput, RequestOptions, IssuedUserApiKey, OrganizationClientOptions, UserApiKey, } from "./organization.js";
+export { Agent, EndUserClient, UserClient } from "./user.js";
+export type { AgentRecord, AgentTemplate, AgentTemplatePage, AgentModelCatalog, CreateAgentInput, UpdateAgentInput, SessionPage, UserClientOptions, } from "./user.js";
+export type { ListOptions } from "./http.js";
+export { Session } from "./session.js";
+export type { BillingTag, CreateSessionOptions, SuggestSessionNameInput, ClarificationItem, SelectableSessionModel, SessionModel, SessionRecord, } from "./session.js";
+export type { OpenRealtimeConnectionInput, OpenRealtimeConnectionResult, RealtimeAudioFormat, RealtimeAudioFormats, RealtimeConnectGrant, RealtimeConnection, RealtimeEndpointingMode, RealtimeLanguage, RealtimeModel, RealtimeModelCatalog, RealtimeModelSelection, RealtimeOpusAudioFormat, RealtimePcm16AudioFormat, RealtimeVoiceSetting, } from "./realtime.js";
+export type { CreateTurnInput, TurnResult, WaitForResultOptions, } from "./turn.js";
+export type { MessageRecord, MessageInputContext, RealtimeMessageMetadata, TurnRecord, FullAgentTurnRecord, RealtimeTurnRecord, TurnPage, TurnStatus, TurnUserFile, TurnFailure, OperationRecord, OperationStatus, OperationResultPointer, SessionInteraction, SessionInteractionPage, SessionRealtimeEvent, RealtimeResponseKind, SessionTimelineEntry, SessionTimelinePage, } from "./history.js";
+export type { TurnCommandInput, RetryReceipt } from "./control.js";
+export { UserFiles, FileUploadOutcomeUnknownError } from "./files.js";
+export type { UserFile, FileUploadCapabilities, CreateFileUploadInput, UploadFileInput, FileUpload, FileUploadStatus, FileUploadPart, UploadedFilePart, FileListOptions, FilePage, FileDownloadGrant, FileContent, } from "./files.js";
+export type { SessionEvent, SessionEventsOptions, ObserveTurnOptions, TurnObservation, } from "./progress.js";
+export type { BillingUsageFactKind, BillingCostBearer, BillingPrincipalBucket, BillingAttributionKind, BillingAuthKind, BillingLlmRequestPurpose, LlmPricingStatus, LlmPricingContextTier, SandboxUsageStatus, BillingUsageEvidenceStatus, BillingValuationStatus, BillingValuationSummary, BillingValuationBreakdown, BillingFactCompletenessCounters, BillingFactCompleteness, UserUsageScopeLevel, UserUsagePeriod, UserUsageScope, UserUsageRange, UsageTotals, BillingBearerCostTotals, BillingAttributionCounters, BillingAttributionBreakdown, LlmUsageAggregate, UserUsageAggregate, SandboxUsageAggregate, WebSearchUsageAggregate, UsageDayPoint, BillingUsageSeriesInterval, BillingUsageSeriesRange, BillingUsageSeriesLlmBreakdown, BillingUsageSeriesSandboxBreakdown, BillingUsageSeriesWebSearchBreakdown, BillingUsageSeriesBreakdown, BillingUsageSeriesBreakdownGroups, BillingUsageSeriesPoint, UserUsageSummary, UserLlmUsage, UserSandboxUsage, UserWebSearchUsage, UserUsageDetails, OrganizationUserUsageSummary, OrganizationLlmUsage, OrganizationSandboxUsage, OrganizationWebSearchUsage, OrganizationUsageItem, OrganizationUserUsageDetails, UserUsageOptions, UserUsageDetailsOptions, OrganizationUserUsageOptions, OrganizationUserUsageDetailsOptions, } from "./usage.js";
+export type { ClientToolDeclaration, ClientToolSet, ReplaceClientToolsOptions, PendingClientToolCall, ClientToolOutputInput, } from "./client-tools.js";
+export { UserSchedulers } from "./schedulers.js";
+export type { SchedulerSchedule, SchedulerDelivery, CreateSchedulerInput, UpdateSchedulerInput, Scheduler, SchedulerResponse, SchedulerPage, SchedulerListOptions, OrganizationSchedulerListOptions, SchedulerMutationOptions, SchedulerFire, SchedulerFirePage, } from "./schedulers.js";
+export { AudioTurnStoppedError } from "./audio.js";
+export type { AudioTurnInput, AudioTurnEvent, AudioTurnResult, } from "./audio.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":"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"}

package/dist/index.js

@@ -0,0 +1,12 @@
+/** TiDB Link OpenAPI version supported by this SDK release. */
+export const TIDB_LINK_API_VERSION = "0.0.1";
+/** Exact service baseline for the supported refreshed SDK surface. */
+export const TIDB_LINK_REVISION = "882287809f91d9a3fdf60537460431d9f0fc23e7";
+export { TiDBLinkApiError, TiDBLinkError, ConflictError, ConnectionError, TurnWaitTimeoutError, InputNotAppliedError, OutcomeUnknownError, ObservationStoppedError, TurnFailedError, TurnInterruptedError, } from "./errors.js";
+export { OrganizationClient } from "./organization.js";
+export { Agent, EndUserClient, UserClient } from "./user.js";
+export { Session } from "./session.js";
+export { UserFiles, FileUploadOutcomeUnknownError } from "./files.js";
+export { UserSchedulers } from "./schedulers.js";
+export { AudioTurnStoppedError } from "./audio.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,+DAA+D;AAC/D,MAAM,CAAC,MAAM,qBAAqB,GAAG,OAAgB,CAAC;AACtD,sEAAsE;AACtE,MAAM,CAAC,MAAM,kBAAkB,GAC7B,0CAAmD,CAAC;AAEtD,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,EACvB,eAAe,EACf,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAUvD,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAY7D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAsDvC,OAAO,EAAE,SAAS,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAkFtE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAgBjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC"}

package/dist/organization.d.ts

@@ -0,0 +1,70 @@
+import { type OrganizationUserUsageOptions, type OrganizationUserUsageDetailsOptions, type OrganizationUserUsageSummary, type OrganizationUserUsageDetails } from "./usage.js";
+import { EndUserClient, type AgentRecord } from "./user.js";
+export interface OrganizationClientOptions {
+    baseUrl: string;
+    apiKey: string;
+}
+export interface Organization {
+    organizationId: string;
+    slug: string;
+    name: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface EndUser {
+    userId: string;
+    organizationId: string;
+    displayName: string | null;
+    externalId: string | null;
+    status: "active" | "disabled";
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateEndUserInput {
+    displayName?: string;
+    externalId?: string;
+}
+export interface RequestOptions {
+    requestId?: string;
+    signal?: AbortSignal;
+}
+export interface UserApiKey {
+    apiKeyId: string;
+    organizationId: string;
+    userId: string;
+    name: string;
+    tokenPrefix: string;
+    status: "active" | "revoked";
+    createdByUserId: string | null;
+    createdByOrganizationApiKeyId: string | null;
+    createdAt: string;
+    updatedAt: string;
+    lastUsedAt: string | null;
+    revokedAt: string | null;
+}
+export interface IssuedUserApiKey {
+    apiKey: UserApiKey;
+    /** Available only in the successful create or rotate response. */
+    token: string;
+}
+/** Customer operations authorized by an Organization API Key. */
+export declare class OrganizationClient {
+    #private;
+    constructor(options: OrganizationClientOptions);
+    /** Select the ordinary resource owner without issuing or impersonating a User API Key. */
+    user(userId: string): EndUserClient;
+    unlinkAgent(userId: string, agentId: string, options?: RequestOptions): Promise<AgentRecord>;
+    getUserUsage(userId: string, options: OrganizationUserUsageOptions): Promise<OrganizationUserUsageSummary>;
+    getUserUsageDetails(userId: string, options: OrganizationUserUsageDetailsOptions): Promise<OrganizationUserUsageDetails>;
+    getOrganization(options?: RequestOptions): Promise<Organization>;
+    createEndUser(input?: CreateEndUserInput, options?: RequestOptions): Promise<EndUser>;
+    listEndUsers(options?: RequestOptions): Promise<EndUser[]>;
+    getEndUser(userId: string, options?: RequestOptions): Promise<EndUser>;
+    createUserApiKey(userId: string, input: {
+        name: string;
+    }, options?: RequestOptions): Promise<IssuedUserApiKey>;
+    listUserApiKeys(userId: string, options?: RequestOptions): Promise<UserApiKey[]>;
+    rotateUserApiKey(apiKeyId: string, options?: RequestOptions): Promise<IssuedUserApiKey>;
+    revokeUserApiKey(apiKeyId: string, options?: RequestOptions): Promise<UserApiKey>;
+}
+//# sourceMappingURL=organization.d.ts.map

package/dist/organization.d.ts.map

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

package/dist/organization.js

@@ -0,0 +1,118 @@
+import { usageQuery, userUsagePath, } from "./usage.js";
+import { EndUserClient } from "./user.js";
+import { OutcomeUnknownError } from "./errors.js";
+import { HttpClient, isApiKey, requireKnownKeys, requestOptions, } from "./http.js";
+const unusableCredentialReceipt = (requestId) => {
+    throw new OutcomeUnknownError("TiDB Link accepted the credential request but returned an unusable receipt", { requestId });
+};
+const userApiKeyReceipt = (value, requestId, expected) => {
+    const apiKey = value;
+    if (typeof apiKey !== "object" ||
+        apiKey === null ||
+        Array.isArray(apiKey) ||
+        ![apiKey.apiKeyId, apiKey.userId, apiKey.organizationId].every((id) => typeof id === "string" && id.length > 0) ||
+        (expected.userId !== undefined && apiKey.userId !== expected.userId) ||
+        (expected.apiKeyId !== undefined && apiKey.apiKeyId !== expected.apiKeyId) ||
+        apiKey.status !== expected.status ||
+        (expected.status === "active"
+            ? apiKey.revokedAt !== null
+            : typeof apiKey.revokedAt !== "string" ||
+                !Number.isFinite(Date.parse(apiKey.revokedAt))))
+        return unusableCredentialReceipt(requestId);
+    return apiKey;
+};
+const issuedUserApiKey = (value, requestId, expected) => {
+    const result = value;
+    const apiKey = userApiKeyReceipt(result?.apiKey, requestId, {
+        ...expected,
+        status: "active",
+    });
+    if (!isApiKey(result?.token, "user"))
+        return unusableCredentialReceipt(requestId);
+    // Token bodies omit the persistent row's uak_ marker.
+    const tokenId = result.token.split("_")[2];
+    if (apiKey.apiKeyId !== `uak_${tokenId}` ||
+        apiKey.tokenPrefix !== `ti_user_${tokenId}_`)
+        return unusableCredentialReceipt(requestId);
+    return { apiKey, token: result.token };
+};
+/** Customer operations authorized by an Organization API Key. */
+export class OrganizationClient {
+    #http;
+    constructor(options) {
+        requireKnownKeys(options, ["baseUrl", "apiKey"], "OrganizationClient options");
+        if (!isApiKey(options.apiKey, "org")) {
+            throw new TypeError("OrganizationClient requires an Organization API Key");
+        }
+        this.#http = new HttpClient(options);
+    }
+    /** Select the ordinary resource owner without issuing or impersonating a User API Key. */
+    user(userId) {
+        return new EndUserClient(this.#http.forUser(userId));
+    }
+    async unlinkAgent(userId, agentId, options) {
+        const result = await this.#http.deleteResponse(`/api/v1/org/users/${encodeURIComponent(userId)}/agents/${encodeURIComponent(agentId)}`, { ...requestOptions(options), outcomeUnknown: true });
+        if (typeof result.data?.agent?.agentId !== "string" ||
+            !result.data.agent.agentId)
+            throw new OutcomeUnknownError("Agent unlink returned no usable receipt; reconcile the association", { requestId: result.requestId });
+        return result.data.agent;
+    }
+    getUserUsage(userId, options) {
+        const path = userUsagePath(userId, options);
+        return this.#http.get(`${path}${usageQuery(options, ["from", "to", "interval", "tagKey", "tagValue"])}`, options);
+    }
+    getUserUsageDetails(userId, options) {
+        const path = userUsagePath(userId, options);
+        return this.#http.get(`${path}/details${usageQuery(options, ["from", "to", "kind", "limit", "cursor", "tagKey", "tagValue"])}`, options);
+    }
+    async getOrganization(options) {
+        const response = await this.#http.get("/api/v1/org", requestOptions(options));
+        return response.organization;
+    }
+    async createEndUser(input = {}, options) {
+        const result = await this.#http.postResponse("/api/v1/org/users", {
+            ...(input.displayName === undefined
+                ? {}
+                : { displayName: input.displayName }),
+            ...(input.externalId === undefined
+                ? {}
+                : { externalId: input.externalId }),
+        }, { ...requestOptions(options), outcomeUnknown: true });
+        if (!result.data?.user ||
+            typeof result.data.user.userId !== "string" ||
+            !result.data.user.userId) {
+            throw new OutcomeUnknownError("End User creation returned no usable User; reconcile by externalId", {
+                requestId: result.requestId,
+            });
+        }
+        return result.data.user;
+    }
+    async listEndUsers(options) {
+        const response = await this.#http.get("/api/v1/org/users", requestOptions(options));
+        return response.users;
+    }
+    async getEndUser(userId, options) {
+        const response = await this.#http.get(`/api/v1/org/users/${encodeURIComponent(userId)}`, requestOptions(options));
+        return response.user;
+    }
+    async createUserApiKey(userId, input, options) {
+        const result = await this.#http.postResponse(`/api/v1/org/users/${encodeURIComponent(userId)}/api-keys`, { name: input.name }, { ...requestOptions(options), outcomeUnknown: true });
+        return issuedUserApiKey(result.data, result.requestId, { userId });
+    }
+    async listUserApiKeys(userId, options) {
+        const response = await this.#http.get(`/api/v1/org/users/${encodeURIComponent(userId)}/api-keys`, requestOptions(options));
+        return response.apiKeys;
+    }
+    async rotateUserApiKey(apiKeyId, options) {
+        const result = await this.#http.postResponse(`/api/v1/org/user-api-keys/${encodeURIComponent(apiKeyId)}/rotate`, undefined, { ...requestOptions(options), outcomeUnknown: true });
+        return issuedUserApiKey(result.data, result.requestId, { apiKeyId });
+    }
+    async revokeUserApiKey(apiKeyId, options) {
+        const result = await this.#http.postResponse(`/api/v1/org/user-api-keys/${encodeURIComponent(apiKeyId)}/revoke`, undefined, { ...requestOptions(options), outcomeUnknown: true });
+        return userApiKeyReceipt(result.data?.apiKey, result.requestId, {
+            apiKeyId,
+            status: "revoked",
+        });
+    }
+}
+//# sourceMappingURL=organization.js.map

package/dist/organization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"organization.js","sourceRoot":"","sources":["../src/organization.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,aAAa,GAKd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAoB,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EACL,UAAU,EACV,QAAQ,EACR,gBAAgB,EAChB,cAAc,GACf,MAAM,WAAW,CAAC;AAwDnB,MAAM,yBAAyB,GAAG,CAAC,SAAiB,EAAS,EAAE;IAC7D,MAAM,IAAI,mBAAmB,CAC3B,4EAA4E,EAC5E,EAAE,SAAS,EAAE,CACd,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,CACxB,KAAc,EACd,SAAiB,EACjB,QACkD,EACtC,EAAE;IACd,MAAM,MAAM,GAAG,KAAsC,CAAC;IACtD,IACE,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI;QACf,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QACrB,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC,KAAK,CAC5D,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAChD;QACD,CAAC,QAAQ,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,CAAC;QACpE,CAAC,QAAQ,CAAC,QAAQ,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC,QAAQ,CAAC;QAC1E,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM;QACjC,CAAC,QAAQ,CAAC,MAAM,KAAK,QAAQ;YAC3B,CAAC,CAAC,MAAM,CAAC,SAAS,KAAK,IAAI;YAC3B,CAAC,CAAC,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;gBACpC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QAEnD,OAAO,yBAAyB,CAAC,SAAS,CAAC,CAAC;IAC9C,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CACvB,KAAc,EACd,SAAiB,EACjB,QAAmD,EACjC,EAAE;IACpB,MAAM,MAAM,GAAG,KAAqD,CAAC;IACrE,MAAM,MAAM,GAAG,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE;QAC1D,GAAG,QAAQ;QACX,MAAM,EAAE,QAAQ;KACjB,CAAC,CAAC;IACH,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC;QAClC,OAAO,yBAAyB,CAAC,SAAS,CAAC,CAAC;IAC9C,sDAAsD;IACtD,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;IAC5C,IACE,MAAM,CAAC,QAAQ,KAAK,OAAO,OAAO,EAAE;QACpC,MAAM,CAAC,WAAW,KAAK,WAAW,OAAO,GAAG;QAE5C,OAAO,yBAAyB,CAAC,SAAS,CAAC,CAAC;IAC9C,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;AACzC,CAAC,CAAC;AAEF,iEAAiE;AACjE,MAAM,OAAO,kBAAkB;IACpB,KAAK,CAAa;IAE3B,YAAY,OAAkC;QAC5C,gBAAgB,CACd,OAAO,EACP,CAAC,SAAS,EAAE,QAAQ,CAAC,EACrB,4BAA4B,CAC7B,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,SAAS,CACjB,qDAAqD,CACtD,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,0FAA0F;IAC1F,IAAI,CAAC,MAAc;QACjB,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,WAAW,CACf,MAAc,EACd,OAAe,EACf,OAAwB;QAExB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,CAC5C,qBAAqB,kBAAkB,CAAC,MAAM,CAAC,WAAW,kBAAkB,CAAC,OAAO,CAAC,EAAE,EACvF,EAAE,GAAG,cAAc,CAAC,OAAO,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,CACrD,CAAC;QACF,IACE,OAAO,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,KAAK,QAAQ;YAC/C,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO;YAE1B,MAAM,IAAI,mBAAmB,CAC3B,oEAAoE,EACpE,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAChC,CAAC;QACJ,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;IAC3B,CAAC;IAED,YAAY,CACV,MAAc,EACd,OAAqC;QAErC,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CACnB,GAAG,IAAI,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,EAAE,EACjF,OAAO,CACR,CAAC;IACJ,CAAC;IAED,mBAAmB,CACjB,MAAc,EACd,OAA4C;QAE5C,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CACnB,GAAG,IAAI,WAAW,UAAU,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,EAAE,EACxG,OAAO,CACR,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,OAAwB;QAC5C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CACnC,aAAa,EACb,cAAc,CAAC,OAAO,CAAC,CACxB,CAAC;QACF,OAAO,QAAQ,CAAC,YAAY,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,aAAa,CACjB,QAA4B,EAAE,EAC9B,OAAwB;QAExB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,CAC1C,mBAAmB,EACnB;YACE,GAAG,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS;gBACjC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC;YACvC,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS;gBAChC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC;SACtC,EACD,EAAE,GAAG,cAAc,CAAC,OAAO,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,CACrD,CAAC;QACF,IACE,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI;YAClB,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ;YAC3C,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EACxB,CAAC;YACD,MAAM,IAAI,mBAAmB,CAC3B,oEAAoE,EACpE;gBACE,SAAS,EAAE,MAAM,CAAC,SAAS;aAC5B,CACF,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,OAAwB;QACzC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CACnC,mBAAmB,EACnB,cAAc,CAAC,OAAO,CAAC,CACxB,CAAC;QACF,OAAO,QAAQ,CAAC,KAAK,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAc,EAAE,OAAwB;QACvD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CACnC,qBAAqB,kBAAkB,CAAC,MAAM,CAAC,EAAE,EACjD,cAAc,CAAC,OAAO,CAAC,CACxB,CAAC;QACF,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,MAAc,EACd,KAAuB,EACvB,OAAwB;QAExB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,CAC1C,qBAAqB,kBAAkB,CAAC,MAAM,CAAC,WAAW,EAC1D,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,EACpB,EAAE,GAAG,cAAc,CAAC,OAAO,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,CACrD,CAAC;QACF,OAAO,gBAAgB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,eAAe,CACnB,MAAc,EACd,OAAwB;QAExB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CACnC,qBAAqB,kBAAkB,CAAC,MAAM,CAAC,WAAW,EAC1D,cAAc,CAAC,OAAO,CAAC,CACxB,CAAC;QACF,OAAO,QAAQ,CAAC,OAAO,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,QAAgB,EAChB,OAAwB;QAExB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,CAC1C,6BAA6B,kBAAkB,CAAC,QAAQ,CAAC,SAAS,EAClE,SAAS,EACT,EAAE,GAAG,cAAc,CAAC,OAAO,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,CACrD,CAAC;QACF,OAAO,gBAAgB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,SAAS,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,QAAgB,EAChB,OAAwB;QAExB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,CAC1C,6BAA6B,kBAAkB,CAAC,QAAQ,CAAC,SAAS,EAClE,SAAS,EACT,EAAE,GAAG,cAAc,CAAC,OAAO,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,CACrD,CAAC;QACF,OAAO,iBAAiB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE;YAC9D,QAAQ;YACR,MAAM,EAAE,SAAS;SAClB,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/progress.d.ts

@@ -0,0 +1,34 @@
+import { type TurnResult } from "./turn.js";
+import { HttpClient } from "./http.js";
+import type { RequestOptions } from "./organization.js";
+export interface SessionEventsOptions extends RequestOptions {
+    /** Opaque position from a previously received event. No automatic replay on refusal. */
+    cursor?: string;
+}
+/** Display events remain provisional; use the original interaction to establish its result. */
+export interface SessionEvent {
+    cursor: string;
+    type: string;
+    sessionId: string;
+    turnId: string | null;
+    createdAt: string;
+    data: Record<string, unknown>;
+}
+export declare function sessionEvents(http: HttpClient, sessionId: string, options?: SessionEventsOptions): AsyncGenerator<SessionEvent>;
+export interface ObserveTurnOptions extends SessionEventsOptions {
+    /** Local observation deadline only; default 60 seconds. */
+    timeoutMs?: number;
+}
+export type TurnObservation = {
+    type: "draft" | "progress";
+    text: string;
+    event: SessionEvent;
+} | {
+    type: "event";
+    event: SessionEvent;
+} | {
+    type: "result";
+    result: TurnResult;
+};
+export declare function observeTurn(http: HttpClient, sessionId: string, inputId: string, options?: ObserveTurnOptions): AsyncGenerator<TurnObservation>;
+//# sourceMappingURL=progress.d.ts.map

package/dist/progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../src/progress.ts"],"names":[],"mappings":"AACA,OAAO,EAAsC,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAShF,OAAO,EAAE,UAAU,EAAwC,MAAM,WAAW,CAAC;AAC7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IAC1D,wFAAwF;IACxF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,+FAA+F;AAC/F,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,wBAAuB,aAAa,CAClC,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,oBAAyB,GACjC,cAAc,CAAC,YAAY,CAAC,CA+D9B;AAED,MAAM,WAAW,kBAAmB,SAAQ,oBAAoB;IAC9D,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,OAAO,GAAG,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC;AAE3C,wBAAuB,WAAW,CAChC,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,kBAAuB,GAC/B,cAAc,CAAC,eAAe,CAAC,CAwHjC"}