@tidblink/server 0.3.0-rc.0 → 0.4.0-rc.1

package/dist/connectors.d.ts

@@ -0,0 +1,66 @@
+import { HttpClient } from "./http.js";
+import type { RequestOptions } from "./organization.js";
+export type ConnectorTransport = "streamable_http" | "tunnel";
+/** An Organization-owned MCP tool server that Agents can call. */
+export interface Connector {
+    connectorId: string;
+    organizationId: string;
+    displayName: string;
+    /** The HTTPS MCP endpoint of a `streamable_http` Connector. */
+    endpointUrl: string;
+    endpointVersion: number;
+    transport: ConnectorTransport;
+    status: "inactive" | "active";
+    /** Pass this as `expectedConnectorVersion` to change the registration. */
+    connectorVersion: number;
+    createdAt: string;
+    updatedAt: string;
+    /** What activation discovered at the endpoint. */
+    observation?: {
+        era: "modern" | "legacy";
+        protocolVersion: string;
+        endpointVersion: number;
+        probedAt: string;
+        expiresAt: string;
+    };
+}
+export interface RegisterConnectorInput extends RequestOptions {
+    /** Unique within the Organization. */
+    displayName: string;
+    /** Defaults to `streamable_http`. */
+    transport?: ConnectorTransport;
+    /** Required for `streamable_http`: an HTTPS URL without credentials. */
+    endpointUrl?: string;
+}
+export interface UpdateConnectorInput {
+    displayName?: string;
+    endpointUrl?: string;
+}
+export interface ConnectorVersionOptions extends RequestOptions {
+    /** The `connectorVersion` you read. A changed registration is refused with ConflictError. */
+    expectedConnectorVersion: number;
+}
+/**
+ * Organization Connector registrations. Register a Connector, then activate
+ * it: activation connects to the endpoint and discovers its tools. Edit only
+ * an inactive Connector.
+ */
+export declare class Connectors {
+    #private;
+    constructor(http: HttpClient);
+    list(options?: RequestOptions): Promise<Connector[]>;
+    get(connectorId: string, options?: RequestOptions): Promise<Connector>;
+    /**
+     * Register an inactive Connector. Registration is not retried; after an
+     * OutcomeUnknownError, list the Connectors and match the display name, which
+     * is unique in the Organization.
+     */
+    register(input: RegisterConnectorInput): Promise<Connector>;
+    /** Edit an inactive Connector. */
+    update(connectorId: string, input: UpdateConnectorInput, options: ConnectorVersionOptions): Promise<Connector>;
+    /** Discover the endpoint's tools and activate the Connector. */
+    activate(connectorId: string, options: ConnectorVersionOptions): Promise<Connector>;
+    /** Stop new calls to the Connector. */
+    deactivate(connectorId: string, options: ConnectorVersionOptions): Promise<Connector>;
+}
+//# sourceMappingURL=connectors.d.ts.map

package/dist/connectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectors.d.ts","sourceRoot":"","sources":["../src/connectors.ts"],"names":[],"mappings":"AACA,OAAO,EACL,UAAU,EAIX,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,GAAG,QAAQ,CAAC;AAE9D,kEAAkE;AAClE,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,MAAM,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC9B,0EAA0E;IAC1E,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,WAAW,CAAC,EAAE;QACZ,GAAG,EAAE,QAAQ,GAAG,QAAQ,CAAC;QACzB,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC;QACxB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,sBAAuB,SAAQ,cAAc;IAC5D,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,uBAAwB,SAAQ,cAAc;IAC7D,6FAA6F;IAC7F,wBAAwB,EAAE,MAAM,CAAC;CAClC;AA0BD;;;;GAIG;AACH,qBAAa,UAAU;;gBAGT,IAAI,EAAE,UAAU;IAItB,IAAI,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAQ1D,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC;IAItE;;;;OAIG;IACG,QAAQ,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,SAAS,CAAC;IAkBjE,kCAAkC;IAC5B,MAAM,CACV,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,oBAAoB,EAC3B,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,SAAS,CAAC;IAarB,gEAAgE;IAChE,QAAQ,CACN,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,SAAS,CAAC;IAIrB,uCAAuC;IACvC,UAAU,CACR,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,SAAS,CAAC;CAoBtB"}

package/dist/connectors.js

@@ -0,0 +1,71 @@
+import { OutcomeUnknownError } from "./errors.js";
+import { HttpClient, requireKnownKeys, requestOptions, } from "./http.js";
+const connectorPath = (id) => `/connectors/${encodeURIComponent(id)}`;
+const connectorReceipt = (result) => {
+    if (typeof result.data?.connectorId !== "string" || !result.data.connectorId)
+        throw new OutcomeUnknownError("Connector change returned no usable registration; read it before changing it again", { requestId: result.requestId });
+    return result.data;
+};
+const requireVersion = (options, label) => {
+    requireKnownKeys(options, ["expectedConnectorVersion", "signal", "requestId"], `${label} options`);
+    if (!Number.isSafeInteger(options.expectedConnectorVersion) ||
+        options.expectedConnectorVersion < 0)
+        throw new TypeError(`${label} requires expectedConnectorVersion`);
+};
+/**
+ * Organization Connector registrations. Register a Connector, then activate
+ * it: activation connects to the endpoint and discovers its tools. Edit only
+ * an inactive Connector.
+ */
+export class Connectors {
+    #http;
+    constructor(http) {
+        this.#http = http;
+    }
+    async list(options) {
+        const response = await this.#http.get("/connectors", requestOptions(options));
+        return response.connectors;
+    }
+    get(connectorId, options) {
+        return this.#http.get(connectorPath(connectorId), requestOptions(options));
+    }
+    /**
+     * Register an inactive Connector. Registration is not retried; after an
+     * OutcomeUnknownError, list the Connectors and match the display name, which
+     * is unique in the Organization.
+     */
+    async register(input) {
+        requireKnownKeys(input, ["displayName", "transport", "endpointUrl", "signal", "requestId"], "Connector registration");
+        if (typeof input.displayName !== "string" || !input.displayName.trim())
+            throw new TypeError("Connector registration requires a displayName");
+        const { signal, requestId, ...body } = input;
+        return connectorReceipt(await this.#http.postResponse("/connectors", body, {
+            outcomeUnknown: true,
+            ...(signal ? { signal } : {}),
+            ...(requestId ? { requestId } : {}),
+        }));
+    }
+    /** Edit an inactive Connector. */
+    async update(connectorId, input, options) {
+        requireKnownKeys(input, ["displayName", "endpointUrl"], "Connector update");
+        requireVersion(options, "Connector update");
+        const { expectedConnectorVersion, ...request } = options;
+        return connectorReceipt(await this.#http.patchResponse(connectorPath(connectorId), { expectedConnectorVersion, ...input }, { outcomeUnknown: true, ...request }));
+    }
+    /** Discover the endpoint's tools and activate the Connector. */
+    activate(connectorId, options) {
+        return this.#transition(connectorId, "activate", options);
+    }
+    /** Stop new calls to the Connector. */
+    deactivate(connectorId, options) {
+        return this.#transition(connectorId, "deactivate", options);
+    }
+    async #transition(connectorId, action, options) {
+        requireVersion(options, `Connector ${action}`);
+        const { expectedConnectorVersion, ...request } = options;
+        return connectorReceipt(await this.#http.postResponse(`${connectorPath(connectorId)}/${action}`, { expectedConnectorVersion }, 
+        // Not retried: a repeat after a lost response would be refused as a version conflict.
+        { outcomeUnknown: true, ...request }));
+    }
+}
+//# sourceMappingURL=connectors.js.map

package/dist/connectors.js.map

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

package/dist/control.js

@@ -11,7 +11,7 @@ export async function submitTurnCommand(http, sessionId, kind, input) {
     const { clientEventId, turnId, signal, requestId } = input;
     signal?.throwIfAborted();
     try {
-        const result = await http.postResponse(`/api/v1/user/sessions/${encodeURIComponent(sessionId)}/events`, { type: `agent.session.input.${kind}`, clientEventId, data: { turnId } }, {
+        const result = await http.postResponse(`/sessions/${encodeURIComponent(sessionId)}/events`, { type: `agent.session.input.${kind}`, clientEventId, data: { turnId } }, {
             outcomeUnknown: true,
             ...(signal ? { signal } : {}),
             ...(requestId ? { requestId } : {}),

package/dist/control.js.map

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

package/dist/errors.d.ts

@@ -63,18 +63,41 @@ export declare class TurnInterruptedError extends TiDBLinkError {
     readonly turnId: string;
     constructor(turnId: string, message?: string, sessionId?: string | undefined, inputId?: string | undefined);
 }
-/** Observation stopped locally; the original command can still be queried or observed. */
-export declare class ObservationStoppedError extends OutcomeUnknownError {
-    readonly cursor: string | undefined;
-    readonly timedOut: boolean;
-    constructor(message: string, options: {
-        sessionId: string;
-        inputId: string;
-        turnId?: string;
-        cursor?: string;
-        requestId?: string;
-        timedOut?: boolean;
+/**
+ * A Backend Connection closed, or could not be opened. `code` is the
+ * WebSocket close code: 4001 means the Organization API Key is missing,
+ * invalid, revoked or rotated, or its Organization is inactive, and
+ * reconnecting cannot help (`retryable` is false). Other closes, such as a
+ * drained or restarted replica, are retryable.
+ */
+export declare class BackendConnectionClosedError extends ConnectionError {
+    readonly code: number;
+    readonly reason: string;
+    readonly retryable: boolean;
+    constructor(input: {
+        code: number;
+        reason?: string;
+        message?: string;
         cause?: unknown;
     });
 }
+/**
+ * The core answered a Backend Connection request with a JSON-RPC error.
+ * `code` is the JSON-RPC error code; for -32000 (refused), `reason` names
+ * why, for example `session_not_found` or `connection_full`. A refused
+ * `session.send` carries the REST message command's error code as `reason`,
+ * such as `session_read_only` or `turn_admission_closed`.
+ */
+export declare class BackendRequestError extends TiDBLinkError {
+    readonly code: number;
+    readonly reason: string | undefined;
+    /** For a refused `session.send`, the REST error's `details`. */
+    readonly details: unknown;
+    constructor(input: {
+        code: number;
+        message: string;
+        reason?: string;
+        details?: unknown;
+    });
+}
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;gBAGrC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CASpD;AAED,qBAAa,gBAAiB,SAAQ,aAAa;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;gBAE5B,KAAK,EAAE;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB;CAYF;AAED,qBAAa,aAAc,SAAQ,gBAAgB;CAAG;AAEtD,qBAAa,eAAgB,SAAQ,aAAa;CAAG;AAErD,mFAAmF;AACnF,qBAAa,mBAAoB,SAAQ,aAAa;IACpD,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;gBAGnC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB;CAOJ;AAED,qBAAa,oBAAqB,SAAQ,mBAAmB;CAAG;AAEhE,qBAAa,oBAAqB,SAAQ,aAAa;IAEnD,QAAQ,CAAC,SAAS,EAAE,MAAM;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM;gBAFd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM;CAM1B;AAED,qBAAa,eAAgB,SAAQ,aAAa;IAChD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;gBAEzB,KAAK,EAAE;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;CAOF;AAED,qBAAa,oBAAqB,SAAQ,aAAa;IAMnD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM;IAN3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAGtB,MAAM,EAAE,MAAM,EACd,OAAO,SAAyB,EACvB,SAAS,CAAC,EAAE,MAAM,YAAA,EAClB,OAAO,CAAC,EAAE,MAAM,YAAA;CAK5B;AAED,0FAA0F;AAC1F,qBAAa,uBAAwB,SAAQ,mBAAmB;IAC9D,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;gBAGzB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QACP,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB;CAMJ"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;gBAGrC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CASpD;AAED,qBAAa,gBAAiB,SAAQ,aAAa;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;gBAE5B,KAAK,EAAE;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB;CAYF;AAED,qBAAa,aAAc,SAAQ,gBAAgB;CAAG;AAEtD,qBAAa,eAAgB,SAAQ,aAAa;CAAG;AAErD,mFAAmF;AACnF,qBAAa,mBAAoB,SAAQ,aAAa;IACpD,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;gBAGnC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB;CAOJ;AAED,qBAAa,oBAAqB,SAAQ,mBAAmB;CAAG;AAEhE,qBAAa,oBAAqB,SAAQ,aAAa;IAEnD,QAAQ,CAAC,SAAS,EAAE,MAAM;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM;gBAFd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM;CAM1B;AAED,qBAAa,eAAgB,SAAQ,aAAa;IAChD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;gBAEzB,KAAK,EAAE;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;CAOF;AAED,qBAAa,oBAAqB,SAAQ,aAAa;IAMnD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM;IAN3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAGtB,MAAM,EAAE,MAAM,EACd,OAAO,SAAyB,EACvB,SAAS,CAAC,EAAE,MAAM,YAAA,EAClB,OAAO,CAAC,EAAE,MAAM,YAAA;CAK5B;AAED;;;;;;GAMG;AACH,qBAAa,4BAA6B,SAAQ,eAAe;IAC/D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;gBAEhB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAUxF;AAED;;;;;;GAMG;AACH,qBAAa,mBAAoB,SAAQ,aAAa;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,gEAAgE;IAChE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;gBAEd,KAAK,EAAE;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB;CAMF"}

package/dist/errors.js

@@ -74,14 +74,42 @@ export class TurnInterruptedError extends TiDBLinkError {
         this.turnId = turnId;
     }
 }
-/** Observation stopped locally; the original command can still be queried or observed. */
-export class ObservationStoppedError extends OutcomeUnknownError {
-    cursor;
-    timedOut;
-    constructor(message, options) {
-        super(message, options);
-        this.cursor = options.cursor;
-        this.timedOut = options.timedOut ?? false;
+/**
+ * A Backend Connection closed, or could not be opened. `code` is the
+ * WebSocket close code: 4001 means the Organization API Key is missing,
+ * invalid, revoked or rotated, or its Organization is inactive, and
+ * reconnecting cannot help (`retryable` is false). Other closes, such as a
+ * drained or restarted replica, are retryable.
+ */
+export class BackendConnectionClosedError extends ConnectionError {
+    code;
+    reason;
+    retryable;
+    constructor(input) {
+        super(input.message ??
+            `Backend Connection closed with code ${input.code}${input.reason ? `: ${input.reason}` : ""}`, input.cause === undefined ? undefined : { cause: input.cause });
+        this.code = input.code;
+        this.reason = input.reason ?? "";
+        this.retryable = input.code !== 4001 && input.code !== 4009;
+    }
+}
+/**
+ * The core answered a Backend Connection request with a JSON-RPC error.
+ * `code` is the JSON-RPC error code; for -32000 (refused), `reason` names
+ * why, for example `session_not_found` or `connection_full`. A refused
+ * `session.send` carries the REST message command's error code as `reason`,
+ * such as `session_read_only` or `turn_admission_closed`.
+ */
+export class BackendRequestError extends TiDBLinkError {
+    code;
+    reason;
+    /** For a refused `session.send`, the REST error's `details`. */
+    details;
+    constructor(input) {
+        super(input.message);
+        this.code = input.code;
+        this.reason = input.reason;
+        this.details = input.details;
     }
 }
 //# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/events.d.ts

@@ -0,0 +1,158 @@
+import type { TemplateSwitchStatus } from "./template-switch.js";
+import type { ClarificationItem } from "./session.js";
+import type { RealtimeResponseKind, SessionRealtimeEvent } from "./history.js";
+/**
+ * One event of a Session's event stream. Events whose `type` the SDK does not
+ * know are delivered unchanged; use `asKnownSessionEvent` for typed access.
+ * Display events remain provisional; use the original interaction to
+ * establish a result.
+ */
+export interface SessionEvent {
+    /** Opaque stream position. Persist it to resume after this event. */
+    cursor: string;
+    type: string;
+    sessionId: string;
+    turnId: string | null;
+    createdAt: string;
+    data: Record<string, unknown>;
+}
+/** The durable Turn event carried in `data` of every `agent.session.turn.*` event. */
+export interface TurnEventData<Name extends string, Payload> {
+    event: Name;
+    turnId: string;
+    sessionId: string;
+    agentRunId?: string;
+    seq: number;
+    createdAt: string;
+    payload: Payload;
+}
+interface KnownEvent<Type extends string, Data> extends SessionEvent {
+    type: Type;
+    data: Data & Record<string, unknown>;
+}
+export type TurnStartedEvent = KnownEvent<"agent.session.turn.started", TurnEventData<"turn_started", {
+    inputId?: string;
+    execution?: {
+        model: string;
+    };
+}>> & {
+    turnId: string;
+};
+/** The complete provisional draft; replace the previous draft of this Turn. */
+export type TurnDraftEvent = KnownEvent<"agent.session.turn.output_text.snapshot", TurnEventData<"assistant_draft", {
+    text: string;
+}>> & {
+    turnId: string;
+};
+export type TurnProgressEvent = KnownEvent<"agent.session.turn.progress", TurnEventData<"progress", {
+    text: string;
+}>> & {
+    turnId: string;
+};
+export interface OperationStepPayload {
+    operationId: string;
+    status: "running" | "succeeded" | "failed" | "interrupted" | "unknown_result";
+    label: string;
+    category?: "tool_call" | "skill_read";
+    skill?: {
+        skillId: string;
+        name: string;
+    };
+    source?: {
+        type: "session_client";
+    } | {
+        type: string;
+        [field: string]: unknown;
+    };
+}
+export type TurnItemAddedEvent = KnownEvent<"agent.session.turn.item.added", TurnEventData<"assistant_message", {
+    messageId: string;
+    text: string;
+    clarificationItem?: ClarificationItem;
+}> | TurnEventData<"operation_step", OperationStepPayload>> & {
+    turnId: string;
+};
+/** A Client Tool call carried by `agent.session.turn.requires_action`. */
+export interface ClientToolCallPayload {
+    callId: string;
+    name: string;
+    arguments: Record<string, unknown>;
+    deadlineAt: string;
+    /**
+     * Present when the call was published to the Session's executing Backend
+     * Connection attachment. Only that attachment executes it, after claiming it
+     * before this time; this event authorizes nothing.
+     */
+    claimBy?: string;
+}
+export type TurnRequiresActionEvent = KnownEvent<"agent.session.turn.requires_action", TurnEventData<"client_tool_calls", {
+    calls: ClientToolCallPayload[];
+}>> & {
+    turnId: string;
+};
+export type TurnCompletedEvent = KnownEvent<"agent.session.turn.completed", TurnEventData<"turn_finished", {
+    status: "succeeded";
+}>> & {
+    turnId: string;
+};
+export type TurnCancelledEvent = KnownEvent<"agent.session.turn.cancelled", TurnEventData<"turn_finished", {
+    status: "interrupted";
+}>> & {
+    turnId: string;
+};
+export type TurnFailedEvent = KnownEvent<"agent.session.turn.failed", TurnEventData<"turn_finished", {
+    status: "failed";
+}> | TurnEventData<"turn_error", {
+    code: string;
+    message: string;
+    details?: Record<string, unknown>;
+}>> & {
+    turnId: string;
+};
+export type RealtimeTranscriptEvent = KnownEvent<"agent.session.realtime.input_transcript.completed", Extract<SessionRealtimeEvent, {
+    type: "input_transcript";
+}>>;
+export type RealtimeResponseEvent = KnownEvent<"agent.session.realtime.response.completed", Extract<SessionRealtimeEvent, {
+    type: "response";
+}> & {
+    kind: RealtimeResponseKind;
+}>;
+export interface TemplateSwitchEventData {
+    id: string;
+    commandId: string;
+    status: Extract<TemplateSwitchStatus, "succeeded" | "failed">;
+    configurationEpoch: number;
+    agentTemplateId: string;
+    contentDigest: string | null;
+    createdAt: string;
+}
+export type TemplateSwitchEvent = KnownEvent<"agent.session.template_switch.succeeded" | "agent.session.template_switch.failed", TemplateSwitchEventData>;
+/**
+ * The Session released its active Turn: the next message, audio Turn or
+ * Template switch can start. It follows that Turn's terminal events and
+ * does not establish its outcome; it can repeat for one Turn.
+ */
+export type SessionIdleEvent = KnownEvent<"agent.session.idle", {
+    id: string;
+    /** The released Turn, or null when it was never recorded. */
+    turnId: string | null;
+    createdAt: string;
+}>;
+export type KnownSessionEvent = TurnStartedEvent | TurnDraftEvent | TurnProgressEvent | TurnItemAddedEvent | TurnRequiresActionEvent | TurnCompletedEvent | TurnCancelledEvent | TurnFailedEvent | RealtimeTranscriptEvent | RealtimeResponseEvent | TemplateSwitchEvent | SessionIdleEvent;
+/** Whether a `client_tool_calls` payload has the fields the SDK types. */
+export declare const isClientToolCallsPayload: (payload: Record<string, unknown>) => payload is {
+    calls: ClientToolCallPayload[];
+};
+/**
+ * Narrow an event to one of the types the SDK knows. Returns `undefined` for
+ * any other type, and for a known type whose data lacks the fields the SDK
+ * types; such events are still delivered by the stream unchanged.
+ */
+export declare function asKnownSessionEvent(event: SessionEvent): KnownSessionEvent | undefined;
+/** Check one event envelope and attach its cursor. */
+export declare function sessionEventFrom(value: unknown, cursor: unknown, options?: {
+    sessionId?: string;
+    requestId?: string;
+}): SessionEvent;
+export {};
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

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

package/dist/events.js

@@ -0,0 +1,110 @@
+import { TiDBLinkError } from "./errors.js";
+const isObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const isString = (value) => typeof value === "string";
+/** Turn events name their durable event in `data.event`. */
+const TURN_EVENTS = {
+    "agent.session.turn.started": ["turn_started"],
+    "agent.session.turn.output_text.snapshot": ["assistant_draft"],
+    "agent.session.turn.progress": ["progress"],
+    "agent.session.turn.item.added": ["assistant_message", "operation_step"],
+    "agent.session.turn.requires_action": ["client_tool_calls"],
+    "agent.session.turn.completed": ["turn_finished"],
+    "agent.session.turn.cancelled": ["turn_finished"],
+    "agent.session.turn.failed": ["turn_finished", "turn_error"],
+};
+const FINISHED_STATUS = {
+    "agent.session.turn.completed": "succeeded",
+    "agent.session.turn.cancelled": "interrupted",
+    "agent.session.turn.failed": "failed",
+};
+const isTextPayload = (payload) => isString(payload.text);
+/** Whether a `client_tool_calls` payload has the fields the SDK types. */
+export const isClientToolCallsPayload = (payload) => Array.isArray(payload.calls) &&
+    payload.calls.every((call) => isObject(call) &&
+        isString(call.callId) &&
+        isString(call.name) &&
+        isObject(call.arguments) &&
+        isString(call.deadlineAt) &&
+        (call.claimBy === undefined || isString(call.claimBy)));
+const isKnownTurnPayload = (name, payload, type) => {
+    switch (name) {
+        case "progress":
+        case "assistant_draft":
+            return isTextPayload(payload);
+        case "assistant_message":
+            return isTextPayload(payload) && isString(payload.messageId);
+        case "operation_step":
+            return (isString(payload.operationId) &&
+                isString(payload.status) &&
+                isString(payload.label));
+        case "client_tool_calls":
+            return isClientToolCallsPayload(payload);
+        case "turn_finished":
+            return payload.status === FINISHED_STATUS[type];
+        case "turn_error":
+            return isString(payload.code) && isString(payload.message);
+        default:
+            return true;
+    }
+};
+/**
+ * Narrow an event to one of the types the SDK knows. Returns `undefined` for
+ * any other type, and for a known type whose data lacks the fields the SDK
+ * types; such events are still delivered by the stream unchanged.
+ */
+export function asKnownSessionEvent(event) {
+    const { type, data } = event;
+    const turnEvents = TURN_EVENTS[type];
+    if (turnEvents) {
+        if (!isString(event.turnId) ||
+            !isString(data.event) ||
+            !turnEvents.includes(data.event) ||
+            !isObject(data.payload) ||
+            !isKnownTurnPayload(data.event, data.payload, type))
+            return undefined;
+        return event;
+    }
+    if (type === "agent.session.realtime.input_transcript.completed" ||
+        type === "agent.session.realtime.response.completed") {
+        const expected = type === "agent.session.realtime.input_transcript.completed"
+            ? "input_transcript"
+            : "response";
+        return data.type === expected &&
+            isString(data.id) &&
+            isString(data.text) &&
+            isString(data.realtimeConnectionId)
+            ? event
+            : undefined;
+    }
+    if (type === "agent.session.template_switch.succeeded" ||
+        type === "agent.session.template_switch.failed")
+        return isString(data.commandId) &&
+            isString(data.agentTemplateId) &&
+            typeof data.configurationEpoch === "number" &&
+            data.status === type.slice("agent.session.template_switch.".length)
+            ? event
+            : undefined;
+    if (type === "agent.session.idle")
+        return isString(data.id) && (data.turnId === null || isString(data.turnId))
+            ? event
+            : undefined;
+    return undefined;
+}
+/** Check one event envelope and attach its cursor. */
+export function sessionEventFrom(value, cursor, options = {}) {
+    const requestId = options.requestId === undefined ? {} : { requestId: options.requestId };
+    const event = value;
+    if (!isString(cursor) ||
+        !cursor ||
+        !isObject(event) ||
+        !isString(event.type) ||
+        !event.type ||
+        !isString(event.sessionId) ||
+        (options.sessionId !== undefined && event.sessionId !== options.sessionId) ||
+        (event.turnId !== null && !isString(event.turnId)) ||
+        !isString(event.createdAt) ||
+        !isObject(event.data))
+        throw new TiDBLinkError("Session event has an invalid envelope", requestId);
+    return { ...event, cursor };
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

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