@oddington/sdk 0.1.33 → 0.1.35

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

@@ -1,7 +1,5 @@
-import type { AskInput, CapturedRecords, DigestInput, InboxFile, PublicationRequest, PublishedAsk, PublishedDigest, RepositoryReceipt, ResolutionInput } from '../../../shared/inbox-contract.js';
+import type { AskInput, DigestInput, InboxFile, PublicationRequest, PublishedAsk, PublishedDigest, ResolutionInput } from '../../../shared/inbox-contract.js';
 import type { FileAddOptions } from '../../../shared/inbox-files.js';
-import type { RecordReadInput } from '../../../shared/record-capture.js';
-import type { RecordDeleteRequest, RecordUpdateRequest, RecordWriteRequest } from '../../../shared/record-write.js';
 export type { RoutineSchema, RoutineSchemaValue, RoutineDefinition, RoutineInput, RoutineRuntime, RoutineAccess, RoutineCapabilities, RoutineStep, RoutineSteps, RoutineStepInput, RoutineStepResult, RoutineStepOutput, RoutineArtifactInput, RoutineArtifact, RoutineAI } from './routine-definition-types.js';
 export declare const defineRoutine: import('./routine-definition-types.js').DefineRoutine;
 export declare const schema: import('./routine-definition-types.js').RoutineSchemaBuilders;
@@ -10,9 +8,6 @@ export { InboxContractError, asksBlock, continueAsk, defineHandler, fileBlock, q
 export type { AskInput, AuthoredSource, CapturedRecords, DigestInput, Handler, HandlerReference, HandlerRuntime, HandlerTransition, InboxBlock, InboxFile, JsonObject, JsonValue, PresentedField, PresentedRecord, PresentedRecordSummary, PublishedAsk, PublishedDigest, PublishedView, PublicationRequest, Question, QuestionInput, QuestionResponse, RecordCreate, RecordDelete, RecordReference, RecordSource, RecordUpdate, RepositoryCapabilities, RepositoryReceipt, Resolution, ResolutionInput, ResponseDefinition, } from '../../../shared/inbox-contract.js';
 export type { CapturedRecordTableInput, RecordField, RecordTableInput, RecordValue, RecordViewInput, TableColumn, ViewRecord, } from '../../../shared/inbox-views.js';
 export type { FileAddOptions } from '../../../shared/inbox-files.js';
-export type { RecordReadInput } from '../../../shared/record-capture.js';
-export type { RecordDeleteRequest, RecordUpdateRequest, RecordWriteRequest } from '../../../shared/record-write.js';
-export { RoutineRecordWriteError } from '../../../shared/record-write.js';
 export { AirtableOperationError } from '../../../shared/airtable-contract.js';
 export type { AirtableField, AirtableTable, AirtableRecord, AirtableListInput, AirtableGetInput, AirtableCreateInput, AirtableUpdateInput, AirtableDeleteInput, AirtableReceipt, AirtableWriteResult, AirtableClient } from '../../../shared/airtable-contract.js';
 export type { GmailRuntimeConnection, AirtableRuntimeConnection, DropboxRuntimeConnection, RuntimeConnection } from '../../../shared/connection-runtime.js';
@@ -40,7 +35,7 @@ export { InboxOperationError } from '../../../shared/inbox-member-contract.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';
+export type { File, FileInput, FileStorage, FileCreateInput, FileCreateOptions, FileEnrichment, FileEnrichOptions, FileEnrichResult, FileErrorCode, FileErrorDetail } from '../../../shared/files-contract.js';
 export declare const files: {
     create(input: import('../../../shared/files-contract.js').FileCreateInput, options?: import('../../../shared/files-contract.js').FileCreateOptions): Promise<import('../../../shared/files-contract.js').File>;
     get(id: string): Promise<import('../../../shared/files-contract.js').File>;
@@ -222,25 +217,6 @@ export type RoutinePublicationClient = {
         requestKey: string;
     }): Promise<PublishedDigest>;
     publishResolution(askId: string, value: ResolutionInput): Promise<void>;
-    readRecords(input: RecordReadInput): Promise<CapturedRecords>;
-    repository: {
-        readRecords(input: RecordReadInput): Promise<CapturedRecords>;
-        updateRecords(input: RecordUpdateRequest, options: {
-            requestKey: string;
-        }): Promise<{
-            receipt: RepositoryReceipt;
-        }>;
-        writeRecords(input: RecordWriteRequest, options: {
-            requestKey: string;
-        }): Promise<{
-            receipt: RepositoryReceipt;
-        }>;
-        deleteRecords(input: RecordDeleteRequest, options: {
-            requestKey: string;
-        }): Promise<{
-            receipt: RepositoryReceipt;
-        }>;
-    };
     files: {
         add(value: FileAddOptions): Promise<InboxFile>;
     };

package/dist/types/shared/files-contract.d.ts

@@ -37,12 +37,40 @@ export type File = {
     enrichments: Record<string, FileEnrichment>;
 };
 export type FileErrorCode = 'invalid_input' | 'unsupported_context' | 'unauthenticated' | 'access_denied' | 'request_too_large' | 'conflict' | 'local_only' | 'integrity' | 'unavailable' | 'capacity' | 'method_not_allowed';
+declare const fileValidationReasons: {
+    invalid_metadata: string;
+    invalid_name: string;
+    invalid_path: string;
+    invalid_storage: string;
+    invalid_media_type: string;
+    invalid_size: string;
+    invalid_request_key: string;
+    invalid_enrichment_name: string;
+    invalid_replacement: string;
+    invalid_bytes: string;
+};
+export type FileErrorDetail = {
+    reason: keyof typeof fileValidationReasons | 'size_mismatch' | 'size_limit';
+    expectedBytes?: number;
+    receivedBytes?: number;
+    limitBytes?: number;
+    receivedAtLeast?: true;
+};
+/** Only inert, bounded facts cross Files and Run error boundaries. */
+export declare function parseFileErrorDetail(value: unknown): FileErrorDetail | undefined;
+export declare function fileErrorExplanation(detail: FileErrorDetail): string;
 export declare class FileOperationError extends Error {
     readonly code: FileErrorCode;
     readonly status: number;
     readonly retryable: boolean;
-    constructor(code: FileErrorCode, status: number, retryable?: boolean);
+    readonly detail?: FileErrorDetail;
+    constructor(code: FileErrorCode, status: number, retryable?: boolean, detail?: FileErrorDetail);
 }
+export declare function fileErrorFacts(error: FileOperationError): {
+    code: FileErrorCode;
+    retryable?: boolean | undefined;
+    detail?: FileErrorDetail | undefined;
+};
 export declare const FILE_ID_PATTERN: RegExp;
 /** Descriptor admission is independent of each runtime's supported writes. */
 export declare const FILE_ORIGINAL_MAX_BYTES: number;
@@ -74,3 +102,4 @@ export type FileCreateMetadata = {
     requestKey: string;
 };
 export declare function parseFileCreateMetadata(value: unknown, maxBytes: number): FileCreateMetadata;
+export {};

package/dist/types/shared/routine-deployment-contract.d.ts

@@ -16,12 +16,12 @@ export type RoutineDeclaration = {
         publish: Array<'asks' | 'digests'>;
     };
     runtime: {
-        features: Array<'python' | 'documents' | 'browser'>;
-        resources: 'standard' | 'large';
-        maxDuration: string;
+        features: [];
+        resources: 'standard';
+        maxDuration: '15m';
     };
     retry: {
-        maxAttempts: number;
+        maxAttempts: 1;
     };
     assets: string[];
 };

package/package.json

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

package/dist/types/shared/record-write.d.ts

@@ -1,33 +0,0 @@
-import { type RecordCreate, type RecordDelete, type RecordUpdate } from './inbox-contract.js';
-export type RecordWrite = RecordCreate | RecordUpdate;
-export type RecordUpdateRequest = {
-    repository: string;
-    records: RecordUpdate[];
-};
-export type RecordWriteRequest = {
-    repository: string;
-    records: RecordWrite[];
-};
-export type RecordDeleteRequest = {
-    repository: string;
-    records: RecordDelete[];
-};
-export type RecordChange = RecordWrite | RecordDelete;
-export type RecordChangeRequest = {
-    repository: string;
-    records: RecordChange[];
-};
-export type RoutineRecordWriteRequest = {
-    input: RecordChangeRequest;
-    requestKey: string;
-};
-export declare const RECORD_WRITE_INPUT_LIMIT: number;
-export declare class RoutineRecordWriteError extends Error {
-    readonly effect: 'unapplied' | 'uncertain' | 'pending';
-    constructor(message: string, effect: 'unapplied' | 'uncertain' | 'pending');
-}
-export declare function validateRecordWrite(value: unknown): RecordWriteRequest;
-export declare function validateRecordUpdate(value: unknown): RecordUpdateRequest;
-export declare function validateRecordDelete(value: unknown): RecordDeleteRequest;
-export declare function validateRecordChange(value: unknown): RecordChangeRequest;
-export declare function validateRoutineRecordWrite(value: unknown): RoutineRecordWriteRequest;