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

package/dist/usage.d.ts.map

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

package/dist/usage.js

@@ -0,0 +1,20 @@
+import { requireKnownKeys } from "./http.js";
+export const usageQuery = (options, allowed) => {
+    requireKnownKeys(options, [...allowed, "signal", "requestId"], "Usage options");
+    const query = new URLSearchParams();
+    for (const [key, value] of Object.entries(options))
+        if (allowed.includes(key) && value !== undefined)
+            query.set(key, String(value));
+    return query.size ? `?${query}` : "";
+};
+export const userUsagePath = (userId, options) => {
+    if (typeof userId !== "string" || !/^[a-z0-9_-]{1,64}$/.test(userId))
+        throw new TypeError("Organization usage requires an explicit User ID");
+    if (typeof options?.from !== "string" ||
+        !options.from ||
+        typeof options.to !== "string" ||
+        !options.to)
+        throw new TypeError("Organization usage requires from and to UTC timestamps");
+    return `/api/v1/org/users/${encodeURIComponent(userId)}/billing/usage`;
+};
+//# sourceMappingURL=usage.js.map

package/dist/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../src/usage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AA0gB7C,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,OAAe,EACf,OAA0B,EAClB,EAAE;IACV,gBAAgB,CACd,OAAO,EACP,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC,EACnC,eAAe,CAChB,CAAC;IACF,MAAM,KAAK,GAAG,IAAI,eAAe,EAAE,CAAC;IACpC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;QAChD,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,KAAK,SAAS;YAC9C,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAClC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACvC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,MAAc,EACd,OAAqC,EAC7B,EAAE;IACV,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC;QAClE,MAAM,IAAI,SAAS,CAAC,iDAAiD,CAAC,CAAC;IACzE,IACE,OAAO,OAAO,EAAE,IAAI,KAAK,QAAQ;QACjC,CAAC,OAAO,CAAC,IAAI;QACb,OAAO,OAAO,CAAC,EAAE,KAAK,QAAQ;QAC9B,CAAC,OAAO,CAAC,EAAE;QAEX,MAAM,IAAI,SAAS,CACjB,wDAAwD,CACzD,CAAC;IACJ,OAAO,qBAAqB,kBAAkB,CAAC,MAAM,CAAC,gBAAgB,CAAC;AACzE,CAAC,CAAC"}

package/dist/user.d.ts

@@ -0,0 +1,96 @@
+import { type UserUsageOptions, type UserUsageDetailsOptions, type UserUsageSummary, type UserUsageDetails } from "./usage.js";
+import { UserSchedulers, type OrganizationSchedulerListOptions } from "./schedulers.js";
+import { UserFiles } from "./files.js";
+import { HttpClient, type ListOptions } from "./http.js";
+import type { RequestOptions } from "./organization.js";
+import { type CreateSessionOptions, Session } from "./session.js";
+import type { RealtimeModelCatalog } from "./realtime.js";
+export interface UserClientOptions {
+    baseUrl: string;
+    apiKey: string;
+}
+/** Create/list/unlink return association metadata; owner get/update also include preferences. */
+export interface AgentRecord {
+    agentId: string;
+    organizationId: string;
+    ownerUserId: string;
+    agentTemplateId: string;
+    status: "active" | "archived";
+    createdAt: string;
+    updatedAt: string;
+    additionalInstructions?: string;
+}
+export interface AgentTemplate {
+    agentTemplateId: string;
+    displayName: string;
+    description: string;
+    contentDigest: string;
+}
+export interface AgentTemplatePage {
+    templates: AgentTemplate[];
+    hasMore: boolean;
+    nextCursor: string | null;
+}
+export interface AgentModelCatalog {
+    defaultModel: string;
+    models: {
+        model: string;
+        label: string;
+        availability: "available" | "provider_unconfigured";
+    }[];
+    organizationDefaultModel: string;
+    effectiveDefaultModel: string;
+    organizationAllowedModels: string[];
+    effectiveAllowedModels: string[];
+}
+export interface CreateAgentInput extends RequestOptions {
+    agentTemplateId: string;
+    /** Keep the same key and input when recovering an uncertain creation. */
+    idempotencyKey: string;
+}
+export interface UpdateAgentInput {
+    /** Applied only to future Sessions. Null or empty text clears the preference. */
+    additionalInstructions: string | null;
+}
+export declare class Agent {
+    #private;
+    constructor(http: HttpClient, record: AgentRecord);
+    get id(): string;
+    get status(): AgentRecord["status"];
+    get data(): Readonly<AgentRecord>;
+    refresh(options?: RequestOptions): Promise<this>;
+    update(input: UpdateAgentInput, options?: RequestOptions): Promise<this>;
+    createSession(options: CreateSessionOptions): Promise<Session>;
+}
+export interface SessionPage {
+    sessions: Session[];
+    hasMore: boolean;
+    nextCursor: string | null;
+}
+/** Ordinary End User resources under the caller's authority. */
+export declare class EndUserClient {
+    #private;
+    protected get http(): HttpClient;
+    get schedulers(): UserSchedulers<OrganizationSchedulerListOptions>;
+    get files(): UserFiles;
+    constructor(http: HttpClient);
+    listAgents(options?: RequestOptions): Promise<Agent[]>;
+    createAgent(input: CreateAgentInput): Promise<Agent>;
+    getAgent(id: string, options?: RequestOptions): Promise<Agent>;
+    listAgentTemplates(options?: ListOptions): Promise<AgentTemplatePage>;
+    listModels(options?: RequestOptions & {
+        agentId?: string;
+    }): Promise<AgentModelCatalog>;
+    listRealtimeModels(options?: RequestOptions): Promise<RealtimeModelCatalog>;
+    listSessions(options?: ListOptions): Promise<SessionPage>;
+    session(id: string): Session;
+    getSession(id: string, options?: RequestOptions): Promise<Session>;
+}
+/** Existing User API Key entry point; Organization callers use organization.user(userId). */
+export declare class UserClient extends EndUserClient {
+    get schedulers(): UserSchedulers;
+    constructor(options: UserClientOptions);
+    getUsage(options?: UserUsageOptions): Promise<UserUsageSummary>;
+    getUsageDetails(options?: UserUsageDetailsOptions): Promise<UserUsageDetails>;
+}
+//# sourceMappingURL=user.d.ts.map

package/dist/user.d.ts.map

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

package/dist/user.js

@@ -0,0 +1,139 @@
+import { usageQuery, } from "./usage.js";
+import { UserSchedulers } from "./schedulers.js";
+import { UserFiles } from "./files.js";
+import { OutcomeUnknownError } from "./errors.js";
+import { requestOptions, HttpClient, isApiKey, paginationQuery, requireCreationKey, requireKnownKeys, } from "./http.js";
+import { createSessionForAgent, Session, } from "./session.js";
+const agentReceipt = (value, requestId) => {
+    if (typeof value?.agent?.agentId !== "string" || !value.agent.agentId) {
+        throw new OutcomeUnknownError("Agent mutation returned no usable Agent; reconcile before retrying", { requestId });
+    }
+    return value.agent;
+};
+export class Agent {
+    #http;
+    #record;
+    constructor(http, record) {
+        this.#http = http;
+        this.#record = record;
+    }
+    get id() {
+        return this.#record.agentId;
+    }
+    get status() {
+        return this.#record.status;
+    }
+    get data() {
+        return this.#record;
+    }
+    async refresh(options) {
+        options = requestOptions(options);
+        const response = await this.#http.get(`/api/v1/user/agents/${encodeURIComponent(this.id)}`, options);
+        this.#record = response.agent;
+        return this;
+    }
+    async update(input, options) {
+        options = requestOptions(options);
+        requireKnownKeys(input, ["additionalInstructions"], "Agent preferences");
+        if (input.additionalInstructions !== null &&
+            typeof input.additionalInstructions !== "string")
+            throw new TypeError("Agent preferences require additionalInstructions");
+        const result = await this.#http.patchResponse(`/api/v1/user/agents/${encodeURIComponent(this.id)}`, input, { ...options, outcomeUnknown: true });
+        this.#record = agentReceipt(result.data, result.requestId);
+        return this;
+    }
+    createSession(options) {
+        return createSessionForAgent(this.#http, this.id, options);
+    }
+}
+/** Ordinary End User resources under the caller's authority. */
+export class EndUserClient {
+    #http;
+    get http() {
+        return this.#http;
+    }
+    #files;
+    #schedulers;
+    get schedulers() {
+        return this.#schedulers;
+    }
+    get files() {
+        return this.#files;
+    }
+    constructor(http) {
+        this.#http = http;
+        this.#files = new UserFiles(http);
+        this.#schedulers = new UserSchedulers(http);
+    }
+    async listAgents(options) {
+        options = requestOptions(options);
+        const response = await this.#http.get("/api/v1/user/agents", options);
+        return response.agents.map((agent) => new Agent(this.#http, agent));
+    }
+    async createAgent(input) {
+        requireKnownKeys(input, ["agentTemplateId", "idempotencyKey", "signal", "requestId"], "Agent creation");
+        if (typeof input.agentTemplateId !== "string" ||
+            !input.agentTemplateId.trim())
+            throw new TypeError("Agent creation requires a Template ID");
+        requireCreationKey(input.idempotencyKey);
+        const result = await this.#http.postResponse("/api/v1/user/agents", { agentTemplateId: input.agentTemplateId }, {
+            idempotencyKey: input.idempotencyKey,
+            ...(input.signal ? { signal: input.signal } : {}),
+            ...(input.requestId ? { requestId: input.requestId } : {}),
+            idempotent: true,
+            outcomeUnknown: true,
+        });
+        return new Agent(this.#http, agentReceipt(result.data, result.requestId));
+    }
+    async getAgent(id, options) {
+        options = requestOptions(options);
+        const response = await this.#http.get(`/api/v1/user/agents/${encodeURIComponent(id)}`, options);
+        return new Agent(this.#http, response.agent);
+    }
+    listAgentTemplates(options) {
+        return this.#http.get(`/api/v1/user/agent-templates${paginationQuery(options)}`, options);
+    }
+    listModels(options) {
+        if (options)
+            requireKnownKeys(options, ["agentId", "signal", "requestId"], "Model list options");
+        const query = options?.agentId === undefined
+            ? ""
+            : `?agentId=${encodeURIComponent(options.agentId)}`;
+        return this.#http.get(`/api/v1/agent-models${query}`, options);
+    }
+    listRealtimeModels(options) {
+        return this.#http.get("/api/v1/realtime-models", requestOptions(options));
+    }
+    async listSessions(options) {
+        const response = await this.#http.get(`/api/v1/user/sessions${paginationQuery(options)}`, options);
+        return {
+            ...response,
+            sessions: response.sessions.map((record) => new Session(this.#http, record.sessionId, record)),
+        };
+    }
+    session(id) {
+        return new Session(this.#http, id);
+    }
+    getSession(id, options) {
+        return this.session(id).refresh(options);
+    }
+}
+/** Existing User API Key entry point; Organization callers use organization.user(userId). */
+export class UserClient extends EndUserClient {
+    get schedulers() {
+        return super.schedulers;
+    }
+    constructor(options) {
+        requireKnownKeys(options, ["baseUrl", "apiKey"], "UserClient options");
+        if (!isApiKey(options.apiKey, "user"))
+            throw new TypeError("UserClient requires a User API Key");
+        super(new HttpClient(options));
+    }
+    getUsage(options = {}) {
+        return this.http.get(`/api/v1/billing/usage${usageQuery(options, ["period", "from", "to", "tagKey", "tagValue"])}`, options);
+    }
+    getUsageDetails(options = {}) {
+        return this.http.get(`/api/v1/billing/usage/details${usageQuery(options, ["period", "from", "to", "tagKey", "tagValue", "limit"])}`, options);
+    }
+}
+//# sourceMappingURL=user.js.map

package/dist/user.js.map

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

package/examples/answer-client-tool.mjs

@@ -0,0 +1,69 @@
+import { pathToFileURL } from "node:url";
+import { UserClient } from "@tidblink/server";
+
+/** The application produces output/error itself and persists this command identity. */
+export async function answerClientToolWorkflow({
+  baseUrl,
+  userApiKey,
+  sessionId,
+  turnId,
+  callId,
+  clientEventId,
+  output,
+  error,
+  signal,
+}) {
+  const session = new UserClient({ baseUrl, apiKey: userApiKey }).session(
+    sessionId,
+  );
+  const calls = await session.listPendingClientToolCalls(
+    signal ? { signal } : undefined,
+  );
+  const call = calls.find(
+    (call) => call.callId === callId && call.turnId === turnId,
+  );
+  if (!call)
+    throw new Error(
+      "The Session Client Tool call is no longer pending; reconcile the original output command before submitting anything else",
+    );
+  if (Date.parse(call.deadlineAt) <= Date.now())
+    throw new Error(
+      "The Client Tool deadline has passed; do not execute the business function again",
+    );
+  return session.submitClientToolOutput({
+    clientEventId,
+    turnId,
+    callId,
+    ...(output === undefined ? {} : { output }),
+    ...(error === undefined ? {} : { error }),
+    ...(signal ? { signal } : {}),
+  });
+}
+
+if (
+  process.argv[1] &&
+  import.meta.url === pathToFileURL(process.argv[1]).href
+) {
+  try {
+    const receipt = await answerClientToolWorkflow({
+      baseUrl: process.env.AGENT_SERVICE_URL,
+      userApiKey: process.env.USER_API_KEY,
+      sessionId: process.env.SESSION_ID,
+      turnId: process.env.TURN_ID,
+      callId: process.env.CALL_ID,
+      clientEventId: process.env.CLIENT_EVENT_ID,
+      output: process.env.TOOL_OUTPUT,
+      ...(process.env.TOOL_ERROR === undefined
+        ? {}
+        : { error: { message: process.env.TOOL_ERROR } }),
+    });
+    console.log(JSON.stringify(receipt));
+  } catch (error) {
+    console.error(
+      error instanceof Error
+        ? error.message
+        : "Client Tool result was not confirmed",
+    );
+    process.exitCode = 1;
+  }
+}

package/examples/control-turn.mjs

@@ -0,0 +1,48 @@
+import { pathToFileURL } from "node:url";
+import { UserClient } from "@tidblink/server";
+
+/** Persist the action and both identities before dispatch; recovery reads that command. */
+export async function controlTurnWorkflow({
+  baseUrl,
+  userApiKey,
+  sessionId,
+  turnId,
+  clientEventId,
+  action,
+  signal,
+}) {
+  if (action !== "cancel" && action !== "retry")
+    throw new TypeError("action must be cancel or retry");
+  const session = new UserClient({ baseUrl, apiKey: userApiKey }).session(
+    sessionId,
+  );
+  const input = { turnId, clientEventId, ...(signal ? { signal } : {}) };
+  if (action === "cancel") return session.cancel(input);
+  const accepted = await session.retry(input);
+  return session.waitForResult(
+    accepted.clientEventId,
+    signal ? { signal } : undefined,
+  );
+}
+
+if (
+  process.argv[1] &&
+  import.meta.url === pathToFileURL(process.argv[1]).href
+) {
+  try {
+    const result = await controlTurnWorkflow({
+      baseUrl: process.env.AGENT_SERVICE_URL,
+      userApiKey: process.env.USER_API_KEY,
+      sessionId: process.env.SESSION_ID,
+      turnId: process.env.TURN_ID,
+      clientEventId: process.env.CLIENT_EVENT_ID,
+      action: process.env.TURN_ACTION,
+    });
+    console.log(JSON.stringify(result));
+  } catch (error) {
+    console.error(
+      error instanceof Error ? error.message : "Turn control failed",
+    );
+    process.exitCode = 1;
+  }
+}

package/examples/create-session.mjs

@@ -0,0 +1,69 @@
+import { pathToFileURL } from "node:url";
+import { UserClient } from "@tidblink/server";
+
+/** Save the selected Template, optional model and both keys before calling. */
+export async function createSessionWorkflow({
+  baseUrl,
+  userApiKey,
+  agentTemplateId,
+  agentCreationKey,
+  sessionCreationKey,
+  model,
+}) {
+  if (!agentTemplateId)
+    throw new TypeError(
+      "Select and retain an agentTemplateId before creating an Agent",
+    );
+  const user = new UserClient({ baseUrl, apiKey: userApiKey });
+  const templates = await user.listAgentTemplates();
+  const models = await user.listModels();
+  const agent = await user.createAgent({
+    agentTemplateId,
+    idempotencyKey: agentCreationKey,
+  });
+  // Omission is part of the creation identity; resolving today's default would change a replay.
+  const session = await agent.createSession({
+    idempotencyKey: sessionCreationKey,
+    ...(model === undefined ? {} : { model }),
+  });
+  return { agent, session, templates, models };
+}
+
+if (
+  process.argv[1] &&
+  import.meta.url === pathToFileURL(process.argv[1]).href
+) {
+  const {
+    AGENT_SERVICE_URL,
+    USER_API_KEY,
+    TEMPLATE_ID,
+    AGENT_CREATION_KEY,
+    SESSION_CREATION_KEY,
+    MODEL_ID,
+  } = process.env;
+  if (
+    !AGENT_SERVICE_URL ||
+    !USER_API_KEY ||
+    !TEMPLATE_ID ||
+    !AGENT_CREATION_KEY ||
+    !SESSION_CREATION_KEY
+  )
+    throw new Error(
+      "Set AGENT_SERVICE_URL, USER_API_KEY, TEMPLATE_ID, AGENT_CREATION_KEY and SESSION_CREATION_KEY; MODEL_ID is optional",
+    );
+  const result = await createSessionWorkflow({
+    baseUrl: AGENT_SERVICE_URL,
+    userApiKey: USER_API_KEY,
+    agentCreationKey: AGENT_CREATION_KEY,
+    sessionCreationKey: SESSION_CREATION_KEY,
+    agentTemplateId: TEMPLATE_ID,
+    model: MODEL_ID,
+  });
+  console.log(
+    JSON.stringify({
+      agentId: result.agent.id,
+      sessionId: result.session.id,
+      model: result.session.model,
+    }),
+  );
+}

package/examples/observe-message.mjs

@@ -0,0 +1,44 @@
+import { pathToFileURL } from "node:url";
+import { UserClient } from "@tidblink/server";
+
+/** Observe an already submitted input. Persist each event cursor for reconnection. */
+export function observeMessageWorkflow({
+  baseUrl,
+  userApiKey,
+  sessionId,
+  inputId,
+  cursor,
+  timeoutMs,
+  signal,
+}) {
+  return new UserClient({ baseUrl, apiKey: userApiKey })
+    .session(sessionId)
+    .observe(inputId, {
+      ...(cursor === undefined ? {} : { cursor }),
+      ...(timeoutMs === undefined ? {} : { timeoutMs }),
+      ...(signal ? { signal } : {}),
+    });
+}
+
+if (
+  process.argv[1] &&
+  import.meta.url === pathToFileURL(process.argv[1]).href
+) {
+  try {
+    for await (const update of observeMessageWorkflow({
+      baseUrl: process.env.AGENT_SERVICE_URL,
+      userApiKey: process.env.USER_API_KEY,
+      sessionId: process.env.SESSION_ID,
+      inputId: process.env.INPUT_ID,
+      cursor: process.env.EVENT_CURSOR,
+    })) {
+      if (update.type === "result") console.log(update.result.text);
+      else console.error(JSON.stringify(update));
+    }
+  } catch (error) {
+    console.error(
+      error instanceof Error ? error.message : "Observation stopped",
+    );
+    process.exitCode = 1;
+  }
+}

package/examples/organization-session.mjs

@@ -0,0 +1,66 @@
+import { pathToFileURL } from "node:url";
+import { OrganizationClient } from "@tidblink/server";
+
+/** Retain the owner, selected Template/model and both creation identities before calling. */
+export async function organizationSessionWorkflow({
+  baseUrl,
+  organizationApiKey,
+  userId,
+  agentTemplateId,
+  agentCreationKey,
+  sessionCreationKey,
+  model,
+}) {
+  const organization = new OrganizationClient({
+    baseUrl,
+    apiKey: organizationApiKey,
+  });
+  const user = organization.user(userId);
+  const templates = await user.listAgentTemplates();
+  const models = await user.listModels();
+  const agent = await user.createAgent({
+    agentTemplateId,
+    idempotencyKey: agentCreationKey,
+  });
+  const session = await agent.createSession({
+    idempotencyKey: sessionCreationKey,
+    ...(model === undefined ? {} : { model }),
+  });
+  return { organization, user, agent, session, templates, models };
+}
+
+if (
+  process.argv[1] &&
+  import.meta.url === pathToFileURL(process.argv[1]).href
+) {
+  const {
+    AGENT_SERVICE_URL,
+    ORGANIZATION_API_KEY,
+    END_USER_ID,
+    TEMPLATE_ID,
+    AGENT_CREATION_KEY,
+    SESSION_CREATION_KEY,
+    MODEL_ID,
+  } = process.env;
+  if (
+    !AGENT_SERVICE_URL ||
+    !ORGANIZATION_API_KEY ||
+    !END_USER_ID ||
+    !TEMPLATE_ID ||
+    !AGENT_CREATION_KEY ||
+    !SESSION_CREATION_KEY
+  )
+    throw new Error(
+      "Set AGENT_SERVICE_URL, ORGANIZATION_API_KEY, END_USER_ID, TEMPLATE_ID, AGENT_CREATION_KEY and SESSION_CREATION_KEY; MODEL_ID is optional",
+    );
+  const { agent, session } = await organizationSessionWorkflow({
+    baseUrl: AGENT_SERVICE_URL,
+    organizationApiKey: ORGANIZATION_API_KEY,
+    userId: END_USER_ID,
+    agentTemplateId: TEMPLATE_ID,
+    agentCreationKey: AGENT_CREATION_KEY,
+    sessionCreationKey: SESSION_CREATION_KEY,
+    model: MODEL_ID,
+  });
+  console.log(JSON.stringify({ agentId: agent.id, sessionId: session.id }));
+}

package/examples/prepare-realtime-connection.mjs

@@ -0,0 +1,61 @@
+import { pathToFileURL } from "node:url";
+import { UserClient } from "@tidblink/server";
+
+/** Prepare an existing owned Session for a terminal to connect; this does not open a WebSocket. */
+export async function prepareRealtimeConnection({
+  baseUrl,
+  userApiKey,
+  sessionId,
+  realtimeModelId,
+  audio,
+  metadata,
+}) {
+  const client = new UserClient({ baseUrl, apiKey: userApiKey });
+  const catalog = await client.listRealtimeModels();
+  const session = client.session(sessionId);
+  let selection = await session.getRealtimeModelSelection();
+  if (
+    realtimeModelId !== undefined &&
+    realtimeModelId !== selection.model
+  ) {
+    selection = await session.setRealtimeModel(realtimeModelId, {
+      ifMatch: selection.etag,
+    });
+  }
+  const prepared = await session.openRealtimeConnection({
+    ...(audio === undefined ? {} : { audio }),
+    ...(metadata === undefined ? {} : { metadata }),
+  });
+  return { catalog, selection, ...prepared };
+}
+
+if (
+  process.argv[1] &&
+  import.meta.url === pathToFileURL(process.argv[1]).href
+) {
+  const {
+    AGENT_SERVICE_URL,
+    USER_API_KEY,
+    SESSION_ID,
+    REALTIME_MODEL_ID,
+  } = process.env;
+  if (!AGENT_SERVICE_URL || !USER_API_KEY || !SESSION_ID) {
+    throw new Error(
+      "Set AGENT_SERVICE_URL, USER_API_KEY and SESSION_ID; REALTIME_MODEL_ID is optional",
+    );
+  }
+  const result = await prepareRealtimeConnection({
+    baseUrl: AGENT_SERVICE_URL,
+    userApiKey: USER_API_KEY,
+    sessionId: SESSION_ID,
+    ...(REALTIME_MODEL_ID ? { realtimeModelId: REALTIME_MODEL_ID } : {}),
+  });
+  // The one-time connect token is returned to imported callers but never printed by this CLI.
+  console.log(
+    JSON.stringify({
+      realtimeConnection: result.realtimeConnection,
+      websocketUrl: result.websocketUrl,
+      connectTokenExpiresAt: result.connectTokenExpiresAt,
+    }),
+  );
+}