@north-light/sdk 0.3.515 → 0.3.519

package/dist/index.d.ts

@@ -14,7 +14,7 @@ export type { AttachmentLink } from './resources/attachments.js';
 export type { Share, ShareCreated, ShareCreateParams } from './resources/shares.js';
 export type { Doc, DocEditParams, DocWriteParams } from './resources/docs.js';
 export type { MemoryDocument, MemoryGetParams, MemoryListItem, MemoryListPage, MemoryListParams } from './resources/memory.js';
-export type { Question, QuestionAnswered, QuestionFields, QuestionResponses, QuestionSlot, QuestionStatus } from './resources/questions.js';
+export type { Question, QuestionAnswered, QuestionCanceled, QuestionFields, QuestionKind, QuestionResponses, QuestionSlot, QuestionStatus } from './resources/questions.js';
 export type { ProviderToolEntry } from './resources/providers.js';
 export { OAuth2Client, ConnectedCrouter, DEFAULT_DIRECTORY_TIMEOUT_MS, MemoryConnectionStore, profileFromClaims } from './oauth/index.js';
 export { authorizationRefusalOf, refusalOf } from './oauth/index.js';

package/dist/resources/questions.d.ts

@@ -20,6 +20,8 @@ export interface QuestionFields {
     slots: QuestionSlot[];
 }
 export type QuestionStatus = 'open' | 'answered' | 'canceled';
+/** A `decision` asks the person for a response; a `notice` asks for nothing and is acknowledged with `answer(id, {})`. */
+export type QuestionKind = 'decision' | 'notice';
 /** Responses keyed by slot id. */
 export type QuestionResponses = Record<string, unknown>;
 /** A question an agent in a run asked the user. */
@@ -27,10 +29,15 @@ export interface Question extends QuestionFields {
     run_id: string;
     /** The asking node. */
     node_id: string;
+    kind: QuestionKind;
     status: QuestionStatus;
     /** Present once answered. */
     answer?: QuestionResponses;
 }
+/** `questions.cancel`'s result: the question as `questions.get` returns it, with `status: 'canceled'`. */
+export type QuestionCanceled = Question & {
+    status: 'canceled';
+};
 export interface QuestionAnswered {
     question_id: string;
     status: 'answered';
@@ -42,8 +49,12 @@ export declare class Questions {
     constructor(request: Request);
     /** Read a question of a run the caller can read; anything else is `not_found`. */
     get(questionId: string, options?: RequestOptions): Promise<Question>;
-    /** Answer an open question of the caller's own run. An answer that does not match a slot is
+    /** Answer an open question of the caller's own run; a notice is acknowledged with empty `responses`. An answer that does not match a slot is
      *  `invalid_request` with `param` naming the slot, and records nothing. A question already answered or
      *  canceled — including the loser of a race — is 409 `run_settled` with `details.state` and `details.result`. */
     answer(questionId: string, responses: QuestionResponses, options?: RequestOptions): Promise<QuestionAnswered>;
+    /** Cancel an open question of the caller's own run (or the caller's own runless provider approval): the person
+     *  dismissed it, and the asking agent is told so. A question already answered or canceled is 409 `run_settled`
+     *  with `details.state` and `details.result`; another app's run is `other_app_run`. A notice is canceled the same way. */
+    cancel(questionId: string, options?: RequestOptions): Promise<QuestionCanceled>;
 }

package/dist/resources/questions.js

@@ -9,12 +9,18 @@ export class Questions {
     get(questionId, options) {
         return this.request('GET', questionPath(questionId), undefined, options);
     }
-    /** Answer an open question of the caller's own run. An answer that does not match a slot is
+    /** Answer an open question of the caller's own run; a notice is acknowledged with empty `responses`. An answer that does not match a slot is
      *  `invalid_request` with `param` naming the slot, and records nothing. A question already answered or
      *  canceled — including the loser of a race — is 409 `run_settled` with `details.state` and `details.result`. */
     answer(questionId, responses, options = {}) {
         return this.request('POST', `${questionPath(questionId)}/answer`, { responses }, { ...options, maxRetries: 0 });
     }
+    /** Cancel an open question of the caller's own run (or the caller's own runless provider approval): the person
+     *  dismissed it, and the asking agent is told so. A question already answered or canceled is 409 `run_settled`
+     *  with `details.state` and `details.result`; another app's run is `other_app_run`. A notice is canceled the same way. */
+    cancel(questionId, options = {}) {
+        return this.request('POST', `${questionPath(questionId)}/cancel`, undefined, { ...options, maxRetries: 0 });
+    }
 }
 function questionPath(id) {
     return `/v1/questions/${encodeURIComponent(pathSegment(id, 'question id'))}`;

package/dist/resources/runs.d.ts

@@ -55,6 +55,8 @@ export interface RunObject {
     /** Present when the root's latest completed turn ended in error; the next turn that completes without one clears it. */
     last_turn_error?: TurnErrorDTO;
     pending_question_ids: string[];
+    /** Open notices (questions of kind `notice`) of the run, oldest first. A notice does not make the run `waiting_on_user`. */
+    open_notice_ids: string[];
     usage: {
         input_tokens: number;
         output_tokens: number;

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.515"
+  sdk-version: "0.3.519"
 ---
 
 # 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.515`. 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.519`. 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.d.ts

@@ -6,7 +6,7 @@ import { FakeRun } from './run.js';
 import { type FakeRefusalCode, type FakeScope, type FakeUser, type Responder } from './users.js';
 import { type FakeError } from './wire.js';
 /** A runtime operation, named as the daemon's `OPERATIONS` table names it. */
-export type FakeOp = 'grant.get' | 'run.start' | 'run.list' | 'run.get' | 'run.message' | 'run.events' | 'run.interrupt' | 'run.cancel' | 'run.delete' | 'run.rename' | 'question.get' | 'question.answer' | 'trace.get' | 'memory.list' | 'memory.get' | 'provider.tools' | 'provider.call' | 'profile.list';
+export type FakeOp = 'grant.get' | 'run.start' | 'run.list' | 'run.get' | 'run.message' | 'run.events' | 'run.interrupt' | 'run.cancel' | 'run.delete' | 'run.rename' | 'question.get' | 'question.answer' | 'question.cancel' | 'trace.get' | 'memory.list' | 'memory.get' | 'provider.tools' | 'provider.call' | 'profile.list';
 /** A directory operation. */
 export type FakeDirectoryOp = 'directory.discovery' | 'directory.token' | 'directory.jwks';
 /** What `intercept` / `failNext` / `gate` match: a runtime operation, `'*'` (every runtime operation), or a directory operation. */

package/dist/testing/cloud.js

@@ -28,6 +28,7 @@ const ROUTES = [
     ['GET', /^\/v1\/runs\/([^/]+)\/trace$/, 'trace.get'],
     ['GET', /^\/v1\/questions\/([^/]+)$/, 'question.get'],
     ['POST', /^\/v1\/questions\/([^/]+)\/answer$/, 'question.answer'],
+    ['POST', /^\/v1\/questions\/([^/]+)\/cancel$/, 'question.cancel'],
     ['GET', /^\/v1\/memory$/, 'memory.list'],
     ['GET', /^\/v1\/memory\/document$/, 'memory.get'],
     ['GET', /^\/v1\/providers\/tools$/, 'provider.tools'],
@@ -606,7 +607,7 @@ export class FakeCloud {
         }
         const user = sub !== null ? this.users.get(sub) : undefined;
         const runId = RUN_OPS.has(op) ? id : undefined;
-        const questionId = op === 'question.get' || op === 'question.answer' ? id : null;
+        const questionId = op === 'question.get' || op === 'question.answer' || op === 'question.cancel' ? id : null;
         const questionRun = questionId === null ? undefined : user?.runs.find((run) => !run.deleted && run.questions.has(questionId));
         const call = {
             userId: user ? user.id : null, op, runId: runId ?? questionRun?.id ?? null, questionId, method: request.method, path: url.pathname,
@@ -776,6 +777,14 @@ export class FakeCloud {
                 run.answer(question, responses);
                 return { status: 200, body: { question_id: question, status: 'answered', answer: responses } };
             }
+            case 'question.cancel': {
+                const { run, question } = this.question(user, id);
+                const current = run.questionObject(question);
+                if (current['status'] !== 'open')
+                    throw refuse(409, 'run_settled', `question ${question} is already ${String(current['status'])}`, { details: { state: current['status'] } });
+                run.cancelQuestion(question);
+                return { status: 200, body: run.questionObject(question) };
+            }
             case 'memory.list': return { status: 200, body: this.memoryList(user, query) };
             case 'memory.get': {
                 this.memoryStore(query);

package/dist/testing/run.d.ts

@@ -55,9 +55,12 @@ export interface FakeQuestion {
     slots?: RunQuestionSlotDTO[];
     provider?: string;
     tool?: string;
+    /** `notice` asks for nothing: it does not make the run `waiting_on_user`, emits no `waiting_on_user`, and is listed in `open_notice_ids`. Default `decision`. */
+    kind?: 'decision' | 'notice';
 }
 interface OpenQuestion {
     question_id: string;
+    kind: 'decision' | 'notice';
     title: string;
     subtitle?: string;
     steps: number;
@@ -112,6 +115,8 @@ export declare class FakeRun {
     /** Messages not yet delivered to a turn (the start's `message` included). */
     get pending(): FakeRunMessage[];
     get pendingQuestionIds(): string[];
+    get openNoticeIds(): string[];
+    private openIds;
     /** The run status, derived as the daemon's `runStatus` derives it. */
     get status(): RunStatusDTO;
     /** What the root is doing, derived from the event log as `runActivity` derives it with no open streaming block. */
@@ -156,6 +161,8 @@ export declare class FakeRun {
     reopen(): void;
     /** The app answered a question. */
     answer(questionId: string, responses: Record<string, unknown>): void;
+    /** The app canceled a question: the person dismissed it. */
+    cancelQuestion(questionId: string): void;
     questionObject(questionId: string): Record<string, unknown> | undefined;
     /** Resolves when the run rests (`idle`, `waiting_on_user`, `settled`), is deleted, `seconds` pass, or `signal` aborts. */
     waitResting(seconds: number, signal?: AbortSignal | null): Promise<void>;

package/dist/testing/run.js

@@ -74,7 +74,9 @@ export class FakeRun {
     get lastTurnError() { return this.turnError; }
     /** Messages not yet delivered to a turn (the start's `message` included). */
     get pending() { return this.messages.filter((message) => !message.delivered); }
-    get pendingQuestionIds() { return [...this.questions.values()].filter((q) => q.status === 'open').map((q) => q.question_id); }
+    get pendingQuestionIds() { return this.openIds('decision'); }
+    get openNoticeIds() { return this.openIds('notice'); }
+    openIds(kind) { return [...this.questions.values()].filter((q) => q.status === 'open' && q.kind === kind).map((q) => q.question_id); }
     /** The run status, derived as the daemon's `runStatus` derives it. */
     get status() {
         if (this.outcomeValue)
@@ -115,6 +117,7 @@ export class FakeRun {
             ...(this.outcomeValue && this.hasResult ? { result: this.resultValue } : {}),
             // `last_report` is the newest report body (`runObject`); a scripted ending writes no report, so it is absent.
             pending_question_ids: status === 'settled' ? [] : this.pendingQuestionIds,
+            open_notice_ids: status === 'settled' ? [] : this.openNoticeIds,
             ...(this.turnError ? { last_turn_error: this.turnError } : {}),
             usage: usage(), payer: 'user', scopes: this.scopes, metadata: this.metadata, created_at: this.createdAt,
             ...(this.settledAt ? { settled_at: this.settledAt } : {}),
@@ -202,9 +205,14 @@ export class FakeRun {
     ask(question) {
         this.assertLive();
         const id = `question-${this.id}-${this.questions.size + 1}`;
-        const slots = question.slots ?? [{ id: 'answer', kind: 'text', step: 0, config: {} }];
+        const kind = question.kind ?? 'decision';
+        const slots = question.slots ?? (kind === 'notice' ? [] : [{ id: 'answer', kind: 'text', step: 0, config: {} }]);
+        if (kind === 'notice' && slots.length > 0)
+            throw new Error('a notice takes no response: it has no slots');
         const steps = question.steps ?? 1;
-        this.questions.set(id, { question_id: id, title: question.title, ...(question.subtitle === undefined ? {} : { subtitle: question.subtitle }), steps, slots, status: 'open' });
+        this.questions.set(id, { question_id: id, kind, title: question.title, ...(question.subtitle === undefined ? {} : { subtitle: question.subtitle }), steps, slots, status: 'open' });
+        if (kind === 'notice')
+            return id;
         this.rested = true;
         this.append('waiting_on_user', {
             question_id: id, initiating_app: this.host.grantee, title: question.title,
@@ -256,13 +264,17 @@ export class FakeRun {
         this.answered = true;
         this.append('question.answered', { question_id: questionId, answer: responses });
     }
+    /** The app canceled a question: the person dismissed it. */
+    cancelQuestion(questionId) {
+        this.questions.get(questionId).status = 'canceled';
+    }
     questionObject(questionId) {
         const q = this.questions.get(questionId);
         if (!q)
             return undefined;
         return {
             question_id: q.question_id, initiating_app: this.host.grantee, title: q.title, ...(q.subtitle === undefined ? {} : { subtitle: q.subtitle }),
-            steps: q.steps, slots: q.slots, run_id: this.id, node_id: this.id, status: q.status, ...(q.answer ? { answer: q.answer } : {}),
+            steps: q.steps, slots: q.slots, run_id: this.id, node_id: this.id, kind: q.kind, status: q.status, ...(q.answer ? { answer: q.answer } : {}),
         };
     }
     /** Resolves when the run rests (`idle`, `waiting_on_user`, `settled`), is deleted, `seconds` pass, or `signal` aborts. */

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.515";
+export declare const SDK_VERSION = "0.3.519";
 /** 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.515';
+export const SDK_VERSION = '0.3.519';
 // 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.515",
-  "crouterContract": "1.23",
+  "version": "0.3.519",
+  "crouterContract": "1.24",
   "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.515",
-    "@north-light/identity": "0.3.515",
+    "@north-light/api": "0.3.519",
+    "@north-light/identity": "0.3.519",
     "jose": "^6.2.1"
   },
   "peerDependencies": {