kyomei 0.1.0

package/index.d.ts

@@ -0,0 +1,51 @@
+export interface PatchboardClient {
+  /** Execute the patchboard with optional input data. */
+  execute(input?: unknown): Promise<{ run_id: string; items: unknown[] }>;
+}
+
+export interface DeviceClient {
+  /** Get device information. */
+  info(): Promise<unknown>;
+}
+
+export interface DiskClient {
+  /** Get a URL for a file in this disk. */
+  url(path: string): string;
+  /** List files in the disk, optionally filtered by path prefix. */
+  list(path?: string): Promise<unknown>;
+}
+
+export interface KyomeiSDK {
+  /** Current project ID. */
+  readonly projectId: string;
+  /** Access a patchboard by name and execute it. */
+  patchboard(name: string): PatchboardClient;
+  /** Access a device by name. */
+  device(name: string): DeviceClient;
+  /** Access a disk/storage by name. */
+  disk(name: string): DiskClient;
+  /** Navigate to a path. */
+  navigate(path: string): void;
+}
+
+/**
+ * React hook to access the Kyomei SDK.
+ * Only available inside code components rendered by the Kyomei Surface Runtime.
+ *
+ * @example
+ * ```tsx
+ * import { useKyomei } from "kyomei";
+ *
+ * export default function OrderList() {
+ *   const k = useKyomei();
+ *   const [orders, setOrders] = React.useState([]);
+ *
+ *   React.useEffect(() => {
+ *     k.patchboard("get-orders").execute({ page: 1 }).then(r => setOrders(r.items));
+ *   }, []);
+ *
+ *   return <div>{JSON.stringify(orders)}</div>;
+ * }
+ * ```
+ */
+export declare function useKyomei(): KyomeiSDK;

package/index.js

@@ -0,0 +1,17 @@
+// Kyomei SDK runtime stub.
+// Actual implementation is injected by the Kyomei Surface Runtime via window.__KYOMEI_SDK__.
+// This file exists so the package is importable at build time (esbuild marks it as external).
+
+"use strict";
+
+function useKyomei() {
+  if (typeof window !== "undefined" && window.__KYOMEI_SDK__) {
+    return window.__KYOMEI_SDK__;
+  }
+  throw new Error(
+    "useKyomei() is only available inside code components rendered by the Kyomei Surface Runtime."
+  );
+}
+
+module.exports = { useKyomei };
+module.exports.useKyomei = useKyomei;

package/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "kyomei",
+  "version": "0.1.0",
+  "description": "Kyomei SDK — access patchboards, devices, and storage from code components",
+  "types": "index.d.ts",
+  "main": "index.js",
+  "files": [
+    "index.d.ts",
+    "index.js"
+  ],
+  "keywords": ["kyomei", "sdk", "automation", "patchboard"],
+  "license": "MIT",
+  "peerDependencies": {
+    "react": ">=18"
+  }
+}