@micrantha/react-native-amaryllis 0.1.0 → 0.1.5

package/lib/typescript/src/ContextPolicies.d.ts

@@ -0,0 +1,4 @@
+import type { ContextScorer } from './ContextTypes';
+export declare const DEFAULT_RECENCY_BIAS = 0.35;
+export declare const defaultContextScorer: ContextScorer;
+//# sourceMappingURL=ContextPolicies.d.ts.map

package/lib/typescript/src/ContextPolicies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContextPolicies.d.ts","sourceRoot":"","sources":["../../../src/ContextPolicies.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA6B,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/E,eAAO,MAAM,oBAAoB,OAAO,CAAC;AA4CzC,eAAO,MAAM,oBAAoB,EAAE,aAOlC,CAAC"}

package/lib/typescript/src/ContextTypes.d.ts

@@ -0,0 +1,92 @@
+import type { LlmRequestParams } from './Types';
+export type EvictionStrategy = 'lru' | 'recency' | 'size';
+export interface MediaReference {
+    uri: string;
+    mimeType?: string;
+    sizeBytes?: number;
+    width?: number;
+    height?: number;
+}
+export interface MediaValidationPolicy {
+    requireAbsoluteUri?: boolean;
+    allowedUriSchemes?: string[];
+    maxMediaBytes?: number;
+    maxMediaWidth?: number;
+    maxMediaHeight?: number;
+}
+export interface ContextItem {
+    id: string;
+    text: string;
+    metadata?: Record<string, string>;
+    tags?: string[];
+    media?: MediaReference[];
+    createdAt: number;
+    updatedAt?: number;
+    ttlSeconds?: number;
+}
+export interface ContextQuery {
+    text: string;
+    limit?: number;
+    filters?: Record<string, string>;
+    tags?: string[];
+    recencyBias?: number;
+    useSemantic?: boolean;
+}
+export interface ContextPolicy {
+    maxBytes?: number;
+    maxItems?: number;
+    defaultTtlSeconds?: number;
+    evictionStrategy?: EvictionStrategy;
+    media?: MediaValidationPolicy;
+}
+export interface ContextStoreStats {
+    itemCount: number;
+    totalBytes?: number;
+}
+export interface ContextStore {
+    put(items: ContextItem[]): Promise<void>;
+    query(query: ContextQuery): Promise<ContextItem[]>;
+    delete(ids: string[]): Promise<void>;
+    compact(policy: ContextPolicy): Promise<void>;
+    stats(): Promise<ContextStoreStats>;
+}
+export interface EmbeddingProvider {
+    embed(texts: string[]): Promise<number[][]>;
+    dimension?: number;
+}
+export interface ContextEngine {
+    add(items: ContextItem[]): Promise<void>;
+    search(query: ContextQuery): Promise<ContextItem[]>;
+    setPolicy(policy: ContextPolicy): void;
+    compact(): Promise<void>;
+    formatRequest(params: ContextFormatParams): LlmRequestParams;
+    deriveQuery(prompt: string, request: LlmRequestParams): ContextQuery | undefined;
+}
+export interface ContextScorer {
+    score(item: ContextItem, query: ContextQuery): number;
+}
+export interface ContextEngineOptions {
+    store: ContextStore;
+    scorer?: ContextScorer;
+    policy?: ContextPolicy;
+    formatter?: ContextRequestFormatter;
+    defaultQueryFactory?: ContextDefaultQueryFactory;
+}
+export interface ContextFormatParams {
+    prompt: string;
+    items: ContextItem[];
+    query?: ContextQuery;
+    request: LlmRequestParams;
+}
+export type ContextRequestFormatter = (params: ContextFormatParams) => LlmRequestParams;
+export type ContextDefaultQueryFactory = (prompt: string, request: LlmRequestParams) => ContextQuery | undefined;
+export interface ToolDefinition {
+    name: string;
+    description?: string;
+    inputSchema?: Record<string, unknown>;
+}
+export interface ToolRegistry {
+    register(tool: ToolDefinition): void;
+    invoke(name: string, input: unknown): Promise<unknown>;
+}
+//# sourceMappingURL=ContextTypes.d.ts.map

package/lib/typescript/src/ContextTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContextTypes.d.ts","sourceRoot":"","sources":["../../../src/ContextTypes.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/ContextValidation.d.ts

@@ -0,0 +1,9 @@
+import type { ContextItem, ContextPolicy, ContextQuery, MediaReference, MediaValidationPolicy } from './ContextTypes';
+export declare const validateContextPolicy: (policy: ContextPolicy | undefined) => void;
+export declare const validateMediaPolicy: (policy: MediaValidationPolicy | undefined) => void;
+export declare const validateMediaReference: (reference: MediaReference, policy?: MediaValidationPolicy) => void;
+export declare const validateMediaReferences: (references: MediaReference[] | undefined, policy?: MediaValidationPolicy) => void;
+export declare const validateContextItem: (item: ContextItem, policy?: ContextPolicy) => void;
+export declare const validateContextItems: (items: ContextItem[], policy?: ContextPolicy) => void;
+export declare const validateContextQuery: (query: ContextQuery) => void;
+//# sourceMappingURL=ContextValidation.d.ts.map

package/lib/typescript/src/ContextValidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContextValidation.d.ts","sourceRoot":"","sources":["../../../src/ContextValidation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EACb,YAAY,EACZ,cAAc,EACd,qBAAqB,EACtB,MAAM,gBAAgB,CAAC;AAqCxB,eAAO,MAAM,qBAAqB,GAChC,QAAQ,aAAa,GAAG,SAAS,KAChC,IAkCF,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,qBAAqB,GAAG,SAAS,KACxC,IA0BF,CAAC;AAEF,eAAO,MAAM,sBAAsB,GACjC,WAAW,cAAc,EACzB,SAAS,qBAAqB,KAC7B,IAuEF,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAClC,YAAY,cAAc,EAAE,GAAG,SAAS,EACxC,SAAS,qBAAqB,KAC7B,IAWF,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAC9B,MAAM,WAAW,EACjB,SAAS,aAAa,KACrB,IAoCF,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,OAAO,WAAW,EAAE,EACpB,SAAS,aAAa,KACrB,IAQF,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,OAAO,YAAY,KAAG,IAqB1D,CAAC"}

package/lib/typescript/src/Errors.d.ts

@@ -0,0 +1,22 @@
+export declare class AmaryllisError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+}
+export declare class InitializationError extends AmaryllisError {
+    constructor(message: string);
+}
+export declare class GenerationError extends AmaryllisError {
+    constructor(message: string);
+}
+export declare class SessionError extends AmaryllisError {
+    constructor(message: string);
+}
+export declare class ValidationError extends AmaryllisError {
+    constructor(message: string);
+}
+export declare class ResourceError extends AmaryllisError {
+    constructor(message: string);
+}
+export declare function isAmaryllisError(error: unknown): error is AmaryllisError;
+export declare function createError(message: string, code?: string): AmaryllisError;
+//# sourceMappingURL=Errors.d.ts.map

package/lib/typescript/src/Errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Errors.d.ts","sourceRoot":"","sources":["../../../src/Errors.ts"],"names":[],"mappings":"AAAA,qBAAa,cAAe,SAAQ,KAAK;aAGrB,IAAI,EAAE,MAAM;gBAD5B,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM;CAK/B;AAED,qBAAa,mBAAoB,SAAQ,cAAc;gBACzC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,eAAgB,SAAQ,cAAc;gBACrC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,YAAa,SAAQ,cAAc;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,eAAgB,SAAQ,cAAc;gBACrC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,aAAc,SAAQ,cAAc;gBACnC,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAExE;AAED,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAwB,GAC7B,cAAc,CAEhB"}

package/lib/typescript/src/NativeAmaryllis.d.ts

@@ -1,9 +1,29 @@
 import type { TurboModule } from 'react-native';
 export interface Spec extends TurboModule {
-    init(params: Object): Promise<void>;
-    newSession(params: Object): Promise<void>;
-    generate(params: Object): Promise<string>;
-    generateAsync(params: Object): Promise<void>;
+    init(params: {
+        modelPath: string;
+        maxTopK?: number;
+        maxNumImages?: number;
+        maxTokens?: number;
+        visionEncoderPath?: string;
+        visionAdapterPath?: string;
+    }): Promise<void>;
+    newSession(params?: {
+        topK?: number;
+        topP?: number;
+        temperature?: number;
+        randomSeed?: number;
+        loraPath?: string;
+        enableVisionModality?: boolean;
+    }): Promise<void>;
+    generate(params: {
+        prompt: string;
+        images?: string[];
+    }): Promise<string>;
+    generateAsync(params: {
+        prompt: string;
+        images?: string[];
+    }): Promise<void>;
     close(): void;
     cancelAsync(): void;
 }

package/lib/typescript/src/NativeAmaryllis.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NativeAmaryllis.d.ts","sourceRoot":"","sources":["../../../src/NativeAmaryllis.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE1C,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7C,KAAK,IAAI,IAAI,CAAC;IAEd,WAAW,IAAI,IAAI,CAAC;CACrB;;AAED,wBAAmE"}
+{"version":3,"file":"NativeAmaryllis.d.ts","sourceRoot":"","sources":["../../../src/NativeAmaryllis.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,IAAI,CAAC,MAAM,EAAE;QACX,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElB,UAAU,CAAC,MAAM,CAAC,EAAE;QAClB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,oBAAoB,CAAC,EAAE,OAAO,CAAC;KAChC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElB,QAAQ,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEzE,aAAa,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5E,KAAK,IAAI,IAAI,CAAC;IAEd,WAAW,IAAI,IAAI,CAAC;CACrB;;AAED,wBAAmE"}

package/lib/typescript/src/TypeConverters.d.ts

@@ -0,0 +1,43 @@
+import type { LlmEngineConfig, LlmSessionParams, LlmRequestParams } from './Types';
+/**
+ * Convert rich LlmEngineConfig to codegen-compatible object structure
+ */
+export declare function toNativeEngineConfig(config: LlmEngineConfig): {
+    modelPath: string;
+    maxTopK: number | undefined;
+    maxNumImages: number | undefined;
+    maxTokens: number | undefined;
+    visionEncoderPath: string | undefined;
+    visionAdapterPath: string | undefined;
+};
+/**
+ * Convert codegen-compatible config object to rich LlmEngineConfig
+ */
+export declare function fromNativeEngineConfig(native: any): LlmEngineConfig;
+/**
+ * Convert rich LlmSessionParams to codegen-compatible object structure
+ */
+export declare function toNativeSessionParams(params?: LlmSessionParams): {
+    topK: number | undefined;
+    topP: number | undefined;
+    temperature: number | undefined;
+    randomSeed: number | undefined;
+    loraPath: string | undefined;
+    enableVisionModality: boolean | undefined;
+} | undefined;
+/**
+ * Convert codegen-compatible session object to rich LlmSessionParams
+ */
+export declare function fromNativeSessionParams(native?: any): LlmSessionParams | undefined;
+/**
+ * Convert rich LlmRequestParams to codegen-compatible object structure
+ */
+export declare function toNativeRequestParams(params: LlmRequestParams): {
+    prompt: string;
+    images: string[] | undefined;
+};
+/**
+ * Convert codegen-compatible request object to rich LlmRequestParams
+ */
+export declare function fromNativeRequestParams(native: any): LlmRequestParams;
+//# sourceMappingURL=TypeConverters.d.ts.map

package/lib/typescript/src/TypeConverters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypeConverters.d.ts","sourceRoot":"","sources":["../../../src/TypeConverters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe;;;;;;;EAS3D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,GAAG,GAAG,eAAe,CASnE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,gBAAgB;;;;;;;cAW9D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,CAAC,EAAE,GAAG,GACX,gBAAgB,GAAG,SAAS,CAW9B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,gBAAgB;;;EAK7D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,GAAG,GAAG,gBAAgB,CAKrE"}

package/lib/typescript/src/Types.d.ts

@@ -1,9 +1,23 @@
 import type { Spec } from './NativeAmaryllis';
 import type { Observable } from 'rxjs';
 export type LlmNativeEngine = Spec;
+export type LlmEvent = {
+    type: 'partial';
+    text: string;
+} | {
+    type: 'final';
+    text: string;
+} | {
+    type: 'error';
+    error: Error;
+};
 export type LlmCallbacks = {
+    onEvent?: (event: LlmEvent) => void;
+    /** @deprecated Use onEvent instead. */
     onPartialResult?: (result: string) => void;
+    /** @deprecated Use onEvent instead. */
     onFinalResult?: (result: string) => void;
+    /** @deprecated Use onEvent instead. */
     onError?: (err: Error) => void;
 };
 export type LlmRequestParams = {

package/lib/typescript/src/Types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Types.d.ts","sourceRoot":"","sources":["../../../src/Types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Types.d.ts","sourceRoot":"","sources":["../../../src/Types.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/context.d.ts

@@ -0,0 +1,8 @@
+export { ContextEngine, createContextEngine, defaultContextFormatter, } from './ContextEngine';
+export * from './ContextEngineContext';
+export * from './ContextPolicies';
+export * from './ContextValidation';
+export { useContextInference, useContextInferenceAsync, } from './AmaryllisHooks';
+export type { ContextInferenceProps } from './AmaryllisHooks';
+export type * from './ContextTypes';
+//# sourceMappingURL=context.d.ts.map

package/lib/typescript/src/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AACzB,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,OAAO,EACL,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC9D,mBAAmB,gBAAgB,CAAC"}

package/lib/typescript/src/index.d.ts

@@ -2,5 +2,10 @@ export { default as Amaryllis, LlmPipe } from './Amaryllis';
 export * from './AmaryllisHooks';
 export * from './AmaryllisContext';
 export * from './AmaryllisRx';
+export { createContextEngine } from './ContextEngine';
+export * from './ContextEngineContext';
+export * from './ContextPolicies';
+export * from './ContextValidation';
+export type * from './ContextTypes';
 export type * from './Types';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC5D,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,mBAAmB,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC5D,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,mBAAmB,gBAAgB,CAAC;AACpC,mBAAmB,SAAS,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@micrantha/react-native-amaryllis",
-  "version": "0.1.0",
-  "description": "A AI module for native mobile in react",
+  "version": "0.1.5",
+  "description": "A generative AI module for native mobile",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
   "exports": {
@@ -10,6 +10,11 @@
       "types": "./lib/typescript/src/index.d.ts",
       "default": "./lib/module/index.js"
     },
+    "./context": {
+      "source": "./src/context.ts",
+      "types": "./lib/typescript/src/context.d.ts",
+      "default": "./lib/module/context.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -48,44 +53,45 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/hackelia-micrantha/react-native-amaryllis.git"
+    "url": "git+https://github.com/hackelia-micrantha/amaryllis.git"
   },
   "author": "Ryan Jennings <ryan.jennings@micrantha.com> (https://github.com/hackelia-micrantha)",
   "license": "MIT",
   "bugs": {
-    "url": "https://github.com/hackelia-micrantha/react-native-amaryllis/issues"
+    "url": "https://github.com/hackelia-micrantha/amaryllis/issues"
   },
-  "homepage": "https://github.com/hackelia-micrantha/react-native-amaryllis#readme",
+  "homepage": "https://github.com/hackelia-micrantha/amaryllis#readme",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/"
   },
   "devDependencies": {
-    "@commitlint/config-conventional": "^19.8.1",
-    "@eslint/compat": "^1.3.2",
-    "@eslint/eslintrc": "^3.3.1",
-    "@eslint/js": "^9.35.0",
-    "@evilmartians/lefthook": "^1.12.3",
-    "@react-native-community/cli": "20.0.1",
-    "@react-native/babel-preset": "0.81.1",
-    "@react-native/eslint-config": "^0.81.1",
-    "@release-it/conventional-changelog": "^10.0.1",
+    "@commitlint/config-conventional": "^20.3.1",
+    "@eslint/compat": "^2.0.1",
+    "@eslint/eslintrc": "^3.3.3",
+    "@eslint/js": "^9.39.2",
+    "@evilmartians/lefthook": "^2.0.15",
+    "@react-native-community/cli": "20.1.0",
+    "@react-native/babel-preset": "0.83.1",
+    "@react-native/eslint-config": "^0.83.1",
+    "@release-it/conventional-changelog": "^10.0.4",
     "@testing-library/react-native": "^13.3.3",
     "@types/jest": "^30.0.0",
-    "@types/react": "^19.1.12",
-    "commitlint": "^19.8.1",
-    "del-cli": "^6.0.0",
-    "eslint": "^9.35.0",
+    "@types/react": "^19.2.8",
+    "commitlint": "^20.3.1",
+    "del-cli": "^7.0.0",
+    "eslint": "^9.39.2",
     "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-prettier": "^5.5.4",
-    "jest": "^30.1.3",
-    "prettier": "^3.6.2",
-    "react": "19.1.1",
-    "react-native": "0.81.1",
-    "react-native-builder-bob": "^0.40.13",
-    "react-test-renderer": "19.1.1",
-    "release-it": "^19.0.4",
-    "turbo": "^2.5.6",
-    "typescript": "^5.9.2"
+    "eslint-plugin-ft-flow": "^3.0.11",
+    "eslint-plugin-prettier": "^5.5.5",
+    "jest": "^30.2.0",
+    "prettier": "^3.8.0",
+    "react": "19.2.3",
+    "react-native": "0.83.1",
+    "react-native-builder-bob": "^0.40.17",
+    "react-test-renderer": "19.2.3",
+    "release-it": "^19.2.3",
+    "turbo": "^2.7.5",
+    "typescript": "^5.9.3"
   },
   "peerDependencies": {
     "react": "*",

package/src/Amaryllis.ts

@@ -9,6 +9,11 @@ import type {
   LlmPipeParams,
   LlmNativeEngine,
 } from './Types';
+import {
+  toNativeEngineConfig,
+  toNativeSessionParams,
+  toNativeRequestParams,
+} from './TypeConverters';
 
 const EVENT_ON_PARTIAL_RESULT = 'onPartialResult';
 const EVENT_ON_FINAL_RESULT = 'onFinalResult';
@@ -25,15 +30,18 @@ export class LlmPipe implements LlmEngine {
   }
 
   async init(params: LlmEngineConfig): Promise<void> {
-    await this.llmNative.init(params);
+    const nativeConfig = toNativeEngineConfig(params);
+    await this.llmNative.init(nativeConfig);
   }
 
   newSession(params: LlmSessionParams): Promise<void> {
-    return this.llmNative.newSession(params);
+    const nativeParams = toNativeSessionParams(params);
+    return this.llmNative.newSession(nativeParams);
   }
 
   async generate(params: LlmRequestParams): Promise<string> {
-    return await this.llmNative.generate(params);
+    const nativeParams = toNativeRequestParams(params);
+    return await this.llmNative.generate(nativeParams);
   }
 
   async generateAsync(
@@ -44,46 +52,89 @@ export class LlmPipe implements LlmEngine {
       this.setupAsyncCallbacks(callbacks);
     }
 
-    return await this.llmNative.generateAsync(params);
+    const nativeParams = toNativeRequestParams(params);
+    return await this.llmNative.generateAsync(nativeParams);
   }
 
   close(): void {
-    this.llmNative.close();
     this.cancelAsync();
+    this.llmNative.close();
   }
 
   cancelAsync(): void {
     this.llmNative.cancelAsync();
-    this.subscriptions.forEach((sub) => sub.remove());
+    const subsToRemove = [...this.subscriptions];
+    this.subscriptions = [];
+    subsToRemove.forEach((sub) => {
+      try {
+        sub.remove();
+      } catch (error) {
+        console.warn('Failed to remove subscription:', error);
+      }
+    });
   }
 
   setupAsyncCallbacks(callbacks: LlmCallbacks): void {
-    if (callbacks.onPartialResult) {
-      this.subscriptions.push(
-        this.llmEmitter.addListener(
-          EVENT_ON_PARTIAL_RESULT,
-          (result: string) => {
+    if (callbacks.onPartialResult || callbacks.onEvent) {
+      const subscription = this.llmEmitter.addListener(
+        EVENT_ON_PARTIAL_RESULT,
+        (result: string) => {
+          try {
+            callbacks.onEvent?.({ type: 'partial', text: result });
+          } catch (error) {
+            console.error('Error in onEvent callback:', error);
+          }
+          try {
             callbacks.onPartialResult?.(result);
+          } catch (error) {
+            console.error('Error in onPartialResult callback:', error);
           }
-        )
+        }
       );
+      this.subscriptions.push(subscription);
     }
 
-    if (callbacks.onFinalResult) {
-      this.subscriptions.push(
-        this.llmEmitter.addListener(EVENT_ON_FINAL_RESULT, (result: string) => {
-          callbacks.onFinalResult?.(result);
-          this.cancelAsync();
-        })
+    if (callbacks.onFinalResult || callbacks.onEvent) {
+      const subscription = this.llmEmitter.addListener(
+        EVENT_ON_FINAL_RESULT,
+        (result: string) => {
+          try {
+            callbacks.onEvent?.({ type: 'final', text: result });
+          } catch (error) {
+            console.error('Error in onEvent callback:', error);
+          }
+          try {
+            callbacks.onFinalResult?.(result);
+          } catch (error) {
+            console.error('Error in onFinalResult callback:', error);
+          } finally {
+            this.cancelAsync();
+          }
+        }
       );
+      this.subscriptions.push(subscription);
     }
-    if (callbacks.onError) {
-      this.subscriptions.push(
-        this.llmEmitter.addListener(EVENT_ON_ERROR, (error: string) => {
-          callbacks.onError?.(new Error(error));
-          this.cancelAsync();
-        })
+
+    if (callbacks.onError || callbacks.onEvent) {
+      const subscription = this.llmEmitter.addListener(
+        EVENT_ON_ERROR,
+        (error: string) => {
+          const errorObj = new Error(error);
+          try {
+            callbacks.onEvent?.({ type: 'error', error: errorObj });
+          } catch (callbackError) {
+            console.error('Error in onEvent callback:', callbackError);
+          }
+          try {
+            callbacks.onError?.(errorObj);
+          } catch (callbackError) {
+            console.error('Error in onError callback:', callbackError);
+          } finally {
+            this.cancelAsync();
+          }
+        }
       );
+      this.subscriptions.push(subscription);
     }
   }
 }

package/src/AmaryllisContext.tsx

@@ -1,6 +1,7 @@
 import { createContext, useContext, useEffect, useMemo, useState } from 'react';
 import type { LLMContextValue, LLMProviderProps } from './Types';
 import { newLlmPipe } from './NativePipe';
+import { InitializationError, isAmaryllisError } from './Errors';
 
 const LLMContext = createContext<LLMContextValue>({
   config: null,
@@ -26,23 +27,37 @@ export const LLMProvider = ({
     try {
       return llmPipe ?? newLlmPipe();
     } catch (e: any) {
-      setError(e);
+      const initError = isAmaryllisError(e)
+        ? e
+        : new InitializationError(e?.message || 'Failed to create LLM pipe');
+      setError(initError);
       return null;
     }
   }, [llmPipe]);
 
   useEffect(() => {
     const start = async () => {
+      if (!controller) return;
+
       try {
-        await controller?.init(config);
+        await controller.init(config);
         setReady(true);
       } catch (e: any) {
         console.error('unable to start amaryllis', e);
-        setError(e);
+        const initError = isAmaryllisError(e)
+          ? e
+          : new InitializationError(e?.message || 'Failed to initialize LLM');
+        setError(initError);
       }
     };
     start();
-    return () => controller?.close();
+    return () => {
+      try {
+        controller?.close();
+      } catch (e: any) {
+        console.warn('Error closing LLM controller:', e);
+      }
+    };
   }, [config, controller]);
 
   return (