@polpo-ai/core 0.15.41 → 0.15.43

package/dist/memory/store-types.d.ts

@@ -0,0 +1,97 @@
+import type { MemoryDedupeInput, MemoryItem, MemoryKind, MemoryScope, MemoryScopeAccess, MemoryStatus } from "./types.js";
+export type MemoryWriteSurface = "api" | "chat" | "task" | "loop" | "schedule" | "channel" | "system";
+export interface MemoryStoreContext {
+    /** Host-owned hard isolation boundary, normally a project id. */
+    readonly namespace: string;
+    readonly access: MemoryScopeAccess;
+    readonly surface?: MemoryWriteSurface;
+    readonly channelVisibility?: "public" | "private";
+    readonly now?: Date | string;
+}
+export interface MemoryItemPatch {
+    readonly content?: string;
+    readonly summary?: string | null;
+    readonly confidence?: number | null;
+    readonly status?: MemoryStatus;
+    readonly expiresAt?: string | null;
+}
+export interface MemoryGetOptions {
+    readonly includeInactive?: boolean;
+    readonly includeExpired?: boolean;
+    readonly now?: Date | string;
+}
+export interface MemoryListQuery {
+    readonly kinds?: readonly MemoryKind[];
+    readonly statuses?: readonly MemoryStatus[];
+    readonly scope?: MemoryScope;
+    readonly includeExpired?: boolean;
+    readonly now?: Date | string;
+    readonly limit?: number;
+}
+export interface MemoryListCursor {
+    readonly createdAt: string;
+    readonly id: string;
+}
+export interface MemoryListPageQuery extends MemoryListQuery {
+    readonly after?: MemoryListCursor;
+}
+export interface MemoryListPage {
+    readonly items: readonly MemoryItem[];
+    readonly nextCursor?: MemoryListCursor;
+}
+export interface MemorySearchQuery {
+    readonly query: string;
+    readonly kinds?: readonly MemoryKind[];
+    readonly scope?: MemoryScope;
+    readonly tokenBudget?: number;
+    readonly maxResults?: number;
+    readonly now?: Date | string;
+}
+export interface MemorySearchResult {
+    readonly item: MemoryItem;
+    readonly score: number;
+    readonly matchedTerms: readonly string[];
+    readonly estimatedTokens: number;
+}
+export type MemoryUsageEventType = "retrieved" | "written" | "updated" | "superseded" | "forgotten";
+export interface MemoryUsageEvent {
+    readonly id: string;
+    readonly memoryId: string;
+    readonly type: MemoryUsageEventType;
+    readonly at: string;
+    readonly runId?: string;
+    readonly sessionId?: string;
+    readonly requestId?: string;
+}
+export interface MemorySupersedeResult {
+    readonly superseded: MemoryItem;
+    readonly replacement: MemoryItem;
+}
+export interface MemoryItemStore {
+    create(item: MemoryItem, context: MemoryStoreContext): Promise<MemoryItem>;
+    get(id: string, context: MemoryStoreContext, options?: MemoryGetOptions): Promise<MemoryItem | undefined>;
+    list(query: MemoryListQuery, context: MemoryStoreContext): Promise<MemoryItem[]>;
+    /**
+     * Optional additive keyset-pagination capability. Hosts that do not
+     * implement it retain the original `list()` contract.
+     */
+    listPage?(query: MemoryListPageQuery, context: MemoryStoreContext): Promise<MemoryListPage>;
+    update(id: string, patch: MemoryItemPatch, context: MemoryStoreContext): Promise<MemoryItem | undefined>;
+    supersede(id: string, replacement: MemoryItem, context: MemoryStoreContext): Promise<MemorySupersedeResult | undefined>;
+    forget(id: string, context: MemoryStoreContext): Promise<boolean>;
+    search(query: MemorySearchQuery, context: MemoryStoreContext): Promise<MemorySearchResult[]>;
+    findDedupeCandidate(input: MemoryDedupeInput, context: MemoryStoreContext): Promise<MemoryItem | undefined>;
+    appendUsage(event: MemoryUsageEvent, context: MemoryStoreContext): Promise<void>;
+    listUsage(memoryId: string, context: MemoryStoreContext): Promise<MemoryUsageEvent[]>;
+    close?(): Promise<void> | void;
+}
+export interface MemoryStoreSnapshotNamespace {
+    readonly namespace: string;
+    readonly items: readonly MemoryItem[];
+    readonly usage: readonly MemoryUsageEvent[];
+}
+export interface MemoryItemStoreSnapshot {
+    readonly version: 1;
+    readonly namespaces: readonly MemoryStoreSnapshotNamespace[];
+}
+//# sourceMappingURL=store-types.d.ts.map

package/dist/memory/store-types.d.ts.map

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

package/dist/memory/store-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=store-types.js.map

package/dist/memory/store-types.js.map

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

package/dist/memory/types.d.ts

@@ -0,0 +1,70 @@
+export declare const MEMORY_SCOPE_KINDS: readonly ["org", "project", "agent", "user", "channel", "session"];
+export type MemoryScopeKind = (typeof MEMORY_SCOPE_KINDS)[number];
+export interface MemoryScope {
+    readonly kind: MemoryScopeKind;
+    readonly subjectId?: string;
+    readonly agentName?: string;
+}
+export declare const MEMORY_KINDS: readonly ["fact", "preference", "open_thread", "style", "failure_pattern", "successful_episode", "procedure_hint"];
+export type MemoryKind = (typeof MEMORY_KINDS)[number];
+export declare const MEMORY_STATUSES: readonly ["pending", "active", "superseded", "deleted"];
+export type MemoryStatus = (typeof MEMORY_STATUSES)[number];
+export declare const MEMORY_PROVENANCE_SOURCES: readonly ["explicit", "run", "session", "tool", "import", "extraction"];
+export type MemoryProvenanceSource = (typeof MEMORY_PROVENANCE_SOURCES)[number];
+export type MemoryProvenanceActor = "user" | "agent" | "system";
+export interface MemoryProvenance {
+    readonly source: MemoryProvenanceSource;
+    readonly actor?: MemoryProvenanceActor;
+    readonly sourceId?: string;
+    readonly runId?: string;
+    readonly sessionId?: string;
+    readonly messageId?: string;
+    readonly toolName?: string;
+}
+export interface MemoryItem {
+    readonly id: string;
+    readonly scope: MemoryScope;
+    readonly kind: MemoryKind;
+    readonly content: string;
+    readonly summary?: string;
+    readonly provenance: MemoryProvenance;
+    readonly confidence?: number;
+    readonly status: MemoryStatus;
+    readonly expiresAt?: string;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+}
+export interface CreateMemoryItemInput {
+    readonly id?: string;
+    readonly scope: MemoryScope;
+    readonly kind: MemoryKind;
+    readonly content: string;
+    readonly summary?: string;
+    readonly provenance: MemoryProvenance;
+    readonly confidence?: number;
+    readonly status?: Extract<MemoryStatus, "pending" | "active">;
+    readonly expiresAt?: string;
+}
+export interface MemoryItemFactoryOptions {
+    readonly createId?: () => string;
+    readonly now?: () => Date | string;
+}
+export interface MemoryScopeAccess {
+    readonly orgId?: string;
+    readonly projectId?: string;
+    readonly agentName?: string;
+    /** Hosted application's end user, never the Polpo account/member id. */
+    readonly externalUserId?: string;
+    readonly channelId?: string;
+    readonly sessionId?: string;
+}
+export interface MemoryDedupeInput {
+    readonly scope: MemoryScope;
+    readonly kind: MemoryKind;
+    readonly content: string;
+}
+export interface RenderMemoryItemsOptions {
+    readonly now?: Date | string;
+    readonly includePending?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/memory/types.js

@@ -0,0 +1,32 @@
+export const MEMORY_SCOPE_KINDS = [
+    "org",
+    "project",
+    "agent",
+    "user",
+    "channel",
+    "session",
+];
+export const MEMORY_KINDS = [
+    "fact",
+    "preference",
+    "open_thread",
+    "style",
+    "failure_pattern",
+    "successful_episode",
+    "procedure_hint",
+];
+export const MEMORY_STATUSES = [
+    "pending",
+    "active",
+    "superseded",
+    "deleted",
+];
+export const MEMORY_PROVENANCE_SOURCES = [
+    "explicit",
+    "run",
+    "session",
+    "tool",
+    "import",
+    "extraction",
+];
+//# sourceMappingURL=types.js.map

package/dist/memory/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/memory/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,KAAK;IACL,SAAS;IACT,OAAO;IACP,MAAM;IACN,SAAS;IACT,SAAS;CACD,CAAC;AAUX,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,MAAM;IACN,YAAY;IACZ,aAAa;IACb,OAAO;IACP,iBAAiB;IACjB,oBAAoB;IACpB,gBAAgB;CACR,CAAC;AAIX,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,SAAS;IACT,QAAQ;IACR,YAAY;IACZ,SAAS;CACD,CAAC;AAIX,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,UAAU;IACV,KAAK;IACL,SAAS;IACT,MAAM;IACN,QAAQ;IACR,YAAY;CACJ,CAAC"}

package/dist/orchestrator-context.d.ts

@@ -20,6 +20,7 @@ import type { AgentStore } from "./agent-store.js";
 import type { PolpoConfig, PolpoFileConfig, Task, AssessmentResult, ReviewContext, ReasoningLevel, ModelConfig } from "./types.js";
 import type { HookRegistry } from "./hooks.js";
 import type { Spawner } from "./spawner.js";
+import type { RuntimeContextProvider } from "./runtime-context/index.js";
 import type { ProjectLoopConfig } from "./loop/types.js";
 import type { ExecutionRouteClassifier, ExecutionRouteClassifierResolverContext } from "./execution-router.js";
 /** Progress event for individual assessment checks. */
@@ -56,6 +57,11 @@ export interface OrchestratorContext {
     readonly polpoDir: string;
     readonly assessFn: AssessFn;
     readonly spawner: Spawner;
+    /**
+     * Optional host-provided retrieval policy. Absence or a zero token budget
+     * keeps task prompts byte-identical and performs no retrieval.
+     */
+    readonly runtimeContext?: RuntimeContextProvider;
     /** Kill an OS process by PID (Node shell: process.kill). */
     readonly killProcess?: (pid: number, signal?: string) => void;
     /** Load polpo.json config from disk. */

package/dist/orchestrator-context.d.ts.map

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

package/dist/runtime-context/index.d.ts

@@ -0,0 +1,5 @@
+export { RUNTIME_CONTEXT_SEGMENT_KINDS, RUNTIME_CONTEXT_TRUST_LEVELS, } from "./types.js";
+export type { ResolveRuntimeContextOptions, RuntimeContextAudit, RuntimeContextCitation, RuntimeContextEntry, RuntimeContextProvider, RuntimeContextResolution, RuntimeContextResult, RuntimeContextRetrievalInput, RuntimeContextRetrievalRequest, RuntimeContextRetriever, RuntimeContextSegment, RuntimeContextSegmentKind, RuntimeContextSource, RuntimeContextTrust, } from "./types.js";
+export { renderRuntimeContextPrompt, resolveRuntimeContext, } from "./runtime-context.js";
+export { createMemoryRuntimeContextRetriever, type CreateMemoryRuntimeContextRetrieverOptions, } from "./memory-retriever.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime-context/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime-context/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,EAC7B,4BAA4B,GAC7B,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,4BAA4B,EAC5B,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACpB,4BAA4B,EAC5B,8BAA8B,EAC9B,uBAAuB,EACvB,qBAAqB,EACrB,yBAAyB,EACzB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,mCAAmC,EACnC,KAAK,0CAA0C,GAChD,MAAM,uBAAuB,CAAC"}

package/dist/runtime-context/index.js

@@ -0,0 +1,4 @@
+export { RUNTIME_CONTEXT_SEGMENT_KINDS, RUNTIME_CONTEXT_TRUST_LEVELS, } from "./types.js";
+export { renderRuntimeContextPrompt, resolveRuntimeContext, } from "./runtime-context.js";
+export { createMemoryRuntimeContextRetriever, } from "./memory-retriever.js";
+//# sourceMappingURL=index.js.map

package/dist/runtime-context/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime-context/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,EAC7B,4BAA4B,GAC7B,MAAM,YAAY,CAAC;AAiBpB,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,mCAAmC,GAEpC,MAAM,uBAAuB,CAAC"}

package/dist/runtime-context/memory-retriever.d.ts

@@ -0,0 +1,14 @@
+import type { MemoryItem, MemoryItemStore, MemoryStoreContext, MemoryUsageEvent } from "../memory/index.js";
+import type { RuntimeContextRetriever, RuntimeContextTrust } from "./types.js";
+export interface CreateMemoryRuntimeContextRetrieverOptions {
+    readonly store: MemoryItemStore;
+    readonly resolveContext: (input: Parameters<RuntimeContextRetriever>[0]) => MemoryStoreContext | Promise<MemoryStoreContext>;
+    readonly maxResults?: number;
+    readonly resolveTrust?: (item: MemoryItem) => RuntimeContextTrust | Promise<RuntimeContextTrust>;
+    readonly createUsageId?: () => string;
+    readonly now?: () => Date | string;
+    /** Usage telemetry is best-effort and never changes retrieval semantics. */
+    readonly onUsageError?: (error: unknown, event: MemoryUsageEvent) => void | Promise<void>;
+}
+export declare function createMemoryRuntimeContextRetriever(options: CreateMemoryRuntimeContextRetrieverOptions): RuntimeContextRetriever;
+//# sourceMappingURL=memory-retriever.d.ts.map

package/dist/runtime-context/memory-retriever.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-retriever.d.ts","sourceRoot":"","sources":["../../src/runtime-context/memory-retriever.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EACV,uBAAuB,EACvB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,0CAA0C;IACzD,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,CACvB,KAAK,EAAE,UAAU,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,KAC1C,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACtD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,CACtB,IAAI,EAAE,UAAU,KACb,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACxD,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,MAAM,CAAC;IACtC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,GAAG,MAAM,CAAC;IACnC,4EAA4E;IAC5E,QAAQ,CAAC,YAAY,CAAC,EAAE,CACtB,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,gBAAgB,KACpB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAoBD,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,0CAA0C,GAClD,uBAAuB,CA2DzB"}

package/dist/runtime-context/memory-retriever.js

@@ -0,0 +1,76 @@
+import { nanoid } from "nanoid";
+function operationTime(options) {
+    const value = options.now?.() ?? new Date();
+    const parsed = value instanceof Date ? value : new Date(value);
+    if (!Number.isFinite(parsed.getTime())) {
+        throw new Error("Memory retrieval time must be valid");
+    }
+    return parsed.toISOString();
+}
+function defaultTrust(item) {
+    return item.provenance.source === "explicit"
+        && item.provenance.actor === "user"
+        ? "user_provided"
+        : "untrusted";
+}
+export function createMemoryRuntimeContextRetriever(options) {
+    return async (input) => {
+        if (input.signal?.aborted) {
+            const error = new Error("Runtime context retrieval was aborted");
+            error.name = "AbortError";
+            throw error;
+        }
+        const context = await options.resolveContext(input);
+        const results = await options.store.search({
+            query: input.query,
+            tokenBudget: input.tokenBudget,
+            maxResults: options.maxResults ?? 20,
+        }, context);
+        const entries = await Promise.all(results.map(async (result) => ({
+            id: result.item.id,
+            content: result.item.content,
+            source: {
+                type: "memory",
+                id: result.item.id,
+                label: result.item.kind,
+                ...(result.item.provenance.sourceId
+                    ? { reference: result.item.provenance.sourceId }
+                    : {}),
+            },
+            timestamp: result.item.updatedAt,
+            trust: await (options.resolveTrust?.(result.item)
+                ?? defaultTrust(result.item)),
+            score: result.score,
+            estimatedTokens: result.estimatedTokens,
+        })));
+        const at = operationTime(options);
+        await Promise.all(results.map(async ({ item }) => {
+            const event = {
+                id: options.createUsageId?.() ?? `memory-usage-${nanoid(16)}`,
+                memoryId: item.id,
+                type: "retrieved",
+                at,
+                ...(input.runId ? { runId: input.runId } : {}),
+                ...(input.sessionId ? { sessionId: input.sessionId } : {}),
+                ...(input.requestId ? { requestId: input.requestId } : {}),
+            };
+            try {
+                await options.store.appendUsage(event, context);
+            }
+            catch (error) {
+                try {
+                    await options.onUsageError?.(error, event);
+                }
+                catch {
+                    // Observability must never change retrieval semantics.
+                }
+            }
+        }));
+        return {
+            segments: entries.length > 0
+                ? [{ kind: "memory", entries }]
+                : [],
+        };
+    };
+}
+//# sourceMappingURL=memory-retriever.js.map

package/dist/runtime-context/memory-retriever.js.map

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

package/dist/runtime-context/runtime-context.d.ts

@@ -0,0 +1,4 @@
+import type { ResolveRuntimeContextOptions, RuntimeContextProvider, RuntimeContextResolution, RuntimeContextRetrievalRequest } from "./types.js";
+export declare function resolveRuntimeContext(provider: RuntimeContextProvider | undefined, request: RuntimeContextRetrievalRequest, options?: ResolveRuntimeContextOptions): Promise<RuntimeContextResolution | undefined>;
+export declare function renderRuntimeContextPrompt(resolution: RuntimeContextResolution | undefined): string;
+//# sourceMappingURL=runtime-context.d.ts.map

package/dist/runtime-context/runtime-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-context.d.ts","sourceRoot":"","sources":["../../src/runtime-context/runtime-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,4BAA4B,EAG5B,sBAAsB,EACtB,wBAAwB,EAGxB,8BAA8B,EAK/B,MAAM,YAAY,CAAC;AA8VpB,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,sBAAsB,GAAG,SAAS,EAC5C,OAAO,EAAE,8BAA8B,EACvC,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,wBAAwB,GAAG,SAAS,CAAC,CA4B/C;AAED,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,wBAAwB,GAAG,SAAS,GAC/C,MAAM,CAOR"}