@oddington/sdk 0.1.17 → 0.1.18

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';

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.17",
+  "version": "0.1.18",
   "description": "Oddington routine and response-handler SDK",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",