@prave/shared 0.1.0 → 0.3.0

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

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-export declare const skillVisibilitySchema: z.ZodEnum<["public", "private", "org"]>;
+export declare const skillVisibilitySchema: z.ZodEnum<["public", "private"]>;
 export type SkillVisibility = z.infer<typeof skillVisibilitySchema>;
 export declare const skillSchema: z.ZodObject<{
     id: z.ZodString;
@@ -8,7 +8,7 @@ export declare const skillSchema: z.ZodObject<{
     slug: z.ZodString;
     description: z.ZodNullable<z.ZodString>;
     content: z.ZodNullable<z.ZodString>;
-    visibility: z.ZodDefault<z.ZodEnum<["public", "private", "org"]>>;
+    visibility: z.ZodDefault<z.ZodEnum<["public", "private"]>>;
     source_repo: z.ZodNullable<z.ZodString>;
     license: z.ZodDefault<z.ZodString>;
     category: z.ZodNullable<z.ZodString>;
@@ -24,6 +24,29 @@ export declare const skillSchema: z.ZodObject<{
     is_owner: z.ZodOptional<z.ZodBoolean>;
     /** Attached by the API on GET: true if the caller has bookmarked the Skill. */
     bookmarked: z.ZodOptional<z.ZodBoolean>;
+    /** Attached by the API: a public slice of the owner profile so cards can render attribution. */
+    owner: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        username: z.ZodNullable<z.ZodString>;
+        display_name: z.ZodNullable<z.ZodString>;
+        avatar_url: z.ZodNullable<z.ZodString>;
+        is_creator: z.ZodBoolean;
+        is_partner: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        username: string | null;
+        display_name: string | null;
+        avatar_url: string | null;
+        is_creator: boolean;
+        is_partner: boolean;
+    }, {
+        id: string;
+        username: string | null;
+        display_name: string | null;
+        avatar_url: string | null;
+        is_creator: boolean;
+        is_partner: boolean;
+    }>>>;
     created_at: z.ZodString;
     updated_at: z.ZodString;
 }, "strip", z.ZodTypeAny, {
@@ -33,7 +56,7 @@ export declare const skillSchema: z.ZodObject<{
     slug: string;
     description: string | null;
     content: string | null;
-    visibility: "public" | "private" | "org";
+    visibility: "public" | "private";
     source_repo: string | null;
     license: string;
     category: string | null;
@@ -48,6 +71,14 @@ export declare const skillSchema: z.ZodObject<{
     purchased?: boolean | undefined;
     is_owner?: boolean | undefined;
     bookmarked?: boolean | undefined;
+    owner?: {
+        id: string;
+        username: string | null;
+        display_name: string | null;
+        avatar_url: string | null;
+        is_creator: boolean;
+        is_partner: boolean;
+    } | null | undefined;
 }, {
     id: string;
     owner_id: string;
@@ -59,7 +90,7 @@ export declare const skillSchema: z.ZodObject<{
     category: string | null;
     created_at: string;
     updated_at: string;
-    visibility?: "public" | "private" | "org" | undefined;
+    visibility?: "public" | "private" | undefined;
     license?: string | undefined;
     tags?: string[] | undefined;
     install_count?: number | undefined;
@@ -70,6 +101,14 @@ export declare const skillSchema: z.ZodObject<{
     purchased?: boolean | undefined;
     is_owner?: boolean | undefined;
     bookmarked?: boolean | undefined;
+    owner?: {
+        id: string;
+        username: string | null;
+        display_name: string | null;
+        avatar_url: string | null;
+        is_creator: boolean;
+        is_partner: boolean;
+    } | null | undefined;
 }>;
 export type Skill = z.infer<typeof skillSchema>;
 export declare const createSkillInputSchema: z.ZodObject<{
@@ -77,7 +116,7 @@ export declare const createSkillInputSchema: z.ZodObject<{
     slug: z.ZodString;
     description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     content: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    visibility: z.ZodOptional<z.ZodDefault<z.ZodEnum<["public", "private", "org"]>>>;
+    visibility: z.ZodOptional<z.ZodDefault<z.ZodEnum<["public", "private"]>>>;
     source_repo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     license: z.ZodOptional<z.ZodDefault<z.ZodString>>;
     category: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -89,7 +128,7 @@ export declare const createSkillInputSchema: z.ZodObject<{
     slug: string;
     description?: string | null | undefined;
     content?: string | null | undefined;
-    visibility?: "public" | "private" | "org" | undefined;
+    visibility?: "public" | "private" | undefined;
     source_repo?: string | null | undefined;
     license?: string | undefined;
     category?: string | null | undefined;
@@ -101,7 +140,7 @@ export declare const createSkillInputSchema: z.ZodObject<{
     slug: string;
     description?: string | null | undefined;
     content?: string | null | undefined;
-    visibility?: "public" | "private" | "org" | undefined;
+    visibility?: "public" | "private" | undefined;
     source_repo?: string | null | undefined;
     license?: string | undefined;
     category?: string | null | undefined;
@@ -115,7 +154,7 @@ export declare const updateSkillInputSchema: z.ZodObject<{
     slug: z.ZodOptional<z.ZodString>;
     description: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
     content: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
-    visibility: z.ZodOptional<z.ZodOptional<z.ZodDefault<z.ZodEnum<["public", "private", "org"]>>>>;
+    visibility: z.ZodOptional<z.ZodOptional<z.ZodDefault<z.ZodEnum<["public", "private"]>>>>;
     source_repo: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
     license: z.ZodOptional<z.ZodOptional<z.ZodDefault<z.ZodString>>>;
     category: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
@@ -129,7 +168,7 @@ export declare const updateSkillInputSchema: z.ZodObject<{
     slug?: string | undefined;
     description?: string | null | undefined;
     content?: string | null | undefined;
-    visibility?: "public" | "private" | "org" | undefined;
+    visibility?: "public" | "private" | undefined;
     source_repo?: string | null | undefined;
     license?: string | undefined;
     category?: string | null | undefined;
@@ -142,7 +181,7 @@ export declare const updateSkillInputSchema: z.ZodObject<{
     slug?: string | undefined;
     description?: string | null | undefined;
     content?: string | null | undefined;
-    visibility?: "public" | "private" | "org" | undefined;
+    visibility?: "public" | "private" | undefined;
     source_repo?: string | null | undefined;
     license?: string | undefined;
     category?: string | null | undefined;
@@ -177,4 +216,31 @@ export declare const skillSearchQuerySchema: z.ZodObject<{
     offset?: number | undefined;
 }>;
 export type SkillSearchQuery = z.infer<typeof skillSearchQuerySchema>;
+export declare const mySkillsQuerySchema: z.ZodObject<{
+    q: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodString>;
+    tag: z.ZodOptional<z.ZodString>;
+    sort: z.ZodDefault<z.ZodEnum<["trending", "popular", "newest", "relevance"]>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+} & {
+    visibility: z.ZodOptional<z.ZodEnum<["public", "private"]>>;
+}, "strip", z.ZodTypeAny, {
+    sort: "trending" | "popular" | "newest" | "relevance";
+    limit: number;
+    offset: number;
+    visibility?: "public" | "private" | undefined;
+    category?: string | undefined;
+    q?: string | undefined;
+    tag?: string | undefined;
+}, {
+    sort?: "trending" | "popular" | "newest" | "relevance" | undefined;
+    visibility?: "public" | "private" | undefined;
+    category?: string | undefined;
+    q?: string | undefined;
+    tag?: string | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+}>;
+export type MySkillsQuery = z.infer<typeof mySkillsQuerySchema>;
 //# 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,yCAAuC,CAAA;AACzE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEnE,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;IAqBtB,6EAA6E;;IAE7E,mEAAmE;;IAEnE,+EAA+E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAI/E,CAAA;AACF,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAA;AAE/C,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwB/B,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"}
+{"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,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;IAqBtB,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwB/B,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"}

package/dist/schemas/skill.schema.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-export const skillVisibilitySchema = z.enum(['public', 'private', 'org']);
+export const skillVisibilitySchema = z.enum(['public', 'private']);
 export const skillSchema = z.object({
     id: z.string().uuid(),
     owner_id: z.string().uuid(),
@@ -27,6 +27,18 @@ export const skillSchema = z.object({
     is_owner: z.boolean().optional(),
     /** Attached by the API on GET: true if the caller has bookmarked the Skill. */
     bookmarked: z.boolean().optional(),
+    /** Attached by the API: a public slice of the owner profile so cards can render attribution. */
+    owner: z
+        .object({
+        id: z.string().uuid(),
+        username: z.string().nullable(),
+        display_name: z.string().nullable(),
+        avatar_url: z.string().nullable(),
+        is_creator: z.boolean(),
+        is_partner: z.boolean(),
+    })
+        .nullable()
+        .optional(),
     created_at: z.string().datetime(),
     updated_at: z.string().datetime(),
 });
@@ -67,3 +79,6 @@ export const skillSearchQuerySchema = z.object({
     limit: z.coerce.number().int().min(1).max(100).default(24),
     offset: z.coerce.number().int().nonnegative().default(0),
 });
+export const mySkillsQuerySchema = skillSearchQuerySchema.extend({
+    visibility: z.enum(['public', 'private']).optional(),
+});

package/dist/types/categories.d.ts

@@ -0,0 +1,5 @@
+export declare const SKILL_CATEGORIES: readonly ["engineering", "design", "marketing", "research", "writing", "analytics", "productivity", "devops", "data", "ai", "security", "product", "workflow-orchestration", "other"];
+export type SkillCategory = (typeof SKILL_CATEGORIES)[number];
+export declare const CATEGORY_LABELS: Record<SkillCategory, string>;
+export declare function isSkillCategory(value: unknown): value is SkillCategory;
+//# sourceMappingURL=categories.d.ts.map

package/dist/types/categories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"categories.d.ts","sourceRoot":"","sources":["../../src/types/categories.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,uLAenB,CAAA;AAEV,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE7D,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAezD,CAAA;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAEtE"}

package/dist/types/categories.js

@@ -0,0 +1,35 @@
+export const SKILL_CATEGORIES = [
+    'engineering',
+    'design',
+    'marketing',
+    'research',
+    'writing',
+    'analytics',
+    'productivity',
+    'devops',
+    'data',
+    'ai',
+    'security',
+    'product',
+    'workflow-orchestration',
+    'other',
+];
+export const CATEGORY_LABELS = {
+    engineering: 'Engineering',
+    design: 'Design',
+    marketing: 'Marketing',
+    research: 'Research',
+    writing: 'Writing',
+    analytics: 'Analytics',
+    productivity: 'Productivity',
+    devops: 'DevOps',
+    data: 'Data',
+    ai: 'AI',
+    security: 'Security',
+    product: 'Product',
+    'workflow-orchestration': 'Workflow',
+    other: 'Other',
+};
+export function isSkillCategory(value) {
+    return typeof value === 'string' && SKILL_CATEGORIES.includes(value);
+}

package/dist/types/index.d.ts

@@ -1,4 +1,7 @@
-export type UserPlan = 'free' | 'pro' | 'team';
+export * from './categories.js';
+export * from './plan-limits.js';
+export * from './intelligence.js';
+export type UserPlan = 'free' | 'explorer' | 'creator';
 export type UserRole = 'user' | 'admin';
 export interface Profile {
     id: string;
@@ -6,12 +9,34 @@ export interface Profile {
     display_name: string | null;
     avatar_url: string | null;
     github_username: string | null;
+    bio: string | null;
+    website_url: string | null;
+    is_creator: boolean;
+    is_partner: boolean;
     role: UserRole;
     plan: UserPlan;
     stripe_customer_id: string | null;
     created_at: string;
     updated_at: string;
 }
+/** Public-safe profile slice — no plan, no stripe ids, no role. */
+export interface PublicProfile {
+    id: string;
+    username: string | null;
+    display_name: string | null;
+    avatar_url: string | null;
+    github_username: string | null;
+    bio: string | null;
+    website_url: string | null;
+    is_creator: boolean;
+    is_partner: boolean;
+    created_at: string;
+}
+export interface PublicProfilePage {
+    profile: PublicProfile;
+    skills: import('../schemas/skill.schema.js').Skill[];
+    skill_count: number;
+}
 export interface AuthUser {
     id: string;
     email: string;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAA;AAC9C,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAA;AAEvC,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,IAAI,EAAE,QAAQ,CAAA;IACd,IAAI,EAAE,QAAQ,CAAA;IACd,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;CACd"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AAEjC,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,CAAA;AACtD,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAA;AAEvC,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,UAAU,EAAE,OAAO,CAAA;IACnB,UAAU,EAAE,OAAO,CAAA;IACnB,IAAI,EAAE,QAAQ,CAAA;IACd,IAAI,EAAE,QAAQ,CAAA;IACd,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,mEAAmE;AACnE,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,UAAU,EAAE,OAAO,CAAA;IACnB,UAAU,EAAE,OAAO,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,aAAa,CAAA;IACtB,MAAM,EAAE,OAAO,4BAA4B,EAAE,KAAK,EAAE,CAAA;IACpD,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;CACd"}

package/dist/types/index.js

@@ -1 +1,3 @@
-export {};
+export * from './categories.js';
+export * from './plan-limits.js';
+export * from './intelligence.js';

package/dist/types/intelligence.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Skill Intelligence — types shared across the API, web, CLI.
+ *
+ * Source-of-truth for the rows in `skill_metadata`, `skill_conflicts`,
+ * `skill_usage_stats`, and `user_agent_settings`. Every layer reads these.
+ */
+export declare const AGENT_TYPES: readonly ["claude", "codex", "cursor", "gemini", "cline", "amp"];
+export type AgentType = (typeof AGENT_TYPES)[number];
+export interface AgentMeta {
+    id: AgentType;
+    label: string;
+    description: string;
+    /** Default OS-specific skill paths used as a fallback in the UI. */
+    defaultPath: {
+        mac: string;
+        windows: string;
+    };
+    /** When true, the SKILL.md needs format conversion before deploy. */
+    conversionRequired: boolean;
+}
+export declare const AGENT_REGISTRY: Record<AgentType, AgentMeta>;
+export interface SkillMetadata {
+    id: string;
+    skill_id: string | null;
+    user_id: string;
+    name: string | null;
+    description: string | null;
+    triggers: string[];
+    slash_command: string | null;
+    disable_model_invocation: boolean;
+    user_invocable: boolean;
+    requires: string[];
+    estimated_tokens: number;
+    file_path: string;
+    agent_type: AgentType;
+    last_analyzed: string;
+    created_at: string;
+    updated_at: string;
+}
+export type ConflictType = 'trigger_overlap' | 'auto_invocation_collision' | 'dependency_conflict';
+export interface SkillConflict {
+    id: string;
+    user_id: string;
+    skill_a_id: string;
+    skill_b_id: string;
+    conflict_type: ConflictType;
+    conflict_detail: string | null;
+    detected_at: string;
+    skill_a_name?: string | null;
+    skill_b_name?: string | null;
+}
+export interface SkillUsageStat {
+    id: string;
+    user_id: string;
+    skill_metadata_id: string;
+    trigger_phrase: string | null;
+    triggered_at: string;
+}
+export interface UserAgentSettings {
+    user_id: string;
+    enabled_agents: AgentType[];
+    skill_paths: Record<AgentType, {
+        mac: string;
+        windows: string;
+    }>;
+    detected_os: 'mac' | 'windows' | 'linux' | null;
+    updated_at: string;
+}
+export interface IntelligenceOverview {
+    total_skills: number;
+    auto_trigger_count: number;
+    user_invocable_count: number;
+    total_estimated_tokens: number;
+    conflict_count: number;
+    agents: {
+        agent: AgentType;
+        skill_count: number;
+    }[];
+    /** Top 5 token-heaviest skills, for the panel summary. */
+    heaviest: Array<Pick<SkillMetadata, 'id' | 'name' | 'slash_command' | 'estimated_tokens'>>;
+}
+export interface IntelligenceOptimization {
+    underused: SkillMetadata[];
+    merge_candidates: Array<{
+        a: SkillMetadata;
+        b: SkillMetadata;
+        reason: string;
+    }>;
+    heavy: SkillMetadata[];
+    total_savings_estimate_tokens: number;
+}
+export interface IntelligenceSearchResult {
+    source: 'local' | 'marketplace';
+    id: string;
+    slug: string;
+    name: string;
+    description: string | null;
+    slash_command: string | null;
+    estimated_tokens: number;
+    install_count?: number | null;
+    rating?: number | null;
+    is_installed: boolean;
+}
+export interface LlmSearchResult {
+    task: string;
+    keywords: string[];
+    scope: 'local' | 'marketplace' | 'both';
+    suggested_triggers: string[];
+    results: IntelligenceSearchResult[];
+}
+/** Shape returned to `prave whatdoes` and the Intelligence detail panel. */
+export interface SkillWhatDoes {
+    found: boolean;
+    source: 'local' | 'marketplace' | null;
+    metadata: SkillMetadata | null;
+    marketplace?: {
+        slug: string;
+        name: string;
+        description: string | null;
+        install_count: number;
+        rating: number | null;
+    } | null;
+    conflicts: SkillConflict[];
+    similar?: Array<{
+        slug: string;
+        name: string;
+    }>;
+}
+/** Token-tier classification used by the CLI + UI badges. */
+export type TokenTier = 'lean' | 'medium' | 'heavy';
+export declare const tokenTier: (n: number) => TokenTier;
+//# sourceMappingURL=intelligence.d.ts.map

package/dist/types/intelligence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intelligence.d.ts","sourceRoot":"","sources":["../../src/types/intelligence.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,WAAW,kEAAmE,CAAA;AAC3F,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAA;AAEpD,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,SAAS,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,oEAAoE;IACpE,WAAW,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;IAC7C,qEAAqE;IACrE,kBAAkB,EAAE,OAAO,CAAA;CAC5B;AAED,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,SAAS,EAAE,SAAS,CA2CvD,CAAA;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,wBAAwB,EAAE,OAAO,CAAA;IACjC,cAAc,EAAE,OAAO,CAAA;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,gBAAgB,EAAE,MAAM,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,SAAS,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,MAAM,YAAY,GACpB,iBAAiB,GACjB,2BAA2B,GAC3B,qBAAqB,CAAA;AAEzB,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,YAAY,CAAA;IAC3B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,WAAW,EAAE,MAAM,CAAA;IAEnB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,iBAAiB,EAAE,MAAM,CAAA;IACzB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,SAAS,EAAE,CAAA;IAC3B,WAAW,EAAE,MAAM,CAAC,SAAS,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAChE,WAAW,EAAE,KAAK,GAAG,SAAS,GAAG,OAAO,GAAG,IAAI,CAAA;IAC/C,UAAU,EAAE,MAAM,CAAA;CACnB;AAID,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAA;IACpB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,oBAAoB,EAAE,MAAM,CAAA;IAC5B,sBAAsB,EAAE,MAAM,CAAA;IAC9B,cAAc,EAAE,MAAM,CAAA;IACtB,MAAM,EAAE;QAAE,KAAK,EAAE,SAAS,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACnD,0DAA0D;IAC1D,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,MAAM,GAAG,eAAe,GAAG,kBAAkB,CAAC,CAAC,CAAA;CAC3F;AAED,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,aAAa,EAAE,CAAA;IAC1B,gBAAgB,EAAE,KAAK,CAAC;QAAE,CAAC,EAAE,aAAa,CAAC;QAAC,CAAC,EAAE,aAAa,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC/E,KAAK,EAAE,aAAa,EAAE,CAAA;IACtB,6BAA6B,EAAE,MAAM,CAAA;CACtC;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,OAAO,GAAG,aAAa,CAAA;IAC/B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,gBAAgB,EAAE,MAAM,CAAA;IACxB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,YAAY,EAAE,OAAO,CAAA;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,KAAK,EAAE,OAAO,GAAG,aAAa,GAAG,MAAM,CAAA;IACvC,kBAAkB,EAAE,MAAM,EAAE,CAAA;IAC5B,OAAO,EAAE,wBAAwB,EAAE,CAAA;CACpC;AAED,4EAA4E;AAC5E,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI,CAAA;IACtC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAA;IAC9B,WAAW,CAAC,EAAE;QACZ,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,EAAE,MAAM,CAAA;QACZ,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;QAC1B,aAAa,EAAE,MAAM,CAAA;QACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KACtB,GAAG,IAAI,CAAA;IACR,SAAS,EAAE,aAAa,EAAE,CAAA;IAC1B,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAChD;AAED,6DAA6D;AAC7D,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAA;AACnD,eAAO,MAAM,SAAS,GAAI,GAAG,MAAM,KAAG,SACY,CAAA"}

package/dist/types/intelligence.js

@@ -0,0 +1,52 @@
+/**
+ * Skill Intelligence — types shared across the API, web, CLI.
+ *
+ * Source-of-truth for the rows in `skill_metadata`, `skill_conflicts`,
+ * `skill_usage_stats`, and `user_agent_settings`. Every layer reads these.
+ */
+export const AGENT_TYPES = ['claude', 'codex', 'cursor', 'gemini', 'cline', 'amp'];
+export const AGENT_REGISTRY = {
+    claude: {
+        id: 'claude',
+        label: 'Claude Code',
+        description: "Anthropic's terminal-based coding agent",
+        defaultPath: { mac: '~/.claude/skills/', windows: '%APPDATA%\\Claude\\skills\\' },
+        conversionRequired: false,
+    },
+    codex: {
+        id: 'codex',
+        label: 'OpenAI Codex',
+        description: "OpenAI's CLI coding agent",
+        defaultPath: { mac: '~/.codex/skills/', windows: '%APPDATA%\\Codex\\skills\\' },
+        conversionRequired: false,
+    },
+    cursor: {
+        id: 'cursor',
+        label: 'Cursor',
+        description: 'AI-first code editor',
+        defaultPath: { mac: '.cursor/rules/', windows: '.cursor\\rules\\' },
+        conversionRequired: true,
+    },
+    gemini: {
+        id: 'gemini',
+        label: 'Gemini CLI',
+        description: "Google's terminal agent",
+        defaultPath: { mac: '~/.gemini/skills/', windows: '%APPDATA%\\Gemini\\skills\\' },
+        conversionRequired: false,
+    },
+    cline: {
+        id: 'cline',
+        label: 'Cline',
+        description: 'Open-source VS Code agent',
+        defaultPath: { mac: '~/.cline/skills/', windows: '%APPDATA%\\Cline\\skills\\' },
+        conversionRequired: false,
+    },
+    amp: {
+        id: 'amp',
+        label: 'Amp',
+        description: 'Ampcode terminal agent',
+        defaultPath: { mac: '~/.amp/skills/', windows: '%APPDATA%\\Amp\\skills\\' },
+        conversionRequired: false,
+    },
+};
+export const tokenTier = (n) => n < 500 ? 'lean' : n < 2000 ? 'medium' : 'heavy';

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

@@ -0,0 +1,62 @@
+import type { Plan } from '../schemas/billing.schema.js';
+/**
+ * PLAN_LIMITS — single source of truth for every gate, quota and copy
+ * choice across the app. Backend uses the numeric/boolean fields to
+ * enforce rules; frontend reads the same object to render disabled
+ * states + upgrade CTAs; CLI calls /me/plan and resolves limits here so
+ * one config drives all three surfaces.
+ *
+ * `null` numeric limits = unlimited.
+ */
+export interface PlanLimits {
+    /** Display label used in pricing cards / Settings */
+    label: string;
+    /** Monthly price in EUR (display only — Stripe is the source of truth) */
+    price_eur_monthly: number;
+    /** Marketing tagline for the plan card */
+    tagline: string;
+    /** Marketplace creator share (0–1). Free can't sell. */
+    creator_revenue_share: number | null;
+    /** Max public skills the user can publish. null = unlimited. */
+    max_public_skills: number | null;
+    /** Can the user create private skills? */
+    can_private_skills: boolean;
+    /** Max private skills if allowed. null = unlimited. */
+    max_private_skills: number | null;
+    /** History tab + revert. */
+    can_versioning: boolean;
+    /** Max paid skills listed simultaneously. 0 = no marketplace. null = unlimited. */
+    max_marketplace_listings: number | null;
+    /** Monthly BYOK tester runs. 0 = blocked. null = unlimited. */
+    tester_credits_monthly: number | null;
+    /** Max bookmarks. null = unlimited. */
+    max_bookmarks: number | null;
+    /** Total skills the user may import via CLI. null = unlimited. */
+    cli_max_imports: number | null;
+    /** Monthly export quota via CLI. 0 = blocked. null = unlimited. */
+    cli_exports_monthly: number | null;
+    /** `prave sync` enabled. */
+    can_cli_sync: boolean;
+    /** Auto-update on `prave sync` rather than diff-only. */
+    can_cli_auto_update: boolean;
+    /** `prave install --bulk`, `prave export --bulk`. */
+    can_cli_bulk: boolean;
+    /** Drag-and-drop block builder UI. */
+    can_block_builder: boolean;
+    /** CI-style skill pipelines + automated tests. */
+    can_pipelines: boolean;
+    /** Per-skill analytics page. */
+    can_analytics: boolean;
+    /** Verified Creator badge on public profile. */
+    has_creator_badge: boolean;
+}
+export declare const PLAN_LIMITS: Record<Plan, PlanLimits>;
+export declare const PLAN_RANK: Record<Plan, number>;
+/** True when `actual` includes everything `required` does. */
+export declare const planMeets: (actual: Plan, required: Plan) => boolean;
+/**
+ * Smallest plan that satisfies a feature flag. Used by the UI to render
+ * accurate "Upgrade to X" CTAs without hard-coding plan names.
+ */
+export declare const minPlanFor: (feature: keyof PlanLimits) => Plan | null;
+//# sourceMappingURL=plan-limits.d.ts.map

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

@@ -0,0 +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;AAExD;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU;IACzB,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAA;IACb,0EAA0E;IAC1E,iBAAiB,EAAE,MAAM,CAAA;IACzB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAA;IACf,wDAAwD;IACxD,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAA;IAGpC,gEAAgE;IAChE,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,0CAA0C;IAC1C,kBAAkB,EAAE,OAAO,CAAA;IAC3B,uDAAuD;IACvD,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,4BAA4B;IAC5B,cAAc,EAAE,OAAO,CAAA;IAGvB,mFAAmF;IACnF,wBAAwB,EAAE,MAAM,GAAG,IAAI,CAAA;IAGvC,+DAA+D;IAC/D,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAA;IAGrC,uCAAuC;IACvC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAG5B,kEAAkE;IAClE,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,mEAAmE;IACnE,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,4BAA4B;IAC5B,YAAY,EAAE,OAAO,CAAA;IACrB,yDAAyD;IACzD,mBAAmB,EAAE,OAAO,CAAA;IAC5B,qDAAqD;IACrD,YAAY,EAAE,OAAO,CAAA;IAGrB,sCAAsC;IACtC,iBAAiB,EAAE,OAAO,CAAA;IAC1B,kDAAkD;IAClD,aAAa,EAAE,OAAO,CAAA;IACtB,gCAAgC;IAChC,aAAa,EAAE,OAAO,CAAA;IACtB,gDAAgD;IAChD,iBAAiB,EAAE,OAAO,CAAA;CAC3B;AAED,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,IAAI,EAAE,UAAU,CA+EhD,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;;;GAGG;AACH,eAAO,MAAM,UAAU,GAAI,SAAS,MAAM,UAAU,KAAG,IAAI,GAAG,IAO7D,CAAA"}

package/dist/types/plan-limits.js

@@ -0,0 +1,88 @@
+export const PLAN_LIMITS = {
+    free: {
+        label: 'Starter',
+        price_eur_monthly: 0,
+        tagline: 'Discover, install and try Prave Skills.',
+        creator_revenue_share: null,
+        max_public_skills: 3,
+        can_private_skills: false,
+        max_private_skills: 0,
+        can_versioning: false,
+        max_marketplace_listings: 0,
+        tester_credits_monthly: 10,
+        max_bookmarks: 5,
+        cli_max_imports: 10,
+        cli_exports_monthly: 0,
+        can_cli_sync: false,
+        can_cli_auto_update: false,
+        can_cli_bulk: false,
+        can_block_builder: false,
+        can_pipelines: false,
+        can_analytics: false,
+        has_creator_badge: false,
+    },
+    explorer: {
+        label: 'Explorer',
+        price_eur_monthly: 4,
+        tagline: 'For developers building and shipping Skills.',
+        creator_revenue_share: null,
+        max_public_skills: 20,
+        can_private_skills: true,
+        max_private_skills: 20,
+        can_versioning: true,
+        max_marketplace_listings: 0,
+        tester_credits_monthly: 80,
+        max_bookmarks: null,
+        cli_max_imports: null,
+        cli_exports_monthly: 50,
+        can_cli_sync: true,
+        can_cli_auto_update: false,
+        can_cli_bulk: false,
+        can_block_builder: false,
+        can_pipelines: false,
+        can_analytics: false,
+        has_creator_badge: false,
+    },
+    creator: {
+        label: 'Creator',
+        price_eur_monthly: 10,
+        tagline: 'For power users shipping and selling Skills daily.',
+        creator_revenue_share: 0.7,
+        max_public_skills: null,
+        can_private_skills: true,
+        max_private_skills: null,
+        can_versioning: true,
+        max_marketplace_listings: null,
+        tester_credits_monthly: 250,
+        max_bookmarks: null,
+        cli_max_imports: null,
+        cli_exports_monthly: null,
+        can_cli_sync: true,
+        can_cli_auto_update: true,
+        can_cli_bulk: true,
+        can_block_builder: true,
+        can_pipelines: true,
+        can_analytics: true,
+        has_creator_badge: true,
+    },
+};
+export const PLAN_RANK = {
+    free: 0,
+    explorer: 1,
+    creator: 2,
+};
+/** True when `actual` includes everything `required` does. */
+export const planMeets = (actual, required) => PLAN_RANK[actual] >= PLAN_RANK[required];
+/**
+ * Smallest plan that satisfies a feature flag. Used by the UI to render
+ * accurate "Upgrade to X" CTAs without hard-coding plan names.
+ */
+export const minPlanFor = (feature) => {
+    const order = ['free', 'explorer', 'creator'];
+    for (const plan of order) {
+        const v = PLAN_LIMITS[plan][feature];
+        if (typeof v === 'boolean' ? v : v !== 0)
+            return plan;
+    }
+    return null;
+};