@heossihq/bee 0.1.5

package/dist/code.js

@@ -0,0 +1,111 @@
+/** Public contracts for Bee's managed Code sessions and actions. */
+export const BEE_CODE_AUTHORITY_MODES = ["read_only", "approve_edits", "auto_edit"];
+export const BEE_CODE_ACTIONS = [
+    "list_files",
+    "discover_repository_controls",
+    "read_file",
+    "search_files",
+    "write_file",
+    "stage_file_chunk",
+    "apply_file_batch",
+    "rollback_file_batch",
+    "git_status",
+    "git_diff",
+    "create_checkpoint",
+    "checkpoint_diff",
+    "create_branch",
+    "commit_changes",
+    "open_pull_request",
+    "diagnostics",
+    "test",
+    "lint",
+    "typecheck",
+    "build",
+    "run_hooks",
+];
+const ACTION_FIELDS = {
+    list_files: { required: [], optional: [] },
+    discover_repository_controls: { required: [], optional: [] },
+    read_file: { required: ["path"], optional: [] },
+    search_files: { required: ["query"], optional: [] },
+    write_file: { required: ["path", "content", "checkpoint_sha"], optional: ["approved"] },
+    stage_file_chunk: {
+        required: ["batch_id", "path", "chunk_index", "total_chunks", "content", "content_sha256"],
+        optional: ["approved"],
+    },
+    apply_file_batch: { required: ["batch_id", "checkpoint_sha"], optional: ["approved"] },
+    rollback_file_batch: { required: ["batch_id"], optional: ["approved"] },
+    git_status: { required: [], optional: [] },
+    git_diff: { required: [], optional: ["path"] },
+    create_checkpoint: { required: [], optional: [] },
+    checkpoint_diff: { required: ["checkpoint_sha"], optional: ["path"] },
+    create_branch: { required: ["branch"], optional: ["approved"] },
+    commit_changes: { required: ["message"], optional: ["approved"] },
+    open_pull_request: { required: ["title", "description"], optional: ["base", "approved"] },
+    diagnostics: { required: [], optional: [] },
+    test: { required: [], optional: ["approved"] },
+    lint: { required: [], optional: ["approved"] },
+    typecheck: { required: [], optional: ["approved"] },
+    build: { required: [], optional: ["approved"] },
+    run_hooks: { required: [], optional: ["approved"] },
+};
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function requireNonEmptyString(value, field) {
+    if (typeof value !== "string" || !value.trim()) {
+        throw new TypeError(`Bee Code ${field} must be a non-empty string`);
+    }
+    return value;
+}
+/** Validate untyped JavaScript/CLI input before any managed Code action is sent. */
+export function validateBeeCodeActionRequest(value) {
+    if (!isRecord(value) || typeof value.action !== "string" || !(value.action in ACTION_FIELDS)) {
+        throw new TypeError("Bee Code action request has an unsupported action");
+    }
+    const action = value.action;
+    const fields = ACTION_FIELDS[action];
+    const supplied = Object.keys(value).filter((field) => field !== "action");
+    const missing = fields.required.filter((field) => !(field in value));
+    const unknown = supplied.filter((field) => !fields.required.includes(field) && !fields.optional.includes(field));
+    if (missing.length)
+        throw new TypeError(`Bee Code ${action} is missing: ${missing.join(", ")}`);
+    if (unknown.length)
+        throw new TypeError(`Bee Code ${action} has unsupported fields: ${unknown.join(", ")}`);
+    for (const field of [
+        "path",
+        "query",
+        "batch_id",
+        "checkpoint_sha",
+        "branch",
+        "message",
+        "title",
+        "base",
+    ]) {
+        if (field in value)
+            requireNonEmptyString(value[field], field);
+    }
+    if ("checkpoint_sha" in value && !/^[0-9a-f]{40}$/i.test(String(value.checkpoint_sha))) {
+        throw new TypeError("Bee Code checkpoint_sha must be a full SHA-1 hex object ID");
+    }
+    if ("content" in value && typeof value.content !== "string") {
+        throw new TypeError("Bee Code content must be a string");
+    }
+    if ("approved" in value && typeof value.approved !== "boolean") {
+        throw new TypeError("Bee Code approved must be a boolean");
+    }
+    if (action === "stage_file_chunk") {
+        if (!Number.isSafeInteger(value.chunk_index) ||
+            !Number.isSafeInteger(value.total_chunks) ||
+            Number(value.chunk_index) < 0 ||
+            Number(value.total_chunks) < 1 ||
+            Number(value.chunk_index) >= Number(value.total_chunks)) {
+            throw new TypeError("Bee Code chunk indexes must identify one bounded chunk");
+        }
+        if (typeof value.content_sha256 !== "string" || !/^[0-9a-f]{64}$/i.test(value.content_sha256)) {
+            throw new TypeError("Bee Code content_sha256 must be a SHA-256 hex digest");
+        }
+    }
+    return { ...value };
+}
+//# sourceMappingURL=code.js.map

package/dist/code.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,20 @@
+/** Base error type — every BeeError carries the HTTP status and (when present) the upstream JSON body. */
+export declare class BeeError extends Error {
+    readonly status: number;
+    readonly body: unknown;
+    constructor(message: string, status: number, body: unknown);
+}
+/** 401 / 403 — bad or missing API key, or the key's plan does not grant the requested tier. */
+export declare class BeeAuthError extends BeeError {
+    constructor(message: string, status: number, body: unknown);
+}
+/** 429 — rate-limited. The `retryAfterSeconds` field reflects the Retry-After header when the server set it. */
+export declare class BeeRateLimitError extends BeeError {
+    readonly retryAfterSeconds: number | null;
+    constructor(message: string, body: unknown, retryAfterSeconds: number | null);
+}
+/** AbortController fired before the response landed. */
+export declare class BeeTimeoutError extends BeeError {
+    constructor(message: string, timeoutMs: number);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,0GAA0G;AAC1G,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;gBAEX,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO;CAM3D;AAED,+FAA+F;AAC/F,qBAAa,YAAa,SAAQ,QAAQ;gBAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO;CAI3D;AAED,gHAAgH;AAChH,qBAAa,iBAAkB,SAAQ,QAAQ;IAC7C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;gBAC9B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,GAAG,IAAI;CAK7E;AAED,wDAAwD;AACxD,qBAAa,eAAgB,SAAQ,QAAQ;gBAC/B,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAI/C"}

package/dist/errors.js

@@ -0,0 +1,35 @@
+/** Base error type — every BeeError carries the HTTP status and (when present) the upstream JSON body. */
+export class BeeError extends Error {
+    status;
+    body;
+    constructor(message, status, body) {
+        super(message);
+        this.name = "BeeError";
+        this.status = status;
+        this.body = body;
+    }
+}
+/** 401 / 403 — bad or missing API key, or the key's plan does not grant the requested tier. */
+export class BeeAuthError extends BeeError {
+    constructor(message, status, body) {
+        super(message, status, body);
+        this.name = "BeeAuthError";
+    }
+}
+/** 429 — rate-limited. The `retryAfterSeconds` field reflects the Retry-After header when the server set it. */
+export class BeeRateLimitError extends BeeError {
+    retryAfterSeconds;
+    constructor(message, body, retryAfterSeconds) {
+        super(message, 429, body);
+        this.name = "BeeRateLimitError";
+        this.retryAfterSeconds = retryAfterSeconds;
+    }
+}
+/** AbortController fired before the response landed. */
+export class BeeTimeoutError extends BeeError {
+    constructor(message, timeoutMs) {
+        super(message, 0, { timeoutMs });
+        this.name = "BeeTimeoutError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,0GAA0G;AAC1G,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,MAAM,CAAS;IACf,IAAI,CAAU;IAEvB,YAAY,OAAe,EAAE,MAAc,EAAE,IAAa;QACxD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,+FAA+F;AAC/F,MAAM,OAAO,YAAa,SAAQ,QAAQ;IACxC,YAAY,OAAe,EAAE,MAAc,EAAE,IAAa;QACxD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,gHAAgH;AAChH,MAAM,OAAO,iBAAkB,SAAQ,QAAQ;IACpC,iBAAiB,CAAgB;IAC1C,YAAY,OAAe,EAAE,IAAa,EAAE,iBAAgC;QAC1E,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;IAC7C,CAAC;CACF;AAED,wDAAwD;AACxD,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IAC3C,YAAY,OAAe,EAAE,SAAiB;QAC5C,KAAK,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @heossihq/bee — Official TypeScript / JavaScript SDK for
+ * Bee by HEOSSI — The Progressive Quantum-Native Intelligence Engine.
+ *
+ * Bee exposes an OpenAI-compatible /chat/completions surface backed by a
+ * domain-specialised LoRA-routed model ladder (Cell, Brood, Comb, Buzz,
+ * Hive, Swarm, Enclave). This SDK is the typed entry point — pure
+ * ESM, zero runtime dependencies, native fetch.
+ *
+ * See https://bee.heossi.com/docs for the full API reference.
+ */
+export { BeeClient } from "./client.js";
+export type { BeeClientOptions } from "./client.js";
+export { BeeError, BeeAuthError, BeeRateLimitError, BeeTimeoutError } from "./errors.js";
+export { executeByopaDirect, quantumLocalSelect } from "./quantum-local.js";
+export type { ByopaDirectAdapter, ByopaDirectRequest, ByopaDirectResult, QuantumLocalAccelerator, QuantumLocalResult, } from "./quantum-local.js";
+export type { ChatMessage, Role, ContentPart, TextPart, ImageUrlPart, ChatCompletionCreateParams, ChatCompletion, ChatCompletionChoice, ChatCompletionChunk, ChatCompletionChunkChoice, ChatCompletionUsage, ModelInfo, ModelsListResponse, QuantumReasoningModel, QuantumProductId, QuantumReasoningJobStatus, QuantumReasoningRealRequestStatus, QuantumReasoningCandidate, QuantumReasoningJob, QuantumReasoningCapabilities, QuantumReasoningJobCreateParams, ProvenanceLink, ProvenanceResult, UsageAllowance, UsageBreakdownTier, UsageResponse, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACzF,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,WAAW,EACX,IAAI,EACJ,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,0BAA0B,EAC1B,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,yBAAyB,EACzB,mBAAmB,EACnB,SAAS,EACT,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,yBAAyB,EACzB,iCAAiC,EACjC,yBAAyB,EACzB,mBAAmB,EACnB,4BAA4B,EAC5B,+BAA+B,EAC/B,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+/**
+ * @heossihq/bee — Official TypeScript / JavaScript SDK for
+ * Bee by HEOSSI — The Progressive Quantum-Native Intelligence Engine.
+ *
+ * Bee exposes an OpenAI-compatible /chat/completions surface backed by a
+ * domain-specialised LoRA-routed model ladder (Cell, Brood, Comb, Buzz,
+ * Hive, Swarm, Enclave). This SDK is the typed entry point — pure
+ * ESM, zero runtime dependencies, native fetch.
+ *
+ * See https://bee.heossi.com/docs for the full API reference.
+ */
+export { BeeClient } from "./client.js";
+export { BeeError, BeeAuthError, BeeRateLimitError, BeeTimeoutError } from "./errors.js";
+export { executeByopaDirect, quantumLocalSelect } from "./quantum-local.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACzF,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/quantum-local.d.ts

@@ -0,0 +1,49 @@
+export interface QuantumLocalAccelerator {
+    backend: "customer_gpu" | string;
+    run(probabilities: readonly number[], shots: number, seed: number): Promise<Record<string, number>>;
+}
+export interface QuantumLocalResult {
+    selected_index: number;
+    selected: string;
+    probabilities: number[];
+    /** Real amplitudes for the prepared, normalized state; padded to 2^qubits. */
+    amplitudes: number[];
+    qubits: number;
+    counts: Record<string, number>;
+    shots: number;
+    backend: string;
+}
+export declare function quantumLocalSelect(input: {
+    candidates: readonly string[];
+    scores: readonly number[];
+    shots?: number;
+    seed?: number;
+    accelerator?: QuantumLocalAccelerator;
+}): Promise<QuantumLocalResult>;
+export interface ByopaDirectRequest {
+    circuit: string;
+    shots: number;
+    backend: string;
+    max_cost_minor: number;
+    currency: string;
+}
+export interface ByopaDirectResult {
+    provider_job_id: string;
+    backend: string;
+    counts: Record<string, number>;
+    billed_cost_minor?: number;
+}
+export interface ByopaDirectAdapter {
+    quote(request: ByopaDirectRequest): Promise<{
+        cost_minor: number;
+        currency: string;
+        expires_at: string;
+    }>;
+    run(request: ByopaDirectRequest, quote: {
+        cost_minor: number;
+        currency: string;
+        expires_at: string;
+    }): Promise<ByopaDirectResult>;
+}
+export declare function executeByopaDirect(request: ByopaDirectRequest, adapter: ByopaDirectAdapter): Promise<ByopaDirectResult>;
+//# sourceMappingURL=quantum-local.d.ts.map

package/dist/quantum-local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quantum-local.d.ts","sourceRoot":"","sources":["../src/quantum-local.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,cAAc,GAAG,MAAM,CAAC;IACjC,GAAG,CACD,aAAa,EAAE,SAAS,MAAM,EAAE,EAChC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,8EAA8E;IAC9E,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAkCD,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,uBAAuB,CAAC;CACvC,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA0D9B;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB;AACD,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AACD,MAAM,WAAW,kBAAkB;IACjC,KAAK,CACH,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzE,GAAG,CACD,OAAO,EAAE,kBAAkB,EAC3B,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAClE,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC/B;AAED,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CAsC5B"}

package/dist/quantum-local.js

@@ -0,0 +1,114 @@
+function validateProviderCounts(counts, shots) {
+    const entries = Object.entries(counts);
+    if (entries.length === 0 ||
+        entries.some(([key, value]) => !/^[01]{1,64}$/.test(key) || !Number.isInteger(value) || value < 0) ||
+        entries.reduce((sum, [, value]) => sum + value, 0) !== shots) {
+        throw new Error("provider returned invalid counts");
+    }
+}
+function finite(value, name) {
+    if (!Number.isFinite(value))
+        throw new TypeError(`${name} must be finite`);
+    return value;
+}
+function validateCounts(counts, size, shots) {
+    const entries = Object.entries(counts);
+    if (entries.length === 0 ||
+        entries.some(([key, value]) => !/^\d+$/.test(key) || Number(key) >= size || !Number.isInteger(value) || value < 0) ||
+        entries.reduce((sum, [, value]) => sum + value, 0) !== shots) {
+        throw new Error("accelerator returned invalid counts");
+    }
+}
+export async function quantumLocalSelect(input) {
+    const { candidates, scores } = input;
+    if (candidates.length < 1 || candidates.length > 256 || candidates.length !== scores.length) {
+        throw new RangeError("candidates and scores must have the same length from 1 to 256");
+    }
+    if (candidates.some((value) => !value || value.length > 256_000))
+        throw new RangeError("invalid candidate");
+    for (const value of scores)
+        finite(value, "score");
+    const shots = input.shots ?? 2_000;
+    const seed = input.seed ?? 0xbee;
+    if (!Number.isInteger(shots) || shots < 1 || shots > 100_000)
+        throw new RangeError("shots out of range");
+    if (!Number.isSafeInteger(seed))
+        throw new RangeError("seed must be a safe integer");
+    const high = Math.max(...scores);
+    const weights = scores.map((score) => Math.exp(score - high));
+    const total = weights.reduce((sum, value) => sum + value, 0);
+    const probabilities = weights.map((value) => value / total);
+    const qubits = Math.max(1, Math.ceil(Math.log2(candidates.length)));
+    const amplitudes = Array.from({ length: 2 ** qubits }, (_, index) => index < probabilities.length ? Math.sqrt(probabilities[index]) : 0);
+    let counts;
+    let backend = "customer_cpu";
+    if (input.accelerator) {
+        counts = await input.accelerator.run(probabilities, shots, seed);
+        backend = input.accelerator.backend;
+    }
+    else {
+        counts = {};
+        let state = seed >>> 0;
+        for (let shot = 0; shot < shots; shot += 1) {
+            state = (Math.imul(1664525, state) + 1013904223) >>> 0;
+            const sample = state / 2 ** 32;
+            let cumulative = 0;
+            let index = probabilities.length - 1;
+            for (let candidate = 0; candidate < probabilities.length; candidate += 1) {
+                cumulative += probabilities[candidate];
+                if (sample < cumulative) {
+                    index = candidate;
+                    break;
+                }
+            }
+            counts[String(index)] = (counts[String(index)] ?? 0) + 1;
+        }
+    }
+    validateCounts(counts, candidates.length, shots);
+    const selectedIndex = Number(Object.keys(counts).reduce((best, key) => (counts[key] > counts[best] ? key : best)));
+    return {
+        selected_index: selectedIndex,
+        selected: candidates[selectedIndex],
+        probabilities,
+        amplitudes,
+        qubits,
+        counts,
+        shots,
+        backend,
+    };
+}
+export async function executeByopaDirect(request, adapter) {
+    if (!request.circuit || request.circuit.length > 1_000_000)
+        throw new RangeError("invalid circuit");
+    if (!Number.isInteger(request.shots) || request.shots < 1 || request.shots > 100_000)
+        throw new RangeError("invalid shots");
+    if (!request.backend || request.backend.length > 200)
+        throw new RangeError("invalid backend");
+    if (!Number.isSafeInteger(request.max_cost_minor) || request.max_cost_minor < 0)
+        throw new RangeError("invalid cost cap");
+    if (!/^[A-Z]{3}$/.test(request.currency))
+        throw new RangeError("currency must be uppercase ISO-4217");
+    const quote = await adapter.quote(request);
+    if (!Number.isSafeInteger(quote.cost_minor) ||
+        quote.cost_minor < 0 ||
+        quote.cost_minor > request.max_cost_minor ||
+        quote.currency !== request.currency ||
+        !/(?:Z|[+-]\d{2}:\d{2})$/.test(quote.expires_at) ||
+        !Number.isFinite(Date.parse(quote.expires_at)) ||
+        Date.parse(quote.expires_at) <= Date.now())
+        throw new Error("provider returned invalid quote");
+    const result = await adapter.run(request, quote);
+    if (!result.provider_job_id ||
+        result.provider_job_id.length > 300 ||
+        result.backend !== request.backend)
+        throw new Error("provider returned invalid identity");
+    validateProviderCounts(result.counts, request.shots);
+    if (result.billed_cost_minor !== undefined &&
+        (!Number.isSafeInteger(result.billed_cost_minor) ||
+            result.billed_cost_minor < 0 ||
+            result.billed_cost_minor > quote.cost_minor ||
+            result.billed_cost_minor > request.max_cost_minor))
+        throw new Error("provider returned invalid bill");
+    return result;
+}
+//# sourceMappingURL=quantum-local.js.map

package/dist/quantum-local.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,234 @@
+/**
+ * OpenAI-compatible request / response types for Bee.
+ *
+ * Bee exposes a strict subset of the OpenAI Chat Completions surface
+ * at https://api.bee.heossi.com/bee/chat/completions — same JSON shapes,
+ * same streaming format. Anything unsupported (function calling,
+ * logprobs, n>1, etc.) silently 400s upstream rather than surfacing
+ * a misleading "ok" response. This SDK exposes only what's verified
+ * to work end-to-end so callers don't ship dead options.
+ */
+export type Role = "system" | "user" | "assistant";
+export type TextPart = {
+    type: "text";
+    text: string;
+};
+export type ImageUrlPart = {
+    type: "image_url";
+    image_url: {
+        url: string;
+        detail?: "auto" | "low" | "high";
+    };
+};
+export type ContentPart = TextPart | ImageUrlPart;
+export interface ChatMessage {
+    role: Role;
+    /** A plain string OR an OpenAI-style multimodal content array. */
+    content: string | ContentPart[];
+}
+export interface ChatCompletionCreateParams {
+    /** Bee tier id — `bee-cell`, `bee-brood`, `bee-comb`, `bee-buzz`, `bee-hive`, `bee-swarm`, `bee-enclave`. Default `bee-cell`. */
+    model?: string;
+    messages: ChatMessage[];
+    temperature?: number;
+    max_tokens?: number;
+    /** Optional deterministic seed (forwarded to the backend; honoured by some tiers). */
+    seed?: number;
+    /** When true, returns an async iterator of OpenAI SSE chunks. */
+    stream?: boolean;
+}
+export interface ChatCompletionChoice {
+    index: number;
+    message: {
+        role: "assistant";
+        content: string;
+    };
+    finish_reason: string;
+}
+export interface ChatCompletionUsage {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+}
+export interface ChatCompletion {
+    id: string;
+    object: "chat.completion";
+    created: number;
+    model: string;
+    choices: ChatCompletionChoice[];
+    usage: ChatCompletionUsage;
+}
+export interface ChatCompletionChunkChoice {
+    index: number;
+    delta: {
+        role?: "assistant";
+        content?: string;
+    };
+    finish_reason: string | null;
+}
+export interface ChatCompletionChunk {
+    id: string;
+    object: "chat.completion.chunk";
+    created: number;
+    model: string;
+    choices: ChatCompletionChunkChoice[];
+}
+export interface ModelInfo {
+    id: string;
+    object: "model";
+    created?: number;
+    owned_by?: string;
+}
+export interface ModelsListResponse {
+    object: "list";
+    data: ModelInfo[];
+}
+export type QuantumReasoningModel = "bee-hive" | "bee-swarm";
+export type QuantumProductId = "local_simulator" | "simulation_cloud" | "managed_qpu" | "byopa_direct" | "byopa_managed";
+export type QuantumReasoningJobStatus = "queued" | "generating_candidates" | "scoring" | "selecting" | "awaiting_qpu" | "completed" | "classical_fallback" | "failed" | "cancelled";
+export type QuantumReasoningRealRequestStatus = "not_requested" | "reserved" | "executed" | "provider_used_simulator" | "quantum_not_enabled" | "quantum_allowance_exhausted" | "released_after_failure";
+export interface QuantumReasoningCandidate {
+    index: number;
+    content: string;
+    score: number;
+}
+export interface QuantumReasoningJob {
+    id: string;
+    product: Exclude<QuantumProductId, "local_simulator" | "byopa_direct">;
+    status: QuantumReasoningJobStatus;
+    model: QuantumReasoningModel;
+    scoring_method: "hive_logprob" | "swarm_judge";
+    requested_real: boolean;
+    prompt?: string;
+    candidates?: QuantumReasoningCandidate[];
+    selected_index?: number;
+    result?: string;
+    selector_backend?: string;
+    selector_confidence?: number;
+    used_real_qubits: boolean;
+    quoted_credits: number | null;
+    fallback_reason: "selector_unreachable" | "invalid_selection" | null;
+    real_request_status: QuantumReasoningRealRequestStatus;
+    usage: Record<string, number>;
+    inference_receipt_id: string | null;
+    attempt_count: number;
+    max_attempts: number;
+    next_attempt_at: string | null;
+    outcome_state: "not_started" | "in_progress" | "committed" | "outcome_unknown" | "reconciled";
+    error: {
+        code: string;
+        message: string;
+    } | null;
+    workspace_id?: string | null;
+    created_at: string;
+    updated_at: string;
+    completed_at: string | null;
+}
+export interface QuantumReasoningCapabilities {
+    allowed_models: QuantumReasoningModel[];
+    real_enabled: boolean;
+    allowance_credits: number;
+    used_credits: number;
+    remaining_credits: number;
+    workspace_role: "owner" | "admin" | "member";
+    can_run_real: boolean;
+    can_manage_jobs: boolean;
+    products: Array<{
+        product: QuantumProductId;
+        purchased: boolean;
+        server_dispatch: boolean;
+        available: boolean;
+    }>;
+}
+export interface QuantumReasoningJobCreateParams {
+    prompt: string;
+    model: QuantumReasoningModel;
+    product: QuantumProductId;
+    provider_connection_id?: string | null;
+    workspace_id?: string | null;
+    /** At-least 16 characters. Reuse it to retry the same logical create safely. */
+    idempotency_key?: string;
+}
+/** One sealed, ML-DSA-65-signed link in a session's provenance chain. */
+export interface ProvenanceLink {
+    seq: number;
+    sessionId: string;
+    prevHash: string;
+    /** Digests of the turn — never the raw code/args. */
+    action: {
+        tool: string;
+        argsDigest: string;
+        resultDigest: string;
+        tier: string;
+    };
+    issuedAt: string;
+    linkHash: string;
+    signatureAlgorithm: "ML-DSA-65";
+    signatureKeyId: string;
+    signature: string;
+}
+/** Result of {@link BeeClient.provenance}.verify — server verdict + re-verifiable chain. */
+export interface ProvenanceResult {
+    session_id: string;
+    /** Bee's verdict for the whole chain. */
+    verified: boolean;
+    /** Number of sealed turns. */
+    turns: number;
+    verification: {
+        ok: boolean;
+        count: number;
+        failedAt?: number;
+        reason?: string;
+    };
+    signature_algorithm: "ML-DSA-65";
+    /** SPKI PEM — re-verify every link offline with any FIPS-204 verifier. */
+    public_key_pem: string | null;
+    chain: ProvenanceLink[];
+}
+/** One metered tier's allowance for the current billing period. */
+export interface UsageAllowance {
+    tier: string;
+    label: string;
+    unit: "requests" | "seconds" | "tokens";
+    used: number;
+    limit: number;
+    remaining: number;
+    percent: number;
+    overage_behavior: "hard_fail" | "payg" | "contract";
+    addons_enabled: boolean;
+}
+/** One Bee tier's share of recent token usage ("what's contributing"). */
+export interface UsageBreakdownTier {
+    label: string;
+    tokens: number;
+    messages: number;
+    percent: number;
+}
+/** Result of {@link BeeClient.usage}.retrieve — real account, usage, and breakdown. */
+export interface UsageResponse {
+    account: {
+        email: string | null;
+        plan_id: string;
+        plan_name: string;
+        organization: string;
+    };
+    usage: {
+        period: "month";
+        resets_at: string;
+        tokens_used: number;
+        tokens_included: number | null;
+        messages: number;
+        active_days: number;
+        credits_usd: number;
+        allowances: UsageAllowance[];
+    };
+    breakdown: {
+        window: "day" | "week";
+        hours: number;
+        total_tokens: number;
+        total_messages: number;
+        input_percent: number;
+        tiers: UsageBreakdownTier[];
+    };
+}
+//# sourceMappingURL=types.d.ts.map