@remnic/core 9.65.6 → 9.65.8

package/src/access-mcp.ts

@@ -45,7 +45,7 @@ import { applyToolOutputSchemas } from "./access-mcp-output-schemas.js";
 import { MCP_READ_ONLY_TOOL_SUFFIXES } from "./mcp-read-only-tools.js";
 import { MEETINGS_MCP_TOOLS } from "./meetings/mcp-tools.js";
 import { WEARABLES_MCP_TOOLS } from "./wearables/mcp-tools.js";
-import { WHO_KNOWS_MCP_TOOLS } from "./who-knows.js";
+import { WHO_KNOWS_MCP_TOOLS } from "./who-knows.js"; import { LOCATION_MCP_TOOLS } from "./location/mcp-tools.js";
 import { PROMOTION_CANDIDATES_MCP_TOOLS } from "./memory-subject.js";
 import { EXTERNAL_WIKI_MCP_TOOLS } from "./external-wiki-mcp-tools.js";
 import { abortError, isAbortError } from "./abort-error.js";
@@ -188,10 +188,10 @@ export const MCP_MIGRATED_OPERATIONS: Readonly<Record<string, OperationName>> =
   "engram.recall_explain": "recall_explain",
   "engram.set_coding_context": "set_coding_context", "engram.recall_tier_explain": "recall_tier_explain",
   "engram.recall_xray": "recall_xray", "engram.who_knows": "who_knows", "engram.promotion_candidates": "promotion_candidates",
-  "engram.wearables_status": "wearables_status",
-  "engram.wearables_sync": "wearables_sync",
-  "engram.transcript_day": "transcript_day",
-  "engram.transcript_search": "transcript_search",
+  "engram.wearables_status": "wearables_status", "engram.wearables_sync": "wearables_sync",
+  "engram.location_status": "location_status", "engram.location_check": "location_check", "engram.location_sync": "location_sync",
+  "engram.location_backfill": "location_backfill", "engram.location_day": "location_day",
+  "engram.transcript_day": "transcript_day", "engram.transcript_search": "transcript_search",
   "engram.transcript_memories": "transcript_memories", "engram.meetings_list": "meetings_list", "engram.meetings_get": "meetings_get", "engram.meetings_build": "meetings_build",
   "engram.action_confidence": "action_confidence",
   "engram.chatgpt_memory_inspector": "chatgpt_memory_inspector",
@@ -706,7 +706,7 @@ export class EngramMcpServer {
           additionalProperties: false,
         },
       },
-      ...WEARABLES_MCP_TOOLS, ...MEETINGS_MCP_TOOLS, ...WHO_KNOWS_MCP_TOOLS, ...PROMOTION_CANDIDATES_MCP_TOOLS,
+      ...WEARABLES_MCP_TOOLS, ...MEETINGS_MCP_TOOLS, ...WHO_KNOWS_MCP_TOOLS, ...PROMOTION_CANDIDATES_MCP_TOOLS, ...LOCATION_MCP_TOOLS,
       ...(service.supportPassportEnabled ? SUPPORT_PASSPORT_MCP_TOOLS : []),
       {
         name: "engram.action_confidence",

package/src/access-operations.ts

@@ -693,6 +693,8 @@ import "./access-operations-batch.js";
 import "./support-passport/access-operations.js";
 // Remnic Relay mission evidence operations (issue #1966).
 import "./relay/mission-access.js";
+// Location sync surfaces (issue #2047).
+import "./location/access-operations.js";
 
 export const REGISTERED_OPERATIONS = [
   memoryGetOperation.spec.name,

package/src/access-surface-catalog.ts

@@ -63,6 +63,11 @@ export const MCP_TOOLS: readonly McpToolEntry[] = [
   { tool: "transcript_day", operation: "transcript_day" },
   { tool: "transcript_search", operation: "transcript_search" },
   { tool: "transcript_memories", operation: "transcript_memories" },
+  { tool: "location_status", operation: "location_status" },
+  { tool: "location_check", operation: "location_check" },
+  { tool: "location_sync", operation: "location_sync" },
+  { tool: "location_backfill", operation: "location_backfill" },
+  { tool: "location_day", operation: "location_day" },
   { tool: "meetings_list", operation: "meetings_list" },
   { tool: "meetings_get", operation: "meetings_get" },
   { tool: "meetings_build", operation: "meetings_build" },
@@ -221,6 +226,11 @@ export const HTTP_ROUTES: readonly HttpRouteEntry[] = [
   { method: "GET", pathname: "/engram/v1/wearables/transcript", operation: "transcript_day" },
   { method: "GET", pathname: "/engram/v1/wearables/transcripts/search", operation: "transcript_search" },
   { method: "GET", pathname: "/engram/v1/wearables/memories", operation: "transcript_memories" },
+  { method: "GET", pathname: "/engram/v1/location/status", operation: "location_status" },
+  { method: "GET", pathname: "/engram/v1/location/check", operation: "location_check" },
+  { method: "POST", pathname: "/engram/v1/location/sync", operation: "location_sync" },
+  { method: "POST", pathname: "/engram/v1/location/backfill", operation: "location_backfill" },
+  { method: "GET", pathname: "/engram/v1/location/day", operation: "location_day" },
   { method: "GET", pathname: "/engram/v1/meetings", operation: "meetings_list" },
   { method: "POST", pathname: "/engram/v1/meetings/build", operation: "meetings_build" },
   { method: "GET", pathname: "/engram/v1/meetings/:id", operation: "meetings_get" },

package/src/active-context-config.ts

@@ -0,0 +1,98 @@
+import { coerceBooleanLike, coerceNumber } from "./connectors/coerce.js";
+
+export interface ActiveContextConfigFields {
+  activeContextTransformLlmEnabled: boolean;
+  activeContextMaxMessages: number;
+  activeContextMaxSnapshotChars: number;
+  activeContextSummaryMaxTokens: number;
+  activeContextMinRetainedMessages: number;
+  activeContextPlanTtlMinutes: number;
+  activeContextRetentionMaxBytes: number;
+}
+
+export interface ActiveContextCapabilitySet {
+  readonly activeContextTransforms: boolean;
+  readonly activeContextMaxMessages: number;
+  readonly activeContextMaxSnapshotChars: number;
+  readonly activeContextSummaryMaxTokens: number;
+  readonly activeContextMinRetainedMessages: number;
+  readonly activeContextPlanTtlMinutes: number;
+  readonly activeContextRetentionMaxBytes: number;
+  readonly activeContextLlm: boolean;
+}
+
+export const DEFAULT_ACTIVE_CONTEXT_CAPS: Readonly<
+  Omit<ActiveContextCapabilitySet, "activeContextTransforms" | "activeContextLlm">
+> = Object.freeze({
+  activeContextMaxMessages: 200,
+  activeContextMaxSnapshotChars: 200_000,
+  activeContextSummaryMaxTokens: 512,
+  activeContextMinRetainedMessages: 3,
+  activeContextPlanTtlMinutes: 15,
+  activeContextRetentionMaxBytes: 1_000_000,
+});
+
+export type ActiveContextConfigProjection = ActiveContextConfigFields & {
+  contextCompressionActionsEnabled: boolean;
+};
+
+export function resolveActiveContextCapabilities(
+  projection: ActiveContextConfigProjection,
+): ActiveContextCapabilitySet {
+  return Object.freeze({
+    activeContextTransforms: projection.contextCompressionActionsEnabled,
+    activeContextMaxMessages: projection.activeContextMaxMessages,
+    activeContextMaxSnapshotChars: projection.activeContextMaxSnapshotChars,
+    activeContextSummaryMaxTokens: projection.activeContextSummaryMaxTokens,
+    activeContextMinRetainedMessages: projection.activeContextMinRetainedMessages,
+    activeContextPlanTtlMinutes: projection.activeContextPlanTtlMinutes,
+    activeContextRetentionMaxBytes: projection.activeContextRetentionMaxBytes,
+    activeContextLlm: projection.activeContextTransformLlmEnabled,
+  });
+}
+
+function activeContextCap(raw: unknown, key: string, fallback: number, hardCap: number): number {
+  if (raw === undefined || raw === null) return fallback;
+  const value = coerceNumber(raw, key);
+  if (value === undefined || value <= 0 || value > hardCap) {
+    throw new Error(`${key} must be a finite number in (0, ${hardCap}]; got ${JSON.stringify(raw)}`);
+  }
+  return Math.floor(value);
+}
+
+export function parseActiveContextFields(cfg: Record<string, unknown>): ActiveContextConfigFields {
+  return {
+    activeContextTransformLlmEnabled: coerceBooleanLike(cfg.activeContextTransformLlmEnabled) ?? false,
+    activeContextMaxMessages: activeContextCap(cfg.activeContextMaxMessages, "activeContextMaxMessages", 200, 1000),
+    activeContextMaxSnapshotChars: activeContextCap(
+      cfg.activeContextMaxSnapshotChars,
+      "activeContextMaxSnapshotChars",
+      200_000,
+      1_000_000,
+    ),
+    activeContextSummaryMaxTokens: activeContextCap(
+      cfg.activeContextSummaryMaxTokens,
+      "activeContextSummaryMaxTokens",
+      512,
+      4096,
+    ),
+    activeContextMinRetainedMessages: activeContextCap(
+      cfg.activeContextMinRetainedMessages,
+      "activeContextMinRetainedMessages",
+      3,
+      50,
+    ),
+    activeContextPlanTtlMinutes: activeContextCap(
+      cfg.activeContextPlanTtlMinutes,
+      "activeContextPlanTtlMinutes",
+      15,
+      1440,
+    ),
+    activeContextRetentionMaxBytes: activeContextCap(
+      cfg.activeContextRetentionMaxBytes,
+      "activeContextRetentionMaxBytes",
+      1_000_000,
+      10_000_000,
+    ),
+  };
+}