@lore-co/core 0.1.12 → 0.1.14

package/dist/session-schemas.d.ts

@@ -0,0 +1,406 @@
+import { z } from "zod";
+import { ConnectorEventTypeSchema } from "./pilot-schemas.js";
+export declare const WorkSessionSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    workspaceId: z.ZodUUID;
+    connector: z.ZodString;
+    externalSessionId: z.ZodString;
+    agent: z.ZodString;
+    project: z.ZodNullable<z.ZodString>;
+    repo: z.ZodNullable<z.ZodString>;
+    title: z.ZodNullable<z.ZodString>;
+    parentSessionId: z.ZodNullable<z.ZodUUID>;
+    startedAt: z.ZodISODateTime;
+    lastActivityAt: z.ZodISODateTime;
+    endedAt: z.ZodNullable<z.ZodISODateTime>;
+    eventCount: z.ZodNumber;
+    metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strict>;
+export type WorkSession = z.infer<typeof WorkSessionSchema>;
+export declare const ListWorkSessionsQuerySchema: z.ZodObject<{
+    repo: z.ZodOptional<z.ZodString>;
+    project: z.ZodOptional<z.ZodString>;
+    agent: z.ZodOptional<z.ZodString>;
+    connector: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    offset: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strict>;
+export type ListWorkSessionsQuery = z.infer<typeof ListWorkSessionsQuerySchema>;
+export declare const ListWorkSessionsResponseSchema: z.ZodObject<{
+    sessions: z.ZodArray<z.ZodObject<{
+        id: z.ZodUUID;
+        workspaceId: z.ZodUUID;
+        connector: z.ZodString;
+        externalSessionId: z.ZodString;
+        agent: z.ZodString;
+        project: z.ZodNullable<z.ZodString>;
+        repo: z.ZodNullable<z.ZodString>;
+        title: z.ZodNullable<z.ZodString>;
+        parentSessionId: z.ZodNullable<z.ZodUUID>;
+        startedAt: z.ZodISODateTime;
+        lastActivityAt: z.ZodISODateTime;
+        endedAt: z.ZodNullable<z.ZodISODateTime>;
+        eventCount: z.ZodNumber;
+        metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strict>>;
+    total: z.ZodNumber;
+    limit: z.ZodNumber;
+    offset: z.ZodNumber;
+}, z.core.$strict>;
+export type ListWorkSessionsResponse = z.infer<typeof ListWorkSessionsResponseSchema>;
+export declare const SessionEventDigestSchema: z.ZodObject<{
+    eventId: z.ZodUUID;
+    type: z.ZodEnum<{
+        observation: "observation";
+        paired_turn: "paired_turn";
+        context_delivery: "context_delivery";
+    }>;
+    occurredAt: z.ZodISODateTime;
+    task: z.ZodNullable<z.ZodString>;
+    userText: z.ZodNullable<z.ZodString>;
+    assistantText: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export type SessionEventDigest = z.infer<typeof SessionEventDigestSchema>;
+export declare const SessionMemorySummarySchema: z.ZodObject<{
+    id: z.ZodUUID;
+    content: z.ZodString;
+    category: z.ZodEnum<{
+        architecture: "architecture";
+        convention: "convention";
+        correction: "correction";
+        gotcha: "gotcha";
+        known_gotcha: "known_gotcha";
+        deprecated: "deprecated";
+        behavior: "behavior";
+        review_feedback: "review_feedback";
+        other: "other";
+    }>;
+    status: z.ZodEnum<{
+        active: "active";
+        proposed: "proposed";
+        suppressed: "suppressed";
+        superseded: "superseded";
+        deleted: "deleted";
+    }>;
+}, z.core.$strict>;
+export type SessionMemorySummary = z.infer<typeof SessionMemorySummarySchema>;
+export declare const WorkSessionDetailResponseSchema: z.ZodObject<{
+    session: z.ZodObject<{
+        id: z.ZodUUID;
+        workspaceId: z.ZodUUID;
+        connector: z.ZodString;
+        externalSessionId: z.ZodString;
+        agent: z.ZodString;
+        project: z.ZodNullable<z.ZodString>;
+        repo: z.ZodNullable<z.ZodString>;
+        title: z.ZodNullable<z.ZodString>;
+        parentSessionId: z.ZodNullable<z.ZodUUID>;
+        startedAt: z.ZodISODateTime;
+        lastActivityAt: z.ZodISODateTime;
+        endedAt: z.ZodNullable<z.ZodISODateTime>;
+        eventCount: z.ZodNumber;
+        metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strict>;
+    events: z.ZodArray<z.ZodObject<{
+        eventId: z.ZodUUID;
+        type: z.ZodEnum<{
+            observation: "observation";
+            paired_turn: "paired_turn";
+            context_delivery: "context_delivery";
+        }>;
+        occurredAt: z.ZodISODateTime;
+        task: z.ZodNullable<z.ZodString>;
+        userText: z.ZodNullable<z.ZodString>;
+        assistantText: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+    learnings: z.ZodArray<z.ZodObject<{
+        id: z.ZodUUID;
+        content: z.ZodString;
+        category: z.ZodEnum<{
+            architecture: "architecture";
+            convention: "convention";
+            correction: "correction";
+            gotcha: "gotcha";
+            known_gotcha: "known_gotcha";
+            deprecated: "deprecated";
+            behavior: "behavior";
+            review_feedback: "review_feedback";
+            other: "other";
+        }>;
+        status: z.ZodEnum<{
+            active: "active";
+            proposed: "proposed";
+            suppressed: "suppressed";
+            superseded: "superseded";
+            deleted: "deleted";
+        }>;
+    }, z.core.$strict>>;
+    deliveredMemories: z.ZodArray<z.ZodObject<{
+        id: z.ZodUUID;
+        content: z.ZodString;
+        category: z.ZodEnum<{
+            architecture: "architecture";
+            convention: "convention";
+            correction: "correction";
+            gotcha: "gotcha";
+            known_gotcha: "known_gotcha";
+            deprecated: "deprecated";
+            behavior: "behavior";
+            review_feedback: "review_feedback";
+            other: "other";
+        }>;
+        status: z.ZodEnum<{
+            active: "active";
+            proposed: "proposed";
+            suppressed: "suppressed";
+            superseded: "superseded";
+            deleted: "deleted";
+        }>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type WorkSessionDetailResponse = z.infer<typeof WorkSessionDetailResponseSchema>;
+export declare const AskRequestSchema: z.ZodObject<{
+    question: z.ZodString;
+    agent: z.ZodOptional<z.ZodString>;
+    project: z.ZodOptional<z.ZodString>;
+    repo: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    includeSessions: z.ZodOptional<z.ZodBoolean>;
+    sessionLimit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export type AskRequest = z.infer<typeof AskRequestSchema>;
+export declare const AskSessionExcerptSchema: z.ZodObject<{
+    eventId: z.ZodUUID;
+    type: z.ZodEnum<{
+        observation: "observation";
+        paired_turn: "paired_turn";
+        context_delivery: "context_delivery";
+    }>;
+    occurredAt: z.ZodISODateTime;
+    text: z.ZodString;
+}, z.core.$strict>;
+export type AskSessionExcerpt = z.infer<typeof AskSessionExcerptSchema>;
+export declare const AskSessionMatchSchema: z.ZodObject<{
+    session: z.ZodObject<{
+        id: z.ZodUUID;
+        workspaceId: z.ZodUUID;
+        connector: z.ZodString;
+        externalSessionId: z.ZodString;
+        agent: z.ZodString;
+        project: z.ZodNullable<z.ZodString>;
+        repo: z.ZodNullable<z.ZodString>;
+        title: z.ZodNullable<z.ZodString>;
+        parentSessionId: z.ZodNullable<z.ZodUUID>;
+        startedAt: z.ZodISODateTime;
+        lastActivityAt: z.ZodISODateTime;
+        endedAt: z.ZodNullable<z.ZodISODateTime>;
+        eventCount: z.ZodNumber;
+        metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strict>;
+    excerpts: z.ZodArray<z.ZodObject<{
+        eventId: z.ZodUUID;
+        type: z.ZodEnum<{
+            observation: "observation";
+            paired_turn: "paired_turn";
+            context_delivery: "context_delivery";
+        }>;
+        occurredAt: z.ZodISODateTime;
+        text: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type AskSessionMatch = z.infer<typeof AskSessionMatchSchema>;
+export declare const AskResponseSchema: z.ZodObject<{
+    question: z.ZodString;
+    knowledge: z.ZodArray<z.ZodObject<{
+        memory: z.ZodObject<{
+            id: z.ZodUUID;
+            workspaceId: z.ZodOptional<z.ZodUUID>;
+            content: z.ZodString;
+            scope: z.ZodObject<{
+                organization: z.ZodOptional<z.ZodString>;
+                project: z.ZodOptional<z.ZodString>;
+                repo: z.ZodOptional<z.ZodString>;
+                path: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+                component: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>;
+            category: z.ZodEnum<{
+                architecture: "architecture";
+                convention: "convention";
+                correction: "correction";
+                gotcha: "gotcha";
+                known_gotcha: "known_gotcha";
+                deprecated: "deprecated";
+                behavior: "behavior";
+                review_feedback: "review_feedback";
+                other: "other";
+            }>;
+            status: z.ZodEnum<{
+                active: "active";
+                proposed: "proposed";
+                suppressed: "suppressed";
+                superseded: "superseded";
+                deleted: "deleted";
+            }>;
+            source: z.ZodObject<{
+                agent: z.ZodString;
+                sessionId: z.ZodOptional<z.ZodString>;
+                messageId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                rawText: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                workspaceId: z.ZodOptional<z.ZodUUID>;
+                eventId: z.ZodOptional<z.ZodUUID>;
+                userId: z.ZodOptional<z.ZodUUID>;
+                redacted: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>;
+            confidence: z.ZodOptional<z.ZodNumber>;
+            confirmation: z.ZodOptional<z.ZodEnum<{
+                unconfirmed: "unconfirmed";
+                implicit: "implicit";
+                explicit: "explicit";
+            }>>;
+            reconciliationKey: z.ZodOptional<z.ZodString>;
+            fingerprint: z.ZodString;
+            supersedesMemoryId: z.ZodNullable<z.ZodUUID>;
+            createdAt: z.ZodISODateTime;
+            updatedAt: z.ZodISODateTime;
+            suppressedAt: z.ZodDefault<z.ZodNullable<z.ZodISODateTime>>;
+            deletedAt: z.ZodNullable<z.ZodISODateTime>;
+        }, z.core.$strict>;
+        score: z.ZodNumber;
+        reasons: z.ZodArray<z.ZodEnum<{
+            symbol: "symbol";
+            path: "path";
+            lexical: "lexical";
+            semantic: "semantic";
+            component: "component";
+            repository: "repository";
+        }>>;
+        matchedTerms: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        lexicalRank: z.ZodNullable<z.ZodNumber>;
+        semanticRank: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strict>>;
+    memories: z.ZodArray<z.ZodObject<{
+        id: z.ZodUUID;
+        workspaceId: z.ZodOptional<z.ZodUUID>;
+        content: z.ZodString;
+        scope: z.ZodObject<{
+            organization: z.ZodOptional<z.ZodString>;
+            project: z.ZodOptional<z.ZodString>;
+            repo: z.ZodOptional<z.ZodString>;
+            path: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+            component: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        category: z.ZodEnum<{
+            architecture: "architecture";
+            convention: "convention";
+            correction: "correction";
+            gotcha: "gotcha";
+            known_gotcha: "known_gotcha";
+            deprecated: "deprecated";
+            behavior: "behavior";
+            review_feedback: "review_feedback";
+            other: "other";
+        }>;
+        status: z.ZodEnum<{
+            active: "active";
+            proposed: "proposed";
+            suppressed: "suppressed";
+            superseded: "superseded";
+            deleted: "deleted";
+        }>;
+        source: z.ZodObject<{
+            agent: z.ZodString;
+            sessionId: z.ZodOptional<z.ZodString>;
+            messageId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            rawText: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            workspaceId: z.ZodOptional<z.ZodUUID>;
+            eventId: z.ZodOptional<z.ZodUUID>;
+            userId: z.ZodOptional<z.ZodUUID>;
+            redacted: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>;
+        confidence: z.ZodOptional<z.ZodNumber>;
+        confirmation: z.ZodOptional<z.ZodEnum<{
+            unconfirmed: "unconfirmed";
+            implicit: "implicit";
+            explicit: "explicit";
+        }>>;
+        reconciliationKey: z.ZodOptional<z.ZodString>;
+        fingerprint: z.ZodString;
+        supersedesMemoryId: z.ZodNullable<z.ZodUUID>;
+        createdAt: z.ZodISODateTime;
+        updatedAt: z.ZodISODateTime;
+        suppressedAt: z.ZodDefault<z.ZodNullable<z.ZodISODateTime>>;
+        deletedAt: z.ZodNullable<z.ZodISODateTime>;
+    }, z.core.$strict>>;
+    sessions: z.ZodArray<z.ZodObject<{
+        session: z.ZodObject<{
+            id: z.ZodUUID;
+            workspaceId: z.ZodUUID;
+            connector: z.ZodString;
+            externalSessionId: z.ZodString;
+            agent: z.ZodString;
+            project: z.ZodNullable<z.ZodString>;
+            repo: z.ZodNullable<z.ZodString>;
+            title: z.ZodNullable<z.ZodString>;
+            parentSessionId: z.ZodNullable<z.ZodUUID>;
+            startedAt: z.ZodISODateTime;
+            lastActivityAt: z.ZodISODateTime;
+            endedAt: z.ZodNullable<z.ZodISODateTime>;
+            eventCount: z.ZodNumber;
+            metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strict>;
+        excerpts: z.ZodArray<z.ZodObject<{
+            eventId: z.ZodUUID;
+            type: z.ZodEnum<{
+                observation: "observation";
+                paired_turn: "paired_turn";
+                context_delivery: "context_delivery";
+            }>;
+            occurredAt: z.ZodISODateTime;
+            text: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    context: z.ZodString;
+    packing: z.ZodOptional<z.ZodObject<{
+        policyVersion: z.ZodLiteral<"context-pack-v1">;
+        estimator: z.ZodLiteral<"utf8-bytes-div-3-v1">;
+        limits: z.ZodObject<{
+            requestedItems: z.ZodNullable<z.ZodNumber>;
+            effectiveItems: z.ZodNumber;
+            maxCharacters: z.ZodNumber;
+            maxEstimatedTokens: z.ZodNumber;
+        }, z.core.$strict>;
+        usage: z.ZodObject<{
+            retrievedItems: z.ZodNumber;
+            includedItems: z.ZodNumber;
+            omittedItems: z.ZodNumber;
+            characters: z.ZodNumber;
+            utf8Bytes: z.ZodNumber;
+            estimatedTokens: z.ZodNumber;
+        }, z.core.$strict>;
+        includedMemoryIds: z.ZodArray<z.ZodUUID>;
+        omitted: z.ZodArray<z.ZodObject<{
+            memoryId: z.ZodUUID;
+            reason: z.ZodEnum<{
+                characters: "characters";
+                items: "items";
+                estimated_tokens: "estimated_tokens";
+            }>;
+        }, z.core.$strict>>;
+        contextSha256: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type AskResponse = z.infer<typeof AskResponseSchema>;
+export interface SessionEventLike {
+    id: string;
+    type: z.infer<typeof ConnectorEventTypeSchema>;
+    payload: Record<string, unknown>;
+    occurredAt: string;
+}
+/**
+ * Extracts the human-meaningful text from a connector event payload without
+ * assuming a single payload shape. Observations store the raw request,
+ * paired turns store the turn request, and context deliveries store a
+ * request/response envelope.
+ */
+export declare function digestSessionEvent(event: SessionEventLike): SessionEventDigest;
+//# sourceMappingURL=session-schemas.d.ts.map

package/dist/session-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-schemas.d.ts","sourceRoot":"","sources":["../src/session-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,wBAAwB,EAEzB,MAAM,oBAAoB,CAAC;AAS5B,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;kBAiBnB,CAAC;AACZ,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,2BAA2B;;;;;;;kBAS7B,CAAC;AACZ,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CACzC,OAAO,2BAA2B,CACnC,CAAC;AAEF,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;kBAOhC,CAAC;AACZ,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAC5C,OAAO,8BAA8B,CACtC,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;;kBAS1B,CAAC;AACZ,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;kBAO5B,CAAC;AACZ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAOjC,CAAC;AACZ,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAC7C,OAAO,+BAA+B,CACvC,CAAC;AAEF,eAAO,MAAM,gBAAgB;;;;;;;;kBAUlB,CAAC;AACZ,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,uBAAuB;;;;;;;;;kBAOzB,CAAC;AACZ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAKvB,CAAC;AACZ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBASnB,CAAC;AACZ,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAuB5D,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,gBAAgB,GACtB,kBAAkB,CA2CpB"}

package/dist/session-schemas.js

@@ -0,0 +1,162 @@
+import { z } from "zod";
+import { ConnectorEventTypeSchema, ConnectorNameSchema, } from "./pilot-schemas.js";
+import { ContextPackingSchema, MemoryCategorySchema, MemorySchema, MemoryStatusSchema, RetrievalHitSchema, } from "./schemas.js";
+export const WorkSessionSchema = z
+    .object({
+    id: z.uuid(),
+    workspaceId: z.uuid(),
+    connector: z.string().trim().min(1).max(100),
+    externalSessionId: z.string().trim().min(1).max(500),
+    agent: z.string().trim().min(1).max(100),
+    project: z.string().nullable(),
+    repo: z.string().nullable(),
+    title: z.string().nullable(),
+    parentSessionId: z.uuid().nullable(),
+    startedAt: z.iso.datetime({ offset: true }),
+    lastActivityAt: z.iso.datetime({ offset: true }),
+    endedAt: z.iso.datetime({ offset: true }).nullable(),
+    eventCount: z.number().int().nonnegative(),
+    metadata: z.record(z.string(), z.unknown()),
+})
+    .strict();
+export const ListWorkSessionsQuerySchema = z
+    .object({
+    repo: z.string().trim().min(1).max(1_000).optional(),
+    project: z.string().trim().min(1).max(500).optional(),
+    agent: z.string().trim().min(1).max(100).optional(),
+    connector: ConnectorNameSchema.optional(),
+    limit: z.coerce.number().int().positive().max(100).optional(),
+    offset: z.coerce.number().int().nonnegative().optional(),
+})
+    .strict();
+export const ListWorkSessionsResponseSchema = z
+    .object({
+    sessions: z.array(WorkSessionSchema),
+    total: z.number().int().nonnegative(),
+    limit: z.number().int().positive(),
+    offset: z.number().int().nonnegative(),
+})
+    .strict();
+export const SessionEventDigestSchema = z
+    .object({
+    eventId: z.uuid(),
+    type: ConnectorEventTypeSchema,
+    occurredAt: z.iso.datetime({ offset: true }),
+    task: z.string().nullable(),
+    userText: z.string().nullable(),
+    assistantText: z.string().nullable(),
+})
+    .strict();
+export const SessionMemorySummarySchema = z
+    .object({
+    id: z.uuid(),
+    content: z.string(),
+    category: MemoryCategorySchema,
+    status: MemoryStatusSchema,
+})
+    .strict();
+export const WorkSessionDetailResponseSchema = z
+    .object({
+    session: WorkSessionSchema,
+    events: z.array(SessionEventDigestSchema),
+    learnings: z.array(SessionMemorySummarySchema),
+    deliveredMemories: z.array(SessionMemorySummarySchema),
+})
+    .strict();
+export const AskRequestSchema = z
+    .object({
+    question: z.string().trim().min(1).max(10_000),
+    agent: z.string().trim().min(1).max(100).optional(),
+    project: z.string().trim().min(1).max(500).optional(),
+    repo: z.string().trim().min(1).max(1_000).optional(),
+    limit: z.number().int().positive().max(20).optional(),
+    includeSessions: z.boolean().optional(),
+    sessionLimit: z.number().int().positive().max(10).optional(),
+})
+    .strict();
+export const AskSessionExcerptSchema = z
+    .object({
+    eventId: z.uuid(),
+    type: ConnectorEventTypeSchema,
+    occurredAt: z.iso.datetime({ offset: true }),
+    text: z.string().max(2_000),
+})
+    .strict();
+export const AskSessionMatchSchema = z
+    .object({
+    session: WorkSessionSchema,
+    excerpts: z.array(AskSessionExcerptSchema),
+})
+    .strict();
+export const AskResponseSchema = z
+    .object({
+    question: z.string(),
+    knowledge: z.array(RetrievalHitSchema),
+    memories: z.array(MemorySchema),
+    sessions: z.array(AskSessionMatchSchema),
+    context: z.string(),
+    packing: ContextPackingSchema.optional(),
+})
+    .strict();
+const TEXT_FIELD_LIMIT = 2_000;
+function truncate(value) {
+    return value.length > TEXT_FIELD_LIMIT
+        ? `${value.slice(0, TEXT_FIELD_LIMIT - 1)}…`
+        : value;
+}
+function stringAt(value, path) {
+    let current = value;
+    for (const key of path) {
+        if (typeof current !== "object" || current === null) {
+            return null;
+        }
+        current = current[key];
+    }
+    return typeof current === "string" && current.trim().length > 0
+        ? truncate(current)
+        : null;
+}
+/**
+ * Extracts the human-meaningful text from a connector event payload without
+ * assuming a single payload shape. Observations store the raw request,
+ * paired turns store the turn request, and context deliveries store a
+ * request/response envelope.
+ */
+export function digestSessionEvent(event) {
+    const payload = event.payload;
+    const task = stringAt(payload, ["task"]) ??
+        stringAt(payload, ["request", "task"]) ??
+        stringAt(payload, ["request", "task", "task"]);
+    let userText = stringAt(payload, ["currentUser", "content"]) ??
+        stringAt(payload, ["currentUserPrompt"]) ??
+        stringAt(payload, ["request", "currentUser", "content"]) ??
+        stringAt(payload, ["request", "currentUserPrompt"]);
+    const assistantText = stringAt(payload, ["previousAssistant", "content"]) ??
+        stringAt(payload, ["request", "previousAssistant", "content"]);
+    if (userText === null) {
+        const request = payload.request;
+        const messages = Array.isArray(payload.messages)
+            ? payload.messages
+            : typeof request === "object" &&
+                request !== null &&
+                Array.isArray(request.messages)
+                ? request.messages
+                : [];
+        const lastUser = [...messages]
+            .reverse()
+            .find((message) => typeof message === "object" &&
+            message !== null &&
+            message.role === "user" &&
+            typeof message.content === "string");
+        userText = lastUser === undefined ? null : truncate(lastUser.content);
+    }
+    return SessionEventDigestSchema.parse({
+        eventId: event.id,
+        type: event.type,
+        occurredAt: event.occurredAt,
+        task,
+        userText,
+        assistantText,
+    });
+}
+//# sourceMappingURL=session-schemas.js.map

package/dist/session-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-schemas.js","sourceRoot":"","sources":["../src/session-schemas.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lore-co/core",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "description": "Schemas and primitives for auditable Lore engineering memory",
   "type": "module",
   "main": "./dist/index.js",
@@ -22,6 +22,10 @@
       "types": "./dist/auth-schemas.d.ts",
       "import": "./dist/auth-schemas.js"
     },
+    "./session-schemas": {
+      "types": "./dist/session-schemas.d.ts",
+      "import": "./dist/session-schemas.js"
+    },
     "./redaction": {
       "types": "./dist/redaction.d.ts",
       "import": "./dist/redaction.js"