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

package/dist/progress.js

@@ -0,0 +1,154 @@
+import { getInteraction } from "./history.js";
+import { waitForResult, validateWaitOptions } from "./turn.js";
+import { TiDBLinkError, TiDBLinkApiError, TurnFailedError, TurnInterruptedError, InputNotAppliedError, ObservationStoppedError, } from "./errors.js";
+import { HttpClient, requireKnownKeys, requireCreationKey } from "./http.js";
+import { decodeSse } from "./sse.js";
+export async function* sessionEvents(http, sessionId, options = {}) {
+    requireKnownKeys(options, ["cursor", "signal", "requestId"], "Event subscription options");
+    if (options.cursor !== undefined &&
+        (typeof options.cursor !== "string" || !options.cursor))
+        throw new TypeError("cursor must be a non-empty opaque event position");
+    const query = new URLSearchParams({ stream: "true" });
+    if (options.cursor !== undefined)
+        query.set("cursor", options.cursor);
+    const { response, requestId } = await http.rawResponse(`/api/v1/user/sessions/${encodeURIComponent(sessionId)}/events?${query}`, {
+        headers: { accept: "text/event-stream" },
+        ...(options.signal ? { signal: options.signal } : {}),
+        ...(options.requestId ? { requestId: options.requestId } : {}),
+    });
+    if (response.headers
+        .get("content-type")
+        ?.split(";", 1)[0]
+        ?.trim()
+        .toLowerCase() !== "text/event-stream" ||
+        !response.body) {
+        await response.body?.cancel();
+        throw new TiDBLinkError("Session subscription returned no event stream", {
+            requestId,
+        });
+    }
+    for await (const frame of decodeSse(response.body)) {
+        let value;
+        try {
+            value = JSON.parse(frame.data);
+        }
+        catch (cause) {
+            throw new TiDBLinkError("Session subscription returned invalid event JSON", { requestId, cause });
+        }
+        const event = value;
+        if (!frame.id ||
+            !event ||
+            typeof event.type !== "string" ||
+            !event.type ||
+            event.sessionId !== sessionId ||
+            (event.turnId !== null && typeof event.turnId !== "string") ||
+            typeof event.createdAt !== "string" ||
+            typeof event.data !== "object" ||
+            event.data === null ||
+            Array.isArray(event.data))
+            throw new TiDBLinkError("Session subscription returned an invalid event envelope", { requestId });
+        yield { ...event, cursor: frame.id };
+    }
+}
+export async function* observeTurn(http, sessionId, inputId, options = {}) {
+    requireKnownKeys(options, ["cursor", "signal", "requestId", "timeoutMs"], "Turn observation options");
+    requireCreationKey(inputId);
+    const { timeoutMs } = validateWaitOptions(options.timeoutMs === undefined ? {} : { timeoutMs: options.timeoutMs });
+    const deadline = new AbortController();
+    const timer = setTimeout(() => deadline.abort(), timeoutMs);
+    const signal = options.signal
+        ? AbortSignal.any([options.signal, deadline.signal])
+        : deadline.signal;
+    const request = {
+        signal,
+        ...(options.requestId ? { requestId: options.requestId } : {}),
+    };
+    let cursor = options.cursor;
+    let turnId;
+    try {
+        const receipt = await getInteraction(http, sessionId, inputId, request);
+        turnId = receipt.turnId;
+        if (receipt.kind !== "message" && receipt.kind !== "retry")
+            throw new TiDBLinkError("Turn observation requires a message or checkpoint retry receipt");
+        if (receipt.rejection ||
+            receipt.mode === "rejected" ||
+            receipt.result.status !== "running") {
+            yield {
+                type: "result",
+                result: await waitForResult(http, sessionId, inputId, {
+                    ...request,
+                    timeoutMs,
+                }),
+            };
+            return;
+        }
+        for await (const event of sessionEvents(http, sessionId, {
+            ...request,
+            ...(cursor ? { cursor } : {}),
+        })) {
+            cursor = event.cursor;
+            if (event.turnId !== turnId)
+                continue;
+            const payload = event.data.payload;
+            if (event.type === "agent.session.turn.output_text.snapshot" ||
+                event.type === "agent.session.turn.progress") {
+                if (typeof payload !== "object" ||
+                    payload === null ||
+                    typeof payload.text !== "string")
+                    throw new TiDBLinkError("Session text event omitted its complete text");
+                yield {
+                    type: event.type === "agent.session.turn.output_text.snapshot"
+                        ? "draft"
+                        : "progress",
+                    text: payload.text,
+                    event,
+                };
+            }
+            else
+                yield { type: "event", event };
+            if (event.data.event === "turn_finished" ||
+                event.data.event === "turn_error") {
+                // Replayed terminal events may belong to another execution of this Turn.
+                const current = await getInteraction(http, sessionId, inputId, request);
+                if (current.result.status === "running")
+                    continue;
+                yield {
+                    type: "result",
+                    result: await waitForResult(http, sessionId, inputId, {
+                        ...request,
+                        timeoutMs,
+                    }),
+                };
+                return;
+            }
+        }
+        throw new TiDBLinkError("Session event subscription ended before the original result was established");
+    }
+    catch (cause) {
+        if (cause instanceof TiDBLinkApiError ||
+            cause instanceof TurnFailedError ||
+            cause instanceof TurnInterruptedError ||
+            cause instanceof InputNotAppliedError)
+            throw cause;
+        throw new ObservationStoppedError(deadline.signal.aborted && !options.signal?.aborted
+            ? "Local observation timed out; recover the original input"
+            : "Observation stopped; recover the original input", {
+            sessionId,
+            inputId,
+            ...(turnId ? { turnId } : {}),
+            ...(cursor ? { cursor } : {}),
+            ...(cause instanceof TiDBLinkError && cause.requestId
+                ? { requestId: cause.requestId }
+                : options.requestId
+                    ? { requestId: options.requestId }
+                    : {}),
+            timedOut: deadline.signal.aborted && !options.signal?.aborted,
+            cause,
+        });
+    }
+    finally {
+        clearTimeout(timer);
+        deadline.abort();
+    }
+}
+//# sourceMappingURL=progress.js.map

package/dist/progress.js.map

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

package/dist/realtime.d.ts

@@ -0,0 +1,91 @@
+export type RealtimeLanguage = "zh-CN" | "en-US";
+export type RealtimeEndpointingMode = "client" | "server";
+export interface RealtimePcm16AudioFormat {
+    encoding: "pcm16";
+    sampleRate: number;
+    channels: 1;
+}
+export interface RealtimeOpusAudioFormat {
+    encoding: "opus";
+    sampleRate: number;
+    channels: 1;
+    packetDurationMs: number;
+    bitrate?: 16000 | 24000 | 32000;
+}
+export type RealtimeAudioFormat = RealtimePcm16AudioFormat | RealtimeOpusAudioFormat;
+export interface RealtimeModel {
+    id: string;
+    label: string;
+    available: boolean;
+    isDefault: boolean;
+    languages: RealtimeLanguage[];
+    endpointingModes: RealtimeEndpointingMode[];
+    audio: {
+        input: RealtimeAudioFormat[];
+        output: RealtimeAudioFormat[];
+    };
+}
+export interface RealtimeModelCatalog {
+    defaultModel: string | null;
+    models: RealtimeModel[];
+}
+export interface RealtimeVoiceSetting {
+    language: RealtimeLanguage;
+}
+export interface RealtimeModelSelection {
+    model: string | null;
+    revision: number;
+    etag: string;
+    voice: RealtimeVoiceSetting | null;
+}
+export interface RealtimeSessionSelectionFields {
+    realtimeModel: string | null;
+    realtimeModelRevision: number;
+    realtimeModelEtag: string;
+    realtimeVoice: RealtimeVoiceSetting | null;
+}
+export declare const realtimeModelSelectionFrom: (session: RealtimeSessionSelectionFields) => RealtimeModelSelection;
+export interface RealtimeAudioFormats {
+    input: RealtimeAudioFormat;
+    output: RealtimeAudioFormat;
+}
+export interface OpenRealtimeConnectionInput {
+    audio?: Partial<RealtimeAudioFormats>;
+    metadata?: Record<string, string>;
+}
+export interface RealtimeConnection {
+    object: "realtime_connection";
+    id: string;
+    sessionId: string;
+    agentId: string;
+    provider: {
+        name: string;
+        region: string | null;
+        model: string | null;
+    };
+    status: "connecting" | "active" | "paused" | "ended";
+    audio: RealtimeAudioFormats;
+    activeTaskTurnId: string | null;
+    usage: {
+        inputAudioSec: number;
+        outputAudioSec: number;
+        thoughtTokens: number;
+        textTokens: number;
+    };
+    metadata: Record<string, string>;
+    createdAt: string;
+    endedAt: string | null;
+}
+export interface RealtimeConnectGrant {
+    websocketUrl: string;
+    connectToken: string;
+    connectTokenExpiresAt: string;
+}
+export interface OpenRealtimeConnectionResult extends RealtimeConnectGrant {
+    realtimeConnection: RealtimeConnection;
+}
+export declare const requireRealtimeModelSelectionReceipt: (value: unknown, requestId: string) => RealtimeModelSelection;
+export declare const requireOpenRealtimeConnectionReceipt: (value: unknown, requestId: string) => OpenRealtimeConnectionResult;
+export declare const requireRealtimeConnectGrantReceipt: (value: unknown, requestId: string) => RealtimeConnectGrant;
+export declare const requireRealtimeConnectionReceipt: (value: unknown, requestId: string) => RealtimeConnection;
+//# sourceMappingURL=realtime.d.ts.map

package/dist/realtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.d.ts","sourceRoot":"","sources":["../src/realtime.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,OAAO,CAAC;AACjD,MAAM,MAAM,uBAAuB,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE1D,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,CAAC,CAAC;CACb;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,CAAC,CAAC;IACZ,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;CACjC;AAED,MAAM,MAAM,mBAAmB,GAC3B,wBAAwB,GACxB,uBAAuB,CAAC;AAE5B,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,gBAAgB,EAAE,uBAAuB,EAAE,CAAC;IAC5C,KAAK,EAAE;QACL,KAAK,EAAE,mBAAmB,EAAE,CAAC;QAC7B,MAAM,EAAE,mBAAmB,EAAE,CAAC;KAC/B,CAAC;CACH;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,8BAA8B;IAC7C,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,oBAAoB,GAAG,IAAI,CAAC;CAC5C;AAED,eAAO,MAAM,0BAA0B,GACrC,SAAS,8BAA8B,KACtC,sBAKD,CAAC;AAEH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,mBAAmB,CAAC;IAC3B,MAAM,EAAE,mBAAmB,CAAC;CAC7B;AAED,MAAM,WAAW,2BAA2B;IAC1C,KAAK,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,qBAAqB,CAAC;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;KACtB,CAAC;IACF,MAAM,EAAE,YAAY,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;IACrD,KAAK,EAAE,oBAAoB,CAAC;IAC5B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,KAAK,EAAE;QACL,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;QACvB,aAAa,EAAE,MAAM,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,4BAA6B,SAAQ,oBAAoB;IACxE,kBAAkB,EAAE,kBAAkB,CAAC;CACxC;AA8FD,eAAO,MAAM,oCAAoC,GAC/C,OAAO,OAAO,EACd,WAAW,MAAM,KAChB,sBAeF,CAAC;AAEF,eAAO,MAAM,oCAAoC,GAC/C,OAAO,OAAO,EACd,WAAW,MAAM,KAChB,4BAQF,CAAC;AAEF,eAAO,MAAM,kCAAkC,GAC7C,OAAO,OAAO,EACd,WAAW,MAAM,KAChB,oBAIF,CAAC;AAEF,eAAO,MAAM,gCAAgC,GAC3C,OAAO,OAAO,EACd,WAAW,MAAM,KAChB,kBAIF,CAAC"}

package/dist/realtime.js

@@ -0,0 +1,112 @@
+import { OutcomeUnknownError } from "./errors.js";
+export const realtimeModelSelectionFrom = (session) => ({
+    model: session.realtimeModel,
+    revision: session.realtimeModelRevision,
+    etag: session.realtimeModelEtag,
+    voice: session.realtimeVoice,
+});
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const isString = (value) => typeof value === "string" && value.length > 0;
+const isNullableString = (value) => value === null || typeof value === "string";
+const isNumber = (value) => typeof value === "number" && Number.isFinite(value) && value >= 0;
+const isDateTime = (value) => typeof value === "string" && Number.isFinite(Date.parse(value));
+const isAudioFormat = (value) => {
+    if (!isRecord(value) ||
+        !isNumber(value.sampleRate) ||
+        value.sampleRate <= 0 ||
+        value.channels !== 1)
+        return false;
+    if (value.encoding === "pcm16")
+        return true;
+    return (value.encoding === "opus" &&
+        Number.isInteger(value.packetDurationMs) &&
+        isNumber(value.packetDurationMs) &&
+        value.packetDurationMs > 0 &&
+        (value.bitrate === undefined ||
+            value.bitrate === 16000 ||
+            value.bitrate === 24000 ||
+            value.bitrate === 32000));
+};
+const isRealtimeConnection = (value) => {
+    if (!isRecord(value))
+        return false;
+    const provider = value.provider;
+    const audio = value.audio;
+    const usage = value.usage;
+    const metadata = value.metadata;
+    return (value.object === "realtime_connection" &&
+        isString(value.id) &&
+        isString(value.sessionId) &&
+        isString(value.agentId) &&
+        isRecord(provider) &&
+        isString(provider.name) &&
+        isNullableString(provider.region) &&
+        isNullableString(provider.model) &&
+        ["connecting", "active", "paused", "ended"].includes(String(value.status)) &&
+        isRecord(audio) &&
+        isAudioFormat(audio.input) &&
+        isAudioFormat(audio.output) &&
+        isNullableString(value.activeTaskTurnId) &&
+        isRecord(usage) &&
+        isNumber(usage.inputAudioSec) &&
+        isNumber(usage.outputAudioSec) &&
+        Number.isInteger(usage.thoughtTokens) &&
+        isNumber(usage.thoughtTokens) &&
+        Number.isInteger(usage.textTokens) &&
+        isNumber(usage.textTokens) &&
+        isRecord(metadata) &&
+        Object.values(metadata).every((entry) => typeof entry === "string") &&
+        isDateTime(value.createdAt) &&
+        (value.endedAt === null || isDateTime(value.endedAt)));
+};
+const isConnectGrant = (value) => {
+    if (!isRecord(value) || !isString(value.websocketUrl))
+        return false;
+    let protocol;
+    try {
+        protocol = new URL(value.websocketUrl).protocol;
+    }
+    catch {
+        return false;
+    }
+    return ((protocol === "ws:" || protocol === "wss:") &&
+        typeof value.connectToken === "string" &&
+        /^rct_[A-Za-z0-9_-]{43}$/u.test(value.connectToken) &&
+        isDateTime(value.connectTokenExpiresAt));
+};
+const unusableReceipt = (operation, requestId) => {
+    throw new OutcomeUnknownError(`TiDB Link accepted ${operation} but returned an unusable receipt`, { requestId });
+};
+export const requireRealtimeModelSelectionReceipt = (value, requestId) => {
+    if (!isRecord(value))
+        return unusableReceipt("the Realtime Model selection", requestId);
+    const voice = value.realtimeVoice;
+    if (!isNullableString(value.realtimeModel) ||
+        !Number.isInteger(value.realtimeModelRevision) ||
+        !isNumber(value.realtimeModelRevision) ||
+        value.realtimeModelRevision <= 0 ||
+        !isString(value.realtimeModelEtag) ||
+        (voice !== null &&
+            (!isRecord(voice) ||
+                (voice.language !== "zh-CN" && voice.language !== "en-US"))))
+        return unusableReceipt("the Realtime Model selection", requestId);
+    return realtimeModelSelectionFrom(value);
+};
+export const requireOpenRealtimeConnectionReceipt = (value, requestId) => {
+    if (!isRecord(value) ||
+        !isRealtimeConnection(value.realtimeConnection) ||
+        !isConnectGrant(value))
+        return unusableReceipt("the Realtime Connection request", requestId);
+    return value;
+};
+export const requireRealtimeConnectGrantReceipt = (value, requestId) => {
+    if (!isConnectGrant(value))
+        return unusableReceipt("the Realtime connect-token request", requestId);
+    return value;
+};
+export const requireRealtimeConnectionReceipt = (value, requestId) => {
+    if (!isRecord(value) || !isRealtimeConnection(value.realtimeConnection))
+        return unusableReceipt("the Realtime Connection mutation", requestId);
+    return value.realtimeConnection;
+};
+//# sourceMappingURL=realtime.js.map

package/dist/realtime.js.map

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

package/dist/schedulers.d.ts

@@ -0,0 +1,129 @@
+import { HttpClient, type ListOptions } from "./http.js";
+import type { RequestOptions } from "./organization.js";
+export type SchedulerSchedule = {
+    kind: "once";
+    runAt: string;
+    after?: never;
+} | {
+    kind: "once";
+    after: string;
+    runAt?: never;
+} | {
+    kind: "cron";
+    cronExpr: string;
+    timezone: string;
+};
+export type SchedulerDelivery = {
+    target: "new_session";
+} | {
+    target: "bound_session";
+    sessionId: string;
+};
+export type CreateSchedulerInput = RequestOptions & {
+    idempotencyKey: string;
+    title: string;
+    prompt: string;
+    schedule: SchedulerSchedule;
+    validFrom?: string | null;
+    validUntil?: string | null;
+} & ({
+    agentId: string;
+    delivery?: {
+        target: "new_session";
+    };
+} | {
+    agentId?: never;
+    delivery: {
+        target: "bound_session";
+        sessionId: string;
+    };
+});
+export interface UpdateSchedulerInput {
+    title?: string;
+    prompt?: string;
+    agentId?: string;
+    delivery?: SchedulerDelivery;
+    schedule?: SchedulerSchedule;
+    enabled?: boolean;
+    validFrom?: string | null;
+    validUntil?: string | null;
+    snoozeUntil?: string;
+}
+export interface Scheduler {
+    schedulerId: string;
+    ownerUserId: string;
+    organizationId: string;
+    agentId: string;
+    title: string;
+    prompt: string;
+    delivery: {
+        target: "new_session" | "bound_session";
+        sessionId: string | null;
+    };
+    schedule: {
+        kind: "once" | "cron";
+        cronExpr: string | null;
+        runAt: string | null;
+        timezone: string;
+    };
+    validFrom: string | null;
+    validUntil: string | null;
+    /** Deleted records are returned only by Organization-owned list history. */
+    status: "enabled" | "disabled" | "deleted";
+    nextFireAt: string | null;
+    lastFiredAt: string | null;
+    revision: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface SchedulerResponse {
+    scheduler: Scheduler;
+    etag: string;
+}
+export interface SchedulerPage {
+    schedulers: Scheduler[];
+    nextCursor: string | null;
+}
+export interface SchedulerListOptions extends ListOptions {
+    status?: "enabled" | "disabled";
+}
+export interface OrganizationSchedulerListOptions extends ListOptions {
+    status?: Scheduler["status"];
+}
+export interface SchedulerMutationOptions extends RequestOptions {
+    ifMatch: string;
+}
+export interface SchedulerFire {
+    fireId: string;
+    schedulerId: string;
+    scheduledFor: string;
+    executionStatus: "pending" | "completed" | "failed";
+    execution: {
+        agentId: string;
+        prompt: string;
+        delivery: Scheduler["delivery"];
+    };
+    result: {
+        sessionId: string | null;
+        turnId: string | null;
+        messageId: string | null;
+        failureCode: string | null;
+    };
+    createdAt: string;
+    settledAt: string | null;
+}
+export interface SchedulerFirePage {
+    fires: SchedulerFire[];
+    nextCursor: string | null;
+}
+export declare class UserSchedulers<TListOptions extends OrganizationSchedulerListOptions = SchedulerListOptions> {
+    #private;
+    constructor(http: HttpClient);
+    create(input: CreateSchedulerInput): Promise<SchedulerResponse>;
+    get(schedulerId: string, options?: RequestOptions): Promise<SchedulerResponse>;
+    update(schedulerId: string, input: UpdateSchedulerInput, options: SchedulerMutationOptions): Promise<SchedulerResponse>;
+    delete(schedulerId: string, options: SchedulerMutationOptions): Promise<void>;
+    list(options?: TListOptions): Promise<SchedulerPage>;
+    fires(schedulerId: string, options?: ListOptions): Promise<SchedulerFirePage>;
+}
+//# sourceMappingURL=schedulers.d.ts.map

package/dist/schedulers.d.ts.map

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

package/dist/schedulers.js

@@ -0,0 +1,91 @@
+import { requestOptions, HttpClient, requireKnownKeys, paginationQuery, } from "./http.js";
+import { OutcomeUnknownError, TiDBLinkError } from "./errors.js";
+const requireMatch = (options) => {
+    requireKnownKeys(options, ["ifMatch", "signal", "requestId"], "Scheduler mutation options");
+    if (typeof options.ifMatch !== "string" || !options.ifMatch)
+        throw new TypeError("Scheduler mutation requires the previously read ifMatch ETag");
+};
+const path = (id) => `/api/v1/schedulers/${encodeURIComponent(id)}`;
+const receipt = (result, mutation = true) => {
+    const scheduler = result.data?.scheduler;
+    if (!scheduler?.schedulerId ||
+        !result.etag ||
+        !Number.isSafeInteger(scheduler.revision)) {
+        const ErrorClass = mutation ? OutcomeUnknownError : TiDBLinkError;
+        throw new ErrorClass("Scheduler response omitted its identity or ETag; read the original Scheduler before changing it", { requestId: result.requestId });
+    }
+    return { scheduler, etag: result.etag };
+};
+export class UserSchedulers {
+    #http;
+    constructor(http) {
+        this.#http = http;
+    }
+    async create(input) {
+        requireKnownKeys(input, [
+            "idempotencyKey",
+            "title",
+            "prompt",
+            "schedule",
+            "agentId",
+            "delivery",
+            "validFrom",
+            "validUntil",
+            "requestId",
+            "signal",
+        ], "Scheduler creation");
+        if (typeof input.idempotencyKey !== "string" ||
+            !/^[\x21-\x7e]{1,255}$/.test(input.idempotencyKey))
+            throw new TypeError("Scheduler creation requires a stable idempotencyKey (1-255 visible ASCII characters)");
+        const { idempotencyKey, requestId, signal, ...body } = input;
+        return receipt(await this.#http.postResponse("/api/v1/schedulers", body, {
+            idempotencyKey,
+            outcomeUnknown: true,
+            ...(requestId ? { requestId } : {}),
+            ...(signal ? { signal } : {}),
+        }));
+    }
+    async get(schedulerId, options) {
+        options = requestOptions(options);
+        return receipt(await this.#http.getResponse(path(schedulerId), options), false);
+    }
+    async update(schedulerId, input, options) {
+        requireKnownKeys(input, [
+            "title",
+            "prompt",
+            "agentId",
+            "delivery",
+            "schedule",
+            "enabled",
+            "validFrom",
+            "validUntil",
+            "snoozeUntil",
+        ], "Scheduler update");
+        requireMatch(options);
+        return receipt(await this.#http.patchResponse(path(schedulerId), input, {
+            ...options,
+            outcomeUnknown: true,
+        }));
+    }
+    async delete(schedulerId, options) {
+        requireMatch(options);
+        await this.#http.response(path(schedulerId), {
+            ...options,
+            method: "DELETE",
+            outcomeUnknown: true,
+        });
+    }
+    list(options) {
+        const input = options ?? {};
+        requireKnownKeys(input, ["status", "limit", "cursor", "signal", "requestId"], "Scheduler list options");
+        const { status, ...paging } = input;
+        const query = new URLSearchParams(paginationQuery(paging).slice(1));
+        if (status !== undefined)
+            query.set("status", status);
+        return this.#http.get(`/api/v1/schedulers${query.size ? `?${query}` : ""}`, options);
+    }
+    fires(schedulerId, options) {
+        return this.#http.get(`${path(schedulerId)}/fires${paginationQuery(options)}`, options);
+    }
+}
+//# sourceMappingURL=schedulers.js.map

package/dist/schedulers.js.map

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