@ringko-ai/rkh 0.2.0 → 0.2.1-rc

package/README.md

@@ -1,28 +1,26 @@
 # RingKo CLI
 
-Run the RingKo agent from a terminal with Node.js 24+ and [Bun](https://bun.sh/) installed:
-
-```sh
-npx @ringko-ai/rkh tui
-```
-
-The `rkh` executable requires Bun on your PATH. You can also use
-`bunx @ringko-ai/rkh tui`, or run `npx @ringko-ai/rkh help` to list commands.
-
-For a global installation:
+`@ringko-ai/rkh` is the RingKo agent CLI, distributed as a globally installed npm
+package. The `ringko` executable is a Bun bundle, so Node.js 24+ **and**
+[Bun](https://bun.sh/) 1.2+ must be on `PATH` — Bun is not optional.
 
 ```sh
 npm install -g @ringko-ai/rkh
-rkh tui
+ringko tui
 ```
 
-The public npm package is `@ringko-ai/rkh`; its command is `rkh`.
+`ringko help` lists every command. Without a global install, `npx @ringko-ai/rkh tui`
+and `bunx @ringko-ai/rkh tui` run the same CLI.
+
+Prerelease versions publish under the `next` dist-tag: `npm install -g @ringko-ai/rkh@next`.
 
 This package bundles the CLI, built-in model providers and the WebUI assets.
 The browser's interactive terminal uses Node.js and the `node-pty` dependency.
-Custom provider modules configured by the host are loaded separately at runtime. For source
-development and standalone platform binaries, see the
-[repository](https://github.com/RingKoAI/ringko-harness).
+Custom provider modules configured by the host are loaded separately at runtime.
+The package installs the `ringko` command; the standalone platform binaries
+use the same name. For source development and standalone binaries, see the
+[repository](https://github.com/RingKoAI/ringko-harness); the Chinese README is
+[README.zh-CN.md](https://github.com/RingKoAI/ringko-harness/blob/main/README.zh-CN.md).
 
 ## Automatic npm releases
 

package/bin/{rkh.mjs → ringko.mjs}

@@ -24830,6 +24830,314 @@ var init_write = __esm(() => {
   init_workspace();
 });
 
+// packages/tools/src/session-query.ts
+import { resolve as resolve5 } from "path";
+function asRecord3(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    throw new TypeError("Expected an object input.");
+  }
+  return value;
+}
+function integerField(record, key, min, max) {
+  const value = record[key];
+  if (value === undefined)
+    return;
+  if (typeof value !== "number" || !Number.isSafeInteger(value) || value < min || value > max) {
+    throw new TypeError(`Invalid '${key}'; expected an integer between ${min} and ${max}.`);
+  }
+  return value;
+}
+function stringField(record, key, max) {
+  const value = record[key];
+  if (value === undefined)
+    return;
+  if (typeof value !== "string" || value.trim().length === 0 || value.length > max) {
+    throw new TypeError(`Invalid '${key}'; expected a non-empty string of at most ${max} characters.`);
+  }
+  return value;
+}
+function normalizePath(path) {
+  const resolved = resolve5(path);
+  return process.platform === "win32" ? resolved.toLowerCase() : resolved;
+}
+function inWorkspace(cwd, workspace) {
+  return typeof cwd === "string" && cwd.length > 0 && normalizePath(cwd) === normalizePath(workspace);
+}
+function serialize2(value) {
+  if (value === undefined)
+    return "";
+  try {
+    return typeof value === "string" ? value : JSON.stringify(value) ?? "";
+  } catch {
+    return String(value);
+  }
+}
+function collapse(text) {
+  return text.replace(/\s+/g, " ").trim();
+}
+function snippetOf(text, needle, limit) {
+  const folded = text.toLowerCase();
+  const at = folded.indexOf(needle);
+  if (at < 0)
+    return collapse(text).slice(0, limit);
+  const start = Math.max(0, at - Math.floor((limit - needle.length) / 2));
+  const window2 = collapse(text.slice(start, start + limit * 2));
+  return window2.length > limit ? `${window2.slice(0, limit)}\u2026` : window2;
+}
+function titleFor(handle) {
+  try {
+    return sessionTitle(handle.all());
+  } catch {
+    return;
+  }
+}
+function openScoped(store, workspace, id, limits) {
+  const meta = store.list().find((candidate) => candidate.id === id);
+  if (!meta)
+    throw new Error(`No session "${id}" in this workspace.`);
+  if (meta.sizeBytes > limits.sessionBytes) {
+    throw new Error(`Session "${id}" is too large to read (${meta.sizeBytes} bytes; limit ${limits.sessionBytes}).`);
+  }
+  const handle = store.open(meta.id, "read");
+  try {
+    if (!inWorkspace(handle.header.cwd, workspace)) {
+      throw new Error(`Session "${id}" belongs to another workspace.`);
+    }
+    const title = titleFor(handle);
+    return {
+      summary: {
+        id: handle.header.id,
+        ...title ? { title } : {},
+        createdAt: handle.header.createdAt,
+        sizeBytes: meta.sizeBytes,
+        ...handle.header.parentSession ? { parentSession: handle.header.parentSession } : {}
+      },
+      events: handle.all()
+    };
+  } finally {
+    handle.close();
+  }
+}
+function summaryFor(meta, store, limits) {
+  const base = {
+    id: meta.id,
+    createdAt: meta.header.createdAt,
+    sizeBytes: meta.sizeBytes,
+    ...meta.header.parentSession ? { parentSession: meta.header.parentSession } : {}
+  };
+  if (meta.sizeBytes > limits.titleBytes)
+    return base;
+  try {
+    const handle = store.open(meta.id, "read");
+    try {
+      const title = titleFor(handle);
+      return title ? { ...base, title } : base;
+    } finally {
+      handle.close();
+    }
+  } catch {
+    return base;
+  }
+}
+function createSessionListTool(store, workspace, limits = SESSION_QUERY_LIMITS) {
+  return defineTool({
+    name: "session_list",
+    taskAccess: "read",
+    description: "List the recorded sessions of the current workspace, newest first, with id, title, creation time and size. Use the id with session_read or session_search.",
+    inputSchema: {
+      type: "object",
+      properties: { limit: { type: "integer", minimum: 1, maximum: limits.sessions } },
+      additionalProperties: false
+    },
+    parseInput(value) {
+      if (value === undefined || value === null)
+        return {};
+      const record = asRecord3(value);
+      const limit = integerField(record, "limit", 1, limits.sessions);
+      return limit === undefined ? {} : { limit };
+    },
+    assessRisk() {
+      return { kind: "workspace_file", reason: "List recorded sessions for this workspace.", target: "session:list" };
+    },
+    execute({ limit }) {
+      const all = store.list().filter((meta) => inWorkspace(meta.header.cwd, workspace));
+      const selected = all.slice(0, limit ?? limits.sessions);
+      return {
+        workspace,
+        sessions: selected.map((meta) => summaryFor(meta, store, limits)),
+        truncated: all.length > selected.length
+      };
+    }
+  });
+}
+function createSessionSearchTool(store, workspace, limits = SESSION_QUERY_LIMITS) {
+  return defineTool({
+    name: "session_search",
+    taskAccess: "read",
+    description: "Search recorded session events in this workspace for a case-insensitive substring. Returns the session id, sequence number, event type and a short snippet for each match; follow up with session_read.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        query: { type: "string", minLength: 1, maxLength: limits.queryCharacters },
+        session: { type: "string" }
+      },
+      required: ["query"],
+      additionalProperties: false
+    },
+    parseInput(value) {
+      const record = asRecord3(value);
+      const query = stringField(record, "query", limits.queryCharacters);
+      if (query === undefined)
+        throw new TypeError("Expected a non-empty string 'query'.");
+      const session = stringField(record, "session", 256);
+      return session === undefined ? { query } : { query, session };
+    },
+    assessRisk(input) {
+      const target = input.session ? `session:${input.session}` : "session:search";
+      return { kind: "workspace_file", reason: "Search recorded session events for this workspace.", target };
+    },
+    execute({ query, session }) {
+      const needle = query.toLowerCase();
+      const all = store.list().filter((meta) => inWorkspace(meta.header.cwd, workspace));
+      const targets = session ? all.filter((meta) => meta.id === session) : all.slice(0, limits.sessions);
+      if (session !== undefined && targets.length === 0)
+        throw new Error(`No session "${session}" in this workspace.`);
+      const matches = [];
+      const scanned = { sessions: 0, events: 0 };
+      let characters = 0;
+      let bytes = 0;
+      let truncated = false;
+      for (const meta of targets) {
+        if (matches.length >= limits.events || characters >= limits.responseCharacters) {
+          truncated = true;
+          break;
+        }
+        if (bytes + meta.sizeBytes > limits.scanBytes) {
+          truncated = true;
+          break;
+        }
+        let scoped;
+        try {
+          scoped = openScoped(store, workspace, meta.id, limits);
+        } catch {
+          continue;
+        }
+        bytes += meta.sizeBytes;
+        scanned.sessions += 1;
+        for (const event of scoped.events.slice(0, limits.scanEventsPerSession)) {
+          if (matches.length >= limits.events || characters >= limits.responseCharacters) {
+            truncated = true;
+            break;
+          }
+          scanned.events += 1;
+          const haystack = `${event.type} ${serialize2(event.data)}`;
+          if (!haystack.toLowerCase().includes(needle))
+            continue;
+          const snippet = snippetOf(haystack, needle, limits.snippetCharacters);
+          matches.push({ session: meta.id, seq: event.seq, time: event.time, type: event.type, snippet });
+          characters += snippet.length + 64;
+        }
+      }
+      return { query, matches, scanned, truncated };
+    }
+  });
+}
+function createSessionReadTool(store, workspace, limits = SESSION_QUERY_LIMITS) {
+  return defineTool({
+    name: "session_read",
+    taskAccess: "read",
+    description: "Read recorded events from one session of this workspace by sequence cursor. Returns seq, time, type and data; oversized data is returned as bounded text.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        session: { type: "string" },
+        before: { type: "integer", minimum: 0 },
+        after: { type: "integer", minimum: 0 },
+        limit: { type: "integer", minimum: 1, maximum: limits.events }
+      },
+      required: ["session"],
+      additionalProperties: false
+    },
+    parseInput(value) {
+      const record = asRecord3(value);
+      const session = stringField(record, "session", 256);
+      if (session === undefined)
+        throw new TypeError("Expected a non-empty string 'session'.");
+      const before = integerField(record, "before", 0, Number.MAX_SAFE_INTEGER);
+      const after = integerField(record, "after", 0, Number.MAX_SAFE_INTEGER);
+      if (before !== undefined && after !== undefined)
+        throw new TypeError("Pass either 'before' or 'after', not both.");
+      const limit = integerField(record, "limit", 1, limits.events);
+      return { session, ...before !== undefined ? { before } : {}, ...after !== undefined ? { after } : {}, ...limit !== undefined ? { limit } : {} };
+    },
+    assessRisk(input) {
+      return { kind: "workspace_file", reason: "Read recorded events from a session of this workspace.", target: `session:${input.session}` };
+    },
+    execute({ session, before, after, limit }) {
+      const scoped = openScoped(store, workspace, session, limits);
+      const candidates = scoped.events.filter((event) => before !== undefined ? event.seq < before : after !== undefined ? event.seq > after : true);
+      const selected = after !== undefined ? candidates.slice(0, limit ?? limits.events) : candidates.slice(-(limit ?? limits.events));
+      const records = [];
+      let characters = 0;
+      let truncated = false;
+      for (const event of selected) {
+        const text = serialize2(event.data);
+        const tooLarge = text.length > limits.eventCharacters;
+        if (characters + Math.min(text.length, limits.eventCharacters) > limits.responseCharacters) {
+          truncated = true;
+          break;
+        }
+        characters += Math.min(text.length, limits.eventCharacters) + 64;
+        records.push({
+          seq: event.seq,
+          time: event.time,
+          type: event.type,
+          ...tooLarge ? { dataText: `${text.slice(0, limits.eventCharacters)}\u2026` } : event.data !== undefined ? { data: event.data } : {},
+          dataTruncated: tooLarge
+        });
+      }
+      const first = selected[0];
+      const last = selected[selected.length - 1];
+      return {
+        session: scoped.summary,
+        events: records,
+        hasOlder: first !== undefined && candidates.some((event) => event.seq < first.seq),
+        hasNewer: last !== undefined && candidates.some((event) => event.seq > last.seq),
+        truncated: truncated || records.length < selected.length
+      };
+    }
+  });
+}
+function registerSessionQueryTools(registry, options) {
+  if (typeof options.workspace !== "string" || options.workspace.trim().length === 0) {
+    throw new TypeError("Session query tools require a workspace.");
+  }
+  const limits = { ...SESSION_QUERY_LIMITS, ...options.limits };
+  const store = options.store ?? new SessionStore({ cwd: options.workspace });
+  registry.registerAll([
+    createSessionListTool(store, options.workspace, limits),
+    createSessionSearchTool(store, options.workspace, limits),
+    createSessionReadTool(store, options.workspace, limits)
+  ]);
+}
+var SESSION_QUERY_LIMITS;
+var init_session_query = __esm(() => {
+  init_src();
+  init_src3();
+  SESSION_QUERY_LIMITS = Object.freeze({
+    sessions: 50,
+    events: 100,
+    sessionBytes: 4 * 1024 * 1024,
+    titleBytes: 256 * 1024,
+    scanBytes: 32 * 1024 * 1024,
+    eventCharacters: 4096,
+    snippetCharacters: 240,
+    queryCharacters: 200,
+    responseCharacters: 60000,
+    scanEventsPerSession: 20000
+  });
+});
+
 // packages/tools/src/index.ts
 function registerWorkspaceTools(registry, options) {
   const workspace = createWorkspace(options.workspace);
@@ -24871,6 +25179,7 @@ var init_src7 = __esm(() => {
   init_write();
   init_workspace();
   init_ask();
+  init_session_query();
 });
 
 // packages/workflow/src/index.ts
@@ -25016,7 +25325,7 @@ var init_skills2 = __esm(() => {
 // packages/sdk/src/permissions.ts
 import { createHash as createHash2, randomUUID as randomUUID6 } from "crypto";
 import { closeSync as closeSync5, existsSync as existsSync3, fstatSync, mkdirSync as mkdirSync11, openSync as openSync5, readSync as readSync2, renameSync as renameSync4, unlinkSync as unlinkSync2, writeFileSync as writeFileSync9 } from "fs";
-import { join as join12, resolve as resolve5 } from "path";
+import { join as join12, resolve as resolve6 } from "path";
 function validateRules(value) {
   if (!Array.isArray(value) || value.length > MAX_RULES)
     throw new TypeError("Invalid permission rules.");
@@ -25031,7 +25340,7 @@ class PermissionManager {
   path;
   sessions = new Map;
   constructor(workspace) {
-    const key = createHash2("sha256").update(resolve5(workspace)).digest("hex");
+    const key = createHash2("sha256").update(resolve6(workspace)).digest("hex");
     this.path = join12(ringkoRoot(), "permissions", `${key}.json`);
   }
   saved() {
@@ -25285,7 +25594,7 @@ var init_mcp_manager = __esm(() => {
 });
 
 // packages/sdk/src/runtime.ts
-import { resolve as resolve6 } from "path";
+import { resolve as resolve7 } from "path";
 function applyToolPolicy(agent, workflow) {
   for (const tool of agent.tools.list())
     if (!workflowAllowsTool(workflow, tool.name))
@@ -25304,6 +25613,7 @@ function registerRuntimeTools(agent, config, workspace, host = {}, session) {
   registerSessionTools(agent.tools, { todos, ask: host.ask ?? (async () => {
     throw new Error("Questions require an interactive host.");
   }) });
+  registerSessionQueryTools(agent.tools, { workspace });
   if (config.capabilities?.network)
     registerNetworkTools(agent.tools, {
       allowPrivateHosts: config.capabilities.privateNetwork === true,
@@ -25329,7 +25639,7 @@ class RuntimeManager {
   constructor(workspace, log) {
     if (typeof workspace !== "string" || !workspace.trim())
       throw new TypeError("Runtime requires a workspace.");
-    this.workspace = resolve6(workspace);
+    this.workspace = resolve7(workspace);
     this.permissions = new PermissionManager(this.workspace);
     this.mcp = new McpManager(this.workspace);
     this.log = log ?? new EventLog;
@@ -35934,7 +36244,7 @@ function createProviderExecutedToolFactory({
     supportsDeferredResults
   });
 }
-async function resolve9(value) {
+async function resolve10(value) {
   if (typeof value === "function") {
     value = value();
   }
@@ -42080,7 +42390,7 @@ var anthropicErrorDataSchema, anthropicFailedResponseHandler, anthropicUploadFil
     });
   }
   async getBatchHeaders(headers) {
-    return combineHeaders(this.options.config.headers ? await resolve9(this.options.config.headers) : undefined, headers);
+    return combineHeaders(this.options.config.headers ? await resolve10(this.options.config.headers) : undefined, headers);
   }
 }, bash_20241022InputSchema, bash_20241022_internal, bash_20250124InputSchema, bash_20250124_internal, computer_20241022InputSchema, computer_20241022, computer_20250124InputSchema, computer_20250124, computer_20251124InputSchema, computer_20251124, memory_20250818InputSchema, memory_20250818, textEditor_20241022InputSchema, textEditor_20241022, textEditor_20250124InputSchema, textEditor_20250124, textEditor_20250429InputSchema, textEditor_20250429, toolSearchBm25_20251119OutputSchema, toolSearchBm25_20251119InputSchema, factory13, toolSearchBm25_20251119 = (args = {}) => {
   return factory13(args);
@@ -42093,7 +42403,7 @@ var anthropicErrorDataSchema, anthropicFailedResponseHandler, anthropicUploadFil
     return this.config.provider;
   }
   async getHeaders() {
-    return combineHeaders(await resolve9(this.config.headers), {
+    return combineHeaders(await resolve10(this.config.headers), {
       "anthropic-beta": "skills-2025-10-02"
     });
   }
@@ -44258,10 +44568,10 @@ var init_dist5 = __esm(() => {
       betas,
       headers
     }) {
-      return combineHeaders(this.config.headers ? await resolve9(this.config.headers) : undefined, headers, betas.size > 0 ? { "anthropic-beta": Array.from(betas).join(",") } : {});
+      return combineHeaders(this.config.headers ? await resolve10(this.config.headers) : undefined, headers, betas.size > 0 ? { "anthropic-beta": Array.from(betas).join(",") } : {});
     }
     async getBetasFromHeaders(requestHeaders) {
-      const configHeaders = this.config.headers ? await resolve9(this.config.headers) : undefined;
+      const configHeaders = this.config.headers ? await resolve10(this.config.headers) : undefined;
       const configBetaHeader = configHeaders?.["anthropic-beta"] ?? "";
       const requestBetaHeader = requestHeaders?.["anthropic-beta"] ?? "";
       return new Set([
@@ -50850,7 +51160,7 @@ var VERSION3 = "4.0.82", googleErrorDataSchema, googleFailedResponseHandler, goo
     return { ...prepared, warnings: [...warnings, ...prepared.warnings] };
   }
   async getHeaders(headers) {
-    return combineHeaders(this.batchConfig.headers ? await resolve9(this.batchConfig.headers) : undefined, headers);
+    return combineHeaders(this.batchConfig.headers ? await resolve10(this.batchConfig.headers) : undefined, headers);
   }
   getBaseOrigin() {
     return this.batchConfig.baseURL.replace(/\/v1beta$/, "");
@@ -51088,7 +51398,7 @@ var VERSION3 = "4.0.82", googleErrorDataSchema, googleFailedResponseHandler, goo
     }
     const videos = [];
     const videoMetadata = [];
-    const resolvedHeaders = await resolve9(this.config.headers);
+    const resolvedHeaders = await resolve10(this.config.headers);
     const apiKey = resolvedHeaders?.["x-goog-api-key"];
     for (const generatedSample of response.generateVideoResponse.generatedSamples) {
       if (generatedSample.video?.uri) {
@@ -51130,7 +51440,7 @@ var VERSION3 = "4.0.82", googleErrorDataSchema, googleFailedResponseHandler, goo
     const { instances, parameters, warnings } = await this.buildRequest(options);
     const { value: operation, responseHeaders } = await postJsonToApi({
       url: `${this.config.baseURL}/models/${this.modelId}:predictLongRunning`,
-      headers: combineHeaders(await resolve9(this.config.headers), options.headers),
+      headers: combineHeaders(await resolve10(this.config.headers), options.headers),
       body: {
         instances,
         parameters
@@ -51163,7 +51473,7 @@ var VERSION3 = "4.0.82", googleErrorDataSchema, googleFailedResponseHandler, goo
     const { value: statusOperation, responseHeaders } = await getFromApi({
       url: `${this.config.baseURL}/${operationName}`,
       validateUrl: false,
-      headers: combineHeaders(await resolve9(this.config.headers), options.headers),
+      headers: combineHeaders(await resolve10(this.config.headers), options.headers),
       successfulResponseHandler: createJsonResponseHandler(googleOperationSchema),
       failedResponseHandler: googleFailedResponseHandler,
       abortSignal: options.abortSignal,
@@ -51813,7 +52123,7 @@ var init_dist6 = __esm(() => {
           values
         });
       }
-      const mergedHeaders = combineHeaders(this.config.headers ? await resolve9(this.config.headers) : undefined, headers);
+      const mergedHeaders = combineHeaders(this.config.headers ? await resolve10(this.config.headers) : undefined, headers);
       const multimodalContent = googleOptions?.content;
       validateMultimodalContentLength({ multimodalContent, values });
       if (values.length === 1) {
@@ -52397,7 +52707,7 @@ var init_dist6 = __esm(() => {
         extraHeaders,
         toolNameMapping
       } = await this.getArgs(options);
-      const mergedHeaders = combineHeaders(this.config.headers ? await resolve9(this.config.headers) : undefined, options.headers, extraHeaders);
+      const mergedHeaders = combineHeaders(this.config.headers ? await resolve10(this.config.headers) : undefined, options.headers, extraHeaders);
       const {
         responseHeaders,
         value: response,
@@ -52437,7 +52747,7 @@ var init_dist6 = __esm(() => {
         toolNameMapping
       } = await this.getArgs(options, { isStreaming: true });
       const wrapProviderMetadata = (payload) => Object.fromEntries(providerOptionsNames.map((name) => [name, payload]));
-      const headers = combineHeaders(this.config.headers ? await resolve9(this.config.headers) : undefined, options.headers, extraHeaders);
+      const headers = combineHeaders(this.config.headers ? await resolve10(this.config.headers) : undefined, options.headers, extraHeaders);
       const { responseHeaders, value: response } = await postJsonToApi({
         url: `${this.config.baseURL}/${getModelPath(this.modelId)}:streamGenerateContent?alt=sse`,
         headers,
@@ -53439,7 +53749,7 @@ var init_dist6 = __esm(() => {
         rawValue: rawResponse
       } = await postJsonToApi({
         url: `${this.config.baseURL}/models/${this.modelId}:generateContent`,
-        headers: combineHeaders(this.config.headers ? await resolve9(this.config.headers) : undefined, options.headers),
+        headers: combineHeaders(this.config.headers ? await resolve10(this.config.headers) : undefined, options.headers),
         body: requestBody,
         failedResponseHandler: googleFailedResponseHandler,
         successfulResponseHandler: createJsonResponseHandler(googleSpeechResponseSchema),
@@ -54121,7 +54431,7 @@ var init_dist6 = __esm(() => {
     async doGenerate(options) {
       const { args, warnings, isAgent, pollingTimeoutMs } = await this.getArgs(options);
       const url = `${this.config.baseURL}/interactions`;
-      const mergedHeaders = combineHeaders(this.config.headers ? await resolve9(this.config.headers) : undefined, options.headers);
+      const mergedHeaders = combineHeaders(this.config.headers ? await resolve10(this.config.headers) : undefined, options.headers);
       const postResult = await postJsonToApi({
         url,
         headers: mergedHeaders,
@@ -54197,7 +54507,7 @@ var init_dist6 = __esm(() => {
     async doStream(options) {
       const { args, warnings, isBackground, pollingTimeoutMs } = await this.getArgs(options);
       const url = `${this.config.baseURL}/interactions`;
-      const mergedHeaders = combineHeaders(this.config.headers ? await resolve9(this.config.headers) : undefined, options.headers);
+      const mergedHeaders = combineHeaders(this.config.headers ? await resolve10(this.config.headers) : undefined, options.headers);
       if (isBackground) {
         return this.doStreamBackground({
           args,
@@ -54348,7 +54658,7 @@ var init_dist6 = __esm(() => {
         rawValue: rawResponse
       } = await postJsonToApi({
         url: `${this.config.baseURL}/interactions`,
-        headers: combineHeaders(this.config.headers ? await resolve9(this.config.headers) : undefined, options.headers),
+        headers: combineHeaders(this.config.headers ? await resolve10(this.config.headers) : undefined, options.headers),
         body: requestBody,
         failedResponseHandler: googleFailedResponseHandler,
         successfulResponseHandler: createJsonResponseHandler(googleInteractionsTranscriptionResponseSchema),
@@ -54404,7 +54714,7 @@ var init_dist6 = __esm(() => {
       const warnings = [];
       const googleOptions = await this.parseOptions(options.providerOptions);
       validateLiveInputAudioFormat(options.inputAudioFormat);
-      const headers = combineHeaders(this.config.headers ? await resolve9(this.config.headers) : undefined, options.headers);
+      const headers = combineHeaders(this.config.headers ? await resolve10(this.config.headers) : undefined, options.headers);
       let apiKey;
       for (const [key, value] of Object.entries(headers)) {
         if (key.toLowerCase() === "x-goog-api-key" && value != null) {
@@ -54732,21 +55042,21 @@ function createOpenAIStreamError({
   });
 }
 function parseStreamError(frame) {
-  const value = asRecord3(frame);
+  const value = asRecord4(frame);
   if (value == null) {
     return;
   }
   if (value.type === "response.failed") {
-    const response = asRecord3(value.response);
-    const responseError = asRecord3(response?.error);
+    const response = asRecord4(value.response);
+    const responseError = asRecord4(response?.error);
     return typeof responseError?.message === "string" ? {
       message: responseError.message,
       code: getStringOrNumber(responseError.code),
       type: "response.failed"
     } : undefined;
   }
-  const error = asRecord3(value.error) ?? value;
-  return typeof error.message === "string" && (asRecord3(value.error) != null || typeof error.type === "string" || ("code" in error) || ("param" in error)) ? {
+  const error = asRecord4(value.error) ?? value;
+  return typeof error.message === "string" && (asRecord4(value.error) != null || typeof error.type === "string" || ("code" in error) || ("param" in error)) ? {
     message: error.message,
     code: getStringOrNumber(error.code),
     type: typeof error.type === "string" ? error.type : undefined
@@ -54776,7 +55086,7 @@ function getStatusCode(error) {
     return 504;
   return 500;
 }
-function asRecord3(value) {
+function asRecord4(value) {
   return typeof value === "object" && value != null ? value : undefined;
 }
 function getStringOrNumber(value) {
@@ -68216,7 +68526,7 @@ var import_oidc, import_oidc2, GATEWAY_REALTIME_SUBPROTOCOL = "ai-gateway-realti
       const { value } = await getFromApi({
         url: `${this.config.baseURL}/config`,
         validateUrl: false,
-        headers: this.config.headers ? await resolve9(this.config.headers) : undefined,
+        headers: this.config.headers ? await resolve10(this.config.headers) : undefined,
         successfulResponseHandler: createJsonResponseHandler(gatewayAvailableModelsResponseSchema),
         failedResponseHandler: createJsonErrorResponseHandler({
           errorSchema: z.any(),
@@ -68235,7 +68545,7 @@ var import_oidc, import_oidc2, GATEWAY_REALTIME_SUBPROTOCOL = "ai-gateway-realti
       const { value } = await getFromApi({
         url: `${baseUrl.origin}/v1/credits`,
         validateUrl: false,
-        headers: this.config.headers ? await resolve9(this.config.headers) : undefined,
+        headers: this.config.headers ? await resolve10(this.config.headers) : undefined,
         successfulResponseHandler: createJsonResponseHandler(gatewayCreditsResponseSchema),
         failedResponseHandler: createJsonErrorResponseHandler({
           errorSchema: z.any(),
@@ -68282,7 +68592,7 @@ var import_oidc, import_oidc2, GATEWAY_REALTIME_SUBPROTOCOL = "ai-gateway-realti
       const { value } = await getFromApi({
         url: `${baseUrl.origin}/v1/report?${searchParams.toString()}`,
         validateUrl: false,
-        headers: this.config.headers ? await resolve9(this.config.headers) : undefined,
+        headers: this.config.headers ? await resolve10(this.config.headers) : undefined,
         successfulResponseHandler: createJsonResponseHandler(gatewaySpendReportResponseSchema),
         failedResponseHandler: createJsonErrorResponseHandler({
           errorSchema: z.any(),
@@ -68305,7 +68615,7 @@ var import_oidc, import_oidc2, GATEWAY_REALTIME_SUBPROTOCOL = "ai-gateway-realti
       const { value } = await getFromApi({
         url: `${baseUrl.origin}/v1/generation?id=${encodeURIComponent(params.id)}`,
         validateUrl: false,
-        headers: this.config.headers ? await resolve9(this.config.headers) : undefined,
+        headers: this.config.headers ? await resolve10(this.config.headers) : undefined,
         successfulResponseHandler: createJsonResponseHandler(gatewayGenerationInfoResponseSchema),
         failedResponseHandler: createJsonErrorResponseHandler({
           errorSchema: z.any(),
@@ -68334,13 +68644,13 @@ var import_oidc, import_oidc2, GATEWAY_REALTIME_SUBPROTOCOL = "ai-gateway-realti
   }) {
     assertTextBatchRequests3(requests);
     const modelId = validateSingleModel2(requests);
-    const resolvedHeaders = this.config.headers ? await resolve9(this.config.headers) : undefined;
+    const resolvedHeaders = this.config.headers ? await resolve10(this.config.headers) : undefined;
     const idempotencyKey = getGatewayBatchIdempotencyKey(providerOptions);
     const forwardedProviderOptions = omitGatewayIdempotencyKey(providerOptions);
     try {
       const { value: responseBody } = await postJsonToApi({
         url: this.getBatchUrl("start"),
-        headers: combineHeaders(resolvedHeaders, headers, { "ai-model-id": modelId }, await resolve9(this.config.o11yHeaders), idempotencyKey != null ? { "idempotency-key": idempotencyKey } : undefined),
+        headers: combineHeaders(resolvedHeaders, headers, { "ai-model-id": modelId }, await resolve10(this.config.o11yHeaders), idempotencyKey != null ? { "idempotency-key": idempotencyKey } : undefined),
         body: {
           ...webhookUrl != null && { callbackUrl: webhookUrl },
           requests: requests.map((request) => ({
@@ -68378,11 +68688,11 @@ var import_oidc, import_oidc2, GATEWAY_REALTIME_SUBPROTOCOL = "ai-gateway-realti
     headers,
     abortSignal
   }) {
-    const resolvedHeaders = this.config.headers ? await resolve9(this.config.headers) : undefined;
+    const resolvedHeaders = this.config.headers ? await resolve10(this.config.headers) : undefined;
     try {
       const { value: responseBody } = await postJsonToApi({
         url: this.getBatchUrl("status"),
-        headers: combineHeaders(resolvedHeaders, headers, await resolve9(this.config.o11yHeaders)),
+        headers: combineHeaders(resolvedHeaders, headers, await resolve10(this.config.o11yHeaders)),
         body: { batchId },
         successfulResponseHandler: createJsonResponseHandler(gatewayBatchStatusResponseSchema),
         failedResponseHandler: createJsonErrorResponseHandler({
@@ -68405,11 +68715,11 @@ var import_oidc, import_oidc2, GATEWAY_REALTIME_SUBPROTOCOL = "ai-gateway-realti
     headers,
     abortSignal
   }) {
-    const resolvedHeaders = this.config.headers ? await resolve9(this.config.headers) : undefined;
+    const resolvedHeaders = this.config.headers ? await resolve10(this.config.headers) : undefined;
     try {
       const { value: lines } = await postJsonToApi({
         url: this.getBatchUrl("results"),
-        headers: combineHeaders(resolvedHeaders, headers, await resolve9(this.config.o11yHeaders)),
+        headers: combineHeaders(resolvedHeaders, headers, await resolve10(this.config.o11yHeaders)),
         body: { batchId },
         successfulResponseHandler: createJsonLinesResponseHandler(gatewayBatchItemResultLineSchema),
         failedResponseHandler: createJsonErrorResponseHandler({
@@ -68432,11 +68742,11 @@ var import_oidc, import_oidc2, GATEWAY_REALTIME_SUBPROTOCOL = "ai-gateway-realti
     headers,
     abortSignal
   }) {
-    const resolvedHeaders = this.config.headers ? await resolve9(this.config.headers) : undefined;
+    const resolvedHeaders = this.config.headers ? await resolve10(this.config.headers) : undefined;
     try {
       const { value: responseBody } = await postJsonToApi({
         url: this.getBatchUrl("cancel"),
-        headers: combineHeaders(resolvedHeaders, headers, await resolve9(this.config.o11yHeaders)),
+        headers: combineHeaders(resolvedHeaders, headers, await resolve10(this.config.o11yHeaders)),
         body: { batchId },
         successfulResponseHandler: createJsonResponseHandler(gatewayBatchStatusResponseSchema),
         failedResponseHandler: createJsonErrorResponseHandler({
@@ -68473,11 +68783,11 @@ var import_oidc, import_oidc2, GATEWAY_REALTIME_SUBPROTOCOL = "ai-gateway-realti
   }
   async doGenerate(options) {
     const { headers, abortSignal } = options;
-    const resolvedHeaders = this.config.headers ? await resolve9(this.config.headers) : undefined;
+    const resolvedHeaders = this.config.headers ? await resolve10(this.config.headers) : undefined;
     try {
       const { responseHeaders, value: responseBody } = await postJsonToApi({
         url: this.getUrl(),
-        headers: combineHeaders(resolvedHeaders, headers ?? {}, this.getModelConfigHeaders(), await resolve9(this.config.o11yHeaders), { accept: "text/event-stream" }),
+        headers: combineHeaders(resolvedHeaders, headers ?? {}, this.getModelConfigHeaders(), await resolve10(this.config.o11yHeaders), { accept: "text/event-stream" }),
         body: this.buildRequestBody(options),
         successfulResponseHandler: async ({
           response,
@@ -68572,11 +68882,11 @@ var import_oidc, import_oidc2, GATEWAY_REALTIME_SUBPROTOCOL = "ai-gateway-realti
   }
   async doStart(options) {
     const { headers, abortSignal, webhookUrl } = options;
-    const resolvedHeaders = this.config.headers ? await resolve9(this.config.headers) : undefined;
+    const resolvedHeaders = this.config.headers ? await resolve10(this.config.headers) : undefined;
     try {
       const { responseHeaders, value: responseBody } = await postJsonToApi({
         url: this.getStartUrl(),
-        headers: combineHeaders(resolvedHeaders, headers ?? {}, this.getModelConfigHeaders(), await resolve9(this.config.o11yHeaders)),
+        headers: combineHeaders(resolvedHeaders, headers ?? {}, this.getModelConfigHeaders(), await resolve10(this.config.o11yHeaders)),
         body: {
           ...this.buildRequestBody(options),
           ...webhookUrl && { callbackUrl: webhookUrl }
@@ -68608,11 +68918,11 @@ var import_oidc, import_oidc2, GATEWAY_REALTIME_SUBPROTOCOL = "ai-gateway-realti
     abortSignal,
     headers
   }) {
-    const resolvedHeaders = this.config.headers ? await resolve9(this.config.headers) : undefined;
+    const resolvedHeaders = this.config.headers ? await resolve10(this.config.headers) : undefined;
     try {
       const { responseHeaders, value: responseBody } = await postJsonToApi({
         url: this.getStatusUrl(),
-        headers: combineHeaders(resolvedHeaders, headers ?? {}, this.getModelConfigHeaders(), await resolve9(this.config.o11yHeaders)),
+        headers: combineHeaders(resolvedHeaders, headers ?? {}, this.getModelConfigHeaders(), await resolve10(this.config.o11yHeaders)),
         body: { operation },
         successfulResponseHandler: createJsonResponseHandler(gatewayVideoStatusResponseSchema),
         failedResponseHandler: createJsonErrorResponseHandler({
@@ -68736,7 +69046,7 @@ var import_oidc, import_oidc2, GATEWAY_REALTIME_SUBPROTOCOL = "ai-gateway-realti
       schema: gatewayEvaluationProviderOptionsSchema
     });
     const validatedProviderOptions = gatewayOptions == null ? providerOptions : { ...providerOptions, gateway: gatewayOptions };
-    const resolvedHeaders = this.config.headers ? await resolve9(this.config.headers) : undefined;
+    const resolvedHeaders = this.config.headers ? await resolve10(this.config.headers) : undefined;
     try {
       const {
         responseHeaders,
@@ -68744,7 +69054,7 @@ var import_oidc, import_oidc2, GATEWAY_REALTIME_SUBPROTOCOL = "ai-gateway-realti
         rawValue
       } = await postJsonToApi({
         url: this.getUrl(),
-        headers: combineHeaders(resolvedHeaders, headers ?? {}, this.getModelConfigHeaders(), await resolve9(this.config.o11yHeaders)),
+        headers: combineHeaders(resolvedHeaders, headers ?? {}, this.getModelConfigHeaders(), await resolve10(this.config.o11yHeaders)),
         body: {
           state,
           questions,
@@ -68800,7 +69110,7 @@ var import_oidc, import_oidc2, GATEWAY_REALTIME_SUBPROTOCOL = "ai-gateway-realti
     abortSignal,
     providerOptions
   }) {
-    const resolvedHeaders = this.config.headers ? await resolve9(this.config.headers) : undefined;
+    const resolvedHeaders = this.config.headers ? await resolve10(this.config.headers) : undefined;
     try {
       const {
         responseHeaders,
@@ -68808,7 +69118,7 @@ var import_oidc, import_oidc2, GATEWAY_REALTIME_SUBPROTOCOL = "ai-gateway-realti
         rawValue
       } = await postJsonToApi({
         url: this.getUrl(),
-        headers: combineHeaders(resolvedHeaders, headers ?? {}, this.getModelConfigHeaders(), await resolve9(this.config.o11yHeaders)),
+        headers: combineHeaders(resolvedHeaders, headers ?? {}, this.getModelConfigHeaders(), await resolve10(this.config.o11yHeaders)),
         body: {
           documents,
           query,
@@ -68862,7 +69172,7 @@ var import_oidc, import_oidc2, GATEWAY_REALTIME_SUBPROTOCOL = "ai-gateway-realti
     headers,
     abortSignal
   }) {
-    const resolvedHeaders = this.config.headers ? await resolve9(this.config.headers) : undefined;
+    const resolvedHeaders = this.config.headers ? await resolve10(this.config.headers) : undefined;
     try {
       const {
         responseHeaders,
@@ -68870,7 +69180,7 @@ var import_oidc, import_oidc2, GATEWAY_REALTIME_SUBPROTOCOL = "ai-gateway-realti
         rawValue
       } = await postJsonToApi({
         url: this.getUrl(),
-        headers: combineHeaders(resolvedHeaders, headers ?? {}, this.getModelConfigHeaders(), await resolve9(this.config.o11yHeaders)),
+        headers: combineHeaders(resolvedHeaders, headers ?? {}, this.getModelConfigHeaders(), await resolve10(this.config.o11yHeaders)),
         body: {
           text,
           ...voice && { voice },
@@ -68928,7 +69238,7 @@ var import_oidc, import_oidc2, GATEWAY_REALTIME_SUBPROTOCOL = "ai-gateway-realti
     headers,
     abortSignal
   }) {
-    const resolvedHeaders = this.config.headers ? await resolve9(this.config.headers) : undefined;
+    const resolvedHeaders = this.config.headers ? await resolve10(this.config.headers) : undefined;
     try {
       const {
         responseHeaders,
@@ -68936,7 +69246,7 @@ var import_oidc, import_oidc2, GATEWAY_REALTIME_SUBPROTOCOL = "ai-gateway-realti
         rawValue
       } = await postJsonToApi({
         url: this.getUrl(),
-        headers: combineHeaders(resolvedHeaders, headers ?? {}, this.getModelConfigHeaders(), await resolve9(this.config.o11yHeaders)),
+        headers: combineHeaders(resolvedHeaders, headers ?? {}, this.getModelConfigHeaders(), await resolve10(this.config.o11yHeaders)),
         body: {
           audio: audio instanceof Uint8Array ? convertUint8ArrayToBase64(audio) : audio,
           mediaType,
@@ -68970,7 +69280,7 @@ var import_oidc, import_oidc2, GATEWAY_REALTIME_SUBPROTOCOL = "ai-gateway-realti
   }
   async doStream(options) {
     const currentDate = this.config._internal?.currentDate?.() ?? /* @__PURE__ */ new Date;
-    const headers = combineHeaders(await resolve9(this.config.headers ?? {}), options.headers ?? {}, this.getModelConfigHeaders(), await resolve9(this.config.o11yHeaders));
+    const headers = combineHeaders(await resolve10(this.config.headers ?? {}), options.headers ?? {}, this.getModelConfigHeaders(), await resolve10(this.config.o11yHeaders));
     const authMethod = await parseAuthMethod(headers);
     const startFrame = {
       type: TRANSCRIPTION_STREAM_START_FRAME_TYPE,
@@ -69575,7 +69885,7 @@ Run 'npx vercel link' to link your project, then 'vc env pull' to fetch the toke
     async doGenerate(options) {
       const { args, warnings } = await this.getArgs(options);
       const { abortSignal } = options;
-      const resolvedHeaders = this.config.headers ? await resolve9(this.config.headers) : undefined;
+      const resolvedHeaders = this.config.headers ? await resolve10(this.config.headers) : undefined;
       try {
         const {
           responseHeaders,
@@ -69583,7 +69893,7 @@ Run 'npx vercel link' to link your project, then 'vc env pull' to fetch the toke
           rawValue: rawResponse
         } = await postJsonToApi({
           url: this.getUrl(),
-          headers: combineHeaders(resolvedHeaders, options.headers, this.getModelConfigHeaders(this.modelId, false), await resolve9(this.config.o11yHeaders)),
+          headers: combineHeaders(resolvedHeaders, options.headers, this.getModelConfigHeaders(this.modelId, false), await resolve10(this.config.o11yHeaders)),
           body: args,
           successfulResponseHandler: createJsonResponseHandler(z.any()),
           failedResponseHandler: createJsonErrorResponseHandler({
@@ -69606,11 +69916,11 @@ Run 'npx vercel link' to link your project, then 'vc env pull' to fetch the toke
     async doStream(options) {
       const { args, warnings } = await this.getArgs(options);
       const { abortSignal } = options;
-      const resolvedHeaders = this.config.headers ? await resolve9(this.config.headers) : undefined;
+      const resolvedHeaders = this.config.headers ? await resolve10(this.config.headers) : undefined;
       try {
         const { value: response, responseHeaders } = await postJsonToApi({
           url: this.getUrl(),
-          headers: combineHeaders(resolvedHeaders, options.headers, this.getModelConfigHeaders(this.modelId, true), await resolve9(this.config.o11yHeaders)),
+          headers: combineHeaders(resolvedHeaders, options.headers, this.getModelConfigHeaders(this.modelId, true), await resolve10(this.config.o11yHeaders)),
           body: args,
           successfulResponseHandler: createEventSourceResponseHandler(z.any()),
           failedResponseHandler: createJsonErrorResponseHandler({
@@ -69705,7 +70015,7 @@ Run 'npx vercel link' to link your project, then 'vc env pull' to fetch the toke
       abortSignal,
       providerOptions
     }) {
-      const resolvedHeaders = this.config.headers ? await resolve9(this.config.headers) : undefined;
+      const resolvedHeaders = this.config.headers ? await resolve10(this.config.headers) : undefined;
       try {
         const {
           responseHeaders,
@@ -69713,7 +70023,7 @@ Run 'npx vercel link' to link your project, then 'vc env pull' to fetch the toke
           rawValue
         } = await postJsonToApi({
           url: this.getUrl(),
-          headers: combineHeaders(resolvedHeaders, headers ?? {}, this.getModelConfigHeaders(), await resolve9(this.config.o11yHeaders)),
+          headers: combineHeaders(resolvedHeaders, headers ?? {}, this.getModelConfigHeaders(), await resolve10(this.config.o11yHeaders)),
           body: {
             values,
             ...providerOptions ? { providerOptions } : {}
@@ -69805,11 +70115,11 @@ Run 'npx vercel link' to link your project, then 'vc env pull' to fetch the toke
       headers,
       abortSignal
     }) {
-      const resolvedHeaders = this.config.headers ? await resolve9(this.config.headers) : undefined;
+      const resolvedHeaders = this.config.headers ? await resolve10(this.config.headers) : undefined;
       try {
         const { responseHeaders, value: responseBody } = await postJsonToApi({
           url: this.getUrl(),
-          headers: combineHeaders(resolvedHeaders, headers ?? {}, this.getModelConfigHeaders(), await resolve9(this.config.o11yHeaders)),
+          headers: combineHeaders(resolvedHeaders, headers ?? {}, this.getModelConfigHeaders(), await resolve10(this.config.o11yHeaders)),
           body: {
             prompt,
             n,
@@ -76995,12 +77305,12 @@ function normalizeStreamProviderError(error) {
   if (isError(error) || AISDKError.isInstance(error) || StreamProviderError.isInstance(error)) {
     return error;
   }
-  const outer = asRecord4(error);
+  const outer = asRecord5(error);
   if (outer == null) {
     return error;
   }
   const providerStreamError = isProviderStreamError(error);
-  const details = providerStreamError ? outer : asRecord4(asRecord4(outer.response)?.error) ?? asRecord4(outer.error) ?? outer;
+  const details = providerStreamError ? outer : asRecord5(asRecord5(outer.response)?.error) ?? asRecord5(outer.error) ?? outer;
   if (typeof details.message !== "string") {
     return error;
   }
@@ -77036,7 +77346,7 @@ function inferExactMessageMetadata(message) {
 function isRetryableStatusCode22(statusCode) {
   return statusCode != null && (statusCode === 408 || statusCode === 409 || statusCode === 429 || statusCode >= 500);
 }
-function asRecord4(value) {
+function asRecord5(value) {
   return typeof value === "object" && value != null ? value : undefined;
 }
 function isError(value) {
@@ -78044,7 +78354,7 @@ var __defProp2, __export2 = (target, all) => {
   const schema = asSchema(inputSchema);
   return {
     name: "object",
-    responseFormat: resolve9(schema.jsonSchema).then((jsonSchema3) => ({
+    responseFormat: resolve10(schema.jsonSchema).then((jsonSchema3) => ({
       type: "json",
       schema: jsonSchema3,
       ...name25 != null && { name: name25 },
@@ -78116,7 +78426,7 @@ var __defProp2, __export2 = (target, all) => {
   const elementSchema = asSchema(inputElementSchema);
   return {
     name: "array",
-    responseFormat: resolve9(elementSchema.jsonSchema).then((jsonSchema3) => {
+    responseFormat: resolve10(elementSchema.jsonSchema).then((jsonSchema3) => {
       const {
         $schema: _$schema,
         definitions,
@@ -81594,7 +81904,7 @@ function tokenCount(value) {
   }
   return;
 }
-function asRecord5(value) {
+function asRecord6(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value) ? value : undefined;
 }
 function providerErrorFields(body) {
@@ -81605,8 +81915,8 @@ function providerErrorFields(body) {
   } catch {
     return fields;
   }
-  const outer = asRecord5(parsed);
-  const error = asRecord5(outer?.error) ?? outer;
+  const outer = asRecord6(parsed);
+  const error = asRecord6(outer?.error) ?? outer;
   if (!error)
     return fields;
   for (const key of ["code", "param", "type"]) {
@@ -81617,7 +81927,7 @@ function providerErrorFields(body) {
   return fields;
 }
 function describeModelError(error) {
-  const record = asRecord5(error);
+  const record = asRecord6(error);
   if (record) {
     const parts = [];
     if (typeof record.message === "string" && record.message.length > 0)
@@ -82068,13 +82378,13 @@ function codexModelsRequest(access, accountId) {
     }
   };
 }
-function asRecord6(value) {
+function asRecord7(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value) ? value : undefined;
 }
 function toModel(value) {
   if (typeof value === "string" && value.length > 0)
     return { id: value };
-  const record = asRecord6(value);
+  const record = asRecord7(value);
   if (!record)
     return;
   const id = record.id ?? record.slug ?? record.name ?? record.model;
@@ -82084,7 +82394,7 @@ function toModel(value) {
   return { id, ...typeof name === "string" && name.length > 0 ? { name } : {} };
 }
 function normalizeModels(payload) {
-  const record = asRecord6(payload);
+  const record = asRecord7(payload);
   const candidates = Array.isArray(payload) ? payload : Array.isArray(record?.data) ? record.data : Array.isArray(record?.models) ? record.models : [];
   const seen = new Set;
   const models = [];
@@ -125360,7 +125670,7 @@ var init_model = __esm(() => {
 import { execFile } from "child_process";
 import { constants as constants2 } from "fs";
 import { lstat as lstat2, open as open3, opendir as opendir2, realpath as realpath3 } from "fs/promises";
-import { isAbsolute as isAbsolute5, join as join14, relative as relative5, resolve as resolve10, sep as sep3 } from "path";
+import { isAbsolute as isAbsolute5, join as join14, relative as relative5, resolve as resolve11, sep as sep3 } from "path";
 import { promisify } from "util";
 
 class WorkspaceReview {
@@ -125372,7 +125682,7 @@ class WorkspaceReview {
     if (typeof path !== "string" || path.length > REVIEW_LIMITS.path || path.includes("\x00") || isAbsolute5(path) || path.split(/[\\/]/).some((part) => part === ".." || part.includes(":")))
       throw new Error("Invalid workspace-relative path.");
     const root = await realpath3(this.root);
-    const candidate = resolve10(root, path || ".");
+    const candidate = resolve11(root, path || ".");
     const rel = relative5(root, candidate);
     if (isAbsolute5(rel) || rel === ".." || rel.startsWith(`..${sep3}`))
       throw new Error("Path is outside the workspace.");
@@ -125565,7 +125875,7 @@ import { randomUUID as randomUUID9 } from "crypto";
 import { existsSync as existsSync5, mkdirSync as mkdirSync12, readdirSync as readdirSync3, statSync as statSync6 } from "fs";
 import { readFile as readFile4 } from "fs/promises";
 import { homedir as homedir3 } from "os";
-import { basename as basename3, dirname as dirname11, extname, join as join15, relative as relative6, resolve as resolve11, sep as sep4 } from "path";
+import { basename as basename3, dirname as dirname11, extname, join as join15, relative as relative6, resolve as resolve12, sep as sep4 } from "path";
 function json3(data, status = 200) {
   return new Response(JSON.stringify(data), {
     status,
@@ -125613,9 +125923,9 @@ function startServer(options = {}) {
     throw new Error("Shared backends only support loopback hosts. Unset RINGKO_HOST or use 127.0.0.1.");
   const configuredPort = Number(process.env.RINGKO_PORT);
   const port = options.port ?? (Number.isInteger(configuredPort) && configuredPort > 0 ? configuredPort : DEFAULT_PORT);
-  let workspace = resolve11(options.workspace ?? process.cwd());
-  const bundledWebuiDir = resolve11(import.meta.dir, "../webui");
-  const webuiDir = resolve11(options.webuiDir ?? process.env.RINGKO_WEBUI_DIR ?? (existsSync5(join15(DEFAULT_WEBUI_DIR, "index.html")) ? DEFAULT_WEBUI_DIR : existsSync5(join15(bundledWebuiDir, "index.html")) ? bundledWebuiDir : join15(dirname11(process.execPath), "webui")));
+  let workspace = resolve12(options.workspace ?? process.cwd());
+  const bundledWebuiDir = resolve12(import.meta.dir, "../webui");
+  const webuiDir = resolve12(options.webuiDir ?? process.env.RINGKO_WEBUI_DIR ?? (existsSync5(join15(DEFAULT_WEBUI_DIR, "index.html")) ? DEFAULT_WEBUI_DIR : existsSync5(join15(bundledWebuiDir, "index.html")) ? bundledWebuiDir : join15(dirname11(process.execPath), "webui")));
   let store = new SessionStore({ cwd: workspace });
   const approvals = new Map;
   const questions = new Map;
@@ -125657,7 +125967,7 @@ function startServer(options = {}) {
   if (activeProject && !options.shared && !options.workspace) {
     try {
       if (statSync6(activeProject.path).isDirectory())
-        workspace = resolve11(activeProject.path);
+        workspace = resolve12(activeProject.path);
     } catch {}
   }
   store = new SessionStore({ cwd: workspace });
@@ -125669,14 +125979,14 @@ function startServer(options = {}) {
     projects = id ? { projects: projects.projects, current: id } : { projects: projects.projects };
     saveProjects(projects);
     const active = id ? projects.projects.find((entry) => entry.id === id) : undefined;
-    workspace = active ? resolve11(active.path) : baseWorkspace;
+    workspace = active ? resolve12(active.path) : baseWorkspace;
     store = new SessionStore({ cwd: workspace });
     resetMcp();
     sync.publish("workspace");
   }
   const runtimes = new Map;
   function runtimeFor(cwd) {
-    const path = resolve11(cwd);
+    const path = resolve12(cwd);
     let runtime = runtimes.get(path);
     if (!runtime) {
       runtime = new RuntimeManager(path, eventLog);
@@ -125758,14 +126068,14 @@ function startServer(options = {}) {
     const raw = typeof body?.path === "string" ? body.path.trim() : "";
     if (raw.length === 0)
       return json3({ error: "path is required." }, 400);
-    const target = resolve11(raw);
+    const target = resolve12(raw);
     try {
       if (!statSync6(target).isDirectory())
         return json3({ error: "path is not a directory." }, 400);
     } catch {
       return json3({ error: "path does not exist." }, 400);
     }
-    const existing = projects.projects.find((entry) => resolve11(entry.path) === target);
+    const existing = projects.projects.find((entry) => resolve12(entry.path) === target);
     if (!existing) {
       const id = `proj-${randomUUID9().slice(0, 8)}`;
       const name = typeof body?.name === "string" && body.name.trim().length > 0 ? body.name.trim() : basename3(target);
@@ -125781,7 +126091,7 @@ function startServer(options = {}) {
   const LIST_LIMIT = 2000;
   function crumbsFor(target) {
     const crumbs = [];
-    let current = resolve11(target);
+    let current = resolve12(target);
     for (;; ) {
       const parent = dirname11(current);
       crumbs.unshift({ name: basename3(current) || current, path: current });
@@ -125794,7 +126104,7 @@ function startServer(options = {}) {
   function handleListDirectory(url) {
     const home = homedir3();
     const requested = url.searchParams.get("path");
-    const target = requested && requested.trim().length > 0 ? resolve11(requested) : home;
+    const target = requested && requested.trim().length > 0 ? resolve12(requested) : home;
     let dirents;
     try {
       dirents = readdirSync3(target, { withFileTypes: true });
@@ -125821,7 +126131,7 @@ function startServer(options = {}) {
     if (name.trim().length === 0 || name.includes("/") || name.includes("\\")) {
       return json3({ error: "name must be a single folder name." }, 400);
     }
-    const target = join15(resolve11(parent), name);
+    const target = join15(resolve12(parent), name);
     try {
       mkdirSync12(target, { recursive: false });
     } catch (error) {
@@ -126675,7 +126985,7 @@ Attached files (read them if relevant): ${attachments.join(", ")}` : raw;
         if (activeRuns.has(body.sessionId))
           return json3({ error: "This session already has an active run. Queue the message until it finishes." }, 409);
         const existing = runStore.open(body.sessionId, "read");
-        if (existing.header.cwd && resolve11(existing.header.cwd) !== runWorkspace)
+        if (existing.header.cwd && resolve12(existing.header.cwd) !== runWorkspace)
           return json3({ error: "Session belongs to a different workspace." }, 409);
         history = toChatMessages(existing.all());
         session = runStore.open(body.sessionId, "write");
@@ -126915,7 +127225,7 @@ Attached files (read them if relevant): ${attachments.join(", ")}` : raw;
   }
   async function serveStatic(pathname) {
     const rel = pathname === "/" ? "index.html" : pathname.replace(/^\/+/, "");
-    const target = resolve11(join15(webuiDir, rel));
+    const target = resolve12(join15(webuiDir, rel));
     const withinRoot = relative6(webuiDir, target);
     if (withinRoot.startsWith("..") || withinRoot.includes(".."))
       return json3({ error: "not found" }, 404);
@@ -127185,7 +127495,7 @@ Attached files (read them if relevant): ${attachments.join(", ")}` : raw;
         const expectedWorkspace = request.headers.get("x-ringko-workspace");
         if (expectedWorkspace) {
           try {
-            if (resolve11(decodeURIComponent(expectedWorkspace)) !== workspace)
+            if (resolve12(decodeURIComponent(expectedWorkspace)) !== workspace)
               return json3({ error: "Backend workspace changed. Reconnect to the correct workspace." }, 409);
           } catch {
             return json3({ error: "Invalid workspace header." }, 400);
@@ -127200,7 +127510,7 @@ Attached files (read them if relevant): ${attachments.join(", ")}` : raw;
           }
         }
         if (url.pathname === "/api/backend" && request.method === "GET")
-          return json3({ protocol: PROTOCOL_VERSION2, instance: sync.instance, workspace, configPath: options.configPath ? resolve11(options.configPath) : null });
+          return json3({ protocol: PROTOCOL_VERSION2, instance: sync.instance, workspace, configPath: options.configPath ? resolve12(options.configPath) : null });
         if (url.pathname === "/api/backend/stop" && request.method === "POST") {
           if (activeRuns.size)
             return json3({ error: "Stop active sessions before stopping the backend." }, 409);
@@ -127343,7 +127653,7 @@ Attached files (read them if relevant): ${attachments.join(", ")}` : raw;
           if (options.shared) {
             try {
               const existing = store.open(id, "read");
-              if (existing.header.cwd && resolve11(existing.header.cwd) !== workspace)
+              if (existing.header.cwd && resolve12(existing.header.cwd) !== workspace)
                 return json3({ error: "Session belongs to a different workspace." }, 409);
             } catch {
               return json3({ error: "Unknown session." }, 404);
@@ -127503,7 +127813,7 @@ var init_server = __esm(() => {
   init_src9();
   init_sync();
   init_runs();
-  DEFAULT_WEBUI_DIR = resolve11(import.meta.dir, "../../webui/dist");
+  DEFAULT_WEBUI_DIR = resolve12(import.meta.dir, "../../webui/dist");
   APPROVAL_TIMEOUT_MS = 5 * 60 * 1000;
   TERMINAL_SESSION_TTL_MS = 30 * 60 * 1000;
   MIME = {
@@ -127531,10 +127841,9 @@ var init_src15 = __esm(() => {
 init_src5();
 
 // packages/tui/src/cli-identity.ts
-var NPM_CLI_COMMAND = "rkh";
-function cliCommand(entry = process.argv[1]) {
-  const name = (entry ?? "").replace(/\\/g, "/").split("/").pop()?.replace(/\.(mjs|cmd|exe)$/, "");
-  return name === NPM_CLI_COMMAND ? NPM_CLI_COMMAND : "ringko";
+var CLI_COMMAND = "ringko";
+function cliCommand(_entry = process.argv[1]) {
+  return CLI_COMMAND;
 }
 
 // packages/tui/src/resume-hint.ts
@@ -127550,26 +127859,26 @@ ${source} tui --session ${quote(sessionId, windows)} --workspace ${quote(workspa
 
 // packages/tui/src/cli.ts
 init_runtime();
-import { resolve as resolve12 } from "path";
+import { resolve as resolve13 } from "path";
 
 // packages/tui/src/backend.ts
 init_src10();
 import { spawn as spawn2 } from "child_process";
-import { resolve as resolve8 } from "path";
+import { resolve as resolve9 } from "path";
 
 // packages/client/src/local.ts
 import { createHash as createHash3 } from "crypto";
 import { realpathSync as realpathSync2 } from "fs";
-import { resolve as resolve7 } from "path";
+import { resolve as resolve8 } from "path";
 var SERVICE_PORT_BASE = 22000;
 var SERVICE_PORT_RANGE = 20000;
 function canonicalWorkspace(workspace) {
-  return realpathSync2(resolve7(workspace));
+  return realpathSync2(resolve8(workspace));
 }
 function sharedPort(workspace, configPath) {
   const path = canonicalWorkspace(workspace);
   const normalized = process.platform === "win32" ? path.toLowerCase() : path;
-  const config = configPath ? resolve7(configPath) : "";
+  const config = configPath ? resolve8(configPath) : "";
   const key = `${normalized}\x00${process.platform === "win32" ? config.toLowerCase() : config}`;
   return SERVICE_PORT_BASE + createHash3("sha256").update(key).digest().readUInt32BE(0) % SERVICE_PORT_RANGE;
 }
@@ -127580,7 +127889,7 @@ var PROBE_TIMEOUT_MS = 1000;
 var RETRY_MS = 200;
 async function connectBackend(options) {
   const workspace = canonicalWorkspace(options.workspace);
-  const configPath = options.configPath ? resolve8(options.configPath) : undefined;
+  const configPath = options.configPath ? resolve9(options.configPath) : undefined;
   const token = process.env.RINGKO_WEB_TOKEN?.trim();
   const explicit = options.url ?? process.env.RINGKO_SERVER;
   const port = sharedPort(workspace, configPath);
@@ -127600,7 +127909,7 @@ async function connectBackend(options) {
         throw error;
       return false;
     }
-    if (identity.protocol !== PROTOCOL_VERSION2 || resolve8(identity.workspace) !== workspace || (identity.configPath ?? undefined) !== configPath) {
+    if (identity.protocol !== PROTOCOL_VERSION2 || resolve9(identity.workspace) !== workspace || (identity.configPath ?? undefined) !== configPath) {
       throw new Error("This port belongs to a different backend/workspace/configuration. Use --server with the correct local backend address.");
     }
     return true;
@@ -127617,7 +127926,7 @@ async function connectBackend(options) {
     const executable = process.execPath;
     const script = process.argv[1];
     const compiled = script?.includes("$bunfs") || script?.includes("~BUN") || script === executable;
-    const args = [...!compiled && script ? [resolve8(script)] : [], "serve", "--shared", "--port", String(port), "--workspace", workspace, ...configPath ? ["--config", configPath] : []];
+    const args = [...!compiled && script ? [resolve9(script)] : [], "serve", "--shared", "--port", String(port), "--workspace", workspace, ...configPath ? ["--config", configPath] : []];
     const child = spawn2(executable, args, { cwd: workspace, env: process.env, detached: true, stdio: "ignore", windowsHide: true });
     const spawned = new Promise((ready, reject) => {
       child.once("spawn", ready);
@@ -127643,7 +127952,7 @@ init_src3();
 // packages/tui/src/provider.ts
 init_loader();
 // packages/tui/package.json
-var version2 = "0.2.0";
+var version2 = "0.2.1-rc";
 
 // packages/tui/src/cli.ts
 var VERSION8 = version2;
@@ -127693,7 +128002,7 @@ Options:
   --completion-promise <text>  (loop) Stop when a reply contains <promise>text</promise>
 
 Providers are introduced through configuration; the config names a provider
-module that is imported at run time. See docs/PROVIDERS.md.
+module that is imported at run time.
 `;
 function denyApprovals(io) {
   return async (request) => {
@@ -127952,7 +128261,7 @@ async function tuiCommand(parsed, io) {
     ...info.modelId ? { modelId: info.modelId } : {}
   });
   if (sessionId && (await backend.sessions()).some((session) => session.id === sessionId)) {
-    io.out(resumeHint(sessionId, resolve12(workspace), process.argv[1]));
+    io.out(resumeHint(sessionId, resolve13(workspace), process.argv[1]));
   }
   return 0;
 }
@@ -127960,7 +128269,7 @@ async function serveCommand(parsed, io) {
   await Promise.resolve().then(() => init_src15());
   let server;
   try {
-    server = startServer({ workspace: resolve12(parsed.workspace ?? process.cwd()), port: parsed.port, configPath: parsed.config, shared: parsed.shared, authToken: process.env.RINGKO_WEB_TOKEN?.trim() });
+    server = startServer({ workspace: resolve13(parsed.workspace ?? process.cwd()), port: parsed.port, configPath: parsed.config, shared: parsed.shared, authToken: process.env.RINGKO_WEB_TOKEN?.trim() });
   } catch (error) {
     io.err(error instanceof Error ? error.message : "Backend startup failed.");
     return 1;

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@ringko-ai/rkh",
-  "version": "0.2.0",
+  "version": "0.2.1-rc",
   "description": "RingKo interactive agent CLI",
   "type": "module",
   "license": "Apache-2.0",
   "bin": {
-    "rkh": "bin/rkh.mjs"
+    "ringko": "bin/ringko.mjs"
   },
   "engines": {
     "node": ">=24",