@crouter/api 0.3.395 → 0.3.397

package/dist/api/dto/run-events.d.ts

@@ -17,11 +17,13 @@ export type RunStatusDTO = 'running' | 'waiting_on_user' | 'idle' | 'settled';
  *  - `thinking`: a root turn is open and the model is reasoning, or its call is in flight before any output.
  *  - `tool`: the model is writing a tool call, or the tool is executing. `tool.summary` is the command's
  *    first line or the path the call acts on, null while the call is still streaming or when it has neither.
+ *  - `submitting_result`: the model is writing, or the runtime is recording, the run's `output_schema`
+ *    result (its `submit_result` call). Never reported as `tool`.
  *  - `writing`: the model is streaming answer text.
  *  - `between_turns`: no root turn is open, yet the run is still running — a child node is working,
  *    mail waits to start the next turn, or the runtime is about to remind the root of its `output_schema`. */
 export type RunActivityDTO = {
-    phase: 'starting' | 'thinking' | 'writing' | 'between_turns';
+    phase: 'starting' | 'thinking' | 'writing' | 'submitting_result' | 'between_turns';
 } | {
     phase: 'tool';
     tool: {

package/dist/api/index.d.ts

@@ -5,7 +5,8 @@ export type { ErrorBody } from './errors.js';
 export { errorCodes } from './error-codes.js';
 export type { ErrorCode, ErrorEnvelope, ErrorOrigin, ErrorType } from './error-codes.js';
 export { API_VERSION, routes } from './routes.js';
-export { RUNTIME_VERSION_HEADER, compareReleaseVersions } from './runtime-version.js';
+export { RUNTIME_VERSION_HEADER, MINIMUM_RUNTIME_VERSION_HEADER, compareReleaseVersions, minimumRuntimeRefusal } from './runtime-version.js';
+export type { MinimumRuntimeRefusal } from './runtime-version.js';
 export * from '../shared/generated-context.js';
 export * from './dto/common.js';
 export * from './dto/health.js';

package/dist/api/index.js

@@ -5,7 +5,7 @@ export { CrtrClient, waitForDaemonAvailability } from './client.js';
 export { APIError, ApiError, isErrorBody } from './errors.js';
 export { errorCodes } from './error-codes.js';
 export { API_VERSION, routes } from './routes.js';
-export { RUNTIME_VERSION_HEADER, compareReleaseVersions } from './runtime-version.js';
+export { RUNTIME_VERSION_HEADER, MINIMUM_RUNTIME_VERSION_HEADER, compareReleaseVersions, minimumRuntimeRefusal } from './runtime-version.js';
 export * from '../shared/generated-context.js';
 export * from './dto/common.js';
 export * from './dto/health.js';

package/dist/api/runtime-version.d.ts

@@ -4,3 +4,28 @@ export declare const RUNTIME_VERSION_HEADER = "Crouter-Runtime-Version";
  *  suffix is ignored). Negative when `a` is older, zero when equal, positive when
  *  newer. A version that does not parse sorts below every version that does. */
 export declare function compareReleaseVersions(a: string, b: string): number;
+/** Request header naming the oldest runtime release the caller accepts, e.g. `0.3.396`. The SDK sends its own
+ *  version on every request except `/healthz`. Optional: absent means no check. The router in front of a hosted
+ *  runtime and the runtime itself each refuse a request that names a newer release than the runtime's, before any
+ *  handler runs (so nothing is accepted and no idempotency key is recorded). */
+export declare const MINIMUM_RUNTIME_VERSION_HEADER = "Crouter-Minimum-Runtime-Version";
+/** The refusal a runtime answers instead of handling a request, or `null` when the request may be handled.
+ *  - `required` absent: handled.
+ *  - `required` not `major.minor.patch` (optional `v`, optional suffix): 400 `invalid_request`.
+ *  - `runtimeVersion` older than `required`, or not a release version: 426 `runtime_version_unsupported`
+ *    (details `{sdk_version, runtime_version}`, the SDK's `RuntimeVersionDetails`). */
+export type MinimumRuntimeRefusal = {
+    status: 400;
+    code: 'invalid_request';
+    message: string;
+    param: string;
+} | {
+    status: 426;
+    code: 'runtime_version_unsupported';
+    message: string;
+    details: {
+        sdk_version: string;
+        runtime_version: string | null;
+    };
+};
+export declare function minimumRuntimeRefusal(required: string | undefined, runtimeVersion: string | null): MinimumRuntimeRefusal | null;

package/dist/api/runtime-version.js

@@ -26,3 +26,25 @@ function parseRelease(version) {
     const match = /^v?(\d+)\.(\d+)\.(\d+)(?:[-+].*)?$/.exec(version.trim());
     return match === null ? null : [Number(match[1]), Number(match[2]), Number(match[3])];
 }
+/** Request header naming the oldest runtime release the caller accepts, e.g. `0.3.396`. The SDK sends its own
+ *  version on every request except `/healthz`. Optional: absent means no check. The router in front of a hosted
+ *  runtime and the runtime itself each refuse a request that names a newer release than the runtime's, before any
+ *  handler runs (so nothing is accepted and no idempotency key is recorded). */
+export const MINIMUM_RUNTIME_VERSION_HEADER = 'Crouter-Minimum-Runtime-Version';
+export function minimumRuntimeRefusal(required, runtimeVersion) {
+    if (required === undefined)
+        return null;
+    if (parseRelease(required) === null) {
+        return { status: 400, code: 'invalid_request', param: MINIMUM_RUNTIME_VERSION_HEADER, message: `${MINIMUM_RUNTIME_VERSION_HEADER} must be a release version like 0.3.396.` };
+    }
+    if (runtimeVersion !== null && parseRelease(runtimeVersion) !== null && compareReleaseVersions(runtimeVersion, required) >= 0)
+        return null;
+    const sdkVersion = required.trim();
+    return {
+        status: 426, code: 'runtime_version_unsupported',
+        message: runtimeVersion === null
+            ? `The runtime did not name its version; the caller requires a runtime at ${sdkVersion} or later. Roll the runtime forward.`
+            : `The runtime is ${runtimeVersion}; the caller requires a runtime at ${sdkVersion} or later. Roll the runtime forward.`,
+        details: { sdk_version: sdkVersion, runtime_version: runtimeVersion },
+    };
+}

package/dist/shared/generated-context.d.ts

@@ -15,6 +15,10 @@ export declare const PARK_SUMMARY_PROMPT: string;
 /** Static recovery prompts shared by the broker producer and display classifier. */
 export declare const AUTH_FAULT_RECOVERY_BODY = "Provider credentials were just updated (a new login landed). Your previous turn stopped on a provider authentication failure. Continue from where you left off and retry the work that failed.";
 export declare const CONNECTION_FAULT_RECOVERY_BODY = "The network connection is back online. Your previous turn stopped on a connection error (the network was down). Continue from where you left off and retry the work that failed.";
+/** A run node's connection retry. Its broker never probes the network (its
+ *  model calls go through the daemon), so it cannot claim the network is back;
+ *  the attempt itself is the probe. */
+export declare const RUN_CONNECTION_FAULT_RETRY_BODY = "Your previous turn stopped on a connection error reaching the model provider. Retrying now: continue from where you left off and retry the work that failed.";
 export declare const PROVIDER_FAULT_RECOVERY_BODY = "Your previous turn stopped on a provider fault. Continue from where you left off and retry the work that failed.";
 export type ModelFallbackRecoveryReason = 'credential' | 'not-found';
 /** Format the stop guard's dynamic structured-output mandate. */

package/dist/shared/generated-context.js

@@ -24,6 +24,10 @@ export const PARK_SUMMARY_PROMPT = 'This conversation has been idle with nothing
 /** Static recovery prompts shared by the broker producer and display classifier. */
 export const AUTH_FAULT_RECOVERY_BODY = 'Provider credentials were just updated (a new login landed). Your previous turn stopped on a provider authentication failure. Continue from where you left off and retry the work that failed.';
 export const CONNECTION_FAULT_RECOVERY_BODY = 'The network connection is back online. Your previous turn stopped on a connection error (the network was down). Continue from where you left off and retry the work that failed.';
+/** A run node's connection retry. Its broker never probes the network (its
+ *  model calls go through the daemon), so it cannot claim the network is back;
+ *  the attempt itself is the probe. */
+export const RUN_CONNECTION_FAULT_RETRY_BODY = 'Your previous turn stopped on a connection error reaching the model provider. Retrying now: continue from where you left off and retry the work that failed.';
 export const PROVIDER_FAULT_RECOVERY_BODY = 'Your previous turn stopped on a provider fault. Continue from where you left off and retry the work that failed.';
 const REVIEW_APPROVAL_OPEN = '<crtr-review-approval>';
 const REVIEW_APPROVAL_CLOSE = '</crtr-review-approval>';
@@ -32,8 +36,7 @@ const MODEL_FALLBACK_RECOVERY_CLOSE = '</model-fallback-recovery>';
 const STRUCTURED_OUTPUT_REPROMPT_SUFFIX = '\n```';
 /** Format the stop guard's dynamic structured-output mandate. */
 export function formatStructuredOutputReprompt(schema, requestId) {
-    const submit = `crtr push result --request ${requestId}`;
-    return `You must submit a result matching the required schema with \`${submit}\` before you can stop, or decline it with \`${submit} --decline "<reason>" --code <token>\` when the schema cannot be honestly satisfied. You cannot finish or go dormant any other way while this request is pending.\n\nRequired schema:\n\n\`\`\`json\n${schema}${STRUCTURED_OUTPUT_REPROMPT_SUFFIX}`;
+    return `You must submit a result matching the required schema before you can stop: call the \`submit_result\` tool with \`request_id: "${requestId}"\` and the JSON in \`result\`, or with \`decline: { reason, code }\` when the schema cannot be honestly satisfied. You cannot finish or go dormant any other way while this request is pending.\n\nRequired schema:\n\n\`\`\`json\n${schema}${STRUCTURED_OUTPUT_REPROMPT_SUFFIX}`;
 }
 /** Keep model-fallback guidance editable without making it a reader contract. */
 export function formatModelFallbackRecovery(previousModel, nextModel, reason) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crouter/api",
-  "version": "0.3.395",
+  "version": "0.3.397",
   "description": "Typed crtrd /v1 API contract — DTOs, route builders, the error contract, the CrtrClient, and the command-plugin manifest format. Zero runtime dependencies.",
   "type": "module",
   "main": "./dist/api/index.js",