cognia-sdk 0.2.1 → 0.2.2

package/README.md

@@ -91,6 +91,10 @@ A verified success needs a signal (a test, a check, a metric) or a human. Inject
 counts as success. Your Cognia Cloud Overview shows the loop per week: turns with context → cited → used → verified, with
 unverified reports listed apart.
 
+**Router decision values** (`x-cognia-decision`): `INJECT`, `ABSTAIN`, `unavailable:timeout` (the context budget passed),
+`unavailable:<status>` (Cognia answered an error), `unavailable:error`, `no_user_message`. Every `unavailable` means the
+call was forwarded untouched.
+
 **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.

package/dist/cjs/client.js

@@ -43,7 +43,7 @@ function shapeContext(r) {
     return { contextId: o.contextId, decision, ...(abstain ? { abstain } : {}), scope, items: items, receipts, metrics };
 }
 /** kept in step with package.json by the version test */
-exports.SDK_VERSION = "0.2.1";
+exports.SDK_VERSION = "0.2.2";
 class CogniaError extends Error {
     status;
     body;
@@ -140,7 +140,7 @@ class Cognia {
                 token = this.key;
             if (!token)
                 throw new CogniaError(`Cognia ${method} ${path} → no credential`, 0, null);
-            const r = await this.f(this.baseUrl + path, { method, headers: { authorization: `Bearer ${token}`, "content-type": "application/json", "user-agent": "cognia-sdk/${SDK_VERSION}" }, body: body === undefined ? undefined : JSON.stringify(body), signal: ac.signal });
+            const r = await this.f(this.baseUrl + path, { method, headers: { authorization: `Bearer ${token}`, "content-type": "application/json", "user-agent": "cognia-sdk/" + exports.SDK_VERSION }, body: body === undefined ? undefined : JSON.stringify(body), signal: ac.signal });
             let j = null;
             try {
                 j = await r.json();
@@ -227,7 +227,8 @@ class Cognia {
             return null;
         return (await this.receipt("used", contextId, { itemIds }));
     }
-    /** Report what happened with one item: used or not, success / failure (/ neutral for a Skill). This is the only path to success. */
+    /** Report what happened with one item: used or not, success / failure (/ neutral for a Skill). USED comes from this or from
+     *  `used()`; success and failure come only from here. */
     outcome(contextId, input) {
         return this.call("POST", `/v1/context/${encodeURIComponent(contextId)}/outcome`, input);
     }

package/dist/esm/client.d.ts

@@ -28,7 +28,7 @@ export interface CogniaOptions {
 /** Accept only what the contract promises; anything else is treated as unavailable so the model call proceeds (fail-open). */
 export declare function shapeContext(r: unknown): ContextResponse | null;
 /** kept in step with package.json by the version test */
-export declare const SDK_VERSION = "0.2.1";
+export declare const SDK_VERSION = "0.2.2";
 export declare class CogniaError extends Error {
     readonly status: number;
     readonly body: unknown;
@@ -67,7 +67,8 @@ export declare class Cognia {
     cited(contextId: string, itemIds: string[]): Promise<void>;
     /** USED: your agent actually used these items, whether or not you know yet how it turned out. The cheapest honest signal. */
     used(contextId: string, itemIds: string[]): Promise<ReceiptResponse | null>;
-    /** Report what happened with one item: used or not, success / failure (/ neutral for a Skill). This is the only path to success. */
+    /** Report what happened with one item: used or not, success / failure (/ neutral for a Skill). USED comes from this or from
+     *  `used()`; success and failure come only from here. */
     outcome(contextId: string, input: OutcomeInput): Promise<OutcomeResponse>;
     /** One-liners for the two outcomes. Pass `verification` when a signal (a test, a check, a metric) or a human confirmed it;
      *  without it the report is recorded as agent-reported, which counts as used but never as verified success. */

package/dist/esm/client.js

@@ -39,7 +39,7 @@ export function shapeContext(r) {
     return { contextId: o.contextId, decision, ...(abstain ? { abstain } : {}), scope, items: items, receipts, metrics };
 }
 /** kept in step with package.json by the version test */
-export const SDK_VERSION = "0.2.1";
+export const SDK_VERSION = "0.2.2";
 export class CogniaError extends Error {
     status;
     body;
@@ -135,7 +135,7 @@ export class Cognia {
                 token = this.key;
             if (!token)
                 throw new CogniaError(`Cognia ${method} ${path} → no credential`, 0, null);
-            const r = await this.f(this.baseUrl + path, { method, headers: { authorization: `Bearer ${token}`, "content-type": "application/json", "user-agent": "cognia-sdk/${SDK_VERSION}" }, body: body === undefined ? undefined : JSON.stringify(body), signal: ac.signal });
+            const r = await this.f(this.baseUrl + path, { method, headers: { authorization: `Bearer ${token}`, "content-type": "application/json", "user-agent": "cognia-sdk/" + SDK_VERSION }, body: body === undefined ? undefined : JSON.stringify(body), signal: ac.signal });
             let j = null;
             try {
                 j = await r.json();
@@ -222,7 +222,8 @@ export class Cognia {
             return null;
         return (await this.receipt("used", contextId, { itemIds }));
     }
-    /** Report what happened with one item: used or not, success / failure (/ neutral for a Skill). This is the only path to success. */
+    /** Report what happened with one item: used or not, success / failure (/ neutral for a Skill). USED comes from this or from
+     *  `used()`; success and failure come only from here. */
     outcome(contextId, input) {
         return this.call("POST", `/v1/context/${encodeURIComponent(contextId)}/outcome`, input);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cognia-sdk",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "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",