ugcinc 4.3.0 → 4.3.1

package/dist/accounts.d.ts

@@ -205,6 +205,21 @@ export interface CreateAccountsResponse {
     failed: number;
     accounts: CreateAccountResult[];
 }
+export type TroubleshootFailReason = 'proxy_issue';
+export interface TroubleshootAccount {
+    id: string;
+    username: string | null;
+    type: string;
+    status: string;
+    tag: string | null;
+    healthy: boolean;
+    fail_reason: TroubleshootFailReason | null;
+    failed_tasks: number;
+    total_tasks: number;
+}
+export interface TroubleshootParams {
+    accountIds?: string[];
+}
 /**
  * Client for managing accounts
  */
@@ -294,4 +309,17 @@ export declare class AccountsClient extends BaseClient {
      * });
      */
     createAccounts(params: CreateAccountsParams): Promise<ApiResponse<CreateAccountsResponse>>;
+    /**
+     * Troubleshoot active accounts — checks proxy health and task stats
+     * Returns a health status and fail reason for each active emulated account
+     *
+     * @example
+     * const response = await client.accounts.troubleshoot();
+     *
+     * if (response.ok) {
+     *   const unhealthy = response.data.filter(a => !a.healthy);
+     *   console.log(`${unhealthy.length} accounts have issues`);
+     * }
+     */
+    troubleshoot(params?: TroubleshootParams): Promise<ApiResponse<TroubleshootAccount[]>>;
 }

package/dist/accounts.js

@@ -107,5 +107,20 @@ class AccountsClient extends base_1.BaseClient {
     async createAccounts(params) {
         return this.post('/accounts/create', params);
     }
+    /**
+     * Troubleshoot active accounts — checks proxy health and task stats
+     * Returns a health status and fail reason for each active emulated account
+     *
+     * @example
+     * const response = await client.accounts.troubleshoot();
+     *
+     * if (response.ok) {
+     *   const unhealthy = response.data.filter(a => !a.healthy);
+     *   console.log(`${unhealthy.length} accounts have issues`);
+     * }
+     */
+    async troubleshoot(params) {
+        return this.post('/accounts/troubleshoot', params ?? {});
+    }
 }
 exports.AccountsClient = AccountsClient;

package/dist/index.d.ts

@@ -25,7 +25,7 @@ export type { PortId } from './port-id';
 export { extractTemplateVariables, processTemplate, substituteVariables } from './automations/utils';
 export type { InputType } from './automations/nodes/types';
 export type { ClientConfig } from './base';
-export type { Account, AccountStat, AccountTask, EditProfileInfo, GetAccountsParams, GetAccountStatsParams, GetAccountStatusParams, AccountInfoUpdate, UpdateAccountInfoParams, AccountInfoUpdateResult, UpdateAccountInfoResponse, AccountSocialUpdate, UpdateAccountSocialParams, AccountSocialUpdateResult, UpdateAccountSocialResponse, DeleteAccountPostsParams, DeleteAccountPostsResponse, ResetWarmupParams, ResetWarmupResponse, NicheSwitchUpdate, NicheSwitchParams, NicheSwitchResult, NicheSwitchResponse, CreateAccountInput, CreateAccountsParams, CreateAccountResult, CreateAccountsResponse, } from './accounts';
+export type { Account, AccountStat, AccountTask, EditProfileInfo, GetAccountsParams, GetAccountStatsParams, GetAccountStatusParams, AccountInfoUpdate, UpdateAccountInfoParams, AccountInfoUpdateResult, UpdateAccountInfoResponse, AccountSocialUpdate, UpdateAccountSocialParams, AccountSocialUpdateResult, UpdateAccountSocialResponse, DeleteAccountPostsParams, DeleteAccountPostsResponse, ResetWarmupParams, ResetWarmupResponse, NicheSwitchUpdate, NicheSwitchParams, NicheSwitchResult, NicheSwitchResponse, CreateAccountInput, CreateAccountsParams, CreateAccountResult, CreateAccountsResponse, TroubleshootFailReason, TroubleshootAccount, TroubleshootParams, } from './accounts';
 export type { TaskType, Task, GetTasksParams } from './tasks';
 export type { PostType, PostStatus, Post, PostStat, GetPostsParams, CreateSlideshowParams, GetPostStatsParams, GetPostStatusParams, CreateVideoParams, UpdatePostParams, DeletePostsParams, DeletePostsResponse, RetryPostsParams, SetPostStatusParams, SetPostStatusResponse, } from './posts';
 export type { RefreshStatsParams, RefreshStatsError, RefreshStatsResponse, DailyAggregatedStat, GetDailyAggregatedStatsParams, DailyAccountStat, GetDailyAccountStatsParams, DailyPostStat, GetDailyPostStatsParams, DashboardDailyStat, GetDashboardDailyStatsParams, TopAccount, GetTopAccountsParams, TopPost, GetTopPostsParams, } from './stats';

package/dist/tools/accounts.js

@@ -124,4 +124,14 @@ exports.accountTools = [
             return client.accounts.createAccounts(params);
         },
     },
+    {
+        name: 'troubleshoot_accounts',
+        description: 'Check health of active accounts. Returns whether each account is healthy and a fail_reason if not. Currently detects proxy_issue (proxy is down or missing).',
+        schema: zod_1.z.object({
+            accountIds: zod_1.z.array(zod_1.z.string()).optional().describe('Specific account IDs to check. If omitted, checks all active accounts.'),
+        }).optional(),
+        execute: async (client, params) => {
+            return client.accounts.troubleshoot(params ?? undefined);
+        },
+    },
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ugcinc",
-  "version": "4.3.0",
+  "version": "4.3.1",
   "description": "TypeScript/JavaScript client for the UGC Inc API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",