@thyn-ai/sqai 0.1.2 → 0.1.4

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;
@@ -197,12 +235,14 @@ declare class RuntimeProvisioner {
 
 /** Contract-derived wire value: everything the computation plane can
  * transport. The wire schema transports; the capability contract authorizes. */
-type AlgentaWireValue = null | boolean | number | string | AlgentaWireValue[] | {
-    [key: string]: AlgentaWireValue;
+type SqaiValue = null | boolean | number | string | SqaiValue[] | {
+    [key: string]: SqaiValue;
 } | {
     type: "decimal" | "bigint";
     value: string;
 };
+/** @deprecated Renamed to {@link SqaiValue}. Kept as a non-breaking alias. */
+type AlgentaWireValue = SqaiValue;
 interface SqaiSource {
     name: string;
     source_id: string | null;
@@ -253,8 +293,8 @@ type ComputationBinding = {
 interface ComputationSpec {
     module: string;
     function: string;
-    args?: AlgentaWireValue[];
-    kwargs?: Record<string, AlgentaWireValue>;
+    args?: SqaiValue[];
+    kwargs?: Record<string, SqaiValue>;
     bindings?: ComputationBinding[];
     seed?: number | string;
 }
@@ -287,7 +327,7 @@ interface BindingProvenance {
 }
 interface ComputeResult {
     status: "ok";
-    value: AlgentaWireValue;
+    value: SqaiValue;
     value_type: string;
     module: string;
     function: string;
@@ -384,6 +424,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). */
@@ -438,11 +487,11 @@ declare function createSQAI(config?: SqaiConfig): SQAI;
 
 /** SQAI failure contract.
  *
- * Algenta error codes pass through verbatim (`source: "algenta"`); SQAI adds
+ * Algenta error codes pass through verbatim (`source: "engine"`); SQAI adds
  * its own codes in the same snake_case vocabulary (`source: "sqai"`). A code
  * is never renamed and the same condition never gets two codes.
  */
-type SqaiErrorSource = "algenta" | "sqai";
+type SqaiErrorSource = "engine" | "sqai";
 interface SqaiErrorOptions {
     retryable?: boolean;
     requestId?: string | null;
@@ -485,8 +534,8 @@ declare const SQAI_ERROR_CODES: readonly ["unsupported_operation", "seed_require
 interface InvocationIdentity {
     module: string;
     function: string;
-    args: AlgentaWireValue[];
-    kwargs: Record<string, AlgentaWireValue>;
+    args: SqaiValue[];
+    kwargs: Record<string, SqaiValue>;
     resolved_bindings: Array<{
         parameter: string | number;
         source_name: string;
@@ -539,17 +588,17 @@ declare class ResultStore {
 
 interface ResolvedBindingValue {
     parameter: string | number;
-    values: AlgentaWireValue;
+    values: SqaiValue;
     provenance: BindingProvenance;
 }
 interface ValidatedComputation {
     entry: CapabilityEntry;
     /** Final positional argument vector, ordered by the signature params. */
-    argsVector: AlgentaWireValue[];
+    argsVector: SqaiValue[];
     seed: number | string | null;
     bindings: ResolvedBindingValue[];
 }
 declare function lookupCapability(index: ContractIndex, module: string, functionName: string): CapabilityEntry;
 declare function validateComputation(spec: ComputationSpec, index: ContractIndex, policy: SqaiPolicy | undefined, resolvedBindings: ResolvedBindingValue[]): ValidatedComputation;
 
-export { type AlgentaWireValue, type AskOutcome, type BindingProvenance, type CapabilityContract, type CapabilityEntry, type CapabilityMatch, type ColumnExtract, type ComputationBinding, type ComputationSpec, type ComputeResult, ContractIndex, type DeterminismEnvelope, type InvocationIdentity, type QueryFilterCondition, type QueryFilterSpec, type QuerySpec, type ResolvedBindingValue, ResultStore, type ResultStoreConfig, RuntimeProvisioner, type RuntimeStatus, SQAI, SQAI_ERROR_CODES, type SqaiConfig, SqaiError, type SqaiErrorSource, type SqaiIntent, type SqaiOutcome, type SqaiPolicy, type SqaiResultRecord, type SqaiSource, type ValidatedComputation, computationHash, createSQAI, currentPlatformKey, invocationHash, isReadOnlyEligible, lookupCapability, runtimeCacheDir, validateComputation };
+export { type AlgentaWireValue, type AskOutcome, type BindingProvenance, type CapabilityContract, type CapabilityEntry, type CapabilityMatch, type ColumnExtract, type ComputationBinding, type ComputationSpec, type ComputeResult, ContractIndex, type DeterminismEnvelope, type InvocationIdentity, type QueryFilterCondition, type QueryFilterSpec, type QuerySpec, type ResolvedBindingValue, ResultStore, type ResultStoreConfig, RuntimeProvisioner, type RuntimeStatus, SQAI, SQAI_ERROR_CODES, type SqaiConfig, SqaiError, type SqaiErrorSource, type SqaiIntent, type SqaiOutcome, type SqaiPolicy, type SqaiResultRecord, type SqaiSource, type SqaiValue, type ValidatedComputation, computationHash, createSQAI, currentPlatformKey, invocationHash, isReadOnlyEligible, lookupCapability, runtimeCacheDir, validateComputation };

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;
@@ -197,12 +235,14 @@ declare class RuntimeProvisioner {
 
 /** Contract-derived wire value: everything the computation plane can
  * transport. The wire schema transports; the capability contract authorizes. */
-type AlgentaWireValue = null | boolean | number | string | AlgentaWireValue[] | {
-    [key: string]: AlgentaWireValue;
+type SqaiValue = null | boolean | number | string | SqaiValue[] | {
+    [key: string]: SqaiValue;
 } | {
     type: "decimal" | "bigint";
     value: string;
 };
+/** @deprecated Renamed to {@link SqaiValue}. Kept as a non-breaking alias. */
+type AlgentaWireValue = SqaiValue;
 interface SqaiSource {
     name: string;
     source_id: string | null;
@@ -253,8 +293,8 @@ type ComputationBinding = {
 interface ComputationSpec {
     module: string;
     function: string;
-    args?: AlgentaWireValue[];
-    kwargs?: Record<string, AlgentaWireValue>;
+    args?: SqaiValue[];
+    kwargs?: Record<string, SqaiValue>;
     bindings?: ComputationBinding[];
     seed?: number | string;
 }
@@ -287,7 +327,7 @@ interface BindingProvenance {
 }
 interface ComputeResult {
     status: "ok";
-    value: AlgentaWireValue;
+    value: SqaiValue;
     value_type: string;
     module: string;
     function: string;
@@ -384,6 +424,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). */
@@ -438,11 +487,11 @@ declare function createSQAI(config?: SqaiConfig): SQAI;
 
 /** SQAI failure contract.
  *
- * Algenta error codes pass through verbatim (`source: "algenta"`); SQAI adds
+ * Algenta error codes pass through verbatim (`source: "engine"`); SQAI adds
  * its own codes in the same snake_case vocabulary (`source: "sqai"`). A code
  * is never renamed and the same condition never gets two codes.
  */
-type SqaiErrorSource = "algenta" | "sqai";
+type SqaiErrorSource = "engine" | "sqai";
 interface SqaiErrorOptions {
     retryable?: boolean;
     requestId?: string | null;
@@ -485,8 +534,8 @@ declare const SQAI_ERROR_CODES: readonly ["unsupported_operation", "seed_require
 interface InvocationIdentity {
     module: string;
     function: string;
-    args: AlgentaWireValue[];
-    kwargs: Record<string, AlgentaWireValue>;
+    args: SqaiValue[];
+    kwargs: Record<string, SqaiValue>;
     resolved_bindings: Array<{
         parameter: string | number;
         source_name: string;
@@ -539,17 +588,17 @@ declare class ResultStore {
 
 interface ResolvedBindingValue {
     parameter: string | number;
-    values: AlgentaWireValue;
+    values: SqaiValue;
     provenance: BindingProvenance;
 }
 interface ValidatedComputation {
     entry: CapabilityEntry;
     /** Final positional argument vector, ordered by the signature params. */
-    argsVector: AlgentaWireValue[];
+    argsVector: SqaiValue[];
     seed: number | string | null;
     bindings: ResolvedBindingValue[];
 }
 declare function lookupCapability(index: ContractIndex, module: string, functionName: string): CapabilityEntry;
 declare function validateComputation(spec: ComputationSpec, index: ContractIndex, policy: SqaiPolicy | undefined, resolvedBindings: ResolvedBindingValue[]): ValidatedComputation;
 
-export { type AlgentaWireValue, type AskOutcome, type BindingProvenance, type CapabilityContract, type CapabilityEntry, type CapabilityMatch, type ColumnExtract, type ComputationBinding, type ComputationSpec, type ComputeResult, ContractIndex, type DeterminismEnvelope, type InvocationIdentity, type QueryFilterCondition, type QueryFilterSpec, type QuerySpec, type ResolvedBindingValue, ResultStore, type ResultStoreConfig, RuntimeProvisioner, type RuntimeStatus, SQAI, SQAI_ERROR_CODES, type SqaiConfig, SqaiError, type SqaiErrorSource, type SqaiIntent, type SqaiOutcome, type SqaiPolicy, type SqaiResultRecord, type SqaiSource, type ValidatedComputation, computationHash, createSQAI, currentPlatformKey, invocationHash, isReadOnlyEligible, lookupCapability, runtimeCacheDir, validateComputation };
+export { type AlgentaWireValue, type AskOutcome, type BindingProvenance, type CapabilityContract, type CapabilityEntry, type CapabilityMatch, type ColumnExtract, type ComputationBinding, type ComputationSpec, type ComputeResult, ContractIndex, type DeterminismEnvelope, type InvocationIdentity, type QueryFilterCondition, type QueryFilterSpec, type QuerySpec, type ResolvedBindingValue, ResultStore, type ResultStoreConfig, RuntimeProvisioner, type RuntimeStatus, SQAI, SQAI_ERROR_CODES, type SqaiConfig, SqaiError, type SqaiErrorSource, type SqaiIntent, type SqaiOutcome, type SqaiPolicy, type SqaiResultRecord, type SqaiSource, type SqaiValue, type ValidatedComputation, computationHash, createSQAI, currentPlatformKey, invocationHash, isReadOnlyEligible, lookupCapability, runtimeCacheDir, validateComputation };