neotoma 0.7.0 → 0.9.0

package/README.md

@@ -23,6 +23,8 @@ Neotoma is a deterministic state layer for AI agents. It stores structured recor
 
 Not retrieval memory (RAG, vector search, semantic lookup). Neotoma enforces deterministic state evolution: same observations always produce the same entity state, regardless of when or in what order they are processed.
 
+The **Inspector** — Neotoma's visual control plane for browsing the entity graph, timeline, schema editor, and agent attribution — is bundled and served at `/inspector` by default when the server starts. No separate build or configuration required. Override with `NEOTOMA_INSPECTOR_DISABLE`, `NEOTOMA_PUBLIC_INSPECTOR_URL`, `NEOTOMA_INSPECTOR_STATIC_DIR`, or `NEOTOMA_INSPECTOR_BASE_PATH` (see `.env.example`).
+
 ## Architecture
 
 ```mermaid

package/dist/actions.d.ts

@@ -14,6 +14,80 @@ export declare const app: import("express-serve-static-core").Express;
  * X-Forwarded-For header — any caller can claim to be loopback.
  */
 export declare function isLocalRequest(req: express.Request): boolean;
+/**
+ * Derive the canonical `@authority` the AAuth profile requires (AAuth §10.3.1).
+ * We trust explicit configuration first, then fall back to the host the
+ * process is actually listening on. We must NOT trust `Host:` headers from
+ * the request path — an attacker could smuggle signatures authored against
+ * a different authority. See src/middleware/aauth_verify.ts.
+ */
+export declare function canonicalAauthAuthority(): string;
+export declare function storeStructuredForApi(params: {
+    userId: string;
+    entities: Record<string, unknown>[];
+    sourcePriority: number;
+    observationSource?: import("./shared/action_schemas.js").ObservationSource;
+    idempotencyKey: string;
+    originalFilename?: string;
+    relationships?: Array<{
+        relationship_type: string;
+        source_index: number;
+        target_index: number;
+    }>;
+    commit?: boolean;
+    strict?: boolean;
+}): Promise<{
+    success: boolean;
+    replayed: boolean;
+    source_id: any;
+    entities_created: number;
+    observations_created: number;
+    entities: {
+        entity_id: string;
+        entity_type: string;
+        observation_id: string;
+    }[];
+} | {
+    warnings?: {
+        code: string;
+        policy: string;
+        observation_index: number;
+        entity_type: string;
+        entity_id: string;
+        identity_basis: string;
+        identity_rule: string;
+    }[] | undefined;
+    success: boolean;
+    replayed: boolean;
+    commit: boolean;
+    source_id: string | null;
+    entities_created: number;
+    observations_created: number;
+    entities: {
+        entity_id: string;
+        entity_type: string;
+        observation_id: string | null;
+        observation_index: number;
+        action: "created" | "matched_existing" | "would_create" | "would_match_existing" | "extended";
+        canonical_name: string;
+        resolver_path: string[];
+        identity_basis: string;
+        identity_rule: string;
+        warnings?: {
+            code: string;
+            policy: string;
+            entity_type: string;
+            identity_basis: string;
+            identity_rule: string;
+        }[] | undefined;
+        entity_snapshot_after: Record<string, unknown> | null;
+    }[];
+    relationships_created: {
+        relationship_type: string;
+        source_entity_id: string;
+        target_entity_id: string;
+    }[];
+}>;
 export declare function startHTTPServer(): Promise<{
     server: import("http").Server<typeof import("http").IncomingMessage, typeof import("http").ServerResponse>;
     port: number;

package/dist/actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AA0I9B,eAAO,MAAM,GAAG,6CAAY,CAAC;AAgY7B;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,GAAG,OAAO,CAU5D;AA2hMD,wBAAsB,eAAe;;;eAkDpC"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAiK9B,eAAO,MAAM,GAAG,6CAAY,CAAC;AAif7B;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,GAAG,OAAO,CAU5D;AA4PD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAmBhD;AA6nHD,wBAAsB,qBAAqB,CAAC,MAAM,EAAE;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,OAAO,4BAA4B,EAAE,iBAAiB,CAAC;IAC3E,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,KAAK,CAAC;QACpB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;;;;;;;;;;;;;cAkfS,MAAM;gBACJ,MAAM;2BACK,MAAM;qBACZ,MAAM;mBACR,MAAM;wBACD,MAAM;uBACP,MAAM;;;;;;;;;mBA9IV,MAAM;qBACJ,MAAM;wBACH,MAAM,GAAG,IAAI;2BACV,MAAM;;wBAET,MAAM;uBACP,MAAM,EAAE;wBACP,MAAM;uBACP,MAAM;;kBA9NX,MAAM;oBACJ,MAAM;yBACD,MAAM;4BACH,MAAM;2BACP,MAAM;;+BA4NF,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;;;2BAkFlC,MAAM;0BACP,MAAM;0BACN,MAAM;;GA8E3B;AA29DD,wBAAsB,eAAe;;;eA2FpC"}