shieldcortex 3.0.4 → 3.2.0

package/dist/tools/recall.d.ts

@@ -20,10 +20,10 @@ export declare const recallSchema: z.ZodObject<{
         type: z.ZodEnum<["user", "cli", "hook", "email", "web", "agent", "file", "api", "tool_response"]>;
         identifier: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        type: "api" | "user" | "cli" | "hook" | "email" | "web" | "agent" | "file" | "tool_response";
+        type: "user" | "cli" | "hook" | "agent" | "api" | "email" | "web" | "file" | "tool_response";
         identifier: string;
     }, {
-        type: "api" | "user" | "cli" | "hook" | "email" | "web" | "agent" | "file" | "tool_response";
+        type: "user" | "cli" | "hook" | "agent" | "api" | "email" | "web" | "file" | "tool_response";
         identifier: string;
     }>>;
 }, "strip", z.ZodTypeAny, {
@@ -32,26 +32,26 @@ export declare const recallSchema: z.ZodObject<{
     includeDecayed: boolean;
     includeGlobal: boolean;
     source?: {
-        type: "api" | "user" | "cli" | "hook" | "email" | "web" | "agent" | "file" | "tool_response";
+        type: "user" | "cli" | "hook" | "agent" | "api" | "email" | "web" | "file" | "tool_response";
         identifier: string;
     } | undefined;
     project?: string | undefined;
     type?: "short_term" | "long_term" | "episodic" | undefined;
-    query?: string | undefined;
     category?: "architecture" | "pattern" | "preference" | "error" | "context" | "learning" | "todo" | "note" | "relationship" | "custom" | undefined;
     tags?: string[] | undefined;
+    query?: string | undefined;
 }, {
     source?: {
-        type: "api" | "user" | "cli" | "hook" | "email" | "web" | "agent" | "file" | "tool_response";
+        type: "user" | "cli" | "hook" | "agent" | "api" | "email" | "web" | "file" | "tool_response";
         identifier: string;
     } | undefined;
     project?: string | undefined;
     mode?: "search" | "important" | "recent" | undefined;
     type?: "short_term" | "long_term" | "episodic" | undefined;
-    limit?: number | undefined;
-    query?: string | undefined;
     category?: "architecture" | "pattern" | "preference" | "error" | "context" | "learning" | "todo" | "note" | "relationship" | "custom" | undefined;
     tags?: string[] | undefined;
+    limit?: number | undefined;
+    query?: string | undefined;
     includeDecayed?: boolean | undefined;
     includeGlobal?: boolean | undefined;
 }>;
@@ -87,22 +87,22 @@ export declare const getMemorySchema: z.ZodObject<{
         type: z.ZodEnum<["user", "cli", "hook", "email", "web", "agent", "file", "api", "tool_response"]>;
         identifier: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        type: "api" | "user" | "cli" | "hook" | "email" | "web" | "agent" | "file" | "tool_response";
+        type: "user" | "cli" | "hook" | "agent" | "api" | "email" | "web" | "file" | "tool_response";
         identifier: string;
     }, {
-        type: "api" | "user" | "cli" | "hook" | "email" | "web" | "agent" | "file" | "tool_response";
+        type: "user" | "cli" | "hook" | "agent" | "api" | "email" | "web" | "file" | "tool_response";
         identifier: string;
     }>>;
 }, "strip", z.ZodTypeAny, {
     id: number;
     source?: {
-        type: "api" | "user" | "cli" | "hook" | "email" | "web" | "agent" | "file" | "tool_response";
+        type: "user" | "cli" | "hook" | "agent" | "api" | "email" | "web" | "file" | "tool_response";
         identifier: string;
     } | undefined;
 }, {
     id: number;
     source?: {
-        type: "api" | "user" | "cli" | "hook" | "email" | "web" | "agent" | "file" | "tool_response";
+        type: "user" | "cli" | "hook" | "agent" | "api" | "email" | "web" | "file" | "tool_response";
         identifier: string;
     } | undefined;
 }>;

package/dist/tools/remember.d.ts

@@ -19,40 +19,55 @@ export declare const rememberSchema: z.ZodObject<{
         type: z.ZodEnum<["user", "cli", "hook", "email", "web", "agent", "file", "api", "tool_response"]>;
         identifier: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        type: "api" | "user" | "cli" | "hook" | "email" | "web" | "agent" | "file" | "tool_response";
+        type: "user" | "cli" | "hook" | "agent" | "api" | "email" | "web" | "file" | "tool_response";
         identifier: string;
     }, {
-        type: "api" | "user" | "cli" | "hook" | "email" | "web" | "agent" | "file" | "tool_response";
+        type: "user" | "cli" | "hook" | "agent" | "api" | "email" | "web" | "file" | "tool_response";
         identifier: string;
     }>>;
+    sourceType: z.ZodOptional<z.ZodEnum<["user", "cli", "hook", "email", "web", "agent", "file", "api", "tool_response"]>>;
+    sourceIdentifier: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    agentId: z.ZodOptional<z.ZodString>;
+    workspaceDir: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     title: string;
     content: string;
     scope?: "project" | "global" | undefined;
     transferable?: boolean | undefined;
     source?: {
-        type: "api" | "user" | "cli" | "hook" | "email" | "web" | "agent" | "file" | "tool_response";
+        type: "user" | "cli" | "hook" | "agent" | "api" | "email" | "web" | "file" | "tool_response";
         identifier: string;
     } | undefined;
     project?: string | undefined;
     type?: "short_term" | "long_term" | "episodic" | undefined;
     category?: "architecture" | "pattern" | "preference" | "error" | "context" | "learning" | "todo" | "note" | "relationship" | "custom" | undefined;
     tags?: string[] | undefined;
+    sourceIdentifier?: string | undefined;
+    sessionId?: string | undefined;
     importance?: "critical" | "low" | "high" | "normal" | undefined;
+    sourceType?: "user" | "cli" | "hook" | "agent" | "api" | "email" | "web" | "file" | "tool_response" | undefined;
+    agentId?: string | undefined;
+    workspaceDir?: string | undefined;
 }, {
     title: string;
     content: string;
     scope?: "project" | "global" | undefined;
     transferable?: boolean | undefined;
     source?: {
-        type: "api" | "user" | "cli" | "hook" | "email" | "web" | "agent" | "file" | "tool_response";
+        type: "user" | "cli" | "hook" | "agent" | "api" | "email" | "web" | "file" | "tool_response";
         identifier: string;
     } | undefined;
     project?: string | undefined;
     type?: "short_term" | "long_term" | "episodic" | undefined;
     category?: "architecture" | "pattern" | "preference" | "error" | "context" | "learning" | "todo" | "note" | "relationship" | "custom" | undefined;
     tags?: string[] | undefined;
+    sourceIdentifier?: string | undefined;
+    sessionId?: string | undefined;
     importance?: "critical" | "low" | "high" | "normal" | undefined;
+    sourceType?: "user" | "cli" | "hook" | "agent" | "api" | "email" | "web" | "file" | "tool_response" | undefined;
+    agentId?: string | undefined;
+    workspaceDir?: string | undefined;
 }>;
 export type RememberInput = z.infer<typeof rememberSchema>;
 /**

package/dist/tools/remember.js

@@ -30,6 +30,13 @@ export const rememberSchema = z.object({
         type: z.enum(['user', 'cli', 'hook', 'email', 'web', 'agent', 'file', 'api', 'tool_response']),
         identifier: z.string(),
     }).optional().describe('Source of this memory for trust scoring (agents should pass this)'),
+    sourceType: z.enum(['user', 'cli', 'hook', 'email', 'web', 'agent', 'file', 'api', 'tool_response']).optional()
+        .describe('Flat source type for integrations that cannot pass nested objects'),
+    sourceIdentifier: z.string().optional()
+        .describe('Flat source identifier for integrations that cannot pass nested objects'),
+    sessionId: z.string().optional().describe('Optional integration session identifier'),
+    agentId: z.string().optional().describe('Optional integration agent identifier'),
+    workspaceDir: z.string().optional().describe('Optional workspace/source path'),
 });
 /**
  * Execute the remember tool
@@ -53,6 +60,14 @@ export async function executeRemember(input) {
         }
         // Resolve project (auto-detect if not provided)
         const resolvedProject = resolveProject(input.project);
+        const derivedSource = input.source ?? (input.sourceType && input.sourceIdentifier
+            ? { type: input.sourceType, identifier: input.sourceIdentifier }
+            : undefined);
+        const metadata = {
+            ...(input.sessionId ? { sessionId: input.sessionId } : {}),
+            ...(input.agentId ? { agentId: input.agentId } : {}),
+            ...(input.workspaceDir ? { workspaceDir: input.workspaceDir } : {}),
+        };
         // Map importance to salience override
         let salienceOverride;
         if (input.importance) {
@@ -96,7 +111,8 @@ export async function executeRemember(input) {
             salience: salienceOverride,
             scope: input.scope,
             transferable: input.transferable,
-        }, undefined, input.source ?? { type: 'cli', identifier: 'mcp' });
+            metadata: Object.keys(metadata).length > 0 ? metadata : undefined,
+        }, undefined, derivedSource ?? { type: 'cli', identifier: 'mcp' });
         // Auto-detect and create relationships with existing memories
         let linksCreated = 0;
         try {

package/hooks/openclaw/cortex-memory/handler.ts

@@ -400,6 +400,9 @@ async function onSessionEnd(event) {
       scope: "global",
       importance: "high",
       tags: "auto-extracted,openclaw-hook",
+      sourceType: "hook",
+      sourceIdentifier: "openclaw-session-end",
+      workspaceDir: context.workspaceDir || "",
     });
     if (result) {
       saved++;
@@ -468,6 +471,9 @@ async function onSessionStop(event) {
       scope: "global",
       importance: "high",
       tags: "auto-extracted,openclaw-hook,session-stop",
+      sourceType: "hook",
+      sourceIdentifier: "openclaw-session-stop",
+      workspaceDir: context.workspaceDir || "",
     });
     if (result) {
       saved++;
@@ -611,6 +617,8 @@ async function checkAndSaveKeywordTrigger(messageText, event) {
     scope: "global",
     importance: matchedTrigger.importance,
     tags: `keyword-trigger,openclaw-hook,trigger:${matchedTrigger.phrase.replace(/\s+/g, "-")}`,
+    sourceType: "hook",
+    sourceIdentifier: `openclaw-keyword:${matchedTrigger.phrase.replace(/\s+/g, "-")}`,
   });
 
   if (result) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shieldcortex",
-  "version": "3.0.4",
+  "version": "3.2.0",
   "description": "Persistent brain for AI agents. Knowledge graphs, memory decay, contradiction detection, Iron Dome behaviour protection — plus the only defence pipeline that stops memory poisoning. Works with Claude Code, OpenClaw, LangChain, and any MCP agent.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",