@extrovert.dev/sdk 0.1.0-pre.8 → 0.1.0-pre.9

package/dist/index.d.cts

@@ -6,7 +6,7 @@
  * on 429/5xx, honors `Retry-After`, and surfaces every failure as a typed {@link ApiError}.
  */
 /** The library version, surfaced in the User-Agent. Kept in sync with package.json by build. */
-declare const SDK_VERSION = "0.1.0-pre.8";
+declare const SDK_VERSION = "0.1.0-pre.9";
 interface RetryOptions {
     /** Max retry attempts for idempotent requests on 429/5xx/network errors. Default 2. */
     maxRetries: number;
@@ -930,6 +930,12 @@ interface ListReviewEventsParams {
  * agent-attributed: the deliberate cross-agent-404 exception. Opaque ids only.
  */
 interface Category {
+    /** Logical accepted messages in this authorized project, counted by creation time. */
+    message_count_7d?: number;
+    message_count_30d?: number;
+    message_count_90d?: number;
+    last_used_at?: string;
+    pending_review_count?: number;
     id: string;
     name: string;
     description: string;
@@ -946,6 +952,9 @@ interface Category {
 }
 /** Browse filter for the category registry (spec §5.5). */
 interface ListCategoriesParams {
+    sort?: "popular" | "messages_7d" | "messages_90d" | "last_used" | "pending_reviews" | "name";
+    limit?: number;
+    page?: string;
     /** Pure lexical substring filter over name+description (every token must match; NO LLM). */
     match?: string;
 }
@@ -1232,8 +1241,8 @@ interface RuleSnapshot extends Page<Rule> {
  *
  * Layering (org/project): an agent-plane save is ALWAYS project-layer: the saved
  * rule's `rule_layer` is `project`, bound to the calling key's project. There is no
- * settable `rule_layer` here: an agent cannot create org-layer / house-style
- * (`rule_layer="org"`) rules in v1; authoring org rules is a console/admin action.
+ * settable `rule_layer` here: this method cannot create org-layer rules. Use learnFromReview for
+ * authenticated reviewer feedback, including organization house style.
  * (`scope: "general"` still means a house-style rule WITHIN the project layer :
  * `scope` is the category axis, `rule_layer` is the ownership axis.)
  */
@@ -2262,6 +2271,7 @@ declare class MockBackend {
      * is a pure lexical filter (every token must appear in name+description) - NO LLM,
      * mirroring the server.
      */
+    private categoryUsage;
     listCategories(params?: ListCategoriesParams): Page<Category>;
     /** Get one category (mock), or undefined when not found. */
     getCategory(categoryId: string): Category | undefined;
@@ -3286,8 +3296,8 @@ declare class Rules {
     /**
      * Save / edit a rule (append-only by supersession; D11). An agent-plane save is
      * ALWAYS project-layer: the saved rule's `rule_layer` is `project`, bound to the
-     * key's project. For org-layer house rules use learnFromReview with an authenticated human source; this method cannot author (`rule_layer:"org"`)
-     * rules in v1: that is a console/admin action.
+     * key's project. For all authenticated reviewer feedback use learnFromReview at the intended
+     * organization, project, or category scope. This method is project maintenance only.
      */
     save(req: SaveRuleRequest, signal?: AbortSignal): Promise<Rule>;
     /** Promote a rule between the category and general/house-style layers. */
@@ -3990,7 +4000,7 @@ declare function signWebhook(secret: string, body: string, timestampSeconds: num
  *
  * ## Provisional, pre-1.0 (0.x)
  *
- * {@link CONTRACT_VERSION} is **`0.1.0-pre.8`** - a deliberately **provisional**, pre-1.0
+ * {@link CONTRACT_VERSION} is **`0.1.0-pre.9`** - a deliberately **provisional**, pre-1.0
  * contract. It is open and documented, but it MAY still evolve before 1.0: there
  * are no external users yet, and the **D20 shared-pool auto-send governor** is a
  * hard prerequisite before onboarding external users. Pin the version; expect
@@ -4047,12 +4057,12 @@ interface DiffJson {
 /**
  * The published version of the Extrovert Review-Loop open contract (D14).
  *
- * **`0.1.0-pre.8` - PROVISIONAL, pre-1.0.** Versioned *with the SDK* (this package's
+ * **`0.1.0-pre.9` - PROVISIONAL, pre-1.0.** Versioned *with the SDK* (this package's
  * `package.json` version) and aligned to the openapi `info.version`. Open and
  * documented, but MAY still evolve before 1.0 (no external users yet; the D20
  * shared-pool governor is required before external users). Pin it.
  */
-declare const CONTRACT_VERSION: "0.1.0-pre.8";
+declare const CONTRACT_VERSION: "0.1.0-pre.9";
 /** The stability posture of a published contract version. */
 type ContractStability = "provisional" | "stable";
 /**

package/dist/index.d.ts

@@ -6,7 +6,7 @@
  * on 429/5xx, honors `Retry-After`, and surfaces every failure as a typed {@link ApiError}.
  */
 /** The library version, surfaced in the User-Agent. Kept in sync with package.json by build. */
-declare const SDK_VERSION = "0.1.0-pre.8";
+declare const SDK_VERSION = "0.1.0-pre.9";
 interface RetryOptions {
     /** Max retry attempts for idempotent requests on 429/5xx/network errors. Default 2. */
     maxRetries: number;
@@ -930,6 +930,12 @@ interface ListReviewEventsParams {
  * agent-attributed: the deliberate cross-agent-404 exception. Opaque ids only.
  */
 interface Category {
+    /** Logical accepted messages in this authorized project, counted by creation time. */
+    message_count_7d?: number;
+    message_count_30d?: number;
+    message_count_90d?: number;
+    last_used_at?: string;
+    pending_review_count?: number;
     id: string;
     name: string;
     description: string;
@@ -946,6 +952,9 @@ interface Category {
 }
 /** Browse filter for the category registry (spec §5.5). */
 interface ListCategoriesParams {
+    sort?: "popular" | "messages_7d" | "messages_90d" | "last_used" | "pending_reviews" | "name";
+    limit?: number;
+    page?: string;
     /** Pure lexical substring filter over name+description (every token must match; NO LLM). */
     match?: string;
 }
@@ -1232,8 +1241,8 @@ interface RuleSnapshot extends Page<Rule> {
  *
  * Layering (org/project): an agent-plane save is ALWAYS project-layer: the saved
  * rule's `rule_layer` is `project`, bound to the calling key's project. There is no
- * settable `rule_layer` here: an agent cannot create org-layer / house-style
- * (`rule_layer="org"`) rules in v1; authoring org rules is a console/admin action.
+ * settable `rule_layer` here: this method cannot create org-layer rules. Use learnFromReview for
+ * authenticated reviewer feedback, including organization house style.
  * (`scope: "general"` still means a house-style rule WITHIN the project layer :
  * `scope` is the category axis, `rule_layer` is the ownership axis.)
  */
@@ -2262,6 +2271,7 @@ declare class MockBackend {
      * is a pure lexical filter (every token must appear in name+description) - NO LLM,
      * mirroring the server.
      */
+    private categoryUsage;
     listCategories(params?: ListCategoriesParams): Page<Category>;
     /** Get one category (mock), or undefined when not found. */
     getCategory(categoryId: string): Category | undefined;
@@ -3286,8 +3296,8 @@ declare class Rules {
     /**
      * Save / edit a rule (append-only by supersession; D11). An agent-plane save is
      * ALWAYS project-layer: the saved rule's `rule_layer` is `project`, bound to the
-     * key's project. For org-layer house rules use learnFromReview with an authenticated human source; this method cannot author (`rule_layer:"org"`)
-     * rules in v1: that is a console/admin action.
+     * key's project. For all authenticated reviewer feedback use learnFromReview at the intended
+     * organization, project, or category scope. This method is project maintenance only.
      */
     save(req: SaveRuleRequest, signal?: AbortSignal): Promise<Rule>;
     /** Promote a rule between the category and general/house-style layers. */
@@ -3990,7 +4000,7 @@ declare function signWebhook(secret: string, body: string, timestampSeconds: num
  *
  * ## Provisional, pre-1.0 (0.x)
  *
- * {@link CONTRACT_VERSION} is **`0.1.0-pre.8`** - a deliberately **provisional**, pre-1.0
+ * {@link CONTRACT_VERSION} is **`0.1.0-pre.9`** - a deliberately **provisional**, pre-1.0
  * contract. It is open and documented, but it MAY still evolve before 1.0: there
  * are no external users yet, and the **D20 shared-pool auto-send governor** is a
  * hard prerequisite before onboarding external users. Pin the version; expect
@@ -4047,12 +4057,12 @@ interface DiffJson {
 /**
  * The published version of the Extrovert Review-Loop open contract (D14).
  *
- * **`0.1.0-pre.8` - PROVISIONAL, pre-1.0.** Versioned *with the SDK* (this package's
+ * **`0.1.0-pre.9` - PROVISIONAL, pre-1.0.** Versioned *with the SDK* (this package's
  * `package.json` version) and aligned to the openapi `info.version`. Open and
  * documented, but MAY still evolve before 1.0 (no external users yet; the D20
  * shared-pool governor is required before external users). Pin it.
  */
-declare const CONTRACT_VERSION: "0.1.0-pre.8";
+declare const CONTRACT_VERSION: "0.1.0-pre.9";
 /** The stability posture of a published contract version. */
 type ContractStability = "provisional" | "stable";
 /**

package/dist/index.js

@@ -266,7 +266,7 @@ var CURRENT_API_VERSION = "2026-06-23";
 var API_VERSION_HEADER = "Extrovert-Version";
 
 // src/http.ts
-var SDK_VERSION = "0.1.0-pre.8";
+var SDK_VERSION = "0.1.0-pre.9";
 function buildUrl(baseUrl, path, query) {
   const base = baseUrl.endsWith("/") ? baseUrl.slice(0, -1) : baseUrl;
   const rel = path.startsWith("/") ? path : `/${path}`;
@@ -1819,8 +1819,21 @@ var MockBackend = class {
    * is a pure lexical filter (every token must appear in name+description) - NO LLM,
    * mirroring the server.
    */
+  categoryUsage(category) {
+    const now2 = Date.now();
+    const rows = [...this.state.reviews.values()].filter((r) => r.category_id === category.id && Date.parse(r.created_at) <= now2);
+    const count = (days) => rows.filter((r) => Date.parse(r.created_at) >= now2 - days * 864e5).length;
+    return {
+      ...category,
+      message_count_7d: count(7),
+      message_count_30d: count(30),
+      message_count_90d: count(90),
+      last_used_at: rows.map((r) => r.created_at).sort().slice(-1)[0],
+      pending_review_count: rows.filter((r) => ["needs_review", "in_review", "chatting", "rejected", "stale", "approved"].includes(r.state)).length
+    };
+  }
   listCategories(params = {}) {
-    let items = [...this.state.categories.values()].filter((c) => !c.merged_into).sort((a, b) => b.created_at.localeCompare(a.created_at));
+    let items = [...this.state.categories.values()].filter((c) => !c.merged_into).map((c) => this.categoryUsage(c)).sort((a, b) => b.created_at.localeCompare(a.created_at));
     const tokens = (params.match ?? "").trim().toLowerCase().split(/\s+/).filter(Boolean);
     if (tokens.length) {
       items = items.filter((c) => {
@@ -1828,15 +1841,22 @@ var MockBackend = class {
         return tokens.every((t) => hay.includes(t));
       });
     }
-    return { items, total: items.length };
+    const field = { messages_7d: "message_count_7d", messages_90d: "message_count_90d", pending_reviews: "pending_review_count" }[params.sort] ?? "message_count_30d";
+    items.sort((a, b) => (params.sort === "name" ? a.name.toLowerCase().localeCompare(b.name.toLowerCase()) : params.sort === "last_used" ? 0 : (b[field] ?? 0) - (a[field] ?? 0)) || (b.last_used_at ?? "").localeCompare(a.last_used_at ?? "") || a.id.localeCompare(b.id));
+    const offset = params.page ? JSON.parse(Buffer.from(params.page, "base64url").toString()).o : 0;
+    const total = items.length, limit = params.limit ?? 100;
+    const next = offset + limit < total ? Buffer.from(JSON.stringify({ o: offset + limit, v: 1 })).toString("base64url") : void 0;
+    return { items: items.slice(offset, offset + limit), total, next_cursor: next };
   }
   /** Get one category (mock), or undefined when not found. */
   getCategory(categoryId) {
-    return this.state.categories.get(categoryId);
+    const category = this.state.categories.get(categoryId);
+    return category ? this.categoryUsage(category) : void 0;
   }
   /** Propose a category (mock): stands immediately, author_kind=agent (D9). */
   proposeCategory(req) {
     const name = req.name.trim();
+    if ([...this.state.categories.values()].some((c) => !c.merged_into && c.name.toLowerCase() === name.toLowerCase())) throw new ConflictError({ status: 409, code: "conflict", message: "Category name already exists; browse and reuse it." });
     if (!name) {
       throw new ValidationError({ status: 400, code: "invalid", message: "name is required" });
     }
@@ -3804,7 +3824,7 @@ var HttpTransport = class {
     });
   }
   listCategories(params, signal) {
-    return this.call({ method: "GET", path: "/v1/categories", query: { match: params.match }, signal });
+    return this.call({ method: "GET", path: "/v1/categories", query: { ...params }, signal });
   }
   getCategory(categoryId, signal) {
     return this.call({ method: "GET", path: `/v1/categories/${encodeURIComponent(categoryId)}`, signal });
@@ -5313,8 +5333,8 @@ var Rules = class {
   /**
    * Save / edit a rule (append-only by supersession; D11). An agent-plane save is
    * ALWAYS project-layer: the saved rule's `rule_layer` is `project`, bound to the
-   * key's project. For org-layer house rules use learnFromReview with an authenticated human source; this method cannot author (`rule_layer:"org"`)
-   * rules in v1: that is a console/admin action.
+   * key's project. For all authenticated reviewer feedback use learnFromReview at the intended
+   * organization, project, or category scope. This method is project maintenance only.
    */
   save(req, signal) {
     return this.ctx.transport.saveRule(req, signal);
@@ -5591,7 +5611,7 @@ async function signWebhook(secret, body, timestampSeconds) {
 }
 
 // src/contract.ts
-var CONTRACT_VERSION = "0.1.0-pre.8";
+var CONTRACT_VERSION = "0.1.0-pre.9";
 var CONTRACT_MANIFEST = {
   name: "extrovert.review-loop",
   version: CONTRACT_VERSION,