@north-light/sdk 0.3.482 → 0.3.484

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/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.482"
+  sdk-version: "0.3.484"
 ---
 
 # 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.482`. 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.484`. 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();

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.482";
+export declare const SDK_VERSION = "0.3.484";
 /** 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.482';
+export const SDK_VERSION = '0.3.484';
 // 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.482",
-  "crouterContract": "1.8",
+  "version": "0.3.484",
+  "crouterContract": "1.10",
   "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.482",
-    "@north-light/identity": "0.3.482",
+    "@north-light/api": "0.3.484",
+    "@north-light/identity": "0.3.484",
     "jose": "^6.2.1"
   },
   "peerDependencies": {