tines 0.0.86 → 0.0.87

package/dist/index.js

@@ -3928,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);
@@ -4128,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) {
@@ -4177,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;
@@ -4289,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([
@@ -4413,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);
@@ -4616,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([
@@ -5129,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) {
@@ -5261,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([
@@ -5282,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([
@@ -6484,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)]);
@@ -6565,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(
@@ -6595,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([
@@ -6729,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) {
@@ -6744,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");
@@ -6809,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}`);
@@ -6915,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.86",
+  "version": "0.0.87",
   "description": "CLI for Tines, an orchestration layer for AI agents",
   "repository": {
     "type": "git",