very-happy-cli 0.2.198 → 0.2.200

package/dist/{reportProgressTool-CFmDK8ag.mjs → reportProgressTool-D4xKY9Ur.mjs}

@@ -1,9 +1,12 @@
 import { z } from 'zod';
-import { x as AutomationNameSchema, h as AUTOMATION_ATTENTION_REASON_MAX_CHARS, j as AUTOMATION_SUMMARY_MAX_CHARS, e as AutomationPrecheckSchema, y as AutomationConcurrencySchema, z as AutomationActionSchema, D as AutomationTriggerSchema } from './index-CxiisoO1.mjs';
-import { a as authenticatedAutomationsClient, b as automationRunIdFromEnv } from './client-CISkP897.mjs';
+import { Y as AutomationNameSchema, o as AUTOMATION_ATTENTION_REASON_MAX_CHARS, q as AUTOMATION_SUMMARY_MAX_CHARS, e as AutomationPrecheckSchema, Z as AutomationConcurrencySchema, _ as AutomationActionSchema, $ as AutomationTriggerSchema, g as ISSUE_STATUSES, F as ISSUE_LIMITS, a0 as ISSUE_AGENT_STATUSES, p as parseIssueRef } from './index-kwsivEs-.mjs';
+import { a as authenticatedAutomationsClient, b as automationRunIdFromEnv } from './client-Blpuk2Hr.mjs';
 import { u as updateAutomationChecked, c as createAutomationChecked } from './precheckCompat-DeEbilbr.mjs';
-import { P as ProjectsUnsupportedError, a as ProjectRequestError, s as sharedProjectsClient } from './client-BRuFIwki.mjs';
+import { P as ProjectsUnsupportedError, a as ProjectRequestError, s as sharedProjectsClient } from './client-BXwIqRha.mjs';
 import { f as formatContextForTool } from './prompt-QHuFx9j6.mjs';
+import { randomUUID } from 'node:crypto';
+import { s as sharedIssuesClient } from './client-BgxQ9aej.mjs';
+import { d as describeIssueError, a as formatIssueDetail, f as formatIssueLine } from './format-CbliQN8V.mjs';
 import { R as REPORT_PROGRESS_TOOL_NAME, d as REPORT_PROGRESS_TOOL_TITLE, e as REPORT_PROGRESS_TOOL_DESCRIPTION } from './agentGuidance-BDYt2Qy2.mjs';
 
 const AUTOMATION_TOOL_NAMES = [
@@ -260,6 +263,110 @@ function registerProjectTools(server, execute) {
   }
 }
 
+const ISSUE_TOOL_NAMES = ["issue_get", "issue_update", "issue_comment", "issue_list"];
+const ISSUE_TOOL_SCHEMAS = {
+  issue_get: {
+    title: "Read Issue",
+    readOnly: true,
+    description: "Read a Very Happy issue: title, status, description, recent timeline and runs. Without `issue` it reads the issue this session is working on.",
+    inputSchema: {
+      issue: z.string().min(1).max(128).optional().describe("Issue key (VH-12) or id; omit for this session's issue")
+    }
+  },
+  issue_update: {
+    title: "Update Issue Status",
+    readOnly: false,
+    description: `Set this session's issue status and/or add a comment. Agents may set only ${ISSUE_AGENT_STATUSES.join(", ")}; in_review and blocked need a comment (what you delivered and how it was verified / exactly what you need). Never done or cancelled: only the owner closes an issue.`,
+    inputSchema: {
+      status: z.string().min(1).max(64).optional().describe(ISSUE_AGENT_STATUSES.join(" | ")),
+      comment: z.string().min(1).max(ISSUE_LIMITS.commentBytes).optional().describe("Comment posted on the issue with this change")
+    }
+  },
+  issue_comment: {
+    title: "Comment on Issue",
+    readOnly: false,
+    description: "Comment on the issue this session is working on. Set mention_owner=true only when the owner must answer or decide something; it lands in their \u300C\u9700\u8981\u6211\u51B3\u7B56\u300D list.",
+    inputSchema: {
+      body: z.string().min(1).max(ISSUE_LIMITS.commentBytes).describe("Markdown comment"),
+      mention_owner: z.boolean().optional().describe("Ask the owner (@me)")
+    }
+  },
+  issue_list: {
+    title: "List Issues",
+    readOnly: true,
+    description: "List this account's issues (read only), newest first.",
+    inputSchema: {
+      status: z.array(z.enum(ISSUE_STATUSES)).max(ISSUE_STATUSES.length).optional().describe("Only these statuses"),
+      project: z.enum(["current", "any"]).optional().describe("current = this session's project only"),
+      limit: z.number().int().min(1).max(50).optional()
+    }
+  }
+};
+function createIssueToolExecutor(sessionId, deps = {}) {
+  const client = deps.client ?? sharedIssuesClient();
+  const scoped = deps.scoped ?? (() => process.env.VH_TEAM_SCOPE_FILE !== void 0);
+  return async (name, args) => {
+    const sid = sessionId();
+    if (name === "issue_get") {
+      const ref = typeof args?.issue === "string" ? args.issue.trim() : "";
+      const ctx = await client.session(sid);
+      const bound = ctx.issue && (!ref || matchesRef(ref, ctx.issue));
+      if (bound && ctx.issue) {
+        const detail2 = await client.get(ctx.issue.id).catch(() => null);
+        return { text: formatIssueDetail({ issue: ctx.issue, comments: ctx.comments, runs: detail2?.runs, current: ctx.current, bound: true }) };
+      }
+      if (!ref) throw new Error('issue_not_bound: This session is not working on an issue (it was not started from one). Pass issue="VH-N" to read another.');
+      if (scoped()) throw new Error("issue_not_bound: Scoped Teams sessions can read only the issue they are working on.");
+      const detail = await client.get(ref);
+      return { text: formatIssueDetail({ issue: detail.issue, comments: detail.comments, runs: detail.runs }) };
+    }
+    if (name === "issue_update") {
+      const result = await client.agentUpdate({
+        sessionId: sid,
+        requestId: randomUUID(),
+        ...typeof args?.status === "string" ? { status: args.status } : {},
+        ...typeof args?.comment === "string" ? { comment: args.comment } : {}
+      });
+      return { text: `${result.issue.key} is ${result.issue.status}${result.comment ? " (comment posted)" : ""}` };
+    }
+    if (name === "issue_comment") {
+      const result = await client.agentComment({ sessionId: sid, body: String(args?.body ?? ""), requestId: randomUUID(), ...args?.mention_owner === true ? { mentionOwner: true } : {} });
+      return { text: `commented on ${result.issue.key}${args?.mention_owner === true ? " (owner notified)" : ""}` };
+    }
+    if (scoped()) throw new Error("issue_not_bound: Scoped Teams sessions can read only the issue they are working on (use issue_get).");
+    let projectId;
+    if (args?.project === "current") {
+      const membership = await (deps.projects ?? sharedProjectsClient()).membership(sid).catch(() => ({ projectId: null }));
+      if (!membership.projectId) return { text: "not in a project" };
+      projectId = membership.projectId;
+    }
+    const list = await client.list({ ...Array.isArray(args?.status) && args.status.length ? { status: args.status.join(",") } : {}, ...projectId ? { projectId } : {}, limit: typeof args?.limit === "number" ? args.limit : 20 });
+    return { text: list.issues.length ? list.issues.map(formatIssueLine).join("\n") : "no issues" };
+  };
+}
+function matchesRef(ref, issue) {
+  const parsed = parseIssueRef(ref);
+  if (!parsed) return false;
+  return "number" in parsed ? parsed.number === issue.number : parsed.id === issue.id;
+}
+function registerIssueTools(server, execute) {
+  for (const name of ISSUE_TOOL_NAMES) {
+    const spec = ISSUE_TOOL_SCHEMAS[name];
+    server.registerTool(name, {
+      description: spec.description,
+      title: spec.title,
+      inputSchema: spec.inputSchema,
+      annotations: { readOnlyHint: spec.readOnly, idempotentHint: spec.readOnly, openWorldHint: false, destructiveHint: false }
+    }, async (args) => {
+      try {
+        return { content: [{ type: "text", text: (await execute(name, args ?? {})).text }], isError: false };
+      } catch (error) {
+        return { content: [{ type: "text", text: describeIssueError(error) }], isError: true };
+      }
+    });
+  }
+}
+
 const SELF_REPORT_MIN_INTERVAL_MS = 30 * 1e3;
 const SELF_REPORT_FRESH_MS = 15 * 60 * 1e3;
 const ATTENTION_VALUES = ["none", "review", "blocked"];
@@ -310,4 +417,4 @@ function registerReportProgressTool(server, execute) {
   });
 }
 
-export { AUTOMATION_TOOL_NAMES as A, PROJECT_TOOL_NAMES as P, registerProjectTools as a, registerReportProgressTool as b, createSelfReportState as c, createProjectToolExecutor as d, normalizePhase as e, normalizeProgress as f, isSelfReportFresh as i, normalizeAttention as n, registerAutomationTools as r, shouldAcceptSelfReport as s };
+export { AUTOMATION_TOOL_NAMES as A, ISSUE_TOOL_NAMES as I, PROJECT_TOOL_NAMES as P, registerProjectTools as a, registerIssueTools as b, registerReportProgressTool as c, createSelfReportState as d, createProjectToolExecutor as e, createIssueToolExecutor as f, normalizePhase as g, normalizeProgress as h, isSelfReportFresh as i, normalizeAttention as n, registerAutomationTools as r, shouldAcceptSelfReport as s };

package/dist/{reportProgressTool-Cr25LWeW.cjs → reportProgressTool-DtEpDqv3.cjs}

@@ -1,11 +1,14 @@
 'use strict';
 
 var z = require('zod');
-var index = require('./index-BknTkVnR.cjs');
-var client = require('./client-oqSAKwmy.cjs');
+var index = require('./index-BiutHOAO.cjs');
+var client = require('./client-D0_UOmC1.cjs');
 var precheckCompat = require('./precheckCompat-CWOi5c9L.cjs');
-var client$1 = require('./client-D-HEr922.cjs');
+var client$1 = require('./client-BnoN4P4t.cjs');
 var prompt = require('./prompt-Bof2aQkI.cjs');
+var node_crypto = require('node:crypto');
+var client$2 = require('./client-1zIbVVX5.cjs');
+var format = require('./format-P9_M_7ga.cjs');
 var agentGuidance = require('./agentGuidance-BtBx2xxE.cjs');
 
 const AUTOMATION_TOOL_NAMES = [
@@ -262,6 +265,110 @@ function registerProjectTools(server, execute) {
   }
 }
 
+const ISSUE_TOOL_NAMES = ["issue_get", "issue_update", "issue_comment", "issue_list"];
+const ISSUE_TOOL_SCHEMAS = {
+  issue_get: {
+    title: "Read Issue",
+    readOnly: true,
+    description: "Read a Very Happy issue: title, status, description, recent timeline and runs. Without `issue` it reads the issue this session is working on.",
+    inputSchema: {
+      issue: z.z.string().min(1).max(128).optional().describe("Issue key (VH-12) or id; omit for this session's issue")
+    }
+  },
+  issue_update: {
+    title: "Update Issue Status",
+    readOnly: false,
+    description: `Set this session's issue status and/or add a comment. Agents may set only ${index.ISSUE_AGENT_STATUSES.join(", ")}; in_review and blocked need a comment (what you delivered and how it was verified / exactly what you need). Never done or cancelled: only the owner closes an issue.`,
+    inputSchema: {
+      status: z.z.string().min(1).max(64).optional().describe(index.ISSUE_AGENT_STATUSES.join(" | ")),
+      comment: z.z.string().min(1).max(index.ISSUE_LIMITS.commentBytes).optional().describe("Comment posted on the issue with this change")
+    }
+  },
+  issue_comment: {
+    title: "Comment on Issue",
+    readOnly: false,
+    description: "Comment on the issue this session is working on. Set mention_owner=true only when the owner must answer or decide something; it lands in their \u300C\u9700\u8981\u6211\u51B3\u7B56\u300D list.",
+    inputSchema: {
+      body: z.z.string().min(1).max(index.ISSUE_LIMITS.commentBytes).describe("Markdown comment"),
+      mention_owner: z.z.boolean().optional().describe("Ask the owner (@me)")
+    }
+  },
+  issue_list: {
+    title: "List Issues",
+    readOnly: true,
+    description: "List this account's issues (read only), newest first.",
+    inputSchema: {
+      status: z.z.array(z.z.enum(index.ISSUE_STATUSES)).max(index.ISSUE_STATUSES.length).optional().describe("Only these statuses"),
+      project: z.z.enum(["current", "any"]).optional().describe("current = this session's project only"),
+      limit: z.z.number().int().min(1).max(50).optional()
+    }
+  }
+};
+function createIssueToolExecutor(sessionId, deps = {}) {
+  const client = deps.client ?? client$2.sharedIssuesClient();
+  const scoped = deps.scoped ?? (() => process.env.VH_TEAM_SCOPE_FILE !== void 0);
+  return async (name, args) => {
+    const sid = sessionId();
+    if (name === "issue_get") {
+      const ref = typeof args?.issue === "string" ? args.issue.trim() : "";
+      const ctx = await client.session(sid);
+      const bound = ctx.issue && (!ref || matchesRef(ref, ctx.issue));
+      if (bound && ctx.issue) {
+        const detail2 = await client.get(ctx.issue.id).catch(() => null);
+        return { text: format.formatIssueDetail({ issue: ctx.issue, comments: ctx.comments, runs: detail2?.runs, current: ctx.current, bound: true }) };
+      }
+      if (!ref) throw new Error('issue_not_bound: This session is not working on an issue (it was not started from one). Pass issue="VH-N" to read another.');
+      if (scoped()) throw new Error("issue_not_bound: Scoped Teams sessions can read only the issue they are working on.");
+      const detail = await client.get(ref);
+      return { text: format.formatIssueDetail({ issue: detail.issue, comments: detail.comments, runs: detail.runs }) };
+    }
+    if (name === "issue_update") {
+      const result = await client.agentUpdate({
+        sessionId: sid,
+        requestId: node_crypto.randomUUID(),
+        ...typeof args?.status === "string" ? { status: args.status } : {},
+        ...typeof args?.comment === "string" ? { comment: args.comment } : {}
+      });
+      return { text: `${result.issue.key} is ${result.issue.status}${result.comment ? " (comment posted)" : ""}` };
+    }
+    if (name === "issue_comment") {
+      const result = await client.agentComment({ sessionId: sid, body: String(args?.body ?? ""), requestId: node_crypto.randomUUID(), ...args?.mention_owner === true ? { mentionOwner: true } : {} });
+      return { text: `commented on ${result.issue.key}${args?.mention_owner === true ? " (owner notified)" : ""}` };
+    }
+    if (scoped()) throw new Error("issue_not_bound: Scoped Teams sessions can read only the issue they are working on (use issue_get).");
+    let projectId;
+    if (args?.project === "current") {
+      const membership = await (deps.projects ?? client$1.sharedProjectsClient()).membership(sid).catch(() => ({ projectId: null }));
+      if (!membership.projectId) return { text: "not in a project" };
+      projectId = membership.projectId;
+    }
+    const list = await client.list({ ...Array.isArray(args?.status) && args.status.length ? { status: args.status.join(",") } : {}, ...projectId ? { projectId } : {}, limit: typeof args?.limit === "number" ? args.limit : 20 });
+    return { text: list.issues.length ? list.issues.map(format.formatIssueLine).join("\n") : "no issues" };
+  };
+}
+function matchesRef(ref, issue) {
+  const parsed = index.parseIssueRef(ref);
+  if (!parsed) return false;
+  return "number" in parsed ? parsed.number === issue.number : parsed.id === issue.id;
+}
+function registerIssueTools(server, execute) {
+  for (const name of ISSUE_TOOL_NAMES) {
+    const spec = ISSUE_TOOL_SCHEMAS[name];
+    server.registerTool(name, {
+      description: spec.description,
+      title: spec.title,
+      inputSchema: spec.inputSchema,
+      annotations: { readOnlyHint: spec.readOnly, idempotentHint: spec.readOnly, openWorldHint: false, destructiveHint: false }
+    }, async (args) => {
+      try {
+        return { content: [{ type: "text", text: (await execute(name, args ?? {})).text }], isError: false };
+      } catch (error) {
+        return { content: [{ type: "text", text: format.describeIssueError(error) }], isError: true };
+      }
+    });
+  }
+}
+
 const SELF_REPORT_MIN_INTERVAL_MS = 30 * 1e3;
 const SELF_REPORT_FRESH_MS = 15 * 60 * 1e3;
 const ATTENTION_VALUES = ["none", "review", "blocked"];
@@ -313,7 +420,9 @@ function registerReportProgressTool(server, execute) {
 }
 
 exports.AUTOMATION_TOOL_NAMES = AUTOMATION_TOOL_NAMES;
+exports.ISSUE_TOOL_NAMES = ISSUE_TOOL_NAMES;
 exports.PROJECT_TOOL_NAMES = PROJECT_TOOL_NAMES;
+exports.createIssueToolExecutor = createIssueToolExecutor;
 exports.createProjectToolExecutor = createProjectToolExecutor;
 exports.createSelfReportState = createSelfReportState;
 exports.isSelfReportFresh = isSelfReportFresh;
@@ -321,6 +430,7 @@ exports.normalizeAttention = normalizeAttention;
 exports.normalizePhase = normalizePhase;
 exports.normalizeProgress = normalizeProgress;
 exports.registerAutomationTools = registerAutomationTools;
+exports.registerIssueTools = registerIssueTools;
 exports.registerProjectTools = registerProjectTools;
 exports.registerReportProgressTool = registerReportProgressTool;
 exports.shouldAcceptSelfReport = shouldAcceptSelfReport;