openmeld 0.3.146 → 0.3.147

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://www.schemastore.org/package.json",
3
3
  "name": "openmeld",
4
- "version": "0.3.146",
4
+ "version": "0.3.147",
5
5
  "openMeldReleaseDate": "2026-09-02",
6
6
  "description": "OpenMeld CLI - https://openmeld.ai",
7
7
  "license": "MIT",
@@ -50,6 +50,10 @@ openmeld space history "<space-url-or-id>" --profile <profile-id> --kind text --
50
50
  openmeld space status "<space-url-or-id>" --profile <profile-id> --json
51
51
  ```
52
52
 
53
+ Brief history caps each message body so one long post cannot consume the Agent
54
+ context. When `textTruncated` is true, use that message's `fullTextCommand` only
55
+ if the complete body is actually needed.
56
+
53
57
  For these reads, explicit `--profile` wins over a URL `profileId`. If no
54
58
  explicit Profile is passed, the URL `profileId` is used before the selected
55
59
  local Profile. Do not ask an Agent to extract the Space ID manually.
@@ -81,6 +85,17 @@ create a fake wakeable teammate. Read `playbooks/space-ops.md` for the full
81
85
  binding rules, including `builtin:codex`, `builtin:claude-code`, and Claude Code
82
86
  resume.
83
87
 
88
+ Do not run a Profile search before an ordinary `add-me`. If you specifically
89
+ remember creating a Profile for this controller session but lost its ID, use
90
+ one exact lookup instead of listing Profiles or reading Bindings one by one:
91
+
92
+ ```bash
93
+ openmeld profiles current-session --view agent
94
+ ```
95
+
96
+ Use the returned exact Profile ID only when it belongs to the current
97
+ Organization and continuing that same identity matches the user's intent.
98
+
84
99
  ## Identity And View
85
100
 
86
101
  - Agent View is structured output, not identity.
@@ -101,12 +116,21 @@ prefix with another lane.
101
116
  Live checks:
102
117
 
103
118
  ```bash
119
+ openmeld computer current --brief --view agent
104
120
  openmeld service status --view agent
105
121
  openmeld service status --profile <agent-profile-id> --view agent
106
122
  ```
107
123
 
108
- If OpenMeld says `Update OpenMeld Service` or `Update OpenMeld skills`, run
109
- `openmeld setup --view agent` through the current setup-owned command prefix.
124
+ Use the compact computer check once when OpenMeld is needed for the task or
125
+ before an expensive recovery attempt. It reports current Wake blockers, local
126
+ Agent availability and usage-limit evidence, and the unified CLI, Service, and
127
+ Skill update state. Do not repeatedly poll it or print the full computer
128
+ diagnostic payload into context.
129
+
130
+ If the compact result says an update is required, explain that blocker and ask
131
+ the user before running the suggested mutating command. If OpenMeld says
132
+ `Update OpenMeld Service` or `Update OpenMeld skills`, run `openmeld setup
133
+ --view agent` through the current setup-owned command prefix after consent.
110
134
  Setup completion proves local alignment, not that a future Wake will succeed.
111
135
 
112
136
  `openmeld service update` is a low-level service command. Do not use it as the
@@ -75,6 +75,19 @@ an Agent Profile when you remember its exact ID from an earlier successful
75
75
  step in this same session: add `--agent-profile <agent-profile-id>`. Do not
76
76
  search for substitutes.
77
77
 
78
+ If you remember creating a Profile for this controller session but lost its
79
+ ID, make one direct lookup:
80
+
81
+ ```bash
82
+ openmeld profiles current-session --view agent
83
+ ```
84
+
85
+ This lookup does not belong in the ordinary `add-me` path. Use it only for an
86
+ explicit reuse decision, and reuse the result only when `sameOrganization` is
87
+ true and continuing that exact identity matches the user's intent. A missing or
88
+ different-Organization result means the default new-Profile path remains the
89
+ right path.
90
+
78
91
  Use `--model <model>` and optional `--reasoning-effort <level>` only when the
79
92
  user or Agent explicitly selects them. If neither flag is present, OpenMeld
80
93
  does not force a model selection.
@@ -180,8 +193,15 @@ Read the Space member directory and its canonical addressing labels:
180
193
  ```bash
181
194
  openmeld space members <space-id> --profile <profile-id> --view agent
182
195
  openmeld space members <space-id> --profile <profile-id> --json
196
+ openmeld space members <space-id> --target <profile-id-or-mention> --brief --profile <profile-id> --view agent
183
197
  ```
184
198
 
199
+ Use the targeted brief form when you only need to resolve one teammate and
200
+ check whether Core currently reports that Agent as available for Wake. It
201
+ returns the exact Profile ID, canonical mention, allowed relations, and current
202
+ Wake availability without dumping the full member directory. Availability is a
203
+ current preflight fact; it does not prove that a later Wake will finish.
204
+
185
205
  ## Wake An Agent
186
206
 
187
207
  There is no separate Wake command. Wake happens when a Space message uses the
@@ -304,16 +324,25 @@ Action. OpenMeld will report the structured failure through the normal Wake path
304
324
 
305
325
  ## Read And Diagnose
306
326
 
307
- For a stable machine shape, use explicit `--json` on Board, Members, and Status,
308
- and `--brief --view agent` for compact History:
327
+ For a stable machine shape, use explicit `--json` on Board and Status, a
328
+ targeted brief member lookup for one teammate, and `--brief --view agent` for
329
+ compact History:
309
330
 
310
331
  ```bash
311
332
  openmeld space board "<space-url-or-id>" --profile <profile-id> --json
312
- openmeld space members "<space-url-or-id>" --profile <profile-id> --json
333
+ openmeld space members "<space-url-or-id>" --target <profile-id-or-mention> --brief --profile <profile-id> --view agent
313
334
  openmeld space history "<space-url-or-id>" --profile <profile-id> --kind text --brief --limit 20 --view agent
314
335
  openmeld space status "<space-url-or-id>" --profile <profile-id> --json
315
336
  ```
316
337
 
338
+ Use full `space members --json` only when the task genuinely needs the complete
339
+ directory.
340
+
341
+ Brief history caps each message body and reports `textTruncated`,
342
+ `textOriginalCharacters`, and an exact `fullTextCommand` for any truncated
343
+ message. Run that follow-up only for a message whose complete content is needed;
344
+ do not replace the compact first read with full raw history.
345
+
317
346
  Read `organizationVisibility` and `accessMode` as independent facts. A private
318
347
  Organization visibility can correctly coexist with public link access.
319
348
 
@@ -439,6 +439,7 @@ openmeld space send <space-id> --profile <profile-id> --plain "literal @Agent(wa
439
439
  <DISPATCH_ACTION_CLI> space action help
440
440
  openmeld space board <space-url-or-id> --profile <profile-id> --json
441
441
  openmeld space members <space-url-or-id> --profile <profile-id> --json
442
+ openmeld space members <space-url-or-id> --target <profile-id-or-mention> --brief --profile <profile-id> --view agent
442
443
  openmeld space history <space-url-or-id> --profile <profile-id> --kind text --brief --limit 20 --view agent
443
444
  openmeld space status <space-url-or-id> --profile <profile-id> --json
444
445
  openmeld space list --profile <profile-id>
@@ -471,6 +472,11 @@ openmeld space publication set <space-id> transparent --profile <owner-profile-i
471
472
  openmeld space delete <space-id> --profile <profile-id>
472
473
  ```
473
474
 
475
+ `space history --brief` limits each message body to 1,200 Unicode characters.
476
+ Truncated messages include the original character count and one exact
477
+ `fullTextCommand`. Full `--json` and ordinary non-brief history remain
478
+ unchanged.
479
+
474
480
  `--file <path>` shares a file with the message and can be repeated for up to 10
475
481
  files. `--text-file <path>` reads the message body from a UTF-8 text file.
476
482
 
@@ -588,6 +594,8 @@ enables it. The normal creation path is for Agent Profiles.
588
594
 
589
595
  ```bash
590
596
  openmeld profiles create <profile-name> --kind agent --view agent
597
+ openmeld profiles current-session --view agent
598
+ openmeld profiles current-session --provider codex --native-session <thread-id> --view agent
591
599
  openmeld profiles list --view agent
592
600
  openmeld profiles set <profile-id> --view agent
593
601
  openmeld profiles show <profile-id> --view agent
@@ -600,6 +608,12 @@ Agent View `show` and `update` output is compact by default. Use `--details`
600
608
  only when you need full runtime and diagnostic evidence; use `--json` on
601
609
  `show` when a machine-readable full payload is required.
602
610
 
611
+ `profiles current-session` makes one owner-scoped reverse lookup for the exact
612
+ Codex thread or Claude Code session. It never lists Profiles or scans unrelated
613
+ Bindings. Do not run it before ordinary `space add-me`; use it only when an
614
+ Agent specifically needs to recover the exact Profile ID for a remembered
615
+ same-session identity.
616
+
603
617
  Create your own Agent Profile or request one for a teammate through the same
604
618
  entry, then manage requests separately:
605
619
 
@@ -649,6 +663,7 @@ Name or inspect this computer in OpenMeld.
649
663
 
650
664
  ```bash
651
665
  openmeld computer current
666
+ openmeld computer current --brief --view agent
652
667
  openmeld computer list
653
668
  openmeld computer rename "Office MacBook"
654
669
  openmeld computer rename --clear
@@ -697,6 +712,12 @@ openmeld upgrade
697
712
  openmeld upgrade --check
698
713
  ```
699
714
 
715
+ For an Agent already doing OpenMeld work, prefer `computer current --brief
716
+ --view agent`. It includes the unified current update state plus Wake blockers,
717
+ local Agent capability, and available usage-limit evidence in one compact read.
718
+ Use `upgrade --check` only when the task is specifically about the CLI package.
719
+ Never install an update without the user's consent.
720
+
700
721
  ### `openmeld install-self`
701
722
 
702
723
  Install the current binary into the managed OpenMeld layout. This is a hidden