@phnx-labs/agents-cli 1.22.35 → 1.22.38

package/dist/commands/setup.js

@@ -20,7 +20,7 @@ import { ensureShimCurrent, switchHomeFileSymlinks, isShimsInPath, addShimsToPat
 import { setHelpSections } from '../lib/help.js';
 import { registerSetupBrowserCommand, runBrowserWizard } from './setup-browser.js';
 import { registerSetupComputerCommand, runComputerWizard } from './setup-computer.js';
-import { registerSetupShareCommand, runShareWizard } from './setup-share.js';
+import { runShareWizard } from './artifacts-setup.js';
 import { registerSetupMineCommand } from './setup-mine.js';
 import { registerSetupSecretsCommand } from './setup-secrets.js';
 import { registerSetupFleetCommand } from './setup-fleet.js';
@@ -131,6 +131,20 @@ export async function runSetup(program, options = {}) {
             spinner.succeed(`Cloned ${systemRepoSlug(systemRepo)} (${result.commit})`);
         }
     }
+    try {
+        const enabled = options.isDaemonEnabledFn
+            ? options.isDaemonEnabledFn()
+            : (await import('../lib/device-config.js')).isDaemonEnabled();
+        if (enabled) {
+            const start = options.startDaemonFn
+                ?? (await import('../lib/daemon.js')).startDaemon;
+            const started = start();
+            if (started.method !== 'already-running' && started.pid) {
+                console.log(chalk.gray(`Started the always-on agents daemon (pid ${started.pid}).`));
+            }
+        }
+    }
+    catch { /* best effort */ }
     // Populate the device registry from the tailnet on first setup. Soft mode is
     // guaranteed non-throwing (no tailscale / corrupt file / lock contention all
     // resolve to ok:false), so this can never block setup.
@@ -195,6 +209,18 @@ export async function runSetup(program, options = {}) {
             }
         }
     }
+    // Register the agents:// URL scheme so deep links in rendered artifacts can
+    // resume a session (RUSH — session deep links). Best-effort and idempotent:
+    // never fails setup, only registers when missing.
+    try {
+        const { registerAgentsUrlScheme } = await import('../lib/deeplink/register.js');
+        const scheme = registerAgentsUrlScheme({ ifMissing: true });
+        if (scheme.registered)
+            console.log(chalk.gray('Registered the agents:// URL scheme (artifact session deep links).'));
+    }
+    catch {
+        // non-fatal — the user can run `agents open register` later.
+    }
     if (options.suppressFooter)
         return;
     // Fresh-machine hub: offer to set up the optional capabilities that need their
@@ -329,10 +355,11 @@ export function registerSetupCommand(program) {
         .description('Set up agents-cli, or re-open the capability onboarding hub.')
         .option('-f, --force', 'Re-run setup even if ~/.agents/.system/ already exists (use with caution)')
         .option('--no-system-repo', 'Skip cloning the system repo (you must populate ~/.agents/.system/ yourself)');
-    // Capability subcommands: `agents setup browser|computer|share|mine|secrets|fleet`.
+    // Capability subcommands: `agents setup browser|computer|mine|secrets|fleet`.
+    // Share/artifact publishing is set up by `agents artifacts setup` (RUSH-2580);
+    // the hub below still offers it as a phase via runShareWizard.
     registerSetupBrowserCommand(setupCmd);
     registerSetupComputerCommand(setupCmd);
-    registerSetupShareCommand(setupCmd);
     registerSetupMineCommand(setupCmd);
     registerSetupSecretsCommand(setupCmd);
     registerSetupFleetCommand(setupCmd);
@@ -360,7 +387,6 @@ export function registerSetupCommand(program) {
       # Set up a specific capability on its own
       agents setup browser
       agents setup computer
-      agents setup share
       agents setup secrets
       agents setup fleet
       agents setup watchdog
@@ -375,7 +401,7 @@ export function registerSetupCommand(program) {
       Capability setup can also be run any time on its own:
         agents setup browser    # detect a browser + create the default profile
         agents setup computer    # install the signed macOS helper + grant permissions
-        agents setup share       # provision or join a Cloudflare share endpoint
+        agents artifacts setup   # provision or join a Cloudflare share endpoint
         agents setup secrets     # choose secrets backend/policy defaults + import
         agents setup fleet       # discover Tailscale devices + configure SSH access
         agents setup watchdog    # choose which devices run the daemon watchdog pass

package/dist/commands/share.d.ts

@@ -1,8 +1,55 @@
 import type { Command } from 'commander';
+import { type ShareConfig } from '../lib/share/config.js';
 import { type CloudflareRequester } from '../lib/share/provision.js';
 import { type PublishResult } from '../lib/share/publish.js';
 import { deleteShare, type DeleteShareResult } from '../lib/share/delete.js';
 export declare function formatSharePublishResult(result: PublishResult, json?: boolean): string;
+/** Compare the configured endpoint's last-deployed template hash against the
+ * hash of the CURRENT `worker-template.ts` render. A config with no recorded
+ * hash (every endpoint provisioned before this field existed) is "unknown" —
+ * never "current" or "outdated", since there is nothing to compare against. */
+export declare function shareTemplateStatus(cfg: ShareConfig): 'current' | 'outdated' | 'unknown';
+/** One published object as reported by the Worker's `?format=json` listing route. */
+export interface ShareListItem {
+    slug: string;
+    url: string;
+    /** Object size in bytes. */
+    size: number;
+    /** Stored content type, or null if the Worker had none recorded. */
+    contentType: string | null;
+    /** ISO timestamp the object was last written (R2 `uploaded`). */
+    publishedAt: string;
+    /** ISO auto-expire timestamp, or null for a permanent share. */
+    expiresAt: string | null;
+}
+export interface ShareListResult {
+    /** The namespace listed. */
+    user: string;
+    count: number;
+    objects: ShareListItem[];
+}
+/** DI seam for tests — override the real HTTP GET of the JSON listing route. */
+export type ListingFetchFn = (url: string) => Promise<{
+    status: number;
+    contentType: string;
+    body: string;
+}>;
+/** Parse the Worker's listing JSON into a validated result, failing loud (with the
+ * outdated-template hint) on any body that isn't the expected shape — an old Worker
+ * serves the HTML gallery for a non-empty namespace, which must not be silently
+ * accepted as "you have published nothing". */
+export declare function parseShareListing(user: string, body: string): ShareListResult;
+/** Fetch and parse the machine-readable listing of the caller's namespace from the
+ * Worker's `?format=json` route. Fails loud when share was never configured, when
+ * the deployed template is known-outdated (RUSH-2449 templateHash), or when the
+ * live response proves the route is absent (404 or a non-JSON 200 = the old HTML
+ * gallery) — never a silent empty/wrong result. */
+export declare function runShareList(opts?: {
+    githubUser?: string;
+    config?: ShareConfig;
+    fetchListing?: ListingFetchFn;
+}): Promise<ShareListResult>;
+export declare function formatShareList(result: ShareListResult, json?: boolean): string;
 export declare function formatShareDeleteResult(result: DeleteShareResult, json?: boolean): string;
 interface ShareDeleteCliOpts {
     keepCover?: boolean;
@@ -10,8 +57,8 @@ interface ShareDeleteCliOpts {
     githubUser?: string;
     json?: boolean;
 }
-/** Shared handler for `agents share delete <targets...>` and the top-level
- * `agents unshare <targets...>` alias. Deletes each target independently and
+/** Shared handler for `agents artifacts share delete <targets...>` and the
+ * top-level `agents unshare <targets...>` alias. Deletes each target independently and
  * continues past a failed one (rm-style), reporting all results and exiting
  * non-zero if any target failed to verify as gone.
  *
@@ -19,10 +66,23 @@ interface ShareDeleteCliOpts {
  * never exposed as a CLI flag, only used to inject a fake config/checker/deleter
  * without touching the keychain or a live endpoint. */
 export declare function runShareDelete(targets: string[], opts: ShareDeleteCliOpts, deleteFn?: typeof deleteShare): Promise<void>;
-export declare function registerShareCommands(program: Command): void;
+/**
+ * Register the `share` subtree under its parent group — `agents artifacts share`
+ * (see commands/artifacts.ts). The top-level `agents unshare` alias is a sibling
+ * registration on the ROOT program, so it is {@link registerUnshareCommand}, not
+ * part of this subtree.
+ */
+export declare function registerShareCommands(artifactsCmd: Command): void;
+/**
+ * Register the top-level `agents unshare <targets...>` alias of
+ * `agents artifacts share delete`. It takes the ROOT program (not the artifacts
+ * group) because it is deliberately a top-level convenience verb — taking a page
+ * down is the one artifact action typed often enough to keep at the root.
+ */
+export declare function registerUnshareCommand(program: Command): void;
 /** Provision a fresh R2 bucket + Worker on the user's Cloudflare and persist the
- * endpoint config + write token. Shared by `agents share setup` and the unified
- * `agents setup share` wizard. */
+ * endpoint config + write token. Shared by both modes of `agents artifacts setup`
+ * (the flag-driven provision and the interactive wizard). */
 export declare function runShareProvision(opts: {
     bundle: string;
     worker: string;
@@ -33,9 +93,29 @@ export declare function runShareProvision(opts: {
     analyticsToken?: string;
     request?: CloudflareRequester;
 }): Promise<void>;
+export interface ShareUpdateResult {
+    updated: boolean;
+    templateHash: string;
+    baseUrl: string;
+    workerName: string;
+}
+/** Re-deploy the Worker script on an ALREADY-provisioned endpoint to match the
+ * current `worker-template.ts`. Reuses the existing account/worker/bucket and
+ * write token from `readShareConfig()`/the `share` bundle — never creates a
+ * bucket, touches routes/domains, or regenerates the token (see
+ * `updateWorker` in `lib/share/provision.ts` for how the token survives the
+ * re-upload). Idempotent: no-ops when the deployed hash already matches
+ * unless `force`. */
+export declare function runShareUpdate(opts?: {
+    bundle?: string;
+    account?: string;
+    token?: string;
+    force?: boolean;
+    request?: CloudflareRequester;
+}): Promise<ShareUpdateResult>;
 /** Join an existing share endpoint (no provisioning): prompt for the endpoint
- * details + write token and persist them. Shared by `agents share join` and the
- * unified `agents setup share` wizard. */
+ * details + write token and persist them. Shared by `agents artifacts share join`
+ * and the `agents artifacts setup` wizard. */
 export declare function runShareJoin(baseUrl?: string, opts?: {
     token?: string;
 }): Promise<void>;