@robota-sdk/agent-ui-terminal 3.0.0-beta.85 → 3.0.0-beta.87

package/src/__tests__/tui-channel-init-failure.test.ts

@@ -37,7 +37,7 @@ vi.mock('@robota-sdk/agent-framework', async (importOriginal) => {
 import { TuiInteractionChannel } from '../TuiInteractionChannel.js';
 
 /** The session's working directory: private to this run, never a fixed name under /tmp. */
-const PROJECT_DIR = mkdtempSync(join(tmpdir(), 'robota-tui-init-failure-'));
+const PROJECT_DIR = mkdtempSync(join(tmpdir(), 'agent-test-tui-init-failure-'));
 afterAll(() => rmSync(PROJECT_DIR, { recursive: true, force: true }));
 
 describe('TuiInteractionChannel init failure surfacing', () => {

package/src/__tests__/tui-state-manager.test.ts

@@ -346,7 +346,7 @@ describe('TuiStateManager', () => {
     expect(mgr.executionWorkspaceSnapshot?.selectedEntryId).toBe('task:agent_1');
   });
 
-  // ── Display order: Tool → Robota ──────────────────────────────
+  // ── Display order: Tool → Fixture Agent ──────────────────────────────
 
   it('streaming state is cleared on complete (tools moved to messages)', () => {
     const mgr = new TuiStateManager();
@@ -432,7 +432,7 @@ describe('TuiStateManager', () => {
     expect(mgr.history[2]!.type).toBe('assistant');
   });
 
-  it('after abort: streaming cleared, messages synced with tool → robota → system', () => {
+  it('after abort: streaming cleared, messages synced with tool → agent → system', () => {
     const mgr = new TuiStateManager();
 
     mgr.onThinking(true);

package/src/__tests__/wire-tui-channel.test.ts

@@ -327,13 +327,13 @@ describe('WireTuiChannel', () => {
     });
     const pending = channel.getSnapshot().pendingUserAction;
     expect(pending).toMatchObject({ title: 'Name?' });
-    channel.resolveUserAction(pending!, { type: 'answer', values: [], text: 'Robota' });
+    channel.resolveUserAction(pending!, { type: 'answer', values: [], text: 'Fixture Agent' });
     await flush();
     expect(link.sent).toEqual([
       {
         type: 'ask-response',
         id: 'a1',
-        response: { type: 'answer', values: [], text: 'Robota' },
+        response: { type: 'answer', values: [], text: 'Fixture Agent' },
       },
     ]);
     await channel.stop();

package/src/keybindings/__tests__/keybinding-registry.test.ts

@@ -11,7 +11,7 @@ import {
   resolveKeybindingInput,
 } from '../keybinding-registry.js';
 
-const SOURCE = '/tmp/robota-keybindings.json';
+const SOURCE = '/tmp/agent-test-keybindings.json';
 
 function parse(document: unknown) {
   return parseKeybindingsDocument(JSON.stringify(document), SOURCE);
@@ -217,7 +217,7 @@ describe('contextual keybinding registry', () => {
       $defs: Record<string, { properties?: Record<string, unknown> }>;
     };
 
-    expect(schema.$id).toBe('https://docs.robota.io/schemas/keybindings.schema.json');
+    expect(schema.$id).toBe('https://docs.robota.io//schemas/keybindings.schema.json');
     expect(Object.keys(schema.properties.bindings.properties)).toEqual(
       Object.keys(KEYBINDING_ACTIONS),
     );

package/src/keybindings/__tests__/node-keybindings-source.test.ts

@@ -11,7 +11,7 @@ import {
 const roots: string[] = [];
 
 async function temporaryRoot(): Promise<string> {
-  const root = await mkdtemp(join(tmpdir(), 'robota-keybindings-'));
+  const root = await mkdtemp(join(tmpdir(), 'agent-test-keybindings-'));
   roots.push(root);
   return root;
 }
@@ -34,6 +34,13 @@ afterEach(async () => {
 });
 
 describe('Node keybindings source', () => {
+  it('omits the schema when the host has no documentation URL', async () => {
+    const root = await temporaryRoot();
+    const source = createNodeKeybindingsSource({ filePath: join(root, 'keys.json') });
+    expect(JSON.parse(await readFile(await source.ensureFile(), 'utf8'))).toEqual({ version: 1, bindings: {} });
+    source.dispose();
+  });
+
   it('uses only the host-selected file and schema when creating the sparse document', async () => {
     const root = await temporaryRoot();
     const filePath = join(root, 'host-config', 'keys.json');

package/src/keybindings/node-keybindings-source.ts

@@ -25,15 +25,15 @@ export interface IKeybindingsSource extends IKeybindingsFilePort {
 
 export interface INodeKeybindingsSourceOptions {
   readonly filePath: string;
-  readonly schemaUrl: string;
+  readonly schemaUrl?: string;
   readonly onDiagnostic?: (diagnostic: IKeybindingDiagnostic) => void;
 }
 
-function defaultDocument(schemaUrl: string) {
-  return { $schema: schemaUrl, version: 1 as const, bindings: {} };
+function defaultDocument(schemaUrl: string | undefined) {
+  return { ...(schemaUrl === undefined ? {} : { $schema: schemaUrl }), version: 1 as const, bindings: {} };
 }
 
-function defaultSnapshot(filePath: string, schemaUrl: string): IKeybindingSnapshot {
+function defaultSnapshot(filePath: string, schemaUrl: string | undefined): IKeybindingSnapshot {
   const parsed = parseKeybindingsDocument(JSON.stringify(defaultDocument(schemaUrl)), filePath);
   if (!parsed.ok) throw new Error(parsed.diagnostic.message);
   return parsed.snapshot;
@@ -41,7 +41,7 @@ function defaultSnapshot(filePath: string, schemaUrl: string): IKeybindingSnapsh
 
 class NodeKeybindingsSource implements IKeybindingsSource {
   readonly filePath: string;
-  readonly #schemaUrl: string;
+  readonly #schemaUrl: string | undefined;
   readonly #onDiagnostic: ((diagnostic: IKeybindingDiagnostic) => void) | undefined;
   readonly #listeners = new Set<(snapshot: IKeybindingSnapshot) => void>();
   #snapshot: IKeybindingSnapshot;
@@ -52,7 +52,7 @@ class NodeKeybindingsSource implements IKeybindingsSource {
 
   constructor(options: INodeKeybindingsSourceOptions) {
     if (options.filePath.trim() === '') throw new Error('Keybindings file path must not be empty.');
-    if (options.schemaUrl.trim() === '') throw new Error('Keybindings schema URL must not be empty.');
+    if (options.schemaUrl?.trim() === '') throw new Error('Keybindings schema URL must not be empty.');
     this.filePath = options.filePath;
     this.#schemaUrl = options.schemaUrl;
     this.#onDiagnostic = options.onDiagnostic;

package/src/render.tsx

@@ -101,9 +101,10 @@ export interface IRenderOptions {
   contributionSources?: readonly IContributionSource[];
   skillRoots?: readonly ISkillRootDescriptor[];
   userSettingsSources?: readonly INodeHostSettingsSource[];
+  environment?: Readonly<Record<string, string | undefined>>;
   /**
    * CLI-083 (issue #2287) — the org policy, forwarded to the session so `blockedCommands` is
-   * enforced on the plain `robota` path as well as under `--serve`.
+   * enforced on the direct CLI path as well as under `--serve`.
    *
    * DECLARED, not merely spread through. The shell forwards this with
    * `...(orgPolicy === null ? {} : { orgPolicy })`, and a spread bypasses TypeScript's
@@ -186,6 +187,7 @@ export interface IRenderOptions {
   defaultTools?: readonly IToolWithEventService[];
   /** The sandbox the shell tools run under, so the session can let a confined command skip the prompt. */
   sandboxClient?: ICreateSessionOptions['sandboxClient'];
+  toolExecutionPolicy?: ICreateSessionOptions['toolExecutionPolicy'];
   commandModules?: readonly ICommandModule[];
   commandHostAdapters?: ICommandHostAdapters;
   shellExec?: TShellExecFn;
@@ -305,6 +307,7 @@ export function toChannelOptions(
     ...(options.userSettingsSources !== undefined
       ? { userSettingsSources: options.userSettingsSources }
       : {}),
+    ...(options.environment !== undefined ? { environment: options.environment } : {}),
     ...(options.orgPolicy !== undefined ? { orgPolicy: options.orgPolicy } : {}),
     ...(options.externalEventVerifierFactory !== undefined
       ? { externalEventVerifierFactory: options.externalEventVerifierFactory }
@@ -351,6 +354,9 @@ export function toChannelOptions(
       : {}),
     ...(options.additionalTools !== undefined ? { additionalTools: options.additionalTools } : {}),
     ...(options.defaultTools !== undefined ? { defaultTools: options.defaultTools } : {}),
+    ...(options.toolExecutionPolicy !== undefined
+      ? { toolExecutionPolicy: options.toolExecutionPolicy }
+      : {}),
     ...(options.sandboxClient !== undefined ? { sandboxClient: options.sandboxClient } : {}),
     commandModules: options.commandModules,
     commandHostAdapters: options.commandHostAdapters,

package/src/terminal-capabilities.ts

@@ -41,7 +41,7 @@ export function supportsImeCursorPositioning(
  * CLI-2004 — may this process write OSC 133 shell-integration marks at agent-turn boundaries?
  *
  * The marks are otherwise harmless: every emulator surveyed discards an unknown OSC sequence, so
- * this gate carries DOCUMENTED negatives, not a capability probe. Robota's support table (the TUI
+ * this gate carries DOCUMENTED negatives, not a capability probe. The support table (the TUI
  * package's docs/SPEC.md) is the user-facing half of the same list.
  *
  * Precedence:

package/src/tui-channel-options.ts

@@ -80,6 +80,7 @@ export interface ITuiInteractionChannelOptions {
   contributionSources?: ICreateSessionOptions['contributionSources'];
   skillRoots?: ICreateSessionOptions['skillRoots'];
   userSettingsSources?: readonly INodeHostSettingsSource[];
+  environment?: Readonly<Record<string, string | undefined>>;
   /**
    * Explicit authority- and permission-backed edit checkpoint capability for this channel's one
    * session. Never shared with another channel's session: a store holds one turn in progress.
@@ -131,6 +132,7 @@ export interface ITuiInteractionChannelOptions {
   defaultTools?: readonly IToolWithEventService[];
   /** The sandbox the shell tools run under, so the session can let a confined command skip the prompt. */
   sandboxClient?: ICreateSessionOptions['sandboxClient'];
+  toolExecutionPolicy?: ICreateSessionOptions['toolExecutionPolicy'];
   commandModules?: readonly ICommandModule[];
   commandHostAdapters?: ICommandHostAdapters;
   shellExec?: TShellExecFn;

package/src/tui-session-options.ts

@@ -52,6 +52,7 @@ export function buildTuiSessionOptions(
     ...(opts.userSettingsSources !== undefined
       ? { userSettingsSources: opts.userSettingsSources }
       : {}),
+    ...(opts.environment !== undefined ? { environment: opts.environment } : {}),
     ...(opts.editCheckpointStore !== undefined
       ? { editCheckpointStore: opts.editCheckpointStore }
       : {}),
@@ -98,6 +99,9 @@ export function buildTuiSessionOptions(
     ...(opts.pluginDirectories !== undefined ? { pluginDirectories: opts.pluginDirectories } : {}),
     ...(opts.additionalTools !== undefined ? { additionalTools: opts.additionalTools } : {}),
     ...(opts.defaultTools !== undefined ? { defaultTools: opts.defaultTools } : {}),
+    ...(opts.toolExecutionPolicy !== undefined
+      ? { toolExecutionPolicy: opts.toolExecutionPolicy }
+      : {}),
     ...(opts.sandboxClient !== undefined ? { sandboxClient: opts.sandboxClient } : {}),
     commandModules: opts.commandModules,
     commandHostAdapters: opts.commandHostAdapters,

package/src/utils/__tests__/tool-call-extractor.test.ts

@@ -65,7 +65,7 @@ describe('extractToolCalls', () => {
 
   it('truncates long argument values with middle ellipsis', () => {
     const longPath =
-      '/Users/jungyoun/Documents/dev/robota/packages/agent-sdk/src/plugins/very-long-directory-name/file.ts';
+      '/Users/example/robota/workspace/packages/agent-sdk/src/plugins/very-long-directory-name/file.ts';
     const history = [
       {
         role: 'assistant',