@ziggs-ai/api-client 0.15.1 → 0.17.0

package/dist/types.d.ts

@@ -1,3 +1,4 @@
+import type { InboxRequestChannel } from '@ziggs-ai/contracts';
 /**
  * One failure shape for every HTTP client path.
  *
@@ -259,19 +260,7 @@ export type BroadcastAudience = typeof OPEN_AGREEMENT_TARGET | typeof ORG_AGREEM
 export declare const BROADCAST_TARGETS: readonly ["everyone", "org"];
 /** True when `id` is a broadcast sentinel ('everyone' | 'org') rather than a concrete principal id. */
 export declare function isBroadcastTarget(id: string | null | undefined): boolean;
-/**
- * Persona face id (`psn_*`). Non-addressable — never use for agent lookup,
- * wake, or payment parties.
- */
-export declare function isPersonaRef(id: string | null | undefined): boolean;
-/**
- * Room presentation binding id (`rpb_*`). Opaque to account lookup / wake /
- * pay. Chat sends may echo it as `receiverId` — the backend resolves it in-room
- *.
- */
-export declare function isRoomPresentationRef(id: string | null | undefined): boolean;
-/** Either opaque presentation ref (`psn_*` | `rpb_*`). */
-export declare function isOpaquePresentationRef(id: string | null | undefined): boolean;
+export { isPersonaFaceRef as isPersonaRef, isRoomBindingRef as isRoomPresentationRef, isPresentationRef as isOpaquePresentationRef, } from '@ziggs-ai/contracts';
 /** Display + entitlement face for a principal on the message/roster wire. */
 export interface PrincipalPresentation {
     /** Public, non-addressable reference (`psn_*` or `rpb_*`). */
@@ -332,7 +321,7 @@ export interface MessageMetadata {
     agreementId?: string | null;
     /**
      * Message send time from the wire payload. The live-path inbox
-     * watermark ack (AgentHost, P4) needs it — without a timestamp the
+     * watermark ack (Agent, P4) needs it — without a timestamp the
      * ack never fires and catch-up re-delivers the chat's whole backlog after a
      * host eviction, re-running already-answered goals.
      */
@@ -472,14 +461,8 @@ export interface InboxTaskRef {
  * A marketplace request doorbell. Own channel so the host can
  * exact-match triage with zero LLM tokens before any wake.
  */
-export interface InboxRequestRef {
-    agreementId: string;
-    /** Exact-match string from the publisher — compare to the agent's tags. */
-    match: string;
-    title: string;
-    ts: string;
-}
-export interface InboxEnvelope {
+export type { InboxOpenRequestRef as InboxRequestRef } from '@ziggs-ai/contracts';
+export interface InboxEnvelope extends InboxRequestChannel {
     asOf: string;
     /**
      * The mailboxes this reader's view merges — its owner's, plus whatever
@@ -487,7 +470,7 @@ export interface InboxEnvelope {
      */
     sources?: InboxSourceRef[];
     /**
-     * Unacked rows across every source, newest first, copies of one event
+     * Unacked rows across every source, oldest first, copies of one event
      * collapsed. This IS the inbox — read straight out of the party delivery
      * logs, not derived from grants. Rows with `assigneeId === me` are mine to
      * act on; the rest are readable context.
@@ -509,9 +492,6 @@ export interface InboxEnvelope {
     /** Open tasks assigned to this agent — the work channel. */
     tasksAwaitingMe: InboxTaskRef[];
     truncatedTasks: number;
-    /** Unacked request deliveries — triaged before any LLM wake. */
-    requestsAwaitingMe?: InboxRequestRef[];
-    truncatedRequests?: number;
     proposalsAwaitingMe: InboxProposalRef[];
     truncatedProposals: number;
     connectionRequestsAwaitingMe: InboxConnectionRequestRef[];

package/dist/types.js

@@ -95,22 +95,4 @@ export const BROADCAST_TARGETS = [OPEN_AGREEMENT_TARGET, ORG_AGREEMENT_TARGET];
 export function isBroadcastTarget(id) {
     return id === OPEN_AGREEMENT_TARGET || id === ORG_AGREEMENT_TARGET;
 }
-/**
- * Persona face id (`psn_*`). Non-addressable — never use for agent lookup,
- * wake, or payment parties.
- */
-export function isPersonaRef(id) {
-    return typeof id === 'string' && id.startsWith('psn_');
-}
-/**
- * Room presentation binding id (`rpb_*`). Opaque to account lookup / wake /
- * pay. Chat sends may echo it as `receiverId` — the backend resolves it in-room
- *.
- */
-export function isRoomPresentationRef(id) {
-    return typeof id === 'string' && id.startsWith('rpb_');
-}
-/** Either opaque presentation ref (`psn_*` | `rpb_*`). */
-export function isOpaquePresentationRef(id) {
-    return isPersonaRef(id) || isRoomPresentationRef(id);
-}
+export { isPersonaFaceRef as isPersonaRef, isRoomBindingRef as isRoomPresentationRef, isPresentationRef as isOpaquePresentationRef, } from '@ziggs-ai/contracts';

package/dist/utils/appUrls.d.ts

@@ -0,0 +1,7 @@
+/** Resolve the app origin once for SDK, MCP, and capability links. */
+export declare function resolveWebAppOrigin(webUrl?: string | null, backendUrl?: string): string;
+export declare function agreementAppUrl(origin: string, id: string): string;
+export declare function agreementsListAppUrl(origin: string): string;
+export declare function connectInviteAppUrl(origin: string, id: string): string;
+export declare function connectionsSettingsAppUrl(origin: string, requestId?: string | null): string;
+export declare function walletAppUrl(origin: string): string;

package/dist/utils/appUrls.js

@@ -0,0 +1,38 @@
+/** Resolve the app origin once for SDK, MCP, and capability links. */
+export function resolveWebAppOrigin(webUrl, backendUrl) {
+    const explicit = webUrl
+        ?.split(';')
+        .map((value) => value.trim())
+        .find(Boolean);
+    if (explicit)
+        return explicit.replace(/\/+$/, '');
+    if (backendUrl) {
+        const backend = new URL(backendUrl);
+        if (backend.hostname === 'localhost' || backend.hostname === '127.0.0.1')
+            return 'http://localhost:1234';
+        backend.hostname = backend.hostname.replace(/^api\./, '');
+        return backend.origin;
+    }
+    return 'https://ziggsai.com';
+}
+function appUrl(origin, path) {
+    return new URL(path, `${resolveWebAppOrigin(origin)}/`).toString();
+}
+export function agreementAppUrl(origin, id) {
+    return appUrl(origin, `/app/agreements/${encodeURIComponent(id)}`);
+}
+export function agreementsListAppUrl(origin) {
+    return appUrl(origin, '/app/agreements');
+}
+export function connectInviteAppUrl(origin, id) {
+    return appUrl(origin, `/connect/${encodeURIComponent(id)}`);
+}
+export function connectionsSettingsAppUrl(origin, requestId) {
+    const url = new URL(appUrl(origin, '/app/access'));
+    if (requestId)
+        url.searchParams.set('request', requestId);
+    return url.toString();
+}
+export function walletAppUrl(origin) {
+    return appUrl(origin, '/app/settings/organization/billing');
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ziggs-ai/api-client",
-  "version": "0.15.1",
+  "version": "0.17.0",
   "description": "HTTP and WebSocket client for the Ziggs backend API",
   "type": "module",
   "main": "dist/index.js",
@@ -27,7 +27,8 @@
     "test:watch": "node --import tsx/esm --test --watch test/*.test.ts"
   },
   "dependencies": {
-    "socket.io-client": "^4.7.0"
+    "socket.io-client": "^4.7.0",
+    "@ziggs-ai/contracts": "^0.6.0"
   },
   "keywords": [
     "ziggs",