@opvs-ai/cli 0.7.5 → 0.11.1

package/dist/lib/pagination.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Pagination helpers.
+ *
+ * Two upstream families sit behind the CLI and they do NOT agree on a
+ * parameter name:
+ *
+ *   - AgentBoard list endpoints (`GET /boards/{id}/tasks`,
+ *     `GET /agents/{id}/tasks`) paginate with `page` + `per_page`.
+ *   - Main-API endpoints (`/board/agent-api/my-tasks`, `/docs/*`,
+ *     `/employees/*`, `/professions/*`) paginate with `skip` + `limit`.
+ *
+ * A `?limit=` sent to the first family is an *unknown* query param, so FastAPI
+ * drops it silently and serves the endpoint default (100). That is CLI-1
+ * (`OSI-37`): `--limit 3` returned 100 rows because nothing rejected the flag,
+ * it simply never arrived. Route every `--limit` through `clampLimit()` and
+ * write it under the name the specific upstream actually reads.
+ *
+ * Clamping is the CLI's job because the upstreams declare hard `le=` bounds and
+ * answer 422 above them — `--limit 250` should give you the maximum page, not
+ * a validation error.
+ */
+/**
+ * Normalise a user-supplied `--limit` / `--page` value for an upstream that
+ * bounds it server-side.
+ *
+ * @param raw   the commander option value (a string, or undefined when omitted)
+ * @param max   the upstream's declared maximum (its `le=` bound)
+ * @param min   the upstream's declared minimum (its `ge=` bound), default 1
+ * @returns the clamped value as a string, or `undefined` when the flag was
+ *          omitted or unparseable — callers must then send no param at all and
+ *          let the upstream apply its own default.
+ */
+export declare function clampLimit(raw: string | number | undefined, max: number, min?: number): string | undefined;

package/dist/lib/pagination.js

@@ -0,0 +1,41 @@
+/**
+ * Pagination helpers.
+ *
+ * Two upstream families sit behind the CLI and they do NOT agree on a
+ * parameter name:
+ *
+ *   - AgentBoard list endpoints (`GET /boards/{id}/tasks`,
+ *     `GET /agents/{id}/tasks`) paginate with `page` + `per_page`.
+ *   - Main-API endpoints (`/board/agent-api/my-tasks`, `/docs/*`,
+ *     `/employees/*`, `/professions/*`) paginate with `skip` + `limit`.
+ *
+ * A `?limit=` sent to the first family is an *unknown* query param, so FastAPI
+ * drops it silently and serves the endpoint default (100). That is CLI-1
+ * (`OSI-37`): `--limit 3` returned 100 rows because nothing rejected the flag,
+ * it simply never arrived. Route every `--limit` through `clampLimit()` and
+ * write it under the name the specific upstream actually reads.
+ *
+ * Clamping is the CLI's job because the upstreams declare hard `le=` bounds and
+ * answer 422 above them — `--limit 250` should give you the maximum page, not
+ * a validation error.
+ */
+/**
+ * Normalise a user-supplied `--limit` / `--page` value for an upstream that
+ * bounds it server-side.
+ *
+ * @param raw   the commander option value (a string, or undefined when omitted)
+ * @param max   the upstream's declared maximum (its `le=` bound)
+ * @param min   the upstream's declared minimum (its `ge=` bound), default 1
+ * @returns the clamped value as a string, or `undefined` when the flag was
+ *          omitted or unparseable — callers must then send no param at all and
+ *          let the upstream apply its own default.
+ */
+export function clampLimit(raw, max, min = 1) {
+    if (raw === undefined || raw === null || raw === "")
+        return undefined;
+    const n = typeof raw === "number" ? raw : Number.parseInt(raw, 10);
+    if (!Number.isFinite(n))
+        return undefined;
+    return String(Math.max(min, Math.min(max, Math.trunc(n))));
+}
+//# sourceMappingURL=pagination.js.map

package/dist/lib/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../src/lib/pagination.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,UAAU,CACxB,GAAgC,EAChC,GAAW,EACX,GAAG,GAAG,CAAC;IAEP,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IACtE,MAAM,CAAC,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACnE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1C,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC7D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opvs-ai/cli",
-  "version": "0.7.5",
+  "version": "0.11.1",
   "description": "OPVS CLI \u2014 Terminal access to AgentBoard + AgentDocs for AI coding agents",
   "type": "module",
   "bin": {