@rosthq/cli 0.7.3 → 0.7.4

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/dist/index.js CHANGED
@@ -41885,7 +41885,7 @@ The Compass is drafted, then activated by a human through supersession.
41885
41885
  order: 15,
41886
41886
  title: "AICOS chat guide",
41887
41887
  summary: "How the AI Chief of Staff chat works in the authenticated app shell and what it can safely do today.",
41888
- version: "2026-07-02.8",
41888
+ version: "2026-07-02.9",
41889
41889
  public: true,
41890
41890
  audiences: ["human", "in_app_agent"],
41891
41891
  stages: ["company_setup", "operating_rhythm"],
@@ -41920,7 +41920,7 @@ In the authenticated app shell, AICOS opens from the floating assistant control.
41920
41920
  Each thread has a purpose:
41921
41921
 
41922
41922
  - **Onboarding** \u2014 setup help and page-aware setup context.
41923
- - **Seat** \u2014 seat and agent setup context.
41923
+ - **Seat** \u2014 a seat-scoped assistant pinned to one seat (see "Seat-scoped AICOS" below).
41924
41924
  - **General** \u2014 company operating help.
41925
41925
 
41926
41926
  You can reopen prior threads, search thread titles and summaries, or start a new one. Session history is stored in tenant-scoped conversation tables so chat history is not reconstructed from analytics, events, or run logs.
@@ -41945,6 +41945,12 @@ During onboarding, the deterministic harness may execute only explicit low-risk
41945
41945
 
41946
41946
  AICOS posture is resolved on the server from the current user's AICOS access scope plus the tenant's Company guardrails. **Report-only** can read, explain, and draft guidance, but it cannot mutate setup or operating state. **Balanced** can perform narrow low-risk internal draft/setup actions and stops at human gates. **High autonomy** can perform allowed internal low-risk actions without changing the hard prohibitions: AICOS still cannot approve its own Charter or manifest, handle credentials, send externally, spend money, perform destructive/admin changes, go live, expand policy/access, or receive hidden sensitive data.
41947
41947
 
41948
+ ## Seat-scoped AICOS
41949
+
41950
+ From a seat page you can open **AICOS scoped to that seat** ("Ask AICOS about this seat"). A seat session is pinned to one seat and reads only that seat plus the seats it directly stewards \u2014 what needs attention there, what is blocked, and which tasks, Friction, Signals, goals, or approvals need action. The chat header shows **Seat: <name>** so it is always clear whether you are talking to Company AICOS or a Seat AICOS.
41951
+
41952
+ Seat mode is the **intersection** of your access scope and one seat, never an escalation: it can only ever show a narrower slice than your company or own-scope session, and it can never reach data your base scope would already deny. The seat is resolved from the session (pinned when it was opened), re-authorized on the server every turn against your current occupancies and stewardship \u2014 a manually supplied seat id in a turn is ignored, a seat from another tenant or one you are not authorized over is indistinguishable from not-found, and if your occupancy or stewardship ends the session falls back to your base scope rather than widening. Setup-limited access does not get seat operating data. Drafted seat actions stay scoped to the session's seat and remain human-gated where required.
41953
+
41948
41954
  AICOS grounds answers from three source classes before producing user-visible setup or operating guidance:
41949
41955
 
41950
41956
  - **Reference documents** \u2014 public {{brand}} guides such as this chat guide, onboarding guidance, the Responsibility Graph playbook, tool-access guidance, and confirmation guidance. AICOS retrieves the narrowest relevant guide before setup, Charter, Signal, Friction, Cascade, Sync, tool-access, or onboarding advice.
@@ -42746,7 +42752,7 @@ External connectors are being rolled out provider by provider, conservatively (r
42746
42752
  order: 48,
42747
42753
  title: "CLI and MCP installation guide",
42748
42754
  summary: "Install the public CLI, register remote token-backed MCP clients, and find the full command and tool catalog.",
42749
- version: "2026-07-02.7",
42755
+ version: "2026-07-03.1",
42750
42756
  public: true,
42751
42757
  audiences: ["human", "cli", "mcp", "in_app_agent"],
42752
42758
  stages: ["company_setup", "staffing"],
@@ -43271,8 +43277,8 @@ These read-only tools are available to any valid MCP token (like the reference t
43271
43277
 
43272
43278
  | Tool | Purpose | Scope | Safe example |
43273
43279
  |---|---|---|---|
43274
- | \`rost_describe_command\` | Return a command's input/output JSON Schema, scope, confirmation gate, help pointer, guides, a validated example, and related commands. | Any valid MCP token | Query \`{"command_id":"compass.draft"}\` |
43275
- | \`rost_list_commands\` | List every callable command id with its title, scope, confirmation, and stages. | Any valid MCP token | Call with \`{}\` |
43280
+ | \`rost_describe_command\` | Return a command's input/output JSON Schema, scope, confirmation gate, MCP tool name, help pointer, guides, a validated example, and related commands. | Any valid MCP token | Query \`{"command_id":"compass.draft"}\` |
43281
+ | \`rost_list_commands\` | List callable command ids in bounded pages with title, scope, confirmation, stages, and MCP tool name when callable. Supports \`q\`, \`category\`, \`stage\`, \`limit\`, and \`cursor\`. | Any valid MCP token | Query \`{"q":"status","limit":10}\` |
43276
43282
 
43277
43283
  The equivalent CLI verbs are \`{{cli}} command schema <id>\` and \`{{cli}} command list\`. The discoverable tool catalog is \`{{cli}} tools list\` (MCP \`rost_list_tool_catalog\`, tenant-scoped).
43278
43284
 
@@ -43281,7 +43287,7 @@ The equivalent CLI verbs are \`{{cli}} command schema <id>\` and \`{{cli}} comma
43281
43287
  | Tool or resource | Purpose | Scope | Safe example |
43282
43288
  |---|---|---|---|
43283
43289
  | \`rost_reference_search\` | Search public reference guides. | Any valid MCP token | Query \`{"query":"agent-reference-map","audience":"mcp"}\` |
43284
- | \`rost_reference_get\` | Retrieve a public guide by slug. | Any valid MCP token | Query \`{"slug":"agent-reference-map"}\` |
43290
+ | \`rost_reference_get\` | Retrieve a bounded public guide payload by slug, or one requested section by section id/title. The response includes available \`sections\` for follow-up reads. | Any valid MCP token | Query \`{"slug":"agent-reference-map","section":"mcp-surfaces"}\` |
43285
43291
  | \`rost://reference/{slug}\` | Read a public reference guide as a resource. | Any valid MCP token | Resource \`rost://reference/mcp-and-cli-guide\` |
43286
43292
 
43287
43293
  ### Tenant-admin tools
@@ -43809,7 +43815,7 @@ Set \`ROST_SKILL_INSTALL_ROOT\` only for a sandbox or CI override. Local copies
43809
43815
  order: 55,
43810
43816
  title: "Agent reference map",
43811
43817
  summary: "Where CLI sessions, MCP clients, and in-app agents should retrieve {{brand}} guidance before recommending setup changes.",
43812
- version: "2026-07-02.3",
43818
+ version: "2026-07-03.1",
43813
43819
  public: true,
43814
43820
  audiences: ["cli", "mcp", "in_app_agent"],
43815
43821
  stages: ["company_setup", "graph_design", "charter_design", "staffing", "operating_rhythm"],
@@ -43845,7 +43851,7 @@ Use this map when you are a CLI session, MCP client, or in-app agent and need to
43845
43851
  - Reference resource template: rost://reference/{slug}
43846
43852
  - Operation resources (read-only, scope-enforced): rost://tenant/status, rost://graph, rost://seat/{id}/context, rost://compass/current, rost://sync/latest, rost://skills, rost://skills/{slug}, rost://skills/{slug}/files/{path}, rost://seat/{id}/skills, rost://operations/reference-map
43847
43853
 
43848
- Start with rost_reference_search when the user asks a broad question. Use rost_reference_get when a workflow or command metadata already names a guide slug. Read the operation resources to load current tenant/seat facts before mutating; tenant-wide resources need a tenant-admin token and a seat token may read only its own rost://seat/{id}/context.
43854
+ Start with rost_reference_search when the user asks a broad question. Use rost_reference_get when a workflow or command metadata already names a guide slug; pass a section id/title to read one bounded section when the guide is large. Read the operation resources to load current tenant/seat facts before mutating; tenant-wide resources need a tenant-admin token and a seat token may read only its own rost://seat/{id}/context.
43849
43855
 
43850
43856
  ## CLI surface
43851
43857
 
@@ -43857,8 +43863,8 @@ Start with rost_reference_search when the user asks a broad question. Use rost_r
43857
43863
 
43858
43864
  Never guess a command's JSON shape. Before calling a command that changes state, read its exact contract:
43859
43865
 
43860
- - List every callable command: {{cli}} command list (CLI) or rost_list_commands (MCP)
43861
- - Read one command's exact input/output schema, help pointer, and a worked example: {{cli}} command schema <id> (CLI) or rost_describe_command with {"command_id":"<id>"} (MCP)
43866
+ - List callable commands: {{cli}} command list (CLI) or rost_list_commands (MCP, bounded pages with q/category/stage/limit/cursor filters)
43867
+ - Read one command's exact input/output schema, help pointer, MCP tool name, and a worked example: {{cli}} command schema <id> (CLI) or rost_describe_command with {"command_id":"<id>"} (MCP)
43862
43868
  - List the tool catalog the agent builder reads (id, scope tiers, credential requirement, access policy, and execution-boundary guidance): {{cli}} tools list (CLI) or rost_list_tool_catalog (MCP)
43863
43869
  - List guided model tiers before choosing --model (recommended default, effort, token prices, cost bands, best-fit work, model id): {{cli}} model list (CLI) or rost_list_model_catalog (MCP)
43864
43870
  - Show a Compass, Charter, or agent setup as a markdown card to review with your human: {{cli}} compass show --markdown, {{cli}} charter show --seat-id <id> --markdown, {{cli}} agent show --seat-id <id> --markdown
@@ -44568,7 +44574,7 @@ Agents may explain which setting is needed and why. They should not ask users to
44568
44574
  order: 73,
44569
44575
  title: "Members and invites guide",
44570
44576
  summary: "How to invite humans into the company without confusing user access with seat accountability.",
44571
- version: "2026-07-02.2",
44577
+ version: "2026-07-03.1",
44572
44578
  public: true,
44573
44579
  audiences: ["human", "cli", "mcp", "in_app_agent"],
44574
44580
  stages: ["company_setup", "staffing"],
@@ -44593,7 +44599,7 @@ Invite the person as a tenant member. Then assign them to one or more seats only
44593
44599
 
44594
44600
  Tenant roles control app access. Seats control operating accountability. Do not attach goals, tasks, or measurables directly to a user when the work belongs to a seat.
44595
44601
 
44596
- Owners and admins can invite people and manage member roles. Use \`external_implementer\` plus setup-limited access for a temporary implementation partner helping configure onboarding, Responsibility Graph, Compass, Charters, and agent setup. Do not grant external implementers sensitive run history, hidden tool arguments, credentials, Memory, or company-operating data unless an owner explicitly expands their profile.
44602
+ Owners and admins can invite people and manage member roles. Use \`external_implementer\` plus setup-limited access for a temporary implementation partner helping configure onboarding, Responsibility Graph, Compass, Charters, and agent setup. Setup-limited access is intentionally not enough for sensitive operating surfaces: Settings member/invite/token/runner/credential metadata, run and tool-call history, runner diagnostics, integration metadata and tests, system health, Signal operating data, and owner/operating pages require owner/admin or full setup access. Do not grant external implementers sensitive run history, hidden tool arguments, credentials, Memory, or company-operating data unless an owner explicitly expands their profile.
44597
44603
 
44598
44604
  ## Working across several client companies
44599
44605
 
@@ -49051,6 +49057,11 @@ import path3 from "node:path";
49051
49057
  import { setTimeout as sleep2 } from "node:timers/promises";
49052
49058
  import { promisify as promisify3 } from "node:util";
49053
49059
  var execFile3 = promisify3(execFileCallback3);
49060
+ var RUNNER_CHARTER_LOAD_TOOLS = [
49061
+ "mcp__rost__rost_get_context",
49062
+ "mcp__rost__rost_report_status",
49063
+ "mcp__rost__rost_get_tasks"
49064
+ ];
49054
49065
  async function runRunnerServe(options) {
49055
49066
  const env = options.env ?? process.env;
49056
49067
  const fetchImpl = options.fetchImpl ?? fetch;
@@ -49321,7 +49332,17 @@ function buildTurnCommand(runtime, prompt, configPath) {
49321
49332
  }
49322
49333
  return {
49323
49334
  command: "claude",
49324
- args: ["-p", prompt, "--mcp-config", configPath, "--strict-mcp-config", "--output-format", "text"]
49335
+ args: [
49336
+ "-p",
49337
+ prompt,
49338
+ "--mcp-config",
49339
+ configPath,
49340
+ "--strict-mcp-config",
49341
+ "--allowedTools",
49342
+ RUNNER_CHARTER_LOAD_TOOLS.join(","),
49343
+ "--output-format",
49344
+ "text"
49345
+ ]
49325
49346
  };
49326
49347
  }
49327
49348
  async function spawnRunnerTurn(appUrl2, workOrder, runtime) {
@@ -49334,14 +49355,14 @@ async function spawnRunnerTurn(appUrl2, workOrder, runtime) {
49334
49355
  work_order_id: workOrder.id,
49335
49356
  task_id: workOrder.task_id ?? null,
49336
49357
  seat: workOrder.seat ?? null,
49337
- charter: workOrder.charter ?? null,
49338
- permission_manifest: workOrder.permission_manifest ?? null,
49358
+ charter_ref: workOrder.charter_ref ?? null,
49339
49359
  aicos: workOrder.aicos ?? null
49340
49360
  };
49341
49361
  const hasAicosContext = typeof workOrder.aicos === "object" && workOrder.aicos !== null;
49342
49362
  const prompt = [
49343
- hasAicosContext ? `Load your ${cliBrand.name} context, answer the AICOS user turn using only seat-authorized context and tools, and stop.` : `Load your ${cliBrand.name} context, report one read-only status, and stop.`,
49363
+ hasAicosContext ? `Call rost_get_context first to load your full ${cliBrand.name} charter, answer the AICOS user turn using only seat-authorized context and tools, and stop.` : `Call rost_get_context first to load your full ${cliBrand.name} charter, report one read-only status, and stop.`,
49344
49364
  "Do not call external systems or mutating tools.",
49365
+ "The work order includes only a compact charter pointer; rost_get_context is the canonical full charter load path.",
49345
49366
  `Claimed work order context: ${JSON.stringify(context).slice(0, 8e3)}`
49346
49367
  ].join("\n");
49347
49368
  await writeFile2(configPath, `${mcpConfig}