@wiro-ai/wiro-mcp 1.3.4 → 1.4.1

package/dist/utils/user-agent.d.ts

@@ -0,0 +1,1199 @@
+import { z } from 'zod';
+import { type ToolCallContext } from './poll.js';
+export declare const AGENT_DASHBOARD_URL = "https://wiro.ai/panel/agents";
+export declare function agentDashboardUrl(guid: string): string;
+export declare const agentStatusLabelSchema: z.ZodEnum<["stopped", "stopping", "queued", "starting", "running", "error", "setup_required", "unknown"]>;
+export type AgentStatusLabel = z.infer<typeof agentStatusLabelSchema>;
+export declare function readAgentStatus(row: Record<string, unknown>): number | null;
+export declare function agentStatusLabel(status: number | null | undefined): AgentStatusLabel;
+/** "Running (4)" */
+export declare function describeAgentStatus(status: number | null | undefined): string;
+export declare const MEMBER_SETUP_HELP: string;
+/** plainMember: the connection acts as a member of the agent's team without admin rights. */
+export declare function agentStatusHint(status: number | null | undefined, plainMember?: boolean): string;
+/** Stopping, queued and starting move on by themselves; every other status stays until someone acts. */
+export declare function isTransitionalStatus(status: number | null | undefined): boolean;
+export declare const AGENT_TIERS: readonly ["starter", "pro"];
+export type AgentTier = typeof AGENT_TIERS[number];
+export declare const tierPriceSchema: z.ZodObject<{
+    priceUsd: z.ZodNumber;
+    monthlyCredits: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    priceUsd: number;
+    monthlyCredits: number;
+}, {
+    priceUsd: number;
+    monthlyCredits: number;
+}>;
+export declare const tierPricingSchema: z.ZodObject<{
+    starter: z.ZodObject<{
+        priceUsd: z.ZodNumber;
+        monthlyCredits: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        priceUsd: number;
+        monthlyCredits: number;
+    }, {
+        priceUsd: number;
+        monthlyCredits: number;
+    }>;
+    pro: z.ZodObject<{
+        priceUsd: z.ZodNumber;
+        monthlyCredits: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        priceUsd: number;
+        monthlyCredits: number;
+    }, {
+        priceUsd: number;
+        monthlyCredits: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    starter: {
+        priceUsd: number;
+        monthlyCredits: number;
+    };
+    pro: {
+        priceUsd: number;
+        monthlyCredits: number;
+    };
+}, {
+    starter: {
+        priceUsd: number;
+        monthlyCredits: number;
+    };
+    pro: {
+        priceUsd: number;
+        monthlyCredits: number;
+    };
+}>;
+export type TierPricing = z.infer<typeof tierPricingSchema>;
+/** Starter and Pro prices, or null when Wiro could not price the agent. */
+export declare function toTierPricing(value: unknown): TierPricing | null;
+export declare function asTier(value: unknown): AgentTier | undefined;
+export declare function formatUsd(value: number | null | undefined): string;
+export declare function formatCredits(value: number | null | undefined): string;
+export declare function roundUsd(value: number): number;
+export declare const AMOUNT_TOLERANCE_USD = 0.005;
+export declare function sameAmount(quoted: number, approved: number): boolean;
+export declare const subscriptionSchema: z.ZodObject<{
+    status: z.ZodString;
+    billing: z.ZodEnum<["wallet", "card"]>;
+    switchingToWallet: z.ZodBoolean;
+    amountUsd: z.ZodNullable<z.ZodNumber>;
+    periodEndsAt: z.ZodOptional<z.ZodString>;
+    daysRemaining: z.ZodNullable<z.ZodNumber>;
+    cancelAtPeriodEnd: z.ZodBoolean;
+    atPeriodEnd: z.ZodOptional<z.ZodEnum<["renews", "ends", "unknown"]>>;
+}, "strip", z.ZodTypeAny, {
+    status: string;
+    billing: "wallet" | "card";
+    switchingToWallet: boolean;
+    amountUsd: number | null;
+    daysRemaining: number | null;
+    cancelAtPeriodEnd: boolean;
+    periodEndsAt?: string | undefined;
+    atPeriodEnd?: "unknown" | "renews" | "ends" | undefined;
+}, {
+    status: string;
+    billing: "wallet" | "card";
+    switchingToWallet: boolean;
+    amountUsd: number | null;
+    daysRemaining: number | null;
+    cancelAtPeriodEnd: boolean;
+    periodEndsAt?: string | undefined;
+    atPeriodEnd?: "unknown" | "renews" | "ends" | undefined;
+}>;
+export type AgentSubscription = z.infer<typeof subscriptionSchema>;
+/**
+ * Whether a plan ends with its current period: true when it ends, false when
+ * it renews, null when that is not known. A wallet plan says so itself, and a
+ * card plan moving to wallet billing renews from the wallet. Any other card
+ * plan is known only when the row carries its card state (cardEnds).
+ */
+export declare function planEndsWithPeriod(subscription: Record<string, unknown>, cardEnds?: unknown): boolean | null;
+export declare function toSubscription(value: unknown, cardEnds?: unknown): AgentSubscription | null;
+/** How a new charge for this plan is paid right now. */
+export declare function chargeRoute(subscription: unknown): 'wallet' | 'card' | null;
+export declare const creditsSchema: z.ZodObject<{
+    monthly: z.ZodNumber;
+    extra: z.ZodNumber;
+    used: z.ZodNumber;
+    remaining: z.ZodNumber;
+    period: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    monthly: number;
+    extra: number;
+    used: number;
+    remaining: number;
+    period?: string | undefined;
+}, {
+    monthly: number;
+    extra: number;
+    used: number;
+    remaining: number;
+    period?: string | undefined;
+}>;
+export type AgentCredits = z.infer<typeof creditsSchema>;
+export declare function toCredits(row: Record<string, unknown>): AgentCredits;
+/** Plain text from catalog HTML. Links keep their target so setup steps stay usable. */
+export declare function htmlToText(value: unknown, maxLength?: number): string;
+export declare function toStringArray(value: unknown): string[];
+export declare const credentialStatusSchema: z.ZodObject<{
+    key: z.ZodString;
+    title: z.ZodString;
+    optional: z.ZodBoolean;
+    oauth: z.ZodBoolean;
+    connected: z.ZodBoolean;
+    filled: z.ZodBoolean;
+    requiredMissing: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    key: string;
+    optional: boolean;
+    title: string;
+    oauth: boolean;
+    connected: boolean;
+    filled: boolean;
+    requiredMissing: boolean;
+}, {
+    key: string;
+    optional: boolean;
+    title: string;
+    oauth: boolean;
+    connected: boolean;
+    filled: boolean;
+    requiredMissing: boolean;
+}>;
+export type CredentialStatus = z.infer<typeof credentialStatusSchema>;
+/** The state of each credential: whether it is filled, connected or missing. */
+export declare function summarizeCredentials(credentials: unknown, skipKeys?: Set<string>): CredentialStatus[];
+export declare const channelStatusSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    credentialKey: z.ZodString;
+    enabled: z.ZodBoolean;
+    configured: z.ZodBoolean;
+    missingFields: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    title: string;
+    credentialKey: string;
+    enabled: boolean;
+    configured: boolean;
+    missingFields: string[];
+}, {
+    id: string;
+    title: string;
+    credentialKey: string;
+    enabled: boolean;
+    configured: boolean;
+    missingFields: string[];
+}>;
+export type ChannelStatus = z.infer<typeof channelStatusSchema>;
+export declare function summarizeChannels(value: unknown): ChannelStatus[];
+export declare const agentTaskSchema: z.ZodObject<{
+    key: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    enabled: z.ZodBoolean;
+    interval: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    source: z.ZodOptional<z.ZodEnum<["template", "skill", "user"]>>;
+    instructions: z.ZodOptional<z.ZodString>;
+    instructionsTruncated: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    key: string;
+    enabled: boolean;
+    instructions?: string | undefined;
+    description?: string | undefined;
+    interval?: string | null | undefined;
+    source?: "user" | "template" | "skill" | undefined;
+    instructionsTruncated?: boolean | undefined;
+}, {
+    key: string;
+    enabled: boolean;
+    instructions?: string | undefined;
+    description?: string | undefined;
+    interval?: string | null | undefined;
+    source?: "user" | "template" | "skill" | undefined;
+    instructionsTruncated?: boolean | undefined;
+}>;
+export type AgentTask = z.infer<typeof agentTaskSchema>;
+/** Custom instructions and scheduled tasks, with the instruction text cut short. */
+export declare function summarizeTasks(value: unknown, maxInstructionLength?: number): AgentTask[];
+declare const selectableModelSchema: z.ZodObject<{
+    slug: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    inputCreditsPer1M: z.ZodOptional<z.ZodNumber>;
+    outputCreditsPer1M: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    slug: string;
+    label?: string | undefined;
+    inputCreditsPer1M?: number | undefined;
+    outputCreditsPer1M?: number | undefined;
+}, {
+    slug: string;
+    label?: string | undefined;
+    inputCreditsPer1M?: number | undefined;
+    outputCreditsPer1M?: number | undefined;
+}>;
+type SelectableModel = z.infer<typeof selectableModelSchema>;
+export declare const extraCreditPackSchema: z.ZodObject<{
+    pack: z.ZodString;
+    credits: z.ZodNumber;
+    priceUsd: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    priceUsd: number;
+    credits: number;
+    pack: string;
+}, {
+    priceUsd: number;
+    credits: number;
+    pack: string;
+}>;
+export declare const agentSummarySchema: z.ZodObject<{
+    guid: z.ZodString;
+    title: z.ZodString;
+    status: z.ZodNullable<z.ZodNumber>;
+    statusLabel: z.ZodEnum<["stopped", "stopping", "queued", "starting", "running", "error", "setup_required", "unknown"]>;
+    setupRequired: z.ZodBoolean;
+    workspace: z.ZodEnum<["personal", "team"]>;
+    template: z.ZodObject<{
+        custom: z.ZodBoolean;
+        guid: z.ZodOptional<z.ZodString>;
+        slug: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        custom: boolean;
+        guid?: string | undefined;
+        title?: string | undefined;
+        slug?: string | undefined;
+    }, {
+        custom: boolean;
+        guid?: string | undefined;
+        title?: string | undefined;
+        slug?: string | undefined;
+    }>;
+    tier: z.ZodOptional<z.ZodString>;
+    monthlyPriceUsd: z.ZodNullable<z.ZodNumber>;
+    credits: z.ZodObject<{
+        monthly: z.ZodNumber;
+        extra: z.ZodNumber;
+        used: z.ZodNumber;
+        remaining: z.ZodNumber;
+        period: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        monthly: number;
+        extra: number;
+        used: number;
+        remaining: number;
+        period?: string | undefined;
+    }, {
+        monthly: number;
+        extra: number;
+        used: number;
+        remaining: number;
+        period?: string | undefined;
+    }>;
+    subscription: z.ZodNullable<z.ZodObject<{
+        status: z.ZodString;
+        billing: z.ZodEnum<["wallet", "card"]>;
+        switchingToWallet: z.ZodBoolean;
+        amountUsd: z.ZodNullable<z.ZodNumber>;
+        periodEndsAt: z.ZodOptional<z.ZodString>;
+        daysRemaining: z.ZodNullable<z.ZodNumber>;
+        cancelAtPeriodEnd: z.ZodBoolean;
+        atPeriodEnd: z.ZodOptional<z.ZodEnum<["renews", "ends", "unknown"]>>;
+    }, "strip", z.ZodTypeAny, {
+        status: string;
+        billing: "wallet" | "card";
+        switchingToWallet: boolean;
+        amountUsd: number | null;
+        daysRemaining: number | null;
+        cancelAtPeriodEnd: boolean;
+        periodEndsAt?: string | undefined;
+        atPeriodEnd?: "unknown" | "renews" | "ends" | undefined;
+    }, {
+        status: string;
+        billing: "wallet" | "card";
+        switchingToWallet: boolean;
+        amountUsd: number | null;
+        daysRemaining: number | null;
+        cancelAtPeriodEnd: boolean;
+        periodEndsAt?: string | undefined;
+        atPeriodEnd?: "unknown" | "renews" | "ends" | undefined;
+    }>>;
+    timezone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    teamSessionMode: z.ZodOptional<z.ZodString>;
+    skills: z.ZodArray<z.ZodString, "many">;
+    createdAt: z.ZodOptional<z.ZodString>;
+    updatedAt: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    guid: string;
+    title: string;
+    status: number | null;
+    workspace: "personal" | "team";
+    credits: {
+        monthly: number;
+        extra: number;
+        used: number;
+        remaining: number;
+        period?: string | undefined;
+    };
+    template: {
+        custom: boolean;
+        guid?: string | undefined;
+        title?: string | undefined;
+        slug?: string | undefined;
+    };
+    statusLabel: "error" | "running" | "unknown" | "stopped" | "stopping" | "queued" | "starting" | "setup_required";
+    setupRequired: boolean;
+    monthlyPriceUsd: number | null;
+    subscription: {
+        status: string;
+        billing: "wallet" | "card";
+        switchingToWallet: boolean;
+        amountUsd: number | null;
+        daysRemaining: number | null;
+        cancelAtPeriodEnd: boolean;
+        periodEndsAt?: string | undefined;
+        atPeriodEnd?: "unknown" | "renews" | "ends" | undefined;
+    } | null;
+    skills: string[];
+    createdAt?: string | undefined;
+    updatedAt?: string | undefined;
+    tier?: string | undefined;
+    timezone?: string | null | undefined;
+    teamSessionMode?: string | undefined;
+}, {
+    guid: string;
+    title: string;
+    status: number | null;
+    workspace: "personal" | "team";
+    credits: {
+        monthly: number;
+        extra: number;
+        used: number;
+        remaining: number;
+        period?: string | undefined;
+    };
+    template: {
+        custom: boolean;
+        guid?: string | undefined;
+        title?: string | undefined;
+        slug?: string | undefined;
+    };
+    statusLabel: "error" | "running" | "unknown" | "stopped" | "stopping" | "queued" | "starting" | "setup_required";
+    setupRequired: boolean;
+    monthlyPriceUsd: number | null;
+    subscription: {
+        status: string;
+        billing: "wallet" | "card";
+        switchingToWallet: boolean;
+        amountUsd: number | null;
+        daysRemaining: number | null;
+        cancelAtPeriodEnd: boolean;
+        periodEndsAt?: string | undefined;
+        atPeriodEnd?: "unknown" | "renews" | "ends" | undefined;
+    } | null;
+    skills: string[];
+    createdAt?: string | undefined;
+    updatedAt?: string | undefined;
+    tier?: string | undefined;
+    timezone?: string | null | undefined;
+    teamSessionMode?: string | undefined;
+}>;
+export type AgentSummary = z.infer<typeof agentSummarySchema>;
+export declare const agentDetailSchema: z.ZodObject<{
+    guid: z.ZodString;
+    title: z.ZodString;
+    status: z.ZodNullable<z.ZodNumber>;
+    statusLabel: z.ZodEnum<["stopped", "stopping", "queued", "starting", "running", "error", "setup_required", "unknown"]>;
+    setupRequired: z.ZodBoolean;
+    workspace: z.ZodEnum<["personal", "team"]>;
+    template: z.ZodObject<{
+        custom: z.ZodBoolean;
+        guid: z.ZodOptional<z.ZodString>;
+        slug: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        custom: boolean;
+        guid?: string | undefined;
+        title?: string | undefined;
+        slug?: string | undefined;
+    }, {
+        custom: boolean;
+        guid?: string | undefined;
+        title?: string | undefined;
+        slug?: string | undefined;
+    }>;
+    tier: z.ZodOptional<z.ZodString>;
+    monthlyPriceUsd: z.ZodNullable<z.ZodNumber>;
+    credits: z.ZodObject<{
+        monthly: z.ZodNumber;
+        extra: z.ZodNumber;
+        used: z.ZodNumber;
+        remaining: z.ZodNumber;
+        period: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        monthly: number;
+        extra: number;
+        used: number;
+        remaining: number;
+        period?: string | undefined;
+    }, {
+        monthly: number;
+        extra: number;
+        used: number;
+        remaining: number;
+        period?: string | undefined;
+    }>;
+    subscription: z.ZodNullable<z.ZodObject<{
+        status: z.ZodString;
+        billing: z.ZodEnum<["wallet", "card"]>;
+        switchingToWallet: z.ZodBoolean;
+        amountUsd: z.ZodNullable<z.ZodNumber>;
+        periodEndsAt: z.ZodOptional<z.ZodString>;
+        daysRemaining: z.ZodNullable<z.ZodNumber>;
+        cancelAtPeriodEnd: z.ZodBoolean;
+        atPeriodEnd: z.ZodOptional<z.ZodEnum<["renews", "ends", "unknown"]>>;
+    }, "strip", z.ZodTypeAny, {
+        status: string;
+        billing: "wallet" | "card";
+        switchingToWallet: boolean;
+        amountUsd: number | null;
+        daysRemaining: number | null;
+        cancelAtPeriodEnd: boolean;
+        periodEndsAt?: string | undefined;
+        atPeriodEnd?: "unknown" | "renews" | "ends" | undefined;
+    }, {
+        status: string;
+        billing: "wallet" | "card";
+        switchingToWallet: boolean;
+        amountUsd: number | null;
+        daysRemaining: number | null;
+        cancelAtPeriodEnd: boolean;
+        periodEndsAt?: string | undefined;
+        atPeriodEnd?: "unknown" | "renews" | "ends" | undefined;
+    }>>;
+    timezone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    teamSessionMode: z.ZodOptional<z.ZodString>;
+    skills: z.ZodArray<z.ZodString, "many">;
+    createdAt: z.ZodOptional<z.ZodString>;
+    updatedAt: z.ZodOptional<z.ZodString>;
+} & {
+    description: z.ZodOptional<z.ZodString>;
+    cover: z.ZodOptional<z.ZodString>;
+    categories: z.ZodArray<z.ZodString, "many">;
+    pricing: z.ZodNullable<z.ZodObject<{
+        starter: z.ZodObject<{
+            priceUsd: z.ZodNumber;
+            monthlyCredits: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            priceUsd: number;
+            monthlyCredits: number;
+        }, {
+            priceUsd: number;
+            monthlyCredits: number;
+        }>;
+        pro: z.ZodObject<{
+            priceUsd: z.ZodNumber;
+            monthlyCredits: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            priceUsd: number;
+            monthlyCredits: number;
+        }, {
+            priceUsd: number;
+            monthlyCredits: number;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        starter: {
+            priceUsd: number;
+            monthlyCredits: number;
+        };
+        pro: {
+            priceUsd: number;
+            monthlyCredits: number;
+        };
+    }, {
+        starter: {
+            priceUsd: number;
+            monthlyCredits: number;
+        };
+        pro: {
+            priceUsd: number;
+            monthlyCredits: number;
+        };
+    }>>;
+    extraCreditPacks: z.ZodArray<z.ZodObject<{
+        pack: z.ZodString;
+        credits: z.ZodNumber;
+        priceUsd: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        priceUsd: number;
+        credits: number;
+        pack: string;
+    }, {
+        priceUsd: number;
+        credits: number;
+        pack: string;
+    }>, "many">;
+    models: z.ZodOptional<z.ZodObject<{
+        chat: z.ZodNullable<z.ZodString>;
+        cron: z.ZodNullable<z.ZodString>;
+        voicePrep: z.ZodNullable<z.ZodString>;
+        voicePostcall: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        chat: string | null;
+        cron: string | null;
+        voicePrep: string | null;
+        voicePostcall: string | null;
+    }, {
+        chat: string | null;
+        cron: string | null;
+        voicePrep: string | null;
+        voicePostcall: string | null;
+    }>>;
+    selectableModels: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        slug: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        inputCreditsPer1M: z.ZodOptional<z.ZodNumber>;
+        outputCreditsPer1M: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        slug: string;
+        label?: string | undefined;
+        inputCreditsPer1M?: number | undefined;
+        outputCreditsPer1M?: number | undefined;
+    }, {
+        slug: string;
+        label?: string | undefined;
+        inputCreditsPer1M?: number | undefined;
+        outputCreditsPer1M?: number | undefined;
+    }>, "many">>;
+    enabledCommands: z.ZodNullable<z.ZodArray<z.ZodString, "many">>;
+    credentials: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        title: z.ZodString;
+        optional: z.ZodBoolean;
+        oauth: z.ZodBoolean;
+        connected: z.ZodBoolean;
+        filled: z.ZodBoolean;
+        requiredMissing: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        key: string;
+        optional: boolean;
+        title: string;
+        oauth: boolean;
+        connected: boolean;
+        filled: boolean;
+        requiredMissing: boolean;
+    }, {
+        key: string;
+        optional: boolean;
+        title: string;
+        oauth: boolean;
+        connected: boolean;
+        filled: boolean;
+        requiredMissing: boolean;
+    }>, "many">;
+    missingCredentials: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        title: z.ZodString;
+        oauth: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        key: string;
+        title: string;
+        oauth: boolean;
+    }, {
+        key: string;
+        title: string;
+        oauth: boolean;
+    }>, "many">;
+    channels: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        credentialKey: z.ZodString;
+        enabled: z.ZodBoolean;
+        configured: z.ZodBoolean;
+        missingFields: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        title: string;
+        credentialKey: string;
+        enabled: boolean;
+        configured: boolean;
+        missingFields: string[];
+    }, {
+        id: string;
+        title: string;
+        credentialKey: string;
+        enabled: boolean;
+        configured: boolean;
+        missingFields: string[];
+    }>, "many">;
+    scheduledTasks: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        enabled: z.ZodBoolean;
+        interval: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        source: z.ZodOptional<z.ZodEnum<["template", "skill", "user"]>>;
+        instructions: z.ZodOptional<z.ZodString>;
+        instructionsTruncated: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        key: string;
+        enabled: boolean;
+        instructions?: string | undefined;
+        description?: string | undefined;
+        interval?: string | null | undefined;
+        source?: "user" | "template" | "skill" | undefined;
+        instructionsTruncated?: boolean | undefined;
+    }, {
+        key: string;
+        enabled: boolean;
+        instructions?: string | undefined;
+        description?: string | undefined;
+        interval?: string | null | undefined;
+        source?: "user" | "template" | "skill" | undefined;
+        instructionsTruncated?: boolean | undefined;
+    }>, "many">;
+    customInstructions: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        enabled: z.ZodBoolean;
+        interval: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        source: z.ZodOptional<z.ZodEnum<["template", "skill", "user"]>>;
+        instructions: z.ZodOptional<z.ZodString>;
+        instructionsTruncated: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        key: string;
+        enabled: boolean;
+        instructions?: string | undefined;
+        description?: string | undefined;
+        interval?: string | null | undefined;
+        source?: "user" | "template" | "skill" | undefined;
+        instructionsTruncated?: boolean | undefined;
+    }, {
+        key: string;
+        enabled: boolean;
+        instructions?: string | undefined;
+        description?: string | undefined;
+        interval?: string | null | undefined;
+        source?: "user" | "template" | "skill" | undefined;
+        instructionsTruncated?: boolean | undefined;
+    }>, "many">;
+    queuedAt: z.ZodOptional<z.ZodString>;
+    startedAt: z.ZodOptional<z.ZodString>;
+    runningAt: z.ZodOptional<z.ZodString>;
+    stoppedAt: z.ZodOptional<z.ZodString>;
+    erroredAt: z.ZodOptional<z.ZodString>;
+    dashboardUrl: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    categories: string[];
+    guid: string;
+    title: string;
+    status: number | null;
+    pricing: {
+        starter: {
+            priceUsd: number;
+            monthlyCredits: number;
+        };
+        pro: {
+            priceUsd: number;
+            monthlyCredits: number;
+        };
+    } | null;
+    workspace: "personal" | "team";
+    credits: {
+        monthly: number;
+        extra: number;
+        used: number;
+        remaining: number;
+        period?: string | undefined;
+    };
+    template: {
+        custom: boolean;
+        guid?: string | undefined;
+        title?: string | undefined;
+        slug?: string | undefined;
+    };
+    statusLabel: "error" | "running" | "unknown" | "stopped" | "stopping" | "queued" | "starting" | "setup_required";
+    setupRequired: boolean;
+    monthlyPriceUsd: number | null;
+    subscription: {
+        status: string;
+        billing: "wallet" | "card";
+        switchingToWallet: boolean;
+        amountUsd: number | null;
+        daysRemaining: number | null;
+        cancelAtPeriodEnd: boolean;
+        periodEndsAt?: string | undefined;
+        atPeriodEnd?: "unknown" | "renews" | "ends" | undefined;
+    } | null;
+    skills: string[];
+    extraCreditPacks: {
+        priceUsd: number;
+        credits: number;
+        pack: string;
+    }[];
+    enabledCommands: string[] | null;
+    credentials: {
+        key: string;
+        optional: boolean;
+        title: string;
+        oauth: boolean;
+        connected: boolean;
+        filled: boolean;
+        requiredMissing: boolean;
+    }[];
+    missingCredentials: {
+        key: string;
+        title: string;
+        oauth: boolean;
+    }[];
+    channels: {
+        id: string;
+        title: string;
+        credentialKey: string;
+        enabled: boolean;
+        configured: boolean;
+        missingFields: string[];
+    }[];
+    scheduledTasks: {
+        key: string;
+        enabled: boolean;
+        instructions?: string | undefined;
+        description?: string | undefined;
+        interval?: string | null | undefined;
+        source?: "user" | "template" | "skill" | undefined;
+        instructionsTruncated?: boolean | undefined;
+    }[];
+    customInstructions: {
+        key: string;
+        enabled: boolean;
+        instructions?: string | undefined;
+        description?: string | undefined;
+        interval?: string | null | undefined;
+        source?: "user" | "template" | "skill" | undefined;
+        instructionsTruncated?: boolean | undefined;
+    }[];
+    dashboardUrl: string;
+    description?: string | undefined;
+    createdAt?: string | undefined;
+    models?: {
+        chat: string | null;
+        cron: string | null;
+        voicePrep: string | null;
+        voicePostcall: string | null;
+    } | undefined;
+    cover?: string | undefined;
+    updatedAt?: string | undefined;
+    startedAt?: string | undefined;
+    tier?: string | undefined;
+    timezone?: string | null | undefined;
+    teamSessionMode?: string | undefined;
+    selectableModels?: {
+        slug: string;
+        label?: string | undefined;
+        inputCreditsPer1M?: number | undefined;
+        outputCreditsPer1M?: number | undefined;
+    }[] | undefined;
+    queuedAt?: string | undefined;
+    runningAt?: string | undefined;
+    stoppedAt?: string | undefined;
+    erroredAt?: string | undefined;
+}, {
+    categories: string[];
+    guid: string;
+    title: string;
+    status: number | null;
+    pricing: {
+        starter: {
+            priceUsd: number;
+            monthlyCredits: number;
+        };
+        pro: {
+            priceUsd: number;
+            monthlyCredits: number;
+        };
+    } | null;
+    workspace: "personal" | "team";
+    credits: {
+        monthly: number;
+        extra: number;
+        used: number;
+        remaining: number;
+        period?: string | undefined;
+    };
+    template: {
+        custom: boolean;
+        guid?: string | undefined;
+        title?: string | undefined;
+        slug?: string | undefined;
+    };
+    statusLabel: "error" | "running" | "unknown" | "stopped" | "stopping" | "queued" | "starting" | "setup_required";
+    setupRequired: boolean;
+    monthlyPriceUsd: number | null;
+    subscription: {
+        status: string;
+        billing: "wallet" | "card";
+        switchingToWallet: boolean;
+        amountUsd: number | null;
+        daysRemaining: number | null;
+        cancelAtPeriodEnd: boolean;
+        periodEndsAt?: string | undefined;
+        atPeriodEnd?: "unknown" | "renews" | "ends" | undefined;
+    } | null;
+    skills: string[];
+    extraCreditPacks: {
+        priceUsd: number;
+        credits: number;
+        pack: string;
+    }[];
+    enabledCommands: string[] | null;
+    credentials: {
+        key: string;
+        optional: boolean;
+        title: string;
+        oauth: boolean;
+        connected: boolean;
+        filled: boolean;
+        requiredMissing: boolean;
+    }[];
+    missingCredentials: {
+        key: string;
+        title: string;
+        oauth: boolean;
+    }[];
+    channels: {
+        id: string;
+        title: string;
+        credentialKey: string;
+        enabled: boolean;
+        configured: boolean;
+        missingFields: string[];
+    }[];
+    scheduledTasks: {
+        key: string;
+        enabled: boolean;
+        instructions?: string | undefined;
+        description?: string | undefined;
+        interval?: string | null | undefined;
+        source?: "user" | "template" | "skill" | undefined;
+        instructionsTruncated?: boolean | undefined;
+    }[];
+    customInstructions: {
+        key: string;
+        enabled: boolean;
+        instructions?: string | undefined;
+        description?: string | undefined;
+        interval?: string | null | undefined;
+        source?: "user" | "template" | "skill" | undefined;
+        instructionsTruncated?: boolean | undefined;
+    }[];
+    dashboardUrl: string;
+    description?: string | undefined;
+    createdAt?: string | undefined;
+    models?: {
+        chat: string | null;
+        cron: string | null;
+        voicePrep: string | null;
+        voicePostcall: string | null;
+    } | undefined;
+    cover?: string | undefined;
+    updatedAt?: string | undefined;
+    startedAt?: string | undefined;
+    tier?: string | undefined;
+    timezone?: string | null | undefined;
+    teamSessionMode?: string | undefined;
+    selectableModels?: {
+        slug: string;
+        label?: string | undefined;
+        inputCreditsPer1M?: number | undefined;
+        outputCreditsPer1M?: number | undefined;
+    }[] | undefined;
+    queuedAt?: string | undefined;
+    runningAt?: string | undefined;
+    stoppedAt?: string | undefined;
+    erroredAt?: string | undefined;
+}>;
+export type AgentDetail = z.infer<typeof agentDetailSchema>;
+/** The part of a new agent that matters right after deploying it. */
+export declare const deployedAgentSchema: z.ZodObject<{
+    guid: z.ZodString;
+    title: z.ZodString;
+    status: z.ZodNullable<z.ZodNumber>;
+    statusLabel: z.ZodEnum<["stopped", "stopping", "queued", "starting", "running", "error", "setup_required", "unknown"]>;
+    setupRequired: z.ZodBoolean;
+    workspace: z.ZodEnum<["personal", "team"]>;
+    template: z.ZodObject<{
+        custom: z.ZodBoolean;
+        guid: z.ZodOptional<z.ZodString>;
+        slug: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        custom: boolean;
+        guid?: string | undefined;
+        title?: string | undefined;
+        slug?: string | undefined;
+    }, {
+        custom: boolean;
+        guid?: string | undefined;
+        title?: string | undefined;
+        slug?: string | undefined;
+    }>;
+    tier: z.ZodOptional<z.ZodString>;
+    monthlyPriceUsd: z.ZodNullable<z.ZodNumber>;
+    credits: z.ZodObject<{
+        monthly: z.ZodNumber;
+        extra: z.ZodNumber;
+        used: z.ZodNumber;
+        remaining: z.ZodNumber;
+        period: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        monthly: number;
+        extra: number;
+        used: number;
+        remaining: number;
+        period?: string | undefined;
+    }, {
+        monthly: number;
+        extra: number;
+        used: number;
+        remaining: number;
+        period?: string | undefined;
+    }>;
+    subscription: z.ZodNullable<z.ZodObject<{
+        status: z.ZodString;
+        billing: z.ZodEnum<["wallet", "card"]>;
+        switchingToWallet: z.ZodBoolean;
+        amountUsd: z.ZodNullable<z.ZodNumber>;
+        periodEndsAt: z.ZodOptional<z.ZodString>;
+        daysRemaining: z.ZodNullable<z.ZodNumber>;
+        cancelAtPeriodEnd: z.ZodBoolean;
+        atPeriodEnd: z.ZodOptional<z.ZodEnum<["renews", "ends", "unknown"]>>;
+    }, "strip", z.ZodTypeAny, {
+        status: string;
+        billing: "wallet" | "card";
+        switchingToWallet: boolean;
+        amountUsd: number | null;
+        daysRemaining: number | null;
+        cancelAtPeriodEnd: boolean;
+        periodEndsAt?: string | undefined;
+        atPeriodEnd?: "unknown" | "renews" | "ends" | undefined;
+    }, {
+        status: string;
+        billing: "wallet" | "card";
+        switchingToWallet: boolean;
+        amountUsd: number | null;
+        daysRemaining: number | null;
+        cancelAtPeriodEnd: boolean;
+        periodEndsAt?: string | undefined;
+        atPeriodEnd?: "unknown" | "renews" | "ends" | undefined;
+    }>>;
+    timezone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    teamSessionMode: z.ZodOptional<z.ZodString>;
+    skills: z.ZodArray<z.ZodString, "many">;
+    createdAt: z.ZodOptional<z.ZodString>;
+    updatedAt: z.ZodOptional<z.ZodString>;
+} & {
+    missingCredentials: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        title: z.ZodString;
+        oauth: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        key: string;
+        title: string;
+        oauth: boolean;
+    }, {
+        key: string;
+        title: string;
+        oauth: boolean;
+    }>, "many">;
+    channels: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        credentialKey: z.ZodString;
+        enabled: z.ZodBoolean;
+        configured: z.ZodBoolean;
+        missingFields: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        title: string;
+        credentialKey: string;
+        enabled: boolean;
+        configured: boolean;
+        missingFields: string[];
+    }, {
+        id: string;
+        title: string;
+        credentialKey: string;
+        enabled: boolean;
+        configured: boolean;
+        missingFields: string[];
+    }>, "many">;
+    dashboardUrl: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    guid: string;
+    title: string;
+    status: number | null;
+    workspace: "personal" | "team";
+    credits: {
+        monthly: number;
+        extra: number;
+        used: number;
+        remaining: number;
+        period?: string | undefined;
+    };
+    template: {
+        custom: boolean;
+        guid?: string | undefined;
+        title?: string | undefined;
+        slug?: string | undefined;
+    };
+    statusLabel: "error" | "running" | "unknown" | "stopped" | "stopping" | "queued" | "starting" | "setup_required";
+    setupRequired: boolean;
+    monthlyPriceUsd: number | null;
+    subscription: {
+        status: string;
+        billing: "wallet" | "card";
+        switchingToWallet: boolean;
+        amountUsd: number | null;
+        daysRemaining: number | null;
+        cancelAtPeriodEnd: boolean;
+        periodEndsAt?: string | undefined;
+        atPeriodEnd?: "unknown" | "renews" | "ends" | undefined;
+    } | null;
+    skills: string[];
+    missingCredentials: {
+        key: string;
+        title: string;
+        oauth: boolean;
+    }[];
+    channels: {
+        id: string;
+        title: string;
+        credentialKey: string;
+        enabled: boolean;
+        configured: boolean;
+        missingFields: string[];
+    }[];
+    dashboardUrl: string;
+    createdAt?: string | undefined;
+    updatedAt?: string | undefined;
+    tier?: string | undefined;
+    timezone?: string | null | undefined;
+    teamSessionMode?: string | undefined;
+}, {
+    guid: string;
+    title: string;
+    status: number | null;
+    workspace: "personal" | "team";
+    credits: {
+        monthly: number;
+        extra: number;
+        used: number;
+        remaining: number;
+        period?: string | undefined;
+    };
+    template: {
+        custom: boolean;
+        guid?: string | undefined;
+        title?: string | undefined;
+        slug?: string | undefined;
+    };
+    statusLabel: "error" | "running" | "unknown" | "stopped" | "stopping" | "queued" | "starting" | "setup_required";
+    setupRequired: boolean;
+    monthlyPriceUsd: number | null;
+    subscription: {
+        status: string;
+        billing: "wallet" | "card";
+        switchingToWallet: boolean;
+        amountUsd: number | null;
+        daysRemaining: number | null;
+        cancelAtPeriodEnd: boolean;
+        periodEndsAt?: string | undefined;
+        atPeriodEnd?: "unknown" | "renews" | "ends" | undefined;
+    } | null;
+    skills: string[];
+    missingCredentials: {
+        key: string;
+        title: string;
+        oauth: boolean;
+    }[];
+    channels: {
+        id: string;
+        title: string;
+        credentialKey: string;
+        enabled: boolean;
+        configured: boolean;
+        missingFields: string[];
+    }[];
+    dashboardUrl: string;
+    createdAt?: string | undefined;
+    updatedAt?: string | undefined;
+    tier?: string | undefined;
+    timezone?: string | null | undefined;
+    teamSessionMode?: string | undefined;
+}>;
+export type DeployedAgent = z.infer<typeof deployedAgentSchema>;
+export declare function toDeployedAgent(agent: AgentDetail): DeployedAgent;
+/** The compact row used by list_my_agents. */
+export declare function toAgentSummary(row: Record<string, unknown>): AgentSummary;
+/** Slugs a deployed agent may switch its chat, cron or voice model to. */
+export declare function selectableModelSlugs(row: Record<string, unknown>): Set<string>;
+/**
+ * The full view of one deployed agent (Detail, Deploy and Update rows): its
+ * status, plan, prices, credits and settings, and the state of each
+ * credential and channel.
+ */
+export declare function toAgentDetail(row: Record<string, unknown>): AgentDetail;
+export declare function formatSubscriptionLine(subscription: AgentSubscription | null, plainMember?: boolean): string;
+/** Without an active plan, an agent starts only on the extra credits it has left. */
+export declare function startNeedsPlan(agent: Pick<AgentSummary, 'subscription' | 'credits'>): boolean;
+export declare function formatAgentSummaryLines(agent: AgentSummary, plainMember?: boolean): string[];
+/** A scheduled task as a list line: key, on or off, schedule and description, then shortenedNote if its text was cut. */
+export declare function formatScheduledTaskLine(task: AgentTask, shortenedNote?: string): string;
+/** A custom instruction as a list line: key, on or off and description, then shortenedNote if its text was cut. */
+export declare function formatCustomInstructionLine(task: AgentTask, shortenedNote?: string): string;
+/** Each model with its credits per 1M input and output tokens, separated by semicolons. */
+export declare function formatModelRates(models: readonly SelectableModel[]): string;
+export declare function formatAgentDetail(agent: AgentDetail, plainMember?: boolean): string;
+export declare function normalizeCustomSkillKey(input: string, interval?: string | null): string | null;
+export declare function isGuid(value: string): boolean;
+export interface AgentApiClient {
+    post<T = Record<string, unknown>>(path: string, body?: Record<string, unknown>, signal?: AbortSignal): Promise<T>;
+}
+/** Reads one agent's Detail row; tool results are built from it with toAgentDetail or toAgentSummary. */
+export declare function readAgentDetail(client: AgentApiClient, guid: string, signal?: AbortSignal): Promise<Record<string, unknown>>;
+export declare function agentPollInterval(elapsedMs: number): number;
+export interface AgentWaitResult {
+    row: Record<string, unknown>;
+    /** False when no read succeeded, so row is the fallback row passed in. */
+    fresh: boolean;
+    settled: boolean;
+    elapsedMs: number;
+}
+/** Reads the agent until its status is no longer stopping, queued or starting. */
+export declare function waitForAgentToSettle(client: AgentApiClient, guid: string, waitSeconds: number, extra: ToolCallContext | undefined, fallbackRow: Record<string, unknown>): Promise<AgentWaitResult>;
+export interface NextAction {
+    tool: string;
+    arguments: Record<string, unknown>;
+    reason: string;
+}
+/** The call that starts on the first missing credential, with every argument it needs. */
+export declare function missingCredentialStep(agent: Pick<AgentDetail, 'guid' | 'missingCredentials'>): NextAction | undefined;
+/**
+ * The most useful next call for an agent in this state, if any. For a team
+ * member without admin rights it is only the wait for a status that moves on
+ * by itself.
+ */
+export declare function nextStepForAgent(agent: AgentDetail, waitSeconds: number, plainMember?: boolean): NextAction | undefined;
+/** Whether a result:false answer is one of the refusals known to leave the wallet untouched. */
+export declare function isPreChargeRefusal(error: unknown): boolean;
+/**
+ * After a paid request was sent, whether it may still have gone through.
+ * Only the known refusals and client errors (other than a timeout or rate
+ * limit) settle it; any other answer, a network failure or a server error
+ * leaves it open.
+ */
+export declare function outcomeUnknown(error: unknown): boolean;
+/** Advice for a status reached after a start, renew or deploy. With the agent, a failed agent without a plan or extra credits is sent to billing. */
+export declare function settledStatusAdvice(status: number | null, plainMember?: boolean, agent?: Pick<AgentSummary, 'subscription' | 'credits'>): string;
+export {};
+//# sourceMappingURL=user-agent.d.ts.map