@thyn-ai/sqai 0.1.1 → 0.1.3

package/dist/index.d.cts

@@ -140,12 +140,29 @@ interface RuntimeStatus {
     platform: string;
     managed: boolean;
 }
+/** A runtime bundle resolved for a specific module filter (build-on-provision). */
+interface FilteredBundle {
+    url: string;
+    sha256: string;
+    version: string;
+    cacheKey: string;
+}
 interface ProvisionerOptions {
     contract: CapabilityContract;
     autoInstall: boolean;
+    /**
+     * Build-on-provision: the developer's module filter. All 4,762 functions are
+     * available in the contract; only the selected modules are compiled + installed.
+     * Empty/undefined → the default pinned bundle (contract.runtime_bundle).
+     */
+    runtimeModules?: string[];
+    /** Build service that compiles a bundle for an exact filter (POST /v1/runtime/build). */
+    buildServiceUrl?: string;
     /** Injection points for tests. */
     runtimeFactory?: (config?: MojoRuntimeConfig) => MojoRuntime;
     downloadBundle?: (url: string, destination: string) => Promise<void>;
+    /** Resolve a filtered bundle (default: POST to buildServiceUrl). Test injection. */
+    resolveFilteredBundle?: (modules: string[], platformKey: string) => Promise<FilteredBundle>;
     /** Bundle cache directory (default: OS user cache — runtimeCacheDir()). */
     cacheDir?: string;
     /** Trust-root overrides (default: the embedded trust root). */
@@ -171,6 +188,27 @@ declare class RuntimeProvisioner {
     stop(): Promise<void>;
     private newRuntime;
     private cacheDir;
+    /** Normalized module filter (sorted, unique, non-empty) or null for the default bundle. */
+    private filterModules;
+    /** Ask the build service to compile + sign a bundle for exactly these modules. */
+    private resolveFilteredBundle;
+    /**
+     * The filter's cache key, computed IDENTICALLY to the build service
+     * (sha256("mods|platform|version")[:20], mods = sorted+unique, comma-joined).
+     * Lets the reuse fast-path find an already-running filtered daemon without a
+     * build-service round-trip. The build service's returned key is authoritative
+     * for install; this only has to match for the reuse optimization to hit.
+     */
+    private localCacheKey;
+    /**
+     * Deterministic per-filter daemon endpoint so a filtered runtime never collides
+     * with the default (or another filter's) daemon on the shared default socket.
+     */
+    private filterEndpoint;
+    private static readonly DAEMON_ENDPOINT_ENV;
+    /** Point the about-to-be-spawned daemon at a filter-specific socket/port/dir. */
+    private applyDaemonEndpointEnv;
+    private restoreEnv;
     private doEnsure;
     private provisionError;
     private wrapVerificationError;
@@ -179,7 +217,7 @@ declare class RuntimeProvisioner {
     private verifiedInstallOrNull;
     private acquireLock;
     private lockIsStale;
-    /** Serialize installers on `<cacheDir>/<version>.lock`; returns the verified install. */
+    /** Serialize installers on `<cacheDir>/<installKey>.lock`; returns the verified install. */
     private ensureInstalled;
     /** Holder-of-the-lock path: download → verify → extract → atomic rename. */
     private downloadVerifyExtract;
@@ -384,6 +422,15 @@ interface SqaiConfig {
     timeout?: number;
     maxRetries?: number;
     resultStore?: ResultStoreConfig;
+    /**
+     * Build-on-provision module filter. All 4,762 functions are available in the
+     * contract; set this to install only the modules you use. The build service
+     * compiles + signs a bundle for exactly this set (cached by filter-hash).
+     * Omit for the default pinned bundle. Env: SQAI_RUNTIME_MODULES (comma-separated).
+     */
+    runtimeModules?: string[];
+    /** Build service endpoint for filtered bundles. Env: SQAI_BUILD_SERVICE_URL. */
+    buildServiceUrl?: string;
     /** BYO substrate (tests). */
     runtime?: Runtime;
     /** BYO computation dispatch target (tests / custom self-hosted engines). */

package/dist/index.d.ts

@@ -140,12 +140,29 @@ interface RuntimeStatus {
     platform: string;
     managed: boolean;
 }
+/** A runtime bundle resolved for a specific module filter (build-on-provision). */
+interface FilteredBundle {
+    url: string;
+    sha256: string;
+    version: string;
+    cacheKey: string;
+}
 interface ProvisionerOptions {
     contract: CapabilityContract;
     autoInstall: boolean;
+    /**
+     * Build-on-provision: the developer's module filter. All 4,762 functions are
+     * available in the contract; only the selected modules are compiled + installed.
+     * Empty/undefined → the default pinned bundle (contract.runtime_bundle).
+     */
+    runtimeModules?: string[];
+    /** Build service that compiles a bundle for an exact filter (POST /v1/runtime/build). */
+    buildServiceUrl?: string;
     /** Injection points for tests. */
     runtimeFactory?: (config?: MojoRuntimeConfig) => MojoRuntime;
     downloadBundle?: (url: string, destination: string) => Promise<void>;
+    /** Resolve a filtered bundle (default: POST to buildServiceUrl). Test injection. */
+    resolveFilteredBundle?: (modules: string[], platformKey: string) => Promise<FilteredBundle>;
     /** Bundle cache directory (default: OS user cache — runtimeCacheDir()). */
     cacheDir?: string;
     /** Trust-root overrides (default: the embedded trust root). */
@@ -171,6 +188,27 @@ declare class RuntimeProvisioner {
     stop(): Promise<void>;
     private newRuntime;
     private cacheDir;
+    /** Normalized module filter (sorted, unique, non-empty) or null for the default bundle. */
+    private filterModules;
+    /** Ask the build service to compile + sign a bundle for exactly these modules. */
+    private resolveFilteredBundle;
+    /**
+     * The filter's cache key, computed IDENTICALLY to the build service
+     * (sha256("mods|platform|version")[:20], mods = sorted+unique, comma-joined).
+     * Lets the reuse fast-path find an already-running filtered daemon without a
+     * build-service round-trip. The build service's returned key is authoritative
+     * for install; this only has to match for the reuse optimization to hit.
+     */
+    private localCacheKey;
+    /**
+     * Deterministic per-filter daemon endpoint so a filtered runtime never collides
+     * with the default (or another filter's) daemon on the shared default socket.
+     */
+    private filterEndpoint;
+    private static readonly DAEMON_ENDPOINT_ENV;
+    /** Point the about-to-be-spawned daemon at a filter-specific socket/port/dir. */
+    private applyDaemonEndpointEnv;
+    private restoreEnv;
     private doEnsure;
     private provisionError;
     private wrapVerificationError;
@@ -179,7 +217,7 @@ declare class RuntimeProvisioner {
     private verifiedInstallOrNull;
     private acquireLock;
     private lockIsStale;
-    /** Serialize installers on `<cacheDir>/<version>.lock`; returns the verified install. */
+    /** Serialize installers on `<cacheDir>/<installKey>.lock`; returns the verified install. */
     private ensureInstalled;
     /** Holder-of-the-lock path: download → verify → extract → atomic rename. */
     private downloadVerifyExtract;
@@ -384,6 +422,15 @@ interface SqaiConfig {
     timeout?: number;
     maxRetries?: number;
     resultStore?: ResultStoreConfig;
+    /**
+     * Build-on-provision module filter. All 4,762 functions are available in the
+     * contract; set this to install only the modules you use. The build service
+     * compiles + signs a bundle for exactly this set (cached by filter-hash).
+     * Omit for the default pinned bundle. Env: SQAI_RUNTIME_MODULES (comma-separated).
+     */
+    runtimeModules?: string[];
+    /** Build service endpoint for filtered bundles. Env: SQAI_BUILD_SERVICE_URL. */
+    buildServiceUrl?: string;
     /** BYO substrate (tests). */
     runtime?: Runtime;
     /** BYO computation dispatch target (tests / custom self-hosted engines). */