@oddington/sdk 0.1.29 → 0.1.31

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

@@ -7,7 +7,7 @@ export declare const defineRoutine: import('./routine-definition-types.js').Defi
 export declare const schema: import('./routine-definition-types.js').RoutineSchemaBuilders;
 export declare const file: import('./routine-definition-types.js').RoutineFileSchema;
 export { InboxContractError, asksBlock, continueAsk, defineHandler, fileBlock, question, recordBlock, recordsBlock, resolveAsk, respond, richTextBlock, selection, } from '../../../shared/inbox-contract.js';
-export type { AskInput, AuthoredSource, CapturedRecords, CsvDetails, 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 { 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';
@@ -20,8 +20,15 @@ export type { Connections } from '../../../shared/airtable-contract.js';
 export declare const connections: import('../../../shared/airtable-contract.js').Connections;
 export { DataOperationError } from '../../../shared/data-contract.js';
 export type { DataRepository, DataErrorCode, PublicValueDefinition, PublicField, CollectionSummary, CollectionSchema, QueryScalar, SelectionOptions, RecordSelection, RecordsQuery, DataValue, SelectedRecord, SelectionMetadata, RecordsResult, RecordsReadInput, RecordsReadResult, RecordsSearchOptions, RecordsSearchResult, HistoryListOptions, HistoryEntry, HistoryChangesOptions, HistoryChange, HistoryChangesResult, RecordIdentity, RecordCreation, RecordUpdateSet, DataPublication, DataChangeSet, DataEffect } from '../../../shared/data-contract.js';
-/** Reserved for OS-generated normalized schema snapshots; grants no runtime authority. */
-export interface DataRepositorySchemas {
+declare global {
+    namespace __OddingtonOS {
+        /** Import-free OS-generated metadata; no runtime namespace is created. */
+        interface DataRepositorySchemas {
+        }
+    }
+}
+/** Reserved for OS-generated snapshots, including legacy module augmentations. */
+export interface DataRepositorySchemas extends __OddingtonOS.DataRepositorySchemas {
 }
 export declare const data: {
     repository<const Name extends string>(name: Name): import('./data-schema-types.js').RepositoryFor<Name>;
@@ -198,18 +205,6 @@ export declare const app: {
     };
     routines: AppRoutineTypes;
 };
-/** A declared stage without a summary takes no second argument. */
-export type AppRunContext<Input, Result, Steps> = {
-    readonly input: AppRunInput<Input>;
-    step<Key extends Extract<keyof Steps, string>>(id: Key, ...summary: Steps[Key] extends undefined ? [] : [summary: Steps[Key]]): Promise<void>;
-    finish(...result: [Result] extends [undefined] ? [] : [result: Result]): Promise<void>;
-};
-export type AppRunInput<Value> = Value extends object ? {
-    readonly [Key in keyof Value]: AppRunInput<Value[Key]>;
-} : Value;
-export declare const appRun: {
-    current<Input = unknown, Result = undefined, Steps = Record<string, undefined>>(): AppRunContext<Input, Result, Steps> | undefined;
-};
 export type InboxRequester = (path: string, init?: RequestInit) => Promise<Response>;
 export type RoutinePublicationClientOptions = {
     workspace?: string;

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

@@ -1,18 +1,13 @@
 /** Provider-neutral authored contract. Registries and object locations stay server-side. */
 export type FileStorage = 'local' | 'remote';
 export type FileInput = Blob | Uint8Array | ReadableStream<Uint8Array>;
-export type FileCsvHints = {
-    encoding?: 'utf-8' | 'windows-1252';
-    delimiter?: ',' | ';' | '\t';
-    headerRow?: number;
-};
 export type FileCreateInput = {
     file: FileInput;
     size?: number;
     path?: string;
     name?: string;
     storage?: FileStorage;
-    csv?: FileCsvHints;
+    mediaType?: string;
 };
 export type FileCreateOptions = {
     requestKey?: string;
@@ -40,18 +35,6 @@ export type File = {
     size: number;
     sha256: string;
     enrichments: Record<string, FileEnrichment>;
-    details: {
-        kind: 'csv';
-        encoding: 'utf-8' | 'windows-1252';
-        delimiter: ',' | ';' | '\t';
-        headerRow: number;
-        dataRows: number;
-    } | {
-        kind: 'pdf';
-        pages?: number;
-    } | {
-        kind: 'other';
-    };
 };
 export type FileErrorCode = 'invalid_input' | 'unsupported_context' | 'unauthenticated' | 'access_denied' | 'request_too_large' | 'conflict' | 'local_only' | 'integrity' | 'unavailable' | 'capacity' | 'method_not_allowed';
 export declare class FileOperationError extends Error {
@@ -77,30 +60,17 @@ export declare function parseFileEnrichMetadata(value: unknown, maxBytes: number
 export declare function safeFileName(value: unknown): value is string;
 export declare function safeFilePath(value: unknown): value is string;
 export declare function safeManagedFilePath(value: unknown): value is string;
-/** Private transport metadata: normalized material options exclude the request key and size declaration. */
-export declare const ORIGINAL_MEDIA_TYPES: readonly ['application/pdf', 'text/plain', 'text/markdown', 'application/json', 'image/png', 'image/jpeg'];
-export type OriginalMediaType = typeof ORIGINAL_MEDIA_TYPES[number];
 /** Normalize declarations only; no byte interpretation or filename inference. */
-export declare function declaredOriginalMediaType(value: string): OriginalMediaType | undefined;
+export type OriginalMediaType = string;
+export declare function declaredOriginalMediaType(value: unknown): string;
+export declare function isCanonicalOriginalMediaType(value: unknown): value is string;
+/** Private transport metadata: normalized material options exclude the request key and size declaration. */
 export type FileCreateMetadata = {
     name: string;
     path: string;
     storage?: FileStorage;
-    csv?: Required<FileCsvHints>;
-    inputMediaType?: OriginalMediaType;
+    mediaType: string;
     size: number;
     requestKey: string;
 };
-/** Declared types are descriptive metadata; this rule never reads original bytes. */
-export declare function declaredOriginalFormat(input: Pick<FileCreateMetadata, 'name' | 'inputMediaType'>): {
-    mediaType: 'application/pdf';
-    details: {
-        kind: 'pdf';
-    };
-} | {
-    mediaType: "application/json" | "image/jpeg" | "image/png" | "text/markdown" | "text/plain";
-    details: {
-        kind: 'other';
-    };
-} | undefined;
 export declare function parseFileCreateMetadata(value: unknown, maxBytes: number): FileCreateMetadata;

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

@@ -87,25 +87,12 @@ export type PresentedRecordSummary = {
     facts?: PresentedField[];
     view?: string;
 };
-export type CsvDetails = {
-    kind: 'csv';
-    encoding: 'utf-8' | 'windows-1252';
-    delimiter: ',' | ';' | '\t';
-    headerRow: number;
-    dataRows: number;
-};
 export type InboxFile = {
     id: string;
     name: string;
     mediaType: string;
     size: number;
     sha256: string;
-    details: CsvDetails | {
-        kind: 'pdf';
-        pages?: number;
-    } | {
-        kind: 'other';
-    };
 };
 export type InboxBlock = {
     kind: 'rich-text';

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

@@ -1,17 +1,12 @@
-import { type InboxFile, type CsvDetails } from './inbox-contract.js';
+import { type InboxFile } from './inbox-contract.js';
 export type FileAddOptions = {
     path: string;
     name?: string;
-    csv?: {
-        encoding?: CsvDetails['encoding'];
-        delimiter?: CsvDetails['delimiter'];
-        headerRow?: number;
-    };
 };
 export declare function validateFileAddOptions(value: unknown): FileAddOptions;
-export declare function validateCsvHints(value: unknown): NonNullable<FileAddOptions['csv']>;
-export declare function csvRows(bytes: Uint8Array, details: CsvDetails): string[][];
-export declare function deriveInboxFile(bytes: Uint8Array, name: string, csv?: FileAddOptions['csv']): Promise<Omit<InboxFile, 'id'>>;
-/** Integrity/type checks apply to publication and every fresh download. */
+/** Consumer interpretation only: no parsing facts become File metadata. */
+export declare function previewCsvRows(bytes: Uint8Array): string[][];
+export declare function deriveInboxFile(bytes: Uint8Array, name: string): Promise<Omit<InboxFile, 'id'>>;
+/** Original integrity is independent of consumer format interpretation. */
 export declare function verifyInboxFile(bytes: Uint8Array, value: unknown): Promise<InboxFile>;
 export declare function publicationFiles(body?: import('./inbox-contract.js').InboxBlock[]): InboxFile[];

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

@@ -28,7 +28,7 @@ export type RoutineDeclaration = {
 export type RoutineDeploymentSource = {
     digest: string;
     declaration: RoutineDeclaration;
-    definition?: {
+    definition: {
         entry: string;
         contract: RoutineContract;
     };

package/package.json

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