@usepylon/sdk 0.1.0-alpha.3 → 0.1.0-alpha.5

package/dist/esm/api/types/GetUserStatusesResponseBody.js

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/ImportIssueRequest.d.ts

@@ -26,7 +26,7 @@ export interface ImportIssueRequest {
     messages: Pylon.ImportIssueMessage[];
     /** The ID of a partner account that serves account_id. Requires account_id. */
     partner_account_id?: string | undefined;
-    /** ContactID that the issue should be on behalf of. */
+    /** ContactID that the issue should be on behalf of. If omitted, the issue has no requester. */
     requester_id?: string | undefined;
     /** ResolutionTime is the time the issue was resolved (RFC3339). */
     resolution_time?: string | undefined;

package/dist/esm/api/types/Issue.d.ts

@@ -37,12 +37,17 @@ export interface Issue {
     external_issues?: Pylon.ExternalIssue[] | undefined;
     /** The time of the first resolution of the issue, if any. Frozen at the issue's first resolution and never updated on reopen/re-resolve. */
     first_resolution_time?: (string | null) | undefined;
+    /** The ID of the user the issue was assigned to when its first response SLA breached, if it breached. */
+    first_response_assignee_id_at_breach?: string | undefined;
     /** The time by which the issue's first response SLA will breach, if any. Only present for issues with an active first response SLA. */
     first_response_breach_time?: string | undefined;
+    /** The ID of the user whose action resolved the issue's first response SLA. Absent when resolved by a contact or automation. */
+    first_response_resolving_user_id?: string | undefined;
     /** The time in seconds it took for the first response to the issue, if any. */
     first_response_seconds?: number | undefined;
     /** The time of the first response to the issue, if any. */
     first_response_time?: (string | null) | undefined;
+    follow_up?: Pylon.SlaTimes | undefined;
     /** The ID of the issue. */
     id: string;
     /** Whether this issue is an issue group. */
@@ -51,14 +56,19 @@ export interface Issue {
     latest_message_time?: (string | null) | undefined;
     /** The link to the issue in Pylon. */
     link: string;
+    next_reply?: Pylon.SlaTimes | undefined;
     /** The number of the issue. */
     number: number;
     /** The number of times the issue has been touched. */
     number_of_touches: number;
     parent_issue_group?: Pylon.MiniIssue | undefined;
     requester?: (Pylon.MiniContact | null) | undefined;
+    /** The ID of the user the issue was assigned to when its resolution SLA breached, if it breached. */
+    resolution_assignee_id_at_breach?: string | undefined;
     /** The time by which the issue's resolution SLA will breach, if any. Only present for open issues with an active resolution SLA. */
     resolution_breach_time?: string | undefined;
+    /** The ID of the user whose action resolved the issue's resolution SLA. Absent when resolved by a contact or automation. */
+    resolution_resolving_user_id?: string | undefined;
     /** The time in seconds it took for the issue to be resolved, if any. */
     resolution_seconds?: number | undefined;
     /** The time of the resolution of the issue, if any. */
@@ -93,4 +103,6 @@ export interface Issue {
     updated_at: string;
     /** The email address connected to the Pylon workspace through which the issue's email conversation is routed. For inbound issues, this is the address that received the original email. */
     workspace_email?: string | undefined;
+    /** The WhatsApp, SMS, or voice phone number connected to the Pylon workspace through which the issue's conversation is routed. For inbound issues, this is the number the customer messaged or called. */
+    workspace_phone_number?: string | undefined;
 }

package/dist/esm/api/types/MergeContactsResponseBody.d.ts

@@ -0,0 +1,6 @@
+import type * as Pylon from "../index.js";
+export interface MergeContactsResponseBody {
+    data: Pylon.Contact;
+    /** The request ID for tracking. */
+    request_id: string;
+}

package/dist/esm/api/types/MergeContactsResponseBody.js

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/Message.d.ts

@@ -12,6 +12,9 @@ export interface Message {
     is_private: boolean;
     /** The HTML body of the message. */
     message_html: string;
+    /** The emoji reactions currently on the message, grouped by emoji. */
+    reactions?: (Pylon.MessageReaction[] | null) | undefined;
+    slack_info?: Pylon.SlackMessageInfo | undefined;
     /** The source of the message. */
     source: string;
     /** The Pylon internal thread ID. This is set only for internal notes and can be passed as thread_id when creating an internal note. */

package/dist/esm/api/types/MessageReaction.d.ts

@@ -0,0 +1,6 @@
+export interface MessageReaction {
+    /** The number of people who reacted with this emoji. */
+    count: number;
+    /** The emoji's Slack-style shortcode name without colons, such as thumbsup. */
+    name: string;
+}

package/dist/esm/api/types/MessageReaction.js

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/Project.d.ts

@@ -1,6 +1,8 @@
 import type * as Pylon from "../index.js";
 export interface Project {
     account?: Pylon.MiniAccount | undefined;
+    /** Instructions the AI follows when keeping this smart project up to date. */
+    ai_instructions: string;
     /** The archived at time of the project in RFC3339 format. */
     archived_at?: string | undefined;
     /** The created at time of the project. */

package/dist/esm/api/types/SlaTimes.d.ts

@@ -1,9 +1,13 @@
 export interface SlaTimes {
+    /** The ID of the user the issue was assigned to when the breach was detected, if it breached. */
+    assignee_id_at_breach?: string | undefined;
     /** The time at which it breaches (or has breached), if any. */
     breach_time?: string | undefined;
-    /** The elapsed business-hours time in seconds, if any. */
+    /** The part of `seconds` that falls within support hours, if any. */
     business_hours_seconds?: number | undefined;
-    /** The elapsed time in seconds, if any. */
+    /** The ID of the user whose action resolved it, if any. Absent when it was resolved by a contact or automation. */
+    resolving_user_id?: string | undefined;
+    /** The elapsed time in seconds, counting only time the issue spent in states that count toward this SLA. May be less than the time between the SLA's start and `time`. */
     seconds?: number | undefined;
     /** The time it was reached, if any. */
     time?: (string | null) | undefined;

package/dist/esm/api/types/SlackMessageInfo.d.ts

@@ -0,0 +1,10 @@
+export interface SlackMessageInfo {
+    /** The Slack channel ID the message was posted in. */
+    channel_id: string;
+    /** The Slack timestamp of this message, which is its Slack message ID. */
+    message_ts: string;
+    /** A link that opens this specific message in Slack. Omitted when the workspace's Slack domain is unknown. */
+    permalink?: string | undefined;
+    /** The timestamp of the thread's root message. Equal to message_ts for the root message itself. */
+    thread_ts: string;
+}

package/dist/esm/api/types/SlackMessageInfo.js

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/Task.d.ts

@@ -1,7 +1,13 @@
 import type * as Pylon from "../index.js";
 export interface Task {
     account?: Pylon.MiniAccount | undefined;
+    /** Instructions the AI follows when evaluating this task in a smart project. */
+    ai_instructions: string;
     assignee?: Pylon.Actor | undefined;
+    /** The IDs of tasks that block this task. */
+    blocked_by_task_ids?: (string[] | null) | undefined;
+    /** The IDs of tasks that this task blocks. */
+    blocks_task_ids?: (string[] | null) | undefined;
     /** The body of the task in HTML format. */
     body_html: string;
     /** The completion time of the task in RFC3339 format. */

package/dist/esm/api/types/TeamAssignmentConfiguration.d.ts

@@ -1,7 +1,16 @@
 export interface TeamAssignmentConfiguration {
+    /**
+     * The slugs of the user statuses members must show to be assigned. See GET /user-statuses.
+     * Empty defers to only_assign_if_user_active.
+     */
+    assignable_user_statuses?: (string[] | null) | undefined;
     /** How issues are routed to team members. One of routing, schedule, manual, pull_queue. */
     assignment_method: string;
-    /** Whether issues are only assigned to members who are currently active. */
+    /**
+     * Whether automatic assignment is restricted by user status. When assignable_user_statuses
+     * is empty, true means only members with an Active status; when it is non-empty, this is
+     * always true and the list decides.
+     */
     only_assign_if_user_active: boolean;
     /** Whether assignment replaces an existing assignee. */
     override_existing_assignee: boolean;

package/dist/esm/api/types/TeamAssignmentConfigurationInput.d.ts

@@ -1,10 +1,19 @@
 export interface TeamAssignmentConfigurationInput {
+    /**
+     * The slugs of the user statuses members must show to be assigned. See GET /user-statuses.
+     * A non-empty list takes precedence over only_assign_if_user_active; an empty list clears
+     * the allow-list so only_assign_if_user_active decides.
+     */
+    assignable_user_statuses?: string[] | undefined;
     /**
      * How issues are routed to team members. Setting schedule routes from this team's own
      * schedule, so the team must already have one or be given one in the same request.
      */
     assignment_method?: TeamAssignmentConfigurationInput.AssignmentMethod | undefined;
-    /** Whether issues are only assigned to members who are currently active. */
+    /**
+     * Whether issues are only assigned to members with an Active status. Setting this without
+     * assignable_user_statuses clears any status allow-list.
+     */
     only_assign_if_user_active?: boolean | undefined;
     /** Whether assignment replaces an existing assignee. */
     override_existing_assignee?: boolean | undefined;

package/dist/esm/api/types/TeamSla.d.ts

@@ -2,6 +2,8 @@ import type * as Pylon from "../index.js";
 export interface TeamSla {
     first_resolution?: Pylon.SlaTimes | undefined;
     first_response?: Pylon.SlaTimes | undefined;
+    follow_up?: Pylon.SlaTimes | undefined;
+    next_reply?: Pylon.SlaTimes | undefined;
     resolution?: Pylon.SlaTimes | undefined;
     /** The ID of the team these are scoped to. */
     team_id: string;

package/dist/esm/api/types/User.d.ts

@@ -20,10 +20,8 @@ export interface User {
     role_ids?: (string[] | null) | undefined;
     /** All assigned roles, including SCIM-derived roles, sorted by ID. Empty when no roles are assigned. */
     roles?: (Pylon.MiniRole[] | null) | undefined;
-    /**
-     * The status of the user.
-     *
-     * Known values: ``, `active`, `away`, `out_of_office`. This list is not exhaustive.
-     */
+    /** The user's routing skills. Null when the caller lacks permission to read team settings. */
+    skills?: (Pylon.UserSkill[] | null) | undefined;
+    /** The status of the user. Standard values are `active`, `away`, and `out_of_office`; custom status slugs are also supported. See GET /user-statuses for each status's category. */
     status: string;
 }

package/dist/esm/api/types/UserSkill.d.ts

@@ -0,0 +1,13 @@
+import type * as Pylon from "../index.js";
+export interface UserSkill {
+    /** The issue custom field ID when attribute_type is `custom_field`, or the issue property, such as `language`, when attribute_type is `default_field`. */
+    attribute: string;
+    /**
+     * The kind of attribute the skill routes on.
+     *
+     * Known values: `custom_field`, `default_field`. This list is not exhaustive.
+     */
+    attribute_type: string;
+    /** The attribute values the user is skilled in, with their levels. */
+    values?: (Pylon.UserSkillValue[] | null) | undefined;
+}

package/dist/esm/api/types/UserSkill.js

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/UserSkillValue.d.ts

@@ -0,0 +1,6 @@
+export interface UserSkillValue {
+    /** The skill level, where 1 is the lowest. Pylon assigns levels 1 to 3. */
+    level: number;
+    /** The attribute value, such as a select option slug, a user ID, or a language code. */
+    value: string;
+}

package/dist/esm/api/types/UserSkillValue.js

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/UserStatus.d.ts

@@ -0,0 +1,12 @@
+export interface UserStatus {
+    /** The category of the user status. One of active, away, out_of_office. */
+    category: string;
+    /** Indicates if the user status is archived. */
+    is_archived: boolean;
+    /** Indicates if the user status is a built-in status. */
+    is_default_status: boolean;
+    /** The label of the user status. */
+    label: string;
+    /** The slug of the user status. Use it in a team's assignment_configuration.assignable_user_statuses. */
+    slug: string;
+}

package/dist/esm/api/types/UserStatus.js

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/index.d.ts

@@ -89,6 +89,8 @@ export * from "./DeleteTaskCommentResponseBody.js";
 export * from "./DeleteTaskResponseBody.js";
 export * from "./DeleteTrainingDataDocumentsResponseBody.js";
 export * from "./DestinationMetadata.js";
+export * from "./EmailActivity.js";
+export * from "./EmailActivityMessage.js";
 export * from "./EmailEvent.js";
 export * from "./EmailMessageInfo.js";
 export * from "./EmailSuppression.js";
@@ -120,6 +122,7 @@ export * from "./GetCustomFieldResponseBody.js";
 export * from "./GetCustomFieldsResponseBody.js";
 export * from "./GetCustomObjectResponseBody.js";
 export * from "./GetCustomObjectsResponseBody.js";
+export * from "./GetEmailActivitiesResponseBody.js";
 export * from "./GetEmailSuppressionsResponseBody.js";
 export * from "./GetFeatureRequestResponseBody.js";
 export * from "./GetIssueFollowersResponseBody.js";
@@ -155,6 +158,7 @@ export * from "./GetTicketFormsResponseBody.js";
 export * from "./GetTrainingDataResponseBody.js";
 export * from "./GetUserResponseBody.js";
 export * from "./GetUserRolesResponseBody.js";
+export * from "./GetUserStatusesResponseBody.js";
 export * from "./GetUsersResponseBody.js";
 export * from "./ImportContactRequestBody.js";
 export * from "./ImportContactResponseBody.js";
@@ -191,10 +195,12 @@ export * from "./MacroGroup.js";
 export * from "./MarkIssuesAsSpamResponseBody.js";
 export * from "./Me.js";
 export * from "./MergeAccountsResponseBody.js";
+export * from "./MergeContactsResponseBody.js";
 export * from "./MergeFeatureRequestsResponseBody.js";
 export * from "./MergeIssuesResponseBody.js";
 export * from "./Message.js";
 export * from "./MessageAuthor.js";
+export * from "./MessageReaction.js";
 export * from "./MeUser.js";
 export * from "./Milestone.js";
 export * from "./MiniAccount.js";
@@ -231,6 +237,7 @@ export * from "./SelectMetadata.js";
 export * from "./SetFeatureRequestPortalVisibilityResponseBody.js";
 export * from "./SkippedIssue.js";
 export * from "./SlackInfo.js";
+export * from "./SlackMessageInfo.js";
 export * from "./SlaTimes.js";
 export * from "./SnoozeIssueResponseBody.js";
 export * from "./SubmitTicketFormField.js";
@@ -288,6 +295,9 @@ export * from "./UpdateUserResponseBody.js";
 export * from "./UploadAccountFileResponseBody.js";
 export * from "./User.js";
 export * from "./UserRole.js";
+export * from "./UserSkill.js";
+export * from "./UserSkillValue.js";
+export * from "./UserStatus.js";
 export * from "./Visibility.js";
 export * from "./VisibilityInput.js";
 export * from "./VoiceCall.js";

package/dist/esm/api/types/index.js

@@ -89,6 +89,8 @@ export * from "./DeleteTaskCommentResponseBody.js";
 export * from "./DeleteTaskResponseBody.js";
 export * from "./DeleteTrainingDataDocumentsResponseBody.js";
 export * from "./DestinationMetadata.js";
+export * from "./EmailActivity.js";
+export * from "./EmailActivityMessage.js";
 export * from "./EmailEvent.js";
 export * from "./EmailMessageInfo.js";
 export * from "./EmailSuppression.js";
@@ -120,6 +122,7 @@ export * from "./GetCustomFieldResponseBody.js";
 export * from "./GetCustomFieldsResponseBody.js";
 export * from "./GetCustomObjectResponseBody.js";
 export * from "./GetCustomObjectsResponseBody.js";
+export * from "./GetEmailActivitiesResponseBody.js";
 export * from "./GetEmailSuppressionsResponseBody.js";
 export * from "./GetFeatureRequestResponseBody.js";
 export * from "./GetIssueFollowersResponseBody.js";
@@ -155,6 +158,7 @@ export * from "./GetTicketFormsResponseBody.js";
 export * from "./GetTrainingDataResponseBody.js";
 export * from "./GetUserResponseBody.js";
 export * from "./GetUserRolesResponseBody.js";
+export * from "./GetUserStatusesResponseBody.js";
 export * from "./GetUsersResponseBody.js";
 export * from "./ImportContactRequestBody.js";
 export * from "./ImportContactResponseBody.js";
@@ -191,10 +195,12 @@ export * from "./MacroGroup.js";
 export * from "./MarkIssuesAsSpamResponseBody.js";
 export * from "./Me.js";
 export * from "./MergeAccountsResponseBody.js";
+export * from "./MergeContactsResponseBody.js";
 export * from "./MergeFeatureRequestsResponseBody.js";
 export * from "./MergeIssuesResponseBody.js";
 export * from "./Message.js";
 export * from "./MessageAuthor.js";
+export * from "./MessageReaction.js";
 export * from "./MeUser.js";
 export * from "./Milestone.js";
 export * from "./MiniAccount.js";
@@ -231,6 +237,7 @@ export * from "./SelectMetadata.js";
 export * from "./SetFeatureRequestPortalVisibilityResponseBody.js";
 export * from "./SkippedIssue.js";
 export * from "./SlackInfo.js";
+export * from "./SlackMessageInfo.js";
 export * from "./SlaTimes.js";
 export * from "./SnoozeIssueResponseBody.js";
 export * from "./SubmitTicketFormField.js";
@@ -288,6 +295,9 @@ export * from "./UpdateUserResponseBody.js";
 export * from "./UploadAccountFileResponseBody.js";
 export * from "./User.js";
 export * from "./UserRole.js";
+export * from "./UserSkill.js";
+export * from "./UserSkillValue.js";
+export * from "./UserStatus.js";
 export * from "./Visibility.js";
 export * from "./VisibilityInput.js";
 export * from "./VoiceCall.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usepylon/sdk",
-  "version": "0.1.0-alpha.3",
+  "version": "0.1.0-alpha.5",
   "description": "Official TypeScript SDK for the Pylon API",
   "license": "MIT",
   "homepage": "https://docs.usepylon.com",