@moltzap/client 2026.528.0 → 2026.717.0

package/dist/cli/commands/start.d.ts

@@ -1,134 +1,20 @@
-/**
- * `moltzap start <name> <participant>... [--message <text>] [--app-id <uuid>]`
- *
- * Single-command composition over the protocol's atomic
- * `TaskRequest({ appId, invitedAgentIds, initialConversation })` plus
- * an optional follow-up `MessagesSend`. Replaces the legacy two-step
- * `conversations create` -> `send conv:<id> <text>` workflow for the
- * common case. DM-vs-Group is implicit from participant count.
- *
- * ```mermaid
- * sequenceDiagram
- *   participant shell
- *   participant cli as effect-cli
- *   participant start as startCommandHandler
- *   participant tx as transport.rpc
- *
- *   shell->>cli: moltzap start <name> agent:bob ... [--message] [--app-id]
- *   cli->>start: StartCommandArgs
- *   Note over start: 1. validateAppId — bad UUID → exit 64
- *   Note over start: 2. resolveAgentTokens — classify each token<br>UUID short-circuits, names batch into ONE AgentsLookupByName call
- *   start->>tx: rpc(AgentsLookupByName, {names})
- *   tx-->>start: {agents}
- *   Note over start: unresolved → exit 64
- *   start->>tx: rpc(TaskRequest, {appId, invitedAgentIds, initialConversation})
- *   tx-->>start: {task, conversation | null}
- *   alt conversation present (fresh create)
- *     Note over start: stdout — Task started — taskId — convId
- *   else conversation null (dedup hit)
- *     start->>tx: rpc(TaskConversationList) — follow nextCursor
- *     tx-->>start: items
- *     Note over start: findReusableConversation — first non-archived under existing taskId
- *     alt found
- *       Note over start: stdout — Task started — reusing existing conversation
- *     else none usable
- *       Note over start: stderr — task closed — exit 1
- *     end
- *   end
- *   opt --message
- *     start->>tx: rpc(MessagesSend, {conversationId, parts})
- *     alt success
- *       Note over start: stdout — Message sent — exit 0
- *     else failure
- *       Note over start: stderr — Error sending message — exit 2
- *     end
- *   end
- * ```
- *
- * **Exit-code contract** — keyed on the stage where the error arose:
- *
- * | Code | Meaning                                                      | Stdout                                  | Stderr                                 |
- * |------|--------------------------------------------------------------|-----------------------------------------|----------------------------------------|
- * |  0   | Full success (fresh create or dedup reuse)                   | `Task started: ...` (+ `Message sent`)  | empty                                  |
- * |  1   | `TaskRequest` wire failure OR dedup hit on closed/unreachable | empty                                   | `Failed: ...` / `Task already exists`  |
- * |  2   | `TaskRequest` OK, `MessagesSend` failed                       | `Task started: ...`                     | `Error sending message: ...`           |
- * |  64  | Usage error: bad `--app-id` UUID, unresolvable agent token, OR more than 100 distinct name tokens | empty | `Invalid --app-id` / `Cannot resolve "..."` |
- *
- * Exit 64 matches POSIX `EX_USAGE`. NO rollback on exit 2 — the task
- * + empty conversation persist; the user can retry
- * `moltzap send conv:&lt;id> &lt;text>`.
- *
- * The exit-code partition is split:
- *
- * - `runStartCommand` (outer `Effect.catchAll`) pattern-matches
- *   `StartCommandError` `_tag` and dispatches to 1 or 64.
- * - Inline `process.exit(2)` lives in the handler body for the
- *   post-`TaskRequest` `MessagesSend` failure. This path cannot route
- *   through `runStartCommand` because the stdout `Task started: ...`
- *   line has already been printed; re-throwing would discard it from
- *   the user's view. The handler uses
- *   `Effect.either(rpc(MessagesSend, ...))` + `Effect.sync(() => { ...
- *   process.exit(2) })`.
- *
- * **Dedup branch** — when `appId === DEFAULT_APP_ID` and the caller
- * already owns a task with the exact same `{caller} ∪ invitedAgentIds`
- * set, the server returns `{ task, conversation: null }`.
- * `handleDedupOutcome` calls `TaskConversationList` (with cursor
- * follow capped at `DEDUP_LOOKUP_MAX_PAGES`) and runs
- * `findReusableConversation` to find a non-archived conversation
- * under the existing task. Found → reuse stdout line; not found →
- * closed-task diagnostic + exit 1.
- *
- * **Zero-participant carve-out** — when `invitedAgentIds === []`, the
- * caller-only task path MUST omit `participants` from
- * `initialConversation` entirely because
- * `InitialConversationSchema.participants` rejects `[]`. The server
- * adds the caller to both `task_participants` and
- * `conversation_participants` implicitly.
- *
- * **Why this doesn't reuse `socket-client.ts → resolveParticipant`** —
- * that helper hard-wires the daemon-socket path
- * (`socket-client.ts → request`), bypassing the CLI `Transport`
- * service that `start.ts` uses for `TaskRequest` / `MessagesSend`.
- * Mixing the two would make `--as`-mode name lookups hit the daemon
- * (potentially absent) and would not be testable via
- * `makeFakeTransport`. The local `resolveAgentTokens` goes through
- * `transport.ts → rpc` instead and coalesces all name-shaped tokens
- * into ONE batched `AgentsLookupByName` call.
- *
- * Sibling: `packages/protocol/src/task/tasks.ts → TaskRequest` /
- * `DEFAULT_APP_ID` / `AppId` — the wire surface this command
- * composes. `commands/conversations.ts → createConversation` — the
- * legacy two-step path D2 replaces (untouched here; D3 deletes it).
- */
 import { Command } from "@effect/cli";
 import { Effect, Option } from "effect";
+import { AppIdV4, type StartParticipant as StartParticipantType } from "../../local-daemon-rpc.js";
 import { type Transport } from "../transport.js";
-/**
- * Parsed CLI arguments for the `start` command. `@effect/cli`'s
- * `Args.repeated` admits zero participants — caller-only tasks are
- * permitted at the wire (Spec D1 per-flow doc 12) but not exercised by
- * spec D2 ACs (which cover `length === 1` DM and `length >= 2` group
- * shapes). Handler MUST NOT reject empty `participants`.
- */
 export interface StartCommandArgs {
     readonly name: string;
-    readonly participants: readonly string[];
+    readonly participants: readonly StartParticipantType[];
     readonly message: string | undefined;
-    readonly appId: string | undefined;
+    readonly appId: AppIdV4 | undefined;
 }
-/**
- * Test seam: invoke the handler directly with parsed args, bypassing
- * `@effect/cli`'s parser. Returns the same `Effect` the `Command.make`
- * wrapper would produce, including the `runStartCommand` exit-code
- * dispatcher. Tests `Effect.provideService(Transport, fake)` and assert
- * `process.exit` was called with the expected code.
- */
-export declare const runStartHandler: (args: StartCommandArgs) => Effect.Effect<void, never, Transport>;
-export declare const startCommand: Command.Command<"start", Transport, never, {
+type StartCommandParsed = {
     readonly name: string;
-    readonly participants: string[];
+    readonly participants: StartParticipantType[];
     readonly message: Option.Option<string>;
-    readonly appId: Option.Option<string>;
-}>;
+    readonly appId: Option.Option<AppIdV4>;
+};
+export declare const runStartHandler: (args: StartCommandArgs) => Effect.Effect<void, never, Transport>;
+export declare const startCommand: Command.Command<"start", Transport, never, StartCommandParsed>;
+export {};
 //# sourceMappingURL=start.d.ts.map

package/dist/cli/commands/start.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/start.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsGG;AACH,OAAO,EAAQ,OAAO,EAAW,MAAM,aAAa,CAAC;AACrD,OAAO,EAAQ,MAAM,EAAU,MAAM,EAAE,MAAM,QAAQ,CAAC;AAetD,OAAO,EAAO,KAAK,SAAS,EAAuB,MAAM,iBAAiB,CAAC;AA0E3E;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AA6iBD;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAC1B,MAAM,gBAAgB,KACrB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,CACK,CAAC;AAE7C,eAAO,MAAM,YAAY;;;;;EA8BxB,CAAC"}
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/start.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,OAAO,EAAW,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EACL,OAAO,EAKP,KAAK,gBAAgB,IAAI,oBAAoB,EAE9C,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAW,KAAK,SAAS,EAAuB,MAAM,iBAAiB,CAAC;AAW/E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACvD,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC;CACrC;AAID,KAAK,kBAAkB,GAAG;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,oBAAoB,EAAE,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;CACxC,CAAC;AAuFF,eAAO,MAAM,eAAe,GAC1B,MAAM,gBAAgB,KACrB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,CACK,CAAC;AAE7C,eAAO,MAAM,YAAY,EAAE,OAAO,CAAC,OAAO,CACxC,OAAO,EACP,SAAS,EACT,KAAK,EACL,kBAAkB,CA0BnB,CAAC"}