@ziggs-ai/api-client 0.2.0 → 0.3.1

package/dist/ConnectionManager.d.ts

@@ -1,3 +1,4 @@
+import { type InboxOperatorAgentEntry } from './http/InboxClient.js';
 type OpenFn = () => Promise<unknown>;
 type CloseFn = (handle: unknown) => Promise<void>;
 export interface ConnectionManagerMeta {
@@ -14,13 +15,21 @@ export interface ConnectionManagerOptions {
      * this manager lazily starts. `start()` long-polls `GET /inbox/operator` with
      * this key; when an agent's slice shows actionable content, it starts that
      * agent's host (which then consumes via its own per-agent inbox loop). No
-     * socket, no wake push — lazy process management driven by the poll. `wsUrl`
+     * socket, no push notification — lazy process management driven by the poll. `wsUrl`
      * is accepted for back-compat but unused (the poll is HTTP).
      */
     control?: {
         wsUrl?: string;
         operatorKey?: string;
     };
+    /**
+     * Gate on the operator-poll lazy start (ZIG-910). Called for each agent
+     * slice with actionable content before its host is started; return false to
+     * leave the host down this pass. The slice stays in later envelopes (reading
+     * never acks), so the gate is consulted again on every poll. Explicit
+     * `startAgent()` calls are not gated. Default: everything actionable starts.
+     */
+    shouldLazyStart?: (entry: InboxOperatorAgentEntry) => boolean;
 }
 export interface QueryFilter {
     domain?: string;
@@ -36,8 +45,9 @@ export declare class ConnectionManager {
     private _entries;
     private _active;
     private _meta;
-    private _waking;
-    constructor({ maxActive, idleTimeoutMs, control }?: ConnectionManagerOptions);
+    private _starting;
+    private _shouldLazyStart;
+    constructor({ maxActive, idleTimeoutMs, control, shouldLazyStart }?: ConnectionManagerOptions);
     register(id: string, openFn: OpenFn, closeFn: CloseFn, meta?: ConnectionManagerMeta): void;
     start(operatorKey?: string): void;
     stop(): Promise<void>;
@@ -49,7 +59,7 @@ export declare class ConnectionManager {
      * the loop never exits until `stop()` (nothing to resynchronize).
      */
     private _runOperatorPoll;
-    wake(id: string): Promise<unknown>;
+    startAgent(id: string): Promise<unknown>;
     sleep(id: string): Promise<void>;
     sleepAll(): Promise<void>;
     touch(id: string): void;

package/dist/ConnectionManager.js

@@ -15,17 +15,19 @@ export class ConnectionManager {
     _entries;
     _active;
     _meta;
-    _waking;
-    constructor({ maxActive = 50, idleTimeoutMs = 60_000, control } = {}) {
+    _starting;
+    _shouldLazyStart;
+    constructor({ maxActive = 50, idleTimeoutMs = 60_000, control, shouldLazyStart } = {}) {
         this.maxActive = maxActive;
         this.idleTimeoutMs = idleTimeoutMs;
+        this._shouldLazyStart = shouldLazyStart ?? null;
         this._operatorKey = control?.operatorKey ?? null;
         this._polling = false;
         this._pollDone = null;
         this._entries = new Map();
         this._active = new Map();
         this._meta = new Map();
-        this._waking = new Map();
+        this._starting = new Map();
     }
     register(id, openFn, closeFn, meta) {
         if (!id)
@@ -74,7 +76,9 @@ export class ConnectionManager {
                     // it isn't already running and we know how to open it.
                     if (!id || this._active.has(id) || !this._entries.has(id))
                         continue;
-                    this.wake(id).catch((err) => runtimeLog.warn('ConnectionManager', `lazy-start("${id}") failed: ${err.message}`));
+                    if (this._shouldLazyStart && !this._shouldLazyStart(entry))
+                        continue;
+                    this.startAgent(id).catch((err) => runtimeLog.warn('ConnectionManager', `lazy-start("${id}") failed: ${err.message}`));
                 }
             }
             catch (err) {
@@ -88,13 +92,13 @@ export class ConnectionManager {
             }
         }
     }
-    async wake(id) {
+    async startAgent(id) {
         const existing = this._active.get(id);
         if (existing) {
             this._resetTimer(id);
             return existing.handle;
         }
-        const pending = this._waking.get(id);
+        const pending = this._starting.get(id);
         if (pending)
             return pending;
         const entry = this._entries.get(id);
@@ -102,7 +106,7 @@ export class ConnectionManager {
             throw new Error(`[ConnectionManager] unknown id: "${id}"`);
         if (this._active.size >= this.maxActive)
             await this._evictLRU();
-        const wakePromise = (async () => {
+        const startPromise = (async () => {
             try {
                 const handle = await entry.openFn();
                 this._active.set(id, { handle, timer: null, lastActive: Date.now() });
@@ -110,11 +114,11 @@ export class ConnectionManager {
                 return handle;
             }
             finally {
-                this._waking.delete(id);
+                this._starting.delete(id);
             }
         })();
-        this._waking.set(id, wakePromise);
-        return wakePromise;
+        this._starting.set(id, startPromise);
+        return startPromise;
     }
     async sleep(id) {
         const entry = this._active.get(id);

package/dist/http/AgreementClient.d.ts

@@ -128,6 +128,13 @@ export interface GetMyAgreementsFilters {
     engagementKind?: EngagementKind;
     proposalStatus?: string;
     hasTask?: boolean;
+    /**
+     * ZIG-942: `scope=mine` alone returns every agreement the caller's grant can
+     * read in the active org — including ones the caller is not a party to
+     * (`isYou` all-false). Pass `partyOnly: true` for a true "mine": only
+     * agreements where the caller (key owner or impersonated agent) is a party.
+     */
+    partyOnly?: boolean;
 }
 export declare function getMyAgreements(filters: GetMyAgreementsFilters | undefined, creds: Creds): Promise<Agreement[]>;
 export declare function getAgreement(agreementId: string, creds: Creds): Promise<Agreement | null>;

package/dist/http/AgreementClient.js

@@ -284,6 +284,8 @@ export async function getMyAgreements(filters = {}, creds) {
         url.searchParams.set('proposalStatus', filters.proposalStatus);
     if (filters.hasTask != null)
         url.searchParams.set('hasTask', String(filters.hasTask));
+    if (filters.partyOnly)
+        url.searchParams.set('partyOnly', 'true');
     let res;
     try {
         res = await fetch(url.toString(), { method: 'GET', headers: buildHeaders(creds) });

package/dist/http/ConnectionsClient.d.ts

@@ -29,7 +29,7 @@ export interface McpConnectionRequestParams {
 /**
  * ZIG-894 — the one connections client for every surface. Consolidates the
  * former agent-sdk private ZiggsConnectClient and ziggs-mcp's inline fetches
- * (proxyConnection, createMcpConnectionRequest). Proxied provider calls never
+ * (proxy, requestMcpConnection). Proxied provider calls never
  * return the raw OAuth token; every proxy response is additionally scanned by
  * the client-side leak guard before it reaches the caller. Grant *listing*
  * across connections is the unified GET /grants; the per-connection grant

package/dist/http/ConnectionsClient.js

@@ -23,7 +23,7 @@ export function assertNoLeakedConnectionSecret(serialized) {
 /**
  * ZIG-894 — the one connections client for every surface. Consolidates the
  * former agent-sdk private ZiggsConnectClient and ziggs-mcp's inline fetches
- * (proxyConnection, createMcpConnectionRequest). Proxied provider calls never
+ * (proxy, requestMcpConnection). Proxied provider calls never
  * return the raw OAuth token; every proxy response is additionally scanned by
  * the client-side leak guard before it reaches the caller. Grant *listing*
  * across connections is the unified GET /grants; the per-connection grant

package/dist/http/ContextDiscoveryClient.d.ts

@@ -1,10 +1,14 @@
 import 'dotenv/config';
-/** Labels-only pointer to context the agent could request access to (P4). */
+/**
+ * Labels-only pointer to context the agent could request access to (P4).
+ * ZIG-927: covers chats, agreements, and connections; connection labels are the
+ * provider name only (never tokens/account labels).
+ */
 export interface DiscoverableItem {
-    type: 'chat';
+    type: 'chat' | 'agreement' | 'connection';
     label: string;
     scopeRef: {
-        kind: 'chat' | 'agreement' | 'org';
+        kind: 'chat' | 'agreement' | 'org' | 'connection';
         id: string;
     };
     orgId: string;

package/dist/http/ContextReadClient.d.ts

@@ -53,7 +53,7 @@ export declare class ContextReadClient {
     /**
      * Aggregated chat snapshot — `GET /context/snapshot?via=chat:<id>`. The
      * server composes history + agreements + roster through the same grant-fenced
-     * readers as {@link read}, so hosted agents pull one fenced view per wake.
+     * readers as {@link read}, so hosted agents pull one fenced view per poll cycle.
      * Rejects with an `Error & { status }` on non-OK so callers can branch (404).
      */
     snapshot(chatId: string, opts?: {

package/dist/http/ContextReadClient.js

@@ -56,7 +56,7 @@ export class ContextReadClient {
     /**
      * Aggregated chat snapshot — `GET /context/snapshot?via=chat:<id>`. The
      * server composes history + agreements + roster through the same grant-fenced
-     * readers as {@link read}, so hosted agents pull one fenced view per wake.
+     * readers as {@link read}, so hosted agents pull one fenced view per poll cycle.
      * Rejects with an `Error & { status }` on non-OK so callers can branch (404).
      */
     async snapshot(chatId, opts = {}) {

package/dist/http/index.d.ts

@@ -25,4 +25,4 @@ export type { ConnectionsError, ConnectionProxyParams, McpConnectionRequestParam
 export { AgentSearchClient } from './AgentSearchClient.js';
 export { TelemetryClient } from './TelemetryClient.js';
 export { InboxClient } from './InboxClient.js';
-export type { InboxScopeKind, InboxScopeEntry, InboxProposalRef, InboxConnectionRequestRef, InboxMcpServerRequestRef, InboxHumanAttention, InboxEnvelope, InboxAck, InboxAckResult, } from './InboxClient.js';
+export type { InboxScopeKind, InboxScopeEntry, InboxProposalRef, InboxConnectionRequestRef, InboxMcpServerRequestRef, InboxHumanAttention, InboxEnvelope, InboxAck, InboxAckResult, InboxOperatorAgentEntry, InboxOperatorEnvelope, } from './InboxClient.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ziggs-ai/api-client",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "HTTP and WebSocket client for the Ziggs backend API",
   "type": "module",
   "main": "dist/index.js",