@portablecore/types 0.1.0

package/dist/expert/core.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Expert Core Types
+ *
+ * The portable identity of an expert.
+ */
+/**
+ * Expert identity (the portable part)
+ */
+export interface ExpertCore {
+    id: string;
+    accountId: string;
+    /** Identity */
+    name: string;
+    slug: string;
+    description?: string;
+    /** Personality */
+    persona?: string;
+    systemPrompt?: string;
+    /** Protected instructions that survive knowledge regeneration */
+    systemInstructions?: string;
+    /** Avatar/visual identity */
+    avatarUrl?: string;
+    /** AI-generated description of avatar for self-awareness */
+    avatarDescription?: string;
+    /** Whether the avatar depicts the user themselves */
+    avatarIsMe?: boolean;
+    /** Name of person depicted in avatar (e.g. "Marshall McLuhan") */
+    avatarSubject?: string;
+    /** Model configuration */
+    modelId?: string;
+    temperature?: number;
+    /** Status */
+    isActive: boolean;
+}
+/**
+ * Expert personality configuration
+ */
+export interface ExpertPersonality {
+    system_prompt: string;
+    tone?: string;
+    constraints?: string[];
+}
+/**
+ * Simplified expert for listing/display
+ */
+export interface ExpertSummary {
+    id: string;
+    name: string;
+    slug: string;
+    description?: string;
+    avatarUrl?: string;
+    isActive: boolean;
+}
+//# sourceMappingURL=core.d.ts.map

package/dist/expert/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/expert/core.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,MAAM,CAAA;IAEjB,eAAe;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,kBAAkB;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,iEAAiE;IACjE,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAE3B,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,4DAA4D;IAC5D,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,qDAAqD;IACrD,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,kEAAkE;IAClE,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB,0BAA0B;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,aAAa;IACb,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAA;IACrB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,OAAO,CAAA;CAClB"}

package/dist/expert/core.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Expert Core Types
+ *
+ * The portable identity of an expert.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=core.js.map

package/dist/expert/core.js.map

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

package/dist/expert/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Expert types - re-exports
+ */
+export * from "./core.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/expert/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,WAAW,CAAA"}

package/dist/expert/index.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * Expert types - re-exports
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./core.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/expert/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/expert/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,4CAAyB"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @portablecore/types
+ *
+ * Shared vocabulary for Portable platforms.
+ * PEP protocol types, Expert, Memory, Surface definitions.
+ *
+ * "The expert brings their expertise. The surface provides the material."
+ */
+export * from "./pep/index.js";
+export * from "./expert/index.js";
+export * from "./memory/index.js";
+export * from "./surface/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,cAAc,gBAAgB,CAAA;AAG9B,cAAc,mBAAmB,CAAA;AAGjC,cAAc,mBAAmB,CAAA;AAGjC,cAAc,oBAAoB,CAAA"}

package/dist/index.js

@@ -0,0 +1,33 @@
+"use strict";
+/**
+ * @portablecore/types
+ *
+ * Shared vocabulary for Portable platforms.
+ * PEP protocol types, Expert, Memory, Surface definitions.
+ *
+ * "The expert brings their expertise. The surface provides the material."
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// PEP Protocol Types
+__exportStar(require("./pep/index.js"), exports);
+// Expert Types
+__exportStar(require("./expert/index.js"), exports);
+// Memory Types
+__exportStar(require("./memory/index.js"), exports);
+// Surface Types
+__exportStar(require("./surface/index.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;;;;;;;;;;;;;;AAEH,qBAAqB;AACrB,iDAA8B;AAE9B,eAAe;AACf,oDAAiC;AAEjC,eAAe;AACf,oDAAiC;AAEjC,gBAAgB;AAChB,qDAAkC"}

package/dist/memory/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Memory types - re-exports
+ */
+export * from "./source.js";
+export * from "./memory.js";
+export * from "./search.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA"}

package/dist/memory/index.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * Memory types - re-exports
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./source.js"), exports);
+__exportStar(require("./memory.js"), exports);
+__exportStar(require("./search.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,8CAA2B;AAC3B,8CAA2B;AAC3B,8CAA2B"}

package/dist/memory/memory.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Memory Types - Core definitions
+ *
+ * Memory belongs to experts, not surfaces.
+ * Portable owns ALL memories. Surfaces don't get to keep them.
+ */
+import type { SurfaceType } from "../surface/context.js";
+import type { MemorySource, MemoryType, MemoryScope, IdentityCategory, MemoryEntity } from "./source.js";
+/**
+ * A memory belonging to an expert
+ */
+export interface Memory {
+    id: string;
+    accountId: string;
+    expertId: string;
+    userId?: string;
+    name?: string;
+    content: string;
+    summary: string;
+    followUp?: string;
+    source: MemorySource;
+    memoryType?: MemoryType;
+    memoryScope: MemoryScope;
+    category?: string;
+    tags: string[];
+    sourceSurfaceType?: SurfaceType | string;
+    sourceSurfaceId?: string;
+    sourceChatId?: string;
+    sourceMessageId?: string;
+    sourceThreadId?: string;
+    importance: number;
+    confidence: number;
+    quality?: number;
+    decayRate: number;
+    accessBoost: number;
+    lastAccessedAt?: Date;
+    accessCount: number;
+    validUntil?: Date;
+    relatedMemoryIds: string[];
+    supersedesMemoryId?: string;
+    entities: MemoryEntity[];
+    denseVectorId?: string;
+    sparseVectorId?: string;
+    embeddingStatus: "pending" | "processing" | "ready" | "failed";
+    embeddingModel?: string;
+    lastEmbeddedAt?: Date;
+    isValidated: boolean;
+    validatedAt?: Date;
+    validatedBy?: string;
+    identityCategory?: IdentityCategory;
+    contradictionOf?: string;
+    confirmationCount: number;
+    formedInMultiPlayer: boolean;
+    participantUserIds: string[];
+    metadata?: Record<string, unknown>;
+    occurredAt?: Date;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * Memory with calculated effective importance
+ */
+export interface MemoryWithEffectiveImportance extends Memory {
+    effectiveImportance: number;
+}
+/**
+ * Simplified memory for PEP context
+ */
+export interface MemorySimple {
+    id: string;
+    expertId: string;
+    content: string;
+    summary?: string;
+    source: MemorySource;
+    tags?: string[];
+    sourceSurfaceType: SurfaceType;
+    sourceSurfaceId: string;
+    quality?: number;
+    importance?: number;
+    createdAt: Date;
+    lastAccessedAt?: Date;
+    embedding?: number[];
+}
+/**
+ * Calculate effective importance with decay and access boost
+ */
+export declare function calculateEffectiveImportance(memory: Memory): number;
+//# sourceMappingURL=memory.d.ts.map

package/dist/memory/memory.d.ts.map

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

package/dist/memory/memory.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * Memory Types - Core definitions
+ *
+ * Memory belongs to experts, not surfaces.
+ * Portable owns ALL memories. Surfaces don't get to keep them.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateEffectiveImportance = calculateEffectiveImportance;
+/**
+ * Calculate effective importance with decay and access boost
+ */
+function calculateEffectiveImportance(memory) {
+    const now = new Date();
+    const createdAt = new Date(memory.createdAt);
+    const daysSinceCreated = (now.getTime() - createdAt.getTime()) / (1000 * 60 * 60 * 24);
+    // Apply exponential decay
+    const decayed = (memory.importance ?? 0.5) *
+        Math.exp(-(memory.decayRate ?? 0.01) * daysSinceCreated);
+    // Apply access boost (capped)
+    const boost = Math.min((memory.accessCount ?? 0) * (memory.accessBoost ?? 0.05), 0.3);
+    // Clamp to 0-1
+    return Math.min(Math.max(decayed + boost, 0), 1);
+}
+//# sourceMappingURL=memory.js.map

package/dist/memory/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/memory/memory.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAsHH,oEAmBC;AAtBD;;GAEG;AACH,SAAgB,4BAA4B,CAAC,MAAc;IACzD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAA;IACtB,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IAC5C,MAAM,gBAAgB,GACpB,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAA;IAE/D,0BAA0B;IAC1B,MAAM,OAAO,GACX,CAAC,MAAM,CAAC,UAAU,IAAI,GAAG,CAAC;QAC1B,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,gBAAgB,CAAC,CAAA;IAE1D,8BAA8B;IAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CACpB,CAAC,MAAM,CAAC,WAAW,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,IAAI,IAAI,CAAC,EACxD,GAAG,CACJ,CAAA;IAED,eAAe;IACf,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,GAAG,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AAClD,CAAC"}

package/dist/memory/search.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Memory Search Types
+ */
+import type { SurfaceType } from "../surface/context.js";
+import type { MemorySource, MemoryType, MemoryScope } from "./source.js";
+import type { MemoryWithEffectiveImportance } from "./memory.js";
+/**
+ * Reference to a memory used in a response
+ */
+export interface MemoryReference {
+    memoryId: string;
+    summary: string;
+    relevance: number;
+    sourceSurface: SurfaceType;
+}
+/**
+ * Options for memory search
+ */
+export interface MemorySearchOptions {
+    /** Maximum memories to return */
+    topK?: number;
+    /** Minimum relevance score (0-1) */
+    minScore?: number;
+    /** Filter by source surface types */
+    surfaceTypes?: (SurfaceType | string)[];
+    /** Filter by memory types */
+    memoryTypes?: MemoryType[];
+    /** Filter by memory source */
+    sources?: MemorySource[];
+    /** Filter by memory scope */
+    scopes?: MemoryScope[];
+    /** Include expired memories */
+    includeExpired?: boolean;
+    /** Filter by tags (any match) */
+    tags?: string[];
+    /** Maximum tokens in combined results */
+    maxTokens?: number;
+    /**
+     * Chat ID for audience-aware retrieval.
+     * When provided, the system checks if other humans are present
+     * and restricts memory access accordingly.
+     */
+    chatId?: string;
+}
+/**
+ * A memory search result
+ */
+export interface MemorySearchResult {
+    memory: MemoryWithEffectiveImportance;
+    score: number;
+    source: "dense" | "sparse" | "both";
+}
+//# sourceMappingURL=search.d.ts.map

package/dist/memory/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/memory/search.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACxE,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAA;AAEhE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,WAAW,CAAA;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,iCAAiC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB,qCAAqC;IACrC,YAAY,CAAC,EAAE,CAAC,WAAW,GAAG,MAAM,CAAC,EAAE,CAAA;IAEvC,6BAA6B;IAC7B,WAAW,CAAC,EAAE,UAAU,EAAE,CAAA;IAE1B,8BAA8B;IAC9B,OAAO,CAAC,EAAE,YAAY,EAAE,CAAA;IAExB,6BAA6B;IAC7B,MAAM,CAAC,EAAE,WAAW,EAAE,CAAA;IAEtB,+BAA+B;IAC/B,cAAc,CAAC,EAAE,OAAO,CAAA;IAExB,iCAAiC;IACjC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IAEf,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,6BAA6B,CAAA;IACrC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAA;CACpC"}

package/dist/memory/search.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Memory Search Types
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=search.js.map

package/dist/memory/search.js.map

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

package/dist/memory/source.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Memory Source Types
+ *
+ * The epistemological foundation of expert memory.
+ */
+/**
+ * The five sources of expert memory (Say, Hear, Do, Know, Be)
+ * - say: What the user communicates (chat)
+ * - hear: What the expert observes (work surfaces)
+ * - do: Actions humans take (work surfaces)
+ * - know: Knowledge accumulated (both)
+ * - be: Identity, personality, presence (both)
+ */
+export type MemorySource = "say" | "hear" | "do" | "know" | "be";
+/**
+ * Memory classification types
+ */
+export type MemoryType = "preference" | "fact" | "constraint" | "project" | "interaction_state" | "self_fact" | "self_value" | "self_goal" | "relationship";
+/**
+ * How widely a memory can be accessed
+ */
+export type MemoryScope = "thread" | "chat" | "expert" | "user" | "portable";
+/**
+ * Identity categories for grouping in identity views
+ */
+export type IdentityCategory = "who_i_am" | "what_i_value" | "what_im_working_on" | "preferences" | "relationships";
+/**
+ * An entity mentioned in memories (person, place, project, etc.)
+ */
+export interface MemoryEntity {
+    type: string;
+    value: string;
+}
+/**
+ * Memory source types constant
+ */
+export declare const MEMORY_SOURCES: {
+    readonly SAY: "say";
+    readonly HEAR: "hear";
+    readonly DO: "do";
+    readonly KNOW: "know";
+    readonly BE: "be";
+};
+//# sourceMappingURL=source.d.ts.map

package/dist/memory/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../src/memory/source.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAAA;AAEhE;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB,YAAY,GACZ,MAAM,GACN,YAAY,GACZ,SAAS,GACT,mBAAmB,GAEnB,WAAW,GACX,YAAY,GACZ,WAAW,GACX,cAAc,CAAA;AAElB;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,MAAM,GACN,UAAU,CAAA;AAEd;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,UAAU,GACV,cAAc,GACd,oBAAoB,GACpB,aAAa,GACb,eAAe,CAAA;AAEnB;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;CAMjB,CAAA"}

package/dist/memory/source.js

@@ -0,0 +1,19 @@
+"use strict";
+/**
+ * Memory Source Types
+ *
+ * The epistemological foundation of expert memory.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MEMORY_SOURCES = void 0;
+/**
+ * Memory source types constant
+ */
+exports.MEMORY_SOURCES = {
+    SAY: "say",
+    HEAR: "hear",
+    DO: "do",
+    KNOW: "know",
+    BE: "be",
+};
+//# sourceMappingURL=source.js.map

package/dist/memory/source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../../src/memory/source.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAuDH;;GAEG;AACU,QAAA,cAAc,GAAG;IAC5B,GAAG,EAAE,KAAK;IACV,IAAI,EAAE,MAAM;IACZ,EAAE,EAAE,IAAI;IACR,IAAI,EAAE,MAAM;IACZ,EAAE,EAAE,IAAI;CACA,CAAA"}

package/dist/pep/export.d.ts

@@ -0,0 +1,146 @@
+/**
+ * PEP Export Payload Types
+ *
+ * The complete payload that travels with an expert to a new surface.
+ * This is the "what travels" definition for PEP Layer 1.
+ * See PEP Specification §3.7
+ */
+/**
+ * The complete payload that travels with an expert to a new surface.
+ */
+export interface PEPExportPayload {
+    /** Schema version for forward compatibility */
+    version: "1.0";
+    /** Expert identity */
+    identity: PEPIdentity;
+    /** Core instructions - always in context (~300-500 tokens) */
+    core_identity: string;
+    /** First message template (expert's opening when starting a conversation) */
+    first_message?: string;
+    /** Knowledge architecture */
+    knowledge: PEPKnowledgePayload;
+    /** Skill bindings */
+    skills: PEPSkillBinding[];
+    /** Voice/personality settings */
+    voice: PEPVoicePayload;
+    /** Memory access configuration */
+    memory: PEPMemoryConfig;
+    /** Origin metadata */
+    provenance: PEPProvenance;
+}
+export interface PEPIdentity {
+    /** UUID, stable across surfaces */
+    id: string;
+    /** Display name (user-chosen) */
+    name: string;
+    /** URL-safe identifier */
+    slug: string;
+    /** One-line description */
+    tagline?: string;
+    /** Profile image URL */
+    avatar_url?: string;
+    /** Host URI (e.g., "portable.expert") */
+    host: string;
+}
+export interface PEPKnowledgePayload {
+    /**
+     * Option 1: Inline documents (for smaller experts)
+     * Documents travel with the expert and are indexed by the surface
+     */
+    documents?: PEPKnowledgeDocument[];
+    /**
+     * Option 2: Remote reference (for larger experts)
+     * Surface queries the host's knowledge endpoint
+     */
+    remote?: {
+        /** Host's semantic search endpoint */
+        query_endpoint: string;
+        /** e.g., Pinecone namespace */
+        namespace?: string;
+    };
+}
+export interface PEPKnowledgeDocument {
+    id: string;
+    document_type: PEPKnowledgeDocumentType;
+    title: string;
+    content: string;
+    token_count: number;
+    /** When to retrieve this document */
+    retrieval_triggers: string[];
+    /** Pre-computed embedding (optional - surface may re-embed) */
+    embedding?: {
+        model: string;
+        dimensions: number;
+        vector: number[];
+    };
+}
+export type PEPKnowledgeDocumentType = "backstory" | "domain_expertise" | "methodology" | "boundaries" | "custom";
+export interface PEPSkillBinding {
+    skill_slug: string;
+    portability: "portable" | "surface_required";
+    /** For portable skills: the tool definition and endpoint */
+    portable_tool?: {
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+        /** Host's endpoint for execution */
+        endpoint: string;
+        /** Optional API key header name */
+        api_key_header?: string;
+    };
+    /** For surface-required skills: what the surface must provide */
+    required_capability?: string;
+}
+export interface PEPVoicePayload {
+    /** Base archetype (surfaces map to their own voice systems) */
+    archetype?: {
+        slug: string;
+        personality_traits: string[];
+        communication_style: string;
+    };
+    /** Expert-specific overrides */
+    overrides?: {
+        tone?: string;
+        verbosity?: "concise" | "balanced" | "detailed";
+        formality?: "casual" | "neutral" | "formal";
+        emoji_usage?: "none" | "minimal" | "moderate";
+    };
+}
+export interface PEPMemoryConfig {
+    /** Memory scope preference */
+    default_scope: "user" | "expert" | "shared";
+    /** Whether expert can access team shared memory */
+    can_access_shared: boolean;
+    /** Whether expert contributes to shared memory */
+    contributes_to_shared: boolean;
+    /**
+     * Memory query interface
+     * Surfaces call this to retrieve relevant memories at invocation time
+     */
+    query_endpoint: string;
+}
+export interface PEPProvenance {
+    /** e.g., "portable" */
+    source_platform: string;
+    /** ISO timestamp */
+    exported_at: string;
+    /** e.g., 2 for tiered architecture */
+    knowledge_version: number;
+    /** For integrity verification */
+    payload_hash?: string;
+}
+/**
+ * Type guard to check if an object is a valid PEP Export Payload.
+ */
+export declare function isPEPExportPayload(obj: unknown): obj is PEPExportPayload;
+/**
+ * Validates a PEP payload and returns detailed errors if invalid.
+ */
+export declare function validatePEPPayload(obj: unknown): {
+    valid: true;
+    payload: PEPExportPayload;
+} | {
+    valid: false;
+    errors: string[];
+};
+//# sourceMappingURL=export.d.ts.map

package/dist/pep/export.d.ts.map

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