@prave/shared 1.4.14 → 1.4.15

package/dist/schemas/intelligence.schema.d.ts

@@ -157,4 +157,55 @@ export declare const recordSkillUsageBySlugSchema: z.ZodObject<{
     meta?: Record<string, string | number | boolean | null> | undefined;
 }>;
 export type RecordSkillUsageBySlugInput = z.infer<typeof recordSkillUsageBySlugSchema>;
+/**
+ * Bulk version of `recordSkillUsageBySlug` — drives the CLI's offline
+ * telemetry-buffer flush.
+ *
+ * The PostToolUse hook on a logged-out machine buffers events as JSONL
+ * lines in `~/.prave/telemetry-queue.jsonl`. Earlier flush logic
+ * replayed them with one POST per event, which after a long offline
+ * window (1 week of heavy use → 300+ events) burned through the
+ * default 240/min/user limit and stopped mid-flush with 429s. This
+ * schema lets the CLI send up to 500 events in ONE authenticated
+ * request — server resolves each unique (slug, agent_type) pair once
+ * and batch-inserts the lot.
+ */
+export declare const recordSkillUsageBySlugBatchSchema: z.ZodObject<{
+    events: z.ZodArray<z.ZodObject<{
+        slug: z.ZodString;
+        trigger_phrase: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        triggered_at: z.ZodOptional<z.ZodString>;
+        agent_type: z.ZodOptional<z.ZodEnum<["claude", "codex", "cursor", "gemini", "cline", "amp"]>>;
+        meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>>;
+    }, "strip", z.ZodTypeAny, {
+        slug: string;
+        agent_type?: "claude" | "codex" | "cursor" | "gemini" | "cline" | "amp" | undefined;
+        trigger_phrase?: string | null | undefined;
+        triggered_at?: string | undefined;
+        meta?: Record<string, string | number | boolean | null> | undefined;
+    }, {
+        slug: string;
+        agent_type?: "claude" | "codex" | "cursor" | "gemini" | "cline" | "amp" | undefined;
+        trigger_phrase?: string | null | undefined;
+        triggered_at?: string | undefined;
+        meta?: Record<string, string | number | boolean | null> | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    events: {
+        slug: string;
+        agent_type?: "claude" | "codex" | "cursor" | "gemini" | "cline" | "amp" | undefined;
+        trigger_phrase?: string | null | undefined;
+        triggered_at?: string | undefined;
+        meta?: Record<string, string | number | boolean | null> | undefined;
+    }[];
+}, {
+    events: {
+        slug: string;
+        agent_type?: "claude" | "codex" | "cursor" | "gemini" | "cline" | "amp" | undefined;
+        trigger_phrase?: string | null | undefined;
+        triggered_at?: string | undefined;
+        meta?: Record<string, string | number | boolean | null> | undefined;
+    }[];
+}>;
+export type RecordSkillUsageBySlugBatchInput = z.infer<typeof recordSkillUsageBySlugBatchSchema>;
 //# sourceMappingURL=intelligence.schema.d.ts.map

package/dist/schemas/intelligence.schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"intelligence.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/intelligence.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,eAAe,oEAAsB,CAAA;AAElD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;EAKlC,CAAA;AACF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAEvE,eAAO,MAAM,6BAA6B;;;;;;;;;EAGxC,CAAA;AACF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAA;AAEnF,eAAO,MAAM,oBAAoB;;;;;;;;;EAG/B,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEjE,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYpC,CAAA;AACF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAEhF,eAAO,MAAM,sBAAsB;;;;;;;;;EAGjC,CAAA;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAE1E;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;EAWtC,CAAA;AACF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAA;AAEpF;;;;;GAKG;AACH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,eAAe,0GAKf,CAAA;AACb,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAEvD,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;EAUvC,CAAA;AACF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAA"}
+{"version":3,"file":"intelligence.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/intelligence.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,eAAe,oEAAsB,CAAA;AAElD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;EAKlC,CAAA;AACF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAEvE,eAAO,MAAM,6BAA6B;;;;;;;;;EAGxC,CAAA;AACF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAA;AAEnF,eAAO,MAAM,oBAAoB;;;;;;;;;EAG/B,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEjE,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYpC,CAAA;AACF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAEhF,eAAO,MAAM,sBAAsB;;;;;;;;;EAGjC,CAAA;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAE1E;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;EAWtC,CAAA;AACF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAA;AAEpF;;;;;GAKG;AACH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,eAAe,0GAKf,CAAA;AACb,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAEvD,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;EAUvC,CAAA;AACF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAA;AAEtF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmB5C,CAAA;AACF,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAA"}

package/dist/schemas/intelligence.schema.js

@@ -81,3 +81,34 @@ export const recordSkillUsageBySlugSchema = z.object({
     agent_type: z.enum(['claude', 'codex', 'cursor', 'gemini', 'cline', 'amp']).optional(),
     meta: usageMetaSchema,
 });
+/**
+ * Bulk version of `recordSkillUsageBySlug` — drives the CLI's offline
+ * telemetry-buffer flush.
+ *
+ * The PostToolUse hook on a logged-out machine buffers events as JSONL
+ * lines in `~/.prave/telemetry-queue.jsonl`. Earlier flush logic
+ * replayed them with one POST per event, which after a long offline
+ * window (1 week of heavy use → 300+ events) burned through the
+ * default 240/min/user limit and stopped mid-flush with 429s. This
+ * schema lets the CLI send up to 500 events in ONE authenticated
+ * request — server resolves each unique (slug, agent_type) pair once
+ * and batch-inserts the lot.
+ */
+export const recordSkillUsageBySlugBatchSchema = z.object({
+    events: z
+        .array(z.object({
+        slug: z
+            .string()
+            .min(1)
+            .max(120)
+            .regex(/^[a-z0-9][a-z0-9_-]*$/i, 'slug must be kebab/snake case'),
+        trigger_phrase: z.string().max(500).nullish(),
+        triggered_at: z.string().datetime().optional(),
+        agent_type: z
+            .enum(['claude', 'codex', 'cursor', 'gemini', 'cline', 'amp'])
+            .optional(),
+        meta: usageMetaSchema,
+    }))
+        .min(1)
+        .max(500),
+});

package/dist/schemas/skill.schema.d.ts

@@ -508,4 +508,50 @@ export declare const autoSkillFromRepoRequestSchema: z.ZodObject<{
     custom_instructions?: string | undefined;
 }>;
 export type AutoSkillFromRepoRequest = z.infer<typeof autoSkillFromRepoRequestSchema>;
+/**
+ * `prave sync` previously hit GET /skills/:slug + POST /skills/:slug/install
+ * + POST /intelligence/analyze for each locally installed skill. With 85
+ * skills that's 255 requests per sync — well past the default 240/min/user
+ * cap, hitting the user mid-sync with "Too many requests" 429s. The bulk
+ * endpoint below collapses the round-trips into one request that returns
+ * every skill's content and records every install in a single DB pass.
+ *
+ * Slug cap of 250 keeps payload size reasonable (avg SKILL.md is ~4KB →
+ * ~1MB max response). Real-world libraries hit 50–150 skills so this
+ * leaves plenty of headroom without uncapped abuse risk.
+ */
+export declare const bulkSyncInputSchema: z.ZodObject<{
+    slugs: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    slugs: string[];
+}, {
+    slugs: string[];
+}>;
+export type BulkSyncInput = z.infer<typeof bulkSyncInputSchema>;
+/**
+ * Per-slug result shape. Only the fields the CLI actually needs to write
+ * the file and to surface paywall errors — keeps payload tight.
+ *
+ *   slug         — echoed for client-side mapping
+ *   content      — SKILL.md body, or null when paid-and-unpurchased
+ *   price_cents  — 0 for free skills
+ *   purchased    — true if owner or has purchase receipt
+ *   is_owner     — true if caller authored the skill
+ *   error        — populated when the skill can't be installed (not found,
+ *                  paywalled, no content). Lets the bulk response carry
+ *                  per-slug failures without breaking the whole sync.
+ */
+export interface BulkSyncItem {
+    slug: string;
+    content: string | null;
+    price_cents: number;
+    purchased: boolean;
+    is_owner: boolean;
+    error: string | null;
+}
+export interface BulkSyncResponse {
+    items: BulkSyncItem[];
+    /** Slugs that couldn't be resolved at all (skill deleted, never existed). */
+    missing: string[];
+}
 //# sourceMappingURL=skill.schema.d.ts.map

package/dist/schemas/skill.schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/skill.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,eAAO,MAAM,qBAAqB,kCAAgC,CAAA;AAClE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEnE;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS1B,CAAA;AACF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAEvD,iFAAiF;AACjF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;EAO5B,CAAA;AACF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAE3D,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;IAsBtB;;;;;OAKG;;;;IAIH,kEAAkE;;;;;;;;;;;;;;;;;;;;;;;IAElE,6DAA6D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAE7D,6EAA6E;;IAE7E,mEAAmE;;IAEnE,+EAA+E;;IAE/E,gGAAgG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAchG,CAAA;AACF,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAA;AAE/C,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;IA4B/B,2EAA2E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAW3E,CAAA;AACJ,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAErE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEjC,CAAA;AACF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAErE,eAAO,MAAM,eAAe,2DAAyD,CAAA;AACrF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAEvD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;EAOjC,CAAA;AACF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAErE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;EAE9B,CAAA;AACF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAI/D;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B;;IAQzC;;;OAGG;;IAEH;;;;;;;OAOG;;IAEH;;;;;OAKG;;IAEH;;;;;;OAMG;;;;;;;;;;;;;;EAEH,CAAA;AACF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAA"}
+{"version":3,"file":"skill.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/skill.schema.ts"],"names":[],"mappings":"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"}

package/dist/schemas/skill.schema.js

@@ -173,3 +173,19 @@ export const autoSkillFromRepoRequestSchema = z.object({
      */
     custom_instructions: z.string().min(1).max(800).optional(),
 });
+/* ─── Bulk sync — used by `prave sync` ─────────────────────────── */
+/**
+ * `prave sync` previously hit GET /skills/:slug + POST /skills/:slug/install
+ * + POST /intelligence/analyze for each locally installed skill. With 85
+ * skills that's 255 requests per sync — well past the default 240/min/user
+ * cap, hitting the user mid-sync with "Too many requests" 429s. The bulk
+ * endpoint below collapses the round-trips into one request that returns
+ * every skill's content and records every install in a single DB pass.
+ *
+ * Slug cap of 250 keeps payload size reasonable (avg SKILL.md is ~4KB →
+ * ~1MB max response). Real-world libraries hit 50–150 skills so this
+ * leaves plenty of headroom without uncapped abuse risk.
+ */
+export const bulkSyncInputSchema = z.object({
+    slugs: z.array(z.string().min(1).max(120)).min(1).max(250),
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prave/shared",
-  "version": "1.4.14",
+  "version": "1.4.15",
   "type": "module",
   "publishConfig": {
     "access": "public"