@soku-ai/cli 0.1.0-alpha.18 → 0.1.0-alpha.19

package/dist/commands/live-surface.js

@@ -0,0 +1,96 @@
+/** `soku live open | list | revoke | rotate-credential`
+ *
+ * A live surface is a link you hand to a person. They open it in their own
+ * browser and watch the resource change as you work on it, edit it themselves,
+ * and clear the writes that need a human.
+ *
+ * The approval credential is printed once, by `open` and `rotate-credential`,
+ * and never appears in the URL. That separation is the whole point: a link
+ * travels — forwarded, pasted, screenshotted — and a credential travelling with
+ * it would prove nothing while looking like proof. What gets recorded as
+ * "who approved this" depends on it.
+ */
+import { apiRequest } from '../http/client.js';
+import { bold, dim, emitSuccess, table } from '../output/envelope.js';
+export function registerLiveSurfaceCommands(program) {
+    // `live`, not `live-surfaces`. The page a person opens is at `/live/<handle>`,
+    // so that is the word they already have for this; `live-surfaces` is the
+    // internal table's name leaking onto the command line. The server route
+    // stays `/api/cli/live-surfaces` — it is deployed, and nothing is served by
+    // renaming a path nobody types.
+    const surfaces = program
+        .command('live')
+        .description('Hand someone a live link to a canvas you are working on');
+    surfaces
+        .command('open <resource-id>')
+        .description('Open a link for a resource and print it with its approval code')
+        .option('--type <type>', "Resource kind (default: 'remix_project')", 'remix_project')
+        .option('--read-only', 'Let them watch but not edit')
+        .option('--no-approvals', 'Do not issue an approval code for this link')
+        .option('--ttl-hours <hours>', 'How long the link stays usable (default 12, max 168)')
+        .action(async (resourceId, opts) => {
+        const data = await apiRequest('/api/cli/live-surfaces', {
+            method: 'POST',
+            workspace: true,
+            body: {
+                resource_type: opts.type,
+                resource_id: resourceId,
+                writable: !opts.readOnly,
+                approvable: opts.approvals,
+                ...(opts.ttlHours ? { ttl_hours: Number(opts.ttlHours) } : {}),
+            },
+        });
+        emitSuccess(data, (d) => {
+            const lines = [bold('Link  ') + d.url];
+            if (d.expiresAt)
+                lines.push(dim('Expires ') + d.expiresAt);
+            if (d.approvalCredential) {
+                lines.push('');
+                lines.push(bold('Approval code  ') + d.approvalCredential);
+                // Printed on its own line, away from the URL, because the two must
+                // reach the person by different routes.
+                lines.push(dim(d.approvalCredentialNote ?? 'Give this to the person, not the link.'));
+            }
+            return lines.join('\n');
+        });
+    });
+    surfaces
+        .command('list <resource-id>')
+        .description('Links still open on a resource, so you do not hand out a second one')
+        .option('--type <type>', "Resource kind (default: 'remix_project')", 'remix_project')
+        .action(async (resourceId, opts) => {
+        const query = `?resource_id=${encodeURIComponent(resourceId)}&resource_type=${encodeURIComponent(opts.type)}`;
+        const data = await apiRequest(`/api/cli/live-surfaces${query}`, { workspace: true });
+        emitSuccess(data, (d) => table(d.surfaces.map((s) => ({
+            url: s.url,
+            can: s.capabilities.join(','),
+            origin: s.origin,
+            expires: s.expiresAt ?? '',
+        })), [
+            { key: 'url', header: 'URL' },
+            { key: 'can', header: 'CAN' },
+            { key: 'origin', header: 'OPENED BY' },
+            { key: 'expires', header: 'EXPIRES' },
+        ]));
+    });
+    surfaces
+        .command('revoke <handle>')
+        .description('Kill a link. Anyone still holding it loses access immediately')
+        .action(async (handle) => {
+        emitSuccess(await apiRequest(`/api/cli/live-surfaces/${encodeURIComponent(handle)}`, {
+            method: 'DELETE',
+            workspace: true,
+        }), () => 'Revoked.');
+    });
+    surfaces
+        .command('rotate-credential <handle>')
+        .description('Issue a fresh approval code, leaving the link itself alive')
+        .action(async (handle) => {
+        const data = await apiRequest(`/api/cli/live-surfaces/${encodeURIComponent(handle)}/approval-credential`, { method: 'POST', workspace: true });
+        // Rotating is for a code that reached the wrong person. Killing the link
+        // as well would cost the right person their work surface for someone
+        // else's mistake, so the two are separate commands.
+        emitSuccess(data, (d) => bold('New approval code  ') + d.approvalCredential);
+    });
+}
+//# sourceMappingURL=live-surface.js.map

package/dist/commands/live-surface.js.map

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