@securecoms/agent-bridge 0.8.0 → 0.10.0

package/dist/memory/openclaw-provider.d.ts

@@ -1,5 +1,9 @@
 import type { MemoryProvider } from "./provider.js";
 import type { SqliteMlsStateStore, MemoryRecordInput, MemoryContextResult } from "@agentvault/connect-mls-store";
+export interface OpenClawFactsOptions {
+    workspaceDir?: string;
+    factsCharBudget?: number;
+}
 /**
  * MemoryProvider for an OpenClaw-hosted agent (Cortina). context() merges
  * OpenClaw's own text history (read-only, plain session .jsonl) with the
@@ -12,9 +16,14 @@ export declare class OpenClawMemoryProvider implements MemoryProvider {
     private readonly store;
     private readonly baseDir;
     private readonly agent;
+    private readonly factsOpts?;
     private noSession;
     private readFailed;
-    constructor(store: SqliteMlsStateStore, baseDir: string, agent: string);
+    private factsMissing;
+    private factsReadFailed;
+    private factsTruncated;
+    private factsChars;
+    constructor(store: SqliteMlsStateStore, baseDir: string, agent: string, factsOpts?: OpenClawFactsOptions | undefined);
     record(input: MemoryRecordInput): Promise<{
         seq: number;
         deduped: boolean;

package/dist/memory/openclaw-workspace-facts.d.ts

@@ -0,0 +1,38 @@
+/** Spec D2 constants — pinned so tests are deterministic. "Chars" = UTF-16 code units. */
+export declare const DEFAULT_FACTS_BUDGET = 8000;
+export declare const MEMORY_MD_CAP = 6000;
+export declare const MIN_FRAGMENT = 200;
+export declare const MAX_SOURCE_BYTES: number;
+/**
+ * Resolve the agent's OpenClaw workspace dir (spec D4). Ladder, first hit wins:
+ *  1. explicit override (credential workspace_dir) — operator beats everything;
+ *  2. openclaw.json, resolved the way OpenClaw itself would:
+ *     2a. agents.list entry with id===agent and a NON-EMPTY string workspace (verbatim,
+ *         never case-transformed — the live config declares "workspace-cortina" for an
+ *         on-disk "workspace-Cortina" and works only because APFS is case-insensitive);
+ *     2b. else agents.defaults.workspace when it is a non-empty string (covers main,
+ *         whose live entry has the workspace key ABSENT, and named agents w/o one);
+ *  3. derivation, LAST resort (openclaw.json missing/malformed/silent):
+ *     main/"" → <base>/workspace, else <base>/workspace-<agent> verbatim.
+ * Empty agent is treated as "main" throughout (the factory passes agent ?? "").
+ * Total: always returns a path; existence is checked at read time, fail-safe.
+ */
+export declare function resolveWorkspaceDir(baseDir: string, agent: string, override?: string): string;
+export interface WorkspaceFactsResult {
+    /** 0..3 provenance-prefixed facts: MEMORY.md first, then dailies newest-first. */
+    facts: string[];
+    /** True when the budget clipped or dropped any source (includes the >1MB skip). */
+    truncated: boolean;
+    /** True when the resolved workspace yielded zero usable sources. False on budget-0 kill switch. */
+    missing: boolean;
+}
+/**
+ * Read the workspace facts (spec D1-D3). READ-ONLY, total: never throws for any
+ * filesystem state — absence degrades to fewer/zero facts. Only MEMORY.md and
+ * memory/\d{4}-\d{2}-\d{2}\.md under the resolved dir are ever opened.
+ * Budget accounting is content-only; prefixes and markers are exempt (audit M2).
+ */
+export declare function readWorkspaceFacts(baseDir: string, agent: string, opts?: {
+    workspaceDir?: string;
+    charBudget?: number;
+}): WorkspaceFactsResult;

package/dist/memory/provider.d.ts

@@ -1,4 +1,5 @@
 import type { SqliteMlsStateStore, MemoryRecordInput, MemoryContextResult } from "@agentvault/connect-mls-store";
+import type { OpenClawFactsOptions } from "./openclaw-provider.js";
 export interface MemoryProvider {
     record(input: MemoryRecordInput): Promise<{
         seq: number;
@@ -26,4 +27,4 @@ export declare class NullMemory implements MemoryProvider {
     }>;
     context(): Promise<MemoryContextResult>;
 }
-export declare function createMemoryProvider(provider: "securecoms" | "none" | "hermes" | "openclaw", store: SqliteMlsStateStore, baseDir?: string, agent?: string): MemoryProvider;
+export declare function createMemoryProvider(provider: "securecoms" | "none" | "hermes" | "openclaw", store: SqliteMlsStateStore, baseDir?: string, agent?: string, openclawFacts?: OpenClawFactsOptions): MemoryProvider;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@securecoms/agent-bridge",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",