@oddington/sdk 0.1.21 → 0.1.22

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

@@ -4,6 +4,8 @@ import type { Connections } from '../../../shared/airtable-contract.js';
 import type { DataRepository } from '../../../shared/data-contract.js';
 import type { Handler } from '../../../shared/inbox-contract.js';
 import type { files, RoutinePublicationClient } from './public.js';
+import type { RoutineAccess } from '../../../shared/routine-definition-contract.js';
+export type { RoutineAccess } from '../../../shared/routine-definition-contract.js';
 declare const valueType: unique symbol;
 /** Serializable declaration; the phantom type never carries authority. */
 export type RoutineSchema<Value, Defaulted extends boolean = boolean> = AppValueSchema & {
@@ -12,13 +14,6 @@ export type RoutineSchema<Value, Defaulted extends boolean = boolean> = AppValue
     readonly hasDefault?: Defaulted;
 };
 export type RoutineSchemaValue<Schema> = Schema extends RoutineSchema<infer Value> ? Value : undefined;
-export type RoutineAccess = {
-    readonly repositories?: Readonly<Record<string, 'read' | 'write'>>;
-    readonly connections?: readonly string[];
-    readonly models?: readonly string[];
-    readonly files?: 'read' | 'read-write';
-    readonly publish?: readonly ('asks' | 'digests')[];
-};
 export type RoutineStepOutput = {
     summary: unknown;
     data: unknown;
@@ -104,4 +99,3 @@ export type RoutineSchemaBuilders = {
     boolean(): RoutineSchema<boolean, false>;
 };
 export type RoutineFileSchema = () => RoutineSchema<File, false>;
-export {};

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

@@ -11,8 +11,8 @@ 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.list' | 'questions.answer' | 'questions.searchRecords' | 'files.read';
 export declare function isAppQuestionOperation(operation: InboxOperation): boolean;
-/** Closed wire vocabulary. Hosts select the listing mode; input cannot select it. */
-export declare function parseInboxRequest(value: unknown, questionListContext?: 'local' | 'hosted'): {
+/** Closed wire vocabulary; both placements require an explicit relevance filter. */
+export declare function parseInboxRequest(value: unknown): {
     operation: InboxOperation;
     input: Record<string, unknown>;
 };

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

@@ -64,6 +64,7 @@ export type LinkedAskSnapshot = {
     done: boolean;
 };
 export interface InboxItem {
+    canonicalRoutineId?: string | null;
     id: string;
     workspaceId: string;
     number: number;
@@ -116,23 +117,20 @@ export interface ResponseAcceptance {
     acceptanceOrder?: number;
 }
 export interface AnswerableQuestion {
-    item: {
-        id: string;
-        number: number;
-        revision: number;
-        title: string;
-        href: string;
-    };
-    origin: {
-        routine: string;
-    };
-    question: {
+    itemId: string;
+    revision: number;
+    title: string;
+    inboxUrl: string;
+    questionId: string;
+    routine: string;
+    prompt: string;
+    instructions?: string;
+    response: ResponseDefinition;
+    answerable: boolean;
+    recordRefs: Array<{
+        repository: string;
         id: string;
-        prompt: string;
-        instructions: string | null;
-        response: ResponseDefinition;
-    };
-    recordRefs: string[];
+    }>;
 }
 export interface AskUpdate {
     item: InboxItem;
@@ -185,7 +183,7 @@ export interface InboxMember {
         }): Promise<RecipientAddition>;
     };
     questions: {
-        list(input?: InboxQuestionListInput): Promise<AnswerableQuestion[]>;
+        list(input: InboxQuestionListInput): Promise<AnswerableQuestion[]>;
         answer(input: InboxAnswerInput): Promise<ResponseAcceptance>;
         searchRecords(input: InboxSearchInput): Promise<RecordSelectionResult>;
     };

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

@@ -0,0 +1,33 @@
+import { type AppValueSchema } from './app-routine-contract.js';
+export type RoutineAccess = {
+    readonly repositories?: Readonly<Record<string, 'read' | 'write'>>;
+    readonly connections?: readonly string[];
+    readonly models?: readonly string[];
+    readonly files?: 'read' | 'read-write';
+    readonly publish?: readonly ('asks' | 'digests')[];
+};
+export type RoutineContract = {
+    id: string;
+    title?: string;
+    input: AppValueSchema;
+    inputDefault?: unknown;
+    access: RoutineAccess;
+    responses: {
+        id: string;
+    }[];
+    steps: {
+        id: string;
+        title: string;
+    }[];
+    result?: AppValueSchema;
+};
+export declare const routineTitle: (value: unknown) => value is string;
+export declare function freezeRoutineMetadata<Value>(value: Value): Value;
+/** Reject values JSON would drop, rewrite, or obtain by invoking authored code. */
+export declare function assertRoutineJson(value: unknown, ancestors?: Set<object>): void;
+/** Inspect property descriptors before reading authored metadata or functions. */
+export declare function assertRoutineFields(value: unknown, allowed?: string[]): asserts value is Record<string, any>;
+export declare function parseRoutineAccess(value: unknown): RoutineAccess;
+/** Inert report/admission grammar shared with authoring; imports no runtime or
+ * capability modules and never constructs executable customer functions. */
+export declare function parseRoutineDefinitionContract(value: unknown): RoutineContract;

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

@@ -0,0 +1,47 @@
+import type { RoutineSourceProvenance } from './routine-source-provenance.js';
+import type { RoutineContract } from './routine-definition-contract.js';
+export declare const ROUTINE_DECLARATION_SCHEMA = "https://schemas.oddington.ai/routine/v1.json";
+export declare const ROUTINE_SOURCE_LIMITS: {
+    files: number;
+    bytes: number;
+    declarationBytes: number;
+};
+export type RoutineDeclaration = {
+    $schema: typeof ROUTINE_DECLARATION_SCHEMA;
+    access: {
+        repositories: Record<string, 'read' | 'write'>;
+        connections: string[];
+        models: string[];
+        files?: 'read' | 'read-write';
+        publish: Array<'asks' | 'digests'>;
+    };
+    runtime: {
+        features: Array<'python' | 'documents' | 'browser'>;
+        resources: 'standard' | 'large';
+        maxDuration: string;
+    };
+    retry: {
+        maxAttempts: number;
+    };
+    assets: string[];
+};
+export type RoutineDeploymentSource = {
+    digest: string;
+    declaration: RoutineDeclaration;
+    definition?: {
+        entry: string;
+        contract: RoutineContract;
+    };
+    files: Array<{
+        path: string;
+        sha256: string;
+        size: number;
+    }>;
+    provenance?: RoutineSourceProvenance;
+};
+/** An authored definition has one fixed, private execution profile. */
+export declare function routineDefinitionDeclaration(contract: RoutineContract): RoutineDeclaration;
+export declare function routineDefinitionDirectory(entry: string): string;
+export declare const routineAlias: (value: unknown) => value is string;
+export declare function routineAssetPattern(value: unknown): value is string;
+export declare function parseRoutineDeclaration(value: unknown): RoutineDeclaration;

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

@@ -0,0 +1,6 @@
+export declare const isRoutineSourceDirectory: (value: string) => boolean;
+/** Both the collector and untrusted upload/build admission use this boundary. */
+export declare function eligibleDeploymentPath(path: string): boolean;
+/** Package metadata is admitted only at the root and selected direct child.
+ * Inventory parsing has no selection yet; sealing supplies the exact name. */
+export declare function eligibleDeploymentInputPath(path: string, routine?: string): boolean;

package/dist/types/shared/routine-source-provenance.d.ts

@@ -0,0 +1,7 @@
+/** Checkout evidence is descriptive and never selects routine authority. */
+export type RoutineSourceProvenance = {
+    branch?: string;
+    commit?: string;
+    dirty: boolean;
+};
+export declare function parseRoutineSourceProvenance(value: unknown): RoutineSourceProvenance;

package/package.json

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