replicas-engine 0.1.973 → 0.1.975

package/dist/src/{asp-host-DSLWM2EA.js → asp-host-SJQEEEQS.js}

@@ -5,12 +5,12 @@ import {
   getCodexAspHost,
   restartCodexAspHost,
   restartCodexAspHostIfRunning
-} from "./chunk-NHD7MMAW.js";
-import "./chunk-3VGFM7ME.js";
-import "./chunk-4P4NVCXW.js";
-import "./chunk-F4ZGMCND.js";
+} from "./chunk-DQFGKWE5.js";
+import "./chunk-TCG5OMQH.js";
+import "./chunk-ZOOJP2HJ.js";
+import "./chunk-X5MYHFWW.js";
 import "./chunk-UZSNFLDQ.js";
-import "./chunk-RMH6PDA7.js";
+import "./chunk-NTM575B4.js";
 import "./chunk-VEQXQN22.js";
 export {
   getCodexAspHost,

package/dist/src/{chunk-NHD7MMAW.js → chunk-DQFGKWE5.js}

@@ -5,15 +5,15 @@ import {
   ENGINE_ENV,
   monolithRequest,
   setAgentCredentialSnapshot
-} from "./chunk-3VGFM7ME.js";
+} from "./chunk-TCG5OMQH.js";
 import {
   AppServerProcess,
   buildCodexAgentEnv
-} from "./chunk-4P4NVCXW.js";
+} from "./chunk-ZOOJP2HJ.js";
 import {
   SUBPROCESS_MAX_BUFFER,
   execFileAsync
-} from "./chunk-F4ZGMCND.js";
+} from "./chunk-X5MYHFWW.js";
 import {
   isRecord
 } from "./chunk-UZSNFLDQ.js";
@@ -27,7 +27,7 @@ import {
   listOpenAICompatibleModels,
   readOllamaAuthEnv,
   resolveOpenAICompatibleModelsUrl
-} from "./chunk-RMH6PDA7.js";
+} from "./chunk-NTM575B4.js";
 
 // src/managers/codex-token-manager.ts
 import { promises as fs } from "fs";
@@ -260,7 +260,7 @@ var CodexTokenManager = class extends BaseRefreshManager {
     await this.applyCredentialUpdate(++this.credentialGeneration, async () => {
       await this.applyCredentialsResponse(data);
       setAgentCredentialSnapshot("codex", data);
-      const { restartCodexAspHostIfRunning: restartCodexAspHostIfRunning2 } = await import("./asp-host-DSLWM2EA.js");
+      const { restartCodexAspHostIfRunning: restartCodexAspHostIfRunning2 } = await import("./asp-host-SJQEEEQS.js");
       await restartCodexAspHostIfRunning2();
     });
     await this.start(true);
@@ -280,7 +280,7 @@ var CodexTokenManager = class extends BaseRefreshManager {
     await this.applyCredentialUpdate(generation, async () => {
       await this.applyCredentialsResponse(data);
       if (restartOnChange && CODEX_AUTH_ENV_KEYS.some((key, index) => process.env[key] !== previousEnv[index])) {
-        const { restartCodexAspHostIfRunning: restartCodexAspHostIfRunning2 } = await import("./asp-host-DSLWM2EA.js");
+        const { restartCodexAspHostIfRunning: restartCodexAspHostIfRunning2 } = await import("./asp-host-SJQEEEQS.js");
         await restartCodexAspHostIfRunning2();
       }
       setAgentCredentialSnapshot("codex", data);

package/dist/src/{chunk-OKFWM3XR.js → chunk-DTKUVZ6U.js}

@@ -5,7 +5,7 @@ import {
   extractCommandProtectionCommandText,
   isRecord,
   parseCodeHostPrUrl
-} from "./chunk-RMH6PDA7.js";
+} from "./chunk-NTM575B4.js";
 
 // src/services/published-pull-request-urls.ts
 function publishedPullRequestUrls(result) {

package/dist/src/{chunk-RMH6PDA7.js → chunk-NTM575B4.js}

@@ -2637,6 +2637,57 @@ function buildCodeHostPrUrl(repoUrl, provider, prNumber) {
   return `${normalizedRepoUrl}/pull/${prNumber}`;
 }
 
+// ../shared/src/replicas-mcp.ts
+import { z as z10 } from "zod";
+
+// ../shared/src/automations/trigger-schemas.ts
+import { z as z9 } from "zod";
+
+// ../shared/src/uuid.ts
+function createUuidFromHex(value) {
+  return `${value.slice(0, 8)}-${value.slice(8, 12)}-5${value.slice(13, 16)}-${(Number.parseInt(value.slice(16, 17), 16) & 3 | 8).toString(16)}${value.slice(17, 20)}-${value.slice(20, 32)}`;
+}
+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 = z9.object({
+  event: z9.string(),
+  repository_ids: z9.array(z9.string().regex(UUID_RE, "must be a repository id")).optional(),
+  group_pr_events: z9.boolean().optional(),
+  excluded_actors: z9.array(z9.string()).optional()
+});
+var cronTriggerSchema = z9.object({ type: z9.literal("cron"), config: z9.object({ schedule: z9.string(), timezone: z9.string().optional() }) });
+var githubTriggerSchema = z9.object({ type: z9.literal("github"), config: repositoryTriggerConfigSchema });
+var gitlabTriggerSchema = z9.object({ type: z9.literal("gitlab"), config: repositoryTriggerConfigSchema });
+var automationTriggerSchema = z9.discriminatedUnion("type", [
+  cronTriggerSchema,
+  githubTriggerSchema,
+  gitlabTriggerSchema,
+  z9.object({ type: z9.literal("slack"), config: z9.object({ event: z9.string(), channel_ids: z9.array(z9.string()).optional(), group_thread_replies: z9.boolean().optional() }) }),
+  z9.object({ type: z9.literal("sentry"), config: z9.object({ event: z9.string(), project_slugs: z9.array(z9.string()).optional(), min_level: z9.string().optional() }) }),
+  z9.object({ type: z9.literal("custom"), config: z9.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 = z10.object({
+  name: z10.string().describe("Short automation name."),
+  prompt: z10.string().describe("Prompt each automation run starts with."),
+  environment_id: z10.string().describe(`Environment id from \`${REPLICAS_MCP_TOOLS.listEnvironments}\`.`),
+  triggers: z10.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: z10.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).
@@ -2907,15 +2958,7 @@ var DOCKER_ABILITY = {
 };
 
 // ../shared/src/routes/environment-setups.ts
-import { z as z9 } from "zod";
-
-// ../shared/src/uuid.ts
-function createUuidFromHex(value) {
-  return `${value.slice(0, 8)}-${value.slice(8, 12)}-5${value.slice(13, 16)}-${(Number.parseInt(value.slice(16, 17), 16) & 3 | 8).toString(16)}${value.slice(17, 20)}-${value.slice(20, 32)}`;
-}
-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
+import { z as z11 } from "zod";
 var ENVIRONMENT_SETUP_STEPS = [
   { key: "understand", label: "Understand the codebase" },
   { key: "install", label: "Install dependencies and run the app" },
@@ -2949,27 +2992,17 @@ var ENVIRONMENT_SETUP_LIMITS = {
 };
 var ENVIRONMENT_SETUP_VARIABLE_WAIT = { defaultMs: 5 * 6e4, maxMs: 15 * 6e4, pollMs: 5e3 };
 var VARIABLE_KEY_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
-var text = (max) => max === void 0 ? z9.string().trim() : z9.string().trim().max(max);
+var text = (max) => max === void 0 ? z11.string().trim() : z11.string().trim().max(max);
 var requiredText = (max) => text(max).min(1, "must not be empty");
 var optionalText = (max) => text(max).nullish().transform((value) => value || null);
 var clearableText = (max) => text(max).nullish().transform((value) => value === void 0 ? void 0 : value || null);
-var list = (item, max) => max === void 0 ? z9.array(item) : z9.array(item).max(max);
+var list = (item, max) => max === void 0 ? z11.array(item) : z11.array(item).max(max);
 var ENVIRONMENT_SETUP_AUTHORED_TRIGGER_TYPES = ["cron", "github", "gitlab"];
 function isEnvironmentSetupAuthoredTriggerType(type) {
   return ENVIRONMENT_SETUP_AUTHORED_TRIGGER_TYPES.some((authored) => authored === type);
 }
-var repositoryTriggerConfigSchema = z9.object({
-  event: z9.string(),
-  repository_ids: z9.array(z9.string().regex(UUID_RE, "must be a repository id")).optional(),
-  group_pr_events: z9.boolean().optional(),
-  excluded_actors: z9.array(z9.string()).optional()
-});
-var proposalTriggerSchema = z9.discriminatedUnion("type", [
-  z9.object({ type: z9.literal("cron"), config: z9.object({ schedule: z9.string(), timezone: z9.string().optional() }) }),
-  z9.object({ type: z9.literal("github"), config: repositoryTriggerConfigSchema }),
-  z9.object({ type: z9.literal("gitlab"), config: repositoryTriggerConfigSchema })
-]);
-var existingTriggerSchema = z9.custom(
+var proposalTriggerSchema = z11.discriminatedUnion("type", [cronTriggerSchema, githubTriggerSchema, gitlabTriggerSchema]);
+var existingTriggerSchema = z11.custom(
   (value) => isRecord(value) && typeof value.type === "string" && isRecord(value.config),
   "must be an automation trigger"
 );
@@ -2977,17 +3010,17 @@ var carriedTriggerSchema = existingTriggerSchema.refine(
   (trigger) => !isEnvironmentSetupAuthoredTriggerType(trigger.type)
 );
 function automationSchema(limits) {
-  const authored = z9.object({
+  const authored = z11.object({
     name: text(limits.nameChars),
     description: text(limits.descriptionChars),
     prompt: text(limits.automationPromptChars),
     triggers: list(proposalTriggerSchema, limits.automationTriggers)
   });
-  const updated = authored.extend({ triggers: list(z9.union([proposalTriggerSchema, carriedTriggerSchema]), limits.automationTriggers) });
-  return z9.object({
+  const updated = authored.extend({ triggers: list(z11.union([proposalTriggerSchema, carriedTriggerSchema]), limits.automationTriggers) });
+  return z11.object({
     key: requiredText(limits.automationKeyChars),
-    action: z9.enum(ENVIRONMENT_SETUP_AUTOMATION_ACTIONS).default("create"),
-    automation_id: z9.string().regex(UUID_RE, "must be an automation id").nullable().default(null),
+    action: z11.enum(ENVIRONMENT_SETUP_AUTOMATION_ACTIONS).default("create"),
+    automation_id: z11.string().regex(UUID_RE, "must be an automation id").nullable().default(null),
     name: text().default(""),
     description: optionalText().transform((value) => value ?? ""),
     prompt: text().default(""),
@@ -3010,7 +3043,7 @@ function automationSchema(limits) {
     const content = (automation.action === "update" ? updated : authored).safeParse(automation);
     if (content.success) return { ...automation, ...content.data };
     for (const issue of content.error.issues) ctx.addIssue({ ...issue, code: "custom" });
-    return z9.NEVER;
+    return z11.NEVER;
   });
 }
 function automationListSchema(limits) {
@@ -3028,7 +3061,7 @@ function automationListSchema(limits) {
   });
 }
 function environmentSchema(limits) {
-  return z9.object({
+  return z11.object({
     name: optionalText(limits.nameChars).transform((value) => value ?? void 0),
     description: clearableText(limits.descriptionChars),
     system_prompt: clearableText(limits.systemPromptChars),
@@ -3037,26 +3070,26 @@ function environmentSchema(limits) {
   });
 }
 function variableSchema(limits, requiredDefault) {
-  return z9.object({
-    key: z9.string().regex(VARIABLE_KEY_RE, "must be a valid environment variable name").max(limits.variableKeyChars ?? Number.POSITIVE_INFINITY),
+  return z11.object({
+    key: z11.string().regex(VARIABLE_KEY_RE, "must be a valid environment variable name").max(limits.variableKeyChars ?? Number.POSITIVE_INFINITY),
     description: optionalText(limits.variableDescriptionChars).transform((value) => value ?? ""),
-    required: z9.boolean().default(requiredDefault)
+    required: z11.boolean().default(requiredDefault)
   });
 }
 function proposalSchema(limits) {
-  return z9.object({
+  return z11.object({
     summary: requiredText(limits.summaryChars),
     stack: list(text(), limits.stackItems).default([]).transform((items) => items.filter(Boolean)),
     environment: environmentSchema(limits),
     variables: list(variableSchema(limits, false), limits.variables).default([]),
     automations: automationListSchema(limits),
-    verification: list(z9.object({
+    verification: list(z11.object({
       label: requiredText(limits.nameChars),
-      status: z9.enum(ENVIRONMENT_SETUP_VERIFICATION_STATUSES),
+      status: z11.enum(ENVIRONMENT_SETUP_VERIFICATION_STATUSES),
       detail: optionalText(limits.verificationDetailChars).transform((value) => value ?? void 0)
     }), limits.verificationItems).default([]),
-    media: list(z9.object({
-      media_id: z9.string().regex(UUID_RE, "must be a media id"),
+    media: list(z11.object({
+      media_id: z11.string().regex(UUID_RE, "must be a media id"),
       title: requiredText(limits.nameChars)
     }), limits.mediaItems).default([])
   });
@@ -3064,35 +3097,35 @@ function proposalSchema(limits) {
 var environmentSetupProposalSchema = proposalSchema({});
 var environmentSetupProposalSubmissionSchema = proposalSchema(ENVIRONMENT_SETUP_LIMITS);
 var environmentSetupVariableRequestSchema = variableSchema({}, false).extend({
-  status: z9.enum(["pending", "provided", "skipped"]),
-  requested_at: z9.string(),
-  resolved_at: z9.string().nullable().default(null)
+  status: z11.enum(["pending", "provided", "skipped"]),
+  requested_at: z11.string(),
+  resolved_at: z11.string().nullable().default(null)
 });
-var environmentSetupRunStateSchema = z9.object({
-  status: z9.enum(ENVIRONMENT_SETUP_RUN_STATUSES),
-  steps: z9.partialRecord(z9.enum(ENVIRONMENT_SETUP_STEPS.map((step) => step.key)), z9.enum(ENVIRONMENT_SETUP_STEP_STATUSES)).default({}),
+var environmentSetupRunStateSchema = z11.object({
+  status: z11.enum(ENVIRONMENT_SETUP_RUN_STATUSES),
+  steps: z11.partialRecord(z11.enum(ENVIRONMENT_SETUP_STEPS.map((step) => step.key)), z11.enum(ENVIRONMENT_SETUP_STEP_STATUSES)).default({}),
   proposal: environmentSetupProposalSchema.nullable().default(null),
-  applied: z9.object({
-    applied_at: z9.string(),
-    automation_ids: z9.array(z9.string())
+  applied: z11.object({
+    applied_at: z11.string(),
+    automation_ids: z11.array(z11.string())
   }).nullable().default(null),
-  variable_requests: z9.array(environmentSetupVariableRequestSchema).default([])
+  variable_requests: z11.array(environmentSetupVariableRequestSchema).default([])
 });
-var applyEnvironmentSetupRequestSchema = z9.object({
+var applyEnvironmentSetupRequestSchema = z11.object({
   environment: environmentSchema(ENVIRONMENT_SETUP_LIMITS).extend({ name: requiredText(ENVIRONMENT_SETUP_LIMITS.nameChars) }),
-  variables: list(z9.object({ key: z9.string().regex(VARIABLE_KEY_RE), value: z9.string() }), ENVIRONMENT_SETUP_LIMITS.variables).default([]).refine((variables) => new Set(variables.map((variable) => variable.key)).size === variables.length, "must have unique keys").transform((variables) => variables.filter((variable) => variable.value.length > 0)),
+  variables: list(z11.object({ key: z11.string().regex(VARIABLE_KEY_RE), value: z11.string() }), ENVIRONMENT_SETUP_LIMITS.variables).default([]).refine((variables) => new Set(variables.map((variable) => variable.key)).size === variables.length, "must have unique keys").transform((variables) => variables.filter((variable) => variable.value.length > 0)),
   automations: automationListSchema(ENVIRONMENT_SETUP_LIMITS)
 });
-var requestEnvironmentSetupVariablesSchema = z9.object({
+var requestEnvironmentSetupVariablesSchema = z11.object({
   variables: list(variableSchema(ENVIRONMENT_SETUP_LIMITS, true), ENVIRONMENT_SETUP_LIMITS.variables).min(1, "must not be empty")
 }).superRefine(({ variables }, ctx) => {
   if (new Set(variables.map((variable) => variable.key)).size !== variables.length) {
     ctx.addIssue({ code: "custom", path: ["variables"], message: "must have unique keys" });
   }
 });
-var respondEnvironmentSetupVariablesSchema = z9.object({
-  values: z9.record(z9.string().regex(VARIABLE_KEY_RE), z9.string()).default({}),
-  skipped: z9.array(z9.string().regex(VARIABLE_KEY_RE)).default([])
+var respondEnvironmentSetupVariablesSchema = z11.object({
+  values: z11.record(z11.string().regex(VARIABLE_KEY_RE), z11.string()).default({}),
+  skipped: z11.array(z11.string().regex(VARIABLE_KEY_RE)).default([])
 });
 
 // ../shared/src/default-skills/replicas-agent/abilities/environment-setup.ts
@@ -4290,6 +4323,7 @@ Take action *with* Replicas itself \u2014 manage automations, environments (vari
 
 Use this when:
 - The user asks you to create, edit, run, or delete an automation
+- The user asks you to come back to something later ("check back on this in a week", "remind me tomorrow", "tell me when CI is green") \u2014 schedule a follow-up (see *Follow-ups and reminders*)
 - The user asks you to manage environments, environment variables, or environment files
 - The user asks "what envs / repos / automations do I have?"
 - The user asks you to scaffold a \`replicas.json\` / \`replicas.yaml\` in a repo
@@ -4350,6 +4384,7 @@ In agent mode the CLI hides commands that don't make sense for in-workspace agen
 | "Create a new env for my \`acme/web\` repo" | \`replicas environment create <name> -r acme/web\` |
 | "What automations do I have?" | \`replicas automation list\` |
 | "Run my nightly automation now" | \`replicas automation run <id>\` |
+| "Check back on this in a week" | \`replicas automation create ... --in 1w --background --personal\` |
 | "Make an automation that runs every weekday at 9am" | \`replicas automation create\` (interactive) or \`--trigger-cron "0 9 * * 1-5"\` |
 | "Make an automation that runs when a PR opens on \`acme/web\`" | \`replicas automation create ... --trigger-github pull_request.opened --trigger-github-repos acme/web\` |
 | "Make an automation that runs when an MR opens on \`acme/web\`" | \`replicas automation create ... --trigger-gitlab merge_request.opened --trigger-gitlab-repos acme/web\` |
@@ -4461,6 +4496,26 @@ replicas automation create ... --lifecycle default --auto-stop-minutes 30
 
 When the user says "make me an automation that...", default to **picking the environment for them by listing the available envs** and asking only when the user hasn't already pinned one. Same for repos in GitHub triggers. Don't pepper the user with questions you can answer by reading the existing config.
 
+### Follow-ups and reminders
+
+You cannot wait days yourself. When the user asks you to come back to something later, schedule a one-time automation that delivers a prompt back into **this workspace's conversation** at that time, then deletes itself:
+
+\`\`\`bash
+replicas automation create "Re-check PR #142 CI" \\
+  --in 1w \\
+  --background --personal \\
+  --prompt "A week ago the user asked me to re-check CI on https://github.com/acme/web/pull/142 (flaky e2e job 'checkout'). Check the latest run, fix it if it is still failing, and summarize the result for the user."
+\`\`\`
+
+- \`--in <duration>\` (\`30m\`, \`2h\`, \`3d\`, \`1w\`, \`1d12h\`) or \`--at <ISO-8601 with offset>\` (e.g. "tomorrow at 9am" \u2192 \`--at 2026-10-08T09:00:00-07:00\`, using the user's timezone if you know it; otherwise say which timezone you assumed).
+- Inside a workspace, one-time follow-ups default to \`--workspace current\`, so you resume with this conversation's context. Inside a workspace, \`--environment\` defaults to this workspace's environment (same repositories), including for \`--workspace new\` and \`reuse\`.
+- Write \`--prompt\` as instructions to your future self: the links, what to check, what "done" looks like, and how to report back (e.g. reply in the original Slack thread). It runs with no memory of why it was scheduled beyond what you write.
+- \`--background\` keeps offhand reminders out of the user's main automations list (they are still visible under **Background**). Omit it for things the user should see and manage, such as ongoing monitoring they asked for.
+- \`--personal\` makes the automation the user's own. Omit it only when the follow-up belongs to the organization.
+- Recurring with an end: \`--trigger-cron "0 9 * * *" --max-runs 5 --workspace current\` runs daily five times, then deletes itself. \`--workspace reuse\` creates one new workspace on the first run and sends every later run to it; \`--workspace new\` (the default for non-one-time automations) creates a fresh workspace per run.
+- Only schedule when the user asked for a follow-up or clearly agreed to one; not for "maybe I'll look at this later".
+- Confirm using the **Next Run** time the CLI prints, not your own arithmetic. Cancel with \`replicas automation delete <id> --force\`; find them with \`replicas automation list --background true\`.
+
 ### Edit
 
 \`\`\`bash
@@ -4563,7 +4618,7 @@ var SENTRY_ABILITY = {
 };
 
 // ../shared/src/memory.ts
-import { z as z10 } from "zod";
+import { z as z12 } from "zod";
 
 // ../shared/src/sandbox.ts
 var SANDBOX_LIFECYCLE = {
@@ -4585,11 +4640,11 @@ var INVALID_WORKSPACE_SIZE_ERROR = `Invalid size: must be one of ${WORKSPACE_SIZ
 // ../shared/src/memory.ts
 var HISTORY_ROOT = `${SANDBOX_PATHS.REPLICAS_DIR}/history`;
 var HISTORY_INDEX_FILENAME = "INDEX.md";
-var memoryExtractionResultSchema = z10.object({
-  summary: z10.string().nullable(),
-  indexEntry: z10.string().nullable()
+var memoryExtractionResultSchema = z12.object({
+  summary: z12.string().nullable(),
+  indexEntry: z12.string().nullable()
 });
-var { $schema: _, ...MEMORY_EXTRACTION_SCHEMA } = z10.toJSONSchema(memoryExtractionResultSchema);
+var { $schema: _, ...MEMORY_EXTRACTION_SCHEMA } = z12.toJSONSchema(memoryExtractionResultSchema);
 
 // ../shared/src/default-skills/replicas-agent/abilities/session-history.ts
 var SECTION12 = `### Session history
@@ -4813,6 +4868,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?)\]$/;
@@ -7786,7 +7848,7 @@ var CLAUDE_AUTH_ENV_KEYS_BY_METHOD = {
 };
 
 // ../shared/src/routes/command-protection.ts
-import { z as z11 } from "zod";
+import { z as z13 } from "zod";
 
 // ../shared/src/git-invocations.ts
 var COMMIT_VALUE_OPTIONS = /* @__PURE__ */ new Set(["message", "file", "trailer", "reuse-message", "reedit-message", "fixup", "squash", "template", "author", "date", "cleanup", "pathspec-from-file"]);
@@ -7877,27 +7939,27 @@ function findCheckoutTarget(args) {
 }
 
 // ../shared/src/routes/command-protection.ts
-var commandProtectionRepoStateSchema = z11.object({
-  branch: z11.string().nullable(),
-  defaultBranch: z11.string().nullable(),
-  pushBranch: z11.string().nullable(),
-  pushConfig: z11.string().nullable(),
-  headMessage: z11.string().nullable(),
-  mergeInProgress: z11.boolean().optional()
+var commandProtectionRepoStateSchema = z13.object({
+  branch: z13.string().nullable(),
+  defaultBranch: z13.string().nullable(),
+  pushBranch: z13.string().nullable(),
+  pushConfig: z13.string().nullable(),
+  headMessage: z13.string().nullable(),
+  mergeInProgress: z13.boolean().optional()
 });
-var commandProtectionEvaluateRequestSchema = z11.object({
-  provider: z11.enum(["claude", "codex", "cursor", "opencode", "pi"]),
-  source: z11.enum(["claude_pre_tool_use", "codex_approval_request", "cursor_pre_tool_use", "opencode_pre_tool_use", "pi_tool_call"]),
-  toolName: z11.string(),
-  toolInput: z11.unknown(),
-  command: z11.string().nullish(),
-  cwd: z11.string().nullish(),
-  toolUseId: z11.string().nullish(),
+var commandProtectionEvaluateRequestSchema = z13.object({
+  provider: z13.enum(["claude", "codex", "cursor", "opencode", "pi"]),
+  source: z13.enum(["claude_pre_tool_use", "codex_approval_request", "cursor_pre_tool_use", "opencode_pre_tool_use", "pi_tool_call"]),
+  toolName: z13.string(),
+  toolInput: z13.unknown(),
+  command: z13.string().nullish(),
+  cwd: z13.string().nullish(),
+  toolUseId: z13.string().nullish(),
   // Read by the engine before the command runs, keyed by absolute path, so the
   // policy can see branches and commit messages the command text only references.
-  gitContext: z11.object({
-    repos: z11.record(z11.string(), commandProtectionRepoStateSchema),
-    messageFiles: z11.record(z11.string(), z11.string())
+  gitContext: z13.object({
+    repos: z13.record(z13.string(), commandProtectionRepoStateSchema),
+    messageFiles: z13.record(z13.string(), z13.string())
   }).optional()
 });
 var COMMAND_PROTECTION_COMMAND_KEYS = ["command", "cmd", "script", "query", "endpoint", "path", "url", "mutation"];
@@ -8094,41 +8156,77 @@ function shouldRefreshPullRequests(toolName, toolInput) {
 }
 
 // ../shared/src/routes/linear.ts
-import { z as z12 } from "zod";
-var linearSessionMetadataSchema = z12.object({
-  via_mothership: z12.boolean().optional(),
-  issue_id: z12.string(),
-  issue_identifier: z12.string(),
-  issue_title: z12.string(),
-  issue_description: z12.string(),
-  issue_url: z12.string(),
-  comment_id: z12.string(),
-  comment_body: z12.string(),
-  triggered_by_id: z12.string().optional(),
-  triggered_by_name: z12.string().optional(),
-  triggered_by_email: z12.string().optional(),
-  linear_workspace_id: z12.string().optional(),
-  creator_id: z12.string().optional(),
-  creator_name: z12.string().optional(),
-  creator_email: z12.string().optional(),
-  assignee_id: z12.string().optional(),
-  assignee_name: z12.string().optional(),
-  assignee_email: z12.string().optional(),
-  issue_state: z12.string().optional(),
-  parent_issue: z12.object({
-    id: z12.string(),
-    identifier: z12.string(),
-    title: z12.string(),
-    description: z12.string().nullable()
+import { z as z14 } from "zod";
+var linearSessionMetadataSchema = z14.object({
+  via_mothership: z14.boolean().optional(),
+  issue_id: z14.string(),
+  issue_identifier: z14.string(),
+  issue_title: z14.string(),
+  issue_description: z14.string(),
+  issue_url: z14.string(),
+  comment_id: z14.string(),
+  comment_body: z14.string(),
+  triggered_by_id: z14.string().optional(),
+  triggered_by_name: z14.string().optional(),
+  triggered_by_email: z14.string().optional(),
+  linear_workspace_id: z14.string().optional(),
+  creator_id: z14.string().optional(),
+  creator_name: z14.string().optional(),
+  creator_email: z14.string().optional(),
+  assignee_id: z14.string().optional(),
+  assignee_name: z14.string().optional(),
+  assignee_email: z14.string().optional(),
+  issue_state: z14.string().optional(),
+  parent_issue: z14.object({
+    id: z14.string(),
+    identifier: z14.string(),
+    title: z14.string(),
+    description: z14.string().nullable()
   }).optional(),
-  workspace: z12.object({
-    id: z12.string(),
-    coding_agent: z12.custom((value) => typeof value === "string" && isValidAgentProvider(value)),
-    task_description: z12.string(),
-    created_at: z12.string()
+  workspace: z14.object({
+    id: z14.string(),
+    coding_agent: z14.custom((value) => typeof value === "string" && isValidAgentProvider(value)),
+    task_description: z14.string(),
+    created_at: z14.string()
   }).optional()
 });
 
+// ../shared/src/routes/mothership.ts
+import { z as z15 } from "zod";
+var MOTHERSHIP_LINEAR_ACTIONS = ["ask", "start"];
+var mothershipLinearSessionIntentRequestSchema = z15.object({
+  comment_id: z15.string().trim().min(1).describe("Id of the Linear comment the session will be created on."),
+  action: z15.enum(MOTHERSHIP_LINEAR_ACTIONS).describe("`ask` when the comment is a clarifying question, `start` when it is the complete task prompt.")
+});
+var mothershipLinearStartRequestSchema = z15.object({
+  issue_id: z15.string().describe("Linear issue id from the envelope's `issue_id`."),
+  agent_session_id: z15.string().describe("Existing Linear agent session id from the envelope's `agent_session_id`."),
+  prompt: z15.string().trim().min(1).describe("Complete task prompt for the coding workspace.")
+});
+var slackChannelIdSchema = z15.string().describe("Slack channel id from the envelope's `channel_id`.");
+var slackThreadTsSchema = z15.string().describe("Slack thread timestamp from the envelope's `thread_ts`.");
+var mothershipSlackSpawnRequestSchema = z15.object({
+  channel_id: slackChannelIdSchema,
+  thread_ts: slackThreadTsSchema,
+  message_ts: z15.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: z15.string().describe("Slack user id of that message's author (the envelope's `user_id`). The workspace is attributed to them."),
+  prompt: z15.string().describe("Complete task for the new workspace, written so it stands on its own."),
+  environment_id: z15.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 = z15.object({
+  channel_id: slackChannelIdSchema,
+  thread_ts: slackThreadTsSchema,
+  message: z15.string().describe("The follow-up to deliver, combining every fresh message that belongs to this update."),
+  user_id: z15.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: z15.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: z15.string().describe("`channel_id` from the envelope of the Slack message that accepted the offer."),
+  confirmation_thread_ts: z15.string().describe("`thread_ts` from that message's envelope."),
+  confirmation_message_ts: z15.string().describe("`message_ts` from that message's envelope."),
+  confirmation_user_id: z15.string().describe("`user_id` from that message's envelope.")
+});
+
 // ../shared/src/routes/plugin-catalog.ts
 var EXPLICIT_PLUGIN_CATALOG = [
   {
@@ -8435,7 +8533,7 @@ var MAX_CLIENT_STATE_REQUEST_BYTES = 5 * 1024 * 1024;
 var MAX_CLIENT_STATE_BYTES_PER_USER = 10 * 1024 * 1024;
 
 // ../shared/src/routes/workspaces.ts
-import { z as z13 } from "zod";
+import { z as z16 } from "zod";
 var WORKSPACE_STATUSES = ["active", "sleeping", "archived", "preparing", "error"];
 var WORKSPACE_STATUS_FILTERS = WORKSPACE_STATUSES.map((status) => status === "error" ? "failed" : status);
 var WORKSPACE_SORT_CHOICES = [
@@ -8459,56 +8557,56 @@ var DEFAULT_WORKSPACE_FILTERS = {
   activity: "any"
 };
 var ONE_DAY_MS = 24 * 60 * 60 * 1e3;
-var terminalRtcCandidateSchema = z13.object({ type: z13.literal("rtc-candidate"), candidate: z13.string(), mid: z13.string() });
-var terminalSocketServerMessageSchema = z13.discriminatedUnion("type", [
-  z13.object({ type: z13.literal("output"), data: z13.string() }),
-  z13.object({ type: z13.literal("rtc-answer"), sdp: z13.string() }),
+var terminalRtcCandidateSchema = z16.object({ type: z16.literal("rtc-candidate"), candidate: z16.string(), mid: z16.string() });
+var terminalSocketServerMessageSchema = z16.discriminatedUnion("type", [
+  z16.object({ type: z16.literal("output"), data: z16.string() }),
+  z16.object({ type: z16.literal("rtc-answer"), sdp: z16.string() }),
   terminalRtcCandidateSchema,
-  z13.object({ type: z13.literal("rtc-switch") })
+  z16.object({ type: z16.literal("rtc-switch") })
 ]);
 var TERMINAL_RTC_ICE_SERVER = "stun:stun.l.google.com:19302";
 
 // ../shared/src/routes/workspace-events.ts
-import { z as z14 } from "zod";
-var workspaceChangedEventSchema = z14.discriminatedUnion("type", [
-  z14.object({
-    type: z14.literal("workspace.changed"),
-    workspaceId: z14.string(),
-    completion: z14.object({
-      workspaceName: z14.string(),
-      completedAt: z14.string(),
-      processing: z14.boolean().optional()
+import { z as z17 } from "zod";
+var workspaceChangedEventSchema = z17.discriminatedUnion("type", [
+  z17.object({
+    type: z17.literal("workspace.changed"),
+    workspaceId: z17.string(),
+    completion: z17.object({
+      workspaceName: z17.string(),
+      completedAt: z17.string(),
+      processing: z17.boolean().optional()
     }).optional(),
-    ts: z14.string()
+    ts: z17.string()
   }),
-  z14.object({
-    type: z14.literal("workspace.chat.changed"),
-    workspaceId: z14.string(),
-    chatId: z14.string(),
-    ts: z14.string()
+  z17.object({
+    type: z17.literal("workspace.chat.changed"),
+    workspaceId: z17.string(),
+    chatId: z17.string(),
+    ts: z17.string()
   }),
-  z14.object({ type: z14.literal("presence.changed"), ts: z14.string() }),
-  z14.object({
-    type: z14.literal("mobile-testing.changed"),
-    workspaceId: z14.string(),
-    ts: z14.string()
+  z17.object({ type: z17.literal("presence.changed"), ts: z17.string() }),
+  z17.object({
+    type: z17.literal("mobile-testing.changed"),
+    workspaceId: z17.string(),
+    ts: z17.string()
   })
 ]);
 
 // ../shared/src/routes/presence.ts
-import { z as z15 } from "zod";
-var presenceStatusSchema = z15.enum(["online", "typing"]);
-var presenceLocationSchema = z15.object({
-  environmentId: z15.string().optional(),
-  workspaceId: z15.string().optional()
+import { z as z18 } from "zod";
+var presenceStatusSchema = z18.enum(["online", "typing"]);
+var presenceLocationSchema = z18.object({
+  environmentId: z18.string().optional(),
+  workspaceId: z18.string().optional()
 });
-var presenceEntrySchema = z15.object({
-  userId: z15.string(),
+var presenceEntrySchema = z18.object({
+  userId: z18.string(),
   status: presenceStatusSchema,
   location: presenceLocationSchema,
-  ts: z15.string()
+  ts: z18.string()
 });
-var updatePresenceRequestSchema = z15.object({
+var updatePresenceRequestSchema = z18.object({
   status: presenceStatusSchema,
   location: presenceLocationSchema.optional()
 });

package/dist/src/{chunk-T65P3LSH.js → chunk-OXFR4PCR.js}

@@ -3,18 +3,18 @@ import { createRequire as __createRequire } from 'node:module';
 const require = __createRequire(import.meta.url);
 import {
   monolithRequest
-} from "./chunk-3VGFM7ME.js";
+} from "./chunk-TCG5OMQH.js";
 import {
   SUBPROCESS_MAX_BUFFER,
   execFileAsync
-} from "./chunk-F4ZGMCND.js";
+} from "./chunk-X5MYHFWW.js";
 import {
   extractCommandProtectionCommandText,
   findCommandProtectionGitLookups,
   findGitCommitSignals,
   findPrMergeSignals,
   parseCommandProtectionRequest
-} from "./chunk-RMH6PDA7.js";
+} from "./chunk-NTM575B4.js";
 
 // src/services/command-protection-service.ts
 import { readFile, stat } from "fs/promises";

package/dist/src/{chunk-3VGFM7ME.js → chunk-TCG5OMQH.js}

@@ -14,7 +14,7 @@ import {
   isValidAgentProvider,
   parsePosixEnvFile,
   readReplicasRuntimeEnv
-} from "./chunk-RMH6PDA7.js";
+} from "./chunk-NTM575B4.js";
 
 // src/runtime-env-loader.ts
 import { readFileSync } from "fs";

package/dist/src/{chunk-F4ZGMCND.js → chunk-X5MYHFWW.js}

@@ -3,7 +3,7 @@ import { createRequire as __createRequire } from 'node:module';
 const require = __createRequire(import.meta.url);
 import {
   HOOK_EXEC_MAX_BUFFER_BYTES
-} from "./chunk-RMH6PDA7.js";
+} from "./chunk-NTM575B4.js";
 
 // src/utils/exec.ts
 import { exec, execFile } from "child_process";

package/dist/src/{chunk-4P4NVCXW.js → chunk-ZOOJP2HJ.js}

@@ -3,10 +3,10 @@ import { createRequire as __createRequire } from 'node:module';
 const require = __createRequire(import.meta.url);
 import {
   execFileAsync
-} from "./chunk-F4ZGMCND.js";
+} from "./chunk-X5MYHFWW.js";
 import {
   isVersionBelow
-} from "./chunk-RMH6PDA7.js";
+} from "./chunk-NTM575B4.js";
 
 // src/utils/codex-agent-env.ts
 function buildCodexAgentEnv(source = process.env) {
@@ -240,7 +240,7 @@ function getCodexModelProvider(method) {
   if (method === "foundry") return "azure";
   return method === "ollama" || method === "openai-compatible" ? "replicas_openai_compatible" : "openai";
 }
-var ENGINE_PACKAGE_VERSION = "0.1.973";
+var ENGINE_PACKAGE_VERSION = "0.1.975";
 var INITIALIZE_METHOD = "initialize";
 var INITIALIZED_NOTIFICATION = "initialized";
 var ACCOUNT_LOGIN_START_METHOD = "account/login/start";

package/dist/src/command-protection-hook.js

@@ -3,13 +3,13 @@ import { createRequire as __createRequire } from 'node:module';
 const require = __createRequire(import.meta.url);
 import {
   evaluateCommandProtection
-} from "./chunk-T65P3LSH.js";
-import "./chunk-3VGFM7ME.js";
-import "./chunk-F4ZGMCND.js";
+} from "./chunk-OXFR4PCR.js";
+import "./chunk-TCG5OMQH.js";
+import "./chunk-X5MYHFWW.js";
 import {
   isRecord
 } from "./chunk-UZSNFLDQ.js";
-import "./chunk-RMH6PDA7.js";
+import "./chunk-NTM575B4.js";
 import "./chunk-VEQXQN22.js";
 
 // src/command-protection-hook.ts

package/dist/src/headless-agent.js

@@ -7,12 +7,12 @@ import {
 import {
   AppServerProcess,
   buildCodexAgentEnv
-} from "./chunk-4P4NVCXW.js";
-import "./chunk-F4ZGMCND.js";
+} from "./chunk-ZOOJP2HJ.js";
+import "./chunk-X5MYHFWW.js";
 import {
   AGENT,
   headlessAgentRequestSchema
-} from "./chunk-RMH6PDA7.js";
+} from "./chunk-NTM575B4.js";
 import "./chunk-VEQXQN22.js";
 
 // src/headless-agent.ts

package/dist/src/index.js

@@ -32,7 +32,7 @@ import {
   reportCommandProtectionBlock,
   resolveDiffBase,
   runGitCommand
-} from "./chunk-T65P3LSH.js";
+} from "./chunk-OXFR4PCR.js";
 import {
   ACCOUNT_RATE_LIMITS_UPDATED_METHOD,
   AGENT_MESSAGE_DELTA_METHOD,
@@ -57,7 +57,7 @@ import {
 } from "./chunk-P73LGPQO.js";
 import {
   publishedPullRequestUrls
-} from "./chunk-OKFWM3XR.js";
+} from "./chunk-DTKUVZ6U.js";
 import {
   BaseRefreshManager,
   CodexAspAuthMethodChangedError,
@@ -72,7 +72,7 @@ import {
   refreshDelayMs,
   restartCodexAspHost,
   routineRefreshExclusions
-} from "./chunk-NHD7MMAW.js";
+} from "./chunk-DQFGKWE5.js";
 import {
   ENGINE_ENV,
   monolithRequest,
@@ -80,16 +80,16 @@ import {
   readRuntimeEnvFile,
   reloadEngineEnv,
   setAgentCredentialSnapshot
-} from "./chunk-3VGFM7ME.js";
+} from "./chunk-TCG5OMQH.js";
 import {
   AspClient,
   getCodexModelProvider
-} from "./chunk-4P4NVCXW.js";
+} from "./chunk-ZOOJP2HJ.js";
 import {
   SUBPROCESS_MAX_BUFFER,
   execAsync,
   execFileAsync
-} from "./chunk-F4ZGMCND.js";
+} from "./chunk-X5MYHFWW.js";
 import {
   isRecord as isRecord2
 } from "./chunk-UZSNFLDQ.js";
@@ -310,7 +310,7 @@ import {
   workspaceCredentialProviderSchema,
   workspaceTokenRequestSchema,
   workspaceTokenResponseSchema
-} from "./chunk-RMH6PDA7.js";
+} from "./chunk-NTM575B4.js";
 import {
   cloneMcpConfig,
   ensureCompatibilityImports,

package/dist/src/post-tool-pr-hook.js

@@ -3,13 +3,13 @@ import { createRequire as __createRequire } from 'node:module';
 const require = __createRequire(import.meta.url);
 import {
   publishedPullRequestUrls
-} from "./chunk-OKFWM3XR.js";
+} from "./chunk-DTKUVZ6U.js";
 import {
   isRecord
 } from "./chunk-UZSNFLDQ.js";
 import {
   shouldRefreshPullRequests
-} from "./chunk-RMH6PDA7.js";
+} from "./chunk-NTM575B4.js";
 import "./chunk-VEQXQN22.js";
 
 // src/services/post-tool-pr-notifier.ts

package/dist/src/subagent-mcp.js

@@ -9,7 +9,7 @@ import {
   spawnSubagentRequestSchema,
   subagentResponseSchema,
   waitSubagentRequestSchema
-} from "./chunk-RMH6PDA7.js";
+} from "./chunk-NTM575B4.js";
 import "./chunk-VEQXQN22.js";
 
 // src/subagent-mcp.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "replicas-engine",
-  "version": "0.1.973",
+  "version": "0.1.975",
   "description": "Lightweight API server for Replicas workspaces",
   "type": "module",
   "main": "dist/src/index.js",