frely-cli 0.6.10 → 0.8.3

package/dist/agent-help.d.ts

@@ -1,9 +1,21 @@
 export declare const COMMANDS: readonly [{
-    readonly id: "cloud";
-    readonly usage: "frely cloud list|describe|call|login|logout [--help]";
-    readonly auth: "cloud-oauth";
-    readonly effect: "subcommand-dependent";
-    readonly purpose: "Discover and call Frely cloud business operations at app.frely.cloud/mcp. Use describe before call; parameters and results are JSON.";
+    readonly id: "login";
+    readonly usage: "frely login [--relay <url>] [--no-browser]";
+    readonly auth: "browser";
+    readonly effect: "authorization";
+    readonly purpose: "Authorize the CLI for the user's Frely account.";
+}, {
+    readonly id: "logout";
+    readonly usage: "frely logout";
+    readonly auth: "none";
+    readonly effect: "local-write";
+    readonly purpose: "Remove login, revoke Cloud authorization and stop the MCP background service.";
+}, {
+    readonly id: "doctor";
+    readonly usage: "frely doctor [-v] [--json]";
+    readonly auth: "optional-account";
+    readonly effect: "diagnostic";
+    readonly purpose: "Show the signed-in account, installation, available upgrades, MCP and connection status; -v verifies the account online and runs detailed diagnostics.";
 }, {
     readonly id: "upgrade";
     readonly usage: "frely upgrade";
@@ -17,65 +29,77 @@ export declare const COMMANDS: readonly [{
     readonly effect: "read";
     readonly purpose: "Read this installed CLI's current Agent instructions.";
 }, {
-    readonly id: "key.budget";
-    readonly usage: "frely key budget (--api-key-stdin [--relay <url>]|--distribution <distribution-id>) [--json]";
-    readonly auth: "api-key";
-    readonly effect: "read";
-    readonly purpose: "Read the Key's self usage and each funding source's limits without account login.";
+    readonly id: "mcp";
+    readonly usage: "frely mcp [--workspace <path>] [--days 1..180] [--json]";
+    readonly auth: "account-and-browser-if-needed";
+    readonly effect: "authorization-if-needed";
+    readonly purpose: "Enable, renew or read device MCP. Unconfigured: request browser approval for --workspace (default: current directory) and install the background service. Expired or --days given: renew with browser approval; the MCP URL stays the same. Otherwise print the MCP URL unchanged. Prompts go to stderr; stdout holds only the URL, or JSON with HTTP transport and OAuth details.";
 }, {
-    readonly id: "skill.install";
-    readonly usage: "frely skill install <manifest-url> [--host chatgpt|codex|claude-code|pi|generic] [--scope global|project] [--api-key-stdin] [--json]";
-    readonly auth: "optional-api-key";
-    readonly effect: "local-write";
-    readonly purpose: "Install the public Agent's trigger Skill; an API key goes only through stdin to secure storage.";
+    readonly id: "mcp.workspace";
+    readonly usage: "frely mcp workspace [add|remove <path>] [--json]";
+    readonly auth: "mcp";
+    readonly effect: "subcommand-dependent";
+    readonly purpose: "List workspace directories for this device, or add/remove an additional one (the primary cannot be removed).";
 }, {
-    readonly id: "skill.status";
-    readonly usage: "frely skill status <distribution-id> [--json]";
+    readonly id: "mcp.stop";
+    readonly usage: "frely mcp stop";
     readonly auth: "none";
-    readonly effect: "read";
-    readonly purpose: "Inspect a managed Agent Skill.";
+    readonly effect: "local-service";
+    readonly purpose: "Pause the local MCP background service. Supported upgrades restore running services without this command.";
 }, {
-    readonly id: "skill.remove";
-    readonly usage: "frely skill remove <distribution-id> [--json]";
+    readonly id: "mcp.start";
+    readonly usage: "frely mcp start";
     readonly auth: "none";
+    readonly effect: "local-service";
+    readonly purpose: "Resume the local MCP background service.";
+}, {
+    readonly id: "mcp.remove";
+    readonly usage: "frely mcp remove";
+    readonly auth: "account";
+    readonly effect: "remote-write";
+    readonly purpose: "Revoke device MCP for every connected client and uninstall the background service (kept running provider-only when local Providers exist).";
+}, {
+    readonly id: "mcp.stdio";
+    readonly usage: "frely mcp stdio [--workspace <path>]";
+    readonly auth: "mcp";
+    readonly effect: "local-execution";
+    readonly purpose: "Serve authorized local tools over stdio for a local MCP client.";
+}, {
+    readonly id: "mcp.serve";
+    readonly usage: "frely mcp serve [--workspace <path>]";
+    readonly auth: "account-and-mcp";
+    readonly effect: "local-execution";
+    readonly purpose: "Foreground Device Relay client; the background service runs this. Not needed for normal use.";
+}, {
+    readonly id: "agent.install";
+    readonly usage: "frely agent install <distribution-id|manifest-url> [--host chatgpt|codex|claude-code|pi|generic] [--scope global|project] [--api-key-stdin] [--json]";
+    readonly auth: "optional-api-key";
     readonly effect: "local-write";
-    readonly purpose: "Remove a managed Agent Skill and its saved API key.";
+    readonly purpose: "Install the public Agent's trigger Skill; an API key goes only through stdin to secure storage.";
 }, {
-    readonly id: "agent.invoke";
-    readonly usage: "frely agent invoke <distribution-id> (--input <text>|--input-stdin) [--json]";
+    readonly id: "agent.run";
+    readonly usage: "frely agent run <distribution-id> (--input <text>|--input-stdin) [--json]";
     readonly auth: "installed-api-key-or-account";
     readonly effect: "remote-call";
     readonly purpose: "Send the complete relevant user request to the installed Agent through model-scoped MCP. Usage may be billed.";
 }, {
-    readonly id: "login";
-    readonly usage: "frely login [--relay <url>] [--no-browser]";
-    readonly auth: "browser";
-    readonly effect: "authorization";
-    readonly purpose: "Authorize the CLI for the user's Frely account.";
+    readonly id: "agent.status";
+    readonly usage: "frely agent status (<distribution-id>|--api-key-stdin [--relay <url>]) [--json]";
+    readonly auth: "none-or-api-key";
+    readonly effect: "read";
+    readonly purpose: "Inspect an installed Agent Skill and, for API-key installs, its Key budget. With --api-key-stdin, read that Key's budget without installing or logging in.";
 }, {
-    readonly id: "logout";
-    readonly usage: "frely logout";
+    readonly id: "agent.remove";
+    readonly usage: "frely agent remove <distribution-id> [--json]";
     readonly auth: "none";
     readonly effect: "local-write";
-    readonly purpose: "Remove login and stop the MCP background service.";
-}, {
-    readonly id: "whoami";
-    readonly usage: "frely whoami";
-    readonly auth: "account";
-    readonly effect: "read";
-    readonly purpose: "Read the signed-in account.";
-}, {
-    readonly id: "doctor";
-    readonly usage: "frely doctor [-v] [--json]";
-    readonly auth: "optional-account";
-    readonly effect: "diagnostic";
-    readonly purpose: "Show installation, available upgrades, account, MCP and connection status; -v runs detailed diagnostics.";
+    readonly purpose: "Remove an installed Agent Skill and its saved API key.";
 }, {
     readonly id: "provider.share";
     readonly usage: "frely provider share [ollama|openai-compatible] [--url <loopback-v1-url>] [--models <a,b>] [--slot <slot-id>] [--name <name>]";
     readonly auth: "account";
     readonly effect: "remote-write";
-    readonly purpose: "Publish a local model Provider.";
+    readonly purpose: "Publish a local model Provider. If a prepared Provider on this device is not finished, resume it instead.";
 }, {
     readonly id: "provider.list";
     readonly usage: "frely provider list [--json]";
@@ -83,59 +107,47 @@ export declare const COMMANDS: readonly [{
     readonly effect: "read";
     readonly purpose: "List configured local Providers.";
 }, {
-    readonly id: "provider.finalize";
-    readonly usage: "frely provider finalize <provider-id>";
-    readonly auth: "account";
-    readonly effect: "remote-write";
-    readonly purpose: "Finish a prepared local Provider.";
-}, {
-    readonly id: "mcp.setup";
-    readonly usage: "frely mcp [--workspace <path>] [--days 1..180]";
-    readonly auth: "account-and-browser";
-    readonly effect: "authorization";
-    readonly purpose: "Enable this computer as a device MCP service for remote HTTP MCP clients with OAuth; install its background service.";
-}, {
-    readonly id: "mcp.renew";
-    readonly usage: "frely mcp renew [--days 1..180]";
-    readonly auth: "account-and-browser";
-    readonly effect: "authorization";
-    readonly purpose: "Renew this device's execution authorization without changing its MCP URL.";
+    readonly id: "cloud";
+    readonly usage: "frely cloud list|describe|call [--help]";
+    readonly auth: "cloud-oauth";
+    readonly effect: "subcommand-dependent";
+    readonly purpose: "Discover and call Frely cloud business operations at frely.cloud/mcp. The first call requests browser authorization. Use describe before call; parameters and results are JSON.";
 }, {
-    readonly id: "mcp.url";
-    readonly usage: "frely mcp url [--json]";
-    readonly auth: "account-and-mcp-or-browser";
-    readonly effect: "authorization-if-unconfigured";
-    readonly purpose: "Read this device's stable MCP URL. If unconfigured, set up the user home directory with browser approval and install the background service. --json includes HTTP transport and OAuth connection details; setup prompts go to stderr.";
+    readonly id: "app.remote";
+    readonly usage: "frely app remote enable|disable|status [--json]";
+    readonly auth: "local";
+    readonly effect: "local-write";
+    readonly purpose: "Toggle agent remote control for the Frely web app (app.frely.cloud). Disabled by default; enable before starting tasks from a phone.";
 }, {
-    readonly id: "mcp.serve";
-    readonly usage: "frely mcp serve [--workspace <path>]";
-    readonly auth: "account-and-mcp";
-    readonly effect: "local-execution";
-    readonly purpose: "Serve authorized local workspace tools.";
+    readonly id: "app.ops";
+    readonly usage: "frely app ops";
+    readonly auth: "local";
+    readonly effect: "read-only";
+    readonly purpose: "Bridge the local agent ops socket to stdin/stdout (NDJSON, incl. tasks_changed pushes); used by the Frely App GUI task panel.";
 }, {
-    readonly id: "mcp.service";
-    readonly usage: "frely mcp service start|stop|uninstall";
-    readonly auth: "none";
-    readonly effect: "local-service";
-    readonly purpose: "Pause, resume or remove the local MCP background service for maintenance. Supported upgrades restore running services without these commands.";
+    readonly id: "app.connectInfo";
+    readonly usage: "frely app connect-info [--json]";
+    readonly auth: "local";
+    readonly effect: "read-only";
+    readonly purpose: "Report the local agent ops socket path and whether a serving process is reachable (used by the Frely App GUI to find task control).";
 }, {
-    readonly id: "mcp.revoke";
-    readonly usage: "frely mcp revoke";
-    readonly auth: "account";
-    readonly effect: "remote-write";
-    readonly purpose: "Revoke device MCP execution authorization for every connected client.";
+    readonly id: "app.key";
+    readonly usage: "frely app key [--lifetime-usd N] [--json]";
+    readonly auth: "user";
+    readonly effect: "account-write";
+    readonly purpose: "Provision a device-scoped Frely API key for app agent tasks (shown once, capped at a lifetime spend limit; default $50, max $500).";
 }, {
-    readonly id: "mcp.stdio";
-    readonly usage: "frely mcp stdio [--workspace <path>]";
-    readonly auth: "mcp";
-    readonly effect: "local-execution";
-    readonly purpose: "Serve authorized local tools over stdio.";
+    readonly id: "app.tasks";
+    readonly usage: "frely app tasks [--json]";
+    readonly auth: "local";
+    readonly effect: "read";
+    readonly purpose: "List local agent tasks with status, merge state and budget usage.";
 }, {
     readonly id: "network";
     readonly usage: "frely network setup|status|find|use|logout [--json]";
     readonly auth: "network";
     readonly effect: "subcommand-dependent";
-    readonly purpose: "Access Frely Network using its separate setup and credentials.";
+    readonly purpose: "Access Frely Network (preview) using its separate setup and credentials.";
 }];
 export declare function agentHelp(): {
     schemaVersion: string;
@@ -144,11 +156,23 @@ export declare function agentHelp(): {
     skill_update_required: boolean;
     instructions: string[];
     commands: readonly [{
-        readonly id: "cloud";
-        readonly usage: "frely cloud list|describe|call|login|logout [--help]";
-        readonly auth: "cloud-oauth";
-        readonly effect: "subcommand-dependent";
-        readonly purpose: "Discover and call Frely cloud business operations at app.frely.cloud/mcp. Use describe before call; parameters and results are JSON.";
+        readonly id: "login";
+        readonly usage: "frely login [--relay <url>] [--no-browser]";
+        readonly auth: "browser";
+        readonly effect: "authorization";
+        readonly purpose: "Authorize the CLI for the user's Frely account.";
+    }, {
+        readonly id: "logout";
+        readonly usage: "frely logout";
+        readonly auth: "none";
+        readonly effect: "local-write";
+        readonly purpose: "Remove login, revoke Cloud authorization and stop the MCP background service.";
+    }, {
+        readonly id: "doctor";
+        readonly usage: "frely doctor [-v] [--json]";
+        readonly auth: "optional-account";
+        readonly effect: "diagnostic";
+        readonly purpose: "Show the signed-in account, installation, available upgrades, MCP and connection status; -v verifies the account online and runs detailed diagnostics.";
     }, {
         readonly id: "upgrade";
         readonly usage: "frely upgrade";
@@ -162,65 +186,77 @@ export declare function agentHelp(): {
         readonly effect: "read";
         readonly purpose: "Read this installed CLI's current Agent instructions.";
     }, {
-        readonly id: "key.budget";
-        readonly usage: "frely key budget (--api-key-stdin [--relay <url>]|--distribution <distribution-id>) [--json]";
-        readonly auth: "api-key";
-        readonly effect: "read";
-        readonly purpose: "Read the Key's self usage and each funding source's limits without account login.";
+        readonly id: "mcp";
+        readonly usage: "frely mcp [--workspace <path>] [--days 1..180] [--json]";
+        readonly auth: "account-and-browser-if-needed";
+        readonly effect: "authorization-if-needed";
+        readonly purpose: "Enable, renew or read device MCP. Unconfigured: request browser approval for --workspace (default: current directory) and install the background service. Expired or --days given: renew with browser approval; the MCP URL stays the same. Otherwise print the MCP URL unchanged. Prompts go to stderr; stdout holds only the URL, or JSON with HTTP transport and OAuth details.";
     }, {
-        readonly id: "skill.install";
-        readonly usage: "frely skill install <manifest-url> [--host chatgpt|codex|claude-code|pi|generic] [--scope global|project] [--api-key-stdin] [--json]";
-        readonly auth: "optional-api-key";
-        readonly effect: "local-write";
-        readonly purpose: "Install the public Agent's trigger Skill; an API key goes only through stdin to secure storage.";
+        readonly id: "mcp.workspace";
+        readonly usage: "frely mcp workspace [add|remove <path>] [--json]";
+        readonly auth: "mcp";
+        readonly effect: "subcommand-dependent";
+        readonly purpose: "List workspace directories for this device, or add/remove an additional one (the primary cannot be removed).";
     }, {
-        readonly id: "skill.status";
-        readonly usage: "frely skill status <distribution-id> [--json]";
+        readonly id: "mcp.stop";
+        readonly usage: "frely mcp stop";
         readonly auth: "none";
-        readonly effect: "read";
-        readonly purpose: "Inspect a managed Agent Skill.";
+        readonly effect: "local-service";
+        readonly purpose: "Pause the local MCP background service. Supported upgrades restore running services without this command.";
     }, {
-        readonly id: "skill.remove";
-        readonly usage: "frely skill remove <distribution-id> [--json]";
+        readonly id: "mcp.start";
+        readonly usage: "frely mcp start";
         readonly auth: "none";
+        readonly effect: "local-service";
+        readonly purpose: "Resume the local MCP background service.";
+    }, {
+        readonly id: "mcp.remove";
+        readonly usage: "frely mcp remove";
+        readonly auth: "account";
+        readonly effect: "remote-write";
+        readonly purpose: "Revoke device MCP for every connected client and uninstall the background service (kept running provider-only when local Providers exist).";
+    }, {
+        readonly id: "mcp.stdio";
+        readonly usage: "frely mcp stdio [--workspace <path>]";
+        readonly auth: "mcp";
+        readonly effect: "local-execution";
+        readonly purpose: "Serve authorized local tools over stdio for a local MCP client.";
+    }, {
+        readonly id: "mcp.serve";
+        readonly usage: "frely mcp serve [--workspace <path>]";
+        readonly auth: "account-and-mcp";
+        readonly effect: "local-execution";
+        readonly purpose: "Foreground Device Relay client; the background service runs this. Not needed for normal use.";
+    }, {
+        readonly id: "agent.install";
+        readonly usage: "frely agent install <distribution-id|manifest-url> [--host chatgpt|codex|claude-code|pi|generic] [--scope global|project] [--api-key-stdin] [--json]";
+        readonly auth: "optional-api-key";
         readonly effect: "local-write";
-        readonly purpose: "Remove a managed Agent Skill and its saved API key.";
+        readonly purpose: "Install the public Agent's trigger Skill; an API key goes only through stdin to secure storage.";
     }, {
-        readonly id: "agent.invoke";
-        readonly usage: "frely agent invoke <distribution-id> (--input <text>|--input-stdin) [--json]";
+        readonly id: "agent.run";
+        readonly usage: "frely agent run <distribution-id> (--input <text>|--input-stdin) [--json]";
         readonly auth: "installed-api-key-or-account";
         readonly effect: "remote-call";
         readonly purpose: "Send the complete relevant user request to the installed Agent through model-scoped MCP. Usage may be billed.";
     }, {
-        readonly id: "login";
-        readonly usage: "frely login [--relay <url>] [--no-browser]";
-        readonly auth: "browser";
-        readonly effect: "authorization";
-        readonly purpose: "Authorize the CLI for the user's Frely account.";
+        readonly id: "agent.status";
+        readonly usage: "frely agent status (<distribution-id>|--api-key-stdin [--relay <url>]) [--json]";
+        readonly auth: "none-or-api-key";
+        readonly effect: "read";
+        readonly purpose: "Inspect an installed Agent Skill and, for API-key installs, its Key budget. With --api-key-stdin, read that Key's budget without installing or logging in.";
     }, {
-        readonly id: "logout";
-        readonly usage: "frely logout";
+        readonly id: "agent.remove";
+        readonly usage: "frely agent remove <distribution-id> [--json]";
         readonly auth: "none";
         readonly effect: "local-write";
-        readonly purpose: "Remove login and stop the MCP background service.";
-    }, {
-        readonly id: "whoami";
-        readonly usage: "frely whoami";
-        readonly auth: "account";
-        readonly effect: "read";
-        readonly purpose: "Read the signed-in account.";
-    }, {
-        readonly id: "doctor";
-        readonly usage: "frely doctor [-v] [--json]";
-        readonly auth: "optional-account";
-        readonly effect: "diagnostic";
-        readonly purpose: "Show installation, available upgrades, account, MCP and connection status; -v runs detailed diagnostics.";
+        readonly purpose: "Remove an installed Agent Skill and its saved API key.";
     }, {
         readonly id: "provider.share";
         readonly usage: "frely provider share [ollama|openai-compatible] [--url <loopback-v1-url>] [--models <a,b>] [--slot <slot-id>] [--name <name>]";
         readonly auth: "account";
         readonly effect: "remote-write";
-        readonly purpose: "Publish a local model Provider.";
+        readonly purpose: "Publish a local model Provider. If a prepared Provider on this device is not finished, resume it instead.";
     }, {
         readonly id: "provider.list";
         readonly usage: "frely provider list [--json]";
@@ -228,59 +264,47 @@ export declare function agentHelp(): {
         readonly effect: "read";
         readonly purpose: "List configured local Providers.";
     }, {
-        readonly id: "provider.finalize";
-        readonly usage: "frely provider finalize <provider-id>";
-        readonly auth: "account";
-        readonly effect: "remote-write";
-        readonly purpose: "Finish a prepared local Provider.";
-    }, {
-        readonly id: "mcp.setup";
-        readonly usage: "frely mcp [--workspace <path>] [--days 1..180]";
-        readonly auth: "account-and-browser";
-        readonly effect: "authorization";
-        readonly purpose: "Enable this computer as a device MCP service for remote HTTP MCP clients with OAuth; install its background service.";
-    }, {
-        readonly id: "mcp.renew";
-        readonly usage: "frely mcp renew [--days 1..180]";
-        readonly auth: "account-and-browser";
-        readonly effect: "authorization";
-        readonly purpose: "Renew this device's execution authorization without changing its MCP URL.";
+        readonly id: "cloud";
+        readonly usage: "frely cloud list|describe|call [--help]";
+        readonly auth: "cloud-oauth";
+        readonly effect: "subcommand-dependent";
+        readonly purpose: "Discover and call Frely cloud business operations at frely.cloud/mcp. The first call requests browser authorization. Use describe before call; parameters and results are JSON.";
     }, {
-        readonly id: "mcp.url";
-        readonly usage: "frely mcp url [--json]";
-        readonly auth: "account-and-mcp-or-browser";
-        readonly effect: "authorization-if-unconfigured";
-        readonly purpose: "Read this device's stable MCP URL. If unconfigured, set up the user home directory with browser approval and install the background service. --json includes HTTP transport and OAuth connection details; setup prompts go to stderr.";
+        readonly id: "app.remote";
+        readonly usage: "frely app remote enable|disable|status [--json]";
+        readonly auth: "local";
+        readonly effect: "local-write";
+        readonly purpose: "Toggle agent remote control for the Frely web app (app.frely.cloud). Disabled by default; enable before starting tasks from a phone.";
     }, {
-        readonly id: "mcp.serve";
-        readonly usage: "frely mcp serve [--workspace <path>]";
-        readonly auth: "account-and-mcp";
-        readonly effect: "local-execution";
-        readonly purpose: "Serve authorized local workspace tools.";
+        readonly id: "app.ops";
+        readonly usage: "frely app ops";
+        readonly auth: "local";
+        readonly effect: "read-only";
+        readonly purpose: "Bridge the local agent ops socket to stdin/stdout (NDJSON, incl. tasks_changed pushes); used by the Frely App GUI task panel.";
     }, {
-        readonly id: "mcp.service";
-        readonly usage: "frely mcp service start|stop|uninstall";
-        readonly auth: "none";
-        readonly effect: "local-service";
-        readonly purpose: "Pause, resume or remove the local MCP background service for maintenance. Supported upgrades restore running services without these commands.";
+        readonly id: "app.connectInfo";
+        readonly usage: "frely app connect-info [--json]";
+        readonly auth: "local";
+        readonly effect: "read-only";
+        readonly purpose: "Report the local agent ops socket path and whether a serving process is reachable (used by the Frely App GUI to find task control).";
     }, {
-        readonly id: "mcp.revoke";
-        readonly usage: "frely mcp revoke";
-        readonly auth: "account";
-        readonly effect: "remote-write";
-        readonly purpose: "Revoke device MCP execution authorization for every connected client.";
+        readonly id: "app.key";
+        readonly usage: "frely app key [--lifetime-usd N] [--json]";
+        readonly auth: "user";
+        readonly effect: "account-write";
+        readonly purpose: "Provision a device-scoped Frely API key for app agent tasks (shown once, capped at a lifetime spend limit; default $50, max $500).";
     }, {
-        readonly id: "mcp.stdio";
-        readonly usage: "frely mcp stdio [--workspace <path>]";
-        readonly auth: "mcp";
-        readonly effect: "local-execution";
-        readonly purpose: "Serve authorized local tools over stdio.";
+        readonly id: "app.tasks";
+        readonly usage: "frely app tasks [--json]";
+        readonly auth: "local";
+        readonly effect: "read";
+        readonly purpose: "List local agent tasks with status, merge state and budget usage.";
     }, {
         readonly id: "network";
         readonly usage: "frely network setup|status|find|use|logout [--json]";
         readonly auth: "network";
         readonly effect: "subcommand-dependent";
-        readonly purpose: "Access Frely Network using its separate setup and credentials.";
+        readonly purpose: "Access Frely Network (preview) using its separate setup and credentials.";
     }];
 };
 export declare function cliUsage(): string;