ugcinc 4.2.0 → 4.3.1

package/dist/accounts.d.ts

@@ -3,6 +3,7 @@ import type { ApiResponse } from './types';
 export interface Account {
     id: string;
     org_id: string;
+    org_name: string | null;
     type: string;
     tag: string | null;
     org_group: string | null;
@@ -204,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
  */
@@ -293,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,11 +25,11 @@ 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';
-export type { ApiKey, DeleteApiKeyParams, EditApiKeyParams, IntegrationKey, IntegrationProvider, UpsertIntegrationKeyParams, DeleteIntegrationKeyParams } from './org';
+export type { Org, ApiKey, DeleteApiKeyParams, EditApiKeyParams, IntegrationKey, IntegrationProvider, UpsertIntegrationKeyParams, DeleteIntegrationKeyParams } from './org';
 export type { UserMedia, MediaUse, SocialAudio, Media, GetMediaParams, GetSocialAudioParams, UploadMediaParams, UploadMediaResponse, MediaTagUpdate, UpdateMediaTagsParams, MediaTagUpdateResult, UpdateMediaTagsResponse, UpdateMediaTagParams, UpdateMediaNameParams, DeleteMediaParams, DeleteMediaResponse, CreateSocialAudioParams, ImportTextParams, ImportTextResponse, CreateMediaFromUrlParams, GetMediaUseParams, GetMediaUseResponse, FilterMediaParams, FilterMediaResponse, GetUploadTokenParams, UploadTokenResponse, } from './media';
 export type { CommentStatus, Comment, CreateCommentParams, CreateCommentResponse, GetCommentsParams, } from './comments';
 export type { BillingInfo, CancelSubscriptionResponse, PortalUrlResponse, DeactivateAccountParams, DeactivateAccountResponse, RequestReplacementParams, RequestReplacementResponse, RequestRefundParams, RequestRefundResponse, BillingRequestInfo, PortalParams, } from './billing';

package/dist/org.d.ts

@@ -1,5 +1,9 @@
 import { BaseClient } from './base';
 import type { ApiResponse } from './types';
+export interface Org {
+    id: string;
+    name: string | null;
+}
 export interface ApiKey {
     id: string;
     name: string;
@@ -33,6 +37,11 @@ export interface DeleteIntegrationKeyParams {
  * Client for managing organization resources
  */
 export declare class OrganizationClient extends BaseClient {
+    /**
+     * Get organizations linked to your API key
+     * Org-scoped key returns the single org; profile-scoped key returns all linked orgs
+     */
+    getOrgs(): Promise<ApiResponse<Org[]>>;
     /**
      * Update the organization's name
      * @param params - The new name for the organization

package/dist/org.js

@@ -6,6 +6,13 @@ const base_1 = require("./base");
  * Client for managing organization resources
  */
 class OrganizationClient extends base_1.BaseClient {
+    /**
+     * Get organizations linked to your API key
+     * Org-scoped key returns the single org; profile-scoped key returns all linked orgs
+     */
+    async getOrgs() {
+        return this.get('/org');
+    }
     /**
      * Update the organization's name
      * @param params - The new name for the organization

package/dist/skills.js

@@ -18,8 +18,14 @@ Auth: \`npx ugcinc auth <api_key> [--admin]\`. Only needed once. Use \`--admin\`
 
 ## Tools
 
+### list_orgs
+List organizations linked to your API key.
+\`\`\`bash
+${run} list_orgs
+\`\`\`
+
 ### list_accounts
-List accounts with optional filters.
+List accounts with optional filters. Each account includes \`org_name\`.
 \`\`\`bash
 ${run} list_accounts
 ${run} list_accounts '{"tag":"fitness"}'

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/dist/tools/org.js

@@ -3,6 +3,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.orgTools = void 0;
 const zod_1 = require("zod");
 exports.orgTools = [
+    {
+        name: 'list_orgs',
+        description: 'List organizations linked to your API key. Returns org IDs and names.',
+        schema: zod_1.z.object({}).optional(),
+        execute: async (client) => {
+            return client.org.getOrgs();
+        },
+    },
     {
         name: 'update_org_name',
         description: 'Update the name of the organization.',

package/package.json

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