@makaio/contracts 1.0.0-dev-1779051654000

package/dist/variant/namespace.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Variant namespace definition.
+ * Provides typed subjects for variant detection and upgrade operations.
+ */
+export declare const VariantNamespace: import("@makaio/framework/core").BusNamespaceDefinition<"host:variant", {
+    getInfo: {
+        request: import("zod").ZodObject<{}, import("zod/v4/core").$strip>;
+        response: import("zod").ZodObject<{
+            variant: import("zod").ZodEnum<{
+                base: "base";
+                cef: "cef";
+            }>;
+            bundleCEF: import("zod").ZodBoolean;
+            defaultRenderer: import("zod").ZodEnum<{
+                cef: "cef";
+                native: "native";
+            }>;
+        }, import("zod/v4/core").$strip>;
+    };
+    requestUpgrade: {
+        request: import("zod").ZodObject<{
+            targetVariant: import("zod").ZodEnum<{
+                base: "base";
+                cef: "cef";
+            }>;
+        }, import("zod/v4/core").$strip>;
+        response: import("zod").ZodUnion<readonly [import("zod").ZodObject<{
+            accepted: import("zod").ZodLiteral<true>;
+            downloadSizeBytes: import("zod").ZodOptional<import("zod").ZodNumber>;
+            message: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+            accepted: import("zod").ZodLiteral<false>;
+            message: import("zod").ZodString;
+        }, import("zod/v4/core").$strip>]>;
+    };
+    upgradeProgress: import("zod").ZodObject<{
+        status: import("zod").ZodEnum<{
+            applying: "applying";
+            complete: "complete";
+            downloading: "downloading";
+            error: "error";
+            progress: "progress";
+        }>;
+        percent: import("zod").ZodOptional<import("zod").ZodNumber>;
+        message: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>;
+}>;
+/**
+ * Variant subjects for type-safe bus operations.
+ * Use these with MakaioBus.request(), MakaioBus.on(), etc.
+ */
+export declare const VariantSubjects: import("@makaio/framework/core").BusSubjects<import("@makaio/framework/core").FlatSubjectDefinitions<"host:variant", {
+    getInfo: {
+        request: import("zod").ZodObject<{}, import("zod/v4/core").$strip>;
+        response: import("zod").ZodObject<{
+            variant: import("zod").ZodEnum<{
+                base: "base";
+                cef: "cef";
+            }>;
+            bundleCEF: import("zod").ZodBoolean;
+            defaultRenderer: import("zod").ZodEnum<{
+                cef: "cef";
+                native: "native";
+            }>;
+        }, import("zod/v4/core").$strip>;
+    };
+    requestUpgrade: {
+        request: import("zod").ZodObject<{
+            targetVariant: import("zod").ZodEnum<{
+                base: "base";
+                cef: "cef";
+            }>;
+        }, import("zod/v4/core").$strip>;
+        response: import("zod").ZodUnion<readonly [import("zod").ZodObject<{
+            accepted: import("zod").ZodLiteral<true>;
+            downloadSizeBytes: import("zod").ZodOptional<import("zod").ZodNumber>;
+            message: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+            accepted: import("zod").ZodLiteral<false>;
+            message: import("zod").ZodString;
+        }, import("zod/v4/core").$strip>]>;
+    };
+    upgradeProgress: import("zod").ZodObject<{
+        status: import("zod").ZodEnum<{
+            applying: "applying";
+            complete: "complete";
+            downloading: "downloading";
+            error: "error";
+            progress: "progress";
+        }>;
+        percent: import("zod").ZodOptional<import("zod").ZodNumber>;
+        message: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>;
+}>, "host:variant">;
+//# sourceMappingURL=namespace.d.ts.map

package/dist/variant/namespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace.d.ts","sourceRoot":"","sources":["../../src/variant/namespace.ts"],"names":[],"mappings":"AA0BA;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAqD,CAAC;AAEnF;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAA4B,CAAC"}

package/dist/variant/schemas.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Variant bus schemas — pure Zod, no side effects.
+ *
+ * Defines Zod schemas for the `host:variant.*` bus namespace, which lets extensions
+ * query which build variant (base/cef) the Electrobun host is running. This
+ * namespace is host-specific: only the Electrobun desktop host registers
+ * handlers for it.
+ *
+ * Import this module when you only need types or validation shapes without
+ * registering the namespace on the bus. To register the namespace and obtain
+ * typed subjects, import `./namespace` instead.
+ * @packageDocumentation
+ */
+import { z } from 'zod';
+/**
+ * Supported build variant identifiers for the Electrobun desktop host.
+ *
+ * - `'base'` — system WebView (no bundled CEF)
+ * - `'cef'` — Chromium Embedded Framework bundled into the distributable
+ */
+export declare const MakaioVariantSchema: z.ZodEnum<{
+    base: "base";
+    cef: "cef";
+}>;
+/** Inferred TypeScript type for a variant identifier. */
+export type MakaioVariant = z.infer<typeof MakaioVariantSchema>;
+/**
+ * Upgrade status values emitted during a variant upgrade operation.
+ *
+ * - `'downloading'` — initiating download
+ * - `'progress'` — download in progress
+ * - `'applying'` — applying the downloaded files
+ * - `'complete'` — upgrade finished successfully
+ * - `'error'` — upgrade failed
+ */
+export declare const VariantUpgradeStatusSchema: z.ZodEnum<{
+    applying: "applying";
+    complete: "complete";
+    downloading: "downloading";
+    error: "error";
+    progress: "progress";
+}>;
+/** Inferred TypeScript type for an upgrade status value. */
+export type VariantUpgradeStatus = z.infer<typeof VariantUpgradeStatusSchema>;
+/**
+ * Variant domain bus schemas.
+ *
+ * Each key becomes a subject identifier as `host:variant.<key>`.
+ */
+export declare const VariantSchemas: {
+    /**
+     * Query the current variant configuration from the host.
+     *
+     * Request: empty — the handler reads the resolved variant at startup.
+     * Response: full variant info — identifier, CEF-bundle flag, and default renderer.
+     *
+     * Subject: `host:variant.getInfo`
+     * Type: Request (RPC)
+     */
+    getInfo: {
+        request: z.ZodObject<{}, z.core.$strip>;
+        response: z.ZodObject<{
+            variant: z.ZodEnum<{
+                base: "base";
+                cef: "cef";
+            }>;
+            bundleCEF: z.ZodBoolean;
+            defaultRenderer: z.ZodEnum<{
+                cef: "cef";
+                native: "native";
+            }>;
+        }, z.core.$strip>;
+    };
+    /**
+     * Request a variant switch on the host.
+     *
+     * The host may accept or decline the request. When accepted it may report
+     * the estimated download size so the caller can display a confirmation UI.
+     * A declined response must include a human-readable `message` explaining why.
+     *
+     * Subject: `host:variant.requestUpgrade`
+     * Type: Request (RPC)
+     */
+    requestUpgrade: {
+        request: z.ZodObject<{
+            targetVariant: z.ZodEnum<{
+                base: "base";
+                cef: "cef";
+            }>;
+        }, z.core.$strip>;
+        response: z.ZodUnion<readonly [z.ZodObject<{
+            accepted: z.ZodLiteral<true>;
+            downloadSizeBytes: z.ZodOptional<z.ZodNumber>;
+            message: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            accepted: z.ZodLiteral<false>;
+            message: z.ZodString;
+        }, z.core.$strip>]>;
+    };
+    /**
+     * Emitted by the host while a variant upgrade is in progress.
+     *
+     * Consumers subscribe to track download and apply progress for display
+     * in the UI (e.g. a progress bar).
+     *
+     * Subject: `host:variant.upgradeProgress`
+     * Type: Event
+     */
+    upgradeProgress: z.ZodObject<{
+        status: z.ZodEnum<{
+            applying: "applying";
+            complete: "complete";
+            downloading: "downloading";
+            error: "error";
+            progress: "progress";
+        }>;
+        percent: z.ZodOptional<z.ZodNumber>;
+        message: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+};
+/** Response payload for `host:variant.getInfo`. */
+export type VariantGetInfoResponse = z.infer<(typeof VariantSchemas)['getInfo']['response']>;
+/** Request payload for `host:variant.requestUpgrade`. */
+export type VariantRequestUpgradeRequest = z.infer<(typeof VariantSchemas)['requestUpgrade']['request']>;
+/** Response payload for `host:variant.requestUpgrade`. */
+export type VariantRequestUpgradeResponse = z.infer<(typeof VariantSchemas)['requestUpgrade']['response']>;
+/** Payload of the `host:variant.upgradeProgress` event. */
+export type VariantUpgradeProgressEvent = z.infer<(typeof VariantSchemas)['upgradeProgress']>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/variant/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/variant/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB;;;EAA0B,CAAC;AAE3D,yDAAyD;AACzD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B;;;;;;EAAuE,CAAC;AAE/G,4DAA4D;AAC5D,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;;;GAIG;AACH,eAAO,MAAM,cAAc;IACzB;;;;;;;;OAQG;;;;;;;;;;;;;;;IAaH;;;;;;;;;OASG;;;;;;;;;;;;;;;;;IA2BH;;;;;;;;OAQG;;;;;;;;;;;;CAemB,CAAC;AAIzB,mDAAmD;AACnD,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,cAAc,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;AAE7F,yDAAyD;AACzD,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,cAAc,CAAC,CAAC,gBAAgB,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AAEzG,0DAA0D;AAC1D,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,cAAc,CAAC,CAAC,gBAAgB,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;AAE3G,2DAA2D;AAC3D,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,cAAc,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC"}

package/dist/version/index.d.ts

@@ -0,0 +1,2 @@
+export { isUniversalRange, type VersionLiteral, VersionLiteralSchema, type VersionRange, VersionRangeSchema, versionSatisfies, } from './primitives.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/version/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/version/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,KAAK,cAAc,EACnB,oBAAoB,EACpB,KAAK,YAAY,EACjB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC"}

package/dist/version/primitives.d.ts

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+/**
+ * npm semver range syntax (e.g. `">=1.0.0 <2.0.0"`, `"^1.5.0"`).
+ *
+ * Used by all range-bearing compatibility fields in descriptors and manifests.
+ */
+export type VersionRange = string;
+/**
+ * Exact semver version (e.g. `"1.0.72"`).
+ *
+ * Used for concrete version pins such as preferred binary versions.
+ */
+export type VersionLiteral = string;
+/** Validates that the string is a valid npm semver range. */
+export declare const VersionRangeSchema: z.ZodString;
+/**
+ * Check whether a concrete version satisfies a semver range.
+ *
+ * Centralizes the `{ includePrerelease: true }` policy so every compatibility
+ * check in the framework uses the same semantics.
+ * @param version - Concrete semver version string.
+ * @param range - npm semver range to test against.
+ * @returns `true` when the version falls within the range.
+ */
+export declare function versionSatisfies(version: string, range: VersionRange): boolean;
+/**
+ * Check whether a semver range is a universal wildcard (`*`, `>=0.0.0`, etc.).
+ *
+ * Uses the `semver` library's normalization so all universal range syntaxes are
+ * recognized, not just the literal `'*'` string.
+ * @param range - Semver range to test.
+ * @returns `true` when the range matches any version.
+ */
+export declare function isUniversalRange(range: string): boolean;
+/** Validates that the string is an exact semver version. */
+export declare const VersionLiteralSchema: z.ZodString;
+//# sourceMappingURL=primitives.d.ts.map

package/dist/version/primitives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../src/version/primitives.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAElC;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AAEpC,6DAA6D;AAC7D,eAAO,MAAM,kBAAkB,aAKO,CAAC;AAEvC;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAE9E;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGvD;AAED,4DAA4D;AAC5D,eAAO,MAAM,oBAAoB,aAKO,CAAC"}

package/dist/version-u2rO7guD.mjs

@@ -0,0 +1 @@
+import{z as e}from"zod";import{satisfies as t,valid as n,validRange as r}from"semver";const i=e.string().min(1).refine(e=>e.trim().length>0&&r(e)!==null,{message:`Must be a valid semver range (e.g. ">=1.0.0 <2.0.0", "^1.5.0")`});function a(e,n){return t(e,n,{includePrerelease:!0})}function o(e){let t=r(e);return t===`*`||t===`>=0.0.0`||t===`>=0.0.0-0`}const s=e.string().min(1).refine(e=>n(e)!==null&&!e.startsWith(`v`),{message:`Must be a valid semver version (e.g. "1.0.0")`});export{a as i,i as n,o as r,s as t};

package/dist/visibility-D4i0fywT.mjs

@@ -0,0 +1 @@
+import{z as e}from"zod";const t=[`batch`,`streaming`],n=[`buffered`,`streaming`],r=e.enum([`none`,`low`,`medium`,`high`,`extra-high`]),i=e.union([e.number(),e.string()]),a=e.object({none:i,low:i,medium:i,high:i,"extra-high":i}).partial(),o=e.object({modes:e.array(e.enum(t)).nonempty(),vocabularyBiasing:e.boolean().optional()}),s=e.object({modes:e.array(e.enum(n)).nonempty(),voiceSelection:e.boolean().optional(),voiceInstructions:e.boolean().optional(),outputFormats:e.array(e.string()).optional()}),c=e.object({vision:e.boolean().optional(),toolCalling:e.boolean().optional(),parallelToolCalls:e.boolean().optional(),structuredOutput:e.boolean().optional(),pdfUpload:e.boolean().optional(),speechToText:o.optional(),textToSpeech:s.optional()}),l=e.object({inputPerMillion:e.number(),inputCachedPerMillion:e.number().optional(),cacheWritePerMillion:e.number().optional(),outputPerMillion:e.number()}),u=e.object({multiplier:e.number()}),d=e.object({token:l.optional(),request:u.optional()}),f=e.object({maxOutputTokens:e.number().optional(),capabilities:c.optional(),pricing:d.optional(),includedInSubscription:e.boolean().optional(),description:e.string().optional()}),p=e.object({name:e.string(),friendlyName:e.string().optional(),family:e.string().optional(),contextWindowSize:e.number(),labId:e.string(),supportedReasoningLevels:a.optional(),metadata:f.optional()}),m=p,h=e.enum([`disabled`,`enabled`,`visible`]),g=e.enum([`allowlist`,`show-all`]);function _(e,t,n){return n?.[e]??(t===`allowlist`?`disabled`:`visible`)}export{r as a,t as c,p as i,n as l,h as n,m as o,_ as r,a as s,g as t};

package/dist/workflow/index.d.ts

@@ -0,0 +1,4 @@
+export { AgentWorkflowStepSchema, BusEventTriggerSchema, ExecutionListQuerySchema, ExecutionStatusSchema, ExtensionWorkflowTriggerSchema, ForEachWorkflowStepSchema, GateWorkflowStepSchema, ShellWorkflowStepSchema, StepStateSchema, StepStatusSchema, WorkflowDefinitionInputSchema, WorkflowDefinitionInputSchemaTyped, WorkflowDefinitionSchema, WorkflowDefinitionSchemaTyped, WorkflowExecutionSchema, WorkflowInputSchema, WorkflowListQuerySchema, WorkflowStepBaseSchema, WorkflowStepSchema, WorkflowTriggerSchema, } from './schemas.js';
+export type { AgentWorkflowStep, BusEventTrigger, ExecutionListQuery, ExecutionStatus, ExtensionWorkflowTrigger, ForEachWorkflowStep, GateWorkflowStep, ShellWorkflowStep, StepState, StepStatus, WorkflowDefinition, WorkflowDefinitionInput, WorkflowExecution, WorkflowInput, WorkflowListQuery, WorkflowStep, WorkflowStepBase, WorkflowTrigger, } from './schemas.js';
+export type { IWorkflowTriggerTypeRegistry, WorkflowTriggerTypeRecord } from './trigger-type-registry.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/workflow/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workflow/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,EACrB,8BAA8B,EAC9B,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACvB,eAAe,EACf,gBAAgB,EAChB,6BAA6B,EAC7B,kCAAkC,EAClC,wBAAwB,EACxB,6BAA6B,EAC7B,uBAAuB,EACvB,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,wBAAwB,EACxB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,SAAS,EACT,UAAU,EACV,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,4BAA4B,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC"}