ds4-context-core 0.1.0

package/dist/manifest/observer.d.ts

@@ -0,0 +1,63 @@
+import type { ContextBudget } from "../core/budget-manager.ts";
+import type { ModelProfile } from "../core/model-profile.ts";
+import type { ArtifactManifestRef, ContextManifest, ContextManifestItem, ContextManifestItemKind, ContextManifestPlanning, MemoryManifestRef, ModelAwarenessManifest, PinManifestRef, PrivacyManifest, ProjectRevision, ProjectSnippetRef } from "./context-manifest.ts";
+export interface ObservedTool {
+    name: string;
+    description: string;
+    parameters: unknown;
+    source?: string;
+    classification?: ContextManifestItem["classification"];
+    privacyReason?: string;
+}
+export interface ObservedMessageSource {
+    sourceId?: string;
+    role?: string;
+    groupId?: string;
+    kind?: ContextManifestItemKind;
+    score?: number;
+    classification?: ContextManifestItem["classification"];
+    privacyReason?: string;
+    mappingReason: string;
+    selectionReason?: string;
+}
+export interface ExcludedContextSource {
+    sourceId?: string;
+    role?: string;
+    groupId?: string;
+    tokens: number;
+    kind: ContextManifestItemKind;
+    score?: number;
+    classification?: ContextManifestItem["classification"];
+    reason: string;
+}
+export interface ObserverManifestInput {
+    id: string;
+    sessionId: string;
+    branchLeafId?: string;
+    profile: ModelProfile;
+    budget: ContextBudget;
+    systemPrompt: string;
+    systemClassification?: ContextManifestItem["classification"];
+    systemPrivacyReason?: string;
+    tools: readonly ObservedTool[];
+    messages: readonly unknown[];
+    messageSources: readonly ObservedMessageSource[];
+    excludedSources: readonly ExcludedContextSource[];
+    summaryIds: readonly string[];
+    retrievedEventIds?: readonly string[];
+    projectSnippets?: readonly ProjectSnippetRef[];
+    projectRevision?: ProjectRevision;
+    pins?: readonly PinManifestRef[];
+    memories?: readonly MemoryManifestRef[];
+    artifacts?: readonly ArtifactManifestRef[];
+    privacy?: PrivacyManifest;
+    modelAwareness?: ModelAwarenessManifest;
+    planning?: ContextManifestPlanning;
+    piReportedContextTokens?: number;
+    policyVersion: string;
+    plannerVersion: string;
+    createdAt: number;
+}
+export declare function estimateObservedToolTokens(tool: ObservedTool): number;
+export declare function buildObserverManifest(input: ObserverManifestInput): ContextManifest;
+//# sourceMappingURL=observer.d.ts.map

package/dist/manifest/observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observer.d.ts","sourceRoot":"","sources":["../../src/manifest/observer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAI7D,OAAO,KAAK,EACV,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,uBAAuB,EACvB,uBAAuB,EACvB,iBAAiB,EACjB,sBAAsB,EACtB,cAAc,EACd,eAAe,EACf,eAAe,EACf,iBAAiB,EAClB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;IACvD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,uBAAuB,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;IACvD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,uBAAuB,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;IACvD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,aAAa,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,CAAC,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;IAC7D,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IAC/B,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IAC7B,cAAc,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACjD,eAAe,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAClD,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,eAAe,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC/C,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,IAAI,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IACjC,QAAQ,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACxC,SAAS,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC3C,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,cAAc,CAAC,EAAE,sBAAsB,CAAC;IACxC,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IACnC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAaD,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAMrE;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,qBAAqB,GAAG,eAAe,CAkInF"}

package/dist/manifest/observer.js

@@ -0,0 +1,150 @@
+import { estimateMessageTokens, estimateTextTokens } from "../core/token-estimator.js";
+import { sha256 } from "../shared/hash.js";
+import { stableStringify } from "../shared/stable-json.js";
+function messageRole(message) {
+    if (!message || typeof message !== "object" || !("role" in message))
+        return undefined;
+    return typeof message.role === "string" ? message.role : undefined;
+}
+function messageKind(role, isCurrentUser) {
+    if (isCurrentUser)
+        return "current";
+    if (role === "compactionSummary" || role === "branchSummary")
+        return "summary";
+    return "recent";
+}
+export function estimateObservedToolTokens(tool) {
+    return estimateTextTokens(stableStringify({
+        name: tool.name,
+        description: tool.description,
+        parameters: tool.parameters,
+    })) + 12;
+}
+export function buildObserverManifest(input) {
+    const included = [];
+    const systemTokens = estimateTextTokens(input.systemPrompt) + (input.systemPrompt ? 8 : 0);
+    if (input.systemPrompt) {
+        included.push({
+            kind: "system",
+            sourceId: "pi:system-prompt",
+            tokens: systemTokens,
+            ...(input.systemClassification ? { classification: input.systemClassification } : {}),
+            reason: input.systemPrivacyReason
+                ? `Pi effective system prompt; ${input.systemPrivacyReason}`
+                : "Pi effective system prompt",
+        });
+    }
+    let toolsTotal = 0;
+    for (const tool of input.tools) {
+        const tokens = estimateObservedToolTokens(tool);
+        toolsTotal += tokens;
+        included.push({
+            kind: "tool",
+            sourceId: `tool:${tool.name}`,
+            tokens,
+            ...(tool.classification ? { classification: tool.classification } : {}),
+            reason: [
+                tool.source ? `Active Pi tool from ${tool.source}` : "Active Pi tool definition",
+                tool.privacyReason,
+            ].filter(Boolean).join("; "),
+        });
+    }
+    let lastUserIndex = -1;
+    for (let index = 0; index < input.messages.length; index++) {
+        if (messageRole(input.messages[index]) === "user")
+            lastUserIndex = index;
+    }
+    let messageTokens = 0;
+    for (let index = 0; index < input.messages.length; index++) {
+        const message = input.messages[index];
+        const source = input.messageSources[index];
+        const role = messageRole(message) ?? source?.role;
+        const tokens = estimateMessageTokens(message);
+        messageTokens += tokens;
+        included.push({
+            kind: source?.kind ?? messageKind(role, index === lastUserIndex),
+            ...(source?.sourceId ? { sourceId: source.sourceId } : {}),
+            ...(role ? { role } : {}),
+            ...(source?.groupId ? { groupId: source.groupId } : {}),
+            tokens,
+            ...(source?.score !== undefined ? { score: source.score } : {}),
+            ...(source?.classification ? { classification: source.classification } : {}),
+            reason: [source?.selectionReason
+                    ? `${source.selectionReason}; provenance: ${source.mappingReason}`
+                    : source?.mappingReason ?? "Transient Pi context message without a session source",
+                source?.privacyReason,
+            ].filter(Boolean).join("; "),
+        });
+    }
+    const promptHash = sha256(stableStringify({
+        systemPrompt: input.systemPrompt,
+        tools: input.tools,
+        messages: input.messages,
+    }));
+    const estimatedInputTokens = systemTokens + toolsTotal + messageTokens;
+    return {
+        schemaVersion: 1,
+        id: input.id,
+        sessionId: input.sessionId,
+        ...(input.branchLeafId ? { branchLeafId: input.branchLeafId } : {}),
+        provider: input.profile.provider,
+        model: input.profile.modelId,
+        contextWindow: input.profile.contextWindow,
+        outputReserve: input.budget.outputReserve,
+        hardInputLimit: input.budget.hardInputLimit,
+        targetInputTokens: input.budget.activeInputBudget,
+        estimatedInputTokens,
+        ...(input.piReportedContextTokens !== undefined
+            ? { piReportedContextTokens: input.piReportedContextTokens }
+            : {}),
+        included,
+        excluded: input.excludedSources.map((source) => ({ ...source })),
+        summaryIds: [...input.summaryIds],
+        retrievedEventIds: [...new Set(input.retrievedEventIds ?? [])],
+        projectSnippets: (input.projectSnippets ?? []).map((snippet) => ({ ...snippet })),
+        ...(input.projectRevision ? {
+            projectRevision: {
+                ...input.projectRevision,
+                changedFiles: [...input.projectRevision.changedFiles],
+            },
+        } : {}),
+        pins: (input.pins ?? []).map((pin) => ({ ...pin })),
+        memories: (input.memories ?? []).map((memory) => ({
+            ...memory,
+            sourceEntryIds: [...memory.sourceEntryIds],
+        })),
+        artifacts: (input.artifacts ?? []).map((artifact) => ({ ...artifact })),
+        ...(input.privacy ? {
+            privacy: {
+                ...input.privacy,
+                allowedClassifications: [...input.privacy.allowedClassifications],
+                selectedClassifications: { ...input.privacy.selectedClassifications },
+            },
+        } : {}),
+        ...(input.modelAwareness ? {
+            modelAwareness: {
+                ...input.modelAwareness,
+                overrideKeys: [...input.modelAwareness.overrideKeys],
+                calibration: {
+                    ...input.modelAwareness.calibration,
+                    cache: { ...input.modelAwareness.calibration.cache },
+                },
+                adaptive: { ...input.modelAwareness.adaptive },
+                ...(input.modelAwareness.switch ? { switch: { ...input.modelAwareness.switch } } : {}),
+            },
+        } : {}),
+        composition: {
+            systemTokens,
+            toolTokens: toolsTotal,
+            messageTokens,
+            messageCount: input.messages.length,
+            toolCount: input.tools.length,
+        },
+        ...(input.planning ? { planning: { ...input.planning } } : {}),
+        policyVersion: input.policyVersion,
+        plannerVersion: input.plannerVersion,
+        promptHash,
+        createdAt: input.createdAt,
+    };
+}
+//# sourceMappingURL=observer.js.map

package/dist/manifest/observer.js.map

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

package/dist/memory/memory-manager.d.ts

@@ -0,0 +1,112 @@
+import type { MemoryConfig } from "../config/config.ts";
+import type { MemoryManifestRef, PinManifestRef } from "../manifest/context-manifest.ts";
+import type { MemoryRepository } from "../persistence/repositories/memory-repository.ts";
+import type { PrivacyClassification } from "../privacy/privacy-policy.ts";
+import { type MemoryItem, type MemoryMaterializationResult, type MemoryMutation, type MemoryScope, type PinItem, type PinMutation, type PinScope, type SessionMutationProjection } from "./memory-types.ts";
+interface ContextMessage {
+    role: "user";
+    content: string;
+    timestamp: number;
+}
+export interface PinEvidence {
+    item: PinItem;
+    message: ContextMessage;
+    estimatedTokens: number;
+    reason: string;
+    manifestRef: PinManifestRef;
+}
+export interface MemoryEvidence {
+    item: MemoryItem;
+    message: ContextMessage;
+    estimatedTokens: number;
+    score: number;
+    reason: string;
+    manifestRef: MemoryManifestRef;
+}
+export interface MemorySelection {
+    pins: PinEvidence[];
+    memories: MemoryEvidence[];
+    excludedPins: number;
+    excludedMemories: number;
+    pinTokens: number;
+    memoryTokens: number;
+}
+export interface MemoryDiagnostics {
+    enabled: boolean;
+    status: "ready" | "disabled" | "failed";
+    activeMemories: number;
+    inactiveMemories: number;
+    activePins: number;
+    inactivePins: number;
+    selectedPins: PinManifestRef[];
+    selectedMemories: MemoryManifestRef[];
+    excludedPins: number;
+    excludedMemories: number;
+    selectedPinTokens: number;
+    selectedMemoryTokens: number;
+    lastMaterialization?: MemoryMaterializationResult;
+    warnings: string[];
+}
+export interface MutationProposal<T> {
+    mutation?: T;
+    duplicateId?: string;
+}
+export declare class MemoryConflictError extends Error {
+    readonly conflictingIds: readonly string[];
+    constructor(conflictingIds: readonly string[]);
+}
+export declare function normalizeMemoryKey(value: string): string;
+export declare function deriveMemoryKey(claim: string): string | undefined;
+export declare class MemoryManager {
+    private readonly repository;
+    private readonly config;
+    private readonly maxPinnedTokens;
+    private readonly maxMemoryTokens;
+    private readonly sessionId;
+    private readonly projectPath;
+    private readonly projectTrusted;
+    private readonly now;
+    private readonly idGenerator;
+    private lastMaterialization?;
+    private lastSelection;
+    private warnings;
+    constructor(repository: MemoryRepository, config: MemoryConfig, maxPinnedTokens: number, maxMemoryTokens: number, sessionId: string, projectPath: string, projectTrusted: boolean, now: () => number, idGenerator: () => string);
+    reconcile(projection: SessionMutationProjection): MemoryMaterializationResult;
+    proposePin(input: {
+        content: string;
+        scope: PinScope;
+        branchLeafId?: string;
+        sourceEntryId?: string;
+        sourceFile?: string;
+        supersedes?: string;
+        classification?: PrivacyClassification;
+        activeEntryIds: ReadonlySet<string>;
+    }): MutationProposal<PinMutation>;
+    proposeUnpin(pinId: string, reason?: string): PinMutation;
+    proposeMemory(input: {
+        claim: string;
+        scope: MemoryScope;
+        key?: string;
+        classification?: PrivacyClassification;
+        sourceEntryIds: readonly string[];
+        activeEntryIds: ReadonlySet<string>;
+    }): MutationProposal<MemoryMutation>;
+    proposeMemorySupersession(input: {
+        previousId: string;
+        claim: string;
+        classification?: PrivacyClassification;
+        sourceEntryIds: readonly string[];
+        activeEntryIds: ReadonlySet<string>;
+    }): MemoryMutation;
+    proposeMemoryStatus(memoryId: string, status: "invalid" | "expired", reason?: string): MemoryMutation;
+    select(requestText: string, activeEntryIds: ReadonlySet<string>): MemorySelection;
+    getPin(id: string): PinItem | undefined;
+    getMemory(id: string): MemoryItem | undefined;
+    applyPlannerSelection(pinIds: ReadonlySet<string>, memoryIds: ReadonlySet<string>): void;
+    listPins(activeOnly?: boolean): PinItem[];
+    listMemories(activeOnly?: boolean): MemoryItem[];
+    diagnostics(): MemoryDiagnostics;
+}
+export declare function disabledMemoryDiagnostics(reason?: string): MemoryDiagnostics;
+export {};
+//# sourceMappingURL=memory-manager.d.ts.map

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

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