@eddacraft/kindling-core 0.1.0

package/dist/types/common.js

@@ -0,0 +1,16 @@
+/**
+ * Common types used across Kindling packages
+ */
+/**
+ * Helper to create a success result
+ */
+export function ok(value) {
+    return { ok: true, value };
+}
+/**
+ * Helper to create an error result
+ */
+export function err(error) {
+    return { ok: false, error };
+}
+//# sourceMappingURL=common.js.map

package/dist/types/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/types/common.ts"],"names":[],"mappings":"AAAA;;GAEG;AA+CH;;GAEG;AACH,MAAM,UAAU,EAAE,CAAI,KAAQ;IAC5B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,GAAG,CAAI,KAAQ;IAC7B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC9B,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Kindling Core Types
+ *
+ * Re-exports all domain types for convenient importing
+ */
+export type { ID, Timestamp, ScopeIds, Result, ValidationError, } from './common.js';
+export { ok, err, } from './common.js';
+export type { ObservationKind, Observation, ObservationInput, } from './observation.js';
+export { OBSERVATION_KINDS, isObservationKind, } from './observation.js';
+export type { CapsuleType, CapsuleStatus, Capsule, CapsuleInput, } from './capsule.js';
+export { CAPSULE_TYPES, CAPSULE_STATUSES, isCapsuleType, isCapsuleStatus, } from './capsule.js';
+export type { Summary, SummaryInput, } from './summary.js';
+export { isValidConfidence, } from './summary.js';
+export type { PinTargetType, Pin, PinInput, } from './pin.js';
+export { PIN_TARGET_TYPES, isPinTargetType, isPinActive, } from './pin.js';
+export type { RetrieveOptions, PinResult, CandidateResult, RetrieveProvenance, RetrieveResult, ProviderSearchOptions, ProviderSearchResult, RetrievalProvider, } from './retrieval.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EACV,EAAE,EACF,SAAS,EACT,QAAQ,EACR,MAAM,EACN,eAAe,GAChB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,EAAE,EACF,GAAG,GACJ,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,eAAe,EACf,WAAW,EACX,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,WAAW,EACX,aAAa,EACb,OAAO,EACP,YAAY,GACb,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,eAAe,GAChB,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,OAAO,EACP,YAAY,GACb,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,aAAa,EACb,GAAG,EACH,QAAQ,GACT,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,WAAW,GACZ,MAAM,UAAU,CAAC;AAGlB,YAAY,EACV,eAAe,EACf,SAAS,EACT,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,11 @@
+/**
+ * Kindling Core Types
+ *
+ * Re-exports all domain types for convenient importing
+ */
+export { ok, err, } from './common.js';
+export { OBSERVATION_KINDS, isObservationKind, } from './observation.js';
+export { CAPSULE_TYPES, CAPSULE_STATUSES, isCapsuleType, isCapsuleStatus, } from './capsule.js';
+export { isValidConfidence, } from './summary.js';
+export { PIN_TARGET_TYPES, isPinTargetType, isPinActive, } from './pin.js';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH,OAAO,EACL,EAAE,EACF,GAAG,GACJ,MAAM,aAAa,CAAC;AASrB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAU1B,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,eAAe,GAChB,MAAM,cAAc,CAAC;AAQtB,OAAO,EACL,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAStB,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,WAAW,GACZ,MAAM,UAAU,CAAC"}

package/dist/types/observation.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Observation types and definitions
+ *
+ * An Observation is an atomic, immutable record of an event that occurred
+ * during development (tool call, command, diff, error, message, etc.)
+ */
+import type { ID, Timestamp, ScopeIds } from './common.js';
+/**
+ * Types of observations that can be captured
+ */
+export type ObservationKind = 'tool_call' | 'command' | 'file_diff' | 'error' | 'message' | 'node_start' | 'node_end' | 'node_output' | 'node_error';
+/**
+ * Observation entity
+ *
+ * Immutable except for the `redacted` flag (via explicit redaction API)
+ */
+export interface Observation {
+    /** Unique identifier (UUIDv4) */
+    id: ID;
+    /** Type of observation */
+    kind: ObservationKind;
+    /** The actual content (text, JSON, etc.) */
+    content: string;
+    /**
+     * Source-specific metadata (e.g., toolName, exitCode, nodeId)
+     * Stored as JSON blob in persistence layer
+     */
+    provenance: Record<string, unknown>;
+    /** Timestamp when observation was created (epoch milliseconds) */
+    ts: Timestamp;
+    /** Isolation dimensions for scoped queries */
+    scopeIds: ScopeIds;
+    /**
+     * Privacy flag
+     * If true, content is '[redacted]' and observation is excluded from FTS
+     */
+    redacted: boolean;
+}
+/**
+ * Input for creating a new observation
+ * Makes id, ts, and redacted optional (will be auto-generated)
+ */
+export interface ObservationInput {
+    id?: ID;
+    kind: ObservationKind;
+    content: string;
+    provenance?: Record<string, unknown>;
+    ts?: Timestamp;
+    scopeIds: ScopeIds;
+    redacted?: boolean;
+}
+/**
+ * All valid observation kinds
+ */
+export declare const OBSERVATION_KINDS: readonly ObservationKind[];
+/**
+ * Type guard to check if a string is a valid ObservationKind
+ */
+export declare function isObservationKind(value: unknown): value is ObservationKind;
+//# sourceMappingURL=observation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"observation.d.ts","sourceRoot":"","sources":["../../src/types/observation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,WAAW,GACX,SAAS,GACT,WAAW,GACX,OAAO,GACP,SAAS,GACT,YAAY,GACZ,UAAU,GACV,aAAa,GACb,YAAY,CAAC;AAEjB;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,iCAAiC;IACjC,EAAE,EAAE,EAAE,CAAC;IAEP,0BAA0B;IAC1B,IAAI,EAAE,eAAe,CAAC;IAEtB,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEpC,kEAAkE;IAClE,EAAE,EAAE,SAAS,CAAC;IAEd,8CAA8C;IAC9C,QAAQ,EAAE,QAAQ,CAAC;IAEnB;;;OAGG;IACH,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,CAAC,EAAE,EAAE,CAAC;IACR,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,EAAE,CAAC,EAAE,SAAS,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,eAAe,EAU9C,CAAC;AAEX;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAE1E"}

package/dist/types/observation.js

@@ -0,0 +1,27 @@
+/**
+ * Observation types and definitions
+ *
+ * An Observation is an atomic, immutable record of an event that occurred
+ * during development (tool call, command, diff, error, message, etc.)
+ */
+/**
+ * All valid observation kinds
+ */
+export const OBSERVATION_KINDS = [
+    'tool_call',
+    'command',
+    'file_diff',
+    'error',
+    'message',
+    'node_start',
+    'node_end',
+    'node_output',
+    'node_error',
+];
+/**
+ * Type guard to check if a string is a valid ObservationKind
+ */
+export function isObservationKind(value) {
+    return typeof value === 'string' && OBSERVATION_KINDS.includes(value);
+}
+//# sourceMappingURL=observation.js.map

package/dist/types/observation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation.js","sourceRoot":"","sources":["../../src/types/observation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkEH;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAA+B;IAC3D,WAAW;IACX,SAAS;IACT,WAAW;IACX,OAAO;IACP,SAAS;IACT,YAAY;IACZ,UAAU;IACV,aAAa;IACb,YAAY;CACJ,CAAC;AAEX;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,iBAAiB,CAAC,QAAQ,CAAC,KAAwB,CAAC,CAAC;AAC3F,CAAC"}

package/dist/types/pin.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Pin types and definitions
+ *
+ * A Pin marks an observation or summary as important
+ * (user-curated for retrieval prioritization)
+ */
+import type { ID, Timestamp, ScopeIds } from './common.js';
+/**
+ * Type of entity that can be pinned
+ */
+export type PinTargetType = 'observation' | 'summary';
+/**
+ * Pin entity
+ *
+ * Immutable - delete to remove
+ */
+export interface Pin {
+    /** Unique identifier (UUIDv4) */
+    id: ID;
+    /** Type of entity being pinned */
+    targetType: PinTargetType;
+    /** ID of the pinned entity (observation or summary) */
+    targetId: ID;
+    /**
+     * Optional user-provided explanation for why this is pinned
+     * e.g., "Critical context for auth flow"
+     */
+    reason?: string;
+    /** Timestamp when pin was created (epoch milliseconds) */
+    createdAt: Timestamp;
+    /**
+     * Optional expiration timestamp (epoch milliseconds)
+     * If set, pin is only active while expiresAt > now
+     * Supports time-bound pins (e.g., session-only)
+     */
+    expiresAt?: Timestamp;
+    /** Isolation dimensions for scoped queries */
+    scopeIds: ScopeIds;
+}
+/**
+ * Input for creating a new pin
+ * Makes id and createdAt optional (will be auto-generated)
+ */
+export interface PinInput {
+    id?: ID;
+    targetType: PinTargetType;
+    targetId: ID;
+    reason?: string;
+    createdAt?: Timestamp;
+    expiresAt?: Timestamp;
+    scopeIds: ScopeIds;
+}
+/**
+ * All valid pin target types
+ */
+export declare const PIN_TARGET_TYPES: readonly PinTargetType[];
+/**
+ * Type guard to check if a string is a valid PinTargetType
+ */
+export declare function isPinTargetType(value: unknown): value is PinTargetType;
+/**
+ * Check if a pin is active (not expired) at a given timestamp
+ */
+export declare function isPinActive(pin: Pin, now: Timestamp): boolean;
+//# sourceMappingURL=pin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pin.d.ts","sourceRoot":"","sources":["../../src/types/pin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG,SAAS,CAAC;AAEtD;;;;GAIG;AACH,MAAM,WAAW,GAAG;IAClB,iCAAiC;IACjC,EAAE,EAAE,EAAE,CAAC;IAEP,kCAAkC;IAClC,UAAU,EAAE,aAAa,CAAC;IAE1B,uDAAuD;IACvD,QAAQ,EAAE,EAAE,CAAC;IAEb;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,0DAA0D;IAC1D,SAAS,EAAE,SAAS,CAAC;IAErB;;;;OAIG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IAEtB,8CAA8C;IAC9C,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,CAAC,EAAE,EAAE,CAAC;IACR,UAAU,EAAE,aAAa,CAAC;IAC1B,QAAQ,EAAE,EAAE,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,aAAa,EAG3C,CAAC;AAEX;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAEtE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAE7D"}

package/dist/types/pin.js

@@ -0,0 +1,26 @@
+/**
+ * Pin types and definitions
+ *
+ * A Pin marks an observation or summary as important
+ * (user-curated for retrieval prioritization)
+ */
+/**
+ * All valid pin target types
+ */
+export const PIN_TARGET_TYPES = [
+    'observation',
+    'summary',
+];
+/**
+ * Type guard to check if a string is a valid PinTargetType
+ */
+export function isPinTargetType(value) {
+    return typeof value === 'string' && PIN_TARGET_TYPES.includes(value);
+}
+/**
+ * Check if a pin is active (not expired) at a given timestamp
+ */
+export function isPinActive(pin, now) {
+    return pin.expiresAt === undefined || pin.expiresAt > now;
+}
+//# sourceMappingURL=pin.js.map

package/dist/types/pin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pin.js","sourceRoot":"","sources":["../../src/types/pin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA0DH;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAA6B;IACxD,aAAa;IACb,SAAS;CACD,CAAC;AAEX;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,gBAAgB,CAAC,QAAQ,CAAC,KAAsB,CAAC,CAAC;AACxF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,GAAQ,EAAE,GAAc;IAClD,OAAO,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI,GAAG,CAAC,SAAS,GAAG,GAAG,CAAC;AAC5D,CAAC"}

package/dist/types/retrieval.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Retrieval types and interfaces
+ */
+import type { ScopeIds, ID } from './common.js';
+import type { Observation } from './observation.js';
+import type { Summary } from './summary.js';
+import type { Pin } from './pin.js';
+/**
+ * Options for retrieval request
+ */
+export interface RetrieveOptions {
+    query: string;
+    scopeIds: ScopeIds;
+    /**
+     * @deprecated Use maxCandidates for bounded result sets. Token-budgeted assembly is a downstream system responsibility.
+     */
+    tokenBudget?: number;
+    maxCandidates?: number;
+    includeRedacted?: boolean;
+}
+/**
+ * Pin with resolved target
+ */
+export interface PinResult {
+    pin: Pin;
+    target: Observation | Summary;
+}
+/**
+ * Candidate with score and match context
+ */
+export interface CandidateResult {
+    entity: Observation | Summary;
+    score: number;
+    matchContext?: string;
+}
+/**
+ * Provenance for retrieval result
+ */
+export interface RetrieveProvenance {
+    query: string;
+    scopeIds: ScopeIds;
+    totalCandidates: number;
+    returnedCandidates: number;
+    truncatedDueToTokenBudget: boolean;
+    providerUsed: string;
+}
+/**
+ * Complete retrieval result
+ */
+export interface RetrieveResult {
+    pins: PinResult[];
+    currentSummary?: Summary;
+    candidates: CandidateResult[];
+    provenance: RetrieveProvenance;
+}
+/**
+ * Provider search options
+ */
+export interface ProviderSearchOptions {
+    query: string;
+    scopeIds: ScopeIds;
+    maxResults?: number;
+    excludeIds?: ID[];
+    includeRedacted?: boolean;
+}
+/**
+ * Provider search result
+ */
+export interface ProviderSearchResult {
+    entity: Observation | Summary;
+    score: number;
+    matchContext?: string;
+}
+/**
+ * Retrieval provider interface
+ */
+export interface RetrievalProvider {
+    name: string;
+    search(options: ProviderSearchOptions): Promise<ProviderSearchResult[]>;
+}
+//# sourceMappingURL=retrieval.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"retrieval.d.ts","sourceRoot":"","sources":["../../src/types/retrieval.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAEpC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,QAAQ,CAAC;IACnB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,GAAG,CAAC;IACT,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,QAAQ,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,yBAAyB,EAAE,OAAO,CAAC;IACnC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,UAAU,EAAE,kBAAkB,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,EAAE,EAAE,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAC;CACzE"}

package/dist/types/retrieval.js

@@ -0,0 +1,5 @@
+/**
+ * Retrieval types and interfaces
+ */
+export {};
+//# sourceMappingURL=retrieval.js.map

package/dist/types/retrieval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieval.js","sourceRoot":"","sources":["../../src/types/retrieval.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types/summary.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Summary types and definitions
+ *
+ * A Summary is a high-level description of a capsule's content
+ * (typically LLM-generated on capsule close)
+ */
+import type { ID, Timestamp } from './common.js';
+/**
+ * Summary entity
+ *
+ * Fully immutable once created
+ */
+export interface Summary {
+    /** Unique identifier (UUIDv4) */
+    id: ID;
+    /** Reference to parent capsule (one-to-one relationship) */
+    capsuleId: ID;
+    /** Summary text (human-readable, typically LLM-generated) */
+    content: string;
+    /**
+     * Quality/confidence score (0.0 = low, 1.0 = high)
+     * Indicates reliability of the summary
+     */
+    confidence: number;
+    /** Timestamp when summary was created (epoch milliseconds) */
+    createdAt: Timestamp;
+    /**
+     * Observation IDs that support this summary (provenance)
+     * Shows which observations informed the summary
+     */
+    evidenceRefs: ID[];
+}
+/**
+ * Input for creating a new summary
+ * Makes id and createdAt optional (will be auto-generated)
+ */
+export interface SummaryInput {
+    id?: ID;
+    capsuleId: ID;
+    content: string;
+    confidence: number;
+    createdAt?: Timestamp;
+    evidenceRefs: ID[];
+}
+/**
+ * Validate that confidence score is in valid range [0.0, 1.0]
+ */
+export declare function isValidConfidence(value: number): boolean;
+//# sourceMappingURL=summary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../src/types/summary.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;GAIG;AACH,MAAM,WAAW,OAAO;IACtB,iCAAiC;IACjC,EAAE,EAAE,EAAE,CAAC;IAEP,4DAA4D;IAC5D,SAAS,EAAE,EAAE,CAAC;IAEd,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB,8DAA8D;IAC9D,SAAS,EAAE,SAAS,CAAC;IAErB;;;OAGG;IACH,YAAY,EAAE,EAAE,EAAE,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,EAAE,EAAE,CAAC;IACR,SAAS,EAAE,EAAE,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,YAAY,EAAE,EAAE,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAExD"}

package/dist/types/summary.js

@@ -0,0 +1,13 @@
+/**
+ * Summary types and definitions
+ *
+ * A Summary is a high-level description of a capsule's content
+ * (typically LLM-generated on capsule close)
+ */
+/**
+ * Validate that confidence score is in valid range [0.0, 1.0]
+ */
+export function isValidConfidence(value) {
+    return typeof value === 'number' && value >= 0.0 && value <= 1.0 && !isNaN(value);
+}
+//# sourceMappingURL=summary.js.map

package/dist/types/summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.js","sourceRoot":"","sources":["../../src/types/summary.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgDH;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,IAAI,GAAG,IAAI,KAAK,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACpF,CAAC"}

package/dist/validation/capsule.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Capsule validation
+ */
+import type { Capsule, ValidationError, Result } from '../types/index.js';
+/**
+ * Validate and normalize a capsule input
+ *
+ * Auto-generates:
+ * - id (if not provided)
+ * - openedAt (if not provided)
+ * - status (defaults to 'open')
+ * - observationIds (defaults to empty array)
+ *
+ * @param input - Capsule input to validate
+ * @returns Result containing validated Capsule or validation errors
+ */
+export declare function validateCapsule(input: unknown): Result<Capsule, ValidationError[]>;
+//# sourceMappingURL=capsule.d.ts.map

package/dist/validation/capsule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capsule.d.ts","sourceRoot":"","sources":["../../src/validation/capsule.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EACV,OAAO,EACP,eAAe,EACf,MAAM,EACP,MAAM,mBAAmB,CAAC;AAQ3B;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,eAAe,EAAE,CAAC,CAkIlF"}

package/dist/validation/capsule.js

@@ -0,0 +1,143 @@
+/**
+ * Capsule validation
+ */
+import { randomUUID } from 'crypto';
+import { ok, err, isCapsuleType, isCapsuleStatus, } from '../types/index.js';
+/**
+ * Validate and normalize a capsule input
+ *
+ * Auto-generates:
+ * - id (if not provided)
+ * - openedAt (if not provided)
+ * - status (defaults to 'open')
+ * - observationIds (defaults to empty array)
+ *
+ * @param input - Capsule input to validate
+ * @returns Result containing validated Capsule or validation errors
+ */
+export function validateCapsule(input) {
+    const errors = [];
+    // Type check
+    if (typeof input !== 'object' || input === null) {
+        return err([{ field: 'input', message: 'Input must be an object' }]);
+    }
+    const data = input;
+    // Validate type (required)
+    if (!data.type) {
+        errors.push({ field: 'type', message: 'type is required' });
+    }
+    else if (!isCapsuleType(data.type)) {
+        errors.push({
+            field: 'type',
+            message: `Invalid capsule type: ${data.type}`,
+            value: data.type,
+        });
+    }
+    // Validate intent (required, non-empty string)
+    if (!data.intent) {
+        errors.push({ field: 'intent', message: 'intent is required' });
+    }
+    else if (typeof data.intent !== 'string') {
+        errors.push({
+            field: 'intent',
+            message: 'intent must be a string',
+            value: typeof data.intent,
+        });
+    }
+    else if (data.intent.trim().length === 0) {
+        errors.push({ field: 'intent', message: 'intent cannot be empty' });
+    }
+    // Validate scopeIds (required)
+    if (!data.scopeIds) {
+        errors.push({ field: 'scopeIds', message: 'scopeIds is required' });
+    }
+    else if (typeof data.scopeIds !== 'object' || data.scopeIds === null) {
+        errors.push({
+            field: 'scopeIds',
+            message: 'scopeIds must be an object',
+        });
+    }
+    // Validate status (optional)
+    if (data.status !== undefined && !isCapsuleStatus(data.status)) {
+        errors.push({
+            field: 'status',
+            message: `Invalid capsule status: ${data.status}`,
+            value: data.status,
+        });
+    }
+    // Validate openedAt (optional, must be positive number)
+    if (data.openedAt !== undefined) {
+        if (typeof data.openedAt !== 'number') {
+            errors.push({
+                field: 'openedAt',
+                message: 'openedAt must be a number',
+                value: typeof data.openedAt,
+            });
+        }
+        else if (data.openedAt < 0) {
+            errors.push({
+                field: 'openedAt',
+                message: 'openedAt must be non-negative',
+                value: data.openedAt,
+            });
+        }
+    }
+    // Validate closedAt (optional, must be positive number)
+    if (data.closedAt !== undefined) {
+        if (typeof data.closedAt !== 'number') {
+            errors.push({
+                field: 'closedAt',
+                message: 'closedAt must be a number',
+                value: typeof data.closedAt,
+            });
+        }
+        else if (data.closedAt < 0) {
+            errors.push({
+                field: 'closedAt',
+                message: 'closedAt must be non-negative',
+                value: data.closedAt,
+            });
+        }
+    }
+    // Validate observationIds (optional, must be array of strings)
+    if (data.observationIds !== undefined) {
+        if (!Array.isArray(data.observationIds)) {
+            errors.push({
+                field: 'observationIds',
+                message: 'observationIds must be an array',
+            });
+        }
+        else if (!data.observationIds.every((id) => typeof id === 'string')) {
+            errors.push({
+                field: 'observationIds',
+                message: 'observationIds must contain only strings',
+            });
+        }
+    }
+    // Validate summaryId (optional, must be string)
+    if (data.summaryId !== undefined && typeof data.summaryId !== 'string') {
+        errors.push({
+            field: 'summaryId',
+            message: 'summaryId must be a string',
+            value: typeof data.summaryId,
+        });
+    }
+    // Return errors if any
+    if (errors.length > 0) {
+        return err(errors);
+    }
+    // Construct validated capsule with defaults
+    const capsule = {
+        id: data.id || randomUUID(),
+        type: data.type,
+        intent: data.intent,
+        status: data.status || 'open',
+        openedAt: data.openedAt || Date.now(),
+        closedAt: data.closedAt,
+        scopeIds: data.scopeIds,
+        observationIds: data.observationIds || [],
+        summaryId: data.summaryId,
+    };
+    return ok(capsule);
+}
+//# sourceMappingURL=capsule.js.map

package/dist/validation/capsule.js.map

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

package/dist/validation/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Validation functions for Kindling domain types
+ */
+export { validateObservation } from './observation.js';
+export { validateCapsule } from './capsule.js';
+export { validateSummary } from './summary.js';
+export { validatePin } from './pin.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC"}

package/dist/validation/index.js

@@ -0,0 +1,8 @@
+/**
+ * Validation functions for Kindling domain types
+ */
+export { validateObservation } from './observation.js';
+export { validateCapsule } from './capsule.js';
+export { validateSummary } from './summary.js';
+export { validatePin } from './pin.js';
+//# sourceMappingURL=index.js.map

package/dist/validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC"}

package/dist/validation/observation.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Observation validation
+ */
+import type { Observation, ValidationError, Result } from '../types/index.js';
+/**
+ * Validate and normalize an observation input
+ *
+ * Auto-generates:
+ * - id (if not provided)
+ * - ts (if not provided)
+ * - redacted (defaults to false)
+ * - provenance (defaults to empty object)
+ *
+ * @param input - Observation input to validate
+ * @returns Result containing validated Observation or validation errors
+ */
+export declare function validateObservation(input: unknown): Result<Observation, ValidationError[]>;
+//# sourceMappingURL=observation.d.ts.map

package/dist/validation/observation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation.d.ts","sourceRoot":"","sources":["../../src/validation/observation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,MAAM,EACP,MAAM,mBAAmB,CAAC;AAO3B;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,WAAW,EAAE,eAAe,EAAE,CAAC,CAiG1F"}