tines 0.0.85 → 0.0.87

package/dist/index.js

@@ -3417,7 +3417,7 @@ var AGENT_GUIDELINES_NAME = "agent-guidelines";
 var JOURNAL_NAME = "journal";
 var AGENT_GUIDELINES_BODY = `You are an agent working on a Tines issue over its HTTP API / CLI. Beyond doing the work, leave the workspace smarter than you found it. Four places to write, chosen by who should inherit what you learned:
 
-- **Issue comments** \u2014 all prose about this issue: progress, findings, dead ends, questions, and instructions for whoever picks it up next. Pass the body on stdin with a quoted heredoc, so backticks, $VARS, quotes and apostrophes reach the thread untouched by the shell (a mangled comment cannot be deleted):
+- **Issue comments** \u2014 all prose about this issue: progress, findings, dead ends, questions, and instructions for whoever picks it up next. Pass the body on stdin with a quoted heredoc, so backticks, $VARS, quotes and apostrophes reach the thread untouched by the shell (\`tines issues comment-edit <ref> <comment-id>\` and \`comment-delete\` repair your own mis-posts, but a clean first post is cheaper):
 
   \`\`\`
   tines issues comment <project>/<number> - <<'EOF'
@@ -3572,6 +3572,8 @@ var DESCRIBERS = {
     return segs;
   },
   "issue.commented": () => [text("commented on"), selfRef()],
+  "issue.comment_edited": () => [text("edited a comment on"), selfRef()],
+  "issue.comment_deleted": () => [text("deleted a comment on"), selfRef()],
   "issue.link_added": linkSegments,
   "issue.link_removed": linkSegments,
   "issue.parked": (_ev, p) => [
@@ -3765,6 +3767,8 @@ function createApiClient(options) {
     // Comments
     listComments: (issueId, page = {}) => get(`/api/v1/issues/${issueId}/comments${query(page)}`),
     createComment: (issueId, body) => request("POST", `/api/v1/issues/${issueId}/comments`, body),
+    updateComment: (issueId, commentId, body) => request("PATCH", `/api/v1/issues/${issueId}/comments/${commentId}`, body),
+    deleteComment: (issueId, commentId) => request("DELETE", `/api/v1/issues/${issueId}/comments/${commentId}`),
     // Scheduled tasks
     listSchedules: (filters = {}) => get(`/api/v1/schedules${query(filters)}`),
     listProjectSchedules: (projectId, page = {}) => get(`/api/v1/projects/${projectId}/schedules${query(page)}`),
@@ -3924,6 +3928,39 @@ var PLACEHOLDER_DESCRIPTIONS = {
 };
 var TEMPLATE_PLACEHOLDERS = Object.keys(PLACEHOLDER_DESCRIPTIONS).map((key) => ({ key, description: PLACEHOLDER_DESCRIPTIONS[key] }));
 
+// ../shared/src/paginate.ts
+var MAX_PAGE_SIZE = 100;
+var MAX_ALL_PAGES_ITEMS = 1e4;
+async function* listPages(fetchPage, opts = {}) {
+  const pageSize = opts.pageSize ?? MAX_PAGE_SIZE;
+  const maxItems = opts.maxItems ?? MAX_ALL_PAGES_ITEMS;
+  const seen = /* @__PURE__ */ new Set();
+  const seenCursors = /* @__PURE__ */ new Set();
+  let cursor;
+  for (; ; ) {
+    const res = await fetchPage({ limit: pageSize, cursor });
+    const fresh = res.items.filter((item) => !seen.has(item.id));
+    for (const item of fresh) seen.add(item.id);
+    if (seen.size > maxItems) {
+      throw new Error(
+        `list has more than ${maxItems} items \u2014 narrow it with filters, or page manually with --cursor`
+      );
+    }
+    yield fresh;
+    if (res.next_cursor === null) return;
+    if (seenCursors.has(res.next_cursor)) {
+      throw new Error(`pagination cursor did not advance past "${cursor}" (server bug?)`);
+    }
+    seenCursors.add(res.next_cursor);
+    cursor = res.next_cursor;
+  }
+}
+async function listAll(fetchPage, opts = {}) {
+  const items = [];
+  for await (const page of listPages(fetchPage, opts)) items.push(...page);
+  return items;
+}
+
 // src/format.ts
 function timestamp(ms) {
   return new Date(ms).toISOString().replace("T", " ").slice(0, 19);
@@ -4018,6 +4055,10 @@ function quotaLabel(quota, stateName) {
   );
   return `state roster: default ${quota.default_limit} per state${overrides.length > 0 ? `, overrides: ${overrides.join(", ")}` : ""}`;
 }
+function commentLines(comment) {
+  const header = `  [${timestamp(comment.created_at)}] ${actorLabel(comment.actor)} (${comment.id})${comment.updated_at ? " (edited)" : ""}:`;
+  return ["", header, ...comment.body.split("\n").map((line) => `  ${line}`)];
+}
 function runRow(run) {
   return [
     run.id,
@@ -4120,7 +4161,16 @@ function withCommon(cmd, { baseUrlFlag = true } = {}) {
 }
 function withList(cmd) {
   return withCommon(
-    cmd.option("--limit <n>", "maximum items to return", (v) => Number.parseInt(v, 10)).option("--cursor <cursor>", "resume from the next_cursor of a previous page")
+    cmd.option(
+      "--limit <n>",
+      "maximum items to return (page size under --all-pages)",
+      (v) => Number.parseInt(v, 10)
+    ).option("--cursor <cursor>", "resume from the next_cursor of a previous page").addOption(
+      new Option(
+        "--all-pages",
+        "fetch every page, not just the first (slower on large lists)"
+      ).conflicts("cursor")
+    )
   );
 }
 function resolveUrl(opts) {
@@ -4169,8 +4219,24 @@ function printJson(value) {
 function printList(res, opts, render) {
   if (opts.json) return printJson(res);
   render(res.items);
-  if (res.next_cursor) console.log(`
-more results: rerun with --cursor ${res.next_cursor}`);
+  if (res.next_cursor) {
+    console.log(
+      `
+more results: rerun with --all-pages, or resume with --cursor ${res.next_cursor}`
+    );
+  }
+}
+async function fetchList(opts, fetchPage) {
+  if (opts.allPages) {
+    return { items: await listAll(fetchPage, { pageSize: opts.limit }), next_cursor: null };
+  }
+  const res = await fetchPage({ limit: opts.limit, cursor: opts.cursor });
+  if (res.next_cursor && opts.json && !opts.cursor) {
+    console.error(
+      "warning: more items exist beyond this page \u2014 rerun with --all-pages for all of them"
+    );
+  }
+  return res;
 }
 function table(rows) {
   if (rows.length === 0) return;
@@ -4281,16 +4347,18 @@ function register(program3) {
   ).action(async (opts) => {
     const api = client(opts);
     const scope = await resolveScopeFlags(api, opts);
-    const res = await api.listContext({
-      kind: opts.kind,
-      project: scope.project_id ?? void 0,
-      state: scope.workflow_state_id ?? void 0,
-      issue: scope.issue_id ?? void 0,
-      q: opts.search,
-      exact: opts.exact ? true : void 0,
-      limit: opts.limit,
-      cursor: opts.cursor
-    });
+    const res = await fetchList(
+      opts,
+      (page) => api.listContext({
+        kind: opts.kind,
+        project: scope.project_id ?? void 0,
+        state: scope.workflow_state_id ?? void 0,
+        issue: scope.issue_id ?? void 0,
+        q: opts.search,
+        exact: opts.exact ? true : void 0,
+        ...page
+      })
+    );
     printList(res, opts, (items) => {
       if (items.length === 0) return console.log("no context items");
       table([
@@ -4405,7 +4473,7 @@ function register(program3) {
     context.command("init").description('Seed the global "agent-guidelines" prompt (a no-op if it already exists)')
   ).action(async (opts) => {
     const api = client(opts);
-    const { items } = await api.listContext({ kind: "prompt", exact: true, limit: 100 });
+    const items = await listAll((page) => api.listContext({ kind: "prompt", exact: true, ...page }));
     const existing = items.find((i) => i.name === AGENT_GUIDELINES_NAME);
     if (existing) {
       if (opts.json) return printJson(existing);
@@ -4543,9 +4611,7 @@ allowed actions: ${allowed.length ? allowed.join(", ") : "none (terminal state)"
     console.log(`
 comments (${issue.comments.length}):`);
     for (const c of issue.comments) {
-      console.log(`
-  [${timestamp(c.created_at)}] ${actorLabel(c.actor)}:`);
-      for (const line of c.body.split("\n")) console.log(`  ${line}`);
+      for (const line of commentLines(c)) console.log(line);
     }
   }
 }
@@ -4610,17 +4676,20 @@ function register2(program3) {
     issues.command("list").description("List issues across projects (hides done issues unless --all)").option("-p, --project <name>", "filter by project name or id").option("-s, --state <name>", "filter by state name or id").option("-c, --category <cat>", "filter by state category").option("-w, --workflow <id-or-name>", "filter by workflow").option("-a, --all", "include issues in done states").option("--ready", "only issues that are actionable now (not done, not a duplicate, no open blockers)").option("-q, --search <text>", "search titles and descriptions")
   ).action(
     async (opts) => {
-      const res = await client(opts).listIssues({
-        project: opts.project,
-        state: opts.state,
-        category: opts.category,
-        workflow: opts.workflow,
-        hide_done: !opts.all,
-        ready: opts.ready,
-        q: opts.search,
-        limit: opts.limit,
-        cursor: opts.cursor
-      });
+      const api = client(opts);
+      const res = await fetchList(
+        opts,
+        (page) => api.listIssues({
+          project: opts.project,
+          state: opts.state,
+          category: opts.category,
+          workflow: opts.workflow,
+          hide_done: !opts.all,
+          ready: opts.ready,
+          q: opts.search,
+          ...page
+        })
+      );
       printList(res, opts, (items) => {
         if (items.length === 0) return console.log(opts.ready ? "no ready issues" : "no issues");
         table([
@@ -4732,7 +4801,29 @@ function register2(program3) {
     const issue = await resolveIssue(api, ref);
     const comment = await api.createComment(issue.id, { body });
     if (opts.json) return printJson(comment);
-    console.log(`commented on ${issue.project_name}/#${issue.number} as ${actorLabel(comment.actor)}`);
+    console.log(
+      `commented on ${issue.project_name}/#${issue.number} as ${actorLabel(comment.actor)} (id ${comment.id})`
+    );
+  });
+  withCommon(
+    issues.command("comment-edit <ref> <comment-id> <markdown>").description(`Replace the body of your own comment \u2014 Markdown body: ${BODY_VALUE_HELP}`).passThroughOptions()
+  ).action(async (ref, commentId, markdown, opts, command) => {
+    if (helpGuard(command, markdown)) return;
+    const body = readBodyValue(markdown);
+    const api = client(opts);
+    const issue = await resolveIssue(api, ref);
+    const comment = await api.updateComment(issue.id, commentId, { body });
+    if (opts.json) return printJson(comment);
+    console.log(`edited comment ${comment.id} on ${issue.project_name}/#${issue.number}`);
+  });
+  withCommon(
+    issues.command("comment-delete <ref> <comment-id>").description("Delete your own comment (the event keeps the record of the deletion)")
+  ).action(async (ref, commentId, opts) => {
+    const api = client(opts);
+    const issue = await resolveIssue(api, ref);
+    await api.deleteComment(issue.id, commentId);
+    if (opts.json) return printJson({ id: commentId, deleted: true });
+    console.log(`deleted comment ${commentId} from ${issue.project_name}/#${issue.number}`);
   });
   withCommon(
     issues.command("block <blocker> <blocked>").description("Record that <blocker> blocks <blocked> (advisory: transitions stay allowed)")
@@ -5101,13 +5192,15 @@ files (v${artifact.current_version.version}):`);
 // src/commands/journal.ts
 var STATE_FLAG_HELP = "target this state's journal instead of your run's launch stage (options go BEFORE <ref>)";
 async function journalItemAt(api, scope) {
-  const { items } = await api.listContext({
-    kind: "prompt",
-    project: scope.project_id ?? void 0,
-    state: scope.workflow_state_id ?? void 0,
-    exact: true,
-    limit: 100
-  });
+  const items = await listAll(
+    (page) => api.listContext({
+      kind: "prompt",
+      project: scope.project_id ?? void 0,
+      state: scope.workflow_state_id ?? void 0,
+      exact: true,
+      ...page
+    })
+  );
   return items.find((i) => i.name === JOURNAL_NAME) ?? null;
 }
 function stateScope(issue, state, workflow) {
@@ -5233,13 +5326,15 @@ function registerEvents(program3) {
   ).action(async (opts) => {
     const api = client(opts);
     const issueId = opts.issue ? (await resolveIssue(api, opts.issue)).id : void 0;
-    const res = await api.listEvents({
-      issue: issueId,
-      project: opts.project,
-      type: opts.type,
-      limit: opts.limit,
-      cursor: opts.cursor
-    });
+    const res = await fetchList(
+      opts,
+      (page) => api.listEvents({
+        issue: issueId,
+        project: opts.project,
+        type: opts.type,
+        ...page
+      })
+    );
     printList(res, opts, (items) => {
       if (items.length === 0) return console.log("no events");
       table([
@@ -5254,7 +5349,8 @@ function registerEvents(program3) {
 function register4(program3) {
   const projects = program3.command("projects").description("Manage projects");
   withList(projects.command("list").description("List projects")).action(async (opts) => {
-    const res = await client(opts).listProjects({ limit: opts.limit, cursor: opts.cursor });
+    const api = client(opts);
+    const res = await fetchList(opts, (page) => api.listProjects(page));
     printList(res, opts, (items) => {
       if (items.length === 0) return console.log("no projects");
       table([
@@ -6456,13 +6552,15 @@ function register6(program3) {
     const api = client(opts);
     const issueId = opts.issue ? (await resolveIssue(api, opts.issue)).id : void 0;
     const runnerId = opts.runner ? (await resolveRunner(api, opts.runner)).id : void 0;
-    const res = await api.listRuns({
-      issue: issueId,
-      runner: runnerId,
-      active: opts.active ? true : void 0,
-      limit: opts.limit,
-      cursor: opts.cursor
-    });
+    const res = await fetchList(
+      opts,
+      (page) => api.listRuns({
+        issue: issueId,
+        runner: runnerId,
+        active: opts.active ? true : void 0,
+        ...page
+      })
+    );
     printList(res, opts, (items) => {
       if (items.length === 0) return console.log(opts.active ? "no active runs" : "no runs");
       table([["ID", "ISSUE", "RUNNER", "TIER", "STATUS", "DURATION", "COST", "CREATED"], ...items.map(runRow)]);
@@ -6537,7 +6635,7 @@ import { createInterface } from "node:readline/promises";
 async function resolveSchedule(api, ref) {
   const { project, name: name2 } = parseScheduleRef(ref);
   const proj = await resolveProject(api, project);
-  const { items } = await api.listProjectSchedules(proj.id, { limit: 100 });
+  const items = await listAll((page) => api.listProjectSchedules(proj.id, page));
   const found = items.find((s) => s.name === name2) ?? items.find((s) => s.id === name2);
   if (!found) {
     die(
@@ -6567,12 +6665,15 @@ function register7(program3) {
   withList(
     schedules.command("list").description("List scheduled tasks (hides paused schedules unless --all)").option("-p, --project <name>", "filter by project name or id").option("-a, --all", "include paused schedules")
   ).action(async (opts) => {
-    const res = await client(opts).listSchedules({
-      project: opts.project,
-      enabled: opts.all ? void 0 : true,
-      limit: opts.limit,
-      cursor: opts.cursor
-    });
+    const api = client(opts);
+    const res = await fetchList(
+      opts,
+      (page) => api.listSchedules({
+        project: opts.project,
+        enabled: opts.all ? void 0 : true,
+        ...page
+      })
+    );
     printList(res, opts, (items) => {
       if (items.length === 0) return console.log("no schedules");
       table([
@@ -6701,14 +6802,14 @@ function register8(program3) {
   withCommon(supervisor.command("status").description("One-screen overview: kill switch, quota, utilization, runners")).action(
     async (opts) => {
       const api = client(opts);
-      const [settings, runnersRes, workflows, activeRuns] = await Promise.all([
+      const [settings, runnersRes, workflows, activeRunItems] = await Promise.all([
         api.getSupervisorSettings(),
         api.listRunners(),
-        api.listWorkflows({ limit: 100 }),
-        api.listRuns({ active: true, limit: 100 })
+        api.listWorkflows(),
+        listAll((page) => api.listRuns({ active: true, ...page }))
       ]);
       if (opts.json) {
-        return printJson({ settings, runners: runnersRes.items, active_runs: activeRuns.items });
+        return printJson({ settings, runners: runnersRes.items, active_runs: activeRunItems });
       }
       const stateNames = /* @__PURE__ */ new Map();
       for (const wf of workflows.items) {
@@ -6716,7 +6817,7 @@ function register8(program3) {
       }
       console.log(`automation: ${settings.enabled ? "ON" : "OFF (kill switch \u2014 nothing dispatches)"}`);
       console.log(quotaLabel(settings.quota, (id) => stateNames.get(id) ?? id));
-      console.log(`utilization: ${utilizationLabel(settings.quota, activeRuns.items, (id) => stateNames.get(id) ?? id)}`);
+      console.log(`utilization: ${utilizationLabel(settings.quota, activeRunItems, (id) => stateNames.get(id) ?? id)}`);
       console.log(`attempt limit: ${settings.attempt_limit} strikes, then the issue parks`);
       if (runnersRes.items.length === 0) {
         console.log("runners: none");
@@ -6781,7 +6882,7 @@ function register8(program3) {
       quota: { type: "state_roster", default_limit: opts.default, overrides }
     });
     if (opts.json) return printJson(settings);
-    const workflows = await api.listWorkflows({ limit: 100 });
+    const workflows = await api.listWorkflows();
     const stateNames = /* @__PURE__ */ new Map();
     for (const wf of workflows.items) {
       for (const s of wf.states) stateNames.set(s.id, `${wf.name}/${s.name}`);
@@ -6887,7 +6988,8 @@ function register9(program3) {
   const workflows = program3.command("workflows").description("Manage the workflow library");
   withList(workflows.command("list").description("List the workflow library")).action(
     async (opts) => {
-      const res = await client(opts).listWorkflows({ limit: opts.limit, cursor: opts.cursor });
+      const api = client(opts);
+      const res = await fetchList(opts, (page) => api.listWorkflows(page));
       printList(res, opts, (items) => {
         if (items.length === 0) return console.log("no workflows");
         table([

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tines",
-  "version": "0.0.85",
+  "version": "0.0.87",
   "description": "CLI for Tines, an orchestration layer for AI agents",
   "repository": {
     "type": "git",