@hypercli.com/cli 0.0.0-stage → 0.9.2

package/README.md

@@ -1,3 +1,26 @@
-# Temporary Holding Version
+# Agent chat setup
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+```sh
+hyper agents chat <agent> 'Use the MCP tools' --cwd /workspace/project --mcp-servers servers.json
+hyper agents chat <agent> 'Continue' --session <session-id> --cwd /workspace/project --mcp-servers servers.json
+cat servers.json | hyper agents chat <agent> 'Use the MCP tools' --mcp-servers -
+```
+
+`--cwd` is the working directory on the agent, passed unchanged to ACP session
+setup. `--mcp-servers` reads a local UTF-8 JSON file (or `-` for stdin). Both
+options apply to new sessions and `--session` resume. Omitted options use the
+SDK defaults. Supply the desired MCP setup again when resuming.
+
+The file is a vanilla ACP v1 MCP server array, for example:
+
+```json
+[
+  {"name":"local-tools","command":"/opt/tools/mcp-server","args":[],"env":[]},
+  {"type":"http","name":"http-tools","url":"https://tools.example/mcp","headers":[]},
+  {"type":"sse","name":"sse-tools","url":"https://tools.example/sse","headers":[]}
+]
+```
+
+Stdio entries have no `type` field. Environment entries and headers use
+`{"name":"KEY","value":"VALUE"}` pairs. An empty array is valid. The CLI checks
+JSON shape; the peer decides which transports and setup it supports.

package/dist/commands/acp.d.ts

@@ -0,0 +1,5 @@
+import type { CommandContext } from '../core/types.js';
+export declare const name = "acp";
+export declare const summary = "Publish files through the local Hyper-ACP host";
+export declare const usage: string[];
+export declare function run(ctx: CommandContext, args: string[]): Promise<number | void>;

package/dist/commands/acp.js

@@ -0,0 +1,51 @@
+import { resolve } from 'node:path';
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { parseCommandArgs } from '../core/argv.js';
+import { CliError, UsageError } from '../core/errors.js';
+import { APP_VERSION } from '../version.js';
+export const name = 'acp';
+export const summary = 'Publish files through the local Hyper-ACP host';
+export const usage = ['hyper acp attach --file PATH [--session-id UUID]'];
+export async function run(ctx, args) {
+    const parsed = parseCommandArgs(args, { file: { type: 'string' }, 'session-id': { type: 'string' } });
+    if (parsed.help) {
+        ctx.output.result(usage, usage.join('\n'));
+        return;
+    }
+    if (parsed.positionals.length !== 1 || parsed.positionals[0] !== 'attach')
+        throw new UsageError(usage[0]);
+    const file = parsed.values.file;
+    const sessionId = parsed.values['session-id'] ?? process.env.HYPER_SESSION_ID;
+    if (typeof file !== 'string' || !file)
+        throw new UsageError('--file is required');
+    if (typeof sessionId !== 'string' || !sessionId)
+        throw new UsageError('HYPER_SESSION_ID or --session-id is required');
+    const bearer = process.env.HYPER_AGENTS_API_KEY;
+    if (!bearer)
+        throw new CliError('HYPER_AGENTS_API_KEY is required for the local host');
+    const port = process.env.HYPER_ACP_MCP_PORT ?? '18521';
+    if (!/^\d+$/.test(port) || Number(port) < 1 || Number(port) > 65535)
+        throw new UsageError('Invalid HYPER_ACP_MCP_PORT');
+    const endpoint = `http://127.0.0.1:${Number(port)}/mcp`;
+    if (process.env.HYPER_ACP_MCP_SERVER && process.env.HYPER_ACP_MCP_SERVER !== endpoint)
+        throw new UsageError('HYPER_ACP_MCP_SERVER must match the loopback listener');
+    const client = new Client({ name: 'hyper-cli', version: APP_VERSION });
+    const transport = new StreamableHTTPClientTransport(new URL(endpoint), {
+        requestInit: { headers: { Authorization: `Bearer ${bearer}` } },
+    });
+    try {
+        await client.connect(transport);
+        const result = await client.callTool({ name: 'attach_file', arguments: { path: resolve(file), sessionId } }, undefined, { timeout: 90000 });
+        ctx.output.result(result, JSON.stringify(result, null, 2));
+        return result.isError ? 1 : 0;
+    }
+    catch {
+        throw new CliError('Local attachment request failed; delivery may be uncertain. Do not automatically retry.');
+    }
+    finally {
+        await client.close().catch(() => { });
+        await transport.close().catch(() => { });
+    }
+}
+//# sourceMappingURL=acp.js.map

package/dist/commands/acp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp.js","sourceRoot":"","sources":["../../src/commands/acp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEzD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,MAAM,CAAC,MAAM,IAAI,GAAG,KAAK,CAAC;AAC1B,MAAM,CAAC,MAAM,OAAO,GAAG,gDAAgD,CAAC;AACxE,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,kDAAkD,CAAC,CAAC;AAE1E,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,GAAmB,EAAE,IAAc;IAC3D,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;IACtG,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAAC,OAAO;IAAC,CAAC;IACxE,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,QAAQ;QAAE,MAAM,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC;IAC3G,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;IAChC,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAC9E,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,UAAU,CAAC,oBAAoB,CAAC,CAAC;IAClF,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,CAAC,SAAS;QAAE,MAAM,IAAI,UAAU,CAAC,8CAA8C,CAAC,CAAC;IACtH,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IAChD,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,QAAQ,CAAC,qDAAqD,CAAC,CAAC;IACvF,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,OAAO,CAAC;IACvD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK;QAAE,MAAM,IAAI,UAAU,CAAC,4BAA4B,CAAC,CAAC;IACxH,MAAM,QAAQ,GAAG,oBAAoB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;IACxD,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,QAAQ;QAAE,MAAM,IAAI,UAAU,CAAC,uDAAuD,CAAC,CAAC;IACrK,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;IACvE,MAAM,SAAS,GAAG,IAAI,6BAA6B,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,EAAE;QACrE,WAAW,EAAE,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,MAAM,EAAE,EAAE,EAAE;KAChE,CAAC,CAAC;IACH,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAChC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5I,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3D,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,QAAQ,CAAC,yFAAyF,CAAC,CAAC;IAChH,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACrC,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC"}

package/dist/commands/agent-login.d.ts

@@ -0,0 +1,97 @@
+/**
+ * `hyper agents login` — first-class login flows for hosted agent pods,
+ * driven entirely through the existing exec/cp machinery; no TTY needed.
+ *
+ * Flow registry (LOGIN_FLOWS) is keyed by runtime so new runtimes (opencode,
+ * openclaw_acp, ...) slot in by adding an entry — each flow is an async fn over
+ * the shared exec/poll primitives.
+ *
+ * Choreographies (verified live in pods):
+ *   codex device-auth — detached `codex login --device-auth` writes a URL +
+ *     one-time code to /tmp/devauth.log; user completes it in a browser; the
+ *     log then reports success. Codes expire in 15 min.
+ *   claude-code paste-back — `claude auth login` reads stdin from a fifo held
+ *     open by a detached sleep; the OAuth URL lands in /tmp/clin.log; the
+ *     user pastes back the `code#state` string, which is piped into the fifo.
+ *     OAuth codes are single-use and bound to that login process's state, so
+ *     the URL is always re-extracted fresh from the log.
+ *   claude-code host-creds — copies local ~/.claude/.credentials.json into the
+ *     pod. Only ever via the explicit --from-host-creds flag.
+ *
+ * Detached-process discipline: exec calls are kept short; pod-side setsid
+ * processes survive client-side exec timeouts ('operation timed out'), so
+ * every launch tolerates the timeout and the poll loop discovers state.
+ */
+import { type Deployments } from '@hypercli.com/sdk';
+import type { CommandContext } from '../core/types.js';
+/** Strip ANSI escapes from pod log output before any regex extraction. */
+export declare function stripAnsi(input: string): string;
+/** Pull the device-auth URL + one-time code out of codex's log. */
+export declare function extractCodexDeviceAuth(log: string): {
+    url?: string;
+    code?: string;
+};
+export declare function codexDeviceAuthOutcome(log: string): 'success' | 'failed' | undefined;
+/** Pull the OAuth authorize URL out of `claude auth login` output. */
+export declare function extractClaudeOAuthUrl(log: string): string | undefined;
+export declare function claudePasteOutcome(log: string): 'success' | 'failed' | undefined;
+/** `claude auth status` prints JSON; tolerate it embedded in noisier output. */
+export declare function claudeStatusLoggedIn(text: string): boolean;
+/** POSIX single-quote an argv fragment (the pasted code rides through sh). */
+export declare function shQuote(value: string): string;
+export interface PollLogOptions<T> {
+    /** Return the current log text, or null when not yet readable. */
+    read: () => Promise<string | null>;
+    /** Extract the awaited value from (ANSI-stripped) text; undefined = keep polling. */
+    extract: (text: string) => T | undefined;
+    /** Terminal-abort check on the text; returning a message throws CliError. */
+    fail?: (text: string) => string | undefined;
+    deadlineAtMs: number;
+    waitingFor: string;
+    minIntervalMs?: number;
+    maxIntervalMs?: number;
+    /** Test seams: deterministic time/sleep/jitter. */
+    sleep?: (ms: number) => Promise<void>;
+    now?: () => number;
+    random?: () => number;
+}
+export declare function pollLog<T>(opts: PollLogOptions<T>): Promise<T>;
+interface LoginIO {
+    /** Machine mode: JSON lines on stdout, code read from stdin. */
+    readonly machine: boolean;
+    info(message: string): void;
+    announce(url: string, code?: string): void;
+    readInput(prompt: string): Promise<string>;
+    finish(outcome: LoginOutcome, provider?: string): void;
+}
+export interface LoginOutcome {
+    loggedIn: boolean;
+    flow: string;
+    runtime: string;
+    agentId: string;
+    detail?: string;
+}
+export interface LoginFlowContext {
+    d: Deployments;
+    agentId: string;
+    deadlineAtMs: number;
+    io: LoginIO;
+    provider?: string;
+}
+export interface LoginFlow {
+    readonly name: string;
+    readonly runtime: string;
+    /** Does an external wallet/user step have to feed input back into the CLI? */
+    readonly requiresWalletUserInput: {
+        readonly type: 'code-paste' | 'none';
+    };
+    readonly summary: string;
+    run(fx: LoginFlowContext): Promise<LoginOutcome>;
+}
+export declare const LOGIN_FLOWS: ReadonlyMap<string, readonly LoginFlow[]>;
+/** Exported for `hyper agents login` wiring in agents.ts. */
+export declare function cmdAgentsLogin(ctx: CommandContext, args: string[], hooks?: {
+    readInput?: (prompt: string) => Promise<string>;
+    now?: () => number;
+}): Promise<void>;
+export {};