@oddington/sdk 0.1.40 → 0.1.42

package/dist/types/packages/sdk/src/data-schema-types.d.ts

@@ -175,8 +175,8 @@ type Result<Schemas extends Catalogue, Query extends RecordsQuery> = Widened<Que
 };
 type Checked<Schemas extends Catalogue, Query> = Widened<Query> extends true ? unknown : CheckQuery<Schemas, Query>;
 type SchemaRepository<Schemas extends Catalogue> = Omit<DataRepository, 'records'> & {
-    records: Omit<DataRepository['records'], 'select' | 'pages' | 'all'> & {
-        select<const Query extends RecordsQuery>(query: Query & Checked<Schemas, Query>): Promise<Result<Schemas, Query>>;
+    records: Omit<DataRepository['records'], 'query' | 'pages' | 'all'> & {
+        query<const Query extends RecordsQuery>(query: Query & Checked<Schemas, Query>): Promise<Result<Schemas, Query>>;
         pages<const Query extends RecordsQuery>(query: Query & Checked<Schemas, Query>): AsyncIterable<Result<Schemas, Query>>;
         all<const Query extends RecordsQuery>(query: Query & Checked<Schemas, Query>, options: {
             maxRecords: number;

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

@@ -5,6 +5,7 @@ export declare const schema: import('./routine-definition-types.js').RoutineSche
 export declare const file: import('./routine-definition-types.js').RoutineFileSchema;
 export { AIError, RoutineAIError } from '../../../shared/routine-ai-contract.js';
 export type { RoutineAIOutputIssue } from '../../../shared/routine-ai-output-detail.js';
+export type { RoutineAIErrorDetail } from '../../../shared/routine-ai-error-detail.js';
 export { InboxContractError, asksBlock, continueAsk, defineHandler, fileBlock, question, recordBlock, recordsBlock, resolveAsk, respond, richTextBlock, selection, } 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';
@@ -152,6 +153,10 @@ export type StepDetail = {
     status: 'pending' | 'running' | 'completed' | 'failed' | 'skipped';
     startedAt?: string;
     finishedAt?: string;
+    progress?: {
+        completed: number;
+        total: number;
+    };
     summary?: unknown;
     data?: unknown;
 };

package/dist/types/packages/sdk/src/routine-definition-types.d.ts

@@ -20,6 +20,7 @@ export type RoutineAI = {
     generateText(input: {
         instructions: string;
         input: RoutineAIInput;
+        tools?: boolean;
     }): Promise<{
         text: string;
     }>;
@@ -28,6 +29,7 @@ export type RoutineAI = {
         instructions: string;
         input: RoutineAIInput;
         schema: Schema;
+        tools?: boolean;
     }): Promise<{
         object: RoutineSchemaValue<Schema>;
     }>;
@@ -72,6 +74,11 @@ type ConnectionName<Access extends RoutineAccess> = Access['connections'] extend
 export type RoutineCapabilities<Access extends RoutineAccess> = {
     readonly run: {
         readonly id: string;
+        /** Report completed work that OS capabilities and Step boundaries cannot observe. */
+        progress(value: {
+            completed: number;
+            total: number;
+        }): Promise<void>;
     };
     readonly ai: Access['ai'] extends true ? RoutineAI : {};
     readonly data: {

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

@@ -211,7 +211,7 @@ export interface DataRepository {
         schema(name: string): Promise<CollectionSchema>;
     };
     records: {
-        select<Query extends RecordsQuery>(query: Query): Promise<RecordsResult<Query>>;
+        query<Query extends RecordsQuery>(query: Query): Promise<RecordsResult<Query>>;
         pages<Query extends RecordsQuery>(query: Query): AsyncIterable<RecordsResult<Query>>;
         all<Query extends RecordsQuery>(query: Query, options: {
             maxRecords: number;

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

@@ -46,12 +46,19 @@ declare const fileValidationReasons: {
     invalid_size: string;
     invalid_request_key: string;
     invalid_enrichment_name: string;
+    invalid_enrichment_request: string;
     invalid_replacement: string;
     invalid_bytes: string;
     original_changed: string;
 };
+declare const localStorageReasons: {
+    local_storage_legacy: string;
+    local_storage_ambiguous: string;
+    local_storage_unrecognized: string;
+    local_storage_tracked: string;
+};
 export type FileErrorDetail = {
-    reason: keyof typeof fileValidationReasons | 'size_mismatch' | 'size_limit';
+    reason: keyof typeof fileValidationReasons | keyof typeof localStorageReasons | 'size_mismatch' | 'size_limit';
     expectedBytes?: number;
     receivedBytes?: number;
     limitBytes?: number;
@@ -60,8 +67,15 @@ export type FileErrorDetail = {
 /** 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 function fileErrorDetailForCode(code: FileErrorCode, detail: unknown): FileErrorDetail | undefined;
 export declare const FILE_CAPACITY_MESSAGE: string;
 export declare const FILE_INTEGRITY_MESSAGE: string;
+/** Shared SDK and terminal copy is derived only from bounded error facts. */
+export declare function fileErrorMessage(error: {
+    code: FileErrorCode;
+    retryable?: boolean;
+    detail?: unknown;
+}): string;
 export declare class FileOperationError extends Error {
     readonly code: FileErrorCode;
     readonly status: number;

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

@@ -1,6 +1,6 @@
 import { type AppValueSchema } from './app-routine-contract.js';
 import { type File } from './files-contract.js';
-import { type RoutineAIOutputIssue } from './routine-ai-output-detail.js';
+import { type RoutineAIErrorDetail } from './routine-ai-error-detail.js';
 /** Requests use the Run value bound; final answers use the same UTF-8 byte ceiling.
  * Raw Files have no universal AI byte cap: adapters must measure their final
  * encoded request against their own transport limit before dispatch. */
@@ -14,10 +14,10 @@ export type RoutineAIErrorCode = typeof ROUTINE_AI_ERROR_CODES[number];
 /** The original answer is explicit recovery data, never part of the message or JSON logging. */
 export declare class AIError extends Error {
     readonly code: RoutineAIErrorCode;
-    readonly detail?: RoutineAIOutputIssue;
+    readonly detail?: RoutineAIErrorDetail;
     readonly text?: string;
     constructor(code: RoutineAIErrorCode, options?: {
-        detail?: RoutineAIOutputIssue;
+        detail?: RoutineAIErrorDetail;
         text?: string;
     });
 }
@@ -26,7 +26,7 @@ export { AIError as RoutineAIError };
 /** Explicit private transport projection; ordinary error logging excludes answer text. */
 export declare function routineAIErrorFacts(error: AIError): {
     code: "access_denied" | "cancelled" | "capability_unavailable" | "file_unavailable" | "input_too_large" | "invalid_input" | "invalid_output" | "output_too_large" | "provider_failure" | "unsupported_file";
-    detail?: RoutineAIOutputIssue | undefined;
+    detail?: RoutineAIErrorDetail | undefined;
     text?: string | undefined;
 };
 export declare function parseRoutineAIError(value: unknown): AIError;
@@ -35,10 +35,12 @@ export type RoutineAIRequest = {
     kind: 'generateText';
     instructions: string;
     input: RoutineAIInput;
+    tools?: boolean;
 } | {
     kind: 'generateObject';
     instructions: string;
     input: RoutineAIInput;
+    tools?: boolean;
     schema: AppValueSchema;
 };
 /** Keep the existing successful transport shapes for deployed SDK compatibility. */

package/dist/types/shared/routine-ai-error-detail.d.ts

@@ -0,0 +1,19 @@
+import type { RoutineAIErrorCode } from './routine-ai-contract.js';
+import { type RoutineAIOutputIssue } from './routine-ai-output-detail.js';
+export type RoutineAIErrorDetail = RoutineAIOutputIssue | {
+    reason: 'turn_limit';
+    limit: number;
+} | {
+    reason: 'runner_exit';
+    exitCode?: number;
+} | {
+    reason: 'runner_error' | 'invalid_runner_response' | 'unexpected_runner_configuration';
+} | {
+    reason: 'invalid_tools' | 'tools_require_file';
+} | {
+    reason: 'unsupported_media_type';
+    mediaType: string;
+};
+/** Diagnostics are finite facts, never runner logs, model text or rejected values. */
+export declare function parseRoutineAIErrorDetail(code: RoutineAIErrorCode, value: unknown): RoutineAIErrorDetail | undefined;
+export declare function routineAIErrorMessage(code: RoutineAIErrorCode, value?: unknown): string;

package/dist/types/shared/routine-ai-output-detail.d.ts

@@ -5,6 +5,8 @@ export type RoutineAIOutputIssue = RoutineSchemaIssue | {
     reason: 'invalid_response';
 } | {
     reason: 'empty_text';
+} | {
+    reason: 'structured_output_limit';
 };
 /** Public explanations carry schema facts and types, never model values or unknown field names. */
 export declare function parseRoutineAIOutputIssue(value: unknown): RoutineAIOutputIssue | undefined;

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

@@ -18,7 +18,7 @@ export type RoutineDeclaration = {
     runtime: {
         features: [];
         resources: 'standard';
-        maxDuration: '15m';
+        maxDuration: '15m' | '60m';
     };
     retry: {
         maxAttempts: 1;

package/package.json

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