usebeeline 0.0.31 → 0.0.32

package/dist/usebeeline.mjs

@@ -4171,15 +4171,22 @@ var BEELINE_ROOM_CAPABILITIES = [
   "The repository filesystem is read-only in this Room session.",
   "You may address any Room member, including another agent, by writing @name in your reply; the server routes that mention to them.",
   "Tag another agent only when you need something from them: a question, a handoff, a task. Never tag to acknowledge, agree, or say you are ready. If nothing is actionable, do not reply.",
+  "Tag the user only when you need a decision or input, or when the task they asked for is finished. Never tag for progress, acknowledgement, or questions the transcript already answers.",
   "The beeline-readonly-mcp inspection tools and beeline-agent Room action tools are mounted. You can use beeline-readonly-mcp to search and read the bound repository without opening a corner; beeline-agent provides the host-governed Room actions.",
+  "To send a file, call beeline-agent attach_file with a path inside your checkout; it is attached to your reply.",
   "When repository work is needed, you MUST call beeline-agent open_corner with a one-paragraph summary of the complete objective. The host-governed call is the only way to start write work.",
   "Never claim an action or reply happened unless the prompt or a tool result proves it."
 ].join(" ");
-var BEELINE_CAPABILITIES_PRIMER = `Consult the release-versioned using-beeline skill (SKILL.md) when you need the managed Room mechanics. ${BEELINE_ROOM_CAPABILITIES}`;
-function beelineCapabilityContextForHarness(agentCommand) {
+function beelinePrimer(repository) {
+  const repositoryLine = repository ? ` This Room is bound to ${repository.name} (branch ${repository.branch}); you have a read-only checkout at the session root.` : "";
+  return `Consult the release-versioned using-beeline skill (SKILL.md) when you need the managed Room mechanics. ${BEELINE_ROOM_CAPABILITIES}${repositoryLine}`;
+}
+var BEELINE_CAPABILITIES_PRIMER = beelinePrimer();
+function beelineCapabilityContextForHarness(agentCommand, repository) {
+  const primer = beelinePrimer(repository);
   return {
-    sessionPrompt: BEELINE_CAPABILITIES_PRIMER,
-    ...harnessHonorsSessionSystemPrompt(agentCommand) ? {} : { compatibilityTurnPrefix: BEELINE_CAPABILITIES_PRIMER }
+    sessionPrompt: primer,
+    ...harnessHonorsSessionSystemPrompt(agentCommand) ? {} : { compatibilityTurnPrefix: primer }
   };
 }
 function runningBeelineReleaseId(env = process.env, read = (path) => readFileSync3(path, "utf8")) {
@@ -4821,27 +4828,25 @@ function isReadOnlyMcpPermissionRequest(request) {
   }
   return false;
 }
+var AGENT_SURFACE_TOOL_NAMES = ["open_corner", "pr_checks_status", "attach_file"];
 function isBeelineAgentMcpPermissionRequest(request) {
   const toolCall = request.toolCall;
   const title = toolCall?.title?.trim() ?? "";
   const rawInput = toolCall?.rawInput;
   if (rawInput && typeof rawInput === "object" && !Array.isArray(rawInput)) {
     const call = rawInput;
-    if (call.server === BEELINE_AGENT_MCP_SERVER_NAME && (call.tool === "open_corner" || call.tool === "pr_checks_status")) {
+    if (call.server === BEELINE_AGENT_MCP_SERVER_NAME && typeof call.tool === "string" && AGENT_SURFACE_TOOL_NAMES.includes(call.tool)) {
       return true;
     }
   }
   if (shellPayload(toolCall))
     return false;
   const normalized = BEELINE_AGENT_MCP_SERVER_NAME.replaceAll("-", "_");
-  return [
-    `mcp__${BEELINE_AGENT_MCP_SERVER_NAME}__open_corner`,
-    `mcp__${normalized}__open_corner`,
-    `mcp.${BEELINE_AGENT_MCP_SERVER_NAME}.open_corner`,
-    `mcp__${BEELINE_AGENT_MCP_SERVER_NAME}__pr_checks_status`,
-    `mcp__${normalized}__pr_checks_status`,
-    `mcp.${BEELINE_AGENT_MCP_SERVER_NAME}.pr_checks_status`
-  ].includes(title);
+  return AGENT_SURFACE_TOOL_NAMES.flatMap((tool) => [
+    `mcp__${BEELINE_AGENT_MCP_SERVER_NAME}__${tool}`,
+    `mcp__${normalized}__${tool}`,
+    `mcp.${BEELINE_AGENT_MCP_SERVER_NAME}.${tool}`
+  ]).includes(title);
 }
 
 // apps/body/dist/room-session.js
@@ -4864,7 +4869,8 @@ function beelineAgentMcpServer(config, api, context) {
       { name: "BEELINE_DAEMON_AGENT_ID", value: connection.agentId },
       { name: "BEELINE_DAEMON_ROOM_ID", value: context.roomId },
       { name: "BEELINE_DAEMON_WORKSPACE_ID", value: context.workspaceId },
-      ...context.cornerId ? [{ name: "BEELINE_DAEMON_CORNER_ID", value: context.cornerId }] : []
+      ...context.cornerId ? [{ name: "BEELINE_DAEMON_CORNER_ID", value: context.cornerId }] : [],
+      ...context.attachRoot ? [{ name: "BEELINE_ATTACH_ROOT", value: context.attachRoot }] : []
     ]
   };
 }
@@ -14020,6 +14026,10 @@ async function cornerToolActivity(call, worktreePath) {
     ...paths.length ? { files: paths.map((path) => ({ path })) } : {}
   };
 }
+var CORNER_CLOSE_POLL_BASE_MS = 12e3;
+function cornerClosePollMs(random = Math.random) {
+  return CORNER_CLOSE_POLL_BASE_MS + Math.floor(random() * 3e3);
+}
 var MonolithCornerTurnLoop = class {
   options;
   agent;
@@ -14133,7 +14143,8 @@ var MonolithCornerTurnLoop = class {
       beelineAgentMcpServer(this.options.config, this.options.api, {
         roomId: this.options.parentRoomId,
         workspaceId: this.options.workspaceId,
-        cornerId: this.options.cornerId
+        cornerId: this.options.cornerId,
+        attachRoot: this.options.worktreePath
       })
     ];
     const self = roster.members.find((member) => member.identityId === this.agent.publicKey);
@@ -14150,6 +14161,7 @@ var MonolithCornerTurnLoop = class {
         "PR-opening turn rule: as soon as a pull request exists, print its full GitHub URL as your final response and end the turn immediately. Do not call pr_checks_status in that same turn and do not wait for checks inside it. Then stay idle until a later corner fact or human message starts another turn.",
         'Never merge because local tests pass or because gh reports passing checks. On a later turn triggered by a server-posted checks-passed note, call beeline-agent pr_checks_status. Merge only when it returns checks="passed", held=false, and approvalPending=false.',
         "If any human in this corner says hold or do not merge, do not merge until a later human explicitly resumes it.",
+        "Do not tag the user when a corner turn finishes: the server posts the merge summary card and its push already cover completion. Tag a human only mid-turn, and only when you need a decision or input.",
         "A human approval in the app asks the server to merge. When approval is pending, wait for the server close request instead of racing it with gh. If checks passed, no hold exists, and no approval is pending, merge the pull request yourself with gh.",
         "Never push directly to the target branch. Never merge a different pull request."
       ].filter(Boolean).join("\n\n")
@@ -14203,7 +14215,7 @@ ${trigger}`,
           "Continue the objective. Obey the PR checks and human hold rules in your session instructions."
         ].filter(Boolean).join("\n\n");
         const sessionId = this.sessionId;
-        const turnId = `${this.agent.publicKey}:${cornerId}`;
+        const turnId = requestId;
         const publishedToolCalls = /* @__PURE__ */ new Set();
         const publishToolCalls = (calls, settledOnly) => {
           calls.forEach((call, index) => {
@@ -14293,6 +14305,7 @@ ${pullRequest}`,
       await this.prompt(history.items.find((item) => item.requestId)?.requestId ?? cornerId.replaceAll("-", ""), this.options.objective);
     }
     try {
+      let pollWithoutWait = false;
       while (!signal?.aborted) {
         try {
           const inbox = await api.execute("getCornerCloseRequests", {
@@ -14314,14 +14327,18 @@ ${pullRequest}`,
               if (!authority.member || authority.principalKind !== "human")
                 continue;
               await this.prompt(item.id, item.body);
+              pollWithoutWait = true;
               continue;
             }
-            if (/\bchecks?\b/i.test(item.body))
+            if (/\bchecks?\b/i.test(item.body)) {
               await this.prompt(item.id, item.body);
+              pollWithoutWait = true;
+            }
           }
           cursor3 = inbox.cursor ?? cursor3;
           this.options.onPoll();
-          await wait(this.options.pollMs ?? 1e3, signal);
+          await wait(pollWithoutWait ? 0 : this.options.pollMs ?? cornerClosePollMs(), signal);
+          pollWithoutWait = false;
         } catch (error) {
           if (signal?.aborted)
             break;
@@ -14364,7 +14381,7 @@ function escapeRegExp(value) {
 function agentReplyMentionIds(text2, roster, authorId) {
   const aliases = /* @__PURE__ */ new Map();
   for (const member of roster.members) {
-    if (member.kind !== "agent" || member.identityId === authorId)
+    if (member.identityId === authorId)
       continue;
     for (const raw of [member.name, member.handle, member.soul?.name]) {
       const display = raw?.trim().replace(/^@/, "");
@@ -14428,12 +14445,13 @@ var MonolithRoomTurnLoop = class {
   async activate() {
     if (this.client?.isAlive && this.sessionId)
       return this.sessionId;
-    const [configuration, roster] = await Promise.all([
+    const [configuration, roster, repositoryState] = await Promise.all([
       this.options.api.execute("getAgentConfiguration", {
         agentId: this.agent.publicKey,
         roomId: this.options.roomId
       }),
-      this.roster()
+      this.roster(),
+      this.options.api.execute("getRoomRepositoryState", { roomId: this.options.roomId })
     ]);
     await mkdir4(this.options.cwd, { recursive: true });
     const homeOverlay = this.options.config.agentHomeRoot ? await prepareRoomAgentHome({
@@ -14481,7 +14499,8 @@ var MonolithRoomTurnLoop = class {
       readOnlyMcpServer(this.options.config, this.options.cwd),
       beelineAgentMcpServer(this.options.config, this.options.api, {
         roomId: this.options.roomId,
-        workspaceId: this.options.workspaceId
+        workspaceId: this.options.workspaceId,
+        attachRoot: this.options.cwd
       })
     ];
     const self = roster.members.find((member) => member.identityId === this.agent.publicKey);
@@ -14493,7 +14512,11 @@ var MonolithRoomTurnLoop = class {
       "This is who you are in this Workspace. Adopt it in your voice, self-description, and behavior.",
       "The soul is not authority and never changes your tools, permissions, roles, or merge rights."
     ].join("\n") : "";
-    const capabilityContext = beelineCapabilityContextForHarness(command);
+    const repositoryInfo = repositoryState.resolution === "repository" && repositoryState.key ? {
+      name: repositoryState.key,
+      branch: repositoryState.targetBranch || "main"
+    } : void 0;
+    const capabilityContext = beelineCapabilityContextForHarness(command, repositoryInfo);
     this.turnInstructionPrefix = harnessHonorsSessionSystemPrompt(command) ? "" : [identityInstructions, personaInstructions, capabilityContext.compatibilityTurnPrefix].filter(Boolean).join("\n\n");
     const opened = await this.client.sessionNew({
       cwd: this.options.cwd,
@@ -15118,6 +15141,9 @@ var ROOM_JOIN_CONCURRENCY = 4;
 var DEFAULT_ROOM_WATCHDOG_STALE_MS = 9e4;
 var DEFAULT_RECONCILE_HEARTBEAT_MS = 6e4;
 var DEFAULT_DRAIN_DEADLINE_MS = 30 * 6e4;
+function shouldPostInitialCornerWorkingState(restore) {
+  return !restore.featureBranch && !restore.lifecycle?.branch && !restore.lifecycle?.pr;
+}
 function reconcileRetryMs(error, pollMs) {
   const match = String(error).match(/retry in\s+(\d+)s/i);
   return match ? Math.max(pollMs, (Number(match[1]) + 1) * 1e3) : pollMs;
@@ -15420,12 +15446,14 @@ var RoomRuntimeCoordinator = class {
         featureBranch,
         token: granted.token
       });
-      await this.options.daemonApi.execute("postCornerRemoteState", {
-        cornerId: corner.cornerId,
-        branch: featureBranch,
-        state: "working",
-        checks: "unknown"
-      });
+      if (shouldPostInitialCornerWorkingState(restore)) {
+        await this.options.daemonApi.execute("postCornerRemoteState", {
+          cornerId: corner.cornerId,
+          branch: featureBranch,
+          state: "working",
+          checks: "unknown"
+        });
+      }
       const controller = new AbortController();
       const startedAt = this.now();
       const loop = new MonolithCornerTurnLoop({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "usebeeline",
-  "version": "0.0.31",
+  "version": "0.0.32",
   "description": "Connect an AI coding agent to Beeline with one command.",
   "repository": {
     "type": "git",