@ziggs-ai/api-client 0.1.16 → 0.1.18

package/dist/http/AgentSearchClient.d.ts

@@ -15,6 +15,13 @@ export interface AgentProfile {
     description?: string;
     tags?: string[];
     matchScore?: number;
+    status?: 'online' | 'available' | 'offline';
+    /**
+     * ZIG-638: how the caller can reach this row, derived per row (never a
+     * hardcoded label). `restricted` = an exact-id lookup matched an unpublished
+     * agent the caller cannot reach — the id is echoed but no name is disclosed.
+     */
+    reachability?: 'published' | 'same-org' | 'linked' | 'managed' | 'restricted';
     reliability?: {
         sampleSize: number;
         band: string;

package/dist/http/AgreementClient.d.ts

@@ -1,6 +1,5 @@
 import 'dotenv/config';
 import { type Creds, type Agreement, type EngagementKind, type BroadcastAudience } from '../types.js';
-import { type PublishToLedgerPayload } from './TaskClient.js';
 export type PlanReviewTiming = 'with_proposal' | 'before_execution';
 /**
  * Shared proposal terms. When `engagementKind` is omitted the server defaults to `service`.
@@ -160,13 +159,6 @@ export declare function claimAgreement(agreementId: string, creds: Creds): Promi
     ok: boolean;
     agreement: Agreement;
 }>;
-/**
- * @deprecated Use {@link claimAgreement} — same endpoint, clearer name for link + quest.
- */
-export declare function claimLink(agreementId: string, creds: Creds): Promise<{
-    ok: boolean;
-    agreement: Agreement;
-}>;
 export declare function getAgreementsByChat(chatId: string, creds: Creds): Promise<unknown[]>;
 export type ChatLinkType = 'origin' | 'mention' | 'delegation' | 'join';
 export declare function linkAgreementToChat(agreementId: string, chatId: string, linkType: ChatLinkType | undefined, creds: Creds): Promise<unknown | null>;
@@ -182,40 +174,6 @@ export declare function getArtifactsForAgreement(agreementId: string, creds: Cre
 export type UserRole = 'payer' | 'provider' | 'participant' | 'observer';
 export declare function linkUserToAgreement(agreementId: string, userId: string, role: UserRole, creds: Creds): Promise<unknown | null>;
 export declare function getUsersForAgreement(agreementId: string, creds: Creds): Promise<unknown[]>;
-/** @deprecated Routing is expressed via `proposedTo` (a specific principal id vs a broadcast sentinel — `OPEN_AGREEMENT_TARGET` ('everyone') or `ORG_AGREEMENT_TARGET` ('org')), not engagementKind. */
-export type ContractKind = 'direct' | 'delegate' | 'open';
-interface ContractBase extends Omit<ProposeTerms, 'description'> {
-    description: string;
-}
-interface DirectContract extends ProposeDirectInput {
-    kind: 'direct';
-}
-interface DelegateContract extends ContractBase {
-    kind: 'delegate';
-    executorId: string;
-    chatId: string;
-    parentAgreementId: string;
-    parentTaskId?: string;
-    payerId?: string;
-}
-interface OpenContract extends ContractBase {
-    kind: 'open';
-    chatId?: string;
-    payerId?: string;
-    parentTaskId?: string;
-}
-export type CreateContractInput = DirectContract | DelegateContract | OpenContract;
-/**
- * @deprecated Prefer {@link proposeDirectTo}, {@link proposeBroadcast},
- * {@link delegateAgreement}, or {@link publishOpenQuest}.
- */
-export declare function createContract(input: CreateContractInput, creds: Creds): Promise<Agreement>;
-/**
- * Publish a buyer-broadcast quest to the marketplace ledger (Store "Wanted").
- * Pass `payload.audience: 'org'` to scope it to your active org (default
- * `'everyone'`, fully public).
- */
-export declare function publishOpenQuest(payload: PublishToLedgerPayload, creds: Creds): Promise<Agreement>;
 export declare class AgreementClient {
     private creds;
     constructor(operatorKey: string, agentId: string);
@@ -242,11 +200,6 @@ export declare class AgreementClient {
         ok: boolean;
         agreement: Agreement;
     }>;
-    /** @deprecated use claimAgreement */
-    claimLink(id: string): Promise<{
-        ok: boolean;
-        agreement: Agreement;
-    }>;
     listByChat(chatId: string): Promise<unknown[]>;
     linkToChat(id: string, chatId: string, linkType?: ChatLinkType): Promise<unknown>;
     listChats(id: string): Promise<unknown[]>;
@@ -260,4 +213,3 @@ export declare class AgreementClient {
     linkUser(id: string, userId: string, role: UserRole): Promise<unknown>;
     listUsers(id: string): Promise<unknown[]>;
 }
-export {};

package/dist/http/AgreementClient.js

@@ -2,7 +2,6 @@ import 'dotenv/config';
 import { runtimeLog } from '../shared/runtimeLog.js';
 import { getBackendUrl } from '../utils/urlUtils.js';
 import { OPEN_AGREEMENT_TARGET, ORG_AGREEMENT_TARGET, isBroadcastTarget, ApiError } from '../types.js';
-import { publishToLedger } from './TaskClient.js';
 // Lazy: read at call time so dotenv loaded after this module is imported
 // still takes effect. Baking it at module-load time would freeze the URL
 // before the caller's dotenv.config() runs.
@@ -374,12 +373,6 @@ export async function claimAgreement(agreementId, creds) {
     }
     return data;
 }
-/**
- * @deprecated Use {@link claimAgreement} — same endpoint, clearer name for link + quest.
- */
-export async function claimLink(agreementId, creds) {
-    return claimAgreement(agreementId, creds);
-}
 // ---------------------------------------------------------------------------
 // Chat links
 // ---------------------------------------------------------------------------
@@ -556,27 +549,6 @@ export async function getUsersForAgreement(agreementId, creds) {
         return [];
     }
 }
-/**
- * @deprecated Prefer {@link proposeDirectTo}, {@link proposeBroadcast},
- * {@link delegateAgreement}, or {@link publishOpenQuest}.
- */
-export async function createContract(input, creds) {
-    assertCreds(creds, 'contract creation');
-    const { kind, ...rest } = input;
-    if (kind === 'direct')
-        return proposeDirectTo(rest, creds);
-    if (kind === 'delegate')
-        return delegateAgreement(rest, creds);
-    return publishOpenQuest(rest, creds);
-}
-/**
- * Publish a buyer-broadcast quest to the marketplace ledger (Store "Wanted").
- * Pass `payload.audience: 'org'` to scope it to your active org (default
- * `'everyone'`, fully public).
- */
-export async function publishOpenQuest(payload, creds) {
-    return publishToLedger(payload, creds);
-}
 export class AgreementClient {
     creds;
     constructor(operatorKey, agentId) {
@@ -600,8 +572,6 @@ export class AgreementClient {
     create(data) { return createAgreement(data, this.creds); }
     revoke(id) { return revokeAgreement(id, this.creds); }
     claimAgreement(id) { return claimAgreement(id, this.creds); }
-    /** @deprecated use claimAgreement */
-    claimLink(id) { return claimAgreement(id, this.creds); }
     listByChat(chatId) { return getAgreementsByChat(chatId, this.creds); }
     linkToChat(id, chatId, linkType) { return linkAgreementToChat(id, chatId, linkType ?? 'mention', this.creds); }
     listChats(id) { return getChatsForAgreement(id, this.creds); }

package/dist/http/MarketplaceClient.d.ts

@@ -19,10 +19,31 @@ export interface PullOffersOptions {
 }
 export declare function pullOffers(options: PullOffersOptions | undefined, creds: Creds): Promise<Agreement[]>;
 export declare function claimOffer(agreementId: string, creds: Creds): Promise<Agreement>;
+export interface PublishQuestPayload {
+    description: string;
+    chatId?: string;
+    payerId?: string;
+    parentTaskId?: string;
+    price?: number;
+    lifecycle?: string;
+    expiresAt?: string;
+    maxExecutions?: number;
+    agreementDescription?: string;
+    /** Broadcast audience: 'everyone' (default, fully public) or 'org' (members of your active org only). */
+    audience?: BroadcastAudience;
+}
+export declare function publishQuest(payload: PublishQuestPayload, creds: Creds): Promise<Agreement>;
+export interface PullQuestsOptions {
+    limit?: number;
+    since?: string;
+}
+export declare function pullQuests(options: PullQuestsOptions | undefined, creds: Creds): Promise<Agreement[]>;
 export declare class MarketplaceClient {
     private creds;
     constructor(operatorKey: string, agentId: string);
     publishOffer(payload: PublishOfferPayload): Promise<Agreement>;
     pullOffers(options?: PullOffersOptions): Promise<Agreement[]>;
     claimOffer(agreementId: string): Promise<Agreement>;
+    publishQuest(payload: PublishQuestPayload): Promise<Agreement>;
+    pullQuests(options?: PullQuestsOptions): Promise<Agreement[]>;
 }

package/dist/http/MarketplaceClient.js

@@ -75,6 +75,41 @@ export async function claimOffer(agreementId, creds) {
         throw new Error(data?.['error'] || 'Claim failed');
     return data['offer'];
 }
+export async function publishQuest(payload, creds) {
+    assertCreds(creds, 'quest publish');
+    const res = await fetch(`${getMarketplaceBaseUrl()}/quests/publish`, {
+        method: 'POST',
+        headers: buildHeaders(creds),
+        body: JSON.stringify(payload || {}),
+    });
+    if (!res.ok) {
+        const body = await res.text().catch(() => '');
+        throwApiError(res, body, `Quest publish failed: ${res.status}`);
+    }
+    const data = await res.json().catch(() => null);
+    if (!data?.['agreement'])
+        throw new Error('Quest publish returned no agreement');
+    return data['agreement'];
+}
+export async function pullQuests(options, creds) {
+    assertCreds(creds, 'quest pull');
+    const params = new URLSearchParams();
+    if (options?.limit != null)
+        params.set('limit', String(options.limit));
+    if (options?.since)
+        params.set('since', options.since);
+    const qs = params.toString();
+    const res = await fetch(`${getMarketplaceBaseUrl()}/quests${qs ? `?${qs}` : ''}`, {
+        method: 'GET',
+        headers: buildHeaders(creds),
+    });
+    if (!res.ok) {
+        const body = await res.text().catch(() => '');
+        throwApiError(res, body, `Quest pull failed: ${res.status}`);
+    }
+    const data = await res.json().catch(() => null);
+    return data?.['agreements'] ?? [];
+}
 export class MarketplaceClient {
     creds;
     constructor(operatorKey, agentId) {
@@ -87,4 +122,6 @@ export class MarketplaceClient {
     publishOffer(payload) { return publishOffer(payload, this.creds); }
     pullOffers(options) { return pullOffers(options, this.creds); }
     claimOffer(agreementId) { return claimOffer(agreementId, this.creds); }
+    publishQuest(payload) { return publishQuest(payload, this.creds); }
+    pullQuests(options) { return pullQuests(options, this.creds); }
 }

package/dist/http/TaskClient.d.ts

@@ -1,11 +1,13 @@
 import 'dotenv/config';
-import { type Creds, type Task, type TaskState, type Agreement, type BroadcastAudience } from '../types.js';
+import { type Creds, type Task, type TaskState } from '../types.js';
 export interface CreateTaskData {
     description: string;
     agreementId: string;
     parentTaskId?: string;
     plan?: unknown;
     idempotencyKey?: string;
+    /** Explicit delegation target (ZIG-586) — must be a party to the agreement; validated server-side. */
+    assigneeId?: string;
 }
 export declare function createTask(taskData: CreateTaskData, creds: Creds): Promise<Task>;
 export declare function getTask(taskId: string, creds: Creds): Promise<Task>;
@@ -24,34 +26,14 @@ export interface PlanReplaceStep {
     order: number;
 }
 export declare function replaceTaskPlan(taskId: string, steps: PlanReplaceStep[], creds: Creds): Promise<Task>;
-export interface PublishToLedgerPayload {
-    description: string;
-    chatId?: string;
-    payerId?: string;
-    parentTaskId?: string;
-    price?: number;
-    lifecycle?: string;
-    expiresAt?: string;
-    maxExecutions?: number;
-    agreementDescription?: string;
-    /** Broadcast audience: 'everyone' (default, fully public) or 'org' (members of your active org only). */
-    audience?: BroadcastAudience;
-}
-export declare function publishToLedger(payload: PublishToLedgerPayload, creds: Creds): Promise<Agreement>;
-export interface PullFromLedgerOptions {
-    limit?: number;
-    since?: string;
-}
-export declare function pullFromLedger(options: PullFromLedgerOptions | undefined, creds: Creds): Promise<Agreement[]>;
-export declare function claimLedgerTask(agreementId: string, creds: Creds, options?: {
-    idempotencyKey?: string;
-}): Promise<Agreement>;
 export declare function reportTask(taskId: string, message: string | undefined, creds: Creds): Promise<Task>;
 export declare function setTaskSatisfaction(taskId: string, satisfaction: 'positive' | 'negative', creds: Creds): Promise<Task>;
 export interface ListTasksOptions {
     state?: string;
     cursor?: string;
     limit?: number;
+    /** Filter to tasks assigned to this id (ZIG-586). */
+    assignedTo?: string;
 }
 export interface ListTasksResult {
     tasks: Task[];
@@ -77,11 +59,6 @@ export declare class TaskClient {
     cancelTask(taskId: string): Promise<Task>;
     getSubtasks(parentTaskId: string): Promise<Task[]>;
     replaceTaskPlan(taskId: string, steps: PlanReplaceStep[]): Promise<Task>;
-    publishToLedger(payload: PublishToLedgerPayload): Promise<Agreement>;
-    pullFromLedger(options?: PullFromLedgerOptions): Promise<Agreement[]>;
-    claimLedgerTask(taskId: string, options?: {
-        idempotencyKey?: string;
-    }): Promise<Agreement>;
     reportTask(taskId: string, message?: string): Promise<Task>;
     setTaskSatisfaction(taskId: string, satisfaction: 'positive' | 'negative'): Promise<Task>;
     listTasks(options?: ListTasksOptions): Promise<ListTasksResult>;

package/dist/http/TaskClient.js

@@ -2,7 +2,6 @@ import 'dotenv/config';
 import { getBackendUrl } from '../utils/urlUtils.js';
 import { ApiError } from '../types.js';
 function getTaskBaseUrl() { return `${getBackendUrl()}/tasks`; }
-function getMarketplaceBaseUrl() { return `${getBackendUrl()}/marketplace`; }
 function buildHeaders(creds) {
     return {
         'content-type': 'application/json',
@@ -206,62 +205,6 @@ export async function replaceTaskPlan(taskId, steps, creds) {
         throw new Error('Invalid response: task data not found');
     return task;
 }
-export async function publishToLedger(payload, creds) {
-    assertCreds(creds, 'quest publish');
-    const res = await fetch(`${getMarketplaceBaseUrl()}/quests/publish`, {
-        method: 'POST',
-        headers: buildHeaders(creds),
-        body: JSON.stringify(payload || {}),
-    });
-    if (!res.ok) {
-        const body = await res.text().catch(() => '');
-        throwApiError(res, body, `Quest publish failed: ${res.status}`);
-    }
-    const data = await res.json().catch(() => null);
-    if (!data?.['agreement'])
-        throw new Error('Quest publish returned no agreement');
-    return data['agreement'];
-}
-export async function pullFromLedger(options, creds) {
-    assertCreds(creds, 'quest pull');
-    const params = new URLSearchParams();
-    if (options?.limit != null)
-        params.set('limit', String(options.limit));
-    if (options?.since)
-        params.set('since', options.since);
-    const qs = params.toString();
-    const res = await fetch(`${getMarketplaceBaseUrl()}/quests${qs ? `?${qs}` : ''}`, {
-        method: 'GET',
-        headers: buildHeaders(creds),
-    });
-    if (!res.ok) {
-        const body = await res.text().catch(() => '');
-        throwApiError(res, body, `Quest pull failed: ${res.status}`);
-    }
-    const data = await res.json().catch(() => null);
-    return data?.['agreements'] ?? [];
-}
-export async function claimLedgerTask(agreementId, creds, options) {
-    if (!agreementId)
-        throw new Error('agreementId is required');
-    assertCreds(creds, 'quest claim');
-    const headers = buildHeaders(creds);
-    if (options?.idempotencyKey)
-        headers['Idempotency-Key'] = options.idempotencyKey;
-    const res = await fetch(`${getMarketplaceBaseUrl()}/quests/claim`, {
-        method: 'POST',
-        headers,
-        body: JSON.stringify({ agreementId }),
-    });
-    if (!res.ok) {
-        const body = await res.text().catch(() => '');
-        throwApiError(res, body, `Quest claim failed: ${res.status}`);
-    }
-    const data = await res.json().catch(() => null);
-    if (!data?.['ok'])
-        throw new Error(data?.['error'] || 'Claim failed');
-    return data['agreement'];
-}
 // ---------------------------------------------------------------------------
 // Reporting & satisfaction
 // ---------------------------------------------------------------------------
@@ -314,6 +257,8 @@ export async function listTasks(options = {}, creds) {
         url.searchParams.set('cursor', options.cursor);
     if (options.limit != null)
         url.searchParams.set('limit', String(options.limit));
+    if (options.assignedTo)
+        url.searchParams.set('assignedTo', options.assignedTo);
     const res = await fetch(url.toString(), {
         method: 'GET',
         headers: buildHeaders(creds),
@@ -373,9 +318,6 @@ export class TaskClient {
     cancelTask(taskId) { return cancelTask(taskId, this.creds); }
     getSubtasks(parentTaskId) { return getSubtasks(parentTaskId, this.creds); }
     replaceTaskPlan(taskId, steps) { return replaceTaskPlan(taskId, steps, this.creds); }
-    publishToLedger(payload) { return publishToLedger(payload, this.creds); }
-    pullFromLedger(options) { return pullFromLedger(options, this.creds); }
-    claimLedgerTask(taskId, options) { return claimLedgerTask(taskId, this.creds, options); }
     reportTask(taskId, message) { return reportTask(taskId, message, this.creds); }
     setTaskSatisfaction(taskId, satisfaction) { return setTaskSatisfaction(taskId, satisfaction, this.creds); }
     listTasks(options) { return listTasks(options ?? {}, this.creds); }

package/dist/types.d.ts

@@ -20,6 +20,8 @@ export interface Task {
     agentId?: string;
     executorId?: string;
     payerId?: string;
+    /** Explicit delegation target (ZIG-586) — id of the agent/user this task is assigned to, or null when unassigned. */
+    assigneeId?: string | null;
     agreementId?: string;
     agreement?: Agreement;
     state: TaskState;

package/package.json

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