@lore-co/core 0.2.1 → 0.2.2

package/dist/index.d.ts

@@ -26,4 +26,5 @@ export * from "./search-schemas.js";
 export * from "./attachment-schemas.js";
 export * from "./cloud-recovery-schemas.js";
 export * from "./recovery-packet-schemas.js";
+export * from "./product-usage.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,OAAO,EACL,4BAA4B,EAC5B,KAAK,sBAAsB,GAC5B,MAAM,mBAAmB,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAE1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,OAAO,EACL,4BAA4B,EAC5B,KAAK,sBAAsB,GAC5B,MAAM,mBAAmB,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAE1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAE7C,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -26,4 +26,5 @@ export * from "./search-schemas.js";
 export * from "./attachment-schemas.js";
 export * from "./cloud-recovery-schemas.js";
 export * from "./recovery-packet-schemas.js";
+export * from "./product-usage.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,OAAO,EACL,4BAA4B,GAE7B,MAAM,mBAAmB,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAE1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,OAAO,EACL,4BAA4B,GAE7B,MAAM,mBAAmB,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAE1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAE7C,cAAc,oBAAoB,CAAC"}

package/dist/product-usage.d.ts

@@ -0,0 +1,109 @@
+import { z } from "zod";
+export declare const USAGE_COMMANDS: readonly ["connect", "ask", "remember", "share", "resume", "continue", "guard", "status", "doctor", "update", "disconnect", "uninstall", "self-host", "run", "recovery", "attach", "machines", "github", "devin", "demo"];
+export declare const DASHBOARD_FEATURES: readonly ["activity", "learnings", "learning_delivery", "sessions", "search", "recovery", "agents", "members", "settings", "setup"];
+export declare const DashboardFeatureSchema: z.ZodEnum<{
+    search: "search";
+    activity: "activity";
+    agents: "agents";
+    members: "members";
+    sessions: "sessions";
+    learnings: "learnings";
+    recovery: "recovery";
+    learning_delivery: "learning_delivery";
+    settings: "settings";
+    setup: "setup";
+}>;
+export type DashboardFeature = z.infer<typeof DashboardFeatureSchema>;
+export declare const UsageEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    eventId: z.ZodString;
+    source: z.ZodLiteral<"cli">;
+    feature: z.ZodEnum<{
+        continue: "continue";
+        status: "status";
+        guard: "guard";
+        github: "github";
+        devin: "devin";
+        machines: "machines";
+        connect: "connect";
+        ask: "ask";
+        remember: "remember";
+        share: "share";
+        resume: "resume";
+        doctor: "doctor";
+        update: "update";
+        disconnect: "disconnect";
+        uninstall: "uninstall";
+        "self-host": "self-host";
+        run: "run";
+        recovery: "recovery";
+        attach: "attach";
+        demo: "demo";
+    }>;
+    action: z.ZodEnum<{
+        failed: "failed";
+        succeeded: "succeeded";
+    }>;
+    durationMs: z.ZodNumber;
+    os: z.ZodEnum<{
+        other: "other";
+        darwin: "darwin";
+        linux: "linux";
+        win32: "win32";
+    }>;
+    version: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    eventId: z.ZodString;
+    source: z.ZodLiteral<"dashboard">;
+    feature: z.ZodEnum<{
+        search: "search";
+        activity: "activity";
+        agents: "agents";
+        members: "members";
+        sessions: "sessions";
+        learnings: "learnings";
+        recovery: "recovery";
+        learning_delivery: "learning_delivery";
+        settings: "settings";
+        setup: "setup";
+    }>;
+    action: z.ZodEnum<{
+        viewed: "viewed";
+        used: "used";
+        helpful: "helpful";
+        not_helpful: "not_helpful";
+    }>;
+}, z.core.$strict>], "source">;
+export type UsageEvent = z.infer<typeof UsageEventSchema>;
+export declare const ProductUsageQuerySchema: z.ZodObject<{
+    days: z.ZodDefault<z.ZodPipe<z.ZodCoercedNumber<unknown>, z.ZodUnion<readonly [z.ZodLiteral<7>, z.ZodLiteral<30>]>>>;
+    workspaceId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type ProductUsageQuery = z.infer<typeof ProductUsageQuerySchema>;
+export interface ProductUsageResponse {
+    from: string;
+    to: string;
+    days: 7 | 30;
+    features: {
+        source: "server" | "dashboard" | "cli";
+        feature: string;
+        events: number;
+        workspaces: number;
+        repeatWorkspaces: number;
+        failures: number;
+        averageDurationMs: number | null;
+        helpful: number;
+        notHelpful: number;
+    }[];
+    activation: {
+        created: number;
+        captured: number;
+        delivered: number;
+    };
+    clients: {
+        os: string;
+        version: string;
+        commands: number;
+        failures: number;
+    }[];
+}
+//# sourceMappingURL=product-usage.d.ts.map

package/dist/product-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-usage.d.ts","sourceRoot":"","sources":["../src/product-usage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,cAAc,2NAA4N,CAAC;AACxP,eAAO,MAAM,kBAAkB,qIAAsI,CAAC;AACtK,eAAO,MAAM,sBAAsB;;;;;;;;;;;EAA6B,CAAC;AACjE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BAgB3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,eAAO,MAAM,uBAAuB;;;kBAGzB,CAAC;AACZ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC;IACb,QAAQ,EAAE;QACR,MAAM,EAAE,QAAQ,GAAG,WAAW,GAAG,KAAK,CAAC;QACvC,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,gBAAgB,EAAE,MAAM,CAAC;QACzB,QAAQ,EAAE,MAAM,CAAC;QACjB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;QACjC,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;KACpB,EAAE,CAAC;IACJ,UAAU,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACrE,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAChF"}

package/dist/product-usage.js

@@ -0,0 +1,27 @@
+import { z } from "zod";
+// Closed catalogs: usage records must never contain arguments, paths or content.
+export const USAGE_COMMANDS = ["connect", "ask", "remember", "share", "resume", "continue", "guard", "status", "doctor", "update", "disconnect", "uninstall", "self-host", "run", "recovery", "attach", "machines", "github", "devin", "demo"];
+export const DASHBOARD_FEATURES = ["activity", "learnings", "learning_delivery", "sessions", "search", "recovery", "agents", "members", "settings", "setup"];
+export const DashboardFeatureSchema = z.enum(DASHBOARD_FEATURES);
+export const UsageEventSchema = z.discriminatedUnion("source", [
+    z.object({
+        eventId: z.string().uuid(),
+        source: z.literal("cli"),
+        feature: z.enum(USAGE_COMMANDS),
+        action: z.enum(["succeeded", "failed"]),
+        durationMs: z.number().int().min(0).max(86_400_000),
+        os: z.enum(["darwin", "linux", "win32", "other"]),
+        version: z.string().regex(/^\d{1,4}\.\d{1,4}\.\d{1,4}(?:-[a-zA-Z0-9.-]{1,32})?$/),
+    }).strict(),
+    z.object({
+        eventId: z.string().uuid(),
+        source: z.literal("dashboard"),
+        feature: DashboardFeatureSchema,
+        action: z.enum(["viewed", "used", "helpful", "not_helpful"]),
+    }).strict(),
+]);
+export const ProductUsageQuerySchema = z.object({
+    days: z.coerce.number().pipe(z.union([z.literal(7), z.literal(30)])).default(7),
+    workspaceId: z.string().uuid().optional(),
+}).strict();
+//# sourceMappingURL=product-usage.js.map

package/dist/product-usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-usage.js","sourceRoot":"","sources":["../src/product-usage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,iFAAiF;AACjF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAU,CAAC;AACxP,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,UAAU,EAAE,WAAW,EAAE,mBAAmB,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,CAAU,CAAC;AACtK,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;AAEjE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,kBAAkB,CAAC,QAAQ,EAAE;IAC7D,CAAC,CAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;QAC1B,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;QACxB,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC;QAC/B,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QACvC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC;QACnD,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACjD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,sDAAsD,CAAC;KAClF,CAAC,CAAC,MAAM,EAAE;IACX,CAAC,CAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;QAC1B,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;QAC9B,OAAO,EAAE,sBAAsB;QAC/B,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;KAC7D,CAAC,CAAC,MAAM,EAAE;CACZ,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/E,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC,MAAM,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lore-co/core",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Schemas and primitives for auditable Lore engineering memory",
   "type": "module",
   "main": "./dist/index.js",