@wiro-ai/wiro-mcp 1.4.0 → 1.5.0

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

@@ -8,7 +8,9 @@ export declare function readAgentStatus(row: Record<string, unknown>): number |
 export declare function agentStatusLabel(status: number | null | undefined): AgentStatusLabel;
 /** "Running (4)" */
 export declare function describeAgentStatus(status: number | null | undefined): string;
-export declare function agentStatusHint(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"];
@@ -80,48 +82,64 @@ export declare const subscriptionSchema: z.ZodObject<{
     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;
+    amountUsd: number | null;
     billing: "wallet" | "card";
     switchingToWallet: boolean;
-    amountUsd: number | null;
     daysRemaining: number | null;
     cancelAtPeriodEnd: boolean;
     periodEndsAt?: string | undefined;
+    atPeriodEnd?: "unknown" | "renews" | "ends" | undefined;
 }, {
     status: string;
+    amountUsd: number | null;
     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>;
-export declare function toSubscription(value: unknown, cancelAtPeriodEnd?: unknown): AgentSubscription | null;
+/**
+ * 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, even though its
+ * card subscription is set to end with the period. 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;
+    renewal: z.ZodOptional<z.ZodNumber>;
     extra: z.ZodNumber;
     used: z.ZodNumber;
     remaining: z.ZodNumber;
     period: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    extra: number;
     monthly: number;
+    extra: number;
     used: number;
     remaining: number;
+    renewal?: number | undefined;
     period?: string | undefined;
 }, {
-    extra: number;
     monthly: number;
+    extra: number;
     used: number;
     remaining: number;
+    renewal?: number | undefined;
     period?: string | undefined;
 }>;
 export type AgentCredits = z.infer<typeof creditsSchema>;
 export declare function toCredits(row: Record<string, unknown>): AgentCredits;
+/** The monthly credits as said in a line: those of this period, and those of each renewal when they differ. */
+export declare function monthlyCreditsText(credits: Pick<AgentCredits, 'monthly' | 'renewal'>): string;
 /** 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[];
@@ -134,24 +152,24 @@ export declare const credentialStatusSchema: z.ZodObject<{
     filled: z.ZodBoolean;
     requiredMissing: z.ZodBoolean;
 }, "strip", z.ZodTypeAny, {
-    title: string;
-    optional: boolean;
     key: string;
+    optional: boolean;
+    title: string;
     oauth: boolean;
     connected: boolean;
     filled: boolean;
     requiredMissing: boolean;
 }, {
-    title: string;
-    optional: boolean;
     key: string;
+    optional: boolean;
+    title: string;
     oauth: boolean;
     connected: boolean;
     filled: boolean;
     requiredMissing: boolean;
 }>;
 export type CredentialStatus = z.infer<typeof credentialStatusSchema>;
-/** Per-credential state only. Field values never leave this function. */
+/** 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;
@@ -163,24 +181,27 @@ export declare const channelStatusSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     id: string;
     title: string;
+    credentialKey: string;
     enabled: boolean;
-    missingFields: string[];
     configured: boolean;
-    credentialKey: string;
+    missingFields: string[];
 }, {
     id: string;
     title: string;
+    credentialKey: string;
     enabled: boolean;
-    missingFields: string[];
     configured: boolean;
-    credentialKey: string;
+    missingFields: string[];
 }>;
 export type ChannelStatus = z.infer<typeof channelStatusSchema>;
 export declare function summarizeChannels(value: unknown): ChannelStatus[];
+/** The scheduled task a custom build starts with. It runs only once its text has been written. */
+export declare const STARTER_TASK_KEY = "cs-cron-my-scheduled-task";
 export declare const agentTaskSchema: z.ZodObject<{
     key: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
     enabled: z.ZodBoolean;
+    notWritten: z.ZodOptional<z.ZodBoolean>;
     interval: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     source: z.ZodOptional<z.ZodEnum<["template", "skill", "user"]>>;
     instructions: z.ZodOptional<z.ZodString>;
@@ -188,23 +209,42 @@ export declare const agentTaskSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     key: string;
     enabled: boolean;
+    instructions?: string | undefined;
     description?: string | undefined;
-    source?: "user" | "skill" | "template" | undefined;
+    notWritten?: boolean | undefined;
     interval?: string | null | undefined;
-    instructions?: string | undefined;
+    source?: "user" | "template" | "skill" | undefined;
     instructionsTruncated?: boolean | undefined;
 }, {
     key: string;
     enabled: boolean;
+    instructions?: string | undefined;
     description?: string | undefined;
-    source?: "user" | "skill" | "template" | undefined;
+    notWritten?: boolean | undefined;
     interval?: string | null | undefined;
-    instructions?: string | 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;
@@ -232,34 +272,37 @@ export declare const agentSummarySchema: z.ZodObject<{
         title: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         custom: boolean;
-        slug?: string | undefined;
-        title?: string | undefined;
         guid?: string | undefined;
+        title?: string | undefined;
+        slug?: string | undefined;
     }, {
         custom: boolean;
-        slug?: string | undefined;
-        title?: string | undefined;
         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;
+        renewal: z.ZodOptional<z.ZodNumber>;
         extra: z.ZodNumber;
         used: z.ZodNumber;
         remaining: z.ZodNumber;
         period: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        extra: number;
         monthly: number;
+        extra: number;
         used: number;
         remaining: number;
+        renewal?: number | undefined;
         period?: string | undefined;
     }, {
-        extra: number;
         monthly: number;
+        extra: number;
         used: number;
         remaining: number;
+        renewal?: number | undefined;
         period?: string | undefined;
     }>;
     subscription: z.ZodNullable<z.ZodObject<{
@@ -270,100 +313,110 @@ export declare const agentSummarySchema: z.ZodObject<{
         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;
+        amountUsd: number | null;
         billing: "wallet" | "card";
         switchingToWallet: boolean;
-        amountUsd: number | null;
         daysRemaining: number | null;
         cancelAtPeriodEnd: boolean;
         periodEndsAt?: string | undefined;
+        atPeriodEnd?: "unknown" | "renews" | "ends" | undefined;
     }, {
         status: string;
+        amountUsd: number | null;
         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>;
+    lastActivityAt: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    status: number | null;
-    title: string;
     guid: string;
-    workspace: "personal" | "team";
-    skills: string[];
-    subscription: {
-        status: string;
-        billing: "wallet" | "card";
-        switchingToWallet: boolean;
-        amountUsd: number | null;
-        daysRemaining: number | null;
-        cancelAtPeriodEnd: boolean;
-        periodEndsAt?: string | undefined;
-    } | null;
+    title: string;
+    status: number | null;
+    workspace: "team" | "personal";
     credits: {
-        extra: number;
         monthly: number;
+        extra: number;
         used: number;
         remaining: number;
+        renewal?: number | undefined;
         period?: string | undefined;
     };
     template: {
         custom: boolean;
-        slug?: string | undefined;
-        title?: string | undefined;
         guid?: string | undefined;
+        title?: string | undefined;
+        slug?: string | undefined;
     };
     statusLabel: "error" | "running" | "unknown" | "stopped" | "stopping" | "queued" | "starting" | "setup_required";
     setupRequired: boolean;
     monthlyPriceUsd: number | null;
-    createdAt?: string | undefined;
-    updatedAt?: string | undefined;
-    tier?: string | undefined;
-    timezone?: string | null | undefined;
-    teamSessionMode?: string | undefined;
-}, {
-    status: number | null;
-    title: string;
-    guid: string;
-    workspace: "personal" | "team";
-    skills: string[];
     subscription: {
         status: string;
+        amountUsd: number | null;
         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;
+    lastActivityAt?: string | undefined;
+}, {
+    guid: string;
+    title: string;
+    status: number | null;
+    workspace: "team" | "personal";
     credits: {
-        extra: number;
         monthly: number;
+        extra: number;
         used: number;
         remaining: number;
+        renewal?: number | undefined;
         period?: string | undefined;
     };
     template: {
         custom: boolean;
-        slug?: string | undefined;
-        title?: string | undefined;
         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;
+        amountUsd: number | null;
+        billing: "wallet" | "card";
+        switchingToWallet: boolean;
+        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;
+    lastActivityAt?: string | undefined;
 }>;
 export type AgentSummary = z.infer<typeof agentSummarySchema>;
 export declare const agentDetailSchema: z.ZodObject<{
@@ -380,34 +433,37 @@ export declare const agentDetailSchema: z.ZodObject<{
         title: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         custom: boolean;
-        slug?: string | undefined;
-        title?: string | undefined;
         guid?: string | undefined;
+        title?: string | undefined;
+        slug?: string | undefined;
     }, {
         custom: boolean;
-        slug?: string | undefined;
-        title?: string | undefined;
         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;
+        renewal: z.ZodOptional<z.ZodNumber>;
         extra: z.ZodNumber;
         used: z.ZodNumber;
         remaining: z.ZodNumber;
         period: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        extra: number;
         monthly: number;
+        extra: number;
         used: number;
         remaining: number;
+        renewal?: number | undefined;
         period?: string | undefined;
     }, {
-        extra: number;
         monthly: number;
+        extra: number;
         used: number;
         remaining: number;
+        renewal?: number | undefined;
         period?: string | undefined;
     }>;
     subscription: z.ZodNullable<z.ZodObject<{
@@ -418,28 +474,32 @@ export declare const agentDetailSchema: z.ZodObject<{
         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;
+        amountUsd: number | null;
         billing: "wallet" | "card";
         switchingToWallet: boolean;
-        amountUsd: number | null;
         daysRemaining: number | null;
         cancelAtPeriodEnd: boolean;
         periodEndsAt?: string | undefined;
+        atPeriodEnd?: "unknown" | "renews" | "ends" | undefined;
     }, {
         status: string;
+        amountUsd: number | null;
         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>;
+    lastActivityAt: z.ZodOptional<z.ZodString>;
 } & {
     description: z.ZodOptional<z.ZodString>;
     cover: z.ZodOptional<z.ZodString>;
@@ -539,17 +599,17 @@ export declare const agentDetailSchema: z.ZodObject<{
         filled: z.ZodBoolean;
         requiredMissing: z.ZodBoolean;
     }, "strip", z.ZodTypeAny, {
-        title: string;
-        optional: boolean;
         key: string;
+        optional: boolean;
+        title: string;
         oauth: boolean;
         connected: boolean;
         filled: boolean;
         requiredMissing: boolean;
     }, {
-        title: string;
-        optional: boolean;
         key: string;
+        optional: boolean;
+        title: string;
         oauth: boolean;
         connected: boolean;
         filled: boolean;
@@ -560,12 +620,12 @@ export declare const agentDetailSchema: z.ZodObject<{
         title: z.ZodString;
         oauth: z.ZodBoolean;
     }, "strip", z.ZodTypeAny, {
-        title: string;
         key: string;
+        title: string;
         oauth: boolean;
     }, {
-        title: string;
         key: string;
+        title: string;
         oauth: boolean;
     }>, "many">;
     channels: z.ZodArray<z.ZodObject<{
@@ -578,22 +638,23 @@ export declare const agentDetailSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         id: string;
         title: string;
+        credentialKey: string;
         enabled: boolean;
-        missingFields: string[];
         configured: boolean;
-        credentialKey: string;
+        missingFields: string[];
     }, {
         id: string;
         title: string;
+        credentialKey: string;
         enabled: boolean;
-        missingFields: string[];
         configured: boolean;
-        credentialKey: string;
+        missingFields: string[];
     }>, "many">;
     scheduledTasks: z.ZodArray<z.ZodObject<{
         key: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
         enabled: z.ZodBoolean;
+        notWritten: z.ZodOptional<z.ZodBoolean>;
         interval: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         source: z.ZodOptional<z.ZodEnum<["template", "skill", "user"]>>;
         instructions: z.ZodOptional<z.ZodString>;
@@ -601,24 +662,27 @@ export declare const agentDetailSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         key: string;
         enabled: boolean;
+        instructions?: string | undefined;
         description?: string | undefined;
-        source?: "user" | "skill" | "template" | undefined;
+        notWritten?: boolean | undefined;
         interval?: string | null | undefined;
-        instructions?: string | undefined;
+        source?: "user" | "template" | "skill" | undefined;
         instructionsTruncated?: boolean | undefined;
     }, {
         key: string;
         enabled: boolean;
+        instructions?: string | undefined;
         description?: string | undefined;
-        source?: "user" | "skill" | "template" | undefined;
+        notWritten?: boolean | undefined;
         interval?: string | null | undefined;
-        instructions?: string | 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;
+        notWritten: z.ZodOptional<z.ZodBoolean>;
         interval: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         source: z.ZodOptional<z.ZodEnum<["template", "skill", "user"]>>;
         instructions: z.ZodOptional<z.ZodString>;
@@ -626,18 +690,20 @@ export declare const agentDetailSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         key: string;
         enabled: boolean;
+        instructions?: string | undefined;
         description?: string | undefined;
-        source?: "user" | "skill" | "template" | undefined;
+        notWritten?: boolean | undefined;
         interval?: string | null | undefined;
-        instructions?: string | undefined;
+        source?: "user" | "template" | "skill" | undefined;
         instructionsTruncated?: boolean | undefined;
     }, {
         key: string;
         enabled: boolean;
+        instructions?: string | undefined;
         description?: string | undefined;
-        source?: "user" | "skill" | "template" | undefined;
+        notWritten?: boolean | undefined;
         interval?: string | null | undefined;
-        instructions?: string | undefined;
+        source?: "user" | "template" | "skill" | undefined;
         instructionsTruncated?: boolean | undefined;
     }>, "many">;
     queuedAt: z.ZodOptional<z.ZodString>;
@@ -648,8 +714,9 @@ export declare const agentDetailSchema: z.ZodObject<{
     dashboardUrl: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     categories: string[];
-    status: number | null;
+    guid: string;
     title: string;
+    status: number | null;
     pricing: {
         starter: {
             priceUsd: number;
@@ -660,95 +727,99 @@ export declare const agentDetailSchema: z.ZodObject<{
             monthlyCredits: number;
         };
     } | null;
-    guid: string;
-    workspace: "personal" | "team";
-    skills: string[];
-    channels: {
-        id: string;
-        title: string;
-        enabled: boolean;
-        missingFields: string[];
-        configured: boolean;
-        credentialKey: string;
-    }[];
-    credentials: {
-        title: string;
-        optional: boolean;
-        key: string;
-        oauth: boolean;
-        connected: boolean;
-        filled: boolean;
-        requiredMissing: boolean;
-    }[];
-    subscription: {
-        status: string;
-        billing: "wallet" | "card";
-        switchingToWallet: boolean;
-        amountUsd: number | null;
-        daysRemaining: number | null;
-        cancelAtPeriodEnd: boolean;
-        periodEndsAt?: string | undefined;
-    } | null;
+    workspace: "team" | "personal";
     credits: {
-        extra: number;
         monthly: number;
+        extra: number;
         used: number;
         remaining: number;
+        renewal?: number | undefined;
         period?: string | undefined;
     };
     template: {
         custom: boolean;
-        slug?: string | undefined;
-        title?: string | undefined;
         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;
+        amountUsd: number | null;
+        billing: "wallet" | "card";
+        switchingToWallet: boolean;
+        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;
-    missingCredentials: {
+    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;
-        source?: "user" | "skill" | "template" | undefined;
+        notWritten?: boolean | undefined;
         interval?: string | null | undefined;
-        instructions?: string | undefined;
+        source?: "user" | "template" | "skill" | undefined;
         instructionsTruncated?: boolean | undefined;
     }[];
     customInstructions: {
         key: string;
         enabled: boolean;
+        instructions?: string | undefined;
         description?: string | undefined;
-        source?: "user" | "skill" | "template" | undefined;
+        notWritten?: boolean | undefined;
         interval?: string | null | undefined;
-        instructions?: string | 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;
-    createdAt?: string | undefined;
     cover?: string | undefined;
     updatedAt?: string | undefined;
     startedAt?: string | undefined;
     tier?: string | undefined;
     timezone?: string | null | undefined;
     teamSessionMode?: string | undefined;
+    lastActivityAt?: string | undefined;
     selectableModels?: {
         slug: string;
         label?: string | undefined;
@@ -761,8 +832,9 @@ export declare const agentDetailSchema: z.ZodObject<{
     erroredAt?: string | undefined;
 }, {
     categories: string[];
-    status: number | null;
+    guid: string;
     title: string;
+    status: number | null;
     pricing: {
         starter: {
             priceUsd: number;
@@ -773,95 +845,99 @@ export declare const agentDetailSchema: z.ZodObject<{
             monthlyCredits: number;
         };
     } | null;
-    guid: string;
-    workspace: "personal" | "team";
-    skills: string[];
-    channels: {
-        id: string;
-        title: string;
-        enabled: boolean;
-        missingFields: string[];
-        configured: boolean;
-        credentialKey: string;
-    }[];
-    credentials: {
-        title: string;
-        optional: boolean;
-        key: string;
-        oauth: boolean;
-        connected: boolean;
-        filled: boolean;
-        requiredMissing: boolean;
-    }[];
-    subscription: {
-        status: string;
-        billing: "wallet" | "card";
-        switchingToWallet: boolean;
-        amountUsd: number | null;
-        daysRemaining: number | null;
-        cancelAtPeriodEnd: boolean;
-        periodEndsAt?: string | undefined;
-    } | null;
+    workspace: "team" | "personal";
     credits: {
-        extra: number;
         monthly: number;
+        extra: number;
         used: number;
         remaining: number;
+        renewal?: number | undefined;
         period?: string | undefined;
     };
     template: {
         custom: boolean;
-        slug?: string | undefined;
-        title?: string | undefined;
         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;
+        amountUsd: number | null;
+        billing: "wallet" | "card";
+        switchingToWallet: boolean;
+        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;
-    missingCredentials: {
+    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;
-        source?: "user" | "skill" | "template" | undefined;
+        notWritten?: boolean | undefined;
         interval?: string | null | undefined;
-        instructions?: string | undefined;
+        source?: "user" | "template" | "skill" | undefined;
         instructionsTruncated?: boolean | undefined;
     }[];
     customInstructions: {
         key: string;
         enabled: boolean;
+        instructions?: string | undefined;
         description?: string | undefined;
-        source?: "user" | "skill" | "template" | undefined;
+        notWritten?: boolean | undefined;
         interval?: string | null | undefined;
-        instructions?: string | 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;
-    createdAt?: string | undefined;
     cover?: string | undefined;
     updatedAt?: string | undefined;
     startedAt?: string | undefined;
     tier?: string | undefined;
     timezone?: string | null | undefined;
     teamSessionMode?: string | undefined;
+    lastActivityAt?: string | undefined;
     selectableModels?: {
         slug: string;
         label?: string | undefined;
@@ -889,34 +965,37 @@ export declare const deployedAgentSchema: z.ZodObject<{
         title: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         custom: boolean;
-        slug?: string | undefined;
-        title?: string | undefined;
         guid?: string | undefined;
+        title?: string | undefined;
+        slug?: string | undefined;
     }, {
         custom: boolean;
-        slug?: string | undefined;
-        title?: string | undefined;
         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;
+        renewal: z.ZodOptional<z.ZodNumber>;
         extra: z.ZodNumber;
         used: z.ZodNumber;
         remaining: z.ZodNumber;
         period: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        extra: number;
         monthly: number;
+        extra: number;
         used: number;
         remaining: number;
+        renewal?: number | undefined;
         period?: string | undefined;
     }, {
-        extra: number;
         monthly: number;
+        extra: number;
         used: number;
         remaining: number;
+        renewal?: number | undefined;
         period?: string | undefined;
     }>;
     subscription: z.ZodNullable<z.ZodObject<{
@@ -927,40 +1006,44 @@ export declare const deployedAgentSchema: z.ZodObject<{
         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;
+        amountUsd: number | null;
         billing: "wallet" | "card";
         switchingToWallet: boolean;
-        amountUsd: number | null;
         daysRemaining: number | null;
         cancelAtPeriodEnd: boolean;
         periodEndsAt?: string | undefined;
+        atPeriodEnd?: "unknown" | "renews" | "ends" | undefined;
     }, {
         status: string;
+        amountUsd: number | null;
         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>;
+    lastActivityAt: z.ZodOptional<z.ZodString>;
 } & {
     missingCredentials: z.ZodArray<z.ZodObject<{
         key: z.ZodString;
         title: z.ZodString;
         oauth: z.ZodBoolean;
     }, "strip", z.ZodTypeAny, {
-        title: string;
         key: string;
+        title: string;
         oauth: boolean;
     }, {
-        title: string;
         key: string;
+        title: string;
         oauth: boolean;
     }>, "many">;
     channels: z.ZodArray<z.ZodObject<{
@@ -973,119 +1056,125 @@ export declare const deployedAgentSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         id: string;
         title: string;
+        credentialKey: string;
         enabled: boolean;
-        missingFields: string[];
         configured: boolean;
-        credentialKey: string;
+        missingFields: string[];
     }, {
         id: string;
         title: string;
+        credentialKey: string;
         enabled: boolean;
-        missingFields: string[];
         configured: boolean;
-        credentialKey: string;
+        missingFields: string[];
     }>, "many">;
     dashboardUrl: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    status: number | null;
-    title: string;
     guid: string;
-    workspace: "personal" | "team";
-    skills: string[];
-    channels: {
-        id: string;
-        title: string;
-        enabled: boolean;
-        missingFields: string[];
-        configured: boolean;
-        credentialKey: string;
-    }[];
-    subscription: {
-        status: string;
-        billing: "wallet" | "card";
-        switchingToWallet: boolean;
-        amountUsd: number | null;
-        daysRemaining: number | null;
-        cancelAtPeriodEnd: boolean;
-        periodEndsAt?: string | undefined;
-    } | null;
+    title: string;
+    status: number | null;
+    workspace: "team" | "personal";
     credits: {
-        extra: number;
         monthly: number;
+        extra: number;
         used: number;
         remaining: number;
+        renewal?: number | undefined;
         period?: string | undefined;
     };
     template: {
         custom: boolean;
-        slug?: string | undefined;
-        title?: string | undefined;
         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;
+        amountUsd: number | null;
+        billing: "wallet" | "card";
+        switchingToWallet: boolean;
+        daysRemaining: number | null;
+        cancelAtPeriodEnd: boolean;
+        periodEndsAt?: string | undefined;
+        atPeriodEnd?: "unknown" | "renews" | "ends" | undefined;
+    } | null;
+    skills: string[];
     missingCredentials: {
-        title: string;
         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;
+    lastActivityAt?: string | undefined;
 }, {
-    status: number | null;
-    title: string;
     guid: string;
-    workspace: "personal" | "team";
-    skills: string[];
-    channels: {
-        id: string;
-        title: string;
-        enabled: boolean;
-        missingFields: string[];
-        configured: boolean;
-        credentialKey: string;
-    }[];
-    subscription: {
-        status: string;
-        billing: "wallet" | "card";
-        switchingToWallet: boolean;
-        amountUsd: number | null;
-        daysRemaining: number | null;
-        cancelAtPeriodEnd: boolean;
-        periodEndsAt?: string | undefined;
-    } | null;
+    title: string;
+    status: number | null;
+    workspace: "team" | "personal";
     credits: {
-        extra: number;
         monthly: number;
+        extra: number;
         used: number;
         remaining: number;
+        renewal?: number | undefined;
         period?: string | undefined;
     };
     template: {
         custom: boolean;
-        slug?: string | undefined;
-        title?: string | undefined;
         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;
+        amountUsd: number | null;
+        billing: "wallet" | "card";
+        switchingToWallet: boolean;
+        daysRemaining: number | null;
+        cancelAtPeriodEnd: boolean;
+        periodEndsAt?: string | undefined;
+        atPeriodEnd?: "unknown" | "renews" | "ends" | undefined;
+    } | null;
+    skills: string[];
     missingCredentials: {
-        title: string;
         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;
+    lastActivityAt?: string | undefined;
 }>;
 export type DeployedAgent = z.infer<typeof deployedAgentSchema>;
 export declare function toDeployedAgent(agent: AgentDetail): DeployedAgent;
@@ -1094,24 +1183,44 @@ export declare function toAgentSummary(row: Record<string, unknown>): AgentSumma
 /** 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 sanitized view of one deployed agent (Detail, Deploy and Update
- * rows). Credential values, billing session links, account ids and the
- * team id are dropped; only states, labels and settings remain.
+ * The keys of the credentials an agent's setup waits for: a credential with a
+ * required field empty, a required credential that holds no value yet, or a
+ * required sign-in that is not connected. A custom build's setup waits only for
+ * the main credential of each active skill, which skillsmeta lists. Its chat
+ * channels are never among them.
+ */
+export declare function credentialKeysSetupWaitsFor(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): string;
-export declare function formatAgentSummaryLines(agent: AgentSummary): string[];
-export declare function formatAgentDetail(agent: AgentDetail): string;
+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;
+/** An agent's title inside a line of this server's own text: on one line, in a code span it cannot close. */
+export declare function agentTitleSpan(title: string): string;
+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>;
 }
-/** The raw Detail row. Callers must pass it through toAgentDetail before returning anything. */
+/** 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;
 }
@@ -1122,19 +1231,45 @@ export interface NextAction {
     arguments: Record<string, unknown>;
     reason: string;
 }
+/** The credential that holds the Wiro project an agent runs models with. */
+export declare const WIRO_PROJECT_CREDENTIAL = "wiro";
+/** The call that connects a Wiro project to an agent. It shows the project first; lead says why it comes now. */
+export declare function bindProjectStep(agentGuid: string, lead: string): NextAction;
 /** 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. */
-export declare function nextStepForAgent(agent: AgentDetail, waitSeconds: number): NextAction | undefined;
-/** Whether a result:false answer is one that Wiro sends before any charge. */
+/**
+ * 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 refusal says the wallet could not be read, which says nothing about what it holds. */
+export declare function isWalletNotRead(error: unknown): boolean;
+/** The words after such a refusal. No funds are asked for: the wallet may hold plenty. */
+export declare const WALLET_NOT_READ_NOTE = "Wiro could not read the balance just now. That is not a low balance, and nothing was charged. Try again in a moment; if it keeps saying so, get_account shows the wallet.";
+/** Whether a result:false answer is one of the refusals known to leave the wallet untouched. */
 export declare function isPreChargeRefusal(error: unknown): boolean;
+/**
+ * Whether a result:false answer says what the wallet paid. Its sentence is the
+ * whole outcome: it is shown as it is, and the call is not repeated.
+ */
+export declare function isKnownPaidOutcome(error: unknown): boolean;
+/**
+ * Whether a result:false answer carries code 110. Its answer is the whole outcome:
+ * the change is reported as failed, what the agent and the wallet show is read by
+ * hand, and the call is not repeated.
+ */
+export declare function isKnownFailedChange(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.
+ * Only the known refusals, an answer that says what the wallet paid or carries
+ * code 110, 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. */
-export declare function settledStatusAdvice(status: number | null): string;
+/** 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;
+/** Advice for a read, which cannot tell whether a start came first: a stopped agent gets what holds now. */
+export declare function readStatusAdvice(agent: Pick<AgentSummary, 'status' | 'subscription' | 'credits'>, plainMember?: boolean): string;
+export {};
 //# sourceMappingURL=user-agent.d.ts.map