@oasisomniverse/web6-api 1.0.0

package/src/index.js

@@ -0,0 +1,45 @@
+'use strict';
+
+const { HttpClient, DEFAULT_BASE_URL } = require('./core/httpClient');
+const { TokenStore } = require('./core/tokenStore');
+const { attachGeneratedModules } = require('./modules/index');
+
+/**
+ * Main SDK entry point. Works in Node 18+ and any modern browser.
+ *
+ *   const { Web6Client } = require('@oasisomniverse/web6-api');
+ *   const web6 = new Web6Client({ baseUrl: 'https://api.web6.oasisomniverse.one' });
+ *   web6.setToken(jwtToken); // reuse a WEB4 OASIS JWT - WEB6 has no auth of its own
+ *   const { result } = await web6.completion.complete({ avatarId, messages: [...] });
+ *
+ * Every controller on the WEB6 AI Layer WebAPI is reachable as a lowerCamel
+ * property (web6.completion, web6.images, web6.holonicMemory, web6.holonicBraid,
+ * web6.orchestrator, web6.reasoningNetwork). Generated methods take a single
+ * args object; route template tokens (e.g. {taskType}) are consumed from it
+ * automatically, remaining keys become the query string (GET/DELETE) or JSON
+ * body (POST/PUT).
+ */
+class Web6Client {
+  constructor({ baseUrl = DEFAULT_BASE_URL, persistSession, fetchImpl } = {}) {
+    this.tokenStore = new TokenStore({ persist: persistSession });
+    this.http = new HttpClient({ baseUrl, tokenStore: this.tokenStore, fetchImpl });
+
+    attachGeneratedModules(this, this.http);
+  }
+
+  setBaseUrl(baseUrl) {
+    this.http.setBaseUrl(baseUrl);
+  }
+
+  /**
+   * WEB6 is an internal AI layer sitting behind the same OASIS identity as
+   * WEB4/WEB5 - it has no avatar/auth endpoints of its own. Reuse a JWT you
+   * already obtained from the WEB4 OASIS API (or your own backend) here.
+   */
+  setToken(jwtToken, sessionExtras = {}) {
+    this.tokenStore.setSession({ ...sessionExtras, jwtToken });
+  }
+}
+
+module.exports = { Web6Client, HttpClient, TokenStore, DEFAULT_BASE_URL };
+module.exports.default = Web6Client;

package/src/modules/Completion.d.ts

@@ -0,0 +1,12 @@
+// AUTO-GENERATED by scripts/generate-types.js - do not hand-edit.
+import type { OASISResponse } from '../core/types';
+
+export declare class CompletionModule {
+  constructor(http: unknown);
+
+  /** POST v1/complete */
+  complete(args?: Record<string, any>): Promise<OASISResponse>;
+
+  /** GET v1/openserv/models */
+  openServModels(args?: Record<string, any>): Promise<OASISResponse>;
+}

package/src/modules/Completion.js

@@ -0,0 +1,25 @@
+'use strict';
+
+// AUTO-GENERATED by scripts/generate-modules.js from endpoints.json - do not hand-edit.
+// Regenerate with: node scripts/generate-modules.js
+
+const { makeOperation } = require('../core/routeHelper');
+
+/**
+ * Generated wrapper for v1 (source: WEB6 AI Layer WebAPI CompletionController.cs).
+ * Every method takes a single args object: path-template tokens (e.g. {id})
+ * are consumed from it automatically; any remaining keys are sent as the
+ * query string (GET/DELETE) or JSON body (POST/PUT).
+ */
+class CompletionModule {
+  constructor(http) {
+    this._http = http;
+
+    // POST v1/complete
+    this.complete = makeOperation(http, "v1", "POST", "complete");
+    // GET v1/openserv/models
+    this.openServModels = makeOperation(http, "v1", "GET", "openserv/models");
+  }
+}
+
+module.exports = { CompletionModule };

package/src/modules/HolonicBraid.d.ts

@@ -0,0 +1,12 @@
+// AUTO-GENERATED by scripts/generate-types.js - do not hand-edit.
+import type { OASISResponse } from '../core/types';
+
+export declare class HolonicBraidModule {
+  constructor(http: unknown);
+
+  /** GET v1/holonic-braid/graph/{taskType} */
+  getGraph(args?: Record<string, any>): Promise<OASISResponse>;
+
+  /** POST v1/holonic-braid/graph/{taskType} */
+  saveGraph(args?: Record<string, any>): Promise<OASISResponse>;
+}

package/src/modules/HolonicBraid.js

@@ -0,0 +1,25 @@
+'use strict';
+
+// AUTO-GENERATED by scripts/generate-modules.js from endpoints.json - do not hand-edit.
+// Regenerate with: node scripts/generate-modules.js
+
+const { makeOperation } = require('../core/routeHelper');
+
+/**
+ * Generated wrapper for v1/holonic-braid (source: WEB6 AI Layer WebAPI HolonicBraidController.cs).
+ * Every method takes a single args object: path-template tokens (e.g. {id})
+ * are consumed from it automatically; any remaining keys are sent as the
+ * query string (GET/DELETE) or JSON body (POST/PUT).
+ */
+class HolonicBraidModule {
+  constructor(http) {
+    this._http = http;
+
+    // GET v1/holonic-braid/graph/{taskType}
+    this.getGraph = makeOperation(http, "v1/holonic-braid", "GET", "graph/{taskType}");
+    // POST v1/holonic-braid/graph/{taskType}
+    this.saveGraph = makeOperation(http, "v1/holonic-braid", "POST", "graph/{taskType}");
+  }
+}
+
+module.exports = { HolonicBraidModule };

package/src/modules/HolonicMemory.d.ts

@@ -0,0 +1,21 @@
+// AUTO-GENERATED by scripts/generate-types.js - do not hand-edit.
+import type { OASISResponse } from '../core/types';
+
+export declare class HolonicMemoryModule {
+  constructor(http: unknown);
+
+  /** GET v1/holonic-memory/earth */
+  getEarthHolon(args?: Record<string, any>): Promise<OASISResponse>;
+
+  /** POST v1/holonic-memory/holons (query: level, name, parentHolonId) */
+  getOrCreateHolon(args?: Record<string, any>): Promise<OASISResponse>;
+
+  /** POST v1/holonic-memory/holons/{childHolonId}/propagate */
+  propagate(args?: Record<string, any>): Promise<OASISResponse>;
+
+  /** POST v1/holonic-memory/holons/{holonId}/memory */
+  recordMemory(args?: Record<string, any>): Promise<OASISResponse>;
+
+  /** PUT v1/holonic-memory/holons/{holonId}/membrane-rule */
+  setMembraneRule(args?: Record<string, any>): Promise<OASISResponse>;
+}

package/src/modules/HolonicMemory.js

@@ -0,0 +1,31 @@
+'use strict';
+
+// AUTO-GENERATED by scripts/generate-modules.js from endpoints.json - do not hand-edit.
+// Regenerate with: node scripts/generate-modules.js
+
+const { makeOperation } = require('../core/routeHelper');
+
+/**
+ * Generated wrapper for v1/holonic-memory (source: WEB6 AI Layer WebAPI HolonicMemoryController.cs).
+ * Every method takes a single args object: path-template tokens (e.g. {id})
+ * are consumed from it automatically; any remaining keys are sent as the
+ * query string (GET/DELETE) or JSON body (POST/PUT).
+ */
+class HolonicMemoryModule {
+  constructor(http) {
+    this._http = http;
+
+    // GET v1/holonic-memory/earth
+    this.getEarthHolon = makeOperation(http, "v1/holonic-memory", "GET", "earth");
+    // POST v1/holonic-memory/holons (query: level, name, parentHolonId)
+    this.getOrCreateHolon = makeOperation(http, "v1/holonic-memory", "POST", "holons", {"query":["level","name","parentHolonId"]});
+    // POST v1/holonic-memory/holons/{childHolonId}/propagate
+    this.propagate = makeOperation(http, "v1/holonic-memory", "POST", "holons/{childHolonId}/propagate");
+    // POST v1/holonic-memory/holons/{holonId}/memory
+    this.recordMemory = makeOperation(http, "v1/holonic-memory", "POST", "holons/{holonId}/memory");
+    // PUT v1/holonic-memory/holons/{holonId}/membrane-rule
+    this.setMembraneRule = makeOperation(http, "v1/holonic-memory", "PUT", "holons/{holonId}/membrane-rule");
+  }
+}
+
+module.exports = { HolonicMemoryModule };

package/src/modules/Images.d.ts

@@ -0,0 +1,9 @@
+// AUTO-GENERATED by scripts/generate-types.js - do not hand-edit.
+import type { OASISResponse } from '../core/types';
+
+export declare class ImagesModule {
+  constructor(http: unknown);
+
+  /** POST v1/images/generate */
+  generate(args?: Record<string, any>): Promise<OASISResponse>;
+}

package/src/modules/Images.js

@@ -0,0 +1,23 @@
+'use strict';
+
+// AUTO-GENERATED by scripts/generate-modules.js from endpoints.json - do not hand-edit.
+// Regenerate with: node scripts/generate-modules.js
+
+const { makeOperation } = require('../core/routeHelper');
+
+/**
+ * Generated wrapper for v1/images (source: WEB6 AI Layer WebAPI ImagesController.cs).
+ * Every method takes a single args object: path-template tokens (e.g. {id})
+ * are consumed from it automatically; any remaining keys are sent as the
+ * query string (GET/DELETE) or JSON body (POST/PUT).
+ */
+class ImagesModule {
+  constructor(http) {
+    this._http = http;
+
+    // POST v1/images/generate
+    this.generate = makeOperation(http, "v1/images", "POST", "generate");
+  }
+}
+
+module.exports = { ImagesModule };

package/src/modules/Orchestrator.d.ts

@@ -0,0 +1,15 @@
+// AUTO-GENERATED by scripts/generate-types.js - do not hand-edit.
+import type { OASISResponse } from '../core/types';
+
+export declare class OrchestratorModule {
+  constructor(http: unknown);
+
+  /** GET v1/orchestrators/ */
+  getAdapters(args?: Record<string, any>): Promise<OASISResponse>;
+
+  /** POST v1/orchestrators/invoke */
+  invoke(args?: Record<string, any>): Promise<OASISResponse>;
+
+  /** POST v1/orchestrators/ */
+  registerAdapter(args?: Record<string, any>): Promise<OASISResponse>;
+}

package/src/modules/Orchestrator.js

@@ -0,0 +1,27 @@
+'use strict';
+
+// AUTO-GENERATED by scripts/generate-modules.js from endpoints.json - do not hand-edit.
+// Regenerate with: node scripts/generate-modules.js
+
+const { makeOperation } = require('../core/routeHelper');
+
+/**
+ * Generated wrapper for v1/orchestrators (source: WEB6 AI Layer WebAPI OrchestratorController.cs).
+ * Every method takes a single args object: path-template tokens (e.g. {id})
+ * are consumed from it automatically; any remaining keys are sent as the
+ * query string (GET/DELETE) or JSON body (POST/PUT).
+ */
+class OrchestratorModule {
+  constructor(http) {
+    this._http = http;
+
+    // GET v1/orchestrators/
+    this.getAdapters = makeOperation(http, "v1/orchestrators", "GET", "");
+    // POST v1/orchestrators/invoke
+    this.invoke = makeOperation(http, "v1/orchestrators", "POST", "invoke");
+    // POST v1/orchestrators/
+    this.registerAdapter = makeOperation(http, "v1/orchestrators", "POST", "");
+  }
+}
+
+module.exports = { OrchestratorModule };

package/src/modules/ReasoningNetwork.d.ts

@@ -0,0 +1,18 @@
+// AUTO-GENERATED by scripts/generate-types.js - do not hand-edit.
+import type { OASISResponse } from '../core/types';
+
+export declare class ReasoningNetworkModule {
+  constructor(http: unknown);
+
+  /** POST v1/reasoning-network/dispatch */
+  dispatch(args?: Record<string, any>): Promise<OASISResponse>;
+
+  /** GET v1/reasoning-network/agents */
+  getAgents(args?: Record<string, any>): Promise<OASISResponse>;
+
+  /** POST v1/reasoning-network/agents */
+  registerAgent(args?: Record<string, any>): Promise<OASISResponse>;
+
+  /** POST v1/reasoning-network/agents/seed-openserv */
+  seedOpenServAgents(args?: Record<string, any>): Promise<OASISResponse>;
+}

package/src/modules/ReasoningNetwork.js

@@ -0,0 +1,29 @@
+'use strict';
+
+// AUTO-GENERATED by scripts/generate-modules.js from endpoints.json - do not hand-edit.
+// Regenerate with: node scripts/generate-modules.js
+
+const { makeOperation } = require('../core/routeHelper');
+
+/**
+ * Generated wrapper for v1/reasoning-network (source: WEB6 AI Layer WebAPI ReasoningNetworkController.cs).
+ * Every method takes a single args object: path-template tokens (e.g. {id})
+ * are consumed from it automatically; any remaining keys are sent as the
+ * query string (GET/DELETE) or JSON body (POST/PUT).
+ */
+class ReasoningNetworkModule {
+  constructor(http) {
+    this._http = http;
+
+    // POST v1/reasoning-network/dispatch
+    this.dispatch = makeOperation(http, "v1/reasoning-network", "POST", "dispatch");
+    // GET v1/reasoning-network/agents
+    this.getAgents = makeOperation(http, "v1/reasoning-network", "GET", "agents");
+    // POST v1/reasoning-network/agents
+    this.registerAgent = makeOperation(http, "v1/reasoning-network", "POST", "agents");
+    // POST v1/reasoning-network/agents/seed-openserv
+    this.seedOpenServAgents = makeOperation(http, "v1/reasoning-network", "POST", "agents/seed-openserv");
+  }
+}
+
+module.exports = { ReasoningNetworkModule };

package/src/modules/index.js

@@ -0,0 +1,25 @@
+'use strict';
+
+// AUTO-GENERATED by scripts/generate-modules.js - do not hand-edit.
+const { CompletionModule } = require('./Completion');
+const { HolonicBraidModule } = require('./HolonicBraid');
+const { HolonicMemoryModule } = require('./HolonicMemory');
+const { ImagesModule } = require('./Images');
+const { OrchestratorModule } = require('./Orchestrator');
+const { ReasoningNetworkModule } = require('./ReasoningNetwork');
+
+/**
+ * Attaches every generated module to the client under its lowerCamel controller
+ * name (e.g. client.completion, client.images, client.holonicMemory).
+ */
+function attachGeneratedModules(client, http) {
+  client.completion = client.completion || new CompletionModule(http);
+  client.holonicBraid = client.holonicBraid || new HolonicBraidModule(http);
+  client.holonicMemory = client.holonicMemory || new HolonicMemoryModule(http);
+  client.images = client.images || new ImagesModule(http);
+  client.orchestrator = client.orchestrator || new OrchestratorModule(http);
+  client.reasoningNetwork = client.reasoningNetwork || new ReasoningNetworkModule(http);
+  return client;
+}
+
+module.exports = { attachGeneratedModules };