@jamesaphoenix/tx-types 0.4.4 → 0.5.1

package/dist/learning.d.ts

@@ -46,6 +46,12 @@ export declare const LearningWithScoreSchema: Schema.Struct<{
     vectorRank: Schema.filter<typeof Schema.Number>;
     /** LLM reranker score (0-1, optional - only present when reranking is applied) */
     rerankerScore: Schema.optional<typeof Schema.Number>;
+    /** Number of hops from seed (0 = direct match from RRF, 1+ = expanded via graph) */
+    expansionHops: Schema.optional<Schema.filter<typeof Schema.Number>>;
+    /** Path of learning IDs from seed to this learning (only for expanded results) */
+    expansionPath: Schema.optional<Schema.Array$<Schema.brand<Schema.filter<typeof Schema.Number>, "LearningId">>>;
+    /** Edge type that led to this learning (null for direct matches) */
+    sourceEdge: Schema.optional<Schema.NullOr<Schema.Literal<["ANCHORED_TO", "DERIVED_FROM", "IMPORTS", "CO_CHANGES_WITH", "SIMILAR_TO", "LINKS_TO", "USED_IN_RUN", "INVALIDATED_BY"]>>>;
     /** Feedback score from historical usage (0-1, 0.5 = neutral, optional) */
     feedbackScore: Schema.optional<typeof Schema.Number>;
     id: Schema.brand<Schema.filter<typeof Schema.Number>, "LearningId">;
@@ -78,6 +84,20 @@ export declare const UpdateLearningInputSchema: Schema.Struct<{
     embedding: Schema.optional<Schema.instanceOf<Float32Array<ArrayBuffer>>>;
 }>;
 export type UpdateLearningInput = typeof UpdateLearningInputSchema.Type;
+/** Options for graph expansion during search. See PRD-016. */
+export declare const GraphExpansionQueryOptionsSchema: Schema.Struct<{
+    /** Enable graph expansion (default: false) */
+    enabled: typeof Schema.Boolean;
+    /** Maximum traversal depth (default: 2) */
+    depth: Schema.optional<Schema.filter<typeof Schema.Number>>;
+    /** Score decay factor per hop (default: 0.7) */
+    decayFactor: Schema.optional<typeof Schema.Number>;
+    /** Maximum nodes to return from expansion (default: 100) */
+    maxNodes: Schema.optional<Schema.filter<typeof Schema.Number>>;
+    /** Filter by specific edge types (default: all types) */
+    edgeTypes: Schema.optional<Schema.Array$<Schema.Literal<["ANCHORED_TO", "DERIVED_FROM", "IMPORTS", "CO_CHANGES_WITH", "SIMILAR_TO", "LINKS_TO", "USED_IN_RUN", "INVALIDATED_BY"]>>>;
+}>;
+export type GraphExpansionQueryOptions = typeof GraphExpansionQueryOptionsSchema.Type;
 /** Query options for learning searches. */
 export declare const LearningQuerySchema: Schema.Struct<{
     query: typeof Schema.String;
@@ -85,14 +105,41 @@ export declare const LearningQuerySchema: Schema.Struct<{
     minScore: Schema.optional<typeof Schema.Number>;
     category: Schema.optional<typeof Schema.String>;
     sourceType: Schema.optional<Schema.Literal<["compaction", "run", "manual", "claude_md"]>>;
+    /** Graph expansion options for traversing related learnings */
+    graphExpansion: Schema.optional<Schema.Struct<{
+        /** Enable graph expansion (default: false) */
+        enabled: typeof Schema.Boolean;
+        /** Maximum traversal depth (default: 2) */
+        depth: Schema.optional<Schema.filter<typeof Schema.Number>>;
+        /** Score decay factor per hop (default: 0.7) */
+        decayFactor: Schema.optional<typeof Schema.Number>;
+        /** Maximum nodes to return from expansion (default: 100) */
+        maxNodes: Schema.optional<Schema.filter<typeof Schema.Number>>;
+        /** Filter by specific edge types (default: all types) */
+        edgeTypes: Schema.optional<Schema.Array$<Schema.Literal<["ANCHORED_TO", "DERIVED_FROM", "IMPORTS", "CO_CHANGES_WITH", "SIMILAR_TO", "LINKS_TO", "USED_IN_RUN", "INVALIDATED_BY"]>>>;
+    }>>;
 }>;
 export type LearningQuery = typeof LearningQuerySchema.Type;
 /** Options for context retrieval. */
 export declare const ContextOptionsSchema: Schema.Struct<{
-    /** Maximum number of learnings to return (default: 10, capped at 50). Misnamed — this is a result count, not a token budget. */
+    /** Enable graph expansion (default: false) */
+    useGraph: Schema.optional<typeof Schema.Boolean>;
+    /** Graph expansion depth (default: 2 per PRD-016) */
+    expansionDepth: Schema.optional<Schema.filter<typeof Schema.Number>>;
+    /** Edge types to include in expansion */
+    edgeTypes: Schema.optional<Schema.Array$<Schema.Literal<["ANCHORED_TO", "DERIVED_FROM", "IMPORTS", "CO_CHANGES_WITH", "SIMILAR_TO", "LINKS_TO", "USED_IN_RUN", "INVALIDATED_BY"]>>>;
+    /** Maximum number of learnings to return (default: 10) */
     maxTokens: Schema.optional<Schema.filter<typeof Schema.Number>>;
 }>;
 export type ContextOptions = typeof ContextOptionsSchema.Type;
+/** Statistics about graph expansion during context retrieval. */
+export declare const GraphExpansionStatsSchema: Schema.Struct<{
+    enabled: typeof Schema.Boolean;
+    seedCount: Schema.filter<typeof Schema.Number>;
+    expandedCount: Schema.filter<typeof Schema.Number>;
+    maxDepthReached: Schema.filter<typeof Schema.Number>;
+}>;
+export type GraphExpansionStats = typeof GraphExpansionStatsSchema.Type;
 /** Result of context retrieval for a task. */
 export declare const ContextResultSchema: Schema.Struct<{
     taskId: typeof Schema.String;
@@ -110,6 +157,12 @@ export declare const ContextResultSchema: Schema.Struct<{
         vectorRank: Schema.filter<typeof Schema.Number>;
         /** LLM reranker score (0-1, optional - only present when reranking is applied) */
         rerankerScore: Schema.optional<typeof Schema.Number>;
+        /** Number of hops from seed (0 = direct match from RRF, 1+ = expanded via graph) */
+        expansionHops: Schema.optional<Schema.filter<typeof Schema.Number>>;
+        /** Path of learning IDs from seed to this learning (only for expanded results) */
+        expansionPath: Schema.optional<Schema.Array$<Schema.brand<Schema.filter<typeof Schema.Number>, "LearningId">>>;
+        /** Edge type that led to this learning (null for direct matches) */
+        sourceEdge: Schema.optional<Schema.NullOr<Schema.Literal<["ANCHORED_TO", "DERIVED_FROM", "IMPORTS", "CO_CHANGES_WITH", "SIMILAR_TO", "LINKS_TO", "USED_IN_RUN", "INVALIDATED_BY"]>>>;
         /** Feedback score from historical usage (0-1, 0.5 = neutral, optional) */
         feedbackScore: Schema.optional<typeof Schema.Number>;
         id: Schema.brand<Schema.filter<typeof Schema.Number>, "LearningId">;
@@ -126,6 +179,13 @@ export declare const ContextResultSchema: Schema.Struct<{
     }>>;
     searchQuery: typeof Schema.String;
     searchDuration: typeof Schema.Number;
+    /** Graph expansion statistics (only present when useGraph=true) */
+    graphExpansion: Schema.optional<Schema.Struct<{
+        enabled: typeof Schema.Boolean;
+        seedCount: Schema.filter<typeof Schema.Number>;
+        expandedCount: Schema.filter<typeof Schema.Number>;
+        maxDepthReached: Schema.filter<typeof Schema.Number>;
+    }>>;
 }>;
 export type ContextResult = typeof ContextResultSchema.Type;
 /** Result of a learning search operation. */
@@ -167,6 +227,19 @@ export declare const RetrievalOptionsSchema: Schema.Struct<{
     category: Schema.optional<typeof Schema.String>;
     /** Optional source type filter */
     sourceType: Schema.optional<Schema.Literal<["compaction", "run", "manual", "claude_md"]>>;
+    /** Graph expansion options for traversing related learnings */
+    graphExpansion: Schema.optional<Schema.Struct<{
+        /** Enable graph expansion (default: false) */
+        enabled: typeof Schema.Boolean;
+        /** Maximum traversal depth (default: 2) */
+        depth: Schema.optional<Schema.filter<typeof Schema.Number>>;
+        /** Score decay factor per hop (default: 0.7) */
+        decayFactor: Schema.optional<typeof Schema.Number>;
+        /** Maximum nodes to return from expansion (default: 100) */
+        maxNodes: Schema.optional<Schema.filter<typeof Schema.Number>>;
+        /** Filter by specific edge types (default: all types) */
+        edgeTypes: Schema.optional<Schema.Array$<Schema.Literal<["ANCHORED_TO", "DERIVED_FROM", "IMPORTS", "CO_CHANGES_WITH", "SIMILAR_TO", "LINKS_TO", "USED_IN_RUN", "INVALIDATED_BY"]>>>;
+    }>>;
     /** MMR diversification options for result variety */
     diversification: Schema.optional<Schema.Struct<{
         /** Enable MMR diversification (default: false) */

package/dist/learning.d.ts.map

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

package/dist/learning.js

@@ -7,6 +7,7 @@
  * Schema definitions provide both compile-time types and runtime validation.
  */
 import { Schema } from "effect";
+import { EdgeTypeSchema } from "./edge.js";
 // =============================================================================
 // CONSTANTS
 // =============================================================================
@@ -55,6 +56,12 @@ export const LearningWithScoreSchema = Schema.Struct({
     vectorRank: Schema.Number.pipe(Schema.int()),
     /** LLM reranker score (0-1, optional - only present when reranking is applied) */
     rerankerScore: Schema.optional(Schema.Number),
+    /** Number of hops from seed (0 = direct match from RRF, 1+ = expanded via graph) */
+    expansionHops: Schema.optional(Schema.Number.pipe(Schema.int())),
+    /** Path of learning IDs from seed to this learning (only for expanded results) */
+    expansionPath: Schema.optional(Schema.Array(LearningIdSchema)),
+    /** Edge type that led to this learning (null for direct matches) */
+    sourceEdge: Schema.optional(Schema.NullOr(EdgeTypeSchema)),
     /** Feedback score from historical usage (0-1, 0.5 = neutral, optional) */
     feedbackScore: Schema.optional(Schema.Number),
 });
@@ -73,6 +80,19 @@ export const UpdateLearningInputSchema = Schema.Struct({
     outcomeScore: Schema.optional(Schema.Number),
     embedding: Schema.optional(Schema.instanceOf(Float32Array)),
 });
+/** Options for graph expansion during search. See PRD-016. */
+export const GraphExpansionQueryOptionsSchema = Schema.Struct({
+    /** Enable graph expansion (default: false) */
+    enabled: Schema.Boolean,
+    /** Maximum traversal depth (default: 2) */
+    depth: Schema.optional(Schema.Number.pipe(Schema.int())),
+    /** Score decay factor per hop (default: 0.7) */
+    decayFactor: Schema.optional(Schema.Number),
+    /** Maximum nodes to return from expansion (default: 100) */
+    maxNodes: Schema.optional(Schema.Number.pipe(Schema.int())),
+    /** Filter by specific edge types (default: all types) */
+    edgeTypes: Schema.optional(Schema.Array(EdgeTypeSchema)),
+});
 /** Query options for learning searches. */
 export const LearningQuerySchema = Schema.Struct({
     query: Schema.String,
@@ -80,12 +100,27 @@ export const LearningQuerySchema = Schema.Struct({
     minScore: Schema.optional(Schema.Number),
     category: Schema.optional(Schema.String),
     sourceType: Schema.optional(LearningSourceTypeSchema),
+    /** Graph expansion options for traversing related learnings */
+    graphExpansion: Schema.optional(GraphExpansionQueryOptionsSchema),
 });
 /** Options for context retrieval. */
 export const ContextOptionsSchema = Schema.Struct({
-    /** Maximum number of learnings to return (default: 10, capped at 50). Misnamed — this is a result count, not a token budget. */
+    /** Enable graph expansion (default: false) */
+    useGraph: Schema.optional(Schema.Boolean),
+    /** Graph expansion depth (default: 2 per PRD-016) */
+    expansionDepth: Schema.optional(Schema.Number.pipe(Schema.int())),
+    /** Edge types to include in expansion */
+    edgeTypes: Schema.optional(Schema.Array(EdgeTypeSchema)),
+    /** Maximum number of learnings to return (default: 10) */
     maxTokens: Schema.optional(Schema.Number.pipe(Schema.int())),
 });
+/** Statistics about graph expansion during context retrieval. */
+export const GraphExpansionStatsSchema = Schema.Struct({
+    enabled: Schema.Boolean,
+    seedCount: Schema.Number.pipe(Schema.int()),
+    expandedCount: Schema.Number.pipe(Schema.int()),
+    maxDepthReached: Schema.Number.pipe(Schema.int()),
+});
 /** Result of context retrieval for a task. */
 export const ContextResultSchema = Schema.Struct({
     taskId: Schema.String,
@@ -93,6 +128,8 @@ export const ContextResultSchema = Schema.Struct({
     learnings: Schema.Array(LearningWithScoreSchema),
     searchQuery: Schema.String,
     searchDuration: Schema.Number,
+    /** Graph expansion statistics (only present when useGraph=true) */
+    graphExpansion: Schema.optional(GraphExpansionStatsSchema),
 });
 /** Result of a learning search operation. */
 export const LearningSearchResultSchema = Schema.Struct({
@@ -119,6 +156,8 @@ export const RetrievalOptionsSchema = Schema.Struct({
     category: Schema.optional(Schema.String),
     /** Optional source type filter */
     sourceType: Schema.optional(LearningSourceTypeSchema),
+    /** Graph expansion options for traversing related learnings */
+    graphExpansion: Schema.optional(GraphExpansionQueryOptionsSchema),
     /** MMR diversification options for result variety */
     diversification: Schema.optional(DiversificationOptionsSchema),
 });

package/dist/learning.js.map

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

package/dist/message.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Message types for tx
+ *
+ * Type definitions for agent outbox messaging (PRD-024).
+ * Core type definitions using Effect Schema (Doctrine Rule 10).
+ * Schema definitions provide both compile-time types and runtime validation.
+ */
+import { Schema } from "effect";
+/**
+ * Valid message statuses.
+ * Two-state lifecycle: pending -> acked
+ */
+export declare const MESSAGE_STATUSES: readonly ["pending", "acked"];
+/** Message status - pending or acked. */
+export declare const MessageStatusSchema: Schema.Literal<["pending", "acked"]>;
+export type MessageStatus = typeof MessageStatusSchema.Type;
+/** Message ID - branded integer. */
+export declare const MessageIdSchema: Schema.brand<Schema.filter<typeof Schema.Number>, "MessageId">;
+export type MessageId = typeof MessageIdSchema.Type;
+/** Message entity - an outbox message in a channel. */
+export declare const MessageSchema: Schema.Struct<{
+    id: Schema.brand<Schema.filter<typeof Schema.Number>, "MessageId">;
+    channel: typeof Schema.String;
+    sender: typeof Schema.String;
+    content: typeof Schema.String;
+    status: Schema.Literal<["pending", "acked"]>;
+    correlationId: Schema.NullOr<typeof Schema.String>;
+    taskId: Schema.NullOr<typeof Schema.String>;
+    metadata: Schema.Record$<typeof Schema.String, typeof Schema.Unknown>;
+    createdAt: typeof Schema.DateFromSelf;
+    ackedAt: Schema.NullOr<typeof Schema.DateFromSelf>;
+    expiresAt: Schema.NullOr<typeof Schema.DateFromSelf>;
+}>;
+export type Message = typeof MessageSchema.Type;
+/** Input for sending a new message. */
+export declare const SendMessageInputSchema: Schema.Struct<{
+    channel: typeof Schema.String;
+    sender: typeof Schema.String;
+    content: typeof Schema.String;
+    correlationId: Schema.NullOr<typeof Schema.String>;
+    taskId: Schema.NullOr<typeof Schema.String>;
+    metadata: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+    ttlSeconds: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
+}>;
+export type SendMessageInput = typeof SendMessageInputSchema.Type;
+/** Filter for reading inbox messages. */
+export declare const InboxFilterSchema: Schema.Struct<{
+    channel: typeof Schema.String;
+    afterId: Schema.optional<Schema.filter<typeof Schema.Number>>;
+    limit: Schema.optional<Schema.filter<Schema.filter<typeof Schema.Number>>>;
+    sender: Schema.optional<typeof Schema.String>;
+    correlationId: Schema.optional<typeof Schema.String>;
+    includeAcked: Schema.optional<typeof Schema.Boolean>;
+    excludeExpired: Schema.optional<typeof Schema.Boolean>;
+}>;
+export type InboxFilter = typeof InboxFilterSchema.Type;
+/** Database row type for messages (snake_case from SQLite). */
+export interface MessageRow {
+    id: number;
+    channel: string;
+    sender: string;
+    content: string;
+    status: string;
+    correlation_id: string | null;
+    task_id: string | null;
+    metadata: string;
+    created_at: string;
+    acked_at: string | null;
+    expires_at: string | null;
+}
+/** Check if a string is a valid MessageStatus. */
+export declare const isValidMessageStatus: (s: string) => s is MessageStatus;
+/** Runtime error for invalid message status from database. */
+export declare class InvalidMessageStatusError extends Error {
+    readonly status: string;
+    constructor(opts: {
+        status: string;
+        id: number;
+    });
+}
+/** Assert a string is a valid MessageStatus, throwing if not. */
+export declare const assertMessageStatus: (s: string, id: number) => MessageStatus;
+//# sourceMappingURL=message.d.ts.map

package/dist/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../src/message.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAM/B;;;GAGG;AACH,eAAO,MAAM,gBAAgB,+BAAgC,CAAA;AAM7D,yCAAyC;AACzC,eAAO,MAAM,mBAAmB,sCAAsC,CAAA;AACtE,MAAM,MAAM,aAAa,GAAG,OAAO,mBAAmB,CAAC,IAAI,CAAA;AAE3D,oCAAoC;AACpC,eAAO,MAAM,eAAe,gEAG3B,CAAA;AACD,MAAM,MAAM,SAAS,GAAG,OAAO,eAAe,CAAC,IAAI,CAAA;AAEnD,uDAAuD;AACvD,eAAO,MAAM,aAAa;;;;;;;;;;;;EAYxB,CAAA;AACF,MAAM,MAAM,OAAO,GAAG,OAAO,aAAa,CAAC,IAAI,CAAA;AAE/C,uCAAuC;AACvC,eAAO,MAAM,sBAAsB;;;;;;;;EAQjC,CAAA;AACF,MAAM,MAAM,gBAAgB,GAAG,OAAO,sBAAsB,CAAC,IAAI,CAAA;AAEjE,yCAAyC;AACzC,eAAO,MAAM,iBAAiB;;;;;;;;EAQ5B,CAAA;AACF,MAAM,MAAM,WAAW,GAAG,OAAO,iBAAiB,CAAC,IAAI,CAAA;AAMvD,+DAA+D;AAC/D,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B;AAMD,kDAAkD;AAClD,eAAO,MAAM,oBAAoB,GAAI,GAAG,MAAM,KAAG,CAAC,IAAI,aAGrD,CAAA;AAED,8DAA8D;AAC9D,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;gBACX,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE;CAKjD;AAED,iEAAiE;AACjE,eAAO,MAAM,mBAAmB,GAAI,GAAG,MAAM,EAAE,IAAI,MAAM,KAAG,aAK3D,CAAA"}

package/dist/message.js

@@ -0,0 +1,82 @@
+/**
+ * Message types for tx
+ *
+ * Type definitions for agent outbox messaging (PRD-024).
+ * Core type definitions using Effect Schema (Doctrine Rule 10).
+ * Schema definitions provide both compile-time types and runtime validation.
+ */
+import { Schema } from "effect";
+// =============================================================================
+// CONSTANTS
+// =============================================================================
+/**
+ * Valid message statuses.
+ * Two-state lifecycle: pending -> acked
+ */
+export const MESSAGE_STATUSES = ["pending", "acked"];
+// =============================================================================
+// SCHEMAS & TYPES
+// =============================================================================
+/** Message status - pending or acked. */
+export const MessageStatusSchema = Schema.Literal(...MESSAGE_STATUSES);
+/** Message ID - branded integer. */
+export const MessageIdSchema = Schema.Number.pipe(Schema.int(), Schema.brand("MessageId"));
+/** Message entity - an outbox message in a channel. */
+export const MessageSchema = Schema.Struct({
+    id: MessageIdSchema,
+    channel: Schema.String,
+    sender: Schema.String,
+    content: Schema.String,
+    status: MessageStatusSchema,
+    correlationId: Schema.NullOr(Schema.String),
+    taskId: Schema.NullOr(Schema.String),
+    metadata: Schema.Record({ key: Schema.String, value: Schema.Unknown }),
+    createdAt: Schema.DateFromSelf,
+    ackedAt: Schema.NullOr(Schema.DateFromSelf),
+    expiresAt: Schema.NullOr(Schema.DateFromSelf),
+});
+/** Input for sending a new message. */
+export const SendMessageInputSchema = Schema.Struct({
+    channel: Schema.String,
+    sender: Schema.String,
+    content: Schema.String,
+    correlationId: Schema.NullOr(Schema.String),
+    taskId: Schema.NullOr(Schema.String),
+    metadata: Schema.optional(Schema.Record({ key: Schema.String, value: Schema.Unknown })),
+    ttlSeconds: Schema.optional(Schema.Number.pipe(Schema.int(), Schema.positive())),
+});
+/** Filter for reading inbox messages. */
+export const InboxFilterSchema = Schema.Struct({
+    channel: Schema.String,
+    afterId: Schema.optional(Schema.Number.pipe(Schema.int())),
+    limit: Schema.optional(Schema.Number.pipe(Schema.int(), Schema.positive())),
+    sender: Schema.optional(Schema.String),
+    correlationId: Schema.optional(Schema.String),
+    includeAcked: Schema.optional(Schema.Boolean),
+    excludeExpired: Schema.optional(Schema.Boolean),
+});
+// =============================================================================
+// RUNTIME VALIDATORS
+// =============================================================================
+/** Check if a string is a valid MessageStatus. */
+export const isValidMessageStatus = (s) => {
+    const statuses = MESSAGE_STATUSES;
+    return statuses.includes(s);
+};
+/** Runtime error for invalid message status from database. */
+export class InvalidMessageStatusError extends Error {
+    status;
+    constructor(opts) {
+        super(`Invalid message status "${opts.status}" for message ${opts.id}`);
+        this.name = "InvalidMessageStatusError";
+        this.status = opts.status;
+    }
+}
+/** Assert a string is a valid MessageStatus, throwing if not. */
+export const assertMessageStatus = (s, id) => {
+    if (!isValidMessageStatus(s)) {
+        throw new InvalidMessageStatusError({ status: s, id });
+    }
+    return s;
+};
+//# sourceMappingURL=message.js.map

package/dist/message.js.map

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

package/dist/response.d.ts

@@ -18,6 +18,7 @@ import type { Learning, LearningWithScore } from "./learning.js";
 import type { FileLearning } from "./file-learning.js";
 import type { Run } from "./run.js";
 import type { Attempt } from "./attempt.js";
+import type { Message } from "./message.js";
 /**
  * TaskWithDeps serialized for JSON output.
  * All Date fields converted to ISO strings.
@@ -85,6 +86,12 @@ export declare const LearningWithScoreSerializedSchema: Schema.Struct<{
     vectorRank: Schema.filter<typeof Schema.Number>;
     /** LLM reranker score (0-1, optional - only present when reranking is applied) */
     rerankerScore: Schema.optional<typeof Schema.Number>;
+    /** Number of hops from seed (0 = direct match from RRF, 1+ = expanded via graph) */
+    expansionHops: Schema.optional<Schema.filter<typeof Schema.Number>>;
+    /** Path of learning IDs from seed to this learning (only for expanded results) */
+    expansionPath: Schema.optional<Schema.Array$<Schema.filter<typeof Schema.Number>>>;
+    /** Edge type that led to this learning (null for direct matches) */
+    sourceEdge: Schema.optional<Schema.NullOr<Schema.Literal<["ANCHORED_TO", "DERIVED_FROM", "IMPORTS", "CO_CHANGES_WITH", "SIMILAR_TO", "LINKS_TO", "USED_IN_RUN", "INVALIDATED_BY"]>>>;
     /** Feedback score from historical usage (0-1, 0.5 = neutral, optional) */
     feedbackScore: Schema.optional<typeof Schema.Number>;
     id: Schema.filter<typeof Schema.Number>;
@@ -471,6 +478,12 @@ export declare const LearningSearchResponseSchema: Schema.Struct<{
         vectorRank: Schema.filter<typeof Schema.Number>;
         /** LLM reranker score (0-1, optional - only present when reranking is applied) */
         rerankerScore: Schema.optional<typeof Schema.Number>;
+        /** Number of hops from seed (0 = direct match from RRF, 1+ = expanded via graph) */
+        expansionHops: Schema.optional<Schema.filter<typeof Schema.Number>>;
+        /** Path of learning IDs from seed to this learning (only for expanded results) */
+        expansionPath: Schema.optional<Schema.Array$<Schema.filter<typeof Schema.Number>>>;
+        /** Edge type that led to this learning (null for direct matches) */
+        sourceEdge: Schema.optional<Schema.NullOr<Schema.Literal<["ANCHORED_TO", "DERIVED_FROM", "IMPORTS", "CO_CHANGES_WITH", "SIMILAR_TO", "LINKS_TO", "USED_IN_RUN", "INVALIDATED_BY"]>>>;
         /** Feedback score from historical usage (0-1, 0.5 = neutral, optional) */
         feedbackScore: Schema.optional<typeof Schema.Number>;
         id: Schema.filter<typeof Schema.Number>;
@@ -510,6 +523,12 @@ export declare const ContextResponseSchema: Schema.Struct<{
         vectorRank: Schema.filter<typeof Schema.Number>;
         /** LLM reranker score (0-1, optional - only present when reranking is applied) */
         rerankerScore: Schema.optional<typeof Schema.Number>;
+        /** Number of hops from seed (0 = direct match from RRF, 1+ = expanded via graph) */
+        expansionHops: Schema.optional<Schema.filter<typeof Schema.Number>>;
+        /** Path of learning IDs from seed to this learning (only for expanded results) */
+        expansionPath: Schema.optional<Schema.Array$<Schema.filter<typeof Schema.Number>>>;
+        /** Edge type that led to this learning (null for direct matches) */
+        sourceEdge: Schema.optional<Schema.NullOr<Schema.Literal<["ANCHORED_TO", "DERIVED_FROM", "IMPORTS", "CO_CHANGES_WITH", "SIMILAR_TO", "LINKS_TO", "USED_IN_RUN", "INVALIDATED_BY"]>>>;
         /** Feedback score from historical usage (0-1, 0.5 = neutral, optional) */
         feedbackScore: Schema.optional<typeof Schema.Number>;
         id: Schema.filter<typeof Schema.Number>;
@@ -527,6 +546,13 @@ export declare const ContextResponseSchema: Schema.Struct<{
     searchQuery: typeof Schema.String;
     /** Search duration in milliseconds */
     searchDuration: typeof Schema.Number;
+    /** Graph expansion statistics (only present when useGraph=true) */
+    graphExpansion: Schema.optional<Schema.Struct<{
+        enabled: typeof Schema.Boolean;
+        seedCount: Schema.filter<typeof Schema.Number>;
+        expandedCount: Schema.filter<typeof Schema.Number>;
+        maxDepthReached: Schema.filter<typeof Schema.Number>;
+    }>>;
 }>;
 export type ContextResponse = typeof ContextResponseSchema.Type;
 /** Response for file learnings. */
@@ -633,4 +659,46 @@ export declare const SyncImportResponseSchema: Schema.Struct<{
     conflicts: Schema.filter<typeof Schema.Number>;
 }>;
 export type SyncImportResponse = typeof SyncImportResponseSchema.Type;
+/**
+ * Message serialized for JSON output.
+ * All Date fields converted to ISO strings.
+ */
+export declare const MessageSerializedSchema: Schema.Struct<{
+    id: Schema.brand<Schema.filter<typeof Schema.Number>, "MessageId">;
+    channel: typeof Schema.String;
+    sender: typeof Schema.String;
+    content: typeof Schema.String;
+    status: Schema.Literal<["pending", "acked"]>;
+    correlationId: Schema.NullOr<typeof Schema.String>;
+    taskId: Schema.NullOr<typeof Schema.String>;
+    metadata: Schema.Record$<typeof Schema.String, typeof Schema.Unknown>;
+    createdAt: typeof Schema.String;
+    ackedAt: Schema.NullOr<typeof Schema.String>;
+    expiresAt: Schema.NullOr<typeof Schema.String>;
+}>;
+export type MessageSerialized = typeof MessageSerializedSchema.Type;
+/**
+ * Serialize a Message for JSON output.
+ * Converts Date objects to ISO strings.
+ */
+export declare const serializeMessage: (message: Message) => MessageSerialized;
+/** Response for reading inbox messages. */
+export declare const InboxResponseSchema: Schema.Struct<{
+    messages: Schema.Array$<Schema.Struct<{
+        id: Schema.brand<Schema.filter<typeof Schema.Number>, "MessageId">;
+        channel: typeof Schema.String;
+        sender: typeof Schema.String;
+        content: typeof Schema.String;
+        status: Schema.Literal<["pending", "acked"]>;
+        correlationId: Schema.NullOr<typeof Schema.String>;
+        taskId: Schema.NullOr<typeof Schema.String>;
+        metadata: Schema.Record$<typeof Schema.String, typeof Schema.Unknown>;
+        createdAt: typeof Schema.String;
+        ackedAt: Schema.NullOr<typeof Schema.String>;
+        expiresAt: Schema.NullOr<typeof Schema.String>;
+    }>>;
+    channel: typeof Schema.String;
+    count: Schema.filter<typeof Schema.Number>;
+}>;
+export type InboxResponse = typeof InboxResponseSchema.Type;
 //# sourceMappingURL=response.d.ts.map

package/dist/response.d.ts.map

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