@isparling/engram-harness 0.1.0 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@isparling/engram-harness",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "private": false,
   "type": "module",
   "license": "Apache-2.0",
@@ -11,11 +11,15 @@
     },
     "./knowledge-types": {
       "import": "./src/knowledgeTypes.ts"
+    },
+    "./capture-types": {
+      "import": "./src/captureTypes.ts"
     }
   },
   "files": [
     "src/packTypes.ts",
     "src/knowledgeTypes.ts",
+    "src/captureTypes.ts",
     "README.md"
   ],
   "publishConfig": {

package/src/captureTypes.ts

@@ -0,0 +1,31 @@
+// Public host-capture DTOs shared between the OMP adapter and external packs.
+// JSON-safe by construction: these shapes cross process boundaries verbatim,
+// so they deliberately carry no functions, classes, or host handles.
+
+import type { JsonObject, KnowledgeError, KnowledgeRecord } from "./knowledgeTypes.ts";
+
+export type CaptureMutationView = {
+  recordId: string;
+  action: "create" | "update";
+  beforeHash: string | null;
+  after: KnowledgeRecord;
+};
+
+export type HostCapturePreview =
+  | { schemaVersion: 0; status: "ready"; planHash: string; mutations: CaptureMutationView[] }
+  | { schemaVersion: 0; status: "blocked"; errors: KnowledgeError[] };
+
+export type HostCaptureApply = {
+  schemaVersion: 0;
+  status: "committed" | "no-change" | "stale" | "failed";
+  planHash: string;
+  mutations: CaptureMutationView[];
+  index: "fresh" | "stale" | "not-attempted";
+  errors: string[];
+};
+
+export type ArtifactReplacementResult = { status: "replaced" | "unchanged"; path: string };
+
+export type CompletionRequest = { model: string; prompt: string; system: string; timeoutSeconds: number };
+
+export type CaptureChangeSetInput = JsonObject;

package/src/knowledgeTypes.ts

@@ -121,11 +121,19 @@ export type PackReconciliation = {
   mutations: PackMutation[];
 };
 
+export type RelatedRecordSelection =
+  | { mode: "search"; query: string }
+  | {
+      mode: "exact";
+      description: string;
+      matches: (record: KnowledgeRecord) => boolean;
+    };
+
 export type KnowledgePack = {
   id: string;
   version: string;
   validateEnvelope: (envelope: KnowledgeEnvelope) => KnowledgeResult<void>;
-  relatedQuery: (envelope: KnowledgeEnvelope) => string;
+  selectRelatedRecords: (envelope: KnowledgeEnvelope) => RelatedRecordSelection;
   reconcile: (input: PackReconcileInput) => KnowledgeResult<PackReconciliation>;
 };