@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 +37 -16
- package/dist/index.js.map +2 -2
- package/dist/runner-serve.d.ts.map +1 -1
- package/package.json +1 -1
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.
|
|
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
|
|
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-
|
|
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
|
|
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-
|
|
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
|
|
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-
|
|
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: [
|
|
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
|
-
|
|
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 ? `
|
|
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}
|