@aragon-agent/cli 0.6.3 → 0.6.7

package/dist/tools/proc-tools.d.ts

@@ -0,0 +1,25 @@
+/**
+ * `bash_output` and `bash_kill` — the model's two handles on a supervised
+ * service (background-service-supervision §5.1).
+ *
+ * REGISTERED THROUGH A FACTORY OPTION, NEVER APPENDED AFTER THE FACT
+ * (`tools/index.ts::procTools`). `tools.test.ts::C7` asserts `HOST_TOOL_NAMES`
+ * equals what `createBuiltinTools` PRODUCES, so appending these in
+ * `AgentController` after the factory returned would turn that test red with a
+ * message about two lists of names that says nothing about background services —
+ * the trap `teamTools` and `todoTools` each record in capitals.
+ *
+ * NEITHER JOINS `MUTATING_TOOLS` (P2-5). `bash_output` is a read. `bash_kill`
+ * stops something THIS SESSION STARTED and is showing on screen, and the plan
+ * gate already refuses it in plan mode; putting a `--confirm` modal between the
+ * user and stopping their own runaway server is the wrong trade. `bash` itself
+ * stays in `MUTATING_TOOLS` unchanged, including when `background: true` — the
+ * command is still arbitrary.
+ */
+import { type AgentTool } from '@aragon-agent/core';
+import type { ProcSupervisorPort } from '../proc/types.js';
+export interface ProcToolDeps {
+    supervisor: ProcSupervisorPort;
+}
+export declare function makeBashOutput(deps: ProcToolDeps): AgentTool;
+export declare function makeBashKill(deps: ProcToolDeps): AgentTool;

package/dist/tools/proc-tools.js

@@ -0,0 +1,102 @@
+/**
+ * `bash_output` and `bash_kill` — the model's two handles on a supervised
+ * service (background-service-supervision §5.1).
+ *
+ * REGISTERED THROUGH A FACTORY OPTION, NEVER APPENDED AFTER THE FACT
+ * (`tools/index.ts::procTools`). `tools.test.ts::C7` asserts `HOST_TOOL_NAMES`
+ * equals what `createBuiltinTools` PRODUCES, so appending these in
+ * `AgentController` after the factory returned would turn that test red with a
+ * message about two lists of names that says nothing about background services —
+ * the trap `teamTools` and `todoTools` each record in capitals.
+ *
+ * NEITHER JOINS `MUTATING_TOOLS` (P2-5). `bash_output` is a read. `bash_kill`
+ * stops something THIS SESSION STARTED and is showing on screen, and the plan
+ * gate already refuses it in plan mode; putting a `--confirm` modal between the
+ * user and stopping their own runaway server is the wrong trade. `bash` itself
+ * stays in `MUTATING_TOOLS` unchanged, including when `background: true` — the
+ * command is still arbitrary.
+ */
+import { defineTool, errorResult, textResult } from '@aragon-agent/core';
+import { PROC_LIMITS } from '../proc/limits.js';
+/** One line of status, shared by both tools so the two can never disagree. */
+function statusLine(service) {
+    const bits = [`service ${service.id}  ${service.status}`];
+    if (service.url)
+        bits.push(service.url);
+    if (service.exitCode !== null)
+        bits.push(`exit code ${service.exitCode}`);
+    else if (service.signal)
+        bits.push(`signal ${service.signal}`);
+    if (service.killIncomplete)
+        bits.push('(may have left a detached child)');
+    return `${bits.join('  ')}\n$ ${service.command}`;
+}
+export function makeBashOutput(deps) {
+    return defineTool({
+        name: 'bash_output',
+        label: 'Service log',
+        description: 'Read a background service log tail and its current status. Pass the ' +
+            '`since` cursor returned by a previous call to read only what is new. ' +
+            'Use this to verify a service actually started, and to read a build or ' +
+            'test watcher as it runs.',
+        parameters: {
+            type: 'object',
+            properties: {
+                service: { type: 'string', description: 'The service id, e.g. "s1".' },
+                since: {
+                    type: 'number',
+                    description: 'Cursor from a previous call; omit to read the whole tail.',
+                },
+            },
+            required: ['service'],
+        },
+        async execute(_id, rawParams) {
+            const params = rawParams;
+            const service = deps.supervisor.get(params.service);
+            if (!service) {
+                return errorResult(`No service "${params.service}". Start one with bash({ command, background: true }).`);
+            }
+            const page = deps.supervisor.read(params.service, params.since);
+            const lines = [statusLine(service)];
+            if (page?.truncated) {
+                lines.push(`[note] older rows were dropped - the tail keeps the last ` +
+                    `${PROC_LIMITS.serviceTailRows} rows.`);
+            }
+            if (!page || page.rows.length === 0) {
+                lines.push('(no new output)');
+            }
+            else {
+                lines.push(...page.rows);
+            }
+            lines.push(`[cursor ${page?.cursor ?? service.rowsSeen}]`);
+            return textResult(lines.join('\n'));
+        },
+    });
+}
+export function makeBashKill(deps) {
+    return defineTool({
+        name: 'bash_kill',
+        label: 'Stop service',
+        description: 'Stop a background service by id, or every service with "all". Stop the ' +
+            'services you started once you are finished with them, unless the user ' +
+            'asked for them to stay up.',
+        parameters: {
+            type: 'object',
+            properties: {
+                service: { type: 'string', description: 'The service id, or "all".' },
+            },
+            required: ['service'],
+        },
+        async execute(_id, rawParams) {
+            const params = rawParams;
+            if (params.service !== 'all' && !deps.supervisor.get(params.service)) {
+                return errorResult(`No service "${params.service}".`);
+            }
+            const stopped = await deps.supervisor.stop(params.service);
+            if (stopped.length === 0)
+                return textResult('Nothing to stop.');
+            const lines = stopped.map((s) => statusLine(s));
+            return textResult(`Stopped ${stopped.length} service${stopped.length === 1 ? '' : 's'}.\n${lines.join('\n')}`);
+        },
+    });
+}

package/dist/ui/App.d.ts

@@ -10,7 +10,8 @@ import type { ConfirmRequest } from '../tools/index.js';
 import { type Overlay, type ToastLevel } from '../agent/reducer.js';
 import type { UpdateBridge } from '../update/types.js';
 import { type RenderMode } from './layout/frame.js';
-import type { MouseSource } from '../input/stdin-mouse-filter.js';
+import type { MouseSource } from '../input/stdin-filter.js';
+import type { PasteBridge } from '../input/limits.js';
 import type { SelectionBridge } from './selection/selection-controller.js';
 import type { HumanInputBridge } from '../tools/human-input.js';
 export interface ConfirmBridge {
@@ -73,6 +74,18 @@ export interface AppProps {
      * 'off'`, on a non-TTY, in CI, and in every test that does not exercise it.
      */
     updateBridge?: UpdateBridge;
+    /**
+     * The stdin filter's channel for a refused paste (tui-paste-handling section
+     * 5.1.2 / I-15).
+     *
+     * A BRIDGE for the reason `updateBridge` above is one: the filter is built in
+     * `cli.tsx` BEFORE `render()`, so it has no `dispatch`. Its only other outlet
+     * is the logger, and a limit that writes only to a log file is
+     * indistinguishable — from the user's chair — from a paste that silently did
+     * nothing, which is what D-11 exists to rule out. Absent under `--no-paste`,
+     * on a non-TTY, and in every test that does not exercise it.
+     */
+    pasteBridge?: PasteBridge;
     /**
      * The terminal-facing services `cli.tsx` owns and this component cannot build
      * (tui-selection-and-scroll-follow §4.4).
@@ -120,4 +133,4 @@ export interface TerminalBridge {
     writeForeign?: (text: string) => void;
     selection?: SelectionBridge;
 }
-export declare function App({ controller, version, mode, initialOverlay, initialPrompt, confirmBridge, humanInputBridge, mouseSource, vtInputWarning, updateBridge, terminal, }: AppProps): React.ReactElement;
+export declare function App({ controller, version, mode, initialOverlay, initialPrompt, confirmBridge, humanInputBridge, mouseSource, vtInputWarning, updateBridge, pasteBridge, terminal, }: AppProps): React.ReactElement;