@teamlearners/clawops 0.14.0 → 0.15.1

package/dist/index.d.ts

@@ -86,6 +86,148 @@ declare class Page<T> {
     autoPagingIter(): AsyncGenerator<T>;
 }
 
+declare const AssignmentLinkAssignmentSchema: z.ZodObject<{
+    number: z.ZodString;
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    consumedAt: z.ZodString;
+    releasedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    number: z.ZodString;
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    consumedAt: z.ZodString;
+    releasedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    number: z.ZodString;
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    consumedAt: z.ZodString;
+    releasedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.ZodTypeAny, "passthrough">>;
+declare const AssignmentLinkSchema: z.ZodObject<{
+    linkId: z.ZodString;
+    url: z.ZodString;
+    status: z.ZodEnum<["pending", "consumed", "expired", "revoked"]>;
+    createdAt: z.ZodString;
+    expiresAt: z.ZodString;
+    consumedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    webhookUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    webhookMethod: z.ZodOptional<z.ZodNullable<z.ZodEnum<["POST", "GET"]>>>;
+    note: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    assignment: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        number: z.ZodString;
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        consumedAt: z.ZodString;
+        releasedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        number: z.ZodString;
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        consumedAt: z.ZodString;
+        releasedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        number: z.ZodString;
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        consumedAt: z.ZodString;
+        releasedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.ZodTypeAny, "passthrough">>>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    linkId: z.ZodString;
+    url: z.ZodString;
+    status: z.ZodEnum<["pending", "consumed", "expired", "revoked"]>;
+    createdAt: z.ZodString;
+    expiresAt: z.ZodString;
+    consumedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    webhookUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    webhookMethod: z.ZodOptional<z.ZodNullable<z.ZodEnum<["POST", "GET"]>>>;
+    note: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    assignment: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        number: z.ZodString;
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        consumedAt: z.ZodString;
+        releasedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        number: z.ZodString;
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        consumedAt: z.ZodString;
+        releasedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        number: z.ZodString;
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        consumedAt: z.ZodString;
+        releasedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.ZodTypeAny, "passthrough">>>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    linkId: z.ZodString;
+    url: z.ZodString;
+    status: z.ZodEnum<["pending", "consumed", "expired", "revoked"]>;
+    createdAt: z.ZodString;
+    expiresAt: z.ZodString;
+    consumedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    webhookUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    webhookMethod: z.ZodOptional<z.ZodNullable<z.ZodEnum<["POST", "GET"]>>>;
+    note: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    assignment: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        number: z.ZodString;
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        consumedAt: z.ZodString;
+        releasedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        number: z.ZodString;
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        consumedAt: z.ZodString;
+        releasedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        number: z.ZodString;
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        consumedAt: z.ZodString;
+        releasedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.ZodTypeAny, "passthrough">>>>;
+}, z.ZodTypeAny, "passthrough">>;
+declare const AssignmentLinkCreateResponseSchema: z.ZodObject<{
+    token: z.ZodString;
+    url: z.ZodString;
+    expiresAt: z.ZodString;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    token: z.ZodString;
+    url: z.ZodString;
+    expiresAt: z.ZodString;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    token: z.ZodString;
+    url: z.ZodString;
+    expiresAt: z.ZodString;
+}, z.ZodTypeAny, "passthrough">>;
+type AssignmentLinkAssignment = z.infer<typeof AssignmentLinkAssignmentSchema>;
+type AssignmentLink = z.infer<typeof AssignmentLinkSchema>;
+type AssignmentLinkCreateResponse = z.infer<typeof AssignmentLinkCreateResponseSchema>;
+type AssignmentLinkStatus = AssignmentLink['status'];
+
+type RequestOptions = {
+    extraHeaders?: Record<string, string>;
+    extraQuery?: Record<string, unknown>;
+    timeout?: number;
+};
+/**
+ * 관리번호(External Assignment) 발급 링크 리소스.
+ *
+ * POST/DELETE는 `external_assignment` 애드온이 활성화된 계정에서만 가능합니다.
+ * GET 조회는 애드온 활성 여부와 무관하게 가능합니다.
+ */
+declare class AssignmentLinks extends APIResource {
+    create(params?: {
+        webhookUrl?: string;
+        webhookMethod?: 'POST' | 'GET';
+        note?: string;
+    }, options?: RequestOptions): Promise<AssignmentLinkCreateResponse>;
+    list(params?: {
+        status?: AssignmentLinkStatus;
+        page?: number;
+        pageSize?: number;
+    }, options?: RequestOptions): Promise<Page<AssignmentLink>>;
+    retrieve(linkId: string, options?: RequestOptions): Promise<AssignmentLink>;
+    revoke(linkId: string, options?: {
+        extraHeaders?: Record<string, string>;
+        timeout?: number;
+    }): Promise<void>;
+}
+
 declare const CallSchema: z.ZodObject<{
     callId: z.ZodString;
     status: z.ZodEnum<["queued", "ringing", "in-progress", "completed", "failed"]>;
@@ -307,6 +449,46 @@ declare const TranscriptRequestAcceptedSchema: z.ZodObject<{
 }, z.ZodTypeAny, "passthrough">>;
 type TranscriptRequestAccepted = z.infer<typeof TranscriptRequestAcceptedSchema>;
 
+/**
+ * 통화 요약 상태. status 에 따라 채워지는 필드가 다름:
+ * - "completed": callId, resultJson, provider, model, promptVersion, schemaVersion, updatedAt
+ * - "pending":   이외 필드 비어있음
+ * - "failed":    failedReason
+ * - "not_requested": 통화는 있지만 요약 row 가 아직 없음
+ */
+declare const SummaryStatusSchema: z.ZodObject<{
+    status: z.ZodEnum<["completed", "pending", "failed", "not_requested"]>;
+    callId: z.ZodOptional<z.ZodString>;
+    resultJson: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    provider: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    promptVersion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    schemaVersion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    failedReason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    updatedAt: z.ZodOptional<z.ZodString>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    status: z.ZodEnum<["completed", "pending", "failed", "not_requested"]>;
+    callId: z.ZodOptional<z.ZodString>;
+    resultJson: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    provider: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    promptVersion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    schemaVersion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    failedReason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    updatedAt: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    status: z.ZodEnum<["completed", "pending", "failed", "not_requested"]>;
+    callId: z.ZodOptional<z.ZodString>;
+    resultJson: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    provider: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    promptVersion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    schemaVersion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    failedReason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    updatedAt: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">>;
+type SummaryStatus = z.infer<typeof SummaryStatusSchema>;
+
 declare class Calls extends APIResource {
     create(params: CallCreateParams, options?: {
         extraHeaders?: Record<string, string>;
@@ -358,6 +540,18 @@ declare class Calls extends APIResource {
         extraQuery?: Record<string, unknown>;
         timeout?: number;
     }): Promise<TranscriptRequestAccepted>;
+    /**
+     * 통화 요약 상태 조회. transcript 가 완료된 통화에 대해 자동 생성된
+     * LLM 구조화 요약 결과를 반환합니다. completed 일 때 resultJson 채워짐.
+     *
+     * @throws NotFoundError (404) — 통화 없음
+     * @throws PermissionDeniedError (403) — accountId 불일치
+     */
+    getSummary(callId: string, options?: {
+        extraHeaders?: Record<string, string>;
+        extraQuery?: Record<string, unknown>;
+        timeout?: number;
+    }): Promise<SummaryStatus>;
 }
 
 declare const MessageSchema: z.ZodObject<{
@@ -552,6 +746,7 @@ declare class AccountContext {
     get messages(): Messages;
     get numbers(): Numbers;
     get webhookLogs(): WebhookLogs;
+    get assignmentLinks(): AssignmentLinks;
 }
 
 declare class ClawOpsError extends Error {
@@ -732,6 +927,7 @@ declare class ClawOps extends APIClient {
     get messages(): Messages;
     get numbers(): Numbers;
     get webhookLogs(): WebhookLogs;
+    get assignmentLinks(): AssignmentLinks;
     get webhooks(): Webhooks;
     accounts(accountId: string): AccountContext;
 }
@@ -761,4 +957,4 @@ interface NumberUpdateParams {
     webhookMethod?: 'POST' | 'GET';
 }
 
-export { APIClient, type APIClientOptions, APIConnectionError, APIError, APIResponseValidationError, APIStatusError, APITimeoutError, AccountContext, AgentConnectionError, AgentError, AuthenticationError, BadRequestError, type Call, type CallControlResponse, type CallCreateParams, type CallListParams, type CallUpdateParams, Calls, ClawOps, ClawOpsError, type ClawOpsOptions, ConflictError, InternalServerError, type Message, type MessageCreateParams, type MessageListParams, Messages, NotFoundError, type NumberCreateParams, type NumberListItem, type NumberUpdateParams, type NumberUpdateResponse, Numbers, Page, type PaginationMeta, PermissionDeniedError, type PhoneNumber, RateLimitError, ServiceUnavailableError, UnprocessableEntityError, VERSION, type WebhookLog, WebhookLogs, WebhookVerificationError, Webhooks, ClawOps as default };
+export { APIClient, type APIClientOptions, APIConnectionError, APIError, APIResponseValidationError, APIStatusError, APITimeoutError, AccountContext, AgentConnectionError, AgentError, type AssignmentLink, type AssignmentLinkAssignment, type AssignmentLinkCreateResponse, type AssignmentLinkStatus, AssignmentLinks, AuthenticationError, BadRequestError, type Call, type CallControlResponse, type CallCreateParams, type CallListParams, type CallUpdateParams, Calls, ClawOps, ClawOpsError, type ClawOpsOptions, ConflictError, InternalServerError, type Message, type MessageCreateParams, type MessageListParams, Messages, NotFoundError, type NumberCreateParams, type NumberListItem, type NumberUpdateParams, type NumberUpdateResponse, Numbers, Page, type PaginationMeta, PermissionDeniedError, type PhoneNumber, RateLimitError, ServiceUnavailableError, UnprocessableEntityError, VERSION, type WebhookLog, WebhookLogs, WebhookVerificationError, Webhooks, ClawOps as default };

package/dist/index.js

@@ -1,5 +1,5 @@
-import { DEFAULT_BASE_URL, DEFAULT_MAX_RETRIES, DEFAULT_TIMEOUT, VERSION, APITimeoutError, APIConnectionError, APIResponseValidationError, makeStatusError, ClawOpsError, INITIAL_RETRY_DELAY, MAX_RETRY_DELAY } from './chunk-6S6PV2RY.js';
-export { APIConnectionError, APIError, APIResponseValidationError, APIStatusError, APITimeoutError, AgentConnectionError, AgentError, AuthenticationError, BadRequestError, ClawOpsError, ConflictError, InternalServerError, NotFoundError, PermissionDeniedError, RateLimitError, ServiceUnavailableError, UnprocessableEntityError, VERSION } from './chunk-6S6PV2RY.js';
+import { DEFAULT_BASE_URL, DEFAULT_MAX_RETRIES, DEFAULT_TIMEOUT, VERSION, APITimeoutError, APIConnectionError, APIResponseValidationError, makeStatusError, ClawOpsError, INITIAL_RETRY_DELAY, MAX_RETRY_DELAY } from './chunk-Z4W4G7RD.js';
+export { APIConnectionError, APIError, APIResponseValidationError, APIStatusError, APITimeoutError, AgentConnectionError, AgentError, AuthenticationError, BadRequestError, ClawOpsError, ConflictError, InternalServerError, NotFoundError, PermissionDeniedError, RateLimitError, ServiceUnavailableError, UnprocessableEntityError, VERSION } from './chunk-Z4W4G7RD.js';
 import { z } from 'zod';
 import { timingSafeEqual, createHmac } from 'crypto';
 
@@ -233,6 +233,74 @@ var Page = class _Page {
     }
   }
 };
+var AssignmentLinkAssignmentSchema = z.object({
+  number: z.string(),
+  name: z.string().nullable().optional(),
+  consumedAt: z.string(),
+  releasedAt: z.string().nullable().optional()
+}).passthrough();
+var AssignmentLinkSchema = z.object({
+  linkId: z.string(),
+  url: z.string(),
+  status: z.enum(["pending", "consumed", "expired", "revoked"]),
+  createdAt: z.string(),
+  expiresAt: z.string(),
+  consumedAt: z.string().nullable().optional(),
+  webhookUrl: z.string().nullable().optional(),
+  webhookMethod: z.enum(["POST", "GET"]).nullable().optional(),
+  note: z.string().nullable().optional(),
+  assignment: AssignmentLinkAssignmentSchema.nullable().optional()
+}).passthrough();
+var AssignmentLinkCreateResponseSchema = z.object({
+  token: z.string(),
+  url: z.string(),
+  expiresAt: z.string()
+}).passthrough();
+
+// src/resources/assignment-links.ts
+var AssignmentLinks = class extends APIResource {
+  async create(params = {}, options = {}) {
+    const body = stripNotGiven({
+      webhookUrl: params.webhookUrl,
+      webhookMethod: params.webhookMethod,
+      note: params.note
+    });
+    return this._client._post(`${this._basePath}/assignment-links`, {
+      body: Object.keys(body).length ? body : void 0,
+      castTo: AssignmentLinkCreateResponseSchema,
+      ...options
+    });
+  }
+  async list(params = {}, options = {}) {
+    const query = stripNotGiven({
+      status: params.status,
+      page: params.page,
+      pageSize: params.pageSize
+    });
+    const path = `${this._basePath}/assignment-links`;
+    const schema = PageSchema(AssignmentLinkSchema);
+    const raw = await this._client._get(path, {
+      castTo: schema,
+      query: Object.keys(query).length ? query : void 0,
+      ...options
+    });
+    const page = new Page(raw.data, raw.meta);
+    page._setClient(this._client, path, AssignmentLinkSchema, query);
+    return page;
+  }
+  async retrieve(linkId, options = {}) {
+    return this._client._get(`${this._basePath}/assignment-links/${linkId}`, {
+      castTo: AssignmentLinkSchema,
+      ...options
+    });
+  }
+  async revoke(linkId, options = {}) {
+    await this._client._delete(
+      `${this._basePath}/assignment-links/${linkId}`,
+      options
+    );
+  }
+};
 var CallSchema = z.object({
   callId: z.string(),
   status: z.enum(["queued", "ringing", "in-progress", "completed", "failed"]),
@@ -267,6 +335,17 @@ var TranscriptRequestAcceptedSchema = z.object({
   status: z.literal("pending"),
   callId: z.string()
 }).passthrough();
+var SummaryStatusSchema = z.object({
+  status: z.enum(["completed", "pending", "failed", "not_requested"]),
+  callId: z.string().optional(),
+  resultJson: z.record(z.string(), z.unknown()).nullable().optional(),
+  provider: z.string().nullable().optional(),
+  model: z.string().nullable().optional(),
+  promptVersion: z.string().nullable().optional(),
+  schemaVersion: z.string().nullable().optional(),
+  failedReason: z.string().nullable().optional(),
+  updatedAt: z.string().optional()
+}).passthrough();
 
 // src/resources/calls.ts
 var Calls = class extends APIResource {
@@ -360,6 +439,19 @@ var Calls = class extends APIResource {
       ...options
     });
   }
+  /**
+   * 통화 요약 상태 조회. transcript 가 완료된 통화에 대해 자동 생성된
+   * LLM 구조화 요약 결과를 반환합니다. completed 일 때 resultJson 채워짐.
+   *
+   * @throws NotFoundError (404) — 통화 없음
+   * @throws PermissionDeniedError (403) — accountId 불일치
+   */
+  async getSummary(callId, options = {}) {
+    return this._client._get(`${this._basePath}/calls/${callId}/summary`, {
+      castTo: SummaryStatusSchema,
+      ...options
+    });
+  }
 };
 var MessageSchema = z.object({
   messageId: z.string(),
@@ -513,6 +605,9 @@ var AccountContext = class {
   get webhookLogs() {
     return new WebhookLogs(this._client, this._accountId);
   }
+  get assignmentLinks() {
+    return new AssignmentLinks(this._client, this._accountId);
+  }
 };
 var WebhookVerificationError = class extends ClawOpsError {
   constructor(message = "Webhook \uC11C\uBA85\uC774 \uC77C\uCE58\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.") {
@@ -573,6 +668,9 @@ var ClawOps = class extends APIClient {
   get webhookLogs() {
     return new WebhookLogs(this, this._defaultAccountId);
   }
+  get assignmentLinks() {
+    return new AssignmentLinks(this, this._defaultAccountId);
+  }
   get webhooks() {
     return new Webhooks();
   }
@@ -584,6 +682,6 @@ var ClawOps = class extends APIClient {
 // src/client-default.ts
 var client_default_default = ClawOps;
 
-export { APIClient, AccountContext, Calls, ClawOps, Messages, Numbers, Page, WebhookLogs, WebhookVerificationError, Webhooks, client_default_default as default };
+export { APIClient, AccountContext, AssignmentLinks, Calls, ClawOps, Messages, Numbers, Page, WebhookLogs, WebhookVerificationError, Webhooks, client_default_default as default };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map