@pyxmate/memory 1.23.2 → 1.24.0

package/dist/dashboard.mjs

@@ -11,10 +11,10 @@ import {
   toGraphologyFormat,
   transformGraphData,
   unreachableHealth
-} from "./chunk-7YHCNO3N.mjs";
-import "./chunk-SGL73IY5.mjs";
+} from "./chunk-L2RHO7DP.mjs";
+import "./chunk-LF22PCY6.mjs";
 import "./chunk-KZKGRND2.mjs";
-import "./chunk-C46EE5BH.mjs";
+import "./chunk-VXXRCAKS.mjs";
 export {
   DashboardClient,
   Poller,

package/dist/{data-plane-contract-C5VqxrpF.d.ts → data-plane-contract-CGU0qjv4.d.ts}

@@ -14,6 +14,87 @@ declare const DATA_PLANE_COMPILER_LIMITS: {
     readonly graphEntities: 1000;
     readonly graphRelationships: 2000;
 };
+/**
+ * Hosted file ingest protocol v1 (docs/specs/hosted-file-ingest/spec.md). The
+ * tenant enforces these absolute caps; the gateway enforces per-plan caps.
+ */
+declare const HOSTED_FILE_INGEST_PROTOCOL: {
+    readonly version: 1;
+    readonly capability: "hosted-file-ingest-v1";
+    readonly capabilityHeader: "X-Pyx-Gateway-Capabilities";
+    readonly uploadTokenHeader: "X-Pyx-Upload-Token";
+    readonly metaKey: "pyx.dev/hosted-file-ingest";
+    readonly routeBase: "/api/memory/file-ingests";
+    readonly preparationVersion: "pyx-file-prepare-v1";
+};
+declare const HOSTED_FILE_INGEST_LIMITS: {
+    readonly maxFileBytes: number;
+    readonly maxFilenameBytes: 255;
+    readonly maxExtractedUtf8Bytes: number;
+    readonly maxChunks: 4096;
+    readonly maxChunkUtf8Bytes: number;
+    readonly maxPageEntries: 50;
+    readonly maxPageEmbeddingUtf8Bytes: number;
+    readonly maxPageCanonicalBytes: number;
+    readonly maxManifestCanonicalBytes: number;
+    readonly uploadTokenTtlMs: number;
+    readonly prepareTimeoutMs: number;
+    readonly jobTtlMs: number;
+};
+declare const HOSTED_FILE_INGEST_JOB_STATES: readonly ["awaiting_upload", "uploaded", "prepared", "published", "failed", "cancelled", "expired"];
+type HostedFileIngestJobState = (typeof HOSTED_FILE_INGEST_JOB_STATES)[number];
+interface HostedFileIngestPageDescriptor {
+    pageIndex: number;
+    firstChunkIndex: number;
+    chunkCount: number;
+    pageSha256: string;
+    embeddingInputSha256: string;
+    embeddingUnicodeScalars: number;
+    embeddingUtf8Bytes: number;
+}
+interface HostedFileIngestManifest {
+    manifestSha256: string;
+    preparationVersion: string;
+    entryCount: number;
+    pageCount: number;
+    extractedUtf8Bytes: number;
+    embeddingUnicodeScalars: number;
+    pages: HostedFileIngestPageDescriptor[];
+}
+interface HostedFileIngestJobView {
+    jobId: string;
+    state: HostedFileIngestJobState;
+    filename: string;
+    byteLength: number;
+    sha256: string;
+    expiresAt: string;
+    upload?: {
+        token: string;
+        expiresAt: string;
+    };
+    manifest?: HostedFileIngestManifest;
+    committedPages?: number[];
+    publication?: HostedFileIngestPublication;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+interface HostedFileIngestPublication {
+    entryCount: number;
+    retiredCount: number;
+    fileId: string;
+}
+interface HostedFileIngestCommitResult {
+    jobId: string;
+    pageIndex: number;
+    state: 'committed';
+    alreadyCommitted: boolean;
+}
+interface HostedFileIngestPublishResult extends HostedFileIngestPublication {
+    jobId: string;
+    state: 'published';
+}
 declare const SENSITIVITY_LEVELS: readonly ["public", "internal", "secret"];
 declare const PRINCIPAL_KINDS: readonly ["api_key", "user"];
 declare const TENANT_MODES: readonly ["single", "multi"];
@@ -117,6 +198,18 @@ declare const DATA_PLANE_OPERATION_COVERAGE: {
     readonly 'rest:batch_store': {
         readonly support: "journal_multi_step";
     };
+    readonly 'rest:file_ingest_begin': {
+        readonly support: "journal_multi_step";
+    };
+    readonly 'rest:file_ingest_prepare': {
+        readonly support: "journal_multi_step";
+    };
+    readonly 'rest:file_ingest_commit': {
+        readonly support: "journal_multi_step";
+    };
+    readonly 'rest:file_ingest_publish': {
+        readonly support: "journal_multi_step";
+    };
     readonly 'rest:get': {
         readonly support: "sqlite_atomic_one_step";
     };
@@ -243,6 +336,9 @@ declare function parseListCursorToken(token: string): {
     createdAt: string;
     id: string;
 };
+/** The document key of a hosted file: a bare filename, never a path. */
+declare function requireHostedFileIngestFilename(value: unknown, field: string): string;
+declare function normalizeHostedFileIngestPageDescriptor(input: unknown, field: string): HostedFileIngestPageDescriptor;
 declare function canonicalDataPlaneJson(value: unknown): string;
 declare function hashDataPlaneStepInputV1(value: unknown): {
     canonicalJson: string;
@@ -258,5 +354,29 @@ declare function hashDataPlaneManifestV1(value: unknown): {
  */
 declare function hashDataPlaneHttpResponseV1(statusCode: number, contentType: string, body: Uint8Array): string;
 declare function compileDataPlaneRequest(request: CompileDataPlaneRequest): CompileDataPlaneResult;
+/** Strict parse of a tenant job view (begin/prepare responses, proxy + gateway). */
+declare function parseHostedFileIngestJobView(input: unknown): HostedFileIngestJobView;
+declare function parseHostedFileIngestCommitResult(input: unknown): HostedFileIngestCommitResult;
+declare function parseHostedFileIngestPublishResult(input: unknown): HostedFileIngestPublishResult;
+declare const HOSTED_FILE_INGEST_GATEWAY_STATES: readonly ["active", "limit_exceeded", "quota_paused", "published", "failed", "cancel_requested", "cancelled", "expired"];
+type HostedFileIngestGatewayState = (typeof HOSTED_FILE_INGEST_GATEWAY_STATES)[number];
+/** Error codes a client may retry after `Retry-After`; every other failure is surfaced. */
+declare const HOSTED_FILE_INGEST_RETRYABLE_CODES: readonly ["prepare_in_progress", "page_commit_in_progress", "publish_in_progress"];
+/**
+ * The gateway's free `authorize` view of one job. Money is in microcents
+ * (1 cent = 1,000,000, the gateway wallet unit), as decimal strings.
+ */
+interface HostedFileIngestAuthorization {
+    jobId: string;
+    state: HostedFileIngestGatewayState;
+    allocated: boolean;
+    revision: number;
+    ceilingMicrocents: string | null;
+    estimateMicrocents: string | null;
+    settledMicrocents: string;
+    outstandingMicrocents: string;
+    authorized: boolean;
+}
+declare function parseHostedFileIngestAuthorization(input: unknown): HostedFileIngestAuthorization;
 
-export { type CanonicalDataPlaneObject as C, DATA_PLANE_CATALOG_VERSION as D, type SupportedDataPlaneCatalogOperation as S, type CanonicalDataPlaneValue as a, type CompileContext as b, type CompileDataPlaneRequest as c, type CompileDataPlaneResult as d, encodeListCursorToken as e, type CompiledDataPlaneExecutionPlan as f, DATA_PLANE_COMPILER_LIMITS as g, DATA_PLANE_CONTRACT_VERSION as h, DATA_PLANE_HTTP_RESPONSE_FRAME as i, DATA_PLANE_MANIFEST_FRAME as j, DATA_PLANE_MANIFEST_VERSION as k, DATA_PLANE_OPERATION_COVERAGE as l, DATA_PLANE_SEARCH_EMBEDDING_CONTRACT as m, DATA_PLANE_STEP_INPUT_FRAME as n, type DataPlaneCatalogOperation as o, parseListCursorToken as p, type DataPlaneUnsupportedReasonCode as q, canonicalDataPlaneJson as r, compileDataPlaneRequest as s, hashDataPlaneHttpResponseV1 as t, hashDataPlaneManifestV1 as u, hashDataPlaneStepInputV1 as v };
+export { type HostedFileIngestManifest as A, type HostedFileIngestPageDescriptor as B, type CanonicalDataPlaneObject as C, DATA_PLANE_CATALOG_VERSION as D, type HostedFileIngestPublishResult as E, canonicalDataPlaneJson as F, compileDataPlaneRequest as G, HOSTED_FILE_INGEST_GATEWAY_STATES as H, hashDataPlaneHttpResponseV1 as I, hashDataPlaneManifestV1 as J, hashDataPlaneStepInputV1 as K, normalizeHostedFileIngestPageDescriptor as L, parseHostedFileIngestAuthorization as M, parseHostedFileIngestCommitResult as N, parseHostedFileIngestJobView as O, parseHostedFileIngestPublishResult as P, requireHostedFileIngestFilename as Q, type SupportedDataPlaneCatalogOperation as S, type CanonicalDataPlaneValue as a, type CompileContext as b, type CompileDataPlaneRequest as c, type CompileDataPlaneResult as d, encodeListCursorToken as e, type CompiledDataPlaneExecutionPlan as f, DATA_PLANE_COMPILER_LIMITS as g, DATA_PLANE_CONTRACT_VERSION as h, DATA_PLANE_HTTP_RESPONSE_FRAME as i, DATA_PLANE_MANIFEST_FRAME as j, DATA_PLANE_MANIFEST_VERSION as k, DATA_PLANE_OPERATION_COVERAGE as l, DATA_PLANE_SEARCH_EMBEDDING_CONTRACT as m, DATA_PLANE_STEP_INPUT_FRAME as n, type DataPlaneCatalogOperation as o, parseListCursorToken as p, type DataPlaneUnsupportedReasonCode as q, HOSTED_FILE_INGEST_JOB_STATES as r, HOSTED_FILE_INGEST_LIMITS as s, HOSTED_FILE_INGEST_PROTOCOL as t, HOSTED_FILE_INGEST_RETRYABLE_CODES as u, type HostedFileIngestAuthorization as v, type HostedFileIngestCommitResult as w, type HostedFileIngestGatewayState as x, type HostedFileIngestJobState as y, type HostedFileIngestJobView as z };

package/dist/data-plane-contract.d.ts

@@ -1 +1 @@
-export { C as CanonicalDataPlaneObject, a as CanonicalDataPlaneValue, b as CompileContext, c as CompileDataPlaneRequest, d as CompileDataPlaneResult, f as CompiledDataPlaneExecutionPlan, D as DATA_PLANE_CATALOG_VERSION, g as DATA_PLANE_COMPILER_LIMITS, h as DATA_PLANE_CONTRACT_VERSION, i as DATA_PLANE_HTTP_RESPONSE_FRAME, j as DATA_PLANE_MANIFEST_FRAME, k as DATA_PLANE_MANIFEST_VERSION, l as DATA_PLANE_OPERATION_COVERAGE, m as DATA_PLANE_SEARCH_EMBEDDING_CONTRACT, n as DATA_PLANE_STEP_INPUT_FRAME, o as DataPlaneCatalogOperation, q as DataPlaneUnsupportedReasonCode, S as SupportedDataPlaneCatalogOperation, r as canonicalDataPlaneJson, s as compileDataPlaneRequest, t as hashDataPlaneHttpResponseV1, u as hashDataPlaneManifestV1, v as hashDataPlaneStepInputV1 } from './data-plane-contract-C5VqxrpF.js';
+export { C as CanonicalDataPlaneObject, a as CanonicalDataPlaneValue, b as CompileContext, c as CompileDataPlaneRequest, d as CompileDataPlaneResult, f as CompiledDataPlaneExecutionPlan, D as DATA_PLANE_CATALOG_VERSION, g as DATA_PLANE_COMPILER_LIMITS, h as DATA_PLANE_CONTRACT_VERSION, i as DATA_PLANE_HTTP_RESPONSE_FRAME, j as DATA_PLANE_MANIFEST_FRAME, k as DATA_PLANE_MANIFEST_VERSION, l as DATA_PLANE_OPERATION_COVERAGE, m as DATA_PLANE_SEARCH_EMBEDDING_CONTRACT, n as DATA_PLANE_STEP_INPUT_FRAME, o as DataPlaneCatalogOperation, q as DataPlaneUnsupportedReasonCode, H as HOSTED_FILE_INGEST_GATEWAY_STATES, r as HOSTED_FILE_INGEST_JOB_STATES, s as HOSTED_FILE_INGEST_LIMITS, t as HOSTED_FILE_INGEST_PROTOCOL, u as HOSTED_FILE_INGEST_RETRYABLE_CODES, v as HostedFileIngestAuthorization, w as HostedFileIngestCommitResult, x as HostedFileIngestGatewayState, y as HostedFileIngestJobState, z as HostedFileIngestJobView, A as HostedFileIngestManifest, B as HostedFileIngestPageDescriptor, E as HostedFileIngestPublishResult, S as SupportedDataPlaneCatalogOperation, F as canonicalDataPlaneJson, G as compileDataPlaneRequest, I as hashDataPlaneHttpResponseV1, J as hashDataPlaneManifestV1, K as hashDataPlaneStepInputV1, L as normalizeHostedFileIngestPageDescriptor, M as parseHostedFileIngestAuthorization, N as parseHostedFileIngestCommitResult, O as parseHostedFileIngestJobView, P as parseHostedFileIngestPublishResult, Q as requireHostedFileIngestFilename } from './data-plane-contract-CGU0qjv4.js';

package/dist/data-plane-contract.mjs

@@ -1,3 +1,4 @@
+import "./chunk-6EEEOV6B.mjs";
 import {
   DATA_PLANE_CATALOG_VERSION,
   DATA_PLANE_COMPILER_LIMITS,
@@ -8,12 +9,23 @@ import {
   DATA_PLANE_OPERATION_COVERAGE,
   DATA_PLANE_SEARCH_EMBEDDING_CONTRACT,
   DATA_PLANE_STEP_INPUT_FRAME,
+  HOSTED_FILE_INGEST_GATEWAY_STATES,
+  HOSTED_FILE_INGEST_JOB_STATES,
+  HOSTED_FILE_INGEST_LIMITS,
+  HOSTED_FILE_INGEST_PROTOCOL,
+  HOSTED_FILE_INGEST_RETRYABLE_CODES,
   canonicalDataPlaneJson,
   compileDataPlaneRequest,
   hashDataPlaneHttpResponseV1,
   hashDataPlaneManifestV1,
-  hashDataPlaneStepInputV1
-} from "./chunk-C46EE5BH.mjs";
+  hashDataPlaneStepInputV1,
+  normalizeHostedFileIngestPageDescriptor,
+  parseHostedFileIngestAuthorization,
+  parseHostedFileIngestCommitResult,
+  parseHostedFileIngestJobView,
+  parseHostedFileIngestPublishResult,
+  requireHostedFileIngestFilename
+} from "./chunk-VXXRCAKS.mjs";
 export {
   DATA_PLANE_CATALOG_VERSION,
   DATA_PLANE_COMPILER_LIMITS,
@@ -24,9 +36,20 @@ export {
   DATA_PLANE_OPERATION_COVERAGE,
   DATA_PLANE_SEARCH_EMBEDDING_CONTRACT,
   DATA_PLANE_STEP_INPUT_FRAME,
+  HOSTED_FILE_INGEST_GATEWAY_STATES,
+  HOSTED_FILE_INGEST_JOB_STATES,
+  HOSTED_FILE_INGEST_LIMITS,
+  HOSTED_FILE_INGEST_PROTOCOL,
+  HOSTED_FILE_INGEST_RETRYABLE_CODES,
   canonicalDataPlaneJson,
   compileDataPlaneRequest,
   hashDataPlaneHttpResponseV1,
   hashDataPlaneManifestV1,
-  hashDataPlaneStepInputV1
+  hashDataPlaneStepInputV1,
+  normalizeHostedFileIngestPageDescriptor,
+  parseHostedFileIngestAuthorization,
+  parseHostedFileIngestCommitResult,
+  parseHostedFileIngestJobView,
+  parseHostedFileIngestPublishResult,
+  requireHostedFileIngestFilename
 };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { StoreInput as StoreInput$1, MemoryEntry as MemoryEntry$1, MemorySearchParams as MemorySearchParams$1, MemorySearchResult as MemorySearchResult$1, MemoryType as MemoryType$1, PrincipalContext as PrincipalContext$1, SensitivityLevel as SensitivityLevel$1, MemoryStats as MemoryStats$1, MemoryInsights as MemoryInsights$1, LineageParams as LineageParams$1, LineageResult as LineageResult$1, ReinforceParams as ReinforceParams$1, ReinforceResult as ReinforceResult$1, WikiLintReport as WikiLintReport$1, GraphRepairResult as GraphRepairResult$1, ExtractedImageMeta as ExtractedImageMeta$1, IngestEntity as IngestEntity$1, IngestRelationship as IngestRelationship$1, EntityExtractionResult as EntityExtractionResult$1, Topology as Topology$1, IngestEvent as IngestEvent$1, GraphEnrichEvent as GraphEnrichEvent$1, GraphNode as GraphNode$1, GraphTraversalResult as GraphTraversalResult$1, CorrectionRecord as CorrectionRecord$1 } from '@pyx-memory/shared';
 export { documentContentSource, documentGraphSource, documentImageSource } from '@pyx-memory/shared';
-export { e as encodeListCursorToken, p as parseListCursorToken } from './data-plane-contract-C5VqxrpF.js';
+export { e as encodeListCursorToken, p as parseListCursorToken } from './data-plane-contract-CGU0qjv4.js';
 
 /** ISO 8601 timestamp string */
 type Timestamp = string;

package/dist/index.mjs

@@ -2,7 +2,7 @@ import {
   DisabledMemory,
   MemoryClient,
   MemoryServerError
-} from "./chunk-SGL73IY5.mjs";
+} from "./chunk-LF22PCY6.mjs";
 import {
   DEFAULTS,
   MEMORY_PROJECT_LABEL_MAX_CHARS,
@@ -37,7 +37,7 @@ import {
   normalizeGraphLabel,
   normalizeNameKey,
   parseListCursorToken
-} from "./chunk-C46EE5BH.mjs";
+} from "./chunk-VXXRCAKS.mjs";
 
 // src/preset.ts
 var DEFAULT_MEMORY_URL = `http://localhost:${DEFAULTS.MEMORY_SERVER_PORT}`;

package/dist/react.mjs

@@ -11,10 +11,10 @@ import {
   toGraphologyFormat,
   transformGraphData,
   unreachableHealth
-} from "./chunk-7YHCNO3N.mjs";
-import "./chunk-SGL73IY5.mjs";
+} from "./chunk-L2RHO7DP.mjs";
+import "./chunk-LF22PCY6.mjs";
 import "./chunk-KZKGRND2.mjs";
-import "./chunk-C46EE5BH.mjs";
+import "./chunk-VXXRCAKS.mjs";
 
 // ../dashboard/src/hooks/use-consolidation-log.ts
 import { useCallback as useCallback2, useMemo } from "react";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pyxmate/memory",
-  "version": "1.23.2",
+  "version": "1.24.0",
   "type": "module",
   "description": "SDK for pyx-memory — Memory as a Service for AI agents",
   "license": "MIT",