@oddington/sdk 0.1.16 → 0.1.18

package/dist/types/packages/sdk/src/auth-types.d.ts

@@ -35,6 +35,8 @@ export interface BrowserAuthHandle {
     subscribe(listener: (state: BrowserAuthState) => void): () => void;
     sendCode(email: string): Promise<void>;
     verifyCode(email: string, code: string): Promise<void>;
+    /** End the browser session and invalidate installed capabilities, including local app access. */
     signOut(): Promise<void>;
+    /** Release this handle and its installed context; preserve the local app credential for a fresh document. */
     dispose(): void;
 }

package/dist/types/packages/sdk/src/public.d.ts

@@ -23,7 +23,7 @@ export declare const data: {
 };
 export { FileOperationError } from '../../../shared/files-contract.js';
 export { InboxOperationError } from '../../../shared/inbox-member-contract.js';
-export type { InboxMember, InboxCurrent, QuestionItemSnapshot, QuestionSnapshot, ResponseConsequence, LinkedAskSnapshot, AskUpdate, DigestReadConfirmation, RecipientCandidate, RecipientAddition, ResponseAcceptance, InboxAnswerInput, InboxSearchInput } from '../../../shared/inbox-member-types.js';
+export type { InboxMember, InboxCurrent, InboxItem, AnswerableQuestion, QuestionSnapshot, ResponseConsequence, LinkedAskSnapshot, AskUpdate, DigestReadConfirmation, RecipientCandidate, RecipientAddition, ResponseAcceptance, InboxAnswerInput, InboxSearchInput } from '../../../shared/inbox-member-types.js';
 export type { RecordSelectionResult } from '../../../shared/record-selection.js';
 export declare const inbox: import('../../../shared/inbox-member-types.js').InboxMember;
 export type { File, FileInput, FileStorage, FileCreateInput, FileCreateOptions, FileEnrichment, FileEnrichOptions, FileEnrichResult, FileErrorCode } from '../../../shared/files-contract.js';
@@ -67,7 +67,7 @@ export type HostedSessionSource = {
         };
     };
 };
-/** OS-owned hosted or exact-origin local browser bootstrap. Reinitialization replaces the context. */
+/** OS-owned hosted or exact-origin local browser bootstrap. Reinitialization replaces the context; a new document uses a fresh auth handle. */
 export declare const os: {
     init(options: {
         auth: HostedSessionSource | import('./auth-types.js').BrowserAuthHandle;

package/dist/types/shared/inbox-member-contract.d.ts

@@ -1,4 +1,4 @@
-import type { InboxCurrent, QuestionItemSnapshot, ResponseAcceptance } from './inbox-member-types.js';
+import type { InboxCurrent, InboxItem, AnswerableQuestion, ResponseAcceptance } from './inbox-member-types.js';
 export declare class InboxOperationError extends Error {
     readonly status: number;
     readonly reason: 'invalid_input' | 'access_denied' | 'authority_unavailable' | 'conflict' | 'unavailable';
@@ -6,14 +6,19 @@ export declare class InboxOperationError extends Error {
 }
 export declare const INBOX_RESULT_BYTES: number;
 export declare const INBOX_INPUT_BYTES = 8192;
+/** Includes the exact declaration only on the private CLI-authenticated ingress. */
+export declare const INBOX_LOCAL_INPUT_BYTES: number;
 export declare const INBOX_UUID: RegExp;
-export type InboxOperation = 'current' | 'items.list' | 'items.read' | 'items.see' | 'items.markDigestRead' | 'items.rename' | 'items.setLifecycle' | 'items.listRecipientCandidates' | 'items.addRecipient' | 'questions.answer' | 'questions.searchRecords' | 'files.read';
+export type InboxOperation = 'current' | 'items.list' | 'items.read' | 'items.see' | 'items.markDigestRead' | 'items.rename' | 'items.setLifecycle' | 'items.listRecipientCandidates' | 'items.addRecipient' | 'questions.list' | 'questions.answer' | 'questions.searchRecords' | 'files.read';
+export declare function isAppQuestionOperation(operation: InboxOperation): boolean;
 /** Closed wire vocabulary, shared by the SDK and its owning Worker. */
 export declare function parseInboxRequest(value: unknown): {
     operation: InboxOperation;
     input: Record<string, unknown>;
 };
 export declare function parseInboxCurrent(value: unknown): InboxCurrent;
-export declare function parseInboxItem(value: unknown): QuestionItemSnapshot;
+export declare function parseInboxItem(value: unknown): InboxItem;
+/** Exact app-facing vocabulary: an upstream snapshot cannot widen it. */
+export declare function parseAnswerableQuestion(value: unknown): AnswerableQuestion;
 export declare function parseInboxAcceptance(value: unknown): ResponseAcceptance;
 export declare function parseInboxResult(operation: InboxOperation, value: unknown): unknown;

package/dist/types/shared/inbox-member-types.d.ts

@@ -63,7 +63,7 @@ export type LinkedAskSnapshot = {
     state: 'unavailable';
     done: boolean;
 };
-export interface QuestionItemSnapshot {
+export interface InboxItem {
     id: string;
     workspaceId: string;
     number: number;
@@ -115,8 +115,27 @@ export interface ResponseAcceptance {
     label?: string;
     acceptanceOrder?: number;
 }
+export interface AnswerableQuestion {
+    item: {
+        id: string;
+        number: number;
+        revision: number;
+        title: string;
+        href: string;
+    };
+    origin: {
+        routine: string;
+    };
+    question: {
+        id: string;
+        prompt: string;
+        instructions: string | null;
+        response: ResponseDefinition;
+    };
+    recordRefs: string[];
+}
 export interface AskUpdate {
-    item: QuestionItemSnapshot;
+    item: InboxItem;
     activityId: number | null;
     changedAt: string | null;
 }
@@ -126,7 +145,7 @@ export interface RecipientCandidate {
     email: string;
 }
 export interface RecipientAddition {
-    item: QuestionItemSnapshot;
+    item: InboxItem;
     addedPersonId: string;
 }
 export type ItemRevision = {
@@ -145,8 +164,8 @@ export type InboxSearchInput = ItemRevision & {
 export interface InboxMember {
     current(): Promise<InboxCurrent>;
     items: {
-        list(): Promise<QuestionItemSnapshot[]>;
-        read(itemId: string): Promise<QuestionItemSnapshot>;
+        list(): Promise<InboxItem[]>;
+        read(itemId: string): Promise<InboxItem>;
         see(itemId: string): Promise<void>;
         markDigestRead(itemId: string): Promise<DigestReadConfirmation>;
         rename(input: ItemRevision & {
@@ -162,6 +181,7 @@ export interface InboxMember {
         }): Promise<RecipientAddition>;
     };
     questions: {
+        list(): Promise<AnswerableQuestion[]>;
         answer(input: InboxAnswerInput): Promise<ResponseAcceptance>;
         searchRecords(input: InboxSearchInput): Promise<RecordSelectionResult>;
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oddington/sdk",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "description": "Oddington routine and response-handler SDK",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",