@north-light/sdk 0.3.509 → 0.3.511

package/dist/resources/providers.d.ts

@@ -1,6 +1,6 @@
 import type { RequestOptions } from '../types.js';
 import type { Request } from './request.js';
-/** Help-only provider manifest: granted leaves, never transport or credentials. */
+/** Help-only provider manifest: all grouped leaves in commands, caller-granted groups in groups; never transport or credentials. */
 export type ProviderToolEntry = {
     provider: string;
     display_name: string;
@@ -35,17 +35,25 @@ export type ProviderToolEntry = {
 export declare class Providers {
     private readonly request;
     constructor(request: Request);
-    /** Omit provider to list every reachable provider; name one to inspect it. */
+    /** Omit provider to list every installed provider; name one to inspect it. */
     tools(provider: string, options?: RequestOptions): Promise<ProviderToolEntry>;
     tools(provider?: undefined, options?: RequestOptions): Promise<{
         providers: ProviderToolEntry[];
     }>;
-    /** The daemon checks scope, mints an outbound token and calls the provider. */
+    /**
+     * The daemon checks scope, mints an outbound token and calls the provider.
+     *
+     * `machine` names which of the account's devices takes the call (a `machine_id`, `runtime:` prefix optional). Only a provider
+     * served by a machine, such as `device`, accepts it. When the account has more than one such machine and the call names none,
+     * the runtime refuses with `machine_required` rather than guessing (except `device`'s `browser libs`, which uses the most recently seen machine); name the
+     * device here and repeat the call.
+     */
     call(input: {
         provider: string;
         tool: string;
         arguments: Record<string, unknown>;
         version?: number;
         approval?: string;
+        machine?: string;
     }, options?: RequestOptions): Promise<unknown>;
 }

package/dist/resources/providers.js

@@ -8,7 +8,14 @@ export class Providers {
         const path = provider === undefined ? '/v1/providers/tools' : `/v1/providers/${pathSegment(provider, 'provider')}/tools`;
         return this.request('GET', path, undefined, options);
     }
-    /** The daemon checks scope, mints an outbound token and calls the provider. */
+    /**
+     * The daemon checks scope, mints an outbound token and calls the provider.
+     *
+     * `machine` names which of the account's devices takes the call (a `machine_id`, `runtime:` prefix optional). Only a provider
+     * served by a machine, such as `device`, accepts it. When the account has more than one such machine and the call names none,
+     * the runtime refuses with `machine_required` rather than guessing (except `device`'s `browser libs`, which uses the most recently seen machine); name the
+     * device here and repeat the call.
+     */
     call(input, options) {
         return this.request('POST', '/v1/provider/call', input, options);
     }

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.509"
+  sdk-version: "0.3.511"
 ---
 
 # 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.509`. 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.511`. 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

@@ -1012,10 +1012,10 @@ export class FakeCloud {
     }
     providerEntry(user, id, definition) {
         const held = user.scopeStrings();
-        if (!held.some((scope) => scope.startsWith(`${id}:`)))
-            return null;
         const displayName = definition.displayName ?? id;
         if (definition.status && definition.status !== 'available') {
+            if (!held.some((scope) => scope.startsWith(`${id}:`)))
+                return null;
             return { provider: id, display_name: displayName, status: definition.status, ...(definition.error ? { error: definition.error } : {}), groups: [], commands: [] };
         }
         const groups = new Map();
@@ -1026,8 +1026,6 @@ export class FakeCloud {
             const description = spec.description ?? tool;
             groups.set(group, [...(groups.get(group) ?? []), { tool, description, summary: description, params: [], output: [] }]);
         }
-        if (groups.size === 0)
-            return null;
         return { provider: id, display_name: displayName, status: 'available', major: 1, groups: [...groups].map(([group, leaves]) => ({ group, leaves })), commands: [] };
     }
     providerTools(user, provider) {

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.509";
+export declare const SDK_VERSION = "0.3.511";
 /** 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.509';
+export const SDK_VERSION = '0.3.511';
 // 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.509",
-  "crouterContract": "1.19",
+  "version": "0.3.511",
+  "crouterContract": "1.21",
   "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.509",
-    "@north-light/identity": "0.3.509",
+    "@north-light/api": "0.3.511",
+    "@north-light/identity": "0.3.511",
     "jose": "^6.2.1"
   },
   "peerDependencies": {