@prave/shared 1.5.0 → 1.5.2

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

@@ -0,0 +1,177 @@
+import { z } from 'zod';
+/**
+ * Contextual Skill Advisor — prose recommendations behind a tiered
+ * freemium quota. See `apps/api/src/services/advisor.service.ts` for
+ * the orchestrator; the schemas below pin the request, response, and
+ * LLM-output shapes so a model drift on the Haiku side gets caught at
+ * the Zod boundary, not in the UI.
+ */
+export declare const advisorModeSchema: z.ZodEnum<["manual", "auto"]>;
+export type AdvisorMode = z.infer<typeof advisorModeSchema>;
+export declare const advisorRequestSchema: z.ZodEffects<z.ZodObject<{
+    mode: z.ZodDefault<z.ZodEnum<["manual", "auto"]>>;
+    /**
+     * Task description for manual mode. Required when `mode === 'manual'`,
+     * ignored when `mode === 'auto'`. We cap at 1200 chars so a long
+     * paste can't blow the Haiku prompt window — the input field on the
+     * web side enforces the same limit.
+     */
+    task: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    mode: "manual" | "auto";
+    task?: string | undefined;
+}, {
+    mode?: "manual" | "auto" | undefined;
+    task?: string | undefined;
+}>, {
+    mode: "manual" | "auto";
+    task?: string | undefined;
+}, {
+    mode?: "manual" | "auto" | undefined;
+    task?: string | undefined;
+}>;
+export type AdvisorRequest = z.infer<typeof advisorRequestSchema>;
+/**
+ * One recommended skill in the advisor's response. `slug` is always a
+ * real catalogue slug — the service drops anything Haiku invented
+ * before the response leaves the API.
+ */
+export declare const advisorRecommendationSchema: z.ZodObject<{
+    slug: z.ZodString;
+    reason: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    slug: string;
+    reason: string;
+}, {
+    slug: string;
+    reason: string;
+}>;
+export type AdvisorRecommendation = z.infer<typeof advisorRecommendationSchema>;
+export declare const advisorResponseSchema: z.ZodObject<{
+    /**
+     * Prose paragraph the model writes. Calmly-cased, no markdown
+     * fences, no emoji. The web result block renders this verbatim.
+     */
+    prose: z.ZodString;
+    recommendations: z.ZodArray<z.ZodObject<{
+        slug: z.ZodString;
+        reason: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        slug: string;
+        reason: string;
+    }, {
+        slug: string;
+        reason: string;
+    }>, "many">;
+    /**
+     * BM25 top-5 fallback slugs. Always populated so the UI can render
+     * clickable Skill cards even when `recommendations` is empty (Haiku
+     * said "no fit" or hallucinated unknown slugs). When this list backs
+     * the result, the server also refunds the rate-limit slot — the
+     * user wasn't billed for a zero-reasoned response.
+     */
+    candidate_slugs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * Echoed for telemetry + cache-bust debugging. The UI doesn't render
+     * this but the analytics layer does.
+     */
+    mode: z.ZodEnum<["manual", "auto"]>;
+    /**
+     * After-this-call quota snapshot — saves the web UI a round-trip
+     * back to `GET /advisor/quota` immediately after a success.
+     */
+    quota: z.ZodObject<{
+        plan: z.ZodEnum<["free", "pro", "max"]>;
+        limit: z.ZodNumber;
+        used: z.ZodNumber;
+        remaining: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        limit: number;
+        plan: "free" | "pro" | "max";
+        used: number;
+        remaining: number;
+    }, {
+        limit: number;
+        plan: "free" | "pro" | "max";
+        used: number;
+        remaining: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    mode: "manual" | "auto";
+    prose: string;
+    recommendations: {
+        slug: string;
+        reason: string;
+    }[];
+    candidate_slugs: string[];
+    quota: {
+        limit: number;
+        plan: "free" | "pro" | "max";
+        used: number;
+        remaining: number;
+    };
+}, {
+    mode: "manual" | "auto";
+    prose: string;
+    recommendations: {
+        slug: string;
+        reason: string;
+    }[];
+    quota: {
+        limit: number;
+        plan: "free" | "pro" | "max";
+        used: number;
+        remaining: number;
+    };
+    candidate_slugs?: string[] | undefined;
+}>;
+export type AdvisorResponse = z.infer<typeof advisorResponseSchema>;
+export declare const advisorQuotaResponseSchema: z.ZodObject<{
+    plan: z.ZodEnum<["free", "pro", "max"]>;
+    limit: z.ZodNumber;
+    used: z.ZodNumber;
+    remaining: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    plan: "free" | "pro" | "max";
+    used: number;
+    remaining: number;
+}, {
+    limit: number;
+    plan: "free" | "pro" | "max";
+    used: number;
+    remaining: number;
+}>;
+export type AdvisorQuotaResponse = z.infer<typeof advisorQuotaResponseSchema>;
+/**
+ * Raw Haiku JSON shape — what the model is told to produce. Validated
+ * inside the service; mismatches throw `HttpError.internal` so the
+ * caller gets a clean 500 rather than half-rendered garbage.
+ */
+export declare const advisorLlmOutputSchema: z.ZodObject<{
+    prose: z.ZodString;
+    recommendations: z.ZodArray<z.ZodObject<{
+        slug: z.ZodString;
+        reason: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        slug: string;
+        reason: string;
+    }, {
+        slug: string;
+        reason: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    prose: string;
+    recommendations: {
+        slug: string;
+        reason: string;
+    }[];
+}, {
+    prose: string;
+    recommendations: {
+        slug: string;
+        reason: string;
+    }[];
+}>;
+export type AdvisorLlmOutput = z.infer<typeof advisorLlmOutputSchema>;
+//# sourceMappingURL=advisor.schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"advisor.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/advisor.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;;GAMG;AAEH,eAAO,MAAM,iBAAiB,+BAA6B,CAAA;AAC3D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAE3D,eAAO,MAAM,oBAAoB;;IAG7B;;;;;OAKG;;;;;;;;;;;;;;EAWH,CAAA;AACJ,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEjE;;;;GAIG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;EAGtC,CAAA;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAA;AAE/E,eAAO,MAAM,qBAAqB;IAChC;;;OAGG;;;;;;;;;;;;IAGH;;;;;;OAMG;;IAEH;;;OAGG;;IAEH;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOH,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEnE,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;EAAoC,CAAA;AAC3E,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAA;AAE7E;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;EAUjC,CAAA;AACF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA"}

package/dist/schemas/advisor.schema.js

@@ -0,0 +1,84 @@
+import { z } from 'zod';
+/**
+ * Contextual Skill Advisor — prose recommendations behind a tiered
+ * freemium quota. See `apps/api/src/services/advisor.service.ts` for
+ * the orchestrator; the schemas below pin the request, response, and
+ * LLM-output shapes so a model drift on the Haiku side gets caught at
+ * the Zod boundary, not in the UI.
+ */
+export const advisorModeSchema = z.enum(['manual', 'auto']);
+export const advisorRequestSchema = z
+    .object({
+    mode: advisorModeSchema.default('manual'),
+    /**
+     * Task description for manual mode. Required when `mode === 'manual'`,
+     * ignored when `mode === 'auto'`. We cap at 1200 chars so a long
+     * paste can't blow the Haiku prompt window — the input field on the
+     * web side enforces the same limit.
+     */
+    task: z.string().trim().min(8).max(1200).optional(),
+})
+    .superRefine((val, ctx) => {
+    if (val.mode === 'manual' && (!val.task || val.task.length < 8)) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ['task'],
+            message: 'Manual mode needs at least 8 characters of task description.',
+        });
+    }
+});
+/**
+ * One recommended skill in the advisor's response. `slug` is always a
+ * real catalogue slug — the service drops anything Haiku invented
+ * before the response leaves the API.
+ */
+export const advisorRecommendationSchema = z.object({
+    slug: z.string().min(1).max(120),
+    reason: z.string().min(1).max(400),
+});
+export const advisorResponseSchema = z.object({
+    /**
+     * Prose paragraph the model writes. Calmly-cased, no markdown
+     * fences, no emoji. The web result block renders this verbatim.
+     */
+    prose: z.string().min(1).max(2400),
+    recommendations: z.array(advisorRecommendationSchema).max(5),
+    /**
+     * BM25 top-5 fallback slugs. Always populated so the UI can render
+     * clickable Skill cards even when `recommendations` is empty (Haiku
+     * said "no fit" or hallucinated unknown slugs). When this list backs
+     * the result, the server also refunds the rate-limit slot — the
+     * user wasn't billed for a zero-reasoned response.
+     */
+    candidate_slugs: z.array(z.string()).default([]),
+    /**
+     * Echoed for telemetry + cache-bust debugging. The UI doesn't render
+     * this but the analytics layer does.
+     */
+    mode: advisorModeSchema,
+    /**
+     * After-this-call quota snapshot — saves the web UI a round-trip
+     * back to `GET /advisor/quota` immediately after a success.
+     */
+    quota: z.object({
+        plan: z.enum(['free', 'pro', 'max']),
+        limit: z.number().int().nonnegative(),
+        used: z.number().int().nonnegative(),
+        remaining: z.number().int().nonnegative(),
+    }),
+});
+export const advisorQuotaResponseSchema = advisorResponseSchema.shape.quota;
+/**
+ * Raw Haiku JSON shape — what the model is told to produce. Validated
+ * inside the service; mismatches throw `HttpError.internal` so the
+ * caller gets a clean 500 rather than half-rendered garbage.
+ */
+export const advisorLlmOutputSchema = z.object({
+    prose: z.string().min(1).max(2400),
+    recommendations: z
+        .array(z.object({
+        slug: z.string().min(1).max(120),
+        reason: z.string().min(1).max(400),
+    }))
+        .max(8), // accept up to 8 so we can drop hallucinations before capping to 5
+});

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

@@ -30,6 +30,16 @@ export declare const hookSchema: z.ZodObject<{
     command: z.ZodString;
     /** Optional per-hook timeout in seconds (1–600). */
     timeout_seconds: z.ZodNullable<z.ZodNumber>;
+    /**
+     * Agents whose runtime exposes a compatible lifecycle-event
+     * contract. Today the answer is always `['claude']` because no
+     * other coding agent (Codex, Gemini, Cursor, Continue, Cline, Amp,
+     * Aider) ships a comparable `PreToolUse`/`PostToolUse` API. The
+     * field exists so we can fan out — without a schema change — the
+     * moment those runtimes catch up. Attached server-side on every
+     * hook GET; not stored in the DB.
+     */
+    supported_agents: z.ZodDefault<z.ZodArray<z.ZodEnum<["claude"]>, "many">>;
     visibility: z.ZodDefault<z.ZodEnum<["public", "private"]>>;
     source_repo: z.ZodNullable<z.ZodString>;
     license: z.ZodDefault<z.ZodString>;
@@ -87,6 +97,7 @@ export declare const hookSchema: z.ZodObject<{
     matcher: string | null;
     command: string;
     timeout_seconds: number | null;
+    supported_agents: "claude"[];
     bookmarked?: boolean | undefined;
     owner?: {
         id: string;
@@ -127,6 +138,7 @@ export declare const hookSchema: z.ZodObject<{
     } | null | undefined;
     security_rating?: "trusted" | "low_risk" | "med_risk" | "critical" | "pending" | null | undefined;
     version?: number | undefined;
+    supported_agents?: "claude"[] | undefined;
     installed?: boolean | undefined;
 }>;
 export type Hook = z.infer<typeof hookSchema>;

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

@@ -1 +1 @@
-{"version":3,"file":"hook.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/hook.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;;;;GAQG;AAEH,eAAO,MAAM,eAAe,oIAS1B,CAAA;AACF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAEvD,eAAO,MAAM,oBAAoB,kCAAgC,CAAA;AACjE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEjE,eAAO,MAAM,UAAU;;;;;;IAWrB,uDAAuD;;IAEvD;;;;OAIG;;IAEH,6DAA6D;;IAE7D,oDAAoD;;;;;;;;;IAWpD,kEAAkE;;IAMlE,qDAAqD;;IAErD,qDAAqD;;IAErD,8DAA8D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAe9D,CAAA;AACF,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAA;AAI7C,eAAO,MAAM,cAAc,2DAAyD,CAAA;AACpF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAErD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;EAOhC,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAInE;;;;GAIG;AACH,eAAO,MAAM,qBAAqB;;;;;;EAQhC,CAAA;AACF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAIxE;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;EAIlC,CAAA;AACF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAEvE;;;GAGG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;EAGtC,CAAA;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAA;AAE/E,kCAAkC;AAClC,eAAO,MAAM,kBAAkB;;;;;;;;;EAG7B,CAAA;AACF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAE7D,mEAAmE;AACnE,eAAO,MAAM,qBAAqB;;;;;;;;;EAGhC,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAInE,eAAO,MAAM,uBAAuB;;;;;;EAElC,CAAA;AACF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAEvE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,IAAI,GAAG,IAAI,CAAA;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,gBAAgB,EAAE,CAAA;IACzB,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB"}
+{"version":3,"file":"hook.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/hook.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;;;;GAQG;AAEH,eAAO,MAAM,eAAe,oIAS1B,CAAA;AACF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAEvD,eAAO,MAAM,oBAAoB,kCAAgC,CAAA;AACjE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEjE,eAAO,MAAM,UAAU;;;;;;IAWrB,uDAAuD;;IAEvD;;;;OAIG;;IAEH,6DAA6D;;IAE7D,oDAAoD;;IAGpD;;;;;;;;OAQG;;;;;;;;;IAWH,kEAAkE;;IAMlE,qDAAqD;;IAErD,qDAAqD;;IAErD,8DAA8D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAe9D,CAAA;AACF,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAA;AAI7C,eAAO,MAAM,cAAc,2DAAyD,CAAA;AACpF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAErD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;EAOhC,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAInE;;;;GAIG;AACH,eAAO,MAAM,qBAAqB;;;;;;EAQhC,CAAA;AACF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAIxE;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;EAIlC,CAAA;AACF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAEvE;;;GAGG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;EAGtC,CAAA;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAA;AAE/E,kCAAkC;AAClC,eAAO,MAAM,kBAAkB;;;;;;;;;EAG7B,CAAA;AACF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAE7D,mEAAmE;AACnE,eAAO,MAAM,qBAAqB;;;;;;;;;EAGhC,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAInE,eAAO,MAAM,uBAAuB;;;;;;EAElC,CAAA;AACF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAEvE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,IAAI,GAAG,IAAI,CAAA;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,gBAAgB,EAAE,CAAA;IACzB,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB"}

package/dist/schemas/hook.schema.js

@@ -41,6 +41,16 @@ export const hookSchema = z.object({
     command: z.string().min(1).max(4000),
     /** Optional per-hook timeout in seconds (1–600). */
     timeout_seconds: z.number().int().min(1).max(600).nullable(),
+    /**
+     * Agents whose runtime exposes a compatible lifecycle-event
+     * contract. Today the answer is always `['claude']` because no
+     * other coding agent (Codex, Gemini, Cursor, Continue, Cline, Amp,
+     * Aider) ships a comparable `PreToolUse`/`PostToolUse` API. The
+     * field exists so we can fan out — without a schema change — the
+     * moment those runtimes catch up. Attached server-side on every
+     * hook GET; not stored in the DB.
+     */
+    supported_agents: z.array(z.enum(['claude'])).default(['claude']),
     visibility: hookVisibilitySchema.default('public'),
     source_repo: z.string().url().nullable(),
     license: z.string().default('MIT'),

package/dist/schemas/index.d.ts

@@ -12,4 +12,5 @@ export * from './api-keys.schema.js';
 export * from './skill-report.schema.js';
 export * from './security-audit.schema.js';
 export * from './hook.schema.js';
+export * from './advisor.schema.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/schemas/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAA;AACxC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,yBAAyB,CAAA;AACvC,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,0BAA0B,CAAA;AACxC,cAAc,sBAAsB,CAAA;AACpC,cAAc,0BAA0B,CAAA;AACxC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAA;AACxC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,yBAAyB,CAAA;AACvC,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,0BAA0B,CAAA;AACxC,cAAc,sBAAsB,CAAA;AACpC,cAAc,0BAA0B,CAAA;AACxC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,kBAAkB,CAAA;AAChC,cAAc,qBAAqB,CAAA"}

package/dist/schemas/index.js

@@ -12,3 +12,4 @@ export * from './api-keys.schema.js';
 export * from './skill-report.schema.js';
 export * from './security-audit.schema.js';
 export * from './hook.schema.js';
+export * from './advisor.schema.js';

package/dist/types/plan-limits.d.ts

@@ -99,6 +99,14 @@ export interface PlanLimits {
     usage_history_days: number | null;
     /** CSV export of usage history. */
     can_usage_export: boolean;
+    /**
+     * Daily call cap on the Contextual Skill Advisor (the prose-
+     * recommendation endpoint). Tiered freemium — every plan can call
+     * the advisor, but Free runs out fast (3) and Max gets the most
+     * (30). Quota lives in Redis fixed-window buckets; see
+     * `apps/api/src/config/rate-limit-buckets.ts`.
+     */
+    advisor_calls_per_day: number;
     /** Public profile page at `/u/<username>`. */
     can_public_profile: boolean;
     /**

package/dist/types/plan-limits.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan-limits.d.ts","sourceRoot":"","sources":["../../src/types/plan-limits.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAA;AACxD,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAE/D;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,UAAU;IACzB,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAA;IACb,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAA;IACf,2EAA2E;IAC3E,iBAAiB,EAAE,MAAM,CAAA;IACzB,gEAAgE;IAChE,gBAAgB,EAAE,MAAM,CAAA;IACxB,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAA;IACZ,0DAA0D;IAC1D,SAAS,EAAE,OAAO,CAAA;IAGlB,+EAA+E;IAC/E,YAAY,EAAE,OAAO,CAAA;IACrB,8BAA8B;IAC9B,YAAY,EAAE,OAAO,CAAA;IACrB;;;;;;;;OAQG;IACH,mBAAmB,EAAE,OAAO,CAAA;IAG5B;;;OAGG;IACH,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAA;IACpC,4BAA4B;IAC5B,YAAY,EAAE,OAAO,CAAA;IACrB,wDAAwD;IACxD,cAAc,EAAE,OAAO,CAAA;IACvB,yCAAyC;IACzC,sBAAsB,EAAE,OAAO,CAAA;IAG/B,0CAA0C;IAC1C,oBAAoB,EAAE,OAAO,CAAA;IAC7B,0CAA0C;IAC1C,qBAAqB,EAAE,OAAO,CAAA;IAC9B;;OAEG;IACH,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAA;IACnC,oDAAoD;IACpD,kBAAkB,EAAE,OAAO,CAAA;IAG3B,gDAAgD;IAChD,gBAAgB,EAAE,OAAO,CAAA;IACzB;;;;;OAKG;IACH,wBAAwB,EAAE,MAAM,GAAG,IAAI,CAAA;IACvC;;;;;;;;OAQG;IACH,wBAAwB,EAAE,MAAM,GAAG,IAAI,CAAA;IACvC;;;;;OAKG;IACH,yBAAyB,EAAE,OAAO,CAAA;IAClC,uDAAuD;IACvD,aAAa,EAAE,OAAO,CAAA;IACtB,qCAAqC;IACrC,kBAAkB,EAAE,OAAO,CAAA;IAC3B;;;OAGG;IACH,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,mCAAmC;IACnC,gBAAgB,EAAE,OAAO,CAAA;IAGzB,8CAA8C;IAC9C,kBAAkB,EAAE,OAAO,CAAA;IAC3B;;;OAGG;IACH,oBAAoB,EAAE,OAAO,CAAA;IAC7B,oDAAoD;IACpD,kBAAkB,EAAE,OAAO,CAAA;IAC3B,mEAAmE;IACnE,kBAAkB,EAAE,OAAO,CAAA;IAG3B,6CAA6C;IAC7C,oBAAoB,EAAE,OAAO,CAAA;IAC7B,+CAA+C;IAC/C,gBAAgB,EAAE,OAAO,CAAA;IAGzB;;;;;OAKG;IACH,mBAAmB,EAAE,SAAS,SAAS,EAAE,CAAA;CAC1C;AAKD,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,IAAI,EAAE,UAAU,CAyJhD,CAAA;AAED,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAI1C,CAAA;AAED,8DAA8D;AAC9D,eAAO,MAAM,SAAS,GAAI,QAAQ,IAAI,EAAE,UAAU,IAAI,KAAG,OACf,CAAA;AAE1C;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GAAI,SAAS,MAAM,UAAU,KAAG,IAAI,GAAG,IAU7D,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,MAAM,IAAI,KAAG,MAAiC,CAAA;AAExE;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,MAAM,IAAI,EAAE,eAAe,MAAM,KAAG,MAAM,GAAG,IAI9E,CAAA"}
+{"version":3,"file":"plan-limits.d.ts","sourceRoot":"","sources":["../../src/types/plan-limits.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAA;AACxD,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAE/D;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,UAAU;IACzB,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAA;IACb,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAA;IACf,2EAA2E;IAC3E,iBAAiB,EAAE,MAAM,CAAA;IACzB,gEAAgE;IAChE,gBAAgB,EAAE,MAAM,CAAA;IACxB,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAA;IACZ,0DAA0D;IAC1D,SAAS,EAAE,OAAO,CAAA;IAGlB,+EAA+E;IAC/E,YAAY,EAAE,OAAO,CAAA;IACrB,8BAA8B;IAC9B,YAAY,EAAE,OAAO,CAAA;IACrB;;;;;;;;OAQG;IACH,mBAAmB,EAAE,OAAO,CAAA;IAG5B;;;OAGG;IACH,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAA;IACpC,4BAA4B;IAC5B,YAAY,EAAE,OAAO,CAAA;IACrB,wDAAwD;IACxD,cAAc,EAAE,OAAO,CAAA;IACvB,yCAAyC;IACzC,sBAAsB,EAAE,OAAO,CAAA;IAG/B,0CAA0C;IAC1C,oBAAoB,EAAE,OAAO,CAAA;IAC7B,0CAA0C;IAC1C,qBAAqB,EAAE,OAAO,CAAA;IAC9B;;OAEG;IACH,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAA;IACnC,oDAAoD;IACpD,kBAAkB,EAAE,OAAO,CAAA;IAG3B,gDAAgD;IAChD,gBAAgB,EAAE,OAAO,CAAA;IACzB;;;;;OAKG;IACH,wBAAwB,EAAE,MAAM,GAAG,IAAI,CAAA;IACvC;;;;;;;;OAQG;IACH,wBAAwB,EAAE,MAAM,GAAG,IAAI,CAAA;IACvC;;;;;OAKG;IACH,yBAAyB,EAAE,OAAO,CAAA;IAClC,uDAAuD;IACvD,aAAa,EAAE,OAAO,CAAA;IACtB,qCAAqC;IACrC,kBAAkB,EAAE,OAAO,CAAA;IAC3B;;;OAGG;IACH,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,mCAAmC;IACnC,gBAAgB,EAAE,OAAO,CAAA;IAGzB;;;;;;OAMG;IACH,qBAAqB,EAAE,MAAM,CAAA;IAG7B,8CAA8C;IAC9C,kBAAkB,EAAE,OAAO,CAAA;IAC3B;;;OAGG;IACH,oBAAoB,EAAE,OAAO,CAAA;IAC7B,oDAAoD;IACpD,kBAAkB,EAAE,OAAO,CAAA;IAC3B,mEAAmE;IACnE,kBAAkB,EAAE,OAAO,CAAA;IAG3B,6CAA6C;IAC7C,oBAAoB,EAAE,OAAO,CAAA;IAC7B,+CAA+C;IAC/C,gBAAgB,EAAE,OAAO,CAAA;IAGzB;;;;;OAKG;IACH,mBAAmB,EAAE,SAAS,SAAS,EAAE,CAAA;CAC1C;AAKD,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,IAAI,EAAE,UAAU,CA+JhD,CAAA;AAED,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAI1C,CAAA;AAED,8DAA8D;AAC9D,eAAO,MAAM,SAAS,GAAI,QAAQ,IAAI,EAAE,UAAU,IAAI,KAAG,OACf,CAAA;AAE1C;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GAAI,SAAS,MAAM,UAAU,KAAG,IAAI,GAAG,IAU7D,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,MAAM,IAAI,KAAG,MAAiC,CAAA;AAExE;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,MAAM,IAAI,EAAE,eAAe,MAAM,KAAG,MAAM,GAAG,IAI9E,CAAA"}

package/dist/types/plan-limits.js

@@ -37,6 +37,7 @@ export const PLAN_LIMITS = {
         can_usage_tracking: false,
         usage_history_days: 0,
         can_usage_export: false,
+        advisor_calls_per_day: 3,
         can_public_profile: false,
         can_magic_link_share: false,
         has_verified_badge: false,
@@ -80,6 +81,7 @@ export const PLAN_LIMITS = {
         can_usage_tracking: true,
         usage_history_days: 30,
         can_usage_export: false,
+        advisor_calls_per_day: 10,
         can_public_profile: true,
         can_magic_link_share: false,
         has_verified_badge: true,
@@ -121,6 +123,7 @@ export const PLAN_LIMITS = {
         can_usage_tracking: true,
         usage_history_days: null,
         can_usage_export: true,
+        advisor_calls_per_day: 30,
         can_public_profile: true,
         can_magic_link_share: true,
         has_verified_badge: true,

package/package.json

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