@notis_ai/cli 0.2.0-beta.178.1 → 0.2.0-beta.1792022492092.1

package/skills/notis-cli/AGENT_INSTRUCTIONS.md

@@ -1,7 +1,7 @@
 <!-- notis-cli:instructions:start -->
 ## Notis CLI
 
-Use the Notis CLI (`npx --package @notis_ai/cli@latest -- notis ...`) whenever the task involves the user's personal data or connected services: integrations (Gmail, Google Calendar, Notion, Slack, GitHub, ...), long-term memories, reminders, automations, native Notis databases and notes, public deep research, or Notis apps. Prefer it over telling the user to operate another app manually, and never treat a task as blocked merely because a capability is absent from the current tool list—reach it through the CLI.
+Use the Notis CLI (`npx --package @notis_ai/cli@latest -- notis ...`) whenever the task involves the user's personal data or connected services: integrations (Gmail, Google Calendar, Notion, Slack, GitHub, ...), long-term memories, reminders, automations, native Notis databases and notes, public deep research, or Notis Spaces and apps. Prefer it over telling the user to operate another app manually, and never treat a task as blocked merely because a capability is absent from the current tool list—reach it through the CLI.
 
 On a local machine, `notis login` authorizes a scoped, revocable OAuth profile in the browser. Notis Desktop may authorize that profile automatically, but the Desktop app does not need to remain running. Hosted Notis shells use `NOTIS_JWT`. Before acting on personal data, run `notis whoami` when the intended account or endpoint is not already clear.
 
@@ -15,7 +15,7 @@ Relevant Notis long-term memory may be injected into a turn inside `<notis_relev
 4. Execute: `notis tools exec <TOOL> --arguments '<json>'`; batch independent calls with `notis tools exec-parallel '<json-array>'`.
 5. If an integration is not connected, `notis tools link <toolkit>` prints a connection URL to give the user.
 
-Tool name shapes: `LOCAL_NOTIS_*` (native Notis), `LOCAL_NOTIS_DATABASE_*` (databases and notes), `LOCAL_MCP_*` (the user's connected MCP servers), and integration tools such as `GMAIL_*`, `NOTION_*`, and `GOOGLECALENDAR_*`.
+Tool name shapes: `LOCAL_NOTIS_*` (native Notis), `LOCAL_NOTIS_DATABASE_*` (databases and notes), `CUSTOM_*` (the user's remote MCP servers), `LOCAL_MCP_*` (MCP servers on the user's computer), and integration tools such as `GMAIL_*`, `NOTION_*`, and `GOOGLECALENDAR_*`.
 
 ### Main features
 
@@ -24,7 +24,7 @@ Tool name shapes: `LOCAL_NOTIS_*` (native Notis), `LOCAL_NOTIS_DATABASE_*` (data
 - **Automations:** `LOCAL_NOTIS_INSERT_AUTOMATION`, `LOCAL_NOTIS_UPDATE_AUTOMATION`, and `LOCAL_NOTIS_RUN_AUTOMATION` run an agent prompt on a cron schedule or event trigger; `LOCAL_NOTIS_LIST_INTEGRATION_TRIGGERS` lists triggers. Fixed text at a time is a reminder; work an agent must perform is an automation.
 - **Databases and notes:** `LOCAL_NOTIS_DATABASE_QUERY` reads; generated `LOCAL_NOTIS_DATABASE_UPSERT_<SLUG>` tools write rows; `LOCAL_NOTIS_DATABASE_UPSERT_DATABASE` creates or alters a schema. Discover the exact per-database tool names before use.
 - **Deep research:** `LOCAL_NOTIS_DEEP_SEARCH` performs public multi-source research.
-- **Notis apps:** Use the notis-apps skill and release-only workflow. App create/edit requests authorize Workspace deployment after checks on local and cloud computers. Explicit read-only, preview-only or no-deploy requests stop at local checks without remote mutations. Preserve exact app identity and deployment base. Verify the installed result. Store publication requires separate approval.
+- **Spaces and legacy apps:** Use the notis-apps skill's release workflow. For accounts moved to Spaces, source work uses `notis spaces`; `notis apps` is only for accounts that have not moved. Never use the legacy App path to modify a migrated Space. Create/edit requests authorize Workspace deployment after checks on local and cloud computers. Explicit read-only, preview-only or no-deploy requests stop at local checks without remote mutations. Preserve the exact Space or app identity and deployment base. Verify the installed result. Store publication requires separate approval.
 
 ### Rules
 

package/skills/notis-onboarding/BRIEF.md

@@ -94,9 +94,13 @@ through the connection and show them the actual result: today's calendar events,
 their most recent email threads, the databases in their Notion. A connected
 integration is a claim; their own data on screen is proof.
 
-If they connect nothing, fall back to installing a public app:
-`LOCAL_NOTIS_LIST_PUBLIC_APP_STORE`, then `LOCAL_NOTIS_INSTALL_APP` with
-`destination_type="personal"`.
+If they connect nothing, you may offer a Space from the Space Store instead, but
+only on an account that has the Store: it is not open to every account yet. Check
+with `notis spaces store list` first. If it answers that Spaces or the Store are
+not available for this account (`spaces_unavailable` or
+`spaces_store_unavailable`), skip this fallback without retrying and go to
+step 3. Otherwise install one with
+`notis spaces store install <listing-id> --request-id <stable-id>`.
 
 ## 3. Finish onboarding
 

package/src/command-specs/apps.js

@@ -935,6 +935,7 @@ async function appsScreenshotHandler(ctx) {
         sessionName: captureSessionName,
         screenshotPath: browserScreenshotPath,
         focusSelector: ctx.options.raw ? null : focus,
+        frameContent: !ctx.options.raw,
         width,
         height,
         timeoutMs: Number.parseInt(ctx.globalOptions.timeoutMs || '', 10) || 15_000,
@@ -949,7 +950,7 @@ async function appsScreenshotHandler(ctx) {
             height,
             accent: appConfig.accent,
             seed: appConfig.name || manifest.app?.name || appSlug,
-            focused: Boolean(focus),
+            focused: Boolean(result.framing?.focus_selector),
             theme: theme || 'light',
           });
         } catch (error) {

package/src/command-specs/auth.js

@@ -133,9 +133,9 @@ export const authCommandSpecs = [
   },
   {
     command_path: ['logout'],
-    summary: 'Revoke and remove the OAuth credential for one CLI profile.',
+    summary: 'Sign this computer out of one CLI profile: revoke and remove its OAuth credential.',
     when_to_use:
-      'Use this to disconnect a single account. Other profiles keep their credentials unless you pass --all-profiles.',
+      'Use this to disconnect a single account on this computer. Its sign-ins on other computers stay, and other profiles keep their credentials unless you pass --all-profiles.',
     args_schema: {
       arguments: [],
       options: [

package/src/command-specs/files.js

@@ -0,0 +1,29 @@
+import { uploadNativeRecordFileWithCliRuntime } from '../runtime/native-record-files.js';
+import { parseJson } from './helpers.js';
+import { usageError } from '../runtime/errors.js';
+
+export const filesCommandSpecs = [{
+  command_path: ['files', 'upload'],
+  summary: 'Upload a local file for one native record you can edit.',
+  when_to_use: 'Save file bytes without a cloud computer; attach the returned file reference through a normal revision-checked row update.',
+  args_schema: { arguments: [{ token: '<file>', key: 'file', description: 'Local regular file up to 8 MB.' }], options: [
+    { flags: '--target <json>', description: 'Exact native target returned by schema discovery.' },
+    { flags: '--record-key <id>', description: 'Stable record key to attach this file to.' },
+    { flags: '--schema-revision <number>', description: 'Current native schema revision.' },
+    { flags: '--request-id <uuid>', description: 'Stable UUID; reuse with identical bytes after an uncertain response.' },
+    { flags: '--name <name>', description: 'Attachment name; defaults to the local basename.' },
+    { flags: '--content-type <mime>', description: 'File MIME type; inferred from known extensions.' },
+  ] },
+  examples: ['notis files upload ./report.html --target \'{"database_id":"<database-id>"}\' --record-key <record-key> --schema-revision 1 --request-id <uuid>'],
+  mutates: true, idempotent: true, require_auth: true,
+  backend_call: { type: 'http', path: '/portal_native_files/upload' },
+  async handler(ctx) {
+    if (!ctx.options.target || ctx.options.schemaRevision === undefined) throw usageError('Pass the discovered native --target and --schema-revision.');
+    const result = await uploadNativeRecordFileWithCliRuntime({ runtime: ctx.runtime, filePath: ctx.args.file,
+      target: parseJson(ctx.options.target, '--target'), recordKey: ctx.options.recordKey,
+      schemaRevision: Number(ctx.options.schemaRevision), requestId: ctx.options.requestId,
+      ...(ctx.options.name ? { name: ctx.options.name } : {}), ...(ctx.options.contentType ? { contentType: ctx.options.contentType } : {}) });
+    return ctx.output.emitSuccess({ command: 'files upload', data: result,
+      humanSummary: 'Uploaded and verified the file. Attach the returned file reference with a revision-checked record update.', meta: { mutating: true } });
+  },
+}];