@ivotoby/postgram-cli 1.25.0 → 1.28.1

package/README.md

@@ -63,6 +63,41 @@ pgm queue
 pgm store "hello" --json
 ```
 
+## Memory Roles
+
+Store durable memory:
+
+```bash
+pgm store "Ivo prefers client-scoped session context in Postgram." \
+  --type memory \
+  --visibility personal \
+  --metadata '{"memory_role":"durable_memory"}'
+```
+
+Store session context:
+
+```bash
+pgm memory session-context "We are discussing Postgram memory lifecycle roles." \
+  --visibility personal \
+  --topic postgram-memory \
+  --agent-id codex \
+  --tags session-context
+```
+
+Search session context:
+
+```bash
+pgm search "Postgram memory lifecycle roles" \
+  --type memory \
+  --memory-role session_context \
+  --visibility personal
+```
+
+Use durable memory for stable facts, decisions, constraints, and preferences.
+Use session context for recent-thread continuity. Session context is embedded
+for semantic recall, scoped to the calling client when the server knows its
+`client_id`, and skipped by graph extraction.
+
 ## Claude Code skill
 
 A portable Claude Code skill for using `pgm` from your agent lives in

package/dist/client.js

@@ -43,6 +43,12 @@ export function createPgmClient(options) {
                 body: input
             });
         },
+        storeSessionContext(input) {
+            return request(options, '/api/memory/session-context', {
+                method: 'POST',
+                body: input
+            });
+        },
         recallEntity(id, input = {}) {
             const params = new URLSearchParams();
             if (input.owner) {

package/dist/pgm.js

@@ -208,6 +208,7 @@ program
     .option('--tags <tags>', 'comma-separated tags')
     .option('--source <source>', 'entity source')
     .option('--metadata <json>', 'JSON metadata object')
+    .option('--skip-extraction', 'store without ever queueing graph extraction')
     .action(async (content, options, command) => {
     await runWithClient(command, async (client, json) => {
         const body = await client.storeEntity({
@@ -218,7 +219,8 @@ program
             status: options.status,
             tags: parseCommaList(options.tags),
             source: options.source,
-            metadata: parseJsonObject(options.metadata)
+            metadata: parseJsonObject(options.metadata),
+            skip_extraction: options.skipExtraction === true ? true : undefined
         });
         return json
             ? body
@@ -246,8 +248,14 @@ program
     .option('--recency-weight <recencyWeight>', 'recency weight', '0.1')
     .option('--expand-graph', 'include graph-connected entities in results')
     .option('--include-archived', 'include archived entities in results')
+    .option('--memory-role <role>', 'memory role filter: durable_memory or session_context')
+    .option('--include-other-clients-session-context', 'include session context from other clients')
     .action(async (query, options, command) => {
     await runWithClient(command, async (client, json) => {
+        if (options.memoryRole !== undefined &&
+            !['durable_memory', 'session_context'].includes(options.memoryRole)) {
+            throw new AppError(ErrorCode.VALIDATION, '--memory-role must be durable_memory or session_context');
+        }
         const body = await client.searchEntities({
             query,
             type: options.type,
@@ -258,11 +266,57 @@ program
             threshold: Number(options.threshold),
             recency_weight: Number(options.recencyWeight),
             expand_graph: options.expandGraph === true ? true : undefined,
-            include_archived: options.includeArchived === true ? true : undefined
+            include_archived: options.includeArchived === true ? true : undefined,
+            memory_role: options.memoryRole,
+            include_other_clients_session_context: options.includeOtherClientsSessionContext === true ? true : undefined
         });
         return json ? body : formatSearchResults(body.results);
     });
 });
+const memoryCommand = program
+    .command('memory')
+    .description('Memory-specific commands');
+memoryCommand
+    .command('session-context')
+    .alias('session')
+    .description('Store client-scoped session-context memory')
+    .argument('[content]', 'session context content')
+    .option('--visibility <visibility>', 'entity visibility', 'shared')
+    .option('--owner <owner>', 'entity owner or namespace')
+    .option('--session-id <sessionId>', 'external session or thread id')
+    .option('--agent-id <agentId>', 'agent or persona id')
+    .option('--topic <topic>', 'topic label')
+    .option('--tags <tags>', 'comma-separated tags')
+    .option('--promotable', 'mark this session context as promotable')
+    .option('--groom-after <groomAfter>', 'ISO timestamp after which grooming may archive/promote it')
+    .option('--expires-at <expiresAt>', 'ISO timestamp after which the context is stale')
+    .action(async (content, options, command) => {
+    await runWithClient(command, async (client, json) => {
+        const body = await client.storeSessionContext({
+            content: await resolveStoreContent(content),
+            visibility: options.visibility,
+            owner: options.owner,
+            session_id: options.sessionId,
+            agent_id: options.agentId,
+            topic: options.topic,
+            tags: parseCommaList(options.tags),
+            promotable: options.promotable === true ? true : undefined,
+            groom_after: options.groomAfter,
+            expires_at: options.expiresAt
+        });
+        return json
+            ? body
+            : formatStoredEntity({
+                id: body.entity.id,
+                type: body.entity.type,
+                content: body.entity.content,
+                status: body.entity.status,
+                visibility: body.entity.visibility,
+                owner: body.entity.owner,
+                tags: body.entity.tags
+            });
+    });
+});
 program
     .command('recall')
     .description('Recall an entity by ID')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ivotoby/postgram-cli",
-  "version": "1.25.0",
+  "version": "1.28.1",
   "description": "Postgram CLI — store, search, and manage entities from the command line",
   "type": "module",
   "bin": {
@@ -28,7 +28,8 @@
     "embeddings"
   ],
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "provenance": true
   },
   "scripts": {
     "build": "tsc -p tsconfig.build.json",
@@ -46,10 +47,9 @@
     "@eslint/js": "^9.38.0",
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/commit-analyzer": "^13.0.1",
-    "@semantic-release/exec": "^7.1.0",
     "@semantic-release/git": "^10.0.1",
     "@semantic-release/github": "^11.0.6",
-    "@semantic-release/npm": "^12.0.2",
+    "@semantic-release/npm": "^13.1.5",
     "@semantic-release/release-notes-generator": "^14.1.0",
     "conventional-changelog-conventionalcommits": "^9.3.1",
     "eslint": "^9.38.0",