@kl-c/matrixos 0.1.49 → 0.2.1

package/dist/gateway/gateway-handler.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Gateway message handler.
+ *
+ * Receives a normalized envelope from the MatrixGateway, dispatches to a
+ * MaTrixOS CLI subprocess (default: `matrixos run <text>`), and returns
+ * the agent reply to be sent back through the adapter.
+ *
+ * Why subprocess and not in-process: the agent runtime is OpenCode-driven
+ * and uses its own conversation loop. Forcing it into the gateway's event
+ * loop is an L-scale refactor; subprocess keeps the gateway stateless and
+ * the agent isolated. Each message = fresh agent process, no session
+ * reuse for v0 (Phase 1 limitation, documented in TRACABILITE).
+ */
+import type { UnifiedEnvelope } from "@matrixos/matrix-gateway-core";
+export interface GatewayHandlerOptions {
+    /** Command to invoke. Default: matrixos (resolved via PATH). */
+    readonly command?: string;
+    /** Args to pass (default: ["run", text]). Use {text} as placeholder. */
+    readonly args?: string[];
+    /** Working dir for the subprocess. */
+    readonly cwd?: string;
+    /** Timeout in ms (default 30s). */
+    readonly timeoutMs?: number;
+    /** Env overrides (merged on top of process.env, secrets redacted). */
+    readonly env?: Record<string, string>;
+    /** Optional callback for partial output (Phase 2: streaming). */
+    readonly onPartial?: (chunk: string) => void;
+}
+export interface GatewayHandlerResult {
+    readonly ok: boolean;
+    readonly reply: string;
+    readonly durationMs: number;
+    readonly exitCode: number | null;
+}
+/**
+ * Slash command detection. If the inbound text starts with /adopt, the
+ * handler dispatches to the adoption flow instead of the agent subprocess.
+ * Returns true if the command was handled inline (caller should not run
+ * the subprocess).
+ */
+export declare const ADOPT_COMMAND = "/adopt";
+export declare function isAdoptCommand(env: UnifiedEnvelope): boolean;
+export declare function handleAdoptCommand(env: UnifiedEnvelope, opts?: GatewayHandlerOptions): Promise<GatewayHandlerResult>;
+export declare function handleGatewayMessage(env: UnifiedEnvelope, opts?: GatewayHandlerOptions): Promise<GatewayHandlerResult>;

package/dist/index.js

@@ -368023,7 +368023,7 @@ function getCachedVersion(options = {}) {
 // package.json
 var package_default = {
   name: "@kl-c/matrixos",
-  version: "0.1.49",
+  version: "0.2.1",
   description: "MaTrixOS \u2014 Agentic OS for OpenCode. Personalizable, communicating, self-improving, resilient.",
   main: "./dist/index.js",
   types: "dist/index.d.ts",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kl-c/matrixos",
-  "version": "0.1.49",
+  "version": "0.2.1",
   "description": "MaTrixOS — Agentic OS for OpenCode. Personalizable, communicating, self-improving, resilient.",
   "main": "./dist/index.js",
   "types": "dist/index.d.ts",