very-happy-cli 0.2.151 → 0.2.153

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "very-happy-cli",
-  "version": "0.2.151",
+  "version": "0.2.153",
   "description": "Remote multi-agent workspace CLI with deep Claude integration, native terminal streaming, and self-hosting.",
   "author": "Kirill Dubovitskiy",
   "contributors": [
@@ -117,12 +117,12 @@
     "zod": "^4.0.0"
   },
   "optionalDependencies": {
-    "very-happy-tools-arm64-darwin": "0.2.151",
-    "very-happy-tools-x64-darwin": "0.2.151",
-    "very-happy-tools-arm64-linux": "0.2.151",
-    "very-happy-tools-x64-linux": "0.2.151",
-    "very-happy-tools-arm64-win32": "0.2.151",
-    "very-happy-tools-x64-win32": "0.2.151"
+    "very-happy-tools-arm64-darwin": "0.2.153",
+    "very-happy-tools-x64-darwin": "0.2.153",
+    "very-happy-tools-arm64-linux": "0.2.153",
+    "very-happy-tools-x64-linux": "0.2.153",
+    "very-happy-tools-arm64-win32": "0.2.153",
+    "very-happy-tools-x64-win32": "0.2.153"
   },
   "devDependencies": {
     "@slopus/happy-wire": "workspace:*",

package/dist/agentGuidance-BXa9ikrZ.cjs

@@ -1,267 +0,0 @@
-'use strict';
-
-var z = require('zod');
-var node_crypto = require('node:crypto');
-var persistence = require('./limits-DwcY3kyi.cjs');
-var promises = require('node:fs/promises');
-var node_fs = require('node:fs');
-var path = require('node:path');
-
-const TeamScopeSchema = z.z.object({
-  serverUrl: z.z.string(),
-  scopeToken: z.z.string().min(1),
-  teamId: z.z.string().min(1),
-  botId: z.z.string().min(1),
-  taskId: z.z.string().optional(),
-  attemptId: z.z.string().optional()
-});
-function teamScopePath(sessionId) {
-  const supplied = process.env.VH_TEAM_SCOPE_FILE;
-  if (supplied) {
-    if (!path.isAbsolute(supplied)) throw new Error("VH_TEAM_SCOPE_FILE must be absolute");
-    return supplied;
-  }
-  if (!sessionId || !/^[a-zA-Z0-9_-]+$/.test(sessionId)) throw new Error("Teams requires a managed session or VH_TEAM_SCOPE_FILE");
-  return path.join(persistence.configuration.happyHomeDir, "teams", "scopes", `${sessionId}.json`);
-}
-async function readTeamScope(path) {
-  let file;
-  try {
-    file = await promises.open(path, node_fs.constants.O_RDONLY | (node_fs.constants.O_NOFOLLOW ?? 0));
-  } catch (error) {
-    if (error.code === "ENOENT") return null;
-    throw new Error("Cannot open team scope");
-  }
-  try {
-    const stat = await file.stat();
-    if (typeof process.getuid === "function" && stat.uid !== process.getuid()) throw new Error("Team scope owner mismatch");
-    if (!stat.isFile() || process.platform !== "win32" && (stat.mode & 63) !== 0) throw new Error("Team scope must be a private 0600 file");
-    const scope = TeamScopeSchema.parse(JSON.parse(await file.readFile("utf8")));
-    scope.serverUrl = persistence.normalizeHttpEndpoint(scope.serverUrl, "team scope");
-    if (scope.serverUrl !== persistence.configuration.serverUrl) throw new Error("Team scope belongs to another server");
-    return scope;
-  } catch {
-    throw new Error("Invalid or unsafe team scope file");
-  } finally {
-    await file.close();
-  }
-}
-async function writeTeamScope(path$1, scope) {
-  await promises.mkdir(path.dirname(path$1), { recursive: true, mode: 448 });
-  const temporary = `${path$1}.${node_crypto.randomUUID()}.new`;
-  const file = await promises.open(temporary, "wx", 384);
-  try {
-    await file.writeFile(JSON.stringify(TeamScopeSchema.parse(scope)));
-    await file.sync();
-  } finally {
-    await file.close();
-  }
-  try {
-    await promises.rename(temporary, path$1);
-  } finally {
-    await promises.unlink(temporary).catch(() => {
-    });
-  }
-}
-
-async function teamRequest(path, method, token, scoped, body) {
-  const response = await fetch(`${persistence.configuration.serverUrl}${path}`, {
-    method,
-    redirect: "error",
-    headers: { "content-type": "application/json", ...scoped ? { "x-happy-team-token": token } : { authorization: `Bearer ${token}` } },
-    body: body === void 0 ? void 0 : JSON.stringify(body),
-    signal: AbortSignal.timeout(25e3)
-  }).catch(() => {
-    throw new Error("Teams connection failed; outcome may be unknown. Reuse the request ID when retrying.");
-  });
-  if (!response.ok) throw new Error(`Teams request failed (HTTP ${response.status})`);
-  try {
-    return await response.json();
-  } catch {
-    throw new Error("Teams returned an invalid response");
-  }
-}
-class TeamConnectionPreflightError extends Error {
-}
-const initializationLocks = /* @__PURE__ */ new Map();
-async function serializeInitialization(path, work) {
-  const previous = initializationLocks.get(path) ?? Promise.resolve();
-  const next = previous.catch(() => {
-  }).then(work);
-  initializationLocks.set(path, next);
-  try {
-    return await next;
-  } finally {
-    if (initializationLocks.get(path) === next) initializationLocks.delete(path);
-  }
-}
-function createTeamsClient(sessionId) {
-  const scopePath = () => teamScopePath(sessionId ?? process.env.HAPPY_SESSION_ID);
-  return {
-    async initialize(input, options) {
-      const path = scopePath();
-      return serializeInitialization(path, async () => {
-        const priorScope = await readTeamScope(path);
-        if (priorScope && !options?.resumeAdoption) throw new Error("This session already has a team scope; use scoped team tools");
-        if (process.env.VH_TEAM_SCOPE_FILE) throw new Error("Assigned team scope is missing or already managed; ask the owner to restore it");
-        const sid = sessionId ?? process.env.HAPPY_SESSION_ID;
-        if (!sid) throw new Error("A managed session identity is required");
-        const machineId = (await persistence.readSettings()).machineId;
-        if (!machineId) throw new TeamConnectionPreflightError("Connect this machine to Very Happy before joining a team");
-        if (input.machineId && input.machineId !== machineId) throw new TeamConnectionPreflightError("Teams must use this session\u2019s local machine");
-        const persisted = persistence.readPersistedSessions()[sid];
-        if (!persisted || persisted.metadata.machineId !== machineId) throw new TeamConnectionPreflightError("Team identity must be a persisted session on this machine");
-        const credentials = await persistence.readCredentialsForConfiguredRelay();
-        if (!credentials) throw new TeamConnectionPreflightError("Sign in to Very Happy before creating or joining a team");
-        if (priorScope && !options?.expectedTeamId) throw new Error("This session already belongs to another team scope");
-        let teamId = input.teamId ?? options?.expectedTeamId;
-        if (!teamId) {
-          const created = await teamRequest("/v1/teams", "POST", credentials.token, false, { name: input.name, machineId, requestId: input.requestId });
-          teamId = created.team.id;
-        } else {
-          const existing = await teamRequest(`/v1/teams/${encodeURIComponent(teamId)}`, "GET", credentials.token, false);
-          if (existing.team?.machineId !== machineId) throw new TeamConnectionPreflightError("Team belongs to another machine");
-        }
-        if (options?.onTeamResolved) await options.onTeamResolved(teamId);
-        if (priorScope) {
-          if (priorScope.teamId !== teamId || priorScope.taskId) throw new Error("This session already belongs to another team scope");
-          const inspected = await teamRequest(`/v1/teams/${encodeURIComponent(teamId)}/agent`, "GET", priorScope.scopeToken, true);
-          const bot = inspected.team?.bots?.find((candidate) => candidate.id === priorScope.botId);
-          if (!bot?.root || bot.managed || bot.sessionId !== sid) throw new Error("Existing scope is not this session\u2019s root identity");
-          return { team: inspected.team, botId: priorScope.botId };
-        }
-        const result = await teamRequest(
-          `/v1/teams/${encodeURIComponent(teamId)}/actions`,
-          "POST",
-          credentials.token,
-          false,
-          { requestId: input.requestId, action: { type: "join", name: input.name, sessionId: sid, ...input.botId ? { botId: input.botId } : {} } }
-        );
-        if (!result.credential?.token || !result.credential?.botId) throw new Error("Team join did not issue a credential");
-        await writeTeamScope(path, { serverUrl: persistence.configuration.serverUrl, teamId, botId: result.credential.botId, scopeToken: result.credential.token });
-        return { team: result.team, botId: result.credential.botId };
-      });
-    },
-    async inspect() {
-      const scope = await readTeamScope(scopePath());
-      if (!scope) throw new Error("Join or create a team first");
-      const { credential: _credential, ...safe } = await teamRequest(`/v1/teams/${encodeURIComponent(scope.teamId)}/agent`, "GET", scope.scopeToken, true);
-      return safe;
-    },
-    async action(action, requestId = node_crypto.randomUUID()) {
-      const scope = await readTeamScope(scopePath());
-      if (!scope) throw new Error("Join or create a team first");
-      const result = await teamRequest(`/v1/teams/${encodeURIComponent(scope.teamId)}/agent`, "POST", scope.scopeToken, true, { requestId, action });
-      const { credential: _credential, ...safe } = result;
-      return safe;
-    }
-  };
-}
-
-const TEAM_TOOL_NAMES = ["team_create", "team_join", "team_inspect", "team_delegate", "team_message", "team_submit", "team_accept", "team_return", "team_cancel", "team_handoff", "team_schedule_create", "team_schedule_pause", "team_schedule_resume", "team_schedule_cancel"];
-const id = z.z.string().min(1).max(128);
-const text = z.z.string().min(1).max(32e3);
-const requestId = id.describe("Unique operation ID. Reuse the same ID and arguments after an uncertain response.");
-function registerTeamsTools(server, sessionId, client = createTeamsClient(sessionId)) {
-  const register = (name, description, inputSchema, execute) => {
-    server.registerTool(name, { description, inputSchema, annotations: { readOnlyHint: name === "team_inspect", idempotentHint: true, openWorldHint: false, destructiveHint: ["team_cancel", "team_handoff", "team_return", "team_schedule_cancel"].includes(name) } }, async (args) => {
-      try {
-        return { content: [{ type: "text", text: JSON.stringify(await execute(args)) }], isError: false };
-      } catch (error) {
-        return { content: [{ type: "text", text: error instanceof Error ? error.message : "Teams operation failed" }], isError: true };
-      }
-    });
-  };
-  register(
-    "team_create",
-    "Create an official Very Happy team and join this session as its root bot. Does not grant access outside this account.",
-    { name: id, machineId: id.optional(), requestId },
-    (args) => client.initialize(args)
-  );
-  register(
-    "team_join",
-    "Join an existing team as a root bot using this session owner\u2019s account. Scoped workers cannot elevate their role.",
-    { teamId: id, name: id, botId: id.optional().describe("Existing root bot to reconnect; preserves its identity"), requestId },
-    (args) => client.initialize(args)
-  );
-  register("team_inspect", "Read your visible team tasks, attempts and messages. Inspect before decisions; submission is not acceptance.", {}, () => client.inspect());
-  const action = (name, description, fields) => register(
-    `team_${name}`,
-    description,
-    { requestId, ...fields },
-    ({ requestId: key, ...args }) => client.action({ type: name, ...args, ...name === "delegate" && args.directory === void 0 ? { directory: process.cwd() } : {} }, key)
-  );
-  action("delegate", "Delegate a goal with acceptance criteria. Use parentTaskId for subdelegation. Existing assigneeBotId or a managed worker may execute it.", {
-    goal: text,
-    acceptance: z.z.array(text).min(1).max(32),
-    parentTaskId: id.optional(),
-    assigneeBotId: id.optional(),
-    botName: id.optional(),
-    directory: z.z.string().min(1).optional(),
-    assistant: z.z.enum(["claude", "codex", "pi-acp"]).optional(),
-    model: z.z.string().trim().min(1).max(256).optional()
-  });
-  action("message", "Send a persistent task-related message. Delivery does not mean the model has read or acted on it.", { taskId: id, body: text, recipientBotId: id.optional() });
-  action("submit", "Submit evidence for your current attempt and goal version. The owner still has to accept it.", { taskId: id, attemptId: id, goalVersion: z.z.number().int().positive(), result: text });
-  const current = { attemptId: id, goalVersion: z.z.number().int().positive() };
-  action("accept", "Accept a task you own after checking its evidence. Resource cleanup is tracked separately.", { taskId: id, ...current });
-  action("return", "Return your task for further work with a concrete reason.", { taskId: id, reason: text, ...current });
-  action("cancel", "Cancel an owned task and its dependent work. Cleanup may remain pending.", { taskId: id, reason: text, ...current });
-  action("handoff", "Move an owned task to another bot; prior execution authority is superseded.", { taskId: id, assigneeBotId: id, ...current });
-  register("team_schedule_create", "Create a persistent one-time or fixed-interval reminder for your own root bot. Delivery wakes the bound session; it does not prove task completion. Use epoch milliseconds, and inspect before retrying.", { requestId, name: id, botId: id, body: text, runAt: z.z.number().int().nonnegative(), intervalMs: z.z.number().int().min(6e4).optional() }, ({ requestId: key, ...args }) => client.action({ type: "schedule-create", ...args }, key));
-  for (const operation of ["pause", "resume", "cancel"]) {
-    register(`team_schedule_${operation}`, `${operation} your root bot\u2019s schedule using its current version from team_inspect. An already in-flight message may still arrive.`, { requestId, scheduleId: id, version: z.z.number().int().positive() }, ({ requestId: key, ...args }) => client.action({ type: `schedule-${operation}`, ...args }, key));
-  }
-}
-
-function trimIdent(text) {
-  const lines = text.split("\n");
-  while (lines.length > 0 && lines[0].trim() === "") {
-    lines.shift();
-  }
-  while (lines.length > 0 && lines[lines.length - 1].trim() === "") {
-    lines.pop();
-  }
-  const minSpaces = lines.reduce((min, line) => {
-    if (line.trim() === "") {
-      return min;
-    }
-    const leadingSpaces = line.match(/^\s*/)[0].length;
-    return Math.min(min, leadingSpaces);
-  }, Infinity);
-  const trimmedLines = lines.map((line) => line.slice(minSpaces));
-  return trimmedLines.join("\n");
-}
-
-const AGENT_GUIDANCE = (() => trimIdent(`
-    You are running inside Happy: the user is reading this session in a web client (often a phone), NOT in the terminal where you run. Two consequences:
-
-    - Terminal output is not a good delivery channel. When the user asks for a piece of text ("copy that", "give me X", "\u590D\u5236\u7ED9\u6211", "\u53D1\u6211"), hand it over with mcp__happy__copy_to_clipboard instead of printing it for them to select by hand.
-    - When you produce or want to show a FILE (a document you wrote, a report, an image, a PDF, a diff), call mcp__happy__open_preview with its path instead of cat-ing it. Their client opens the rendered file.
-
-    Judgement, not reflex: use these when the user's goal is to RECEIVE something. If they are asking a question you can just answer, answer it. Do not preview a file you only read for your own reasoning, and do not preview the same file repeatedly within a turn.
-
-    If you are working on a task the user is tracking, call mcp__happy__report_progress at meaningful milestones (started / blocked / needs review / done) so their board reflects reality. Do not report every tool call.
-`))();
-const PREVIEW_TOOL_NAME = "open_preview";
-const PREVIEW_TOOL_TITLE = "Open File Preview for the User";
-const PREVIEW_TOOL_DESCRIPTION = 'Open a file in the preview panel of every web client the user currently has open. Use this whenever you produce or want to show the user a file: a document or report you just wrote, a generated image or diagram, a PDF, a data file, or a source file you want them to look at. Trigger phrases include: "write me a doc", "show me that file", "let me see it", "\u5199\u4E2A\u6587\u6863", "\u7ED9\u6211\u770B\u770B\u8FD9\u4E2A\u6587\u4EF6", "\u6253\u5F00\u770B\u4E0B". Pass an absolute path (or one starting with ~). The file is read on this machine and rendered in their browser \u2014 markdown is rendered, images and PDFs are displayed, other text is syntax-highlighted. Prefer this over printing file contents to the terminal, which the user is probably not looking at. NOTE: this only requests that their client open the file; it cannot confirm the user actually looked at it, so do not assume they have seen it.';
-const REPORT_PROGRESS_TOOL_NAME = "report_progress";
-const REPORT_PROGRESS_TOOL_TITLE = "Report Progress to the Task Board";
-const REPORT_PROGRESS_TOOL_DESCRIPTION = `Report what you are doing to the user's task board, so they can see the state of this session at a glance without reading the transcript. Call it at meaningful milestones only: when you start substantive work, when you get blocked and need the user, when something is ready for their review, and when you are done. Do NOT call it after every tool call or every file edit \u2014 it is a status line, not a log. Set attention to "blocked" when you cannot proceed without the user, "review" when you want them to look at something, and "none" for ordinary progress. Keep progress to one short line describing the current state (the user reads it on a card).`;
-
-exports.AGENT_GUIDANCE = AGENT_GUIDANCE;
-exports.PREVIEW_TOOL_DESCRIPTION = PREVIEW_TOOL_DESCRIPTION;
-exports.PREVIEW_TOOL_NAME = PREVIEW_TOOL_NAME;
-exports.PREVIEW_TOOL_TITLE = PREVIEW_TOOL_TITLE;
-exports.REPORT_PROGRESS_TOOL_DESCRIPTION = REPORT_PROGRESS_TOOL_DESCRIPTION;
-exports.REPORT_PROGRESS_TOOL_NAME = REPORT_PROGRESS_TOOL_NAME;
-exports.REPORT_PROGRESS_TOOL_TITLE = REPORT_PROGRESS_TOOL_TITLE;
-exports.TEAM_TOOL_NAMES = TEAM_TOOL_NAMES;
-exports.TeamConnectionPreflightError = TeamConnectionPreflightError;
-exports.createTeamsClient = createTeamsClient;
-exports.readTeamScope = readTeamScope;
-exports.registerTeamsTools = registerTeamsTools;
-exports.teamRequest = teamRequest;
-exports.teamScopePath = teamScopePath;
-exports.trimIdent = trimIdent;

package/dist/agentGuidance-Dvo3cZMW.mjs

@@ -1,251 +0,0 @@
-import { z } from 'zod';
-import { randomUUID } from 'node:crypto';
-import { n as normalizeHttpEndpoint, c as configuration, r as readSettings, d as readPersistedSessions, e as readCredentialsForConfiguredRelay } from './limits-DS-bnYYp.mjs';
-import { open, mkdir, rename, unlink } from 'node:fs/promises';
-import { constants } from 'node:fs';
-import { isAbsolute, join, dirname } from 'node:path';
-
-const TeamScopeSchema = z.object({
-  serverUrl: z.string(),
-  scopeToken: z.string().min(1),
-  teamId: z.string().min(1),
-  botId: z.string().min(1),
-  taskId: z.string().optional(),
-  attemptId: z.string().optional()
-});
-function teamScopePath(sessionId) {
-  const supplied = process.env.VH_TEAM_SCOPE_FILE;
-  if (supplied) {
-    if (!isAbsolute(supplied)) throw new Error("VH_TEAM_SCOPE_FILE must be absolute");
-    return supplied;
-  }
-  if (!sessionId || !/^[a-zA-Z0-9_-]+$/.test(sessionId)) throw new Error("Teams requires a managed session or VH_TEAM_SCOPE_FILE");
-  return join(configuration.happyHomeDir, "teams", "scopes", `${sessionId}.json`);
-}
-async function readTeamScope(path) {
-  let file;
-  try {
-    file = await open(path, constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0));
-  } catch (error) {
-    if (error.code === "ENOENT") return null;
-    throw new Error("Cannot open team scope");
-  }
-  try {
-    const stat = await file.stat();
-    if (typeof process.getuid === "function" && stat.uid !== process.getuid()) throw new Error("Team scope owner mismatch");
-    if (!stat.isFile() || process.platform !== "win32" && (stat.mode & 63) !== 0) throw new Error("Team scope must be a private 0600 file");
-    const scope = TeamScopeSchema.parse(JSON.parse(await file.readFile("utf8")));
-    scope.serverUrl = normalizeHttpEndpoint(scope.serverUrl, "team scope");
-    if (scope.serverUrl !== configuration.serverUrl) throw new Error("Team scope belongs to another server");
-    return scope;
-  } catch {
-    throw new Error("Invalid or unsafe team scope file");
-  } finally {
-    await file.close();
-  }
-}
-async function writeTeamScope(path, scope) {
-  await mkdir(dirname(path), { recursive: true, mode: 448 });
-  const temporary = `${path}.${randomUUID()}.new`;
-  const file = await open(temporary, "wx", 384);
-  try {
-    await file.writeFile(JSON.stringify(TeamScopeSchema.parse(scope)));
-    await file.sync();
-  } finally {
-    await file.close();
-  }
-  try {
-    await rename(temporary, path);
-  } finally {
-    await unlink(temporary).catch(() => {
-    });
-  }
-}
-
-async function teamRequest(path, method, token, scoped, body) {
-  const response = await fetch(`${configuration.serverUrl}${path}`, {
-    method,
-    redirect: "error",
-    headers: { "content-type": "application/json", ...scoped ? { "x-happy-team-token": token } : { authorization: `Bearer ${token}` } },
-    body: body === void 0 ? void 0 : JSON.stringify(body),
-    signal: AbortSignal.timeout(25e3)
-  }).catch(() => {
-    throw new Error("Teams connection failed; outcome may be unknown. Reuse the request ID when retrying.");
-  });
-  if (!response.ok) throw new Error(`Teams request failed (HTTP ${response.status})`);
-  try {
-    return await response.json();
-  } catch {
-    throw new Error("Teams returned an invalid response");
-  }
-}
-class TeamConnectionPreflightError extends Error {
-}
-const initializationLocks = /* @__PURE__ */ new Map();
-async function serializeInitialization(path, work) {
-  const previous = initializationLocks.get(path) ?? Promise.resolve();
-  const next = previous.catch(() => {
-  }).then(work);
-  initializationLocks.set(path, next);
-  try {
-    return await next;
-  } finally {
-    if (initializationLocks.get(path) === next) initializationLocks.delete(path);
-  }
-}
-function createTeamsClient(sessionId) {
-  const scopePath = () => teamScopePath(sessionId ?? process.env.HAPPY_SESSION_ID);
-  return {
-    async initialize(input, options) {
-      const path = scopePath();
-      return serializeInitialization(path, async () => {
-        const priorScope = await readTeamScope(path);
-        if (priorScope && !options?.resumeAdoption) throw new Error("This session already has a team scope; use scoped team tools");
-        if (process.env.VH_TEAM_SCOPE_FILE) throw new Error("Assigned team scope is missing or already managed; ask the owner to restore it");
-        const sid = sessionId ?? process.env.HAPPY_SESSION_ID;
-        if (!sid) throw new Error("A managed session identity is required");
-        const machineId = (await readSettings()).machineId;
-        if (!machineId) throw new TeamConnectionPreflightError("Connect this machine to Very Happy before joining a team");
-        if (input.machineId && input.machineId !== machineId) throw new TeamConnectionPreflightError("Teams must use this session\u2019s local machine");
-        const persisted = readPersistedSessions()[sid];
-        if (!persisted || persisted.metadata.machineId !== machineId) throw new TeamConnectionPreflightError("Team identity must be a persisted session on this machine");
-        const credentials = await readCredentialsForConfiguredRelay();
-        if (!credentials) throw new TeamConnectionPreflightError("Sign in to Very Happy before creating or joining a team");
-        if (priorScope && !options?.expectedTeamId) throw new Error("This session already belongs to another team scope");
-        let teamId = input.teamId ?? options?.expectedTeamId;
-        if (!teamId) {
-          const created = await teamRequest("/v1/teams", "POST", credentials.token, false, { name: input.name, machineId, requestId: input.requestId });
-          teamId = created.team.id;
-        } else {
-          const existing = await teamRequest(`/v1/teams/${encodeURIComponent(teamId)}`, "GET", credentials.token, false);
-          if (existing.team?.machineId !== machineId) throw new TeamConnectionPreflightError("Team belongs to another machine");
-        }
-        if (options?.onTeamResolved) await options.onTeamResolved(teamId);
-        if (priorScope) {
-          if (priorScope.teamId !== teamId || priorScope.taskId) throw new Error("This session already belongs to another team scope");
-          const inspected = await teamRequest(`/v1/teams/${encodeURIComponent(teamId)}/agent`, "GET", priorScope.scopeToken, true);
-          const bot = inspected.team?.bots?.find((candidate) => candidate.id === priorScope.botId);
-          if (!bot?.root || bot.managed || bot.sessionId !== sid) throw new Error("Existing scope is not this session\u2019s root identity");
-          return { team: inspected.team, botId: priorScope.botId };
-        }
-        const result = await teamRequest(
-          `/v1/teams/${encodeURIComponent(teamId)}/actions`,
-          "POST",
-          credentials.token,
-          false,
-          { requestId: input.requestId, action: { type: "join", name: input.name, sessionId: sid, ...input.botId ? { botId: input.botId } : {} } }
-        );
-        if (!result.credential?.token || !result.credential?.botId) throw new Error("Team join did not issue a credential");
-        await writeTeamScope(path, { serverUrl: configuration.serverUrl, teamId, botId: result.credential.botId, scopeToken: result.credential.token });
-        return { team: result.team, botId: result.credential.botId };
-      });
-    },
-    async inspect() {
-      const scope = await readTeamScope(scopePath());
-      if (!scope) throw new Error("Join or create a team first");
-      const { credential: _credential, ...safe } = await teamRequest(`/v1/teams/${encodeURIComponent(scope.teamId)}/agent`, "GET", scope.scopeToken, true);
-      return safe;
-    },
-    async action(action, requestId = randomUUID()) {
-      const scope = await readTeamScope(scopePath());
-      if (!scope) throw new Error("Join or create a team first");
-      const result = await teamRequest(`/v1/teams/${encodeURIComponent(scope.teamId)}/agent`, "POST", scope.scopeToken, true, { requestId, action });
-      const { credential: _credential, ...safe } = result;
-      return safe;
-    }
-  };
-}
-
-const TEAM_TOOL_NAMES = ["team_create", "team_join", "team_inspect", "team_delegate", "team_message", "team_submit", "team_accept", "team_return", "team_cancel", "team_handoff", "team_schedule_create", "team_schedule_pause", "team_schedule_resume", "team_schedule_cancel"];
-const id = z.string().min(1).max(128);
-const text = z.string().min(1).max(32e3);
-const requestId = id.describe("Unique operation ID. Reuse the same ID and arguments after an uncertain response.");
-function registerTeamsTools(server, sessionId, client = createTeamsClient(sessionId)) {
-  const register = (name, description, inputSchema, execute) => {
-    server.registerTool(name, { description, inputSchema, annotations: { readOnlyHint: name === "team_inspect", idempotentHint: true, openWorldHint: false, destructiveHint: ["team_cancel", "team_handoff", "team_return", "team_schedule_cancel"].includes(name) } }, async (args) => {
-      try {
-        return { content: [{ type: "text", text: JSON.stringify(await execute(args)) }], isError: false };
-      } catch (error) {
-        return { content: [{ type: "text", text: error instanceof Error ? error.message : "Teams operation failed" }], isError: true };
-      }
-    });
-  };
-  register(
-    "team_create",
-    "Create an official Very Happy team and join this session as its root bot. Does not grant access outside this account.",
-    { name: id, machineId: id.optional(), requestId },
-    (args) => client.initialize(args)
-  );
-  register(
-    "team_join",
-    "Join an existing team as a root bot using this session owner\u2019s account. Scoped workers cannot elevate their role.",
-    { teamId: id, name: id, botId: id.optional().describe("Existing root bot to reconnect; preserves its identity"), requestId },
-    (args) => client.initialize(args)
-  );
-  register("team_inspect", "Read your visible team tasks, attempts and messages. Inspect before decisions; submission is not acceptance.", {}, () => client.inspect());
-  const action = (name, description, fields) => register(
-    `team_${name}`,
-    description,
-    { requestId, ...fields },
-    ({ requestId: key, ...args }) => client.action({ type: name, ...args, ...name === "delegate" && args.directory === void 0 ? { directory: process.cwd() } : {} }, key)
-  );
-  action("delegate", "Delegate a goal with acceptance criteria. Use parentTaskId for subdelegation. Existing assigneeBotId or a managed worker may execute it.", {
-    goal: text,
-    acceptance: z.array(text).min(1).max(32),
-    parentTaskId: id.optional(),
-    assigneeBotId: id.optional(),
-    botName: id.optional(),
-    directory: z.string().min(1).optional(),
-    assistant: z.enum(["claude", "codex", "pi-acp"]).optional(),
-    model: z.string().trim().min(1).max(256).optional()
-  });
-  action("message", "Send a persistent task-related message. Delivery does not mean the model has read or acted on it.", { taskId: id, body: text, recipientBotId: id.optional() });
-  action("submit", "Submit evidence for your current attempt and goal version. The owner still has to accept it.", { taskId: id, attemptId: id, goalVersion: z.number().int().positive(), result: text });
-  const current = { attemptId: id, goalVersion: z.number().int().positive() };
-  action("accept", "Accept a task you own after checking its evidence. Resource cleanup is tracked separately.", { taskId: id, ...current });
-  action("return", "Return your task for further work with a concrete reason.", { taskId: id, reason: text, ...current });
-  action("cancel", "Cancel an owned task and its dependent work. Cleanup may remain pending.", { taskId: id, reason: text, ...current });
-  action("handoff", "Move an owned task to another bot; prior execution authority is superseded.", { taskId: id, assigneeBotId: id, ...current });
-  register("team_schedule_create", "Create a persistent one-time or fixed-interval reminder for your own root bot. Delivery wakes the bound session; it does not prove task completion. Use epoch milliseconds, and inspect before retrying.", { requestId, name: id, botId: id, body: text, runAt: z.number().int().nonnegative(), intervalMs: z.number().int().min(6e4).optional() }, ({ requestId: key, ...args }) => client.action({ type: "schedule-create", ...args }, key));
-  for (const operation of ["pause", "resume", "cancel"]) {
-    register(`team_schedule_${operation}`, `${operation} your root bot\u2019s schedule using its current version from team_inspect. An already in-flight message may still arrive.`, { requestId, scheduleId: id, version: z.number().int().positive() }, ({ requestId: key, ...args }) => client.action({ type: `schedule-${operation}`, ...args }, key));
-  }
-}
-
-function trimIdent(text) {
-  const lines = text.split("\n");
-  while (lines.length > 0 && lines[0].trim() === "") {
-    lines.shift();
-  }
-  while (lines.length > 0 && lines[lines.length - 1].trim() === "") {
-    lines.pop();
-  }
-  const minSpaces = lines.reduce((min, line) => {
-    if (line.trim() === "") {
-      return min;
-    }
-    const leadingSpaces = line.match(/^\s*/)[0].length;
-    return Math.min(min, leadingSpaces);
-  }, Infinity);
-  const trimmedLines = lines.map((line) => line.slice(minSpaces));
-  return trimmedLines.join("\n");
-}
-
-const AGENT_GUIDANCE = (() => trimIdent(`
-    You are running inside Happy: the user is reading this session in a web client (often a phone), NOT in the terminal where you run. Two consequences:
-
-    - Terminal output is not a good delivery channel. When the user asks for a piece of text ("copy that", "give me X", "\u590D\u5236\u7ED9\u6211", "\u53D1\u6211"), hand it over with mcp__happy__copy_to_clipboard instead of printing it for them to select by hand.
-    - When you produce or want to show a FILE (a document you wrote, a report, an image, a PDF, a diff), call mcp__happy__open_preview with its path instead of cat-ing it. Their client opens the rendered file.
-
-    Judgement, not reflex: use these when the user's goal is to RECEIVE something. If they are asking a question you can just answer, answer it. Do not preview a file you only read for your own reasoning, and do not preview the same file repeatedly within a turn.
-
-    If you are working on a task the user is tracking, call mcp__happy__report_progress at meaningful milestones (started / blocked / needs review / done) so their board reflects reality. Do not report every tool call.
-`))();
-const PREVIEW_TOOL_NAME = "open_preview";
-const PREVIEW_TOOL_TITLE = "Open File Preview for the User";
-const PREVIEW_TOOL_DESCRIPTION = 'Open a file in the preview panel of every web client the user currently has open. Use this whenever you produce or want to show the user a file: a document or report you just wrote, a generated image or diagram, a PDF, a data file, or a source file you want them to look at. Trigger phrases include: "write me a doc", "show me that file", "let me see it", "\u5199\u4E2A\u6587\u6863", "\u7ED9\u6211\u770B\u770B\u8FD9\u4E2A\u6587\u4EF6", "\u6253\u5F00\u770B\u4E0B". Pass an absolute path (or one starting with ~). The file is read on this machine and rendered in their browser \u2014 markdown is rendered, images and PDFs are displayed, other text is syntax-highlighted. Prefer this over printing file contents to the terminal, which the user is probably not looking at. NOTE: this only requests that their client open the file; it cannot confirm the user actually looked at it, so do not assume they have seen it.';
-const REPORT_PROGRESS_TOOL_NAME = "report_progress";
-const REPORT_PROGRESS_TOOL_TITLE = "Report Progress to the Task Board";
-const REPORT_PROGRESS_TOOL_DESCRIPTION = `Report what you are doing to the user's task board, so they can see the state of this session at a glance without reading the transcript. Call it at meaningful milestones only: when you start substantive work, when you get blocked and need the user, when something is ready for their review, and when you are done. Do NOT call it after every tool call or every file edit \u2014 it is a status line, not a log. Set attention to "blocked" when you cannot proceed without the user, "review" when you want them to look at something, and "none" for ordinary progress. Keep progress to one short line describing the current state (the user reads it on a card).`;
-
-export { AGENT_GUIDANCE as A, PREVIEW_TOOL_NAME as P, REPORT_PROGRESS_TOOL_NAME as R, TeamConnectionPreflightError as T, PREVIEW_TOOL_TITLE as a, PREVIEW_TOOL_DESCRIPTION as b, readTeamScope as c, teamRequest as d, createTeamsClient as e, trimIdent as f, TEAM_TOOL_NAMES as g, REPORT_PROGRESS_TOOL_TITLE as h, REPORT_PROGRESS_TOOL_DESCRIPTION as i, registerTeamsTools as r, teamScopePath as t };