@north-light/sdk 0.3.481 → 0.3.483

package/dist/index.d.ts

@@ -35,6 +35,7 @@ export type { ActivityStep, DescribeTool } from './resources/activity.js';
 export { APIError, APIConnectionError, APIConnectionTimeoutError, APIUserAbortError, AuthenticationError, BadRequestError, ConflictError, CrouterError, DeadlineExceededError, InternalServerError, NotFoundError, PermissionDeniedError, RateLimitError, RuntimeVersionError, UnprocessableEntityError, mapError, } from './errors.js';
 export type { DeadlineDetails, RuntimeVersionDetails } from './errors.js';
 export { SDK_VERSION } from './version.js';
+export { setupLink } from './setup-link.js';
 export { sdkErrorCodes } from './error-codes.js';
 export type { SdkErrorCode } from './error-codes.js';
 export type { AuthStatus, AuthStatusParams, CancelParams, EnsureProfileParams, JsonSchema, MessageParams, NodeCreateParams, NodeEventsOptions, NodeOutcomeOptions, OutputSchema, ParsedOutcome, RequestOptions, SchemaOutput, } from './types.js';

package/dist/index.js

@@ -14,4 +14,5 @@ export { RUN_NOTICE_SCOPE, RunNoticeError, verifyRunNotice } from './resources/r
 export { describeToolDefault, followActivity } from './resources/activity.js';
 export { APIError, APIConnectionError, APIConnectionTimeoutError, APIUserAbortError, AuthenticationError, BadRequestError, ConflictError, CrouterError, DeadlineExceededError, InternalServerError, NotFoundError, PermissionDeniedError, RateLimitError, RuntimeVersionError, UnprocessableEntityError, mapError, } from './errors.js';
 export { SDK_VERSION } from './version.js';
+export { setupLink } from './setup-link.js';
 export { sdkErrorCodes } from './error-codes.js';

package/dist/resources/runs.d.ts

@@ -13,6 +13,8 @@ export interface RunStartParams {
     profile?: string;
     /** The model the run's root agent runs on: a bare strength (`medium`, resolved against the default provider), `family/strength` (`anthropic/medium`), or a concrete registered model id. Absent uses the run kind's default. Applies to the root only; its child nodes choose their own. An unknown or unregistered value is refused (`invalid_request`, `param: model`). */
     model?: string;
+    /** Wall-clock limit on the run, measured from start: one or more `<int>[smhd]` parts (`10m`, `1h30m`), at most `24h`. When it passes the run settles with outcome `deadline_exceeded` (`runs.get`'s `outcome.reason`) and its agent is stopped. Absent sets no limit. A malformed, zero or over-24h value is refused (`invalid_request`, `param: deadline`). */
+    deadline?: string;
     /** A JSON Schema, or an object with `toJSONSchema()` (a Zod v4 object), the run's result must satisfy.
      *  Sent as a JSON object; the daemon refuses one that is not an object or is over 256 KB serialized
      *  (`invalid_request`, `param: output_schema`), which is raised without a resend. The SDK does not

package/dist/setup-link.d.ts

@@ -0,0 +1,7 @@
+import type { ProviderDependency } from '@north-light/api';
+/** The link that sends the person to a dependency's setup page and back: `dependency.next` with `return_to` set to
+ *  `returnTo` (an `https` URL on your app's registered redirect origin), percent-encoded. Any query `next` already
+ *  carries, such as `client_id`, is kept. Throws when `next` is not an absolute URL or `returnTo` is empty. */
+export declare function setupLink(dependency: Pick<ProviderDependency, 'next'>, options: {
+    returnTo: string;
+}): string;

package/dist/setup-link.js

@@ -0,0 +1,10 @@
+/** The link that sends the person to a dependency's setup page and back: `dependency.next` with `return_to` set to
+ *  `returnTo` (an `https` URL on your app's registered redirect origin), percent-encoded. Any query `next` already
+ *  carries, such as `client_id`, is kept. Throws when `next` is not an absolute URL or `returnTo` is empty. */
+export function setupLink(dependency, options) {
+    if (!options.returnTo)
+        throw new TypeError('setupLink: returnTo is required');
+    const url = new URL(dependency.next);
+    url.searchParams.set('return_to', options.returnTo);
+    return url.href;
+}

package/dist/skill/northlight/SKILL.md

@@ -2,7 +2,7 @@
 name: northlight
 description: "Use when building, debugging or shipping an app that signs people in with Northlight, starts runs on their Northlight runtime, or calls Northlight providers (sms, search, integrations, context, device) with @north-light/sdk."
 metadata:
-  sdk-version: "0.3.481"
+  sdk-version: "0.3.483"
 ---
 
 # Building a Northlight app
@@ -11,7 +11,7 @@ An app on Northlight signs people in with their Northlight account, then starts
 
 ## First: check this skill matches the SDK
 
-This skill is for SDK version `0.3.481`. If the project has `node_modules/@north-light/sdk/package.json`, compare its `version` with that number. If they differ, run `npx @north-light/sdk skill` in the project, then read the rewritten `.agents/skills/northlight/SKILL.md` (or `.claude/skills/northlight/SKILL.md`) instead of this copy. That command needs no account and no crtr. A project that has no SDK yet starts with `npx @north-light/sdk@latest init <dir>`.
+This skill is for SDK version `0.3.483`. If the project has `node_modules/@north-light/sdk/package.json`, compare its `version` with that number. If they differ, run `npx @north-light/sdk skill` in the project, then read the rewritten `.agents/skills/northlight/SKILL.md` (or `.claude/skills/northlight/SKILL.md`) instead of this copy. That command needs no account and no crtr. A project that has no SDK yet starts with `npx @north-light/sdk@latest init <dir>`.
 
 ## Where things run
 

package/dist/testing/cloud.js

@@ -245,6 +245,7 @@ export class FakeCloud {
                     const dependency = {
                         state: setupState, ...(options.message === undefined ? {} : { message: options.message }),
                         next: options.next ?? `${cloud.issuer}/connect/setup/${provider}?client_id=${cloud.clientId}`,
+                        ...(options.step === undefined ? {} : { step: options.step }),
                     };
                     state.dependencies = { ...state.dependencies, [provider]: dependency };
                     state.wakeHolds();
@@ -827,17 +828,29 @@ export class FakeCloud {
         for (const field of ['mode', 'parent', 'fork_from', 'node_id', 'env', 'tools', 'system_prompt'])
             if (params[field] !== undefined)
                 throw refuse(403, 'owner_only', `${field} is owner-only`, { param: field });
-        for (const field of ['payer', 'model_policy', 'deadline', 'kind'])
+        for (const field of ['payer', 'model_policy', 'kind'])
             if (params[field] !== undefined)
                 throw invalid(`${field} is not available`, field);
         for (const field of Object.keys(params))
-            if (!['prompt', 'scopes', 'metadata', 'profile', 'isolated', 'cwd', 'worktree', 'output_schema', 'message', 'model'].includes(field))
+            if (!['prompt', 'scopes', 'metadata', 'profile', 'isolated', 'cwd', 'worktree', 'output_schema', 'message', 'model', 'deadline'].includes(field))
                 throw invalid(`unknown field ${field}`, field);
         if (params['model'] !== undefined && (typeof params['model'] !== 'string' || !params['model'].trim()))
             throw invalid('model must be a non-empty string', 'model');
         // The fake has no model registry, so it checks only the shape the real server also refuses: a strength, a family/strength, or a provider/model id.
         if (typeof params['model'] === 'string' && !/^(ultra|strong|medium|light|normal|weak|opus|sonnet|haiku|[^/\s]+\/[^\s]+)$/.test(params['model']))
             throw invalid(`model '${params['model']}' is not a strength, a family/strength, or a provider/model id`, 'model');
+        // Same grammar and 24h ceiling as the daemon: `<int>[smhd]` parts, summed, greater than zero.
+        if (params['deadline'] !== undefined) {
+            const deadline = params['deadline'];
+            const ms = typeof deadline === 'string' && /^\+?(?:\d+[smhd])+$/.test(deadline)
+                ? [...deadline.matchAll(/(\d+)([smhd])/g)].reduce((sum, [, n, unit]) => sum + Number(n) * { s: 1_000, m: 60_000, h: 3_600_000, d: 86_400_000 }[unit], 0) : null;
+            if (ms === null || !Number.isSafeInteger(ms))
+                throw invalid(`deadline '${String(deadline)}' is not a duration; use one or more <int>[smhd] parts such as 10m or 1h30m`, 'deadline');
+            if (ms <= 0)
+                throw invalid('deadline must be greater than zero', 'deadline');
+            if (ms > 24 * 3_600_000)
+                throw invalid('deadline must be at most 24h', 'deadline');
+        }
         if (params['profile'] !== undefined && (typeof params['profile'] !== 'string' || !params['profile']))
             throw invalid('profile must be a profile id', 'profile');
         if (params['isolated'] !== undefined && typeof params['isolated'] !== 'boolean')
@@ -870,6 +883,7 @@ export class FakeCloud {
         const message = params['message'];
         const hash = sha256Hex(JSON.stringify({
             prompt: params['prompt'], scopes, metadata, profile: params['profile'], isolated: params['isolated'], cwd: params['cwd'], ...(params['model'] === undefined ? {} : { model: params['model'] }),
+            ...(params['deadline'] === undefined ? {} : { deadline: params['deadline'] }),
             ...(outputSchema === undefined ? {} : { output_schema: outputSchema }), ...(message === undefined ? {} : { message }),
         }));
         if (key !== null) {

package/dist/testing/users.d.ts

@@ -110,6 +110,7 @@ export interface FakeUser {
         setup(provider: string, state: SetupState, options?: {
             message?: string;
             next?: string;
+            step?: string;
         }): void;
         /** A grant sync with unchanged content: nothing changes, no held read wakes. */
         sync(): void;

package/dist/version.d.ts

@@ -1,5 +1,5 @@
 /** This SDK's release version. Informational only: compatibility is the contract level, not this number. */
-export declare const SDK_VERSION = "0.3.481";
+export declare const SDK_VERSION = "0.3.483";
 /** The release sent in `Crouter-Minimum-Runtime-Version` on every request. It is frozen, so a runtime from before the
  *  contract level existed (which only knows this header) refuses this SDK, while every later runtime accepts it. */
 export declare const LEGACY_FLOOR = "0.3.423";

package/dist/version.js

@@ -1,6 +1,6 @@
 // SDK_VERSION is written by scripts/release-version.mjs on every release; do not edit by hand.
 /** This SDK's release version. Informational only: compatibility is the contract level, not this number. */
-export const SDK_VERSION = '0.3.481';
+export const SDK_VERSION = '0.3.483';
 // LEGACY_FLOOR is written once by `scripts/contract.mjs release`, at the first release that carries the contract level
 // (the `0.0.0` placeholder is replaced there and never again); do not edit by hand.
 /** The release sent in `Crouter-Minimum-Runtime-Version` on every request. It is frozen, so a runtime from before the

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@north-light/sdk",
-  "version": "0.3.481",
-  "crouterContract": "1.7",
+  "version": "0.3.483",
+  "crouterContract": "1.9",
   "description": "Typed Node and browser client for running crouter agents through the crtrd /v1 API.",
   "type": "module",
   "main": "./dist/index.js",
@@ -44,8 +44,8 @@
     "prepublishOnly": "node -e \"if (process.env.npm_config_tag !== 'next') { console.error('@north-light/sdk publishes only with --tag next; scripts/promote-sdk.mjs is the only mover of latest.'); process.exit(1); }\""
   },
   "dependencies": {
-    "@north-light/api": "0.3.481",
-    "@north-light/identity": "0.3.481",
+    "@north-light/api": "0.3.483",
+    "@north-light/identity": "0.3.483",
     "jose": "^6.2.1"
   },
   "peerDependencies": {