@wiro-ai/wiro-mcp 1.4.1 → 1.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (226) hide show
  1. package/README.md +38 -15
  2. package/dist/client.d.ts +19 -6
  3. package/dist/client.d.ts.map +1 -1
  4. package/dist/client.js +44 -27
  5. package/dist/client.js.map +1 -1
  6. package/dist/instructions.d.ts.map +1 -1
  7. package/dist/instructions.js +7 -4
  8. package/dist/instructions.js.map +1 -1
  9. package/dist/playbooks.d.ts.map +1 -1
  10. package/dist/playbooks.js +46 -35
  11. package/dist/playbooks.js.map +1 -1
  12. package/dist/prompts.d.ts.map +1 -1
  13. package/dist/prompts.js +3 -2
  14. package/dist/prompts.js.map +1 -1
  15. package/dist/tools/apply-agent-skills.d.ts.map +1 -1
  16. package/dist/tools/apply-agent-skills.js +458 -109
  17. package/dist/tools/apply-agent-skills.js.map +1 -1
  18. package/dist/tools/bind-agent-project.d.ts +4 -0
  19. package/dist/tools/bind-agent-project.d.ts.map +1 -0
  20. package/dist/tools/bind-agent-project.js +405 -0
  21. package/dist/tools/bind-agent-project.js.map +1 -0
  22. package/dist/tools/cancel-agent-message.d.ts.map +1 -1
  23. package/dist/tools/cancel-agent-message.js +6 -3
  24. package/dist/tools/cancel-agent-message.js.map +1 -1
  25. package/dist/tools/cancel-task.js +3 -3
  26. package/dist/tools/cancel-task.js.map +1 -1
  27. package/dist/tools/clone-workflow.d.ts.map +1 -1
  28. package/dist/tools/clone-workflow.js +5 -4
  29. package/dist/tools/clone-workflow.js.map +1 -1
  30. package/dist/tools/connect-agent-oauth.d.ts.map +1 -1
  31. package/dist/tools/connect-agent-oauth.js +161 -40
  32. package/dist/tools/connect-agent-oauth.js.map +1 -1
  33. package/dist/tools/control-agent.d.ts.map +1 -1
  34. package/dist/tools/control-agent.js +109 -36
  35. package/dist/tools/control-agent.js.map +1 -1
  36. package/dist/tools/create-workflow.d.ts +3 -0
  37. package/dist/tools/create-workflow.d.ts.map +1 -1
  38. package/dist/tools/create-workflow.js +12 -11
  39. package/dist/tools/create-workflow.js.map +1 -1
  40. package/dist/tools/delete-agent-session.d.ts.map +1 -1
  41. package/dist/tools/delete-agent-session.js +18 -12
  42. package/dist/tools/delete-agent-session.js.map +1 -1
  43. package/dist/tools/delete-agent.d.ts.map +1 -1
  44. package/dist/tools/delete-agent.js +12 -9
  45. package/dist/tools/delete-agent.js.map +1 -1
  46. package/dist/tools/delete-workflow.d.ts.map +1 -1
  47. package/dist/tools/delete-workflow.js +5 -4
  48. package/dist/tools/delete-workflow.js.map +1 -1
  49. package/dist/tools/deploy-agent.d.ts.map +1 -1
  50. package/dist/tools/deploy-agent.js +239 -46
  51. package/dist/tools/deploy-agent.js.map +1 -1
  52. package/dist/tools/disconnect-agent-oauth.d.ts.map +1 -1
  53. package/dist/tools/disconnect-agent-oauth.js +32 -12
  54. package/dist/tools/disconnect-agent-oauth.js.map +1 -1
  55. package/dist/tools/get-account.d.ts.map +1 -1
  56. package/dist/tools/get-account.js +148 -42
  57. package/dist/tools/get-account.js.map +1 -1
  58. package/dist/tools/get-agent-activity.d.ts.map +1 -1
  59. package/dist/tools/get-agent-activity.js +185 -35
  60. package/dist/tools/get-agent-activity.js.map +1 -1
  61. package/dist/tools/get-agent-conversation.d.ts.map +1 -1
  62. package/dist/tools/get-agent-conversation.js +57 -35
  63. package/dist/tools/get-agent-conversation.js.map +1 -1
  64. package/dist/tools/get-agent-message.d.ts.map +1 -1
  65. package/dist/tools/get-agent-message.js +6 -4
  66. package/dist/tools/get-agent-message.js.map +1 -1
  67. package/dist/tools/get-agent-template.d.ts.map +1 -1
  68. package/dist/tools/get-agent-template.js +13 -17
  69. package/dist/tools/get-agent-template.js.map +1 -1
  70. package/dist/tools/get-model-schema.js +3 -3
  71. package/dist/tools/get-model-schema.js.map +1 -1
  72. package/dist/tools/get-my-agent.d.ts.map +1 -1
  73. package/dist/tools/get-my-agent.js +13 -8
  74. package/dist/tools/get-my-agent.js.map +1 -1
  75. package/dist/tools/get-playbook.d.ts.map +1 -1
  76. package/dist/tools/get-playbook.js +3 -2
  77. package/dist/tools/get-playbook.js.map +1 -1
  78. package/dist/tools/get-task-price.js +3 -3
  79. package/dist/tools/get-task-price.js.map +1 -1
  80. package/dist/tools/get-task.js +3 -3
  81. package/dist/tools/get-task.js.map +1 -1
  82. package/dist/tools/get-workflow.d.ts.map +1 -1
  83. package/dist/tools/get-workflow.js +38 -19
  84. package/dist/tools/get-workflow.js.map +1 -1
  85. package/dist/tools/index.d.ts +3 -1
  86. package/dist/tools/index.d.ts.map +1 -1
  87. package/dist/tools/index.js +6 -1
  88. package/dist/tools/index.js.map +1 -1
  89. package/dist/tools/kill-task.js +3 -3
  90. package/dist/tools/kill-task.js.map +1 -1
  91. package/dist/tools/list-agent-skills.d.ts.map +1 -1
  92. package/dist/tools/list-agent-skills.js +11 -8
  93. package/dist/tools/list-agent-skills.js.map +1 -1
  94. package/dist/tools/list-agent-templates.js +4 -4
  95. package/dist/tools/list-agent-templates.js.map +1 -1
  96. package/dist/tools/list-my-agents.d.ts.map +1 -1
  97. package/dist/tools/list-my-agents.js +11 -8
  98. package/dist/tools/list-my-agents.js.map +1 -1
  99. package/dist/tools/list-projects.d.ts +4 -0
  100. package/dist/tools/list-projects.d.ts.map +1 -0
  101. package/dist/tools/list-projects.js +141 -0
  102. package/dist/tools/list-projects.js.map +1 -0
  103. package/dist/tools/list-studio-results.js +3 -3
  104. package/dist/tools/list-studio-results.js.map +1 -1
  105. package/dist/tools/list-tasks.js +3 -3
  106. package/dist/tools/list-tasks.js.map +1 -1
  107. package/dist/tools/list-workflow-runs.d.ts.map +1 -1
  108. package/dist/tools/list-workflow-runs.js +6 -4
  109. package/dist/tools/list-workflow-runs.js.map +1 -1
  110. package/dist/tools/list-workflows.d.ts.map +1 -1
  111. package/dist/tools/list-workflows.js +7 -6
  112. package/dist/tools/list-workflows.js.map +1 -1
  113. package/dist/tools/manage-agent-billing.d.ts.map +1 -1
  114. package/dist/tools/manage-agent-billing.js +207 -59
  115. package/dist/tools/manage-agent-billing.js.map +1 -1
  116. package/dist/tools/manage-agent-custom-skill.d.ts.map +1 -1
  117. package/dist/tools/manage-agent-custom-skill.js +119 -15
  118. package/dist/tools/manage-agent-custom-skill.js.map +1 -1
  119. package/dist/tools/recommend-model.js +3 -3
  120. package/dist/tools/recommend-model.js.map +1 -1
  121. package/dist/tools/resume-workflow-run.d.ts.map +1 -1
  122. package/dist/tools/resume-workflow-run.js +3 -2
  123. package/dist/tools/resume-workflow-run.js.map +1 -1
  124. package/dist/tools/run-model.js +3 -3
  125. package/dist/tools/run-model.js.map +1 -1
  126. package/dist/tools/run-workflow.d.ts.map +1 -1
  127. package/dist/tools/run-workflow.js +3 -2
  128. package/dist/tools/run-workflow.js.map +1 -1
  129. package/dist/tools/save-workflow-from-agent.d.ts.map +1 -1
  130. package/dist/tools/save-workflow-from-agent.js +17 -12
  131. package/dist/tools/save-workflow-from-agent.js.map +1 -1
  132. package/dist/tools/schemas.d.ts +32 -26
  133. package/dist/tools/schemas.d.ts.map +1 -1
  134. package/dist/tools/schemas.js +67 -0
  135. package/dist/tools/schemas.js.map +1 -1
  136. package/dist/tools/search-docs.js +3 -3
  137. package/dist/tools/search-docs.js.map +1 -1
  138. package/dist/tools/search-models.js +3 -3
  139. package/dist/tools/search-models.js.map +1 -1
  140. package/dist/tools/send-agent-message.d.ts.map +1 -1
  141. package/dist/tools/send-agent-message.js +30 -9
  142. package/dist/tools/send-agent-message.js.map +1 -1
  143. package/dist/tools/set-agent-credentials.d.ts.map +1 -1
  144. package/dist/tools/set-agent-credentials.js +55 -61
  145. package/dist/tools/set-agent-credentials.js.map +1 -1
  146. package/dist/tools/update-agent.d.ts.map +1 -1
  147. package/dist/tools/update-agent.js +59 -20
  148. package/dist/tools/update-agent.js.map +1 -1
  149. package/dist/tools/update-workflow.d.ts +199 -0
  150. package/dist/tools/update-workflow.d.ts.map +1 -1
  151. package/dist/tools/update-workflow.js +20 -7
  152. package/dist/tools/update-workflow.js.map +1 -1
  153. package/dist/tools/upload-file.js +3 -3
  154. package/dist/tools/upload-file.js.map +1 -1
  155. package/dist/tools/wait-for-task.js +3 -3
  156. package/dist/tools/wait-for-task.js.map +1 -1
  157. package/dist/tools/wait-for-workflow-run.d.ts +3 -3
  158. package/dist/tools/wait-for-workflow-run.d.ts.map +1 -1
  159. package/dist/tools/wait-for-workflow-run.js +7 -6
  160. package/dist/tools/wait-for-workflow-run.js.map +1 -1
  161. package/dist/utils/agent-catalog.d.ts +59 -0
  162. package/dist/utils/agent-catalog.d.ts.map +1 -1
  163. package/dist/utils/agent-catalog.js +28 -7
  164. package/dist/utils/agent-catalog.js.map +1 -1
  165. package/dist/utils/agent-config.d.ts +172 -9
  166. package/dist/utils/agent-config.d.ts.map +1 -1
  167. package/dist/utils/agent-config.js +416 -60
  168. package/dist/utils/agent-config.js.map +1 -1
  169. package/dist/utils/agent-message.d.ts +36 -14
  170. package/dist/utils/agent-message.d.ts.map +1 -1
  171. package/dist/utils/agent-message.js +92 -26
  172. package/dist/utils/agent-message.js.map +1 -1
  173. package/dist/utils/agent-targets.d.ts +7 -3
  174. package/dist/utils/agent-targets.d.ts.map +1 -1
  175. package/dist/utils/agent-targets.js +35 -23
  176. package/dist/utils/agent-targets.js.map +1 -1
  177. package/dist/utils/agent-turns.d.ts +19 -12
  178. package/dist/utils/agent-turns.d.ts.map +1 -1
  179. package/dist/utils/agent-turns.js +97 -15
  180. package/dist/utils/agent-turns.js.map +1 -1
  181. package/dist/utils/api.d.ts +6 -0
  182. package/dist/utils/api.d.ts.map +1 -1
  183. package/dist/utils/api.js +22 -1
  184. package/dist/utils/api.js.map +1 -1
  185. package/dist/utils/format.d.ts.map +1 -1
  186. package/dist/utils/format.js +7 -13
  187. package/dist/utils/format.js.map +1 -1
  188. package/dist/utils/json-schema-dialect.d.ts.map +1 -1
  189. package/dist/utils/json-schema-dialect.js +4 -0
  190. package/dist/utils/json-schema-dialect.js.map +1 -1
  191. package/dist/utils/media.d.ts +8 -0
  192. package/dist/utils/media.d.ts.map +1 -1
  193. package/dist/utils/media.js +29 -0
  194. package/dist/utils/media.js.map +1 -1
  195. package/dist/utils/poll.d.ts +5 -2
  196. package/dist/utils/poll.d.ts.map +1 -1
  197. package/dist/utils/poll.js +10 -9
  198. package/dist/utils/poll.js.map +1 -1
  199. package/dist/utils/quoted-text.d.ts +28 -0
  200. package/dist/utils/quoted-text.d.ts.map +1 -0
  201. package/dist/utils/quoted-text.js +64 -0
  202. package/dist/utils/quoted-text.js.map +1 -0
  203. package/dist/utils/studio-runs.d.ts.map +1 -1
  204. package/dist/utils/studio-runs.js +7 -4
  205. package/dist/utils/studio-runs.js.map +1 -1
  206. package/dist/utils/user-agent.d.ts +197 -29
  207. package/dist/utils/user-agent.d.ts.map +1 -1
  208. package/dist/utils/user-agent.js +314 -48
  209. package/dist/utils/user-agent.js.map +1 -1
  210. package/dist/utils/wiro-project.d.ts +45 -0
  211. package/dist/utils/wiro-project.d.ts.map +1 -0
  212. package/dist/utils/wiro-project.js +66 -0
  213. package/dist/utils/wiro-project.js.map +1 -0
  214. package/dist/utils/workflow-save.d.ts +22 -1
  215. package/dist/utils/workflow-save.d.ts.map +1 -1
  216. package/dist/utils/workflow-save.js +122 -24
  217. package/dist/utils/workflow-save.js.map +1 -1
  218. package/dist/utils/workflow.d.ts +26 -13
  219. package/dist/utils/workflow.d.ts.map +1 -1
  220. package/dist/utils/workflow.js +51 -20
  221. package/dist/utils/workflow.js.map +1 -1
  222. package/dist/utils/workspace.d.ts +30 -4
  223. package/dist/utils/workspace.d.ts.map +1 -1
  224. package/dist/utils/workspace.js +95 -12
  225. package/dist/utils/workspace.js.map +1 -1
  226. package/package.json +1 -1
@@ -85,18 +85,18 @@ export declare const subscriptionSchema: z.ZodObject<{
85
85
  atPeriodEnd: z.ZodOptional<z.ZodEnum<["renews", "ends", "unknown"]>>;
86
86
  }, "strip", z.ZodTypeAny, {
87
87
  status: string;
88
+ amountUsd: number | null;
88
89
  billing: "wallet" | "card";
89
90
  switchingToWallet: boolean;
90
- amountUsd: number | null;
91
91
  daysRemaining: number | null;
92
92
  cancelAtPeriodEnd: boolean;
93
93
  periodEndsAt?: string | undefined;
94
94
  atPeriodEnd?: "unknown" | "renews" | "ends" | undefined;
95
95
  }, {
96
96
  status: string;
97
+ amountUsd: number | null;
97
98
  billing: "wallet" | "card";
98
99
  switchingToWallet: boolean;
99
- amountUsd: number | null;
100
100
  daysRemaining: number | null;
101
101
  cancelAtPeriodEnd: boolean;
102
102
  periodEndsAt?: string | undefined;
@@ -106,8 +106,9 @@ export type AgentSubscription = z.infer<typeof subscriptionSchema>;
106
106
  /**
107
107
  * Whether a plan ends with its current period: true when it ends, false when
108
108
  * it renews, null when that is not known. A wallet plan says so itself, and a
109
- * card plan moving to wallet billing renews from the wallet. Any other card
110
- * plan is known only when the row carries its card state (cardEnds).
109
+ * card plan moving to wallet billing renews from the wallet, even though its
110
+ * card subscription is set to end with the period. Any other card plan is
111
+ * known only when the row carries its card state (cardEnds).
111
112
  */
112
113
  export declare function planEndsWithPeriod(subscription: Record<string, unknown>, cardEnds?: unknown): boolean | null;
113
114
  export declare function toSubscription(value: unknown, cardEnds?: unknown): AgentSubscription | null;
@@ -115,6 +116,7 @@ export declare function toSubscription(value: unknown, cardEnds?: unknown): Agen
115
116
  export declare function chargeRoute(subscription: unknown): 'wallet' | 'card' | null;
116
117
  export declare const creditsSchema: z.ZodObject<{
117
118
  monthly: z.ZodNumber;
119
+ renewal: z.ZodOptional<z.ZodNumber>;
118
120
  extra: z.ZodNumber;
119
121
  used: z.ZodNumber;
120
122
  remaining: z.ZodNumber;
@@ -124,16 +126,20 @@ export declare const creditsSchema: z.ZodObject<{
124
126
  extra: number;
125
127
  used: number;
126
128
  remaining: number;
129
+ renewal?: number | undefined;
127
130
  period?: string | undefined;
128
131
  }, {
129
132
  monthly: number;
130
133
  extra: number;
131
134
  used: number;
132
135
  remaining: number;
136
+ renewal?: number | undefined;
133
137
  period?: string | undefined;
134
138
  }>;
135
139
  export type AgentCredits = z.infer<typeof creditsSchema>;
136
140
  export declare function toCredits(row: Record<string, unknown>): AgentCredits;
141
+ /** The monthly credits as said in a line: those of this period, and those of each renewal when they differ. */
142
+ export declare function monthlyCreditsText(credits: Pick<AgentCredits, 'monthly' | 'renewal'>): string;
137
143
  /** Plain text from catalog HTML. Links keep their target so setup steps stay usable. */
138
144
  export declare function htmlToText(value: unknown, maxLength?: number): string;
139
145
  export declare function toStringArray(value: unknown): string[];
@@ -189,10 +195,20 @@ export declare const channelStatusSchema: z.ZodObject<{
189
195
  }>;
190
196
  export type ChannelStatus = z.infer<typeof channelStatusSchema>;
191
197
  export declare function summarizeChannels(value: unknown): ChannelStatus[];
198
+ /** The titles of the skills that are on, from Detail's skillsmeta. */
199
+ export declare function activeSkillTitles(row: Record<string, unknown>): Map<string, string>;
200
+ /** Lists of skill names, such as the skills a paused task waits for: [["a"], ["b", "c"]]. Empty lists and non-names are dropped. */
201
+ export declare function toSkillGroups(value: unknown): string[][];
202
+ /** The scheduled task a custom build starts with. It runs only once its text has been written. */
203
+ export declare const STARTER_TASK_KEY = "cs-cron-my-scheduled-task";
192
204
  export declare const agentTaskSchema: z.ZodObject<{
193
205
  key: z.ZodString;
194
206
  description: z.ZodOptional<z.ZodString>;
195
207
  enabled: z.ZodBoolean;
208
+ notWritten: z.ZodOptional<z.ZodBoolean>;
209
+ ownerSkills: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
210
+ skillOff: z.ZodOptional<z.ZodBoolean>;
211
+ offSkills: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodString, "many">, "many">>;
196
212
  interval: z.ZodOptional<z.ZodNullable<z.ZodString>>;
197
213
  source: z.ZodOptional<z.ZodEnum<["template", "skill", "user"]>>;
198
214
  instructions: z.ZodOptional<z.ZodString>;
@@ -202,6 +218,10 @@ export declare const agentTaskSchema: z.ZodObject<{
202
218
  enabled: boolean;
203
219
  instructions?: string | undefined;
204
220
  description?: string | undefined;
221
+ notWritten?: boolean | undefined;
222
+ ownerSkills?: string[] | undefined;
223
+ skillOff?: boolean | undefined;
224
+ offSkills?: string[][] | undefined;
205
225
  interval?: string | null | undefined;
206
226
  source?: "user" | "template" | "skill" | undefined;
207
227
  instructionsTruncated?: boolean | undefined;
@@ -210,6 +230,10 @@ export declare const agentTaskSchema: z.ZodObject<{
210
230
  enabled: boolean;
211
231
  instructions?: string | undefined;
212
232
  description?: string | undefined;
233
+ notWritten?: boolean | undefined;
234
+ ownerSkills?: string[] | undefined;
235
+ skillOff?: boolean | undefined;
236
+ offSkills?: string[][] | undefined;
213
237
  interval?: string | null | undefined;
214
238
  source?: "user" | "template" | "skill" | undefined;
215
239
  instructionsTruncated?: boolean | undefined;
@@ -274,6 +298,7 @@ export declare const agentSummarySchema: z.ZodObject<{
274
298
  monthlyPriceUsd: z.ZodNullable<z.ZodNumber>;
275
299
  credits: z.ZodObject<{
276
300
  monthly: z.ZodNumber;
301
+ renewal: z.ZodOptional<z.ZodNumber>;
277
302
  extra: z.ZodNumber;
278
303
  used: z.ZodNumber;
279
304
  remaining: z.ZodNumber;
@@ -283,12 +308,14 @@ export declare const agentSummarySchema: z.ZodObject<{
283
308
  extra: number;
284
309
  used: number;
285
310
  remaining: number;
311
+ renewal?: number | undefined;
286
312
  period?: string | undefined;
287
313
  }, {
288
314
  monthly: number;
289
315
  extra: number;
290
316
  used: number;
291
317
  remaining: number;
318
+ renewal?: number | undefined;
292
319
  period?: string | undefined;
293
320
  }>;
294
321
  subscription: z.ZodNullable<z.ZodObject<{
@@ -302,18 +329,18 @@ export declare const agentSummarySchema: z.ZodObject<{
302
329
  atPeriodEnd: z.ZodOptional<z.ZodEnum<["renews", "ends", "unknown"]>>;
303
330
  }, "strip", z.ZodTypeAny, {
304
331
  status: string;
332
+ amountUsd: number | null;
305
333
  billing: "wallet" | "card";
306
334
  switchingToWallet: boolean;
307
- amountUsd: number | null;
308
335
  daysRemaining: number | null;
309
336
  cancelAtPeriodEnd: boolean;
310
337
  periodEndsAt?: string | undefined;
311
338
  atPeriodEnd?: "unknown" | "renews" | "ends" | undefined;
312
339
  }, {
313
340
  status: string;
341
+ amountUsd: number | null;
314
342
  billing: "wallet" | "card";
315
343
  switchingToWallet: boolean;
316
- amountUsd: number | null;
317
344
  daysRemaining: number | null;
318
345
  cancelAtPeriodEnd: boolean;
319
346
  periodEndsAt?: string | undefined;
@@ -324,16 +351,18 @@ export declare const agentSummarySchema: z.ZodObject<{
324
351
  skills: z.ZodArray<z.ZodString, "many">;
325
352
  createdAt: z.ZodOptional<z.ZodString>;
326
353
  updatedAt: z.ZodOptional<z.ZodString>;
354
+ lastActivityAt: z.ZodOptional<z.ZodString>;
327
355
  }, "strip", z.ZodTypeAny, {
328
356
  guid: string;
329
357
  title: string;
330
358
  status: number | null;
331
- workspace: "personal" | "team";
359
+ workspace: "team" | "personal";
332
360
  credits: {
333
361
  monthly: number;
334
362
  extra: number;
335
363
  used: number;
336
364
  remaining: number;
365
+ renewal?: number | undefined;
337
366
  period?: string | undefined;
338
367
  };
339
368
  template: {
@@ -347,9 +376,9 @@ export declare const agentSummarySchema: z.ZodObject<{
347
376
  monthlyPriceUsd: number | null;
348
377
  subscription: {
349
378
  status: string;
379
+ amountUsd: number | null;
350
380
  billing: "wallet" | "card";
351
381
  switchingToWallet: boolean;
352
- amountUsd: number | null;
353
382
  daysRemaining: number | null;
354
383
  cancelAtPeriodEnd: boolean;
355
384
  periodEndsAt?: string | undefined;
@@ -361,16 +390,18 @@ export declare const agentSummarySchema: z.ZodObject<{
361
390
  tier?: string | undefined;
362
391
  timezone?: string | null | undefined;
363
392
  teamSessionMode?: string | undefined;
393
+ lastActivityAt?: string | undefined;
364
394
  }, {
365
395
  guid: string;
366
396
  title: string;
367
397
  status: number | null;
368
- workspace: "personal" | "team";
398
+ workspace: "team" | "personal";
369
399
  credits: {
370
400
  monthly: number;
371
401
  extra: number;
372
402
  used: number;
373
403
  remaining: number;
404
+ renewal?: number | undefined;
374
405
  period?: string | undefined;
375
406
  };
376
407
  template: {
@@ -384,9 +415,9 @@ export declare const agentSummarySchema: z.ZodObject<{
384
415
  monthlyPriceUsd: number | null;
385
416
  subscription: {
386
417
  status: string;
418
+ amountUsd: number | null;
387
419
  billing: "wallet" | "card";
388
420
  switchingToWallet: boolean;
389
- amountUsd: number | null;
390
421
  daysRemaining: number | null;
391
422
  cancelAtPeriodEnd: boolean;
392
423
  periodEndsAt?: string | undefined;
@@ -398,6 +429,7 @@ export declare const agentSummarySchema: z.ZodObject<{
398
429
  tier?: string | undefined;
399
430
  timezone?: string | null | undefined;
400
431
  teamSessionMode?: string | undefined;
432
+ lastActivityAt?: string | undefined;
401
433
  }>;
402
434
  export type AgentSummary = z.infer<typeof agentSummarySchema>;
403
435
  export declare const agentDetailSchema: z.ZodObject<{
@@ -427,6 +459,7 @@ export declare const agentDetailSchema: z.ZodObject<{
427
459
  monthlyPriceUsd: z.ZodNullable<z.ZodNumber>;
428
460
  credits: z.ZodObject<{
429
461
  monthly: z.ZodNumber;
462
+ renewal: z.ZodOptional<z.ZodNumber>;
430
463
  extra: z.ZodNumber;
431
464
  used: z.ZodNumber;
432
465
  remaining: z.ZodNumber;
@@ -436,12 +469,14 @@ export declare const agentDetailSchema: z.ZodObject<{
436
469
  extra: number;
437
470
  used: number;
438
471
  remaining: number;
472
+ renewal?: number | undefined;
439
473
  period?: string | undefined;
440
474
  }, {
441
475
  monthly: number;
442
476
  extra: number;
443
477
  used: number;
444
478
  remaining: number;
479
+ renewal?: number | undefined;
445
480
  period?: string | undefined;
446
481
  }>;
447
482
  subscription: z.ZodNullable<z.ZodObject<{
@@ -455,18 +490,18 @@ export declare const agentDetailSchema: z.ZodObject<{
455
490
  atPeriodEnd: z.ZodOptional<z.ZodEnum<["renews", "ends", "unknown"]>>;
456
491
  }, "strip", z.ZodTypeAny, {
457
492
  status: string;
493
+ amountUsd: number | null;
458
494
  billing: "wallet" | "card";
459
495
  switchingToWallet: boolean;
460
- amountUsd: number | null;
461
496
  daysRemaining: number | null;
462
497
  cancelAtPeriodEnd: boolean;
463
498
  periodEndsAt?: string | undefined;
464
499
  atPeriodEnd?: "unknown" | "renews" | "ends" | undefined;
465
500
  }, {
466
501
  status: string;
502
+ amountUsd: number | null;
467
503
  billing: "wallet" | "card";
468
504
  switchingToWallet: boolean;
469
- amountUsd: number | null;
470
505
  daysRemaining: number | null;
471
506
  cancelAtPeriodEnd: boolean;
472
507
  periodEndsAt?: string | undefined;
@@ -477,6 +512,7 @@ export declare const agentDetailSchema: z.ZodObject<{
477
512
  skills: z.ZodArray<z.ZodString, "many">;
478
513
  createdAt: z.ZodOptional<z.ZodString>;
479
514
  updatedAt: z.ZodOptional<z.ZodString>;
515
+ lastActivityAt: z.ZodOptional<z.ZodString>;
480
516
  } & {
481
517
  description: z.ZodOptional<z.ZodString>;
482
518
  cover: z.ZodOptional<z.ZodString>;
@@ -631,6 +667,10 @@ export declare const agentDetailSchema: z.ZodObject<{
631
667
  key: z.ZodString;
632
668
  description: z.ZodOptional<z.ZodString>;
633
669
  enabled: z.ZodBoolean;
670
+ notWritten: z.ZodOptional<z.ZodBoolean>;
671
+ ownerSkills: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
672
+ skillOff: z.ZodOptional<z.ZodBoolean>;
673
+ offSkills: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodString, "many">, "many">>;
634
674
  interval: z.ZodOptional<z.ZodNullable<z.ZodString>>;
635
675
  source: z.ZodOptional<z.ZodEnum<["template", "skill", "user"]>>;
636
676
  instructions: z.ZodOptional<z.ZodString>;
@@ -640,6 +680,10 @@ export declare const agentDetailSchema: z.ZodObject<{
640
680
  enabled: boolean;
641
681
  instructions?: string | undefined;
642
682
  description?: string | undefined;
683
+ notWritten?: boolean | undefined;
684
+ ownerSkills?: string[] | undefined;
685
+ skillOff?: boolean | undefined;
686
+ offSkills?: string[][] | undefined;
643
687
  interval?: string | null | undefined;
644
688
  source?: "user" | "template" | "skill" | undefined;
645
689
  instructionsTruncated?: boolean | undefined;
@@ -648,6 +692,10 @@ export declare const agentDetailSchema: z.ZodObject<{
648
692
  enabled: boolean;
649
693
  instructions?: string | undefined;
650
694
  description?: string | undefined;
695
+ notWritten?: boolean | undefined;
696
+ ownerSkills?: string[] | undefined;
697
+ skillOff?: boolean | undefined;
698
+ offSkills?: string[][] | undefined;
651
699
  interval?: string | null | undefined;
652
700
  source?: "user" | "template" | "skill" | undefined;
653
701
  instructionsTruncated?: boolean | undefined;
@@ -656,6 +704,10 @@ export declare const agentDetailSchema: z.ZodObject<{
656
704
  key: z.ZodString;
657
705
  description: z.ZodOptional<z.ZodString>;
658
706
  enabled: z.ZodBoolean;
707
+ notWritten: z.ZodOptional<z.ZodBoolean>;
708
+ ownerSkills: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
709
+ skillOff: z.ZodOptional<z.ZodBoolean>;
710
+ offSkills: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodString, "many">, "many">>;
659
711
  interval: z.ZodOptional<z.ZodNullable<z.ZodString>>;
660
712
  source: z.ZodOptional<z.ZodEnum<["template", "skill", "user"]>>;
661
713
  instructions: z.ZodOptional<z.ZodString>;
@@ -665,6 +717,10 @@ export declare const agentDetailSchema: z.ZodObject<{
665
717
  enabled: boolean;
666
718
  instructions?: string | undefined;
667
719
  description?: string | undefined;
720
+ notWritten?: boolean | undefined;
721
+ ownerSkills?: string[] | undefined;
722
+ skillOff?: boolean | undefined;
723
+ offSkills?: string[][] | undefined;
668
724
  interval?: string | null | undefined;
669
725
  source?: "user" | "template" | "skill" | undefined;
670
726
  instructionsTruncated?: boolean | undefined;
@@ -673,6 +729,10 @@ export declare const agentDetailSchema: z.ZodObject<{
673
729
  enabled: boolean;
674
730
  instructions?: string | undefined;
675
731
  description?: string | undefined;
732
+ notWritten?: boolean | undefined;
733
+ ownerSkills?: string[] | undefined;
734
+ skillOff?: boolean | undefined;
735
+ offSkills?: string[][] | undefined;
676
736
  interval?: string | null | undefined;
677
737
  source?: "user" | "template" | "skill" | undefined;
678
738
  instructionsTruncated?: boolean | undefined;
@@ -698,12 +758,13 @@ export declare const agentDetailSchema: z.ZodObject<{
698
758
  monthlyCredits: number;
699
759
  };
700
760
  } | null;
701
- workspace: "personal" | "team";
761
+ workspace: "team" | "personal";
702
762
  credits: {
703
763
  monthly: number;
704
764
  extra: number;
705
765
  used: number;
706
766
  remaining: number;
767
+ renewal?: number | undefined;
707
768
  period?: string | undefined;
708
769
  };
709
770
  template: {
@@ -717,9 +778,9 @@ export declare const agentDetailSchema: z.ZodObject<{
717
778
  monthlyPriceUsd: number | null;
718
779
  subscription: {
719
780
  status: string;
781
+ amountUsd: number | null;
720
782
  billing: "wallet" | "card";
721
783
  switchingToWallet: boolean;
722
- amountUsd: number | null;
723
784
  daysRemaining: number | null;
724
785
  cancelAtPeriodEnd: boolean;
725
786
  periodEndsAt?: string | undefined;
@@ -759,6 +820,10 @@ export declare const agentDetailSchema: z.ZodObject<{
759
820
  enabled: boolean;
760
821
  instructions?: string | undefined;
761
822
  description?: string | undefined;
823
+ notWritten?: boolean | undefined;
824
+ ownerSkills?: string[] | undefined;
825
+ skillOff?: boolean | undefined;
826
+ offSkills?: string[][] | undefined;
762
827
  interval?: string | null | undefined;
763
828
  source?: "user" | "template" | "skill" | undefined;
764
829
  instructionsTruncated?: boolean | undefined;
@@ -768,6 +833,10 @@ export declare const agentDetailSchema: z.ZodObject<{
768
833
  enabled: boolean;
769
834
  instructions?: string | undefined;
770
835
  description?: string | undefined;
836
+ notWritten?: boolean | undefined;
837
+ ownerSkills?: string[] | undefined;
838
+ skillOff?: boolean | undefined;
839
+ offSkills?: string[][] | undefined;
771
840
  interval?: string | null | undefined;
772
841
  source?: "user" | "template" | "skill" | undefined;
773
842
  instructionsTruncated?: boolean | undefined;
@@ -787,6 +856,7 @@ export declare const agentDetailSchema: z.ZodObject<{
787
856
  tier?: string | undefined;
788
857
  timezone?: string | null | undefined;
789
858
  teamSessionMode?: string | undefined;
859
+ lastActivityAt?: string | undefined;
790
860
  selectableModels?: {
791
861
  slug: string;
792
862
  label?: string | undefined;
@@ -812,12 +882,13 @@ export declare const agentDetailSchema: z.ZodObject<{
812
882
  monthlyCredits: number;
813
883
  };
814
884
  } | null;
815
- workspace: "personal" | "team";
885
+ workspace: "team" | "personal";
816
886
  credits: {
817
887
  monthly: number;
818
888
  extra: number;
819
889
  used: number;
820
890
  remaining: number;
891
+ renewal?: number | undefined;
821
892
  period?: string | undefined;
822
893
  };
823
894
  template: {
@@ -831,9 +902,9 @@ export declare const agentDetailSchema: z.ZodObject<{
831
902
  monthlyPriceUsd: number | null;
832
903
  subscription: {
833
904
  status: string;
905
+ amountUsd: number | null;
834
906
  billing: "wallet" | "card";
835
907
  switchingToWallet: boolean;
836
- amountUsd: number | null;
837
908
  daysRemaining: number | null;
838
909
  cancelAtPeriodEnd: boolean;
839
910
  periodEndsAt?: string | undefined;
@@ -873,6 +944,10 @@ export declare const agentDetailSchema: z.ZodObject<{
873
944
  enabled: boolean;
874
945
  instructions?: string | undefined;
875
946
  description?: string | undefined;
947
+ notWritten?: boolean | undefined;
948
+ ownerSkills?: string[] | undefined;
949
+ skillOff?: boolean | undefined;
950
+ offSkills?: string[][] | undefined;
876
951
  interval?: string | null | undefined;
877
952
  source?: "user" | "template" | "skill" | undefined;
878
953
  instructionsTruncated?: boolean | undefined;
@@ -882,6 +957,10 @@ export declare const agentDetailSchema: z.ZodObject<{
882
957
  enabled: boolean;
883
958
  instructions?: string | undefined;
884
959
  description?: string | undefined;
960
+ notWritten?: boolean | undefined;
961
+ ownerSkills?: string[] | undefined;
962
+ skillOff?: boolean | undefined;
963
+ offSkills?: string[][] | undefined;
885
964
  interval?: string | null | undefined;
886
965
  source?: "user" | "template" | "skill" | undefined;
887
966
  instructionsTruncated?: boolean | undefined;
@@ -901,6 +980,7 @@ export declare const agentDetailSchema: z.ZodObject<{
901
980
  tier?: string | undefined;
902
981
  timezone?: string | null | undefined;
903
982
  teamSessionMode?: string | undefined;
983
+ lastActivityAt?: string | undefined;
904
984
  selectableModels?: {
905
985
  slug: string;
906
986
  label?: string | undefined;
@@ -941,6 +1021,7 @@ export declare const deployedAgentSchema: z.ZodObject<{
941
1021
  monthlyPriceUsd: z.ZodNullable<z.ZodNumber>;
942
1022
  credits: z.ZodObject<{
943
1023
  monthly: z.ZodNumber;
1024
+ renewal: z.ZodOptional<z.ZodNumber>;
944
1025
  extra: z.ZodNumber;
945
1026
  used: z.ZodNumber;
946
1027
  remaining: z.ZodNumber;
@@ -950,12 +1031,14 @@ export declare const deployedAgentSchema: z.ZodObject<{
950
1031
  extra: number;
951
1032
  used: number;
952
1033
  remaining: number;
1034
+ renewal?: number | undefined;
953
1035
  period?: string | undefined;
954
1036
  }, {
955
1037
  monthly: number;
956
1038
  extra: number;
957
1039
  used: number;
958
1040
  remaining: number;
1041
+ renewal?: number | undefined;
959
1042
  period?: string | undefined;
960
1043
  }>;
961
1044
  subscription: z.ZodNullable<z.ZodObject<{
@@ -969,18 +1052,18 @@ export declare const deployedAgentSchema: z.ZodObject<{
969
1052
  atPeriodEnd: z.ZodOptional<z.ZodEnum<["renews", "ends", "unknown"]>>;
970
1053
  }, "strip", z.ZodTypeAny, {
971
1054
  status: string;
1055
+ amountUsd: number | null;
972
1056
  billing: "wallet" | "card";
973
1057
  switchingToWallet: boolean;
974
- amountUsd: number | null;
975
1058
  daysRemaining: number | null;
976
1059
  cancelAtPeriodEnd: boolean;
977
1060
  periodEndsAt?: string | undefined;
978
1061
  atPeriodEnd?: "unknown" | "renews" | "ends" | undefined;
979
1062
  }, {
980
1063
  status: string;
1064
+ amountUsd: number | null;
981
1065
  billing: "wallet" | "card";
982
1066
  switchingToWallet: boolean;
983
- amountUsd: number | null;
984
1067
  daysRemaining: number | null;
985
1068
  cancelAtPeriodEnd: boolean;
986
1069
  periodEndsAt?: string | undefined;
@@ -991,6 +1074,7 @@ export declare const deployedAgentSchema: z.ZodObject<{
991
1074
  skills: z.ZodArray<z.ZodString, "many">;
992
1075
  createdAt: z.ZodOptional<z.ZodString>;
993
1076
  updatedAt: z.ZodOptional<z.ZodString>;
1077
+ lastActivityAt: z.ZodOptional<z.ZodString>;
994
1078
  } & {
995
1079
  missingCredentials: z.ZodArray<z.ZodObject<{
996
1080
  key: z.ZodString;
@@ -1032,12 +1116,13 @@ export declare const deployedAgentSchema: z.ZodObject<{
1032
1116
  guid: string;
1033
1117
  title: string;
1034
1118
  status: number | null;
1035
- workspace: "personal" | "team";
1119
+ workspace: "team" | "personal";
1036
1120
  credits: {
1037
1121
  monthly: number;
1038
1122
  extra: number;
1039
1123
  used: number;
1040
1124
  remaining: number;
1125
+ renewal?: number | undefined;
1041
1126
  period?: string | undefined;
1042
1127
  };
1043
1128
  template: {
@@ -1051,9 +1136,9 @@ export declare const deployedAgentSchema: z.ZodObject<{
1051
1136
  monthlyPriceUsd: number | null;
1052
1137
  subscription: {
1053
1138
  status: string;
1139
+ amountUsd: number | null;
1054
1140
  billing: "wallet" | "card";
1055
1141
  switchingToWallet: boolean;
1056
- amountUsd: number | null;
1057
1142
  daysRemaining: number | null;
1058
1143
  cancelAtPeriodEnd: boolean;
1059
1144
  periodEndsAt?: string | undefined;
@@ -1079,16 +1164,18 @@ export declare const deployedAgentSchema: z.ZodObject<{
1079
1164
  tier?: string | undefined;
1080
1165
  timezone?: string | null | undefined;
1081
1166
  teamSessionMode?: string | undefined;
1167
+ lastActivityAt?: string | undefined;
1082
1168
  }, {
1083
1169
  guid: string;
1084
1170
  title: string;
1085
1171
  status: number | null;
1086
- workspace: "personal" | "team";
1172
+ workspace: "team" | "personal";
1087
1173
  credits: {
1088
1174
  monthly: number;
1089
1175
  extra: number;
1090
1176
  used: number;
1091
1177
  remaining: number;
1178
+ renewal?: number | undefined;
1092
1179
  period?: string | undefined;
1093
1180
  };
1094
1181
  template: {
@@ -1102,9 +1189,9 @@ export declare const deployedAgentSchema: z.ZodObject<{
1102
1189
  monthlyPriceUsd: number | null;
1103
1190
  subscription: {
1104
1191
  status: string;
1192
+ amountUsd: number | null;
1105
1193
  billing: "wallet" | "card";
1106
1194
  switchingToWallet: boolean;
1107
- amountUsd: number | null;
1108
1195
  daysRemaining: number | null;
1109
1196
  cancelAtPeriodEnd: boolean;
1110
1197
  periodEndsAt?: string | undefined;
@@ -1130,6 +1217,7 @@ export declare const deployedAgentSchema: z.ZodObject<{
1130
1217
  tier?: string | undefined;
1131
1218
  timezone?: string | null | undefined;
1132
1219
  teamSessionMode?: string | undefined;
1220
+ lastActivityAt?: string | undefined;
1133
1221
  }>;
1134
1222
  export type DeployedAgent = z.infer<typeof deployedAgentSchema>;
1135
1223
  export declare function toDeployedAgent(agent: AgentDetail): DeployedAgent;
@@ -1137,6 +1225,14 @@ export declare function toDeployedAgent(agent: AgentDetail): DeployedAgent;
1137
1225
  export declare function toAgentSummary(row: Record<string, unknown>): AgentSummary;
1138
1226
  /** Slugs a deployed agent may switch its chat, cron or voice model to. */
1139
1227
  export declare function selectableModelSlugs(row: Record<string, unknown>): Set<string>;
1228
+ /**
1229
+ * The keys of the credentials an agent's setup waits for: a credential with a
1230
+ * required field empty, a required credential that holds no value yet, or a
1231
+ * required sign-in that is not connected. A custom build's setup waits only for
1232
+ * the main credential of each active skill, which skillsmeta lists. Its chat
1233
+ * channels are never among them.
1234
+ */
1235
+ export declare function credentialKeysSetupWaitsFor(row: Record<string, unknown>): Set<string>;
1140
1236
  /**
1141
1237
  * The full view of one deployed agent (Detail, Deploy and Update rows): its
1142
1238
  * status, plan, prices, credits and settings, and the state of each
@@ -1146,14 +1242,65 @@ export declare function toAgentDetail(row: Record<string, unknown>): AgentDetail
1146
1242
  export declare function formatSubscriptionLine(subscription: AgentSubscription | null, plainMember?: boolean): string;
1147
1243
  /** Without an active plan, an agent starts only on the extra credits it has left. */
1148
1244
  export declare function startNeedsPlan(agent: Pick<AgentSummary, 'subscription' | 'credits'>): boolean;
1245
+ /** An agent's title inside a line of this server's own text: on one line, in a code span it cannot close. */
1246
+ export declare function agentTitleSpan(title: string): string;
1149
1247
  export declare function formatAgentSummaryLines(agent: AgentSummary, plainMember?: boolean): string[];
1150
- /** A scheduled task as a list line: key, on or off, schedule and description, then shortenedNote if its text was cut. */
1151
- export declare function formatScheduledTaskLine(task: AgentTask, shortenedNote?: string): string;
1152
- /** A custom instruction as a list line: key, on or off and description, then shortenedNote if its text was cut. */
1248
+ /** Names inside a sentence: a, b and c. */
1249
+ export declare function nameList(names: readonly string[], word: 'and' | 'or'): string;
1250
+ /**
1251
+ * A name made from a key, as the dashboard makes it, for when there is no title: int-brevo-email reads
1252
+ * Brevo Email and ga4-attribution-auditor GA4 Attribution Auditor. known: false leaves the list of brands
1253
+ * and acronyms out, for a name the customer typed.
1254
+ */
1255
+ export declare function wordsFromKey(key: string, { known }?: {
1256
+ known?: boolean;
1257
+ }): string;
1258
+ /**
1259
+ * A custom skill or scheduled task as people see it, by the name the dashboard makes from its key, with the
1260
+ * key the tools take: GA4 Attribution Auditor (`cs-cron-ga4-attribution-auditor`). known is false for a task
1261
+ * the customer named. A key that is not plain words shows alone.
1262
+ */
1263
+ export declare function taskLabel(key: string, known?: boolean): string;
1264
+ /** Whether a task's name comes from Wiro's words: one the customer created and named reads as typed. */
1265
+ export declare function taskNamedByWiro(task: {
1266
+ source?: string;
1267
+ userCreated?: boolean;
1268
+ ownerSkills?: string[];
1269
+ }): boolean;
1270
+ /**
1271
+ * A skill as people see it, by its catalog title, with the name apply_agent_skills takes: Gmail Check
1272
+ * (`int-gmail-check`). Without the title, words made from the name stand in for it.
1273
+ */
1274
+ export declare function skillLabel(name: string, titles?: ReadonlyMap<string, string>): string;
1275
+ /**
1276
+ * Why a paused task does not run, as a clause that names the skills to turn on (offSkills, one from each
1277
+ * list). Its own on/off state stays as it is: a task that is on runs again once they are on, and one that is
1278
+ * off also needs turning on.
1279
+ */
1280
+ export declare function skillOffText(task: Pick<AgentTask, 'enabled' | 'offSkills'>, titles?: ReadonlyMap<string, string>): string;
1281
+ /** A task that waits for skills (lists, one from each) as a sentence with a space before it: " `key` stays paused until A is on." */
1282
+ export declare function waitingTaskSentence(key: string, groups: readonly (readonly string[])[], titles?: ReadonlyMap<string, string>, verb?: string): string;
1283
+ /**
1284
+ * The paused tasks among these, each as a sentence that names the skills to turn on, with a space before it.
1285
+ * A saved credential turns such a task on, but it stays paused until they are on; verb says it otherwise,
1286
+ * such as "is paused" for a task the change at hand paused.
1287
+ */
1288
+ export declare function skillOffTasksNote(tasks: ReadonlyArray<{
1289
+ key: string;
1290
+ offSkills?: string[][];
1291
+ skillOff?: boolean;
1292
+ }>, titles?: ReadonlyMap<string, string>, verb?: string): string;
1293
+ /**
1294
+ * A scheduled task as a list line: name and key, on or off, schedule and description, then shortenedNote if its text
1295
+ * was cut. titles names the skills a paused task waits for as people see them.
1296
+ */
1297
+ export declare function formatScheduledTaskLine(task: AgentTask, shortenedNote?: string, titles?: ReadonlyMap<string, string>): string;
1298
+ /** A custom instruction as a list line: name and key, on or off and description, then shortenedNote if its text was cut. */
1153
1299
  export declare function formatCustomInstructionLine(task: AgentTask, shortenedNote?: string): string;
1154
1300
  /** Each model with its credits per 1M input and output tokens, separated by semicolons. */
1155
1301
  export declare function formatModelRates(models: readonly SelectableModel[]): string;
1156
- export declare function formatAgentDetail(agent: AgentDetail, plainMember?: boolean): string;
1302
+ /** titles names skills as people see them: the agent's own (activeSkillTitles) and those a paused task waits for (pausedSkillTitles). */
1303
+ export declare function formatAgentDetail(agent: AgentDetail, plainMember?: boolean, titles?: ReadonlyMap<string, string>): string;
1157
1304
  export declare function normalizeCustomSkillKey(input: string, interval?: string | null): string | null;
1158
1305
  export declare function isGuid(value: string): boolean;
1159
1306
  export interface AgentApiClient {
@@ -1176,6 +1323,10 @@ export interface NextAction {
1176
1323
  arguments: Record<string, unknown>;
1177
1324
  reason: string;
1178
1325
  }
1326
+ /** The credential that holds the Wiro project an agent runs models with. */
1327
+ export declare const WIRO_PROJECT_CREDENTIAL = "wiro";
1328
+ /** The call that connects a Wiro project to an agent. It shows the project first; lead says why it comes now. */
1329
+ export declare function bindProjectStep(agentGuid: string, lead: string): NextAction;
1179
1330
  /** The call that starts on the first missing credential, with every argument it needs. */
1180
1331
  export declare function missingCredentialStep(agent: Pick<AgentDetail, 'guid' | 'missingCredentials'>): NextAction | undefined;
1181
1332
  /**
@@ -1184,16 +1335,33 @@ export declare function missingCredentialStep(agent: Pick<AgentDetail, 'guid' |
1184
1335
  * by itself.
1185
1336
  */
1186
1337
  export declare function nextStepForAgent(agent: AgentDetail, waitSeconds: number, plainMember?: boolean): NextAction | undefined;
1338
+ /** Whether a refusal says the wallet could not be read, which says nothing about what it holds. */
1339
+ export declare function isWalletNotRead(error: unknown): boolean;
1340
+ /** The words after such a refusal. No funds are asked for: the wallet may hold plenty. */
1341
+ 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.";
1187
1342
  /** Whether a result:false answer is one of the refusals known to leave the wallet untouched. */
1188
1343
  export declare function isPreChargeRefusal(error: unknown): boolean;
1344
+ /**
1345
+ * Whether a result:false answer says what the wallet paid. Its sentence is the
1346
+ * whole outcome: it is shown as it is, and the call is not repeated.
1347
+ */
1348
+ export declare function isKnownPaidOutcome(error: unknown): boolean;
1349
+ /**
1350
+ * Whether a result:false answer carries code 110. Its answer is the whole outcome:
1351
+ * the change is reported as failed, what the agent and the wallet show is read by
1352
+ * hand, and the call is not repeated.
1353
+ */
1354
+ export declare function isKnownFailedChange(error: unknown): boolean;
1189
1355
  /**
1190
1356
  * After a paid request was sent, whether it may still have gone through.
1191
- * Only the known refusals and client errors (other than a timeout or rate
1192
- * limit) settle it; any other answer, a network failure or a server error
1193
- * leaves it open.
1357
+ * Only the known refusals, an answer that says what the wallet paid or carries
1358
+ * code 110, and client errors (other than a timeout or rate limit) settle it; any
1359
+ * other answer, a network failure or a server error leaves it open.
1194
1360
  */
1195
1361
  export declare function outcomeUnknown(error: unknown): boolean;
1196
1362
  /** 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. */
1197
1363
  export declare function settledStatusAdvice(status: number | null, plainMember?: boolean, agent?: Pick<AgentSummary, 'subscription' | 'credits'>): string;
1364
+ /** Advice for a read, which cannot tell whether a start came first: a stopped agent gets what holds now. */
1365
+ export declare function readStatusAdvice(agent: Pick<AgentSummary, 'status' | 'subscription' | 'credits'>, plainMember?: boolean): string;
1198
1366
  export {};
1199
1367
  //# sourceMappingURL=user-agent.d.ts.map