replicas-cli 0.2.776 → 0.2.777

package/dist/index.cjs

@@ -23535,6 +23535,48 @@ function skillNamesFromCommand(command) {
   })));
 }
 
+// ../shared/src/uuid.ts
+var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+
+// ../shared/src/automations/trigger-schemas.ts
+var repositoryTriggerConfigSchema = external_exports.object({
+  event: external_exports.string(),
+  repository_ids: external_exports.array(external_exports.string().regex(UUID_RE, "must be a repository id")).optional(),
+  group_pr_events: external_exports.boolean().optional(),
+  excluded_actors: external_exports.array(external_exports.string()).optional()
+});
+var cronTriggerSchema = external_exports.object({ type: external_exports.literal("cron"), config: external_exports.object({ schedule: external_exports.string(), timezone: external_exports.string().optional() }) });
+var githubTriggerSchema = external_exports.object({ type: external_exports.literal("github"), config: repositoryTriggerConfigSchema });
+var gitlabTriggerSchema = external_exports.object({ type: external_exports.literal("gitlab"), config: repositoryTriggerConfigSchema });
+var automationTriggerSchema = external_exports.discriminatedUnion("type", [
+  cronTriggerSchema,
+  githubTriggerSchema,
+  gitlabTriggerSchema,
+  external_exports.object({ type: external_exports.literal("slack"), config: external_exports.object({ event: external_exports.string(), channel_ids: external_exports.array(external_exports.string()).optional(), group_thread_replies: external_exports.boolean().optional() }) }),
+  external_exports.object({ type: external_exports.literal("sentry"), config: external_exports.object({ event: external_exports.string(), project_slugs: external_exports.array(external_exports.string()).optional(), min_level: external_exports.string().optional() }) }),
+  external_exports.object({ type: external_exports.literal("custom"), config: external_exports.object({}) })
+]);
+
+// ../shared/src/replicas-mcp.ts
+var REPLICAS_MCP_SERVER_NAME = "replicas-mcp";
+var REPLICAS_MCP_TOOLS = {
+  listEnvironments: "list_environments",
+  createAutomation: "create_automation",
+  spawn: "spawn_workspace",
+  relay: "relay_to_workspace",
+  linearStart: "start_linear_session",
+  linearSessionIntent: "register_linear_session_intent"
+};
+var automationToolInputSchema = external_exports.object({
+  name: external_exports.string().describe("Short automation name."),
+  prompt: external_exports.string().describe("Prompt each automation run starts with."),
+  environment_id: external_exports.string().describe(`Environment id from \`${REPLICAS_MCP_TOOLS.listEnvironments}\`.`),
+  triggers: external_exports.array(automationTriggerSchema).min(1).describe(
+    'One or more triggers. Cron: `{ "type": "cron", "config": { "schedule": "0 9 * * 1", "timezone": "America/New_York" } }`. GitHub: `{ "type": "github", "config": { "event": "pull_request.opened", "repository_ids": ["<repository uuid>"] } }`.'
+  ),
+  description: external_exports.string().optional().describe("One-line summary shown in the dashboard.")
+});
+
 // ../shared/src/default-skills/replicas-agent/abilities/computer.ts
 var SECTION = `### Computer use (Linux desktop control)
 Drive the workspace's Linux desktop - open a browser, click, type, scroll, screenshot, record - via the \`replicas computer\` CLI. Every Replicas workspace boots with a live H.264 and Opus stream published as an authenticated preview, so a \`Desktop\` tab is always available in the dashboard. Use \`replicas computer info\` to get the viewer URL when you want to share it (e.g. point a user on Slack at the live stream).
@@ -23804,9 +23846,6 @@ var DOCKER_ABILITY = {
   referenceFile: { name: "DOCKER.md", content: REFERENCE2 }
 };
 
-// ../shared/src/uuid.ts
-var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-
 // ../shared/src/routes/environment-setups.ts
 var ENVIRONMENT_SETUP_STEPS = [
   { key: "understand", label: "Understand the codebase" },
@@ -23856,17 +23895,7 @@ var ENVIRONMENT_SETUP_AUTHORED_TRIGGER_TYPES = ["cron", "github", "gitlab"];
 function isEnvironmentSetupAuthoredTriggerType(type) {
   return ENVIRONMENT_SETUP_AUTHORED_TRIGGER_TYPES.some((authored) => authored === type);
 }
-var repositoryTriggerConfigSchema = external_exports.object({
-  event: external_exports.string(),
-  repository_ids: external_exports.array(external_exports.string().regex(UUID_RE, "must be a repository id")).optional(),
-  group_pr_events: external_exports.boolean().optional(),
-  excluded_actors: external_exports.array(external_exports.string()).optional()
-});
-var proposalTriggerSchema = external_exports.discriminatedUnion("type", [
-  external_exports.object({ type: external_exports.literal("cron"), config: external_exports.object({ schedule: external_exports.string(), timezone: external_exports.string().optional() }) }),
-  external_exports.object({ type: external_exports.literal("github"), config: repositoryTriggerConfigSchema }),
-  external_exports.object({ type: external_exports.literal("gitlab"), config: repositoryTriggerConfigSchema })
-]);
+var proposalTriggerSchema = external_exports.discriminatedUnion("type", [cronTriggerSchema, githubTriggerSchema, gitlabTriggerSchema]);
 var existingTriggerSchema = external_exports.custom(
   (value) => isRecord(value) && typeof value.type === "string" && isRecord(value.config),
   "must be an automation trigger"
@@ -25708,6 +25737,13 @@ function removeTag(text2, tag) {
 function removeReplicasInstructions(text2) {
   return removeTag(text2, REPLICAS_INSTRUCTIONS_TAG);
 }
+var mothershipMcpActions = `These are tools of the \`${REPLICAS_MCP_SERVER_NAME}\` MCP server; their argument names match the envelope fields. Call them directly as tools, never through a shell or the Replicas CLI.
+- **Spawn** a dedicated workspace for the thread and hand off: \`${REPLICAS_MCP_TOOLS.spawn}\`, with \`environment_id\` when you chose one.
+- **Relay** a follow-up that is clearly meant for you into the workspace already bound to the thread (pass the envelope's \`user_id\` so it's attributed to its author): \`${REPLICAS_MCP_TOOLS.relay}\`, with \`queue: true\` to queue it.
+- **List environments**: \`${REPLICAS_MCP_TOOLS.listEnvironments}\`.
+- **Create an automation**: \`${REPLICAS_MCP_TOOLS.createAutomation}\`, filling its \`confirmation_*\` arguments from the accepting message's envelope.
+- **Register a Linear session intent**: \`${REPLICAS_MCP_TOOLS.linearSessionIntent}\` with \`comment_id\` and \`action\`.
+- **Start a Linear session**: \`${REPLICAS_MCP_TOOLS.linearStart}\` with \`issue_id\`, \`agent_session_id\`, and \`prompt\`.`;
 
 // ../shared/src/user-message-attachments.ts
 var ATTACHMENT_PLACEHOLDER_REGEX = /^\[\d+ (?:(?:images?|files?)(?: and \d+ files?)? attached|(?:image )?attachments?)\]$/;
@@ -27829,6 +27865,31 @@ var SLASH_COMMANDS = [
   }))
 ];
 
+// ../shared/src/terminal.ts
+var CONTROL_CHARACTERS = /[\u0000-\u001F\u007F-\u009F]/g;
+function sanitizeTerminalLine(value) {
+  return value.replace(CONTROL_CHARACTERS, " ").trim();
+}
+
+// ../shared/src/mothership.ts
+function mothershipWorkspaceLine(workspaceId, workspaceName, webAppUrl) {
+  return `Workspace: ${sanitizeTerminalLine(workspaceName ?? "") || "Workspace"} (${getWorkspaceDashboardUrl(workspaceId, { webAppUrl })})`;
+}
+async function waitForMothershipSpawn(getThreadWorkspace, options) {
+  for (let attempt = 0; attempt < options.attempts; attempt++) {
+    const { workspace_id, workspace_name } = await getThreadWorkspace();
+    if (workspace_id) return `Spawned workspace.
+${mothershipWorkspaceLine(workspace_id, workspace_name, options.webAppUrl)}`;
+    await new Promise((resolve2) => setTimeout(resolve2, 1e3));
+  }
+  return "Workspace spawn requested. The new workspace will take over this Slack thread.";
+}
+function formatMothershipRelayResult(result, webAppUrl) {
+  const folded = result.folded_in ? ` Folded in ${result.folded_in} earlier relay${result.folded_in === 1 ? "" : "s"} that had not started yet.` : "";
+  return `${result.interrupted ? `Interrupted the thread's dedicated workspace and relayed the message.${folded}` : "Relayed to the thread's dedicated workspace."}
+${mothershipWorkspaceLine(result.workspace_id, result.workspace_name, webAppUrl)}`;
+}
+
 // ../shared/src/replicas-config.ts
 var import_yaml = __toESM(require_dist());
 
@@ -27841,12 +27902,6 @@ var HOOK_EXEC_MAX_BUFFER_BYTES = 10 * 1024 * 1024;
 // ../shared/src/replicas-config.ts
 var REPLICAS_CONFIG_FILENAMES = ["replicas.json", "replicas.yaml", "replicas.yml"];
 
-// ../shared/src/terminal.ts
-var CONTROL_CHARACTERS = /[\u0000-\u001F\u007F-\u009F]/g;
-function sanitizeTerminalLine(value) {
-  return value.replace(CONTROL_CHARACTERS, " ").trim();
-}
-
 // ../shared/src/subagent-mcp.ts
 var SUBAGENT_MCP_TOOLS = {
   getProviders: "get_providers",
@@ -27873,7 +27928,7 @@ var headlessAgentRequestSchema = external_exports.object({
 });
 
 // ../shared/src/cli-version.ts
-var CLI_VERSION = "0.2.776";
+var CLI_VERSION = "0.2.777";
 
 // ../shared/src/version.ts
 function compareVersions(v1, v2) {
@@ -27948,6 +28003,41 @@ var linearSessionMetadataSchema = external_exports.object({
   }).optional()
 });
 
+// ../shared/src/routes/mothership.ts
+var MOTHERSHIP_LINEAR_ACTIONS = ["ask", "start"];
+var mothershipLinearSessionIntentRequestSchema = external_exports.object({
+  comment_id: external_exports.string().trim().min(1).describe("Id of the Linear comment the session will be created on."),
+  action: external_exports.enum(MOTHERSHIP_LINEAR_ACTIONS).describe("`ask` when the comment is a clarifying question, `start` when it is the complete task prompt.")
+});
+var mothershipLinearStartRequestSchema = external_exports.object({
+  issue_id: external_exports.string().describe("Linear issue id from the envelope's `issue_id`."),
+  agent_session_id: external_exports.string().describe("Existing Linear agent session id from the envelope's `agent_session_id`."),
+  prompt: external_exports.string().trim().min(1).describe("Complete task prompt for the coding workspace.")
+});
+var slackChannelIdSchema = external_exports.string().describe("Slack channel id from the envelope's `channel_id`.");
+var slackThreadTsSchema = external_exports.string().describe("Slack thread timestamp from the envelope's `thread_ts`.");
+var mothershipSlackSpawnRequestSchema = external_exports.object({
+  channel_id: slackChannelIdSchema,
+  thread_ts: slackThreadTsSchema,
+  message_ts: external_exports.string().describe("Timestamp of the Slack message that asked for the work (the envelope's `message_ts`). The server verifies this message and its author."),
+  user_id: external_exports.string().describe("Slack user id of that message's author (the envelope's `user_id`). The workspace is attributed to them."),
+  prompt: external_exports.string().describe("Complete task for the new workspace, written so it stands on its own."),
+  environment_id: external_exports.string().optional().describe(`Environment id from \`${REPLICAS_MCP_TOOLS.listEnvironments}\`. Pass it only when clearly confident it fits; omit it to let routing choose or ask the person.`)
+});
+var mothershipSlackRelayRequestSchema = external_exports.object({
+  channel_id: slackChannelIdSchema,
+  thread_ts: slackThreadTsSchema,
+  message: external_exports.string().describe("The follow-up to deliver, combining every fresh message that belongs to this update."),
+  user_id: external_exports.string().optional().describe("Slack user id of the follow-up's author (the envelope's `user_id`), so it is attributed to them. Defaults to the thread's original requester."),
+  queue: external_exports.boolean().optional().describe("Set true only when the person explicitly asked for this to happen after the current task finishes. Delivers behind the active turn instead of interrupting it.")
+});
+var mothershipAutomationToolInputSchema = automationToolInputSchema.extend({
+  confirmation_channel_id: external_exports.string().describe("`channel_id` from the envelope of the Slack message that accepted the offer."),
+  confirmation_thread_ts: external_exports.string().describe("`thread_ts` from that message's envelope."),
+  confirmation_message_ts: external_exports.string().describe("`message_ts` from that message's envelope."),
+  confirmation_user_id: external_exports.string().describe("`user_id` from that message's envelope.")
+});
+
 // ../shared/src/routes/plugin-catalog.ts
 var EXPLICIT_PLUGIN_CATALOG = [
   {
@@ -32560,9 +32650,6 @@ async function serviceLogsCommand(name, options) {
 }
 
 // src/commands/mothership.ts
-function workspaceNameForOutput(name) {
-  return sanitizeTerminalLine(name ?? "") || "Workspace";
-}
 async function mothershipMonitorChannelCommand(options) {
   const channel = options.channel?.trim();
   const approvalChannel = options.approvalChannel?.trim();
@@ -32608,18 +32695,12 @@ async function mothershipSpawnCommand(options) {
     method: "POST",
     body
   });
-  for (let attempt = 0; attempt < 60; attempt++) {
-    const result = await agentFetch(
+  console.log(await waitForMothershipSpawn(
+    () => agentFetch(
       `/v1/agent/mothership/thread-workspace?channel_id=${encodeURIComponent(channel)}&thread_ts=${encodeURIComponent(thread)}`
-    );
-    if (result.workspace_id) {
-      console.log(`Spawned workspace.
-Workspace: ${workspaceNameForOutput(result.workspace_name)} (${getWorkspaceDashboardUrl(result.workspace_id, { webAppUrl: process.env.REPLICAS_WEB_URL })})`);
-      return;
-    }
-    await new Promise((resolve2) => setTimeout(resolve2, 1e3));
-  }
-  console.log("Workspace spawn requested. The new workspace will take over this Slack thread.");
+    ),
+    { attempts: 60, webAppUrl: process.env.REPLICAS_WEB_URL }
+  ));
 }
 async function mothershipRelayCommand(options) {
   const channel = options.channel?.trim();
@@ -32640,9 +32721,7 @@ async function mothershipRelayCommand(options) {
     method: "POST",
     body
   });
-  const folded = result.folded_in ? ` Folded in ${result.folded_in} earlier relay${result.folded_in === 1 ? "" : "s"} that had not started yet.` : "";
-  console.log(`${result.interrupted ? `Interrupted the thread's dedicated workspace and relayed the message.${folded}` : "Relayed to the thread's dedicated workspace."}
-Workspace: ${workspaceNameForOutput(result.workspace_name)} (${getWorkspaceDashboardUrl(result.workspace_id, { webAppUrl: process.env.REPLICAS_WEB_URL })})`);
+  console.log(formatMothershipRelayResult(result, process.env.REPLICAS_WEB_URL));
 }
 
 // src/commands/environment.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "replicas-cli",
-  "version": "0.2.776",
+  "version": "0.2.777",
   "description": "CLI for managing Replicas workspaces - SSH into cloud dev environments with automatic port forwarding",
   "main": "dist/index.cjs",
   "bin": {