@oneie/sdk 0.2.0

package/README.md

@@ -0,0 +1,74 @@
+# @oneie/sdk
+
+Client SDK for the ONE substrate — signals, units, persist, launch handoff.
+
+```bash
+npm install @oneie/sdk
+```
+
+## Quick Start
+
+```typescript
+import { getApiUrl, resolveApiKey } from "@oneie/sdk/urls";
+import * as storage from "@oneie/sdk/storage";
+
+// Resolve base URL (env: ONEIE_API_URL, default: https://api.one.ie)
+const url = getApiUrl();
+
+// Storage CRUD
+await storage.put("my-key", { hello: "world" }, { apiKey: resolveApiKey() });
+const value = await storage.get("my-key");
+await storage.del("my-key");
+```
+
+## Modules
+
+| Import | What |
+|--------|------|
+| `@oneie/sdk` | Types + all re-exports |
+| `@oneie/sdk/urls` | `getApiUrl()`, `resolveApiKey()`, `resolveBaseUrl()` |
+| `@oneie/sdk/storage` | `get()`, `put()`, `del()`, `list()` — `/api/storage/*` |
+| `@oneie/sdk/launch` | `launchToken()` — generate agent launch tokens |
+| `@oneie/sdk/handoff` | Token handoff helpers |
+
+## Types
+
+```typescript
+import type { SdkConfig, OneSdkError, Outcome } from "@oneie/sdk";
+
+// Outcome — the 4-result type from the substrate
+type Outcome<T> =
+  | { result: T }        // success
+  | { timeout: true }    // slow, not bad
+  | { dissolved: true }  // missing unit/capability
+```
+
+## Environment Variables
+
+| Variable | Default | Purpose |
+|----------|---------|---------|
+| `ONEIE_API_URL` | `https://api.one.ie` | Substrate API base URL |
+| `ONEIE_API_KEY` | — | Bearer token |
+
+## License
+
+[one.ie/free-license](https://one.ie/free-license)
+
+## Telemetry
+
+`@oneie/sdk` sends anonymous usage signals to the ONE substrate to improve routing quality.
+
+**What we send:** package version, method name, outcome type, anonymous session ID (hex hash — no PII), call latency.
+
+**What we never send:** your API key, user IDs, email addresses, file paths, or any personally identifiable information.
+
+**Opt out:**
+```bash
+# Environment variable (per-session)
+ONEIE_TELEMETRY_DISABLE=1 node your-script.js
+
+# Permanent opt-out
+echo '{"telemetry":false}' > ~/.oneie/config.json
+```
+
+When opt-out is active, `oneie --version` prints `telemetry: disabled`.

package/dist/client.d.ts

@@ -0,0 +1,29 @@
+import type { DecayResponse, HighwaysResponse, HypothesesResponse, MarkDimsResponse, Outcome, SdkConfig, SignalResponse } from "./types.js";
+export declare class SubstrateClient {
+    private readonly baseUrl;
+    private readonly apiKey;
+    constructor(cfg?: SdkConfig);
+    signal(sender: string, receiver: string, data?: unknown): Promise<SignalResponse>;
+    ask(receiver: string, data?: unknown, timeout?: number, from?: string): Promise<Outcome<unknown>>;
+    mark(edge: string, scores?: Partial<{
+        fit: number;
+        form: number;
+        truth: number;
+        taste: number;
+    }>): Promise<MarkDimsResponse>;
+    warn(edge: string, scores?: Partial<{
+        fit: number;
+        form: number;
+        truth: number;
+        taste: number;
+    }>): Promise<MarkDimsResponse>;
+    fade(trailRate?: number, resistanceRate?: number): Promise<DecayResponse>;
+    highways(limit?: number): Promise<HighwaysResponse>;
+    recall(status?: string): Promise<HypothesesResponse>;
+    reveal(uid: string): Promise<unknown>;
+    forget(uid: string): Promise<unknown>;
+    frontier(uid: string): Promise<unknown>;
+    know(): Promise<unknown>;
+    select(): Promise<unknown>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,OAAO,EACP,SAAS,EACT,cAAc,EACf,MAAM,YAAY,CAAC;AAsBpB,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;gBAEhC,GAAG,GAAE,SAAc;IAKzB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC;IAWjF,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAiBjG,IAAI,CACR,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,GAC5E,OAAO,CAAC,gBAAgB,CAAC;IAWtB,IAAI,CACR,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,GAC5E,OAAO,CAAC,gBAAgB,CAAC;IAWtB,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAWzE,QAAQ,CAAC,KAAK,SAAK,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAW/C,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAYpD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWrC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWrC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWvC,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAMxB,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;CAUjC"}

package/dist/client.js

@@ -0,0 +1,88 @@
+import { OneSdkError } from "./types.js";
+import { resolveApiKey, resolveBaseUrl } from "./urls.js";
+import { emit } from "./telemetry.js";
+async function req(baseUrl, path, init = {}, apiKey) {
+    const headers = { "Content-Type": "application/json" };
+    if (apiKey)
+        headers["Authorization"] = `Bearer ${apiKey}`;
+    const res = await fetch(`${baseUrl}${path}`, { ...init, headers });
+    if (!res.ok) {
+        throw new OneSdkError(`${(init.method ?? "GET")} ${path} → ${res.status}`, res.status);
+    }
+    return res.json();
+}
+export class SubstrateClient {
+    baseUrl;
+    apiKey;
+    constructor(cfg = {}) {
+        this.baseUrl = resolveBaseUrl(cfg.baseUrl);
+        this.apiKey = resolveApiKey(cfg.apiKey);
+    }
+    async signal(sender, receiver, data) {
+        const result = await req(this.baseUrl, "/api/signal", { method: "POST", body: JSON.stringify({ sender, receiver, data }) }, this.apiKey);
+        emit("toolkit:sdk:signal", ["sdk", "method-signal", result.success ? "200" : "error"]);
+        return result;
+    }
+    async ask(receiver, data, timeout, from) {
+        const t = Date.now();
+        const result = await req(this.baseUrl, "/api/ask", { method: "POST", body: JSON.stringify({ receiver, data, timeout, from }) }, this.apiKey);
+        const outcome = "result" in result ? "result"
+            : "timeout" in result ? "timeout"
+                : "dissolved" in result ? "dissolved"
+                    : "failure";
+        emit("toolkit:sdk:ask", ["sdk", "method-ask", `outcome-${outcome}`], { latencyMs: Date.now() - t });
+        return result;
+    }
+    async mark(edge, scores) {
+        const result = await req(this.baseUrl, "/api/loop/mark-dims", { method: "POST", body: JSON.stringify({ edge, ...(scores ?? { fit: 1, form: 1, truth: 1, taste: 1 }) }) }, this.apiKey);
+        emit("toolkit:sdk:mark", ["sdk", "method-mark"]);
+        return result;
+    }
+    async warn(edge, scores) {
+        const result = await req(this.baseUrl, "/api/loop/mark-dims", { method: "POST", body: JSON.stringify({ edge, ...(scores ?? { fit: 0, form: 0, truth: 0, taste: 0 }) }) }, this.apiKey);
+        emit("toolkit:sdk:warn", ["sdk", "method-warn"]);
+        return result;
+    }
+    async fade(trailRate, resistanceRate) {
+        const result = await req(this.baseUrl, "/api/decay-cycle", { method: "POST", body: JSON.stringify({ trailRate, resistanceRate }) }, this.apiKey);
+        emit("toolkit:sdk:fade", ["sdk", "method-fade"]);
+        return result;
+    }
+    async highways(limit = 10) {
+        const result = await req(this.baseUrl, `/api/loop/highways?limit=${limit}`, {}, this.apiKey);
+        emit("toolkit:sdk:highways", ["sdk", "method-highways"]);
+        return result;
+    }
+    async recall(status) {
+        const qs = status ? `?status=${encodeURIComponent(status)}` : "";
+        const result = await req(this.baseUrl, `/api/hypotheses${qs}`, {}, this.apiKey);
+        emit("toolkit:sdk:recall", ["sdk", "method-recall"]);
+        return result;
+    }
+    async reveal(uid) {
+        const result = await req(this.baseUrl, `/api/memory/reveal/${encodeURIComponent(uid)}`, {}, this.apiKey);
+        emit("toolkit:sdk:reveal", ["sdk", "method-reveal"]);
+        return result;
+    }
+    async forget(uid) {
+        const result = await req(this.baseUrl, `/api/memory/forget/${encodeURIComponent(uid)}`, { method: "DELETE" }, this.apiKey);
+        emit("toolkit:sdk:forget", ["sdk", "method-forget"]);
+        return result;
+    }
+    async frontier(uid) {
+        const result = await req(this.baseUrl, `/api/memory/frontier/${encodeURIComponent(uid)}`, {}, this.apiKey);
+        emit("toolkit:sdk:frontier", ["sdk", "method-frontier"]);
+        return result;
+    }
+    async know() {
+        const result = await req(this.baseUrl, "/api/tick", {}, this.apiKey);
+        emit("toolkit:sdk:know", ["sdk", "method-know"]);
+        return result;
+    }
+    async select() {
+        const result = await req(this.baseUrl, "/api/loop/stage", { method: "POST", body: JSON.stringify({}) }, this.apiKey);
+        emit("toolkit:sdk:select", ["sdk", "method-select"]);
+        return result;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/handoff.d.ts

@@ -0,0 +1,3 @@
+export declare function validateEthAddress(address: string): void;
+export declare function generateDeployLink(agentUid: string, baseUrl?: string): string;
+//# sourceMappingURL=handoff.d.ts.map

package/dist/handoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff.d.ts","sourceRoot":"","sources":["../src/handoff.ts"],"names":[],"mappings":"AAEA,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAOxD;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAI7E"}

package/dist/handoff.js

@@ -0,0 +1,15 @@
+import { getFrontendUrl } from "./urls.js";
+export function validateEthAddress(address) {
+    if (!address || typeof address !== "string") {
+        throw new Error("validateEthAddress: address required");
+    }
+    if (!/^0x[a-fA-F0-9]{40}$/.test(address)) {
+        throw new Error(`validateEthAddress: invalid address ${address}`);
+    }
+}
+export function generateDeployLink(agentUid, baseUrl) {
+    const root = baseUrl ?? getFrontendUrl();
+    const safe = encodeURIComponent(agentUid);
+    return `${root.replace(/\/$/, "")}/deploy/${safe}`;
+}
+//# sourceMappingURL=handoff.js.map

package/dist/handoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff.js","sourceRoot":"","sources":["../src/handoff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,uCAAuC,OAAO,EAAE,CAAC,CAAC;IACpE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,QAAgB,EAAE,OAAgB;IACnE,MAAM,IAAI,GAAG,OAAO,IAAI,cAAc,EAAE,CAAC;IACzC,MAAM,IAAI,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC1C,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,IAAI,EAAE,CAAC;AACrD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export * from "./types.js";
+export * from "./urls.js";
+export * as storage from "./storage.js";
+export * from "./handoff.js";
+export { launchToken } from "./launch.js";
+export type { LaunchOpts, LaunchResult } from "./launch.js";
+export { SubstrateClient } from "./client.js";
+export { emit as telemetryEmit, isDisabled as isTelemetryDisabled, sessionId } from "./telemetry.js";
+export declare const SDK_VERSION = "0.2.0";
+//# 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,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE5D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,IAAI,IAAI,aAAa,EAAE,UAAU,IAAI,mBAAmB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAErG,eAAO,MAAM,WAAW,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export * from "./types.js";
+export * from "./urls.js";
+export * as storage from "./storage.js";
+export * from "./handoff.js";
+export { launchToken } from "./launch.js";
+export { SubstrateClient } from "./client.js";
+export { emit as telemetryEmit, isDisabled as isTelemetryDisabled, sessionId } from "./telemetry.js";
+export const SDK_VERSION = "0.2.0";
+//# 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,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,IAAI,IAAI,aAAa,EAAE,UAAU,IAAI,mBAAmB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAErG,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC"}

package/dist/launch.d.ts

@@ -0,0 +1,16 @@
+export interface LaunchOpts {
+    agentLaunchUrl?: string;
+    apiKey?: string;
+    dryRun?: boolean;
+    chain?: "sui" | "base" | "solana";
+    meta?: Record<string, unknown>;
+}
+export interface LaunchResult {
+    tokenId: string;
+    address?: string;
+    chain: string;
+    dryRun: boolean;
+    raw: unknown;
+}
+export declare function launchToken(agentUid: string, opts?: LaunchOpts): Promise<LaunchResult>;
+//# sourceMappingURL=launch.d.ts.map

package/dist/launch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.d.ts","sourceRoot":"","sources":["../src/launch.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,UAAU;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;CACd;AAID,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE,UAAe,GAAG,OAAO,CAAC,YAAY,CAAC,CAyChG"}

package/dist/launch.js

@@ -0,0 +1,49 @@
+import { resolveApiKey, resolveBaseUrl } from "./urls.js";
+import { OneSdkError } from "./types.js";
+const DEFAULT_AGENT_LAUNCH_URL = "https://agent-launch.ai/api";
+export async function launchToken(agentUid, opts = {}) {
+    const base = opts.agentLaunchUrl ?? process.env.AGENT_LAUNCH_URL ?? DEFAULT_AGENT_LAUNCH_URL;
+    const key = resolveApiKey(opts.apiKey);
+    const body = {
+        agentUid,
+        chain: opts.chain ?? "sui",
+        dryRun: opts.dryRun ?? false,
+        meta: opts.meta ?? {},
+    };
+    const headers = new Headers({ "Content-Type": "application/json" });
+    if (key)
+        headers.set("Authorization", `Bearer ${key}`);
+    const res = await fetch(`${base.replace(/\/$/, "")}/v1/tokens`, {
+        method: "POST",
+        headers,
+        body: JSON.stringify(body),
+    });
+    if (!res.ok)
+        throw new OneSdkError(`launch ${res.status}`, res.status);
+    const raw = (await res.json());
+    const tokenId = String(raw.tokenId ?? raw.id ?? `dry-${Date.now()}`);
+    const result = {
+        tokenId,
+        address: typeof raw.address === "string" ? raw.address : undefined,
+        chain: body.chain,
+        dryRun: body.dryRun,
+        raw,
+    };
+    // Emit token-launched signal to the substrate (best-effort).
+    try {
+        await fetch(`${resolveBaseUrl(undefined)}/api/signal`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                receiver: `agent:${agentUid}`,
+                data: { tags: ["token-launched"], content: result },
+                scope: "public",
+            }),
+        });
+    }
+    catch {
+        // signal emit is best-effort; the launch itself is authoritative
+    }
+    return result;
+}
+//# sourceMappingURL=launch.js.map

package/dist/launch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.js","sourceRoot":"","sources":["../src/launch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAkBzC,MAAM,wBAAwB,GAAG,6BAA6B,CAAC;AAE/D,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAgB,EAAE,OAAmB,EAAE;IACvE,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,wBAAwB,CAAC;IAC7F,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG;QACX,QAAQ;QACR,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,KAAK;QAC1B,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK;QAC5B,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE;KACtB,CAAC;IACF,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;IACpE,IAAI,GAAG;QAAE,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,UAAU,GAAG,EAAE,CAAC,CAAC;IACvD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,EAAE;QAC9D,MAAM,EAAE,MAAM;QACd,OAAO;QACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;KAC3B,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,WAAW,CAAC,UAAU,GAAG,CAAC,MAAM,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvE,MAAM,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA4B,CAAC;IAC1D,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,EAAE,IAAI,OAAO,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACrE,MAAM,MAAM,GAAiB;QAC3B,OAAO;QACP,OAAO,EAAE,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;QAClE,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,GAAG;KACJ,CAAC;IACF,6DAA6D;IAC7D,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,GAAG,cAAc,CAAC,SAAS,CAAC,aAAa,EAAE;YACrD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,QAAQ,EAAE,SAAS,QAAQ,EAAE;gBAC7B,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,gBAAgB,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE;gBACnD,KAAK,EAAE,QAAQ;aAChB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,iEAAiE;IACnE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/storage.d.ts

@@ -0,0 +1,9 @@
+export interface StorageEntry {
+    key: string;
+    value: string;
+}
+export declare function listStorage(uid: string, apiKey?: string): Promise<StorageEntry[]>;
+export declare function getStorage(uid: string, key: string, apiKey?: string): Promise<string | null>;
+export declare function putStorage(uid: string, key: string, value: string, apiKey?: string): Promise<void>;
+export declare function deleteStorage(uid: string, key: string, apiKey?: string): Promise<void>;
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAcD,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAGvF;AAED,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQlG;AAED,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKxG;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5F"}

package/dist/storage.js

@@ -0,0 +1,42 @@
+import { resolveApiKey, resolveBaseUrl } from "./urls.js";
+import { OneSdkError } from "./types.js";
+async function req(path, init, apiKey, baseUrl) {
+    const key = resolveApiKey(apiKey);
+    const url = `${resolveBaseUrl(baseUrl)}${path}`;
+    const headers = new Headers(init.headers);
+    if (key)
+        headers.set("Authorization", `Bearer ${key}`);
+    if (init.body && !headers.has("Content-Type"))
+        headers.set("Content-Type", "application/json");
+    const res = await fetch(url, { ...init, headers });
+    if (!res.ok)
+        throw new OneSdkError(`storage ${res.status}`, res.status);
+    if (res.status === 204)
+        return undefined;
+    return (await res.json());
+}
+export async function listStorage(uid, apiKey) {
+    const data = await req(`/api/storage/${encodeURIComponent(uid)}`, { method: "GET" }, apiKey);
+    return data.items ?? [];
+}
+export async function getStorage(uid, key, apiKey) {
+    try {
+        const data = await req(`/api/storage/${encodeURIComponent(uid)}/${encodeURIComponent(key)}`, { method: "GET" }, apiKey);
+        return data.value;
+    }
+    catch (err) {
+        if (err instanceof OneSdkError && err.status === 404)
+            return null;
+        throw err;
+    }
+}
+export async function putStorage(uid, key, value, apiKey) {
+    await req(`/api/storage/${encodeURIComponent(uid)}/${encodeURIComponent(key)}`, {
+        method: "PUT",
+        body: JSON.stringify({ value }),
+    }, apiKey);
+}
+export async function deleteStorage(uid, key, apiKey) {
+    await req(`/api/storage/${encodeURIComponent(uid)}/${encodeURIComponent(key)}`, { method: "DELETE" }, apiKey);
+}
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAOzC,KAAK,UAAU,GAAG,CAAI,IAAY,EAAE,IAAiB,EAAE,MAAe,EAAE,OAAgB;IACtF,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,GAAG,GAAG,GAAG,cAAc,CAAC,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC;IAChD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,GAAG;QAAE,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,UAAU,GAAG,EAAE,CAAC,CAAC;IACvD,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;IAC/F,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IACnD,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,WAAW,CAAC,WAAW,GAAG,CAAC,MAAM,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACxE,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO,SAAc,CAAC;IAC9C,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAM,CAAC;AACjC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAW,EAAE,MAAe;IAC5D,MAAM,IAAI,GAAG,MAAM,GAAG,CAA4B,gBAAgB,kBAAkB,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC;IACxH,OAAO,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAW,EAAE,GAAW,EAAE,MAAe;IACxE,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAoB,gBAAgB,kBAAkB,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC;QAC3I,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,WAAW,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC;QAClE,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAW,EAAE,GAAW,EAAE,KAAa,EAAE,MAAe;IACvF,MAAM,GAAG,CAAC,gBAAgB,kBAAkB,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,GAAG,CAAC,EAAE,EAAE;QAC9E,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC;KAChC,EAAE,MAAM,CAAC,CAAC;AACb,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAW,EAAE,GAAW,EAAE,MAAe;IAC3E,MAAM,GAAG,CAAC,gBAAgB,kBAAkB,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,MAAM,CAAC,CAAC;AAChH,CAAC"}

package/dist/telemetry.d.ts

@@ -0,0 +1,4 @@
+export declare const sessionId: string;
+export declare function emit(receiver: string, tags: string[], content?: Record<string, unknown>): void;
+export declare function isDisabled(): boolean;
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,SAAS,QAGP,CAAC;AA2BhB,wBAAgB,IAAI,CAClB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI,CAeN;AAED,wBAAgB,UAAU,IAAI,OAAO,CAEpC"}

package/dist/telemetry.js

@@ -0,0 +1,60 @@
+import { createHash, randomBytes } from "node:crypto";
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+const DISABLE_KEY = "ONEIE_TELEMETRY_DISABLE";
+const ENDPOINT = "https://api.one.ie/api/signal";
+const RATE_LIMIT = 100;
+const RATE_WINDOW_MS = 3_600_000;
+let tokenCount = 0;
+let windowStart = Date.now();
+export const sessionId = createHash("sha256")
+    .update(randomBytes(16))
+    .digest("hex")
+    .slice(0, 16);
+function isEnabled() {
+    if (typeof process === "undefined")
+        return false;
+    if (process.env[DISABLE_KEY])
+        return false;
+    try {
+        const cfg = JSON.parse(readFileSync(join(process.env["HOME"] ?? "~", ".oneie", "config.json"), "utf8"));
+        if (cfg["telemetry"] === false)
+            return false;
+    }
+    catch {
+        // Config file absent or unreadable — default to enabled
+    }
+    return true;
+}
+function consume() {
+    const now = Date.now();
+    if (now - windowStart > RATE_WINDOW_MS) {
+        tokenCount = 0;
+        windowStart = now;
+    }
+    if (tokenCount >= RATE_LIMIT)
+        return false;
+    tokenCount++;
+    return true;
+}
+export function emit(receiver, tags, content) {
+    if (!isEnabled() || !consume())
+        return;
+    void fetch(ENDPOINT, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+            sender: `toolkit:${sessionId}`,
+            receiver,
+            data: JSON.stringify({
+                tags: ["telemetry", ...tags],
+                weight: 1,
+                content: { id: sessionId, ...content },
+            }),
+        }),
+    }).catch(() => undefined);
+}
+export function isDisabled() {
+    return !isEnabled();
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,WAAW,GAAG,yBAAyB,CAAC;AAC9C,MAAM,QAAQ,GAAG,+BAA+B,CAAC;AACjD,MAAM,UAAU,GAAG,GAAG,CAAC;AACvB,MAAM,cAAc,GAAG,SAAS,CAAC;AAEjC,IAAI,UAAU,GAAG,CAAC,CAAC;AACnB,IAAI,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;AAC7B,MAAM,CAAC,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,CAAC;KAC1C,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;KACvB,MAAM,CAAC,KAAK,CAAC;KACb,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAEhB,SAAS,SAAS;IAChB,IAAI,OAAO,OAAO,KAAK,WAAW;QAAE,OAAO,KAAK,CAAC;IACjD,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CACpB,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,EAAE,QAAQ,EAAE,aAAa,CAAC,EAAE,MAAM,CAAC,CACrD,CAAC;QAC7B,IAAI,GAAG,CAAC,WAAW,CAAC,KAAK,KAAK;YAAE,OAAO,KAAK,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,wDAAwD;IAC1D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,OAAO;IACd,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,IAAI,GAAG,GAAG,WAAW,GAAG,cAAc,EAAE,CAAC;QACvC,UAAU,GAAG,CAAC,CAAC;QACf,WAAW,GAAG,GAAG,CAAC;IACpB,CAAC;IACD,IAAI,UAAU,IAAI,UAAU;QAAE,OAAO,KAAK,CAAC;IAC3C,UAAU,EAAE,CAAC;IACb,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,IAAI,CAClB,QAAgB,EAChB,IAAc,EACd,OAAiC;IAEjC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,EAAE;QAAE,OAAO;IACvC,KAAK,KAAK,CAAC,QAAQ,EAAE;QACnB,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,MAAM,EAAE,WAAW,SAAS,EAAE;YAC9B,QAAQ;YACR,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,IAAI,EAAE,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC;gBAC5B,MAAM,EAAE,CAAC;gBACT,OAAO,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,OAAO,EAAE;aACvC,CAAC;SACH,CAAC;KACH,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,CAAC,SAAS,EAAE,CAAC;AACtB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,81 @@
+export interface SdkConfig {
+    apiKey?: string;
+    baseUrl?: string;
+}
+export declare class OneSdkError extends Error {
+    readonly status?: number | undefined;
+    readonly code?: string | undefined;
+    constructor(message: string, status?: number | undefined, code?: string | undefined);
+}
+export type Outcome<T> = {
+    result: T;
+    latency: number;
+} | {
+    timeout: true;
+    latency: number;
+} | {
+    dissolved: true;
+    latency: number;
+} | {
+    failure: true;
+    latency: number;
+};
+export interface SignalResponse {
+    ok: boolean;
+    routed: string | null;
+    result?: unknown;
+    latency: number;
+    success: boolean;
+    sui?: string | null;
+}
+export interface HighwaysResponse {
+    highways: Array<{
+        path: string;
+        strength: number;
+        resistance: number;
+        net: number;
+    }>;
+}
+export interface HypothesesResponse {
+    hypotheses: Array<{
+        hid: string;
+        statement: string;
+        status: string;
+        observations: number;
+        pValue: number;
+        actionReady: boolean;
+    }>;
+}
+export interface MarkDimsResponse {
+    ok: boolean;
+    edge: string;
+    scores: {
+        fit: number;
+        form: number;
+        truth: number;
+        taste: number;
+    };
+    marks: Array<{
+        edge: string;
+        action: "mark" | "warn";
+        strength: number;
+    }>;
+}
+export interface DecayResponse {
+    before: {
+        edges: number;
+        avgStrength: number;
+        avgResistance: number;
+    };
+    after: {
+        edges: number;
+        avgStrength: number;
+        avgResistance: number;
+    };
+    decayed: {
+        trailRate: number;
+        resistanceRate: number;
+    };
+    timestamp: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,WAAY,SAAQ,KAAK;IAGlC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM;gBAFtB,OAAO,EAAE,MAAM,EACN,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,IAAI,CAAC,EAAE,MAAM,YAAA;CAKzB;AAED,MAAM,MAAM,OAAO,CAAC,CAAC,IACjB;IAAE,MAAM,EAAE,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,SAAS,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtF;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,KAAK,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,OAAO,CAAC;KACtB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACpE,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3E;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IACtE,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IACrE,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;IACvD,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/types.js

@@ -0,0 +1,11 @@
+export class OneSdkError extends Error {
+    status;
+    code;
+    constructor(message, status, code) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.name = "OneSdkError";
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,WAAY,SAAQ,KAAK;IAGzB;IACA;IAHX,YACE,OAAe,EACN,MAAe,EACf,IAAa;QAEtB,KAAK,CAAC,OAAO,CAAC,CAAC;QAHN,WAAM,GAAN,MAAM,CAAS;QACf,SAAI,GAAJ,IAAI,CAAS;QAGtB,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF"}

package/dist/urls.d.ts

@@ -0,0 +1,11 @@
+declare const PROD_API_URL = "https://api.one.ie";
+declare const PROD_FRONTEND_URL = "https://one.ie";
+declare const DEV_API_URL = "http://localhost:4321";
+declare const DEV_FRONTEND_URL = "http://localhost:4321";
+export declare function getEnvironment(): "dev" | "production";
+export declare function getApiUrl(): string;
+export declare function getFrontendUrl(): string;
+export declare function resolveApiKey(configKey?: string): string | undefined;
+export declare function resolveBaseUrl(configUrl?: string): string;
+export { PROD_API_URL, PROD_FRONTEND_URL, DEV_API_URL, DEV_FRONTEND_URL };
+//# sourceMappingURL=urls.d.ts.map

package/dist/urls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"urls.d.ts","sourceRoot":"","sources":["../src/urls.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,YAAY,uBAAuB,CAAC;AAC1C,QAAA,MAAM,iBAAiB,mBAAmB,CAAC;AAC3C,QAAA,MAAM,WAAW,0BAA0B,CAAC;AAC5C,QAAA,MAAM,gBAAgB,0BAA0B,CAAC;AAEjD,wBAAgB,cAAc,IAAI,KAAK,GAAG,YAAY,CAGrD;AAED,wBAAgB,SAAS,IAAI,MAAM,CAIlC;AAED,wBAAgB,cAAc,IAAI,MAAM,CAIvC;AAED,wBAAgB,aAAa,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAIpE;AAED,wBAAgB,cAAc,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/urls.js

@@ -0,0 +1,35 @@
+const PROD_API_URL = "https://api.one.ie";
+const PROD_FRONTEND_URL = "https://one.ie";
+const DEV_API_URL = "http://localhost:4321";
+const DEV_FRONTEND_URL = "http://localhost:4321";
+export function getEnvironment() {
+    if (typeof process === "undefined")
+        return "production";
+    return process.env.NODE_ENV === "production" ? "production" : "dev";
+}
+export function getApiUrl() {
+    const override = typeof process !== "undefined" ? process.env.ONEIE_API_URL : undefined;
+    if (override)
+        return override;
+    return getEnvironment() === "production" ? PROD_API_URL : DEV_API_URL;
+}
+export function getFrontendUrl() {
+    const override = typeof process !== "undefined" ? process.env.ONEIE_FRONTEND_URL : undefined;
+    if (override)
+        return override;
+    return getEnvironment() === "production" ? PROD_FRONTEND_URL : DEV_FRONTEND_URL;
+}
+export function resolveApiKey(configKey) {
+    if (configKey)
+        return configKey;
+    if (typeof process === "undefined")
+        return undefined;
+    return process.env.ONEIE_API_KEY ?? process.env.ONE_API_KEY;
+}
+export function resolveBaseUrl(configUrl) {
+    if (configUrl)
+        return configUrl;
+    return getApiUrl();
+}
+export { PROD_API_URL, PROD_FRONTEND_URL, DEV_API_URL, DEV_FRONTEND_URL };
+//# sourceMappingURL=urls.js.map

package/dist/urls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"urls.js","sourceRoot":"","sources":["../src/urls.ts"],"names":[],"mappings":"AAAA,MAAM,YAAY,GAAG,oBAAoB,CAAC;AAC1C,MAAM,iBAAiB,GAAG,gBAAgB,CAAC;AAC3C,MAAM,WAAW,GAAG,uBAAuB,CAAC;AAC5C,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AAEjD,MAAM,UAAU,cAAc;IAC5B,IAAI,OAAO,OAAO,KAAK,WAAW;QAAE,OAAO,YAAY,CAAC;IACxD,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,MAAM,QAAQ,GAAG,OAAO,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC;IACxF,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,OAAO,cAAc,EAAE,KAAK,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,MAAM,QAAQ,GAAG,OAAO,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7F,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,OAAO,cAAc,EAAE,KAAK,YAAY,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,gBAAgB,CAAC;AAClF,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,SAAkB;IAC9C,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC;IAChC,IAAI,OAAO,OAAO,KAAK,WAAW;QAAE,OAAO,SAAS,CAAC;IACrD,OAAO,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,SAAkB;IAC/C,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC;IAChC,OAAO,SAAS,EAAE,CAAC;AACrB,CAAC;AAED,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@oneie/sdk",
+  "version": "0.2.0",
+  "description": "ONE substrate SDK — signals, units, persist, launch handoff.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./urls": "./dist/urls.js",
+    "./storage": "./dist/storage.js",
+    "./handoff": "./dist/handoff.js",
+    "./launch": "./dist/launch.js",
+    "./client": "./dist/client.js",
+    "./telemetry": "./dist/telemetry.js"
+  },
+  "files": ["dist", "README.md"],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "bun run build"
+  },
+  "devDependencies": {
+    "typescript": "5.9.2"
+  },
+  "license": "SEE LICENSE IN https://one.ie/free-license",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/one-ie/envelopes.git",
+    "directory": "packages/sdk"
+  }
+}