@hypercli.com/cli 0.0.0-stage → 0.9.1

package/dist/commands/me.js

@@ -0,0 +1,258 @@
+/**
+ * `hyper me` — composite identity check (golden sample of an authenticated
+ * read command).
+ *
+ * Three authorities, reported independently:
+ *   1. Product identity  — client.user.authMe()              (GET /api/auth/me)
+ *   2. Agent entitlement — client.agent.subscriptionSummary() (agents section;
+ *      a 401/403 here reports "unavailable" and must NOT erase section 1)
+ *   3. Runtime identity  — client.deployments.accessIdentity() (cheap probe;
+ *      only an agent runtime key can name its Agent — skip silently otherwise)
+ *
+ * When section 3 says the key IS an agent runtime key, a fourth step resolves
+ * the Agent record itself (client.deployments.get('self') — name, handle,
+ * runtime); its failure must leave the output exactly as it was.
+ *
+ * The API key itself is never printed (keyId/keyName are identifiers, not the
+ * secret).
+ */
+import { APIError, hasActivePlan, } from '@hypercli.com/sdk';
+import { parseCommandArgs } from '../core/argv.js';
+import { CliError } from '../core/errors.js';
+import { renderGroupHelp } from '../core/help.js';
+export const name = 'me';
+export const summary = 'Resolve the current auth context and show key capabilities.';
+export const usage = ['hyper me [--json]'];
+/** Map an authMe failure to a precise CliError. Never retried. */
+function toAuthError(err) {
+    if (err instanceof APIError && err.statusCode === 401) {
+        const detail = err.detail ? `: ${err.detail}` : '';
+        // "API key is inactive" => the key was recognized but deactivated.
+        const message = /inactive/i.test(err.detail)
+            ? `API key recognized but inactive${detail}. Reactivate or replace the key at its source, then run 'hyper me' again`
+            : `API key invalid or expired${detail}. Run 'hyper configure' to set a valid key`;
+        return new CliError(message, 1);
+    }
+    if (err instanceof CliError)
+        return err;
+    if (err instanceof APIError) {
+        return new CliError(`failed to resolve identity (HTTP ${err.statusCode}): ${err.detail}`);
+    }
+    return new CliError(`failed to resolve identity: ${err instanceof Error ? err.message : String(err)}`);
+}
+function describeError(err) {
+    if (err instanceof APIError)
+        return `${err.statusCode}: ${err.detail}`;
+    return err instanceof Error ? err.message : String(err);
+}
+/** Latest expiresAt among ACTIVE entitlement items (python parity). */
+function latestActiveExpiry(summary) {
+    const dates = summary.entitlementItems
+        .filter((item) => item.status.toUpperCase() === 'ACTIVE')
+        .map((item) => item.expiresAt)
+        .filter((d) => d instanceof Date && Number.isFinite(d.getTime()))
+        .sort((a, b) => a.getTime() - b.getTime());
+    return dates.length > 0 ? dates[dates.length - 1] : null;
+}
+/** e.g. "3d 4h", "2h 15m", "40m", "expired" (python parity). */
+function formatTimeLeft(expiresAt, now = new Date()) {
+    const remainingMs = expiresAt.getTime() - now.getTime();
+    if (remainingMs <= 0)
+        return 'expired';
+    const totalMinutes = Math.floor(remainingMs / 60000);
+    const days = Math.floor(totalMinutes / 1440);
+    const hours = Math.floor((totalMinutes % 1440) / 60);
+    const minutes = totalMinutes % 60;
+    if (days)
+        return `${days}d ${hours}h`;
+    if (hours)
+        return `${hours}h ${minutes}m`;
+    return `${minutes}m`;
+}
+function thousands(n) {
+    return n.toLocaleString('en-US');
+}
+// ---------- table rendering ----------
+function rowsBlock(rows) {
+    const width = Math.max(0, ...rows.map(([key]) => key.length));
+    return rows.map(([key, value]) => `  ${key.padEnd(width)}  ${value}`.trimEnd());
+}
+function identityRows(authMe, agentIdentity, selfAgent) {
+    const rows = [
+        ['user_id', authMe.userId],
+        ['orchestra_user_id', authMe.orchestraUserId ?? ''],
+        ['external_id', authMe.externalId ?? ''],
+        ['privy_user_id', authMe.privyUserId ?? ''],
+        ['wallet_address', authMe.walletAddress ?? ''],
+        ['team_id', authMe.teamId],
+        ['plan_id', authMe.planId],
+        ['email', authMe.email ?? ''],
+        ['user_type', authMe.userType ?? ''],
+        ['auth_type', authMe.authType],
+        ['has_active_subscription', authMe.hasActiveSubscription ? 'yes' : 'no'],
+        ['key_id', authMe.keyId ?? ''],
+        ['key_name', authMe.keyName ?? ''],
+    ];
+    if (authMe.runtime)
+        rows.push(['runtime', authMe.runtime.runtime]);
+    if (agentIdentity) {
+        rows.push(['agent_id', agentIdentity.agentId ?? '']);
+        if (selfAgent) {
+            rows.push(['agent_name', selfAgent.displayName ?? selfAgent.name ?? '']);
+            if (selfAgent.handle)
+                rows.push(['agent_handle', selfAgent.handle]);
+            if (selfAgent.runtime)
+                rows.push(['agent_runtime', selfAgent.runtime]);
+        }
+        if (agentIdentity.capabilities.length > 0) {
+            rows.push(['agent_capabilities', agentIdentity.capabilities.join(', ')]);
+        }
+    }
+    return rows;
+}
+function agentsRows(summary, agentsError) {
+    if (!summary) {
+        return [['entitlements', `unavailable (${agentsError ?? 'unknown error'})`]];
+    }
+    const rows = [
+        ['has_active_plan', hasActivePlan(summary) ? 'yes' : 'no'],
+        ['effective_plan', summary.effectivePlanId],
+        ['current_entitlement', summary.currentEntitlementId ?? ''],
+        ['active_subscriptions', String(summary.activeSubscriptionCount)],
+        ['active_entitlements', String(summary.activeEntitlementCount)],
+    ];
+    const expiresAt = latestActiveExpiry(summary);
+    if (expiresAt) {
+        rows.push(['expires_at', expiresAt.toISOString()]);
+        rows.push(['time_left', formatTimeLeft(expiresAt)]);
+    }
+    rows.push([
+        'limits',
+        `${thousands(summary.pooledTpmLimit)} TPM / ${thousands(summary.pooledRpmLimit)} RPM / ${thousands(summary.pooledTpd)} TPD`,
+    ]);
+    return rows;
+}
+function renderTable(authMe, agentIdentity, selfAgent, summary, agentsError) {
+    const identity = ['Identity', ...rowsBlock(identityRows(authMe, agentIdentity, selfAgent))].join('\n');
+    const capabilityLines = authMe.capabilities.length > 0 ? authMe.capabilities.map((c) => `  ${c}`) : ['  (none)'];
+    const capabilities = ['Capabilities', ...capabilityLines].join('\n');
+    const agents = ['Agents', ...rowsBlock(agentsRows(summary, agentsError))].join('\n');
+    return `${identity}\n\n${capabilities}\n\n${agents}`;
+}
+// ---------- json rendering ----------
+function identityJson(authMe, agentIdentity, selfAgent) {
+    const identity = {
+        userId: authMe.userId,
+        orchestraUserId: authMe.orchestraUserId,
+        externalId: authMe.externalId,
+        privyUserId: authMe.privyUserId,
+        walletAddress: authMe.walletAddress,
+        userType: authMe.userType,
+        teamId: authMe.teamId,
+        planId: authMe.planId,
+        email: authMe.email,
+        authType: authMe.authType,
+        hasActiveSubscription: authMe.hasActiveSubscription,
+        keyId: authMe.keyId,
+        keyName: authMe.keyName,
+        tags: authMe.tags,
+    };
+    if (authMe.runtime)
+        identity.runtime = authMe.runtime;
+    if (agentIdentity) {
+        identity.agent_id = agentIdentity.agentId;
+        if (selfAgent) {
+            identity.agent_name = selfAgent.displayName ?? selfAgent.name ?? null;
+            identity.agent_handle = selfAgent.handle ?? null;
+            identity.agent_runtime = selfAgent.runtime ?? null;
+        }
+        identity.agent_capabilities = agentIdentity.capabilities;
+    }
+    return identity;
+}
+function agentsJson(summary) {
+    return {
+        hasActivePlan: hasActivePlan(summary),
+        effectivePlanId: summary.effectivePlanId,
+        currentSubscriptionId: summary.currentSubscriptionId,
+        currentEntitlementId: summary.currentEntitlementId,
+        activeSubscriptionCount: summary.activeSubscriptionCount,
+        activeEntitlementCount: summary.activeEntitlementCount,
+        pooledTpmLimit: summary.pooledTpmLimit,
+        pooledRpmLimit: summary.pooledRpmLimit,
+        pooledTpd: summary.pooledTpd,
+        billingResetAt: summary.billingResetAt ? summary.billingResetAt.toISOString() : null,
+        entitlementItems: summary.entitlementItems.map((item) => ({
+            id: item.id,
+            planId: item.planId,
+            planName: item.planName,
+            provider: item.provider,
+            status: item.status,
+            startsAt: item.startsAt ? item.startsAt.toISOString() : null,
+            expiresAt: item.expiresAt ? item.expiresAt.toISOString() : null,
+            tpmLimit: item.tpmLimit,
+            rpmLimit: item.rpmLimit,
+            tpdLimit: item.tpdLimit,
+            agentTier: item.agentTier,
+            features: item.features,
+            tags: item.tags,
+        })),
+    };
+}
+export async function run(ctx, args) {
+    const parsed = parseCommandArgs(args);
+    if (parsed.help) {
+        process.stdout.write(`${renderGroupHelp({ name, summary, usage, run })}\n`);
+        return;
+    }
+    const client = await ctx.client();
+    // 1. Product identity — the command's spine. A 401 here is fatal, no retry.
+    let authMe;
+    try {
+        authMe = await client.user.authMe();
+    }
+    catch (err) {
+        throw toAuthError(err);
+    }
+    // 2. Agent entitlement — failure degrades to "unavailable", never erases 1.
+    let entitlementSummary = null;
+    let agentsError = null;
+    try {
+        entitlementSummary = await client.agent.subscriptionSummary();
+    }
+    catch (err) {
+        agentsError = describeError(err);
+    }
+    // 3. Runtime identity — only an agent runtime key can name its Agent;
+    //    a failure here must leave `hyper me` exactly as it was.
+    let agentIdentity = null;
+    try {
+        const resolved = await client.deployments.accessIdentity();
+        if (resolved.isAgentRuntimeKey)
+            agentIdentity = resolved;
+    }
+    catch {
+        agentIdentity = null;
+    }
+    // 4. Agent record (self) — resolves the runtime key's Agent display name,
+    //    handle, and runtime family. Same degradation rule as 3.
+    let selfAgent = null;
+    if (agentIdentity) {
+        try {
+            selfAgent = await client.deployments.get('self');
+        }
+        catch {
+            selfAgent = null;
+        }
+    }
+    const agents = entitlementSummary ? agentsJson(entitlementSummary) : null;
+    const payload = {
+        identity: identityJson(authMe, agentIdentity, selfAgent),
+        capabilities: authMe.capabilities,
+        agents,
+    };
+    if (agents === null)
+        payload.agents_error = agentsError ?? 'unknown error';
+    ctx.output.result(payload, renderTable(authMe, agentIdentity, selfAgent, entitlementSummary, agentsError));
+}
+//# sourceMappingURL=me.js.map

package/dist/commands/me.js.map

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

package/dist/commands/memory.d.ts

@@ -0,0 +1,5 @@
+import type { CommandContext } from '../core/types.js';
+export declare const name = "memory";
+export declare const summary = "Search session memory, fetch summaries and history, or rebuild a summary (once per 24h).";
+export declare const usage: string[];
+export declare function run(ctx: CommandContext, args: string[]): Promise<void>;

package/dist/commands/memory.js

@@ -0,0 +1,110 @@
+import { APIError } from '@hypercli.com/sdk';
+import { parseCommandArgs } from '../core/argv.js';
+import { UsageError } from '../core/errors.js';
+import { renderGroupHelp } from '../core/help.js';
+export const name = 'memory';
+export const summary = 'Search session memory, fetch summaries and history, or rebuild a summary (once per 24h).';
+export const usage = [
+    'hyper memory search <query...> [-s|--session-id ID] [-a|--agent-id ID] [--cursor CURSOR] [--limit N] [--json]',
+    'hyper memory summary <ID> [--json]',
+    'hyper memory chunks <ID> [--cursor CURSOR] [--limit N] [--json]',
+    'hyper memory tail <ID> [--n N] [--json]',
+    'hyper memory rebuild <ID> [--json]',
+];
+function positiveInteger(value, flag) {
+    if (value === undefined)
+        return undefined;
+    const number = Number(value);
+    if (!/^\d+$/.test(String(value)) || !Number.isSafeInteger(number) || number < 1 || number > 100) {
+        throw new UsageError(`${flag} must be an integer from 1 to 100`);
+    }
+    return number;
+}
+const FULL_UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const ARG_SPEC = {
+    'session-id': { type: 'string', short: 's' },
+    'agent-id': { type: 'string', short: 'a' },
+    limit: { type: 'string' },
+    cursor: { type: 'string' },
+    n: { type: 'string' },
+};
+export async function run(ctx, args) {
+    const parsed = parseCommandArgs(args, ARG_SPEC);
+    if (parsed.help || parsed.positionals.length === 0) {
+        process.stdout.write(`${renderGroupHelp({ name, summary, usage, run })}\n`);
+        return;
+    }
+    const [command, ...rest] = parsed.positionals;
+    const allowed = {
+        search: ['session-id', 'agent-id', 'cursor', 'limit'], summary: [], chunks: ['cursor', 'limit'], tail: ['n'], rebuild: [],
+    };
+    if (!Object.hasOwn(allowed, command))
+        throw new UsageError(`unknown memory command '${command}'`);
+    for (const flag of Object.keys(ARG_SPEC)) {
+        if (parsed.values[flag] !== undefined && !allowed[command].includes(flag)) {
+            throw new UsageError(`--${flag} is not supported by memory ${command}`);
+        }
+    }
+    if (command === 'search' ? !rest.join(' ').trim() : rest.length !== 1 || !rest[0].trim()) {
+        throw new UsageError(command === 'search' ? 'memory search requires a query' : `memory ${command} requires one session ID`);
+    }
+    const limit = positiveInteger(parsed.values.limit, '--limit');
+    const n = positiveInteger(parsed.values.n, '--n');
+    const sessionId = parsed.values['session-id'];
+    if (sessionId !== undefined && !sessionId.trim())
+        throw new UsageError('--session-id must not be empty');
+    const agentId = parsed.values['agent-id'];
+    if (agentId !== undefined && !FULL_UUID.test(agentId.trim()))
+        throw new UsageError('--agent-id must be a UUID');
+    const api = (await ctx.client()).memory;
+    switch (command) {
+        case 'search': {
+            const result = await api.search(rest.join(' '), { sessionId, agentId, cursor: parsed.values.cursor, limit });
+            ctx.output.result(result, result.items.length ? {
+                columns: ['SESSION', 'CHUNK', 'SCORE', 'TEXT'],
+                rows: result.items.map((row) => [row.sessionId, row.id, row.score, row.text]),
+            } : 'No results.');
+            if (ctx.format !== 'json' && result.hasMore && result.nextCursor !== null) {
+                ctx.output.info(`Next cursor: ${result.nextCursor}`);
+            }
+            return;
+        }
+        case 'summary': {
+            const result = await api.getSummary(rest[0]);
+            ctx.output.result(result, result.summaryText ?? (result.pending ? 'Summary pending.' : 'No summary yet.'));
+            return;
+        }
+        case 'rebuild': {
+            try {
+                const result = await api.rebuild(rest[0]);
+                ctx.output.result(result, `Summary rebuild ${result.status}: ${result.sessionId}`);
+            }
+            catch (error) {
+                if (error instanceof APIError && error.retryAfterSeconds !== undefined) {
+                    throw new APIError(error.statusCode, `${error.detail} (retry after ${error.retryAfterSeconds}s)`, error.method, error.url, error.responseText, error.retryAfterSeconds);
+                }
+                throw error;
+            }
+            return;
+        }
+        case 'chunks': {
+            const result = await api.getChunks(rest[0], { cursor: parsed.values.cursor, limit });
+            ctx.output.result(result, result.items.length ? {
+                columns: ['ID', 'START', 'END', 'TEXT'],
+                rows: result.items.map((row) => [row.id, row.seqStart, row.seqEnd, row.text]),
+            } : 'No chunks.');
+            if (ctx.format !== 'json' && result.hasMore && result.nextCursor !== null) {
+                ctx.output.info(`Next cursor: ${result.nextCursor}`);
+            }
+            return;
+        }
+        case 'tail': {
+            const result = await api.getTail(rest[0], n ?? 20);
+            ctx.output.result(result, result.items.length ? {
+                columns: ['START', 'END', 'ROLE', 'TEXT'],
+                rows: result.items.map((row) => [row.seqStart, row.seqEnd, row.role, row.text]),
+            } : 'No messages.');
+        }
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/commands/memory.js.map

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

package/dist/commands/routines.d.ts

@@ -0,0 +1,27 @@
+/**
+ * `hyper routines` — scheduled prompts for agents, plus on-demand runs.
+ *
+ * `hyper agents routines list|create|delete` stays untouched and rides
+ * client.routines; this group is the top-level test surface (jobs.ts/voice.ts
+ * shape: self-contained module, local helpers).
+ *
+ * `routines run` NOTE (no server-side run-now): the backend service
+ * (hyperclaw-backend/routines/app/main.py) exposes only
+ * list/create/get/patch/delete, and ts-sdk/src/routines.ts mirrors that.
+ * `run` therefore replays the executor's semantics locally: fetch the
+ * routine's agent, require RUNNING and an ACP-family runtime (mirror of
+ * routines/app/executor.py `execute_routine`), then send the prompt over the
+ * backend ACP session proxy (/ws/acp) — session_id bound -> socket attach +
+ * session/load (new session on failure), else session/new. The turn
+ * inherently runs to a stop reason
+ * (closing the socket would cancel it), so --wait only controls whether the
+ * assistant reply is printed.
+ */
+import { type Routine } from '@hypercli.com/sdk';
+import type { CommandContext } from '../core/types.js';
+export declare const name = "routines";
+export declare const summary = "Manage scheduled agent routines and run them on demand.";
+export declare const usage: string[];
+/** Exported for the desktop-parity test matrix in tests/routines.test.ts. */
+export declare function describeSchedule(routine: Routine): string;
+export declare function run(ctx: CommandContext, args: string[]): Promise<number | void>;