@m8tes/sdk 0.1.0-alpha.6 → 0.1.0-alpha.7

package/dist/index.d.cts

@@ -1364,6 +1364,44 @@ declare class RunStream implements AsyncIterable<M8tesStreamEvent> {
  * request. Mirrors `sdk/py/m8tes/_resources/runs.py`, field for field.
  */
 
+/**
+ * Per-reply overrides accepted by `POST /runs/{id}/reply`.
+ *
+ * These mirror the server's `RunReply` model. Every field is optional; omit one
+ * to inherit whatever the run last ran with. (The Python SDK also takes `files`;
+ * TypeScript has no attachment path on reply yet.)
+ *
+ * SETTING ANY OF THESE CHANGES HOW A MID-TURN REPLY BEHAVES. A reply to a run
+ * whose current turn is still executing is normally QUEUED and delivered as the
+ * next turn. The server refuses to queue overrides — it cannot apply them to a
+ * turn already running under the run's persisted settings — so a reply carrying
+ * any field below fails with 409 instead. Send the message bare, or retry once
+ * the turn ends.
+ */
+interface RunReplyOptions extends RunStreamOptions {
+    /**
+     * Override this reply's app toolset (names from `client.apps.list()`).
+     * A changed set persists to the run, so later replies inherit it.
+     * `[]` means "inherit the run's current set", NOT "no tools".
+     */
+    tools?: string[];
+    /** Execution-mode override for this and later replies. Omit to inherit the run's mode. */
+    permission_mode?: PermissionMode;
+    /** Override whether the internal same-scope management tools are enabled for this reply. */
+    task_setup_tools?: boolean;
+    /** Override whether the internal issue-reporting feedback tool is enabled for this reply. */
+    feedback?: boolean;
+    /**
+     * Override whether the agent may ask questions (AskUserQuestion) during this reply.
+     * Pass `false` to pin non-interactive behavior, so an unattended reply loop on a
+     * run created with `human_in_the_loop: true` cannot pause on a question.
+     *
+     * Note the 409 above: `false` is still an override, so a loop that sets it on
+     * every reply will fail whenever it catches the run mid-turn. Set it on the
+     * replies that start a turn, not blindly on all of them.
+     */
+    human_in_the_loop?: boolean;
+}
 interface RunCreateParams {
     /** What the agent should do. */
     message: string;
@@ -1520,7 +1558,7 @@ interface RunsResource {
     stream(runId: number, options?: RunStreamOptions): RunStream;
     /** 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;
+    reply(runId: number, message: string, options?: RunReplyOptions): RunStream;
     /** GET /runs/{id}. Pass `user_id` to scope to one end-user (required when the
      *  account has strict multi-tenant mode on). */
     get(runId: number, params?: {
@@ -1846,7 +1884,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.6";
+declare const M8TES_SDK_VERSION = "0.1.0-alpha.7";
 declare class M8tes {
     readonly runs: RunsResource;
     readonly agents: AgentsResource;
@@ -1868,4 +1906,4 @@ declare class M8tes {
     constructor(options?: ClientOptions);
 }
 
-export { type AccountDeletion, type AccountExport, type AccountResource, type AccountSettings, type AccountSettingsUpdateParams, type Agent, type AgentCreateParams, type AgentListParams, type AgentUpdateParams, type AgentsResource, type AlertThresholdParams, type App, type AppConnectionInitiation, type AppConnectionResult, type AppsResource, type AuthorizableModelConnectionProvider, type AutoReloadParams, type Balance, type BillingPlansParams, type BillingPortalParams, type BillingResource, type ClientOptions, type CodeModelConnectionProvider, ConversationState, DEFAULT_BASE_URL, type DeviceModelConnectionProvider, type EmailInbox, type EndUser, type EndUserCreateParams, type EndUserUpdateParams, type EndUserUsage, type FetchLike, type Http, type JsonObject, type ListResponse, M8TES_SDK_VERSION, M8tes, M8tesStreamEvent, type MemoriesResource, type Memory, type MemoryCreateParams, type MemoryListParams, type MemoryUpdateParams, type Model, type ModelAuthorization, type ModelConnection, type ModelConnectionProvider, type ModelConnectionsResource, type ModelPricing, type ModelsResource, Normalizer, type OverageParams, Page, type PageParams, type PermissionCreateParams, type PermissionDeleteParams, type PermissionListParams, type PermissionMode, type PermissionPolicy, type PermissionRequest, type PermissionsResource, type Plan, type PollOptions, type Receipt, type Run, type RunCreateParams, type RunFile, type RunListParams, type RunOutcome, RunPausedError, RunStream, type RunStreamOptions, RunTimeoutError, type RunUsage, RunWaitAbortedError, type RunsResource, type SettingsResource, type SubscriptionBillingPeriod, type SubscriptionCheckout, type SubscriptionCheckoutParams, type SubscriptionPlanId, TERMINAL_STATUSES, type Task, type TaskCreateParams, type TaskListParams, type TaskRunParams, type TaskUpdateParams, type TasksResource, type Teammate, type TokenTransaction, type TopupParams, type Trigger, type TriggerCreateParams, type TriggerType, type TriggersResource, type Usage, type UsageBucket, type UsageModelSlice, type UsageTimeseries, type UsageTimeseriesParams, type UsageTotals, type UsersResource, type VerifySignatureOptions, type WaitOptions, type Webhook, type WebhookDelivery, type WebhookToggle, type WebhooksResource, createAccountResource, createBillingResource, createHttp, createMemoriesResource, createModelConnectionsResource, createModelsResource, createPermissionsResource, isPlanApproval, planText, pollRun, verifySignature, waitForRun };
+export { type AccountDeletion, type AccountExport, type AccountResource, type AccountSettings, type AccountSettingsUpdateParams, type Agent, type AgentCreateParams, type AgentListParams, type AgentUpdateParams, type AgentsResource, type AlertThresholdParams, type App, type AppConnectionInitiation, type AppConnectionResult, type AppsResource, type AuthorizableModelConnectionProvider, type AutoReloadParams, type Balance, type BillingPlansParams, type BillingPortalParams, type BillingResource, type ClientOptions, type CodeModelConnectionProvider, ConversationState, DEFAULT_BASE_URL, type DeviceModelConnectionProvider, type EmailInbox, type EndUser, type EndUserCreateParams, type EndUserUpdateParams, type EndUserUsage, type FetchLike, type Http, type JsonObject, type ListResponse, M8TES_SDK_VERSION, M8tes, M8tesStreamEvent, type MemoriesResource, type Memory, type MemoryCreateParams, type MemoryListParams, type MemoryUpdateParams, type Model, type ModelAuthorization, type ModelConnection, type ModelConnectionProvider, type ModelConnectionsResource, type ModelPricing, type ModelsResource, Normalizer, type OverageParams, Page, type PageParams, type PermissionCreateParams, type PermissionDeleteParams, type PermissionListParams, type PermissionMode, type PermissionPolicy, type PermissionRequest, type PermissionsResource, type Plan, type PollOptions, type Receipt, type Run, type RunCreateParams, type RunFile, type RunListParams, type RunOutcome, RunPausedError, type RunReplyOptions, RunStream, type RunStreamOptions, RunTimeoutError, type RunUsage, RunWaitAbortedError, type RunsResource, type SettingsResource, type SubscriptionBillingPeriod, type SubscriptionCheckout, type SubscriptionCheckoutParams, type SubscriptionPlanId, TERMINAL_STATUSES, type Task, type TaskCreateParams, type TaskListParams, type TaskRunParams, type TaskUpdateParams, type TasksResource, type Teammate, type TokenTransaction, type TopupParams, type Trigger, type TriggerCreateParams, type TriggerType, type TriggersResource, type Usage, type UsageBucket, type UsageModelSlice, type UsageTimeseries, type UsageTimeseriesParams, type UsageTotals, type UsersResource, type VerifySignatureOptions, type WaitOptions, type Webhook, type WebhookDelivery, type WebhookToggle, type WebhooksResource, createAccountResource, createBillingResource, createHttp, createMemoriesResource, createModelConnectionsResource, createModelsResource, createPermissionsResource, isPlanApproval, planText, pollRun, verifySignature, waitForRun };

package/dist/index.d.ts

@@ -1364,6 +1364,44 @@ declare class RunStream implements AsyncIterable<M8tesStreamEvent> {
  * request. Mirrors `sdk/py/m8tes/_resources/runs.py`, field for field.
  */
 
+/**
+ * Per-reply overrides accepted by `POST /runs/{id}/reply`.
+ *
+ * These mirror the server's `RunReply` model. Every field is optional; omit one
+ * to inherit whatever the run last ran with. (The Python SDK also takes `files`;
+ * TypeScript has no attachment path on reply yet.)
+ *
+ * SETTING ANY OF THESE CHANGES HOW A MID-TURN REPLY BEHAVES. A reply to a run
+ * whose current turn is still executing is normally QUEUED and delivered as the
+ * next turn. The server refuses to queue overrides — it cannot apply them to a
+ * turn already running under the run's persisted settings — so a reply carrying
+ * any field below fails with 409 instead. Send the message bare, or retry once
+ * the turn ends.
+ */
+interface RunReplyOptions extends RunStreamOptions {
+    /**
+     * Override this reply's app toolset (names from `client.apps.list()`).
+     * A changed set persists to the run, so later replies inherit it.
+     * `[]` means "inherit the run's current set", NOT "no tools".
+     */
+    tools?: string[];
+    /** Execution-mode override for this and later replies. Omit to inherit the run's mode. */
+    permission_mode?: PermissionMode;
+    /** Override whether the internal same-scope management tools are enabled for this reply. */
+    task_setup_tools?: boolean;
+    /** Override whether the internal issue-reporting feedback tool is enabled for this reply. */
+    feedback?: boolean;
+    /**
+     * Override whether the agent may ask questions (AskUserQuestion) during this reply.
+     * Pass `false` to pin non-interactive behavior, so an unattended reply loop on a
+     * run created with `human_in_the_loop: true` cannot pause on a question.
+     *
+     * Note the 409 above: `false` is still an override, so a loop that sets it on
+     * every reply will fail whenever it catches the run mid-turn. Set it on the
+     * replies that start a turn, not blindly on all of them.
+     */
+    human_in_the_loop?: boolean;
+}
 interface RunCreateParams {
     /** What the agent should do. */
     message: string;
@@ -1520,7 +1558,7 @@ interface RunsResource {
     stream(runId: number, options?: RunStreamOptions): RunStream;
     /** 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;
+    reply(runId: number, message: string, options?: RunReplyOptions): RunStream;
     /** GET /runs/{id}. Pass `user_id` to scope to one end-user (required when the
      *  account has strict multi-tenant mode on). */
     get(runId: number, params?: {
@@ -1846,7 +1884,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.6";
+declare const M8TES_SDK_VERSION = "0.1.0-alpha.7";
 declare class M8tes {
     readonly runs: RunsResource;
     readonly agents: AgentsResource;
@@ -1868,4 +1906,4 @@ declare class M8tes {
     constructor(options?: ClientOptions);
 }
 
-export { type AccountDeletion, type AccountExport, type AccountResource, type AccountSettings, type AccountSettingsUpdateParams, type Agent, type AgentCreateParams, type AgentListParams, type AgentUpdateParams, type AgentsResource, type AlertThresholdParams, type App, type AppConnectionInitiation, type AppConnectionResult, type AppsResource, type AuthorizableModelConnectionProvider, type AutoReloadParams, type Balance, type BillingPlansParams, type BillingPortalParams, type BillingResource, type ClientOptions, type CodeModelConnectionProvider, ConversationState, DEFAULT_BASE_URL, type DeviceModelConnectionProvider, type EmailInbox, type EndUser, type EndUserCreateParams, type EndUserUpdateParams, type EndUserUsage, type FetchLike, type Http, type JsonObject, type ListResponse, M8TES_SDK_VERSION, M8tes, M8tesStreamEvent, type MemoriesResource, type Memory, type MemoryCreateParams, type MemoryListParams, type MemoryUpdateParams, type Model, type ModelAuthorization, type ModelConnection, type ModelConnectionProvider, type ModelConnectionsResource, type ModelPricing, type ModelsResource, Normalizer, type OverageParams, Page, type PageParams, type PermissionCreateParams, type PermissionDeleteParams, type PermissionListParams, type PermissionMode, type PermissionPolicy, type PermissionRequest, type PermissionsResource, type Plan, type PollOptions, type Receipt, type Run, type RunCreateParams, type RunFile, type RunListParams, type RunOutcome, RunPausedError, RunStream, type RunStreamOptions, RunTimeoutError, type RunUsage, RunWaitAbortedError, type RunsResource, type SettingsResource, type SubscriptionBillingPeriod, type SubscriptionCheckout, type SubscriptionCheckoutParams, type SubscriptionPlanId, TERMINAL_STATUSES, type Task, type TaskCreateParams, type TaskListParams, type TaskRunParams, type TaskUpdateParams, type TasksResource, type Teammate, type TokenTransaction, type TopupParams, type Trigger, type TriggerCreateParams, type TriggerType, type TriggersResource, type Usage, type UsageBucket, type UsageModelSlice, type UsageTimeseries, type UsageTimeseriesParams, type UsageTotals, type UsersResource, type VerifySignatureOptions, type WaitOptions, type Webhook, type WebhookDelivery, type WebhookToggle, type WebhooksResource, createAccountResource, createBillingResource, createHttp, createMemoriesResource, createModelConnectionsResource, createModelsResource, createPermissionsResource, isPlanApproval, planText, pollRun, verifySignature, waitForRun };
+export { type AccountDeletion, type AccountExport, type AccountResource, type AccountSettings, type AccountSettingsUpdateParams, type Agent, type AgentCreateParams, type AgentListParams, type AgentUpdateParams, type AgentsResource, type AlertThresholdParams, type App, type AppConnectionInitiation, type AppConnectionResult, type AppsResource, type AuthorizableModelConnectionProvider, type AutoReloadParams, type Balance, type BillingPlansParams, type BillingPortalParams, type BillingResource, type ClientOptions, type CodeModelConnectionProvider, ConversationState, DEFAULT_BASE_URL, type DeviceModelConnectionProvider, type EmailInbox, type EndUser, type EndUserCreateParams, type EndUserUpdateParams, type EndUserUsage, type FetchLike, type Http, type JsonObject, type ListResponse, M8TES_SDK_VERSION, M8tes, M8tesStreamEvent, type MemoriesResource, type Memory, type MemoryCreateParams, type MemoryListParams, type MemoryUpdateParams, type Model, type ModelAuthorization, type ModelConnection, type ModelConnectionProvider, type ModelConnectionsResource, type ModelPricing, type ModelsResource, Normalizer, type OverageParams, Page, type PageParams, type PermissionCreateParams, type PermissionDeleteParams, type PermissionListParams, type PermissionMode, type PermissionPolicy, type PermissionRequest, type PermissionsResource, type Plan, type PollOptions, type Receipt, type Run, type RunCreateParams, type RunFile, type RunListParams, type RunOutcome, RunPausedError, type RunReplyOptions, RunStream, type RunStreamOptions, RunTimeoutError, type RunUsage, RunWaitAbortedError, type RunsResource, type SettingsResource, type SubscriptionBillingPeriod, type SubscriptionCheckout, type SubscriptionCheckoutParams, type SubscriptionPlanId, TERMINAL_STATUSES, type Task, type TaskCreateParams, type TaskListParams, type TaskRunParams, type TaskUpdateParams, type TasksResource, type Teammate, type TokenTransaction, type TopupParams, type Trigger, type TriggerCreateParams, type TriggerType, type TriggersResource, type Usage, type UsageBucket, type UsageModelSlice, type UsageTimeseries, type UsageTimeseriesParams, type UsageTotals, type UsersResource, type VerifySignatureOptions, type WaitOptions, type Webhook, type WebhookDelivery, type WebhookToggle, type WebhooksResource, createAccountResource, createBillingResource, createHttp, createMemoriesResource, createModelConnectionsResource, createModelsResource, createPermissionsResource, isPlanApproval, planText, pollRun, verifySignature, waitForRun };

package/dist/index.js

@@ -1,5 +1,5 @@
-import { createNormalizer, createSseDecoder, initialConversationState, accumulate, RunFailedError, APIError, parseRetryAfter, ConflictError, NotFoundError, AuthenticationError, PermissionDeniedError, ValidationError, seg, parseErrorEnvelope, errorClassForStatus } from './chunk-F6B6R3SP.js';
-export { APIError, AuthenticationError, BillingError, ConflictError, M8tesApiError, NotFoundError, PROTOCOL_VERSION, PermissionDeniedError, RateLimitError, RunFailedError, RunNotStreamingError, TERMINAL_EVENT_TYPES, ValidationError, accumulate, createAccumulator, createNormalizer, createSseDecoder, errorClassForStatus, errorFromResponse, initialConversationState, isTerminalEvent, parseErrorEnvelope, parseRetryAfter, parseSse, seg, splitConcatenatedJson } from './chunk-F6B6R3SP.js';
+import { createNormalizer, createSseDecoder, initialConversationState, accumulate, RunFailedError, APIError, parseRetryAfter, ConflictError, NotFoundError, AuthenticationError, PermissionDeniedError, ValidationError, seg, parseErrorEnvelope, errorClassForStatus } from './chunk-5X7I2XPE.js';
+export { APIError, AuthenticationError, BillingError, ConflictError, M8tesApiError, NotFoundError, PROTOCOL_VERSION, PermissionDeniedError, RateLimitError, RunFailedError, RunNotStreamingError, TERMINAL_EVENT_TYPES, ValidationError, accumulate, createAccumulator, createNormalizer, createSseDecoder, errorClassForStatus, errorFromResponse, initialConversationState, isTerminalEvent, parseErrorEnvelope, parseRetryAfter, parseSse, seg, splitConcatenatedJson } from './chunk-5X7I2XPE.js';
 import { createHmac, timingSafeEqual } from 'crypto';
 
 // src/http.ts
@@ -157,7 +157,9 @@ function createHttp(options = {}) {
       return send(method, path, opts);
     },
     async *stream(method, path, opts = {}) {
-      const res = await send(method, path, opts, { conflictIsNotStreaming: true });
+      const res = await send(method, path, opts, {
+        conflictIsNotStreaming: method === "GET"
+      });
       if (opts.onReplay && res.headers.get(REPLAY_HEADER)) {
         const run = await res.json();
         yield* opts.onReplay(run);
@@ -949,6 +951,10 @@ function withRunId(err, runId) {
   }
   return err;
 }
+function replyBody(message, options) {
+  const { raiseOnError: _raiseOnError, idempotencyKey: _idempotencyKey, ...overrides } = options ?? {};
+  return toBody({ ...overrides, message, stream: true });
+}
 function items(payload) {
   return Array.isArray(payload) ? payload : payload?.data ?? [];
 }
@@ -1052,7 +1058,7 @@ function createRunsResource(http) {
     reply(runId, message, options) {
       return new RunStream(
         http.stream("POST", `/runs/${seg(runId)}/reply`, {
-          body: { message },
+          body: replyBody(message, options),
           headers: idempotencyHeaders(options?.idempotencyKey),
           onReplay: replayJoin(http)
         }),
@@ -1291,7 +1297,7 @@ function createWebhooksResource(http) {
 }
 
 // src/index.ts
-var M8TES_SDK_VERSION = "0.1.0-alpha.6";
+var M8TES_SDK_VERSION = "0.1.0-alpha.7";
 var M8tes = class {
   runs;
   agents;