@audienti/cli 0.2.0-exora.1 → 0.2.0-exora.11

package/skills/getting-started/references/reply-checks.md

@@ -0,0 +1,54 @@
+# Mailbox checks
+
+Audienti never signs in to your user's mailbox. You send from it through your own email
+connector (Gmail or Outlook, through Composio, a Claude connector or similar), so you also
+prove it works and read it for replies. Two queue tasks ask for that. If you have no email
+connector, tell your user exactly: "I need a Gmail or Outlook connector to send from your
+mailbox." Never send them to Settings to connect a mailbox.
+
+## The test email (`mailbox.confirm`)
+
+A mailbox counts for campaigns only once you sent a test email from it to itself, read it
+back and reported its code. [The mailbox test email](mailbox-check.md) gives the steps. Your
+user does nothing in that check. It proves the mailbox sends and that you can read its
+inbox, which the reply checks below need too.
+
+## The reply check (`replies.check`)
+
+Before any next step goes to someone you emailed, in a campaign or not, Audienti asks you to
+check the mailbox the email went out from for their reply. Until you report each person, no
+next step is planned or sent for them. Each task lists at most 100 people in `waiting`, each
+with `person`, `name`, `participation` (null when the step is in no campaign), `attempt`
+(the email) and `sentAt` (when it went out). A task for a mailbox you confirm is assigned to
+you.
+While you hold the task, its list stays as it was when you claimed it, even after a reply
+you record. Report everyone on it.
+
+1. Claim the task.
+2. Search the mailbox with your connector for mail from the listed people since their
+   `sentAt` only. Do not read anything else.
+3. Record each reply you find the way you record any reply: `audienti prospects
+   conversation append PERSON --workspace ID --file ITEM.json` with `direction: inbound`
+   and `conversationType: direct`. It returns the evidence id. Audienti then ends the
+   person's wait, holds their sends and gives you a reply task, as for any reply.
+4. Report every listed person:
+
+```json
+{
+  "results": [
+    { "kind": "email.no_reply", "person": "PERSON_ID" },
+    { "kind": "email.reply", "person": "PERSON_ID", "evidence": "EVIDENCE_ID" }
+  ]
+}
+```
+
+```sh
+audienti outcomes report TASK_ID --file RESULTS.json
+```
+
+5. Report the task done. If you cannot read the mailbox now, release the task with a note.
+
+An `email.reply` whose evidence is not an inbound message of that person is not recorded
+(`reply_not_recorded`): record the reply first. A person you leave out comes back on the
+next check, about an hour later. Reporting the same person again for the same email returns
+`already_recorded`.

package/skills/playbook-design/SKILL.md

@@ -0,0 +1,136 @@
+---
+name: playbook-design
+description: Create, reuse or revise an Audienti playbook, the stages and steps a prospect moves through from first touch to the goal. Use during getting started, when a campaign has no playbook, and whenever you or the user have a new outreach idea.
+---
+
+# Playbook design
+
+A playbook is what a campaign follows: the stages a prospect moves
+through, the steps in each stage (channel, action, wait), the goal stage, the ways out
+(off-ramps) and the voice. Audienti stores every playbook with revisions, so a good one
+is written once and reused by many campaigns. Planning tasks (`prospects.plan`) read the
+campaign's playbook to decide each prospect's next step, so a campaign without one
+cannot be worked.
+
+Use this skill when:
+
+- You are getting started and the workspace has no playbook yet.
+- A queue task says a campaign needs a playbook (**Draft a playbook**, or a
+  **Get campaign ready** task that says "pick a playbook").
+- You or the user have a new idea for how to reach people: a new channel order, a
+  different first touch, a new voice, a new goal.
+
+## Rules
+
+- Reuse before you create. Most new campaigns fit a playbook that already exists.
+- Use only channels you can cover with accounts you reported (LinkedIn, Email). For anything you cannot do yourself, such as a call, a voicemail, a handwritten note, a video or a gift, use a `Custom` step: you prepare it and a person does it. A Custom step can wait for a named event the person records (`wait.until` `event`), for example "Gift delivered".
+  Do not draft a phone step if no one can call.
+- One playbook is one strategy. A correction to the same strategy (a wait, a step's
+  wording, a missing off-ramp) is a new revision. A different strategy is a new
+  playbook, so the two can be compared in Analytics.
+- Saving a playbook never changes campaigns already pinned to it. Pin the new
+  revision on purpose.
+- Never invent results or proof points for the voice. Use the user's words.
+- Every first email ends with one plain sentence that lets the prospect opt out, such
+  as "If this is not for you, reply and I will not write again." Say so in the first
+  email step's `instructions`. A prospect who opts out is suppressed for good.
+- Ask the user before a new playbook is used for outreach. Nothing is sent without
+  their approval.
+
+## 1. Reuse first
+
+1. `audienti playbook list` shows one page of summaries: name, latest revision and stage and step
+   counts. Follow `nextCursor` for more; `--limit N` sets the page size.
+   Every workspace has three starter playbooks (`system: true`): Email first, LinkedIn
+   first and Email only. When your reported channels point to one, the list marks it
+   `recommended: true` and returns a `recommendation` with its `reason`. A confirmed
+   LinkedIn account gives LinkedIn first: the user registered it as a sender account and
+   authorized you on it, and your report for it is healthy and includes `send_message`.
+   Email with LinkedIn not yet confirmed gives Email first; email alone gives Email only.
+2. `audienti playbook show ID` shows the stages, steps, goal and voice.
+3. If one fits the campaign's offer, audience and your channels, use it. Say in one
+   line why it fits, then go to step 4 (pin it). A starter playbook can be pinned as it
+   is, but it is read-only: to change it, save its fields as a new playbook (no `id`,
+   `expectedRevision` 0) with a new name, and revise that copy. Saving a starter
+   playbook with its `id` fails with 409 `starter_playbook`.
+
+## 2. Draft a new playbook
+
+Start from the user's offer, the audience and the channels you have. A good default
+for founder-led or agent-led outbound has five to six stages:
+
+1. **Ready** (Agent): the prospect is in the campaign. No steps.
+2. **Warming** (Agent, optional): view the profile, like a recent post. Skip it when
+   LinkedIn is not available.
+3. **Outreach underway** (Agent): the touches, in order, with waits. For example a
+   connection request (wait 21 days), a message "Only if connected" (wait 5), a first
+   email (wait 4). Completes to the **Unresponsive** off-ramp when every step is done
+   and nobody replied.
+4. **In conversation** (Assignee): the prospect replied. A person drafts or approves
+   the reply. Completion `stay`.
+5. **Meeting requested** (Assignee).
+6. **Meeting booked** (Assignee, goal, `goalDays` 0).
+
+Write `instructions` on each step as coaching for whoever does it: what to say, what
+evidence to lead with, what to avoid. Write `voice` as two or three sentences in the
+user's style. See [fields and an example request](references/fields.md) for every
+field and the rules Audienti checks.
+
+## 3. Save it
+
+1. Write the request to a file: `expectedRevision` 0 and no `id` for a new playbook;
+   the playbook's `id` and its current revision number to revise one. Use a fresh
+   `requestId` (a UUID) and fresh UUIDs for every stage, step and off-ramp `key`.
+   Keep the same keys when you revise, so progress already recorded stays on its stage.
+2. `audienti playbook save --file REQUEST.json`. Over MCP use `playbook_save`.
+3. If the save fails, read the error: `field` is the path of the wrong value, `allowed` the
+   values that work and `next` what to do. Fix that field and retry with the same
+   `requestId`. Run `audienti playbook actions` for the step action ids, channels and event
+   names. If `next` says to ask your user (for example to turn on Allow workspace changes),
+   ask with `audienti ask` and carry on with what you can. If it reports a revision conflict, the error gives `currentRevision`: run
+   `playbook show ID`, apply your change to that revision and save with that `expectedRevision`.
+
+## 4. Ask the user and pin it
+
+1. Ask in Audienti, not in chat: `audienti ask "Use this playbook for CAMPAIGN?"
+   --context "SUMMARY" --option "Use it" --option "Change it"`. Put the stages, the
+   touches with their waits, the goal and the voice in the context as a short list.
+2. When they answer, apply their changes as a new revision.
+3. Pin it to the campaign with `playbookPin` `{ "id": PLAYBOOK_ID, "revision": N }`:
+   in `audienti campaign create` for a new campaign, or in the campaign's draft update
+   for a draft. An active campaign keeps its pin; to try a new playbook, make a
+   successor (below).
+
+## New ideas
+
+When you or the user have a new idea for how to reach people:
+
+1. Write the idea as one change: "Lead with email instead of a connection request",
+   "Add a phone step after the second email", "Offer a teardown, not a demo".
+2. If it is a correction, save a new revision of the same playbook.
+3. If it is a different strategy, save a new playbook named for the idea.
+4. Test it with `audienti campaign successor ID` that changes only the playbook, so
+   the old and new campaigns can be compared. Name what changed in the campaign notes.
+5. Ask the user before the successor starts.
+
+## Record progress and ask for review
+
+Read the playbook before doing work for a campaign pinned to it: `audienti playbook
+show PLAYBOOK_ID`. Stage plays are instructions for you, the external agent; they are
+not a hosted sequence that runs by itself.
+
+- Progress: `audienti playbook record --file PATH` with exactly one of `stageKey`,
+  `offRampKey` or `finishStage: true`, the participation's pinned playbook version and
+  its current expected progress version, and stored evidence. Do not invent outcomes.
+  `audienti playbook` prints the command usage; the API schema has the required fields.
+- Human review: `audienti playbook suggest --file PATH`. The user approves or dismisses
+  it in **Operator → Queue**. A suggestion does not move a stage, and agents cannot
+  approve one. A stay completion records work without moving the stage.
+  `audienti playbook suggestions` lists the suggestions you can see.
+- None of these commands sends a message to a provider.
+
+## Done
+
+Close your queue task with a note that names the playbook, its revision and the
+campaign it is pinned to: `audienti queue done TASK --note "Saved Founder-led outbound
+r1, pinned to Logistics UK test"`.

package/skills/playbook-design/references/fields.md

@@ -0,0 +1,146 @@
+# Playbook fields
+
+`audienti playbook save --file REQUEST.json` accepts one object:
+
+| Field | Rule |
+| --- | --- |
+| `id` | Omit for a new playbook. The playbook ID to revise one. |
+| `expectedRevision` | 0 for a new playbook, otherwise the latest revision number. |
+| `requestId` | A fresh UUID. Reuse it only when you retry the same save. |
+| `fields` | The playbook itself, below. |
+
+## fields
+
+| Field | Rule |
+| --- | --- |
+| `name` | 1 to 120 characters. Name the strategy, not the campaign. |
+| `stages` | 2 to 30 stages, in order. Leave it out for the default skeleton (see Defaults). |
+| `goalKey` | The `key` of the goal stage. Not the first stage. Left out, it is the last stage (with `stages` left out too, the skeleton's last stage). |
+| `offRamps` | Up to 30 ways out: `{ key, name, reason }`. `reason` is `rejected`, `not_fit`, `nurture`, `unresponsive` or `other`. The system sets `taken_over`, `bounced` and `skipped` itself; do not choose them. "Bad data" and "repair" are not off-ramps. |
+| `voice` | How messages should sound, in the user's style. |
+| `eventRules` | Optional: what happens when an event reaches a person, for any stage and step. A new playbook starts with three (below); leave the field out to keep them, or send the whole list to replace it. See Event rules. |
+| `rules` | Optional: `allowBackward` (boolean, default false): let a move go to an earlier stage. Approval of a move is a setting on the account, not a playbook rule. |
+
+## Defaults
+
+When you change a playbook you already have, a part you leave out (`stages`, `goalKey`, `offRamps`, `voice`) stays as it is. For a new playbook, leave a field out and the server fills the best-practice value, the same on the CLI, MCP, REST and in the editor. What you write is kept, even a weak choice; the Playbook check warns about those.
+
+| Left out | Value |
+| --- | --- |
+| `stages` | Ready, Outreach underway (no steps; people who finish it leave as Unresponsive), In conversation (worked by a person) and Meeting booked as the goal. `playbook save` with only a `name` makes this. |
+| `offRamps` | Unresponsive, Not interested and Not a fit. |
+| an off-ramp `reason` | Guessed from the name (Not interested is `rejected`, Not a fit is `not_fit`, Unresponsive is `unresponsive`), else `other`. |
+| `voice` | One plain, short sentence. A blank voice gets it too. |
+| a stage `goalDays` | The waits of its main steps plus 2 days, at least 3. The goal stage gets 0. |
+| a stage `completion` | A stage with steps that an agent works, other than the goal, closes people out as Unresponsive. Other stages stay. |
+| a step `condition` | `Only if connected` for a LinkedIn message, else `Always`. |
+| a step `instructions` | One coaching sentence for the kind of action. |
+| a main step `wait` | Only for a step that is new in this save. A step that sends waits 3 days for a reply; a connection request waits 7 days for the accept; a step that sends nothing has no wait. A step the playbook already has keeps what it has, and `"wait": null` means no wait. |
+
+## The Playbook check
+
+Every read and save of a playbook returns `warnings`, a deterministic check that needs no agent. An item
+is `{ id, level, message, stageKey, stepKey, fix }`. A save is refused with `playbook_cannot_work` (422,
+the list in `errors`) when `offRamps` is empty or a stage has `on: []` and nothing sends people to it.
+The other items are warnings; read them after each save and clear them:
+
+| Item `id` | Meaning and default fix |
+| --- | --- |
+| `stage_never_ends` | A stage with steps and `completion` `stay`. Use `off_ramp` with the Unresponsive off-ramp. |
+| `stage_by_hand_only` | Nothing opens a stage but a person or agent. Give it an `on` event or finish the stage before it with `next`. |
+| `send_without_wait` | A send step with no `wait`, followed by another send on the same channel. Add a wait. |
+| `goal_shorter_than_waits` | `goalDays` is below the waits added up. Use the waits plus 2 days. |
+| `send_in_person_stage` | A send step in the goal stage or an `Assignee` stage writes to someone who already answered. Remove it. |
+| `steps_after_break_up` | A step after the break-up email. Put it before the break-up step. |
+| `message_without_connection` | A LinkedIn message with condition `Always` and no connection request before it. Use `Only if connected`. |
+| `stages_loop` | Routes or rules send people between stages in a circle. |
+
+## Stage
+
+| Field | Rule |
+| --- | --- |
+| `key` | A UUID, unique in the playbook. Keep it across revisions. |
+| `name` | Unique in the playbook. |
+| `movesInWhen` | What moves a prospect into this stage, for example "They replied". Shown to people; `on` decides. |
+| `on` | The events that open this stage: `accept`, `reply`, `meeting` or `manual`. Defaults to `["manual"]`. An event moves the prospect to the furthest later stage that opens on it; the stages passed over are recorded as skipped, never as done. |
+| `owner` | `Agent` or `Assignee` (the person assigned to the prospect). |
+| `goalDays` | 0 to 365. The days after which a prospect in this stage is overdue (the pipeline card turns orange). 0 means never overdue. |
+| `enabled` | Defaults to true. `false` skips the stage: no one is moved into it. The first stage and the goal stage cannot be skipped. |
+| `steps` | Up to 20 steps. |
+| `completion` | `{ "kind": "next" }`, `{ "kind": "stay" }` or `{ "kind": "off_ramp", "offRampKey": KEY }`. The last enabled stage cannot use `next`. |
+
+## Step
+
+| Field | Rule |
+| --- | --- |
+| `key` | A UUID, unique in the playbook. A plan action that runs this step carries it as `playbookStepKey`; actions without it change no playbook progress. |
+| `channel` | `LinkedIn`, `Email` or `Custom`. A `Custom` step is something you cannot do, for example a phone call, a voicemail, a handwritten note, a video or a gift. You prepare the script, note or choice, and a person does it by hand and records what happened on the Hand tasks page. A Custom step is never a side step and sends nothing. |
+| `action` | A short label, for example "Send connection request". |
+| `condition` | `Always`, `Only if viable` or `Only if connected`. `Only if connected` is checked: a person who was sent a connection request and has not accepted is skipped for the step; a person with no request on record is not blocked, because they may already be connected. A stage that opens on `accept` gates the same way. Left out, a LinkedIn message gets `Only if connected` and everything else `Always`. |
+| `viability` | Required with `Only if viable`: when the step makes sense. An Email step is skipped, without a card, for a person with no email on record, whatever its condition. |
+| `instructions` | Coaching for whoever does the step. |
+| `wait` | Optional: `{ "until": U, "days": N }`. `until` is `accept` (LinkedIn steps only), `reply`, `meeting`, `timeout` or `event` (Custom steps only); `days` is 1 to 60. An `event` wait also needs `"event": "Gift delivered"` (the name of what the person records); the person records it on the Hand tasks page and that ends the wait, and so does a reply, a booked meeting or the days running out. The wait starts when the agent reports the step's result with its step key: a plan action carries the step's `key` as `playbookStepKey`, and a succeeded result for that action starts the wait. A reply or a booked meeting ends every wait early; an accept ends only a wait until `accept`. Older playbooks used `waitDays: N`, which still reads as `{ "until": "timeout", "days": N }`. |
+| `side` | Defaults to false. A side step runs while the main step before it waits, for example a profile view or a like. A stage with side steps needs a main step. |
+| `onTimeout` | `next` (default) or `off_ramp`. With `off_ramp`, a main step whose wait runs out leaves the prospect through the `unresponsive` off-ramp. When nothing is left in the stage, its completion decides. |
+| `routes` | Optional: `{ "accept"?: T, "reply"?: T, "meeting"?: T }`, where `T` is `{ "kind": "stage", "stageKey": "<uuid>" }` or `{ "kind": "off_ramp", "offRampKey": "<uuid>" }`. Where an event that reaches the person after this step ran sends them. The step's route wins over the stage's `on` list; an event with no route follows the stage. A main step only; `accept` only on a LinkedIn step. A route to an earlier stage needs `rules.allowBackward`. |
+| `actionId` | Optional: an action id from the outreach rulebook, for example `linkedin.message.send`. It must match the step's `channel`. List the valid ids with their channel and label: `audienti playbook actions` (MCP `playbook_actions_list`). The `action` text stays the label the person reads. |
+| `eventRules` | Optional, up to 10: event rules for this step only. See Event rules. |
+
+## Event rules
+
+An event rule says what happens when an event reaches a person: do these things, then go here. It lives on the playbook (`fields.eventRules`, up to 30), on a stage (`eventRules`, up to 10) or on a step (up to 10). The nearest place wins, then the most specific event: a reply kind beats any reply. A step `routes` entry is the older form of the same thing.
+
+| Field | Rule |
+| --- | --- |
+| `key` | A UUID, unique in the playbook. |
+| `when` | The event: `accepted`, `replied`, `meeting_booked`, `wait_timeout`, `inbound_connection_request`, or a reply kind `reply.interested`, `reply.question`, `reply.later`, `reply.out_of_office`, `reply.wrong_person`, `reply.referral`. An unknown name is refused with the allowed names; `audienti playbook actions` lists them under `eventRules.when`. |
+| `do` | Optional list of `stop_wait`, `snooze`, `redirect_to_named_person`, `ask_who_is_right`, `tell_me`, `hand_to_user`, `withdraw_pending_request`. Also under `eventRules.do`. |
+| `snoozeDays` | 1 to 90. For `snooze`. |
+| `goto` | Where the person goes after: `{ "kind": "stay" }`, `{ "kind": "gate" }` (the stage's own next step; the default), or `{ "kind": "stage", "stageKey": KEY }`, `{ "kind": "off_ramp", "offRampKey": KEY }` or `{ "kind": "step", "stepKey": KEY }`. |
+
+Every new playbook starts with these three on the playbook, when you send no `eventRules`:
+
+- `reply.interested`: `stop_wait`, then `gate`.
+- `reply.out_of_office`: `snooze` for 7 days, then `stay`.
+- `reply.wrong_person`: `stop_wait`, `redirect_to_named_person`, `ask_who_is_right`, then `stay`.
+
+Taking someone off the list and a bounce always run first; no rule changes them.
+
+A LinkedIn step whose `actionId` is `linkedin.inmail.send` runs only when the LinkedIn account reports InMail available. Otherwise it is skipped without a card.
+
+## Example request
+
+Replace every `<uuid>` with a fresh UUID (`uuidgen` or `node -e "console.log(crypto.randomUUID())"`).
+Use the same UUID wherever the same placeholder letter appears.
+
+```json
+{
+  "expectedRevision": 0,
+  "requestId": "<uuid>",
+  "fields": {
+    "name": "Founder-led outbound",
+    "stages": [
+      { "key": "<A>", "name": "Ready", "owner": "Agent", "goalDays": 3, "steps": [], "completion": { "kind": "next" } },
+      { "key": "<B>", "name": "Warming", "owner": "Agent", "goalDays": 7, "steps": [
+        { "key": "<uuid>", "channel": "LinkedIn", "action": "View profile", "condition": "Always", "instructions": "Read their recent activity for a signal to mention." },
+        { "key": "<uuid>", "channel": "LinkedIn", "action": "Like a recent post", "condition": "Always", "instructions": "Only a post about their work.", "wait": { "until": "timeout", "days": 3 } }
+      ], "completion": { "kind": "next" } },
+      { "key": "<C>", "name": "Outreach underway", "owner": "Agent", "goalDays": 35, "steps": [
+        { "key": "<uuid>", "channel": "LinkedIn", "action": "Send connection request", "condition": "Always", "instructions": "No note, or one line on their signal.", "wait": { "until": "accept", "days": 21 } },
+        { "key": "<uuid>", "channel": "LinkedIn", "action": "View profile", "condition": "Always", "instructions": "A light touch while the request waits.", "side": true },
+        { "key": "<uuid>", "channel": "LinkedIn", "action": "Send message", "condition": "Only if connected", "instructions": "Lead with their signal and offer something useful.", "wait": { "until": "reply", "days": 5 } },
+        { "key": "<uuid>", "channel": "Email", "action": "Email 1", "condition": "Always", "instructions": "Three sentences: signal, offer, one short question.", "wait": { "until": "reply", "days": 4 }, "onTimeout": "off_ramp" }
+      ], "completion": { "kind": "off_ramp", "offRampKey": "<R>" } },
+      { "key": "<D>", "name": "In conversation", "movesInWhen": "They replied", "on": ["reply"], "owner": "Assignee", "goalDays": 3, "steps": [
+        { "key": "<uuid>", "channel": "Email", "action": "Draft a reply", "condition": "Always", "instructions": "Answer their question first. Propose a time only if they asked.", "wait": { "until": "reply", "days": 2 } }
+      ], "completion": { "kind": "stay" } },
+      { "key": "<E>", "name": "Meeting requested", "owner": "Assignee", "goalDays": 3, "steps": [], "completion": { "kind": "next" } },
+      { "key": "<F>", "name": "Meeting booked", "on": ["meeting"], "owner": "Assignee", "goalDays": 0, "steps": [], "completion": { "kind": "stay" } }
+    ],
+    "goalKey": "<F>",
+    "offRamps": [{ "key": "<R>", "name": "Unresponsive", "reason": "unresponsive" }],
+    "voice": "Write like a founder. Lead with their signal, offer something useful, and ask one short question.",
+    "rules": { "allowBackward": false }
+  }
+}
+```

package/source-manifest.json

@@ -1,59 +1,106 @@
 {
   "repository": "https://github.com/omalab/exora",
-  "sourceCommit": "9cd6c048e9a33ac0b08ebf4980ac07c8c78a0446",
+  "sourceCommit": "bdfb2ad6a10be923217ea690ac9f894c7f5c11ad",
   "files": {
     "LICENSE": "220f297cfcd5c38eb64e6b4b4a77cab4ebc7f4686d4d99c6260a475d02ca11e5",
+    "README.md": "7ff32cc8ac89dd54b64d7b39c0b41b1f37e154b7ea10ad5a7bceefc3df77d87f",
     "bin/audienti-mcp.mjs": "6df1d6eb3a5bc65e7592e5b8f73cd4c98c159f2583723d042338633b356301df",
     "cli/account-intake-operations.mjs": "b43d764c628beabafad753d711ddb2af2c64276e4a6506ed0b854839091ea5db",
     "cli/account-intake.mjs": "aa77f2f96fd030f8830d6de278932186aea7c82cfda086a5a6cf569202feebc8",
     "cli/account-replies.mjs": "699e34e5c736ba316df8f164b4c50f82a7e4e2d5e51303e6b13944c3f2c854ab",
-    "cli/account-reply-operations.mjs": "b4d65cf4459138909dba916012f78cc6cf4580748ed350d220132ec96adbdd83",
-    "cli/agents.mjs": "8d0f7a940f61a74408956b2c597aceb107a25d08877d733db9fddfa68aa33bdb",
-    "cli/approach-operations.mjs": "a84d0d406c60dd239b9fb1cbd1a6923c51a23a332e2afd6a789c680c6a7ef46c",
-    "cli/assignment-operations.mjs": "60d672702dcaca9514a7eff5cfde094844884361a22a7cf667c465a80c59a75d",
-    "cli/assignment.mjs": "44255a329529f897af1055828d5ca0bd2ea5182df62c4983006f4c5ab2547f0a",
-    "cli/audience-operations.mjs": "632fe13f59dbeeb0d264943b5df5643d1dc631a504363e2d1dbe1297f5ab9b78",
-    "cli/audiences.mjs": "6aa845c4351bd04577e74e0c7803e1d5d32acdf5de77e51a5413abbfa0db1263",
-    "cli/audienti.mjs": "8438c2034823571c6c79687ee8262af4daa3d9b29f6da4d12db2b3de9c10eba7",
-    "cli/connection-registry-operations.mjs": "2de6a46a4cace8392cb3705e7dc1d18e1d782ca136a170a6b556e60957749c05",
-    "cli/content.mjs": "db3fcbf7f96c314227a8172a442b70b46405126e0d61f8358cee1bfe6c627ebd",
-    "cli/discovery-operations.mjs": "dc564a591bd920df67ba2df65f31d973491c21687e6fba12125430a8ecad2c95",
-    "cli/discovery.mjs": "c0c23378ff93ecd86cba8d9e0add1fcc5a26f5e849cbc561860b93f50f0adb27",
-    "cli/experiment-operations.mjs": "68879e83e29b6a86ddaff5931fb3c38c072aadf40dee57513e33c43b8f9fdc5c",
-    "cli/experiments.mjs": "80a672d056b1f2cdff882c63ee39420c0b9e68167fbe4f8486a905e51c0de4cb",
-    "cli/json-file.mjs": "e1fa747c2ba7cdb1f013ed99789a7e4811c3f569cd7d9715f30ddededa34159e",
-    "cli/mcp.mjs": "4e746d5eb34ca68b32f544eb9085777a57e2e9bbddd3d2810c51cf9e10a1e6df",
-    "cli/offer-operations.mjs": "29587e874faed3db86bfdde9faf8aec6ea767152617879859f3f7b9236610874",
+    "cli/account-reply-operations.mjs": "4359096dbf75d8c3602266588d2aea2b6cdecd903e2a094dbf25d26e2fab22b2",
+    "cli/agents.mjs": "e311dd08d1dc09648881a37eb9765bf6d155786f0b713204f51de29bc8134293",
+    "cli/assignment-operations.mjs": "fc74e3fd79975cfcbac14891d5dec5f25e662777050fc46a8ad3aae5cf361c59",
+    "cli/assignment.mjs": "90cb85e0df8aadca2ff8391c99e778b41261183b5f38e8c6c32afee2f98f871a",
+    "cli/attachment-operations.mjs": "dd29a50d073ded71ebd606fb3a9181bebcf2a1390f75f99cdcb61d84261d102a",
+    "cli/attachments.mjs": "2fee6b4abbf82da9847d4a927a3d4d3ca947a198a903a78927596a2ea858cbf4",
+    "cli/audience-operations.mjs": "133b72dc6b9e3a6b4f173ce28f1524163f9c7b049505b885115f83b9e4af7170",
+    "cli/audiences.mjs": "3c377346efc1a8bdde432a16c2d19a3f51f34f3333d344d3a2bfa94c188a017d",
+    "cli/audienti.mjs": "5b2dbf838cc915b4e2096de275bb5ed8fc8cc79b546cf3855cc7ca680a09151f",
+    "cli/audit-operations.mjs": "afaf87d592a1e5f6bff2a8649a6a64a8f471950b7d99e98995d9205aa5910398",
+    "cli/audit.mjs": "a7becaed67c58b063e668b5e66844b6dc15c11a63b428faa171b542ad922c001",
+    "cli/budget-operations.mjs": "d74916551ef393e29734c6e13cf9021251e0ed126eeaa529e18cf2332146e1e0",
+    "cli/budgets.mjs": "683e06cb4d410c851286fbd1cdd4fb9f1902726c60fd4fcddb2c13d164786525",
+    "cli/campaign-find.mjs": "9c0a44c69ab7ad3e24a0a2edc97b8f3a14f602e3b6caf7e1943b8e1b93609c4a",
+    "cli/campaign-operations.mjs": "c1ac42f53f8bf19957fac41cc2a80ab4e26a743a7c1cc0b42c8c0e85fcf6e61b",
+    "cli/campaigns.mjs": "a4c1e824b729cdaf1838db68785e62c55d4ba7d57c59d3f71666d2197be2fdf8",
+    "cli/cohort-operations.mjs": "91b1d1fc48e75581bb315f42d735ef94e21687dc216f352337d8a5d180bb691e",
+    "cli/cohorts.mjs": "c71940903430f3e6834608f113534910b75a98b3e410a5942f04051607488485",
+    "cli/connection-registry-operations.mjs": "888ea440d00ffc9ed68d4cc084ff73a5a00d0e60bd6293baba8bb4539a25ae62",
+    "cli/content.mjs": "04141903c304cb7c911ac35ad41cd1f1d48adb230caa6d8873d6545eb017c79d",
+    "cli/discovery-operations.mjs": "cc132abae230cc84439bcd24da813e2798ee1eb83a06a7d1141202ab9c68215a",
+    "cli/discovery.mjs": "34b3794ee6ca539dbbccef77ec2085fd5411023046bdfb9b83e2537414542a41",
+    "cli/file-operations.mjs": "564f334dd9d52e9c56f44d58b5c3b0bda59ff72f54126b755bc472144069349e",
+    "cli/files.mjs": "2221b067d6ade7ef5cc8965929aea2eb485781953d3f2b50600995b65fbdedae",
+    "cli/guardrails-operations.mjs": "aa5a911663133b3287bea805df9e2a5d8b5bbc4a3df972c52f91fee315954ded",
+    "cli/guardrails.mjs": "e8b9c0a19956a9eab84475d3c56a4b6c77baf7ed9a55e8686d660ef1ad562aa8",
+    "cli/hand-task-operations.mjs": "473473fe95324c8c8733e037feab5ac468c07b0658fabd739cfd7d400a7faa83",
+    "cli/hand-tasks.mjs": "2c895cf6b30c594a7e27cc4ec4b7eddeb39f941cd195b9255c6e0d6b4a56371f",
+    "cli/json-file.mjs": "96431b18215834c2531f5901e2526875c634dd2e85a9465fcffc937fbec52150",
+    "cli/kv-operations.mjs": "505d79d0d535d3441883f8a37817c30c73367216a35dddb07181f0f0e799df79",
+    "cli/kv.mjs": "05783610001dd002af07a4bb8f26e64d74aa4981bbe38a2100552b810cb3bc72",
+    "cli/mcp.mjs": "289f6a68554e54fe0dbad290bf710ff7fad1c598421a83d3fb9b96979dac1eaa",
+    "cli/notification-operations.mjs": "7225dbcfd87d29921e72ee247f61aaee323a4a2e5a48a9ba9c945b02f66e4978",
+    "cli/offer-operations.mjs": "a03d467622be38bbf52bbfbbd54e6969bdd55af15a627f54356bb03eb1b4f508",
     "cli/offers.mjs": "4a97007e1e25352707bbecda0b2519affcd0024e52ae8d9446d76d459460feca",
-    "cli/owner-account-client.mjs": "712b2fd5a8cb21f1baa88ebce1ee1750a44b34cf7d15a93be61e530aacf202c4",
+    "cli/outbound-operations.mjs": "52992bea63195efa8150c6ca2ff0b37ee6010f03fa366055c70c755ee0eb028e",
+    "cli/outbound.mjs": "23903eb0fec4d7af3aa0031d63488ed9a8697e07ccf1314d194b48e109d15f82",
+    "cli/outcome-operations.mjs": "cf133097799f240a006264a38a4c6bd4094078d6dec78a71679700ac3bdeacd5",
+    "cli/outcomes.mjs": "765ccb112a90fc4d228b2a41e5e19c5e1f3e2fe14bc1d8128b0090fc95cdbf3f",
+    "cli/owner-account-client.mjs": "e7912f7c67571676cb94bcc9424b7d4a3bf9ef1461c9a5d6c31a2651e546a9ea",
+    "cli/playbook-help.mjs": "56a5b6ba4c94022931f9c751c954133239404048aba99d1ff28cd290eac22f41",
+    "cli/playbook-operations.mjs": "f5a90688c266d2445fc69500ed39aa0eb0548c8894a710130190bf8177dcbfb1",
     "cli/profiles.mjs": "45929b224ffc916b6dbd7a94e06ac09a1ff7feec430633b10d160c1608fc2d32",
-    "cli/progress.mjs": "7bf270872d95c06aa48d49c3393e6e48e628b74cffb69a7929641ff7a0717b58",
+    "cli/progress.mjs": "aeca47f4e59be306dac4592cf2e4209a30e322fc13e4e103e64e09faa370f5a8",
     "cli/prospecting-settings-operations.mjs": "37b881a867c19d9e5f2d02316038284ea0cf09de4f37b6dee2370a1faedf245e",
     "cli/prospecting-settings.mjs": "b09f47c84416d9892d7d5b17dcf684cbb560e1cacb25513826ff04ef9307626e",
-    "cli/recipient-operations.mjs": "efc06c75d263169a35f5bac76dce133d4e78cf96a4b4a661531234a4d4007cdf",
-    "cli/recipients.mjs": "e5e30fc30ab325a43cffdc51ad8872cb657ce0f5d3cb304dd8af65c6d9224c75",
-    "cli/sender-account-operations.mjs": "f54b0e5ef6d6563752df95b2ce39c9a9a2e6ae2d53d13d6ef6c899cc92456aa7",
-    "cli/sender-accounts.mjs": "a3c569b5da55c22226f37d65d5a9144229860bf37fbfc7b5ac3c307a9ee9b048",
-    "cli/skills-mcp.mjs": "8eae2f456b0a3c39b905856e70c21204fe208e86d05f23a38949fb4fc584f808",
-    "cli/skills.mjs": "85f7ecc76e85b4014ac1356f399b3108eec4a152256aa6b4e0a7dfc44aaf2676",
+    "cli/question-operations.mjs": "c7070dd1b5ec9c5b0df93012ef08d0d6b4d6e5c8da267a37beb1acc5c3cf4ea1",
+    "cli/questions.mjs": "32bbe0b785b1e6438435faf4697332ea2da3133d4c896720d39377c35e9b2127",
+    "cli/queue-operations.mjs": "bc5f5b8f79f056f579c2d3965d143b45ded4665629e2c4d427adfbaf7e9687fb",
+    "cli/queue.mjs": "046f4dba92ac9eacbb1f12215ab2b49623bae597342da6b415f7afb3c3a1344e",
+    "cli/recipient-operations.mjs": "7d41c17ef2d59dbed982893e0989c9c076317b91adcd3d752cbe1d2e0b8c41b2",
+    "cli/recipients.mjs": "dc93d4a23ca1df9c84a0c9734d09491af179644eed48d856d1f1a24d42276ea8",
+    "cli/rooms-operations.mjs": "27e4c1c0dac7cf1256468bac5806fb2a3959d07d3cac3af8d785a50772148fd1",
+    "cli/rooms.mjs": "bc42cc3f040b23bd832c725cb0e2faf66fe6327cbc64571550586ce97ba40415",
+    "cli/search-operations.mjs": "903f12fffb6824872160c4136925ab5638142bb4e39236b37f927cd2c6a43776",
+    "cli/secret-operations.mjs": "faefe9c9ece81087dc7aab32e88f331ed942d0757ce5a978b5f0722d514f377f",
+    "cli/secrets.mjs": "cab4ea932e724ce3c807c7825869810b44fb8d75cdacec32f8101353f0e7c5f5",
+    "cli/sender-account-operations.mjs": "1ca45ee0f1472b69972bca7b68e2a58ab1f20eb2143d99db435a6e1bf02fba11",
+    "cli/sender-accounts.mjs": "406abd62a489894bec2cb3c9ebcc1b19572ab8f2d0fab4854deb78ea7dd89d0a",
+    "cli/skills-mcp.mjs": "6a91b16a789f50035ae0fe33f8ae2758bb9829949db7efb05c6d65dde335a9e0",
+    "cli/skills.mjs": "ea8dfef32664714f9c63251d9a6bbdb44d77d41e272df46bb102ebfcd8df8b66",
     "cli/suppression-operations.mjs": "d1f827a785670fc6e44d87b18e4cfb6596b09e5be7c4f84c4b9a75ed13a962c6",
     "cli/suppression.mjs": "2b10be67e290deec9ed915139c3d98d45d7d10fd41abb67b5a35a630d636a4ed",
-    "cli/tools-operations.mjs": "ae8bbb8cc919aa8a9c796367f488911f2eda3670e81f85829972b13582827963",
-    "cli/tools.mjs": "229b096d8d858a22e0a08a2a745906e83873827c3d74a5b13a6607ae198c465f",
-    "cli/work-execution-operations.mjs": "cb5926acdb9e5cd3173c48868436b1a5e5ebd1b6cab372aec2e2ce447f4f62da",
-    "cli/work-execution.mjs": "5d9dba0dde20a7ec6ff6a2cbee140497171af9bfdd403f90e8ff8286a72862e7",
+    "cli/tools-operations.mjs": "aafa52336c0bda8b05d4a091548c18d8634608d282d433aee45a744044b68770",
+    "cli/tools.mjs": "6d9c7f27cc50e5e2fc0859c9c2d62bc3e77b5a46d0e2aeaa6cf31e2867138758",
+    "cli/usage-operations.mjs": "64dd1ae850f52bb72c7648be78a8ab2dfab986afba2d2d2cd08034c4f7b3ace6",
+    "cli/usage.mjs": "cd582c061f83ca4f220ddd3cd2a174a1a3a3c0ee308b3d5a5f47752a501e322e",
+    "cli/work-execution-operations.mjs": "842d706b36bb035aa54e1dee8bf950f0619c495bcae84faa1926fbb05f6842bc",
+    "cli/work-execution.mjs": "4b74923417eaa70dee0ba8806b64d0acf7c884fb77b76d5e86d567cf92e51b01",
     "cli/work-feedback-operations.mjs": "a998f2b2dbe38ceb2bad74f7fa61c31f87f842755449248b7eb0c04185c0ee3d",
     "cli/work-feedback.mjs": "f3b77ecfd7ea1aba9c9f03c9d894137547e9c5575d9daa359ed94505ad025852",
-    "cli/work-operations.mjs": "f6544b69b424f839919e2c6c336b70a7be3aa0d147b18bc25479ca7a634117a5",
-    "cli/work.mjs": "b029727fb2a9e931e9e077d04e1976bfedc496e2ffcd74ccfa6490d109b5f139",
-    "cli/workspaces.mjs": "58e28acf3f5f82bbee35ea03478ec948390c908c6714330ace90118d552249cd",
-    "package.json": "a4d48a4c8704437707e7991b07af0f81296140bff1d50e662607c857a4ae7f50",
-    "skills/audienti/SKILL.md": "f6f8b3d74979c0e2e214d17a7fc77dcb93e957c37304d76791ddab88a6187914",
-    "skills/audienti/references/helpers.md": "b1eda3787dc0b10746c1272ada2689bfc29f014c2ea432d94733a8205a7d8dc3",
-    "skills/audienti/references/profile-workflows.md": "c44fcc0ce9142281aa309c3f0e771883a084100c86fbdd06561a3dc16e58c6db",
+    "cli/work-operations.mjs": "8b3a84ca15e8e4ad79ef92ced4c5adaffd5129f630e3bfc2c74a844a90867600",
+    "cli/work.mjs": "751107ecc3de5a6be9db4a068cddc41f3ad8e77c87e59686eaf522862caf9e9f",
+    "cli/workspaces.mjs": "8144874c7c0a224efc33190dccffffdecebad82f52b6a98c4e4d0f7dfa601f90",
+    "package.json": "f42afbf827ff5fac9e8f29085a51f15cae2045f603bc87e1f4e8b24eec96bf8b",
+    "skills/agent-rooms/SKILL.md": "08f917ff85fee1d23499a4499056ce845b39ce6727029b104819dad41ee87cc2",
+    "skills/agent-rooms/references/commands.md": "ef5afa5543ca9da967a147f638774647998ea1c1a2a821959f3bf87d54c292bd",
+    "skills/audienti/SKILL.md": "8f2124065bfc3a005b44e194e7dcce9bbf14062ab332e7db66d441eeccb518ed",
+    "skills/audienti/references/helpers.md": "e27aff0aa07b92f575d617612ed3def824765bac6ce1304cf227a4aca223369a",
+    "skills/audienti/references/profile-workflows.md": "80669b75eb5e8aeb614ce55ac046236d671af0de3ddd238853324579d5a3b251",
     "skills/audienti/references/workflow-receipt.md": "349f9a85472832b8bdc6a5d16c5b10b8e32d48d3e81523ad8d42f9a03b3655ff",
-    "skills/audienti/scripts/contracts.mjs": "214aecaf3eec080196233e4e0fcf1e8cb07c5b30350aed70c3fec9db9f8e1f32",
+    "skills/audienti/scripts/contracts.mjs": "900428e067b7f8dae544012387bc3752f7b0d27777a80cd16ec0985848983f70",
     "skills/audienti/scripts/profile-helpers.mjs": "7f62afdefd8e1b1bfec95f1ca6f48cfc4e204d1bff35f805261c45c6d5fcb46a",
-    "skills/audienti/scripts/run.mjs": "652094ff8b642d13f5e0bb30756bb49464c051511c37f202249fde917b319208"
+    "skills/audienti/scripts/run.mjs": "652094ff8b642d13f5e0bb30756bb49464c051511c37f202249fde917b319208",
+    "skills/getting-started/SKILL.md": "902fffe321a91acd2dc3583a372801df6952c7e974179198ce688b62ca8b8f21",
+    "skills/getting-started/references/audience.md": "6a2c061be5e299b3cbbd236578693ae5084d216425c500d3639a4d1fcb86ccb7",
+    "skills/getting-started/references/campaign-draft.md": "c2cbeb7de95734889698a5cd852268b9bed69e56f661153bb7ada237241a1a6b",
+    "skills/getting-started/references/capabilities.md": "982e3583a47ba4ac832efae2f6af3a4d8c0c18cace159c76b2a4ad1a8d8e910e",
+    "skills/getting-started/references/mailbox-check.md": "113574bb5a573125620dcde4e65ebf44164f7b0727cc936fb41234f5d57bba73",
+    "skills/getting-started/references/outcome-checks.md": "094d09d231b38d4935aa9eb8ac089e46ba8e698489852fa97040e6b5eac77a9b",
+    "skills/getting-started/references/replies.md": "865c97bea9c4bbecc2aba15be933356d11c37f3239be2cd436442230b5e0501e",
+    "skills/getting-started/references/reply-checks.md": "85fe692ad6b7bc73e204de313b27d225be3da1a0af71e8e7bb9945ae511a0dc3",
+    "skills/playbook-design/SKILL.md": "86d77069a73d5c21c43623d2faa84a3957cfb1f30f7fae45f239b32e249f892a",
+    "skills/playbook-design/references/fields.md": "41b20ab4a82501def62f8138fc218f48180a46c37fcf68d47f6a5802c5a747bf"
   }
 }

package/cli/approach-operations.mjs

@@ -1,12 +0,0 @@
-import {z} from 'zod';
-const uuid=z.string().uuid(),scope={workspaceId:uuid.optional()},stage=z.object({key:uuid,name:z.string().trim().min(1).max(120)}).strict();
-const fields=z.object({name:z.string().trim().min(1).max(120),stages:z.array(stage).min(2).max(30),goalKey:uuid,offRamps:z.array(stage.extend({reason:z.enum(['rejected','not_fit','nurture','unresponsive','other'])})).max(30)}).strict();
-const base=a=>`/workspaces/${a.workspaceId}`,query=(a,skip=[])=>new URLSearchParams(Object.entries(a).filter(([k,v])=>k!=='workspaceId'&&!skip.includes(k)&&v!==undefined).map(([k,v])=>[k,String(v)]));
-export const approachOperations={
- approach_list:{schema:z.object({...scope,cursor:uuid.optional(),limit:z.number().int().min(1).max(100).optional()}).strict(),method:'GET',path:a=>`${base(a)}/approaches?${query(a)}`,scoped:true,description:'List immutable versioned approaches in the current workspace. Free CRM read.'},
- approach_get:{schema:z.object({...scope,id:uuid,revision:z.number().int().positive().optional()}).strict(),method:'GET',path:a=>`${base(a)}/approaches/${a.id}?${query(a,['id'])}`,scoped:true,description:'Read an approach version: stable stage keys, goal and terminal off-ramps.'},
- approach_save:{schema:z.object({...scope,id:uuid.optional(),requestId:uuid,expectedRevision:z.number().int().nonnegative(),fields}).strict(),method:'POST',path:a=>`${base(a)}/approaches`,body:({workspaceId,...a})=>a,scoped:true,description:'Create or revise an approach with optimistic version and idempotent request. Does not change existing experiment or participation pins.'},
- approach_progress_get:{schema:z.object({...scope,participationId:uuid}).strict(),method:'GET',path:a=>`${base(a)}/participations/${a.participationId}/progress`,scoped:true,description:'Read the participation’s admitted approach pin and recorded stage/outcome history.'},
- approach_progress_record:{schema:z.object({...scope,participationId:uuid,expectedVersion:z.number().int().nonnegative(),requestId:uuid,stageKey:uuid.optional(),offRampKey:uuid.optional(),reason:z.string().trim().min(1).max(2000),evidence:z.array(z.object({kind:z.enum(['observation','conversation']),id:uuid}).strict()).max(20)}).strict(),method:'POST',path:a=>`${base(a)}/participations/${a.participationId}/progress`,body:({workspaceId,participationId,...a})=>a,scoped:true,description:'Record one forward stage or terminal off-ramp using stored evidence for this person. Assigned owner/Admin only. Goal ends prospecting; post-goal forward reporting never reactivates. No send or provider call.'},
- workspace_analytics_get:{schema:z.object({...scope,experimentId:uuid.optional(),pinId:uuid.optional(),from:z.string().datetime(),to:z.string().datetime()}).strict(),method:'GET',path:a=>`${base(a)}/analytics?${query(a)}`,scoped:true,description:'Read UTC-period distinct outcomes and explicit stage events. Missing activity or cost attribution is not tracked, never fabricated zero. Maximum 366 days; narrow large scopes.'}
-};

package/cli/experiment-operations.mjs

@@ -1,25 +0,0 @@
-import {z} from 'zod';
-const uuid=z.string().uuid(),workspace={workspaceId:uuid.optional()},locator={...workspace,experimentId:uuid};
-const state=z.enum(['Preparing','Active','Paused','Closing','Archived']);
-const signalBase={id:uuid,scope:z.enum(['company','person']),details:z.string().optional()};
-const signal=z.discriminatedUnion('kind',[
- z.object({...signalBase,kind:z.literal('research'),question:z.string(),expected:z.boolean().optional()}).strict(),
- z.object({...signalBase,kind:z.literal('topic'),topic:z.string()}).strict(),
- z.object({...signalBase,kind:z.literal('profile'),url:z.string(),track:z.enum(['audience','activity']).optional(),interactions:z.array(z.enum(['comments','reactions'])).optional()}).strict(),
-]);
-const fields=z.object({name:z.string(),audienceId:uuid,audienceRevision:z.number().int(),offerId:uuid,offerRevision:z.number().int(),premise:z.string(),approach:z.string().optional(),approachPin:z.object({id:uuid,revision:z.number().int().positive()}).strict().optional(),notes:z.string().optional(),ownerUserId:uuid.nullable().optional(),tags:z.array(z.string()).optional(),signalMatch:z.enum(['any','all']).optional(),signals:z.array(signal).optional(),targets:z.discriminatedUnion('kind',[
- z.object({kind:z.literal('none'),values:z.array(z.never())}).strict(),
- z.object({kind:z.literal('companies'),values:z.array(z.object({type:z.enum(['domain','linkedin-company']),value:z.string()}).strict())}).strict(),
- z.object({kind:z.literal('people'),values:z.array(z.object({type:z.literal('linkedin-person'),value:z.string()}).strict())}).strict(),
-]).optional(),channels:z.array(z.enum(['email','linkedin'])).optional(),approvalMode:z.literal('manual').optional(),contentOpsEnabled:z.boolean().optional(),schedule:z.object({startAt:z.string().nullable().optional(),endAt:z.string().nullable().optional(),maxCompanies:z.number().int().nullable().optional()}).strict().optional()}).strict();
-const path=a=>`/workspaces/${a.workspaceId}/experiments`,detail=a=>path(a)+`/${a.experimentId}`;
-const qs=a=>new URLSearchParams(Object.fromEntries(Object.entries(a).filter(([k,v])=>!['workspaceId','experimentId'].includes(k)&&v!==undefined).map(([k,v])=>[k,String(v)])));
-export const experimentOperations={
- experiment_list:{schema:z.object({...workspace,state:state.optional(),archived:z.boolean().optional(),q:z.string().optional(),limit:z.number().int().optional(),after:uuid.optional()}).strict(),method:'GET',path:a=>path(a)+'?'+qs(a),scoped:true},
- experiment_get:{schema:z.object({...locator,revision:z.number().int().optional()}).strict(),method:'GET',path:a=>detail(a)+'?'+qs(a),scoped:true},
- experiment_events:{schema:z.object({...locator,limit:z.number().int().optional(),after:uuid.optional()}).strict(),method:'GET',path:a=>detail(a)+'/events?'+qs(a),scoped:true},
- experiment_create:{schema:z.object({...workspace,requestId:uuid,fields}).strict(),method:'POST',path,body:a=>({requestId:a.requestId,fields:a.fields}),scoped:true},
- experiment_update:{schema:z.object({...locator,expectedRevision:z.number().int(),fields}).strict(),method:'POST',path:a=>detail(a)+'/revisions',body:a=>({expectedRevision:a.expectedRevision,fields:a.fields}),scoped:true},
- experiment_transition:{schema:z.object({...locator,expectedState:state,operation:z.enum(['activate','pause','resume','close','archive','restore']),reason:z.string().optional()}).strict(),method:'POST',path:a=>detail(a)+'/transitions',body:a=>({expectedState:a.expectedState,operation:a.operation,...(a.reason===undefined?{}:{reason:a.reason})}),scoped:true},
- experiment_successor:{schema:z.object({...locator,requestId:uuid,expectedRevision:z.number().int(),fields}).strict(),method:'POST',path:a=>detail(a)+'/successors',body:a=>({requestId:a.requestId,expectedRevision:a.expectedRevision,fields:a.fields}),scoped:true},
-};

package/cli/experiments.mjs

@@ -1,26 +0,0 @@
-import {callWorkspace,configuration} from './workspaces.mjs';
-import {readJsonFile} from './json-file.mjs';
-export async function experimentCli(args){
- const position=[],flags={};for(let i=0;i<args.length;i++){
-  if(!args[i].startsWith('--')){position.push(args[i]);continue}
-  const key=args[i].slice(2);if(!['profile','workspace','file','request-id','expected-revision','revision','archived','limit','after','q','state','operation','expected-state','reason'].includes(key)||!args[i+1]||args[i+1].startsWith('--')||Object.hasOwn(flags,key))throw new Error('Unknown or incomplete experiment option.');
-  flags[key]=args[++i];
- }
- const command=position[1],name={list:'experiment_list',show:'experiment_get',create:'experiment_create',update:'experiment_update',transition:'experiment_transition',successor:'experiment_successor',events:'experiment_events'}[command];
- if(!name||position.length!==(['list','create'].includes(command)?2:3))throw new Error('Use experiment list|show ID|create|update ID|transition ID|successor ID|events ID.');
- const input={workspaceId:flags.workspace};
- if(position[2])input.experimentId=position[2];
- if(['list','events'].includes(command)){
-  if(flags.archived!==undefined&&!['true','false'].includes(flags.archived))throw new Error('Archived must be true or false.');
-  if(flags.archived!==undefined)input.archived=flags.archived==='true';
-  if(flags.limit!==undefined)input.limit=Number(flags.limit);
-  if(flags.after)input.after=flags.after;
-  if(flags.q!==undefined)input.q=flags.q;if(flags.state!==undefined)input.state=flags.state;
- }
- if(command==='show'&&flags.revision!==undefined)input.revision=Number(flags.revision);
- if(['create','update','successor'].includes(command)){if(!flags.file)throw new Error('Supply --file PATH containing Experiment fields.');input.fields=readJsonFile(flags.file,65536,'Experiment file');}
- if(['create','successor'].includes(command))input.requestId=flags['request-id'];
- if(['update','successor'].includes(command))input.expectedRevision=Number(flags['expected-revision']);
- if(command==='transition'){input.operation=flags.operation;input.expectedState=flags['expected-state'];if(flags.reason!==undefined)input.reason=flags.reason;}
- console.log(JSON.stringify(await callWorkspace(name,input,configuration(flags.profile))));
-}