cognia-sdk 0.1.7 → 0.2.0

package/README.md

@@ -94,3 +94,16 @@ unverified reports listed apart.
 **Credits.** Reporting on other owners' knowledge earns Cloud credits (verified outcomes most, used receipts a little,
 context calls that injected a little), and your own memories earn when an independent agent's verified success lands on
 them. Credits pay for Workbench messages beyond your plan. They are not money. `GET /v1/cloud/me/credits` lists them.
+
+## Namespaces: one key, many end users (0.2.0)
+
+If you build an app where many people each have their own agent, give each of them a namespace:
+
+```ts
+const cognia = new Cognia({ apiKey: process.env.COGNIA_API_KEY, namespace: `user:${userId}` });
+```
+
+Every context call then carries that namespace. A private memory saved under it is returned only to the same
+namespace: the `mine` scope never crosses from one of your users to another, and the `organization` and `network`
+scopes add only what is shared with your organizations or public. Omit the namespace for a single-agent integration.
+Your own Cognia Cloud still shows everything the key owns: you are the data controller for your users' memories.

package/dist/cjs/client.js

@@ -62,7 +62,9 @@ class Cognia {
     tokenProvider;
     f;
     onError;
+    namespace;
     constructor(o) {
+        this.namespace = o.namespace;
         if (!o.apiKey && !o.tokenProvider)
             throw new Error("Cognia: apiKey or tokenProvider is required");
         this.key = o.apiKey ?? null;
@@ -166,7 +168,8 @@ class Cognia {
      */
     async context(req) {
         const body = typeof req === "string" ? { task: req } : req;
-        const payload = { task: body.task, scope: body.scope ?? this.scope, ...(body.budget ?? this.budget ? { budget: { ...this.budget, ...body.budget } } : {}), ...(body.session ? { session: body.session } : {}) };
+        const ns = body.identity?.namespace ?? this.namespace;
+        const payload = { task: body.task, scope: body.scope ?? this.scope, ...(body.budget ?? this.budget ? { budget: { ...this.budget, ...body.budget } } : {}), ...(body.session ? { session: body.session } : {}), ...(ns ? { identity: { namespace: ns } } : {}) };
         try {
             const r = await this.call("POST", "/v1/context", payload, this.timeoutMs);
             const shaped = shapeContext(r);

package/dist/esm/client.d.ts

@@ -1,5 +1,8 @@
 import type { ReceiptResponse, ContextRequest, ContextResponse, ContextResult, OutcomeInput, OutcomeResponse, ExtractResponse, Scope } from "./types.js";
 export interface CogniaOptions {
+    /** end-user namespace sent on every context call (0.2.0). Use one per end user of YOUR app: their private memories
+     *  are then invisible to every other namespace under the same key. Omit for a single-agent integration. */
+    namespace?: string;
     /** the agent's credential (cognia_sk_…, a developer or SDK credential); never logged, never put in a URL */
     apiKey?: string;
     /** Delegated auth: called at REQUEST time to obtain the bearer (e.g. an MCP OAuth access token the host already
@@ -39,6 +42,7 @@ export declare class Cognia {
     private readonly tokenProvider;
     private readonly f;
     private readonly onError;
+    readonly namespace: string | undefined;
     constructor(o: CogniaOptions);
     /** Every string that reaches the host through an error or a reason has the bearer removed first (independent E2E F28). */
     private scrub;

package/dist/esm/client.js

@@ -57,7 +57,9 @@ export class Cognia {
     tokenProvider;
     f;
     onError;
+    namespace;
     constructor(o) {
+        this.namespace = o.namespace;
         if (!o.apiKey && !o.tokenProvider)
             throw new Error("Cognia: apiKey or tokenProvider is required");
         this.key = o.apiKey ?? null;
@@ -161,7 +163,8 @@ export class Cognia {
      */
     async context(req) {
         const body = typeof req === "string" ? { task: req } : req;
-        const payload = { task: body.task, scope: body.scope ?? this.scope, ...(body.budget ?? this.budget ? { budget: { ...this.budget, ...body.budget } } : {}), ...(body.session ? { session: body.session } : {}) };
+        const ns = body.identity?.namespace ?? this.namespace;
+        const payload = { task: body.task, scope: body.scope ?? this.scope, ...(body.budget ?? this.budget ? { budget: { ...this.budget, ...body.budget } } : {}), ...(body.session ? { session: body.session } : {}), ...(ns ? { identity: { namespace: ns } } : {}) };
         try {
             const r = await this.call("POST", "/v1/context", payload, this.timeoutMs);
             const shaped = shapeContext(r);

package/dist/esm/types.d.ts

@@ -12,6 +12,10 @@ export interface ContextRequest {
         id: string;
         turn: number;
     };
+    /** end-user namespace (0.2.0): one developer key, many end users; private memories are isolated per namespace */
+    identity?: {
+        namespace?: string;
+    };
 }
 export interface MemoryItem {
     kind: "memory";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cognia-sdk",
-  "version": "0.1.7",
+  "version": "0.2.0",
   "description": "Cognia for your model calls: one line gives any agent the Memories and Skills it may use, with provenance and honest receipts. Fails open.",
   "license": "MIT",
   "author": "Cognia",