@m8tes/sdk 0.1.0-alpha.3 → 0.1.0-alpha.5

package/dist/index.d.cts

@@ -171,6 +171,12 @@ interface Agent {
     enable_task_setup_tools?: boolean | null;
     enable_feedback?: boolean | null;
     enable_self_improvement?: boolean | null;
+    /** Most recent run activity in the last 90 days; null if idle longer. */
+    last_active_at?: string | null;
+    /** How many runs are executing or awaiting approval right now. */
+    active_run_count?: number;
+    /** Sole live run id when active_run_count is exactly 1; otherwise null. */
+    active_run_id?: number | null;
 }
 /** Permanent alias — the platform term is "agent", the DB model is `Teammate`. */
 type Teammate = Agent;
@@ -200,6 +206,10 @@ interface Run {
     /** Provider behind an OAuth subscription route: claude, openai, xai, or gemini. */
     auth_provider?: string | null;
     retryable?: boolean;
+    /** Whether this run performed any non-read-only action. Null when not computed. */
+    repeats_actions?: boolean | null;
+    /** Whether the offered recovery would repeat an action; latest turn only for chat. */
+    recovery_repeats_actions?: boolean | null;
     retry_of_run_id?: number | null;
     retry_count?: number;
     output_data?: JsonObject | null;
@@ -212,6 +222,9 @@ interface RunOutcome {
     summary: string | null;
     headline: string | null;
     needs_reply: boolean;
+    needs_reply_count: number | null;
+    /** How the agent chose to deliver this outcome: email, slack, or none. */
+    delivery_channel: string;
     output_data: JsonObject | null;
     message_count: number;
     input_tokens: number;
@@ -257,6 +270,7 @@ interface Task {
     enable_task_setup_tools?: boolean | null;
     enable_feedback?: boolean | null;
     enable_lessons?: boolean;
+    permission_mode?: PermissionMode | null;
 }
 type TriggerType = "schedule" | "webhook" | "email" | "app";
 interface Trigger {
@@ -455,6 +469,8 @@ interface Usage {
     cost_limit: string;
     period_end: string;
     subscription_status: string | null;
+    /** Authoritative eligibility for the model-subscription-funded Free path. */
+    free_path_available: boolean;
     overage_enabled: boolean;
     overage_used_cents: number;
     /** Ceiling on overage spend per period. Runs stop billing overage once reached. */
@@ -596,6 +612,8 @@ interface AgentUpdateParams {
     model?: string | null;
     effort?: string | null;
     default_permission_mode?: PermissionMode | null;
+    /** Who can see this agent. Omit or null leaves it unchanged. */
+    visibility?: "personal" | "organization" | null;
     allowed_senders?: string[] | null;
     enable_memory?: boolean | null;
     enable_history?: boolean | null;
@@ -1036,6 +1054,8 @@ interface ModelConnectionsResource {
     cancelAuthorization(provider: AuthorizableModelConnectionProvider, state: string): Promise<void>;
     /** Delete m8tes' encrypted copy of the provider credentials. */
     disconnect(provider: ModelConnectionProvider): Promise<ModelConnection>;
+    /** Clear the account model-plan default so platform mates use m8tes credits again. */
+    clearDefault(): Promise<boolean>;
 }
 declare function createModelConnectionsResource(http: Http): ModelConnectionsResource;
 
@@ -1384,13 +1404,18 @@ interface RunsResource {
      * If the run already did something visible (sent a message, changed data), the
      * API refuses with a 409 `retry_needs_confirmation`; pass `confirm: true` to
      * proceed. Check `run.retryable` first to avoid a guaranteed conflict.
+     * Provider auth, quota, own-subscription rate-limit, and availability failures
+     * follow the account's current connected/preferred provider. Other failures
+     * replay the original concrete model; `use_credits` pins m8tes credits.
      */
     retry(runId: number, params?: {
         confirm?: boolean;
+        use_credits?: boolean;
     }): Promise<Run>;
     /** Join a run already in flight. Throws `RunNotStreamingError` if it has finished. */
     stream(runId: number, options?: RunStreamOptions): RunStream;
-    /** Continue the conversation on an existing run, streaming the reply. */
+    /** Continue the same run, streaming only this follow-up. After a provider failure,
+     *  the reply follows the account's current connected/preferred provider. */
     reply(runId: number, message: string, options?: RunStreamOptions): RunStream;
     /** GET /runs/{id}. Pass `user_id` to scope to one end-user (required when the
      *  account has strict multi-tenant mode on). */
@@ -1507,6 +1532,8 @@ interface TaskCreateFields {
     enable_feedback?: boolean;
     /** Accumulate self-improvement lessons across this task's runs. Default true. */
     enable_lessons?: boolean;
+    /** How this task's runs ask for approval. Default: the agent's default. */
+    permission_mode?: PermissionMode;
 }
 /**
  * PATCH /tasks/{id} accepts exactly these fields (backend `DevTaskUpdate`).
@@ -1528,6 +1555,7 @@ interface TaskUpdateParams {
     enable_task_setup_tools?: boolean | null;
     enable_feedback?: boolean | null;
     enable_lessons?: boolean | null;
+    permission_mode?: PermissionMode | null;
 }
 interface TaskListParams {
     user_id?: string;
@@ -1698,7 +1726,7 @@ interface WebhooksResource {
  */
 
 /** Kept in lockstep with package.json "version" — guarded by test/version.test.ts. */
-declare const M8TES_SDK_VERSION = "0.1.0-alpha.3";
+declare const M8TES_SDK_VERSION = "0.1.0-alpha.5";
 declare class M8tes {
     readonly runs: RunsResource;
     readonly agents: AgentsResource;

package/dist/index.d.ts

@@ -171,6 +171,12 @@ interface Agent {
     enable_task_setup_tools?: boolean | null;
     enable_feedback?: boolean | null;
     enable_self_improvement?: boolean | null;
+    /** Most recent run activity in the last 90 days; null if idle longer. */
+    last_active_at?: string | null;
+    /** How many runs are executing or awaiting approval right now. */
+    active_run_count?: number;
+    /** Sole live run id when active_run_count is exactly 1; otherwise null. */
+    active_run_id?: number | null;
 }
 /** Permanent alias — the platform term is "agent", the DB model is `Teammate`. */
 type Teammate = Agent;
@@ -200,6 +206,10 @@ interface Run {
     /** Provider behind an OAuth subscription route: claude, openai, xai, or gemini. */
     auth_provider?: string | null;
     retryable?: boolean;
+    /** Whether this run performed any non-read-only action. Null when not computed. */
+    repeats_actions?: boolean | null;
+    /** Whether the offered recovery would repeat an action; latest turn only for chat. */
+    recovery_repeats_actions?: boolean | null;
     retry_of_run_id?: number | null;
     retry_count?: number;
     output_data?: JsonObject | null;
@@ -212,6 +222,9 @@ interface RunOutcome {
     summary: string | null;
     headline: string | null;
     needs_reply: boolean;
+    needs_reply_count: number | null;
+    /** How the agent chose to deliver this outcome: email, slack, or none. */
+    delivery_channel: string;
     output_data: JsonObject | null;
     message_count: number;
     input_tokens: number;
@@ -257,6 +270,7 @@ interface Task {
     enable_task_setup_tools?: boolean | null;
     enable_feedback?: boolean | null;
     enable_lessons?: boolean;
+    permission_mode?: PermissionMode | null;
 }
 type TriggerType = "schedule" | "webhook" | "email" | "app";
 interface Trigger {
@@ -455,6 +469,8 @@ interface Usage {
     cost_limit: string;
     period_end: string;
     subscription_status: string | null;
+    /** Authoritative eligibility for the model-subscription-funded Free path. */
+    free_path_available: boolean;
     overage_enabled: boolean;
     overage_used_cents: number;
     /** Ceiling on overage spend per period. Runs stop billing overage once reached. */
@@ -596,6 +612,8 @@ interface AgentUpdateParams {
     model?: string | null;
     effort?: string | null;
     default_permission_mode?: PermissionMode | null;
+    /** Who can see this agent. Omit or null leaves it unchanged. */
+    visibility?: "personal" | "organization" | null;
     allowed_senders?: string[] | null;
     enable_memory?: boolean | null;
     enable_history?: boolean | null;
@@ -1036,6 +1054,8 @@ interface ModelConnectionsResource {
     cancelAuthorization(provider: AuthorizableModelConnectionProvider, state: string): Promise<void>;
     /** Delete m8tes' encrypted copy of the provider credentials. */
     disconnect(provider: ModelConnectionProvider): Promise<ModelConnection>;
+    /** Clear the account model-plan default so platform mates use m8tes credits again. */
+    clearDefault(): Promise<boolean>;
 }
 declare function createModelConnectionsResource(http: Http): ModelConnectionsResource;
 
@@ -1384,13 +1404,18 @@ interface RunsResource {
      * If the run already did something visible (sent a message, changed data), the
      * API refuses with a 409 `retry_needs_confirmation`; pass `confirm: true` to
      * proceed. Check `run.retryable` first to avoid a guaranteed conflict.
+     * Provider auth, quota, own-subscription rate-limit, and availability failures
+     * follow the account's current connected/preferred provider. Other failures
+     * replay the original concrete model; `use_credits` pins m8tes credits.
      */
     retry(runId: number, params?: {
         confirm?: boolean;
+        use_credits?: boolean;
     }): Promise<Run>;
     /** Join a run already in flight. Throws `RunNotStreamingError` if it has finished. */
     stream(runId: number, options?: RunStreamOptions): RunStream;
-    /** Continue the conversation on an existing run, streaming the reply. */
+    /** Continue the same run, streaming only this follow-up. After a provider failure,
+     *  the reply follows the account's current connected/preferred provider. */
     reply(runId: number, message: string, options?: RunStreamOptions): RunStream;
     /** GET /runs/{id}. Pass `user_id` to scope to one end-user (required when the
      *  account has strict multi-tenant mode on). */
@@ -1507,6 +1532,8 @@ interface TaskCreateFields {
     enable_feedback?: boolean;
     /** Accumulate self-improvement lessons across this task's runs. Default true. */
     enable_lessons?: boolean;
+    /** How this task's runs ask for approval. Default: the agent's default. */
+    permission_mode?: PermissionMode;
 }
 /**
  * PATCH /tasks/{id} accepts exactly these fields (backend `DevTaskUpdate`).
@@ -1528,6 +1555,7 @@ interface TaskUpdateParams {
     enable_task_setup_tools?: boolean | null;
     enable_feedback?: boolean | null;
     enable_lessons?: boolean | null;
+    permission_mode?: PermissionMode | null;
 }
 interface TaskListParams {
     user_id?: string;
@@ -1698,7 +1726,7 @@ interface WebhooksResource {
  */
 
 /** Kept in lockstep with package.json "version" — guarded by test/version.test.ts. */
-declare const M8TES_SDK_VERSION = "0.1.0-alpha.3";
+declare const M8TES_SDK_VERSION = "0.1.0-alpha.5";
 declare class M8tes {
     readonly runs: RunsResource;
     readonly agents: AgentsResource;

package/dist/index.js

@@ -405,8 +405,12 @@ function createUsersResource(http) {
 // src/resources/billing.ts
 function createBillingResource(http) {
   return {
-    usage() {
-      return http.request("GET", "/usage/");
+    async usage() {
+      const usage = await http.request("GET", "/usage/");
+      return {
+        ...usage,
+        free_path_available: usage.free_path_available ?? false
+      };
     },
     usageTimeseries(params = {}) {
       const { agent_id, teammate_id, ...rest } = params;
@@ -421,8 +425,14 @@ function createBillingResource(http) {
     plans() {
       return http.request("GET", "/billing/plans");
     },
-    setOverage(params) {
-      return http.request("PATCH", "/billing/overage", { body: toBody({ ...params }) });
+    async setOverage(params) {
+      const usage = await http.request("PATCH", "/billing/overage", {
+        body: toBody({ ...params })
+      });
+      return {
+        ...usage,
+        free_path_available: usage.free_path_available ?? false
+      };
     },
     balance() {
       return http.request("GET", "/billing/balance");
@@ -510,6 +520,13 @@ function createModelConnectionsResource(http) {
     },
     disconnect(provider) {
       return http.request("DELETE", `/model-connections/${seg(provider)}`);
+    },
+    async clearDefault() {
+      const res = await http.request(
+        "DELETE",
+        "/model-connections/preferred-default"
+      );
+      return Boolean(res?.cleared);
     }
   };
 }
@@ -989,11 +1006,14 @@ function createRunsResource(http) {
     wait(runId, options = {}) {
       return waitForRun(pollDeps(options.user_id), runId, options);
     },
-    // `confirm` is a QUERY param and the route takes no body (verified against
-    // fastapi/app/routers/v2/runs.py::retry_run), so send neither.
+    // `confirm` / `use_credits` are QUERY params and the route takes no body
+    // (verified against fastapi/app/routers/v2/runs.py::retry_run).
     retry(runId, params = {}) {
       return http.request("POST", `/runs/${seg(runId)}/retry`, {
-        query: params.confirm ? toQuery({ confirm: true }) : ""
+        query: toQuery({
+          confirm: params.confirm ? true : void 0,
+          use_credits: params.use_credits ? true : void 0
+        })
       });
     },
     stream(runId, options) {
@@ -1228,7 +1248,7 @@ function createWebhooksResource(http) {
 }
 
 // src/index.ts
-var M8TES_SDK_VERSION = "0.1.0-alpha.3";
+var M8TES_SDK_VERSION = "0.1.0-alpha.5";
 var M8tes = class {
   runs;
   agents;