@todoforai/tfa-surface 0.1.3 → 0.1.4

package/dist/cli.js

@@ -116,7 +116,7 @@ function resolveToken(opts = {}) {
 // package.json
 var package_default = {
   name: "@todoforai/tfa-surface",
-  version: "0.1.3",
+  version: "0.1.4",
   description: "TODOforAI surface CLI — see and drive what is shown in the user's live UI (describe, todo/panel views, renderer cards, surface render, controls). Replaces tfa-frontend. Reuses bridge credentials.",
   type: "module",
   bin: {
@@ -163,7 +163,8 @@ Discovery:
 
 Surfaces — a ref is a todo id, <todoId>:<alias> (a shown artifact, live) or an http(s) url:
   open overlay <todoId>                 The full-page todo (todos only).
-  open window  <ref>                    A floating preview window (any ref).
+  open window  <ref> [--detached]       A floating preview window (any ref); --detached: out of
+                                        the grid, own size, resizable. connect:/stream: refs always are.
   open panel   <view> [--todo <id>] [--url <url>]
                                         A todo's side panel: changes|agents|preview|browser|terminal
                                         (--todo defaults to $TODOFORAI_TODO_ID).
@@ -206,6 +207,7 @@ Examples:
   tfa-surface card add kpi-tile dashboards/kpi.html --title "KPI tile"
   tfa-surface open window 3f2a91...
   tfa-surface open window $TODOFORAI_TODO_ID:kpi     # a shown artifact, in its own window
+  tfa-surface open window connect:<deviceId>/zele   # a sign-in card for the user
   tfa-surface open card   $TODOFORAI_TODO_ID:kpi --title "Weekly KPIs" --group marketing
   tfa-surface open panel browser --url https://example.com
   tfa-surface close card weekly-kpis
@@ -291,7 +293,7 @@ function printDescribe(d) {
   console.log(`sidebar: ${d.sidebar}`);
   console.log(d.surfaces.length ? "surfaces:" : "surfaces: []");
   for (const s of d.surfaces) {
-    const flags = [s.focused ? "focused" : "", s.docked ? "docked" : "", s.view ?? "", s.group ? `in ${s.group}` : ""].filter(Boolean).join(", ");
+    const flags = [s.focused ? "focused" : "", s.docked ? "docked" : "", s.size ? `detached ${s.size.w}x${s.size.h}` : "", s.view ?? "", s.group ? `in ${s.group}` : ""].filter(Boolean).join(", ");
     const id = s.kind === "overlay" || s.id === s.ref ? "" : ` ${s.id}`;
     console.log(`  ${s.kind}${id}: ${s.ref}${flags ? `   ${flags}` : ""}${s.title ? `   # ${s.title}` : ""}`);
     if (s.browser)
@@ -319,6 +321,7 @@ async function main() {
       "api-url": { type: "string" },
       "api-token": { type: "string" },
       json: { type: "boolean", default: false },
+      detached: { type: "boolean", default: false },
       help: { type: "boolean", short: "h", default: false },
       version: { type: "boolean", default: false }
     },
@@ -356,11 +359,11 @@ async function main() {
     }
     case "open": {
       const [kind, arg] = args;
-      const usage = "usage: tfa-surface open overlay <todoId> | window <ref> | panel <view> [--todo <id>] [--url <url>] | card <ref> [--id <id>] [--title <t>] [--group <slug>]";
+      const usage = "usage: tfa-surface open overlay <todoId> | window <ref> [--detached] | panel <view> [--todo <id>] [--url <url>] | card <ref> [--id <id>] [--title <t>] [--group <slug>]";
       if (kind === "overlay" || kind === "window") {
         if (!arg)
           die(usage);
-        const result = await uiCall(ctx, "surface.open", { kind, ref: arg });
+        const result = await uiCall(ctx, "surface.open", { kind, ref: arg, ...values.detached && { detached: true } });
         console.log(ctx.json ? JSON.stringify(result) : `${result.created ? "opened" : "already open"} (${kind})`);
       } else if (kind === "panel") {
         if (!arg)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@todoforai/tfa-surface",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "TODOforAI surface CLI — see and drive what is shown in the user's live UI (describe, todo/panel views, renderer cards, surface render, controls). Replaces tfa-frontend. Reuses bridge credentials.",
   "type": "module",
   "bin": {