@ouispec/agent-core 0.2.0 → 0.4.0

package/dist/approvals/types.d.ts

@@ -12,5 +12,56 @@ export declare const DEFAULT_APPROVAL_TTL_MS: number;
 /** The longest an action may declare an approval lasts. */
 export declare const MAX_APPROVAL_TTL_MS: number;
 export declare const APPROVAL_CHANNELS: readonly ApprovalChannel[];
+/**
+ * How long the store remembers that an approval was asked for and never
+ * decided, after it has expired: long enough for a conversation picked up
+ * days later to be told its call expired, rather than that it still waits.
+ */
+export declare const EXPIRED_APPROVAL_MEMORY_MS: number;
+/**
+ * How long a turn that claimed an expiry has to store it and confirm. A turn
+ * that dies in between confirms nothing, and cannot release anything either:
+ * its claim lapses on the store's clock and the next turn claims again, so the
+ * stored conversation does not say "waiting" for good.
+ */
+export declare const EXPIRY_CLAIM_LEASE_MS: number;
+/**
+ * Where an approval stands when a later turn finds its call still stored as
+ * waiting, and asks to settle it (`POST /internal/approvals/:id/settle`):
+ *
+ * - `claimed`: it expired without having run — undecided, or approved and
+ *   never used (`decided`) — and this caller holds the claim to store
+ *   that, for `EXPIRY_CLAIM_LEASE_MS`. The caller stores the call's result as
+ *   expired, then confirms; confirmed, the claim is permanent.
+ * - `already`: it expired without having run, and another turn holds the claim
+ *   or has confirmed it. The caller tells the model so for its own turn, and stores
+ *   nothing.
+ * - `open`: it is still pending, or approved and not yet used. The card is live.
+ * - `unknown`: the store cannot say it expired undecided — it was declined, or
+ *   approved and used, it is another user's or another conversation's, it was
+ *   asked for before the store kept this memory, or the memory has lapsed.
+ *   Nothing is changed.
+ * - `confirmed`: the answer to a confirmation.
+ *
+ * Only the store's own clock decides that an approval has expired.
+ */
+export type ApprovalSettleOutcome = 'claimed' | 'already' | 'open' | 'unknown' | 'confirmed';
+export interface ApprovalSettlement {
+    approvalId: string;
+    outcome: ApprovalSettleOutcome;
+    /** When it expired (epoch ms), for `claimed` and `already`. */
+    expiresAt?: number;
+    /**
+     * For `claimed` and `already`: the user had approved it, and it expired
+     * before it was used (the turn that would have run it never did). Absent
+     * when nobody decided it.
+     */
+    decided?: 'approved';
+}
+/** Whose approval is asked about: the same ownership the other approval routes check. */
+export interface ApprovalOwner {
+    userId: string;
+    conversationId: string;
+}
 export type { ActionRequestApproval, ApprovalChannel, ApprovalContinuation, ApprovalDecidePayload, ApprovalDecideResult, ApprovalDecision, ApprovalEffect, ApprovalGrant, ApprovalPreview, ApprovalPreviewArgument, ApprovalRedeemResult, ApprovalRefusal, ApprovalRefusalReason, ApprovalRequiredEvent, ApprovalStatus, ApprovalTokenClaims, ApprovedCall, PendingApprovalInput, } from '@ouispec/contract';
 //# sourceMappingURL=types.d.ts.map

package/dist/approvals/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/approvals/types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAyB,eAAe,EAAiB,MAAM,mBAAmB,CAAC;AAE/F;;;;;GAKG;AAEH,gFAAgF;AAChF,eAAO,MAAM,qBAAqB,oBAAoB,CAAC;AAEvD,uFAAuF;AACvF,eAAO,MAAM,uBAAuB,QAAa,CAAC;AAClD,2DAA2D;AAC3D,eAAO,MAAM,mBAAmB,QAAc,CAAC;AAE/C,eAAO,MAAM,iBAAiB,EAAE,SAAS,eAAe,EAA4C,CAAC;AAKrG,YAAY,EACV,qBAAqB,EACrB,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,eAAe,EACf,uBAAuB,EACvB,oBAAoB,EACpB,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EACrB,cAAc,EACd,mBAAmB,EACnB,YAAY,EACZ,oBAAoB,GACrB,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/approvals/types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAyB,eAAe,EAAiB,MAAM,mBAAmB,CAAC;AAE/F;;;;;GAKG;AAEH,gFAAgF;AAChF,eAAO,MAAM,qBAAqB,oBAAoB,CAAC;AAEvD,uFAAuF;AACvF,eAAO,MAAM,uBAAuB,QAAa,CAAC;AAClD,2DAA2D;AAC3D,eAAO,MAAM,mBAAmB,QAAc,CAAC;AAE/C,eAAO,MAAM,iBAAiB,EAAE,SAAS,eAAe,EAA4C,CAAC;AAErG;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,QAAwB,CAAC;AAEhE;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,QAAa,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,CAAC;AAE7F,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,qBAAqB,CAAC;IAC/B,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,UAAU,CAAC;CACtB;AAED,yFAAyF;AACzF,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;CACxB;AAKD,YAAY,EACV,qBAAqB,EACrB,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,eAAe,EACf,uBAAuB,EACvB,oBAAoB,EACpB,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EACrB,cAAc,EACd,mBAAmB,EACnB,YAAY,EACZ,oBAAoB,GACrB,MAAM,mBAAmB,CAAC"}

package/dist/approvals/types.js

@@ -11,6 +11,19 @@ export const DEFAULT_APPROVAL_TTL_MS = 5 * 60_000;
 /** The longest an action may declare an approval lasts. */
 export const MAX_APPROVAL_TTL_MS = 30 * 60_000;
 export const APPROVAL_CHANNELS = ['ui', 'voice', 'phone', 'sms', 'chat'];
+/**
+ * How long the store remembers that an approval was asked for and never
+ * decided, after it has expired: long enough for a conversation picked up
+ * days later to be told its call expired, rather than that it still waits.
+ */
+export const EXPIRED_APPROVAL_MEMORY_MS = 30 * 24 * 60 * 60_000;
+/**
+ * How long a turn that claimed an expiry has to store it and confirm. A turn
+ * that dies in between confirms nothing, and cannot release anything either:
+ * its claim lapses on the store's clock and the next turn claims again, so the
+ * stored conversation does not say "waiting" for good.
+ */
+export const EXPIRY_CLAIM_LEASE_MS = 2 * 60_000;
 const requestIsOUIs = true;
 const grantIsOUIs = true;
 void requestIsOUIs;

package/dist/approvals/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/approvals/types.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AAEH,gFAAgF;AAChF,MAAM,CAAC,MAAM,qBAAqB,GAAG,iBAAiB,CAAC;AAEvD,uFAAuF;AACvF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,GAAG,MAAM,CAAC;AAClD,2DAA2D;AAC3D,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,GAAG,MAAM,CAAC;AAE/C,MAAM,CAAC,MAAM,iBAAiB,GAA+B,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;AA6BrG,MAAM,aAAa,GAAmD,IAAI,CAAC;AAC3E,MAAM,WAAW,GAA0C,IAAI,CAAC;AAChE,KAAK,aAAa,CAAC;AACnB,KAAK,WAAW,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/approvals/types.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AAEH,gFAAgF;AAChF,MAAM,CAAC,MAAM,qBAAqB,GAAG,iBAAiB,CAAC;AAEvD,uFAAuF;AACvF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,GAAG,MAAM,CAAC;AAClD,2DAA2D;AAC3D,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,GAAG,MAAM,CAAC;AAE/C,MAAM,CAAC,MAAM,iBAAiB,GAA+B,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;AAErG;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC;AAEhE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,GAAG,MAAM,CAAC;AAsEhD,MAAM,aAAa,GAAmD,IAAI,CAAC;AAC3E,MAAM,WAAW,GAA0C,IAAI,CAAC;AAChE,KAAK,aAAa,CAAC;AACnB,KAAK,WAAW,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ouispec/agent-core",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Schema types, entity graph, intent resolution, and protocol definitions for the agent SDK",
   "homepage": "https://github.com/wesreid/oui/tree/main/packages/agent-core#readme",
   "bugs": {
@@ -30,9 +30,9 @@
   "dependencies": {
     "ajv": "^8.17.0",
     "yaml": "^2.7.0",
-    "@ouispec/agent-events": "^0.2.0",
+    "@ouispec/agent-events": "^0.2.2",
     "@ouispec/contract": "^0.2.0",
-    "oui-spec": "^0.7.1"
+    "oui-spec": "^0.8.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",