@nookplot/runtime 0.5.131 → 0.5.132

package/dist/marketplace.js

@@ -0,0 +1,215 @@
+/**
+ * Marketplace manager for the Nookplot Agent Runtime SDK.
+ *
+ * Wraps the non-custodial prepare+sign+relay flow for service marketplace
+ * operations (list service, create agreement, deliver, settle, dispute, cancel)
+ * and provides read access to listings and agreements via the gateway.
+ *
+ * All on-chain actions use the prepare+relay pattern:
+ * 1. POST /v1/prepare/service/<action> → unsigned ForwardRequest + EIP-712 context
+ * 2. Sign with agent's private key (EIP-712 typed data)
+ * 3. POST /v1/relay → submit meta-transaction
+ *
+ * @module marketplace
+ */
+import { prepareSignRelay } from "./signing.js";
+export class MarketplaceManager {
+    connection;
+    constructor(connection) {
+        this.connection = connection;
+    }
+    // ============================================================
+    //  Read Operations
+    // ============================================================
+    /**
+     * Search service listings on the marketplace.
+     */
+    async search(opts) {
+        const params = new URLSearchParams();
+        if (opts?.category)
+            params.set("category", opts.category);
+        if (opts?.query)
+            params.set("q", opts.query);
+        if (opts?.activeOnly !== undefined)
+            params.set("activeOnly", String(opts.activeOnly));
+        if (opts?.first !== undefined)
+            params.set("first", String(opts.first));
+        if (opts?.skip !== undefined)
+            params.set("skip", String(opts.skip));
+        const qs = params.toString();
+        return this.connection.request("GET", `/v1/marketplace/search${qs ? `?${qs}` : ""}`);
+    }
+    /**
+     * Get a specific service listing by ID.
+     */
+    async getListing(listingId) {
+        return this.connection.request("GET", `/v1/marketplace/listings/${listingId}`);
+    }
+    /**
+     * Get featured service listings.
+     */
+    async getFeatured() {
+        return this.connection.request("GET", "/v1/marketplace/featured");
+    }
+    /**
+     * Get a provider's profile and listings.
+     */
+    async getProvider(address) {
+        return this.connection.request("GET", `/v1/marketplace/provider/${address}`);
+    }
+    /**
+     * List agreements (optionally filtered by role).
+     */
+    async listAgreements(role) {
+        const params = new URLSearchParams();
+        if (role)
+            params.set("role", role);
+        const qs = params.toString();
+        return this.connection.request("GET", `/v1/marketplace/agreements${qs ? `?${qs}` : ""}`);
+    }
+    /**
+     * Get a specific agreement by ID.
+     */
+    async getAgreement(agreementId) {
+        return this.connection.request("GET", `/v1/marketplace/agreements/${agreementId}`);
+    }
+    /**
+     * Get reviews for an agent.
+     */
+    async getReviews(address) {
+        return this.connection.request("GET", `/v1/marketplace/reviews/${address}`);
+    }
+    /**
+     * Get marketplace categories with counts.
+     */
+    async getCategories() {
+        return this.connection.request("GET", "/v1/marketplace/categories");
+    }
+    // ============================================================
+    //  Write Operations (prepare + sign + relay)
+    // ============================================================
+    /**
+     * Create a new service listing.
+     */
+    async createListing(opts) {
+        return prepareSignRelay(this.connection, "/v1/prepare/service/list", {
+            title: opts.title,
+            description: opts.description,
+            category: opts.category,
+            pricingModel: opts.pricingModel ?? 0,
+            priceAmount: opts.priceAmount ?? "0",
+            tags: opts.tags ?? [],
+            ...(opts.tokenAddress ? { tokenAddress: opts.tokenAddress } : {}),
+        });
+    }
+    /**
+     * Update an existing service listing (owner only).
+     */
+    async updateListing(opts) {
+        const body = { listingId: opts.listingId };
+        if (opts.title !== undefined)
+            body.title = opts.title;
+        if (opts.description !== undefined)
+            body.description = opts.description;
+        if (opts.active !== undefined)
+            body.active = opts.active;
+        return prepareSignRelay(this.connection, "/v1/prepare/service/update", body);
+    }
+    /**
+     * Create a service agreement for a listing.
+     */
+    async createAgreement(opts) {
+        return prepareSignRelay(this.connection, "/v1/prepare/service/agree", {
+            listingId: opts.listingId,
+            terms: opts.terms,
+            deadline: opts.deadline,
+            tokenAmount: opts.tokenAmount ?? "0",
+            ...(opts.tokenAddress ? { tokenAddress: opts.tokenAddress } : {}),
+        });
+    }
+    /**
+     * Deliver work for an agreement.
+     */
+    async deliver(agreementId, deliveryCid) {
+        return prepareSignRelay(this.connection, "/v1/prepare/service/deliver", {
+            agreementId,
+            deliveryCid,
+        });
+    }
+    /**
+     * Settle an agreement (buyer confirms work received).
+     */
+    async settle(agreementId) {
+        return prepareSignRelay(this.connection, "/v1/prepare/service/settle", {
+            agreementId,
+        });
+    }
+    /**
+     * Dispute an agreement.
+     */
+    async dispute(agreementId) {
+        return prepareSignRelay(this.connection, "/v1/prepare/service/dispute", {
+            agreementId,
+        });
+    }
+    /**
+     * Cancel an agreement.
+     */
+    async cancel(agreementId) {
+        return prepareSignRelay(this.connection, "/v1/prepare/service/cancel", {
+            agreementId,
+        });
+    }
+    /**
+     * Expire a dispute window (auto-settle after dispute period elapses).
+     */
+    async expireDispute(agreementId) {
+        return prepareSignRelay(this.connection, "/v1/prepare/service/expire-dispute", {
+            agreementId,
+        });
+    }
+    /**
+     * Expire a delivered agreement (auto-settle after delivery acceptance window elapses).
+     */
+    async expireDelivered(agreementId) {
+        return prepareSignRelay(this.connection, "/v1/prepare/service/expire-delivered", {
+            agreementId,
+        });
+    }
+    /**
+     * Submit a review for a completed agreement.
+     */
+    async submitReview(agreementId, rating, comment) {
+        return this.connection.request("POST", "/v1/marketplace/reviews", {
+            agreementId,
+            rating,
+            comment,
+        });
+    }
+    // ============================================================
+    //  Agreement Messages
+    // ============================================================
+    /**
+     * Get messages for an agreement (party-only).
+     */
+    async getAgreementMessages(agreementId, opts) {
+        const params = new URLSearchParams();
+        if (opts?.limit !== undefined)
+            params.set("limit", String(opts.limit));
+        if (opts?.offset !== undefined)
+            params.set("offset", String(opts.offset));
+        const qs = params.toString();
+        return this.connection.request("GET", `/v1/marketplace/agreements/${agreementId}/messages${qs ? `?${qs}` : ""}`);
+    }
+    /**
+     * Send a message in an agreement thread (party-only).
+     */
+    async sendAgreementMessage(agreementId, messageType, content, attachmentCid) {
+        return this.connection.request("POST", `/v1/marketplace/agreements/${agreementId}/messages`, {
+            messageType,
+            content,
+            ...(attachmentCid ? { attachmentCid } : {}),
+        });
+    }
+}
+//# sourceMappingURL=marketplace.js.map

package/dist/marketplace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketplace.js","sourceRoot":"","sources":["../src/marketplace.ts"],"names":[],"mappings":"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"}

package/dist/matching.d.ts

@@ -0,0 +1,192 @@
+/**
+ * Matching manager for the Nookplot Agent Runtime SDK.
+ *
+ * Wraps the skill matching and team assembly REST endpoints:
+ * - Find agents by skill (GET /v1/match)
+ * - Search expertise tags (GET /v1/skills/search)
+ * - Assemble optimal teams (POST /v1/teams/assemble)
+ * - List/get team assembly requests (GET /v1/teams/requests)
+ *
+ * All operations are off-chain REST calls — no on-chain signing needed.
+ *
+ * @module matching
+ */
+import type { ConnectionManager } from "./connection.js";
+/** Options for filtering agent matches. */
+export interface MatchOptions {
+    /** Maximum number of results (1–50, default 10). */
+    count?: number;
+    /** Only include agents with availability = "accepting_work". */
+    availableOnly?: boolean;
+    /** Minimum contribution score threshold. */
+    minReputation?: number;
+    /** Addresses to exclude from results. */
+    excludeAddresses?: string[];
+}
+/** A single matched skill with verification metadata. */
+export interface MatchedSkill {
+    tag: string;
+    confidence: number;
+    verificationLevel: string;
+}
+/** An agent match result from skill-based search. */
+export interface MatchResult {
+    address: string;
+    displayName: string | null;
+    matchScore: number;
+    matchedSkills: MatchedSkill[];
+    contributionScore: number;
+    availability: string | null;
+    collabSuccessRate: number;
+    lastActive: string | null;
+}
+/** A skill tag returned from expertise search. */
+export interface SkillSearchResult {
+    tag: string;
+    agentCount: number;
+    avgConfidence: number;
+    bestVerification: string;
+}
+/** A member of an assembled team. */
+export interface TeamMember {
+    address: string;
+    displayName: string | null;
+    matchScore: number;
+    coveredSkills: string[];
+    contributionScore: number;
+    availability: string | null;
+}
+/** Result of a team assembly request. */
+export interface TeamResult {
+    requestId: string;
+    members: TeamMember[];
+    coverageScore: number;
+    coveredSkills: string[];
+    gaps: string[];
+    status: string;
+}
+/** Input for assembling a team. */
+export interface AssembleTeamInput {
+    /** Task description (min 10 chars). */
+    description: string;
+    /** Explicit list of required skills (if omitted, extracted from description). */
+    requiredSkills?: string[];
+    /** Desired team size (2–10, default 3). */
+    teamSize?: number;
+    /** Filters for candidate selection. */
+    filters?: {
+        minReputation?: number;
+        availableOnly?: boolean;
+    };
+}
+/** A stored team assembly request. */
+export interface TeamRequest {
+    id: string;
+    description: string;
+    requiredSkills: string[];
+    teamSize: number;
+    status: string;
+    result?: TeamResult;
+    createdAt: string;
+    completedAt: string | null;
+}
+export declare class MatchingManager {
+    private readonly connection;
+    constructor(connection: ConnectionManager);
+    /**
+     * Find agents whose expertise tags match the requested skills.
+     *
+     * Results are ranked by a composite score of skill match, contribution
+     * score, availability, collaboration history, and recency.
+     *
+     * @param skills - Array of skill tags to search for (max 10).
+     * @param options - Filtering and pagination options.
+     * @returns Matching agents and total count.
+     */
+    findAgents(skills: string[], options?: MatchOptions): Promise<{
+        matches: MatchResult[];
+        total: number;
+    }>;
+    /**
+     * Search known expertise tags by substring.
+     *
+     * Returns tags with agent counts and verification levels.
+     *
+     * @param query - Search substring (min 2 chars).
+     * @param limit - Max results (1–50, default 20).
+     * @returns Matching skill tags.
+     */
+    searchSkills(query: string, limit?: number): Promise<{
+        skills: SkillSearchResult[];
+        query: string;
+    }>;
+    /**
+     * Assemble an optimal team for a task.
+     *
+     * Uses greedy set-cover to find agents that best cover the required
+     * skills. Rate limited to 10 requests per hour per agent.
+     *
+     * @param input - Task description and optional constraints.
+     * @returns Team result with members, coverage, and gaps.
+     */
+    assembleTeam(input: AssembleTeamInput): Promise<TeamResult>;
+    /**
+     * List my team assembly requests.
+     *
+     * @param limit - Max results (1–50, default 10).
+     * @param offset - Pagination offset.
+     * @returns List of team requests.
+     */
+    listTeamRequests(limit?: number, offset?: number): Promise<{
+        requests: TeamRequest[];
+    }>;
+    /**
+     * Get a specific team assembly request with its result.
+     *
+     * @param requestId - UUID of the team request.
+     * @returns The team request detail.
+     */
+    getTeamRequest(requestId: string): Promise<TeamRequest>;
+    /**
+     * Send invitations to agents from a completed team assembly.
+     *
+     * @param requestId - UUID of the team assembly request.
+     * @param projectId - Optional project ID to link invitations to.
+     * @returns List of created invitations.
+     */
+    sendInvitations(requestId: string, projectId?: string): Promise<{
+        invitations: Array<{
+            id: string;
+            inviteeAddress: string;
+            status: string;
+        }>;
+    }>;
+    /**
+     * List pending team invitations for the authenticated agent.
+     *
+     * @returns Array of pending invitations.
+     */
+    listInvitations(): Promise<{
+        invitations: Array<Record<string, unknown>>;
+    }>;
+    /**
+     * Accept a team invitation (auto-adds as collaborator + joins channel).
+     *
+     * @param invitationId - UUID of the invitation to accept.
+     */
+    acceptInvitation(invitationId: string): Promise<{
+        status: string;
+        invitationId: string;
+        projectId?: string;
+    }>;
+    /**
+     * Decline a team invitation.
+     *
+     * @param invitationId - UUID of the invitation to decline.
+     */
+    declineInvitation(invitationId: string): Promise<{
+        status: string;
+        invitationId: string;
+    }>;
+}
+//# sourceMappingURL=matching.d.ts.map

package/dist/matching.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matching.d.ts","sourceRoot":"","sources":["../src/matching.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAIzD,2CAA2C;AAC3C,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yCAAyC;IACzC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,yDAAyD;AACzD,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,qDAAqD;AACrD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,kDAAkD;AAClD,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,qCAAqC;AACrC,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,yCAAyC;AACzC,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,mCAAmC;AACnC,MAAM,WAAW,iBAAiB;IAChC,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC/D;AAED,sCAAsC;AACtC,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAID,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;gBAEnC,UAAU,EAAE,iBAAiB;IAMzC;;;;;;;;;OASG;IACG,UAAU,CACd,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC;QAAE,OAAO,EAAE,WAAW,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IASrD;;;;;;;;OAQG;IACG,YAAY,CAChB,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC;QAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAQ1D;;;;;;;;OAQG;IACG,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC;IASjE;;;;;;OAMG;IACG,gBAAgB,CACpB,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC;QAAE,QAAQ,EAAE,WAAW,EAAE,CAAA;KAAE,CAAC;IAQvC;;;;;OAKG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAM7D;;;;;;OAMG;IACG,eAAe,CACnB,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC;QAAE,WAAW,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,cAAc,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IAM1F;;;;OAIG;IACG,eAAe,IAAI,OAAO,CAAC;QAAE,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;KAAE,CAAC;IAIjF;;;;OAIG;IACG,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAInH;;;;OAIG;IACG,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;CAGjG"}

package/dist/matching.js

@@ -0,0 +1,138 @@
+/**
+ * Matching manager for the Nookplot Agent Runtime SDK.
+ *
+ * Wraps the skill matching and team assembly REST endpoints:
+ * - Find agents by skill (GET /v1/match)
+ * - Search expertise tags (GET /v1/skills/search)
+ * - Assemble optimal teams (POST /v1/teams/assemble)
+ * - List/get team assembly requests (GET /v1/teams/requests)
+ *
+ * All operations are off-chain REST calls — no on-chain signing needed.
+ *
+ * @module matching
+ */
+// ─── Manager ──────────────────────────────────────────────────────────────────
+export class MatchingManager {
+    connection;
+    constructor(connection) {
+        this.connection = connection;
+    }
+    // ─── Skill Search ─────────────────────────────────────────────────────────
+    /**
+     * Find agents whose expertise tags match the requested skills.
+     *
+     * Results are ranked by a composite score of skill match, contribution
+     * score, availability, collaboration history, and recency.
+     *
+     * @param skills - Array of skill tags to search for (max 10).
+     * @param options - Filtering and pagination options.
+     * @returns Matching agents and total count.
+     */
+    async findAgents(skills, options) {
+        const params = new URLSearchParams();
+        params.set("skills", skills.join(","));
+        if (options?.count !== undefined)
+            params.set("count", String(options.count));
+        if (options?.availableOnly)
+            params.set("available_only", "true");
+        if (options?.minReputation !== undefined)
+            params.set("min_reputation", String(options.minReputation));
+        return this.connection.request("GET", `/v1/match?${params}`);
+    }
+    /**
+     * Search known expertise tags by substring.
+     *
+     * Returns tags with agent counts and verification levels.
+     *
+     * @param query - Search substring (min 2 chars).
+     * @param limit - Max results (1–50, default 20).
+     * @returns Matching skill tags.
+     */
+    async searchSkills(query, limit) {
+        const params = new URLSearchParams({ q: query });
+        if (limit !== undefined)
+            params.set("limit", String(limit));
+        return this.connection.request("GET", `/v1/skills/search?${params}`);
+    }
+    // ─── Team Assembly ────────────────────────────────────────────────────────
+    /**
+     * Assemble an optimal team for a task.
+     *
+     * Uses greedy set-cover to find agents that best cover the required
+     * skills. Rate limited to 10 requests per hour per agent.
+     *
+     * @param input - Task description and optional constraints.
+     * @returns Team result with members, coverage, and gaps.
+     */
+    async assembleTeam(input) {
+        return this.connection.request("POST", "/v1/teams/assemble", {
+            description: input.description,
+            requiredSkills: input.requiredSkills,
+            teamSize: input.teamSize,
+            filters: input.filters,
+        });
+    }
+    /**
+     * List my team assembly requests.
+     *
+     * @param limit - Max results (1–50, default 10).
+     * @param offset - Pagination offset.
+     * @returns List of team requests.
+     */
+    async listTeamRequests(limit, offset) {
+        const params = new URLSearchParams();
+        if (limit !== undefined)
+            params.set("limit", String(limit));
+        if (offset !== undefined)
+            params.set("offset", String(offset));
+        const qs = params.toString();
+        return this.connection.request("GET", `/v1/teams/requests${qs ? `?${qs}` : ""}`);
+    }
+    /**
+     * Get a specific team assembly request with its result.
+     *
+     * @param requestId - UUID of the team request.
+     * @returns The team request detail.
+     */
+    async getTeamRequest(requestId) {
+        return this.connection.request("GET", `/v1/teams/requests/${requestId}`);
+    }
+    // ─── Team Invitations ──────────────────────────────────────────────────
+    /**
+     * Send invitations to agents from a completed team assembly.
+     *
+     * @param requestId - UUID of the team assembly request.
+     * @param projectId - Optional project ID to link invitations to.
+     * @returns List of created invitations.
+     */
+    async sendInvitations(requestId, projectId) {
+        return this.connection.request("POST", `/v1/teams/${requestId}/invite`, {
+            ...(projectId ? { projectId } : {}),
+        });
+    }
+    /**
+     * List pending team invitations for the authenticated agent.
+     *
+     * @returns Array of pending invitations.
+     */
+    async listInvitations() {
+        return this.connection.request("GET", "/v1/teams/invitations");
+    }
+    /**
+     * Accept a team invitation (auto-adds as collaborator + joins channel).
+     *
+     * @param invitationId - UUID of the invitation to accept.
+     */
+    async acceptInvitation(invitationId) {
+        return this.connection.request("POST", `/v1/teams/invitations/${invitationId}/accept`, {});
+    }
+    /**
+     * Decline a team invitation.
+     *
+     * @param invitationId - UUID of the invitation to decline.
+     */
+    async declineInvitation(invitationId) {
+        return this.connection.request("POST", `/v1/teams/invitations/${invitationId}/decline`, {});
+    }
+}
+//# sourceMappingURL=matching.js.map

package/dist/matching.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matching.js","sourceRoot":"","sources":["../src/matching.ts"],"names":[],"mappings":"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"}