@nodeterm/sdk 0.1.0

package/README.md

@@ -0,0 +1,124 @@
+# @nodeterm/sdk
+
+Generic Node.js SDK for communication between a local machine and external tools.
+
+The SDK only provides contracts, runtime orchestration, and session events. It does not execute commands, restrict commands, pick directories, manage shells, or know about Telegram. Product logic belongs in the application using the SDK.
+
+## Install
+
+```bash
+npm install @nodeterm/sdk
+```
+
+## Simple Request/Response
+
+```ts
+import { createRuntime } from "@nodeterm/sdk";
+
+const runtime = createRuntime({
+  connectors: [connector],
+  async handler(request) {
+    return {
+      requestId: request.id,
+      ok: true,
+      payload: {
+        received: request.payload
+      },
+      completedAt: new Date()
+    };
+  }
+});
+
+await runtime.start();
+```
+
+## Streaming Session
+
+Use sessions for long outputs, long-running processes, or interactive tools.
+
+```ts
+import { createRuntime } from "@nodeterm/sdk";
+
+const runtime = createRuntime({
+  connectors: [connector],
+  async handler(request, context) {
+    const session = context.createSession(request);
+
+    session.emit({
+      type: "output",
+      stream: "stdout",
+      data: "started\n"
+    });
+
+    session.emit({
+      type: "done",
+      exitCode: 0
+    });
+
+    return session.response();
+  }
+});
+
+await runtime.start();
+```
+
+Session events emitted before a connector subscribes are replayed by default, so short-lived handlers can emit and return without losing output.
+
+## Interactive Input
+
+Connectors can send input, resize, and close events through the same session channel. A future CLI can map these events to `node-pty`, while a Telegram connector can map them to chat messages.
+
+```ts
+async handler(request, context) {
+  const session = context.createSession(request);
+
+  session.on("input", (event) => {
+    process.stdout.write(event.data);
+  });
+
+  session.on("resize", (event) => {
+    console.log(`resize ${event.cols}x${event.rows}`);
+  });
+
+  session.on("close", () => {
+    console.log("session closed");
+  });
+
+  return session.response();
+}
+```
+
+## Test Connector
+
+`MemoryConnector` is exported from `@nodeterm/sdk/testing` for tests and examples.
+
+```ts
+import { createRuntime } from "@nodeterm/sdk";
+import { MemoryConnector } from "@nodeterm/sdk/testing";
+
+const connector = new MemoryConnector();
+const runtime = createRuntime({
+  connectors: [connector],
+  async handler(request) {
+    return {
+      requestId: request.id,
+      ok: true,
+      payload: request.payload,
+      completedAt: new Date()
+    };
+  }
+});
+
+await runtime.start();
+const response = await connector.send({ text: "hello" });
+```
+
+## Development
+
+```bash
+cd sdk
+npm install
+npm run build
+npm test
+npm pack --dry-run
+```

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { createRuntime } from "./runtime.js";
+export { LocalSession } from "./session.js";
+export type { Actor, Connector, ConnectorHandler, ControlError, ControlRequest, ControlResponse, ControlRuntime, DoneSessionEvent, ErrorSessionEvent, InputSessionEvent, MaybePromise, OutputSessionEvent, ResizeSessionEvent, RuntimeContext, RuntimeHandler, Session, SessionEvent, SessionEventOf, SessionEventType, SessionListener, SessionResponseOptions, SessionSubscribeOptions, Unsubscribe } from "./types.js";

package/dist/index.js

@@ -0,0 +1,3 @@
+export { createRuntime } from "./runtime.js";
+export { LocalSession } from "./session.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,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/runtime.d.ts

@@ -0,0 +1,6 @@
+import type { Connector, ControlRuntime, RuntimeHandler } from "./types.js";
+export type RuntimeOptions<TRequestPayload = unknown, TResponsePayload = unknown, TRequestMeta = Record<string, unknown>, TResponseMeta = Record<string, unknown>> = {
+    connectors: readonly Connector<TRequestPayload, TResponsePayload, TRequestMeta, TResponseMeta>[];
+    handler: RuntimeHandler<TRequestPayload, TResponsePayload, TRequestMeta, TResponseMeta>;
+};
+export declare function createRuntime<TRequestPayload = unknown, TResponsePayload = unknown, TRequestMeta = Record<string, unknown>, TResponseMeta = Record<string, unknown>>(options: RuntimeOptions<TRequestPayload, TResponsePayload, TRequestMeta, TResponseMeta>): ControlRuntime;

package/dist/runtime.js

@@ -0,0 +1,49 @@
+import { LocalSession } from "./session.js";
+export function createRuntime(options) {
+    return new DefaultRuntime(options);
+}
+class DefaultRuntime {
+    options;
+    running = false;
+    constructor(options) {
+        this.options = options;
+    }
+    async start() {
+        if (this.running)
+            return;
+        await Promise.all(this.options.connectors.map((connector) => {
+            return connector.start((request) => this.handle(request));
+        }));
+        this.running = true;
+    }
+    async stop() {
+        if (!this.running)
+            return;
+        await Promise.all(this.options.connectors.map((connector) => connector.stop()));
+        this.running = false;
+    }
+    isRunning() {
+        return this.running;
+    }
+    async handle(request) {
+        const context = {
+            createSession(sessionRequest, options) {
+                return new LocalSession(sessionRequest, options);
+            }
+        };
+        try {
+            return await this.options.handler(request, context);
+        }
+        catch (error) {
+            return {
+                requestId: request.id,
+                ok: false,
+                error: {
+                    message: error instanceof Error ? error.message : String(error)
+                },
+                completedAt: new Date()
+            };
+        }
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAY5C,MAAM,UAAU,aAAa,CAM3B,OAAuF;IAEvF,OAAO,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,cAAc;IASC;IAHX,OAAO,GAAG,KAAK,CAAC;IAExB,YACmB,OAAuF;QAAvF,YAAO,GAAP,OAAO,CAAgF;IACvG,CAAC;IAEJ,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QAEzB,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE;YAC1D,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QAC5D,CAAC,CAAC,CAAC,CAAC;QAEJ,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAE1B,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAChF,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;IACvB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAEO,KAAK,CAAC,MAAM,CAClB,OAAsD;QAEtD,MAAM,OAAO,GAAmB;YAC9B,aAAa,CAAC,cAAc,EAAE,OAAO;gBACnC,OAAO,IAAI,YAAY,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;YACnD,CAAC;SACF,CAAC;QAEF,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACtD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,SAAS,EAAE,OAAO,CAAC,EAAE;gBACrB,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE;oBACL,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;iBAChE;gBACD,WAAW,EAAE,IAAI,IAAI,EAAE;aACxB,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/session.d.ts

@@ -0,0 +1,15 @@
+import type { ControlRequest, ControlResponse, Session, SessionEvent, SessionEventOf, SessionEventType, SessionListener, SessionResponseOptions, SessionSubscribeOptions, Unsubscribe } from "./types.js";
+export declare class LocalSession implements Session {
+    readonly id: string;
+    readonly requestId: string;
+    private events;
+    private listeners;
+    constructor(request: ControlRequest, options?: {
+        id?: string;
+    });
+    emit(event: SessionEvent): void;
+    onEvent(listener: SessionListener, options?: SessionSubscribeOptions): Unsubscribe;
+    on<TType extends SessionEventType>(type: TType, listener: SessionListener<SessionEventOf<TType>>, options?: SessionSubscribeOptions): Unsubscribe;
+    history(): readonly SessionEvent[];
+    response<TPayload = undefined, TMeta = Record<string, unknown>>(options?: SessionResponseOptions<TPayload, TMeta>): ControlResponse<TPayload, TMeta>;
+}

package/dist/session.js

@@ -0,0 +1,50 @@
+import { randomUUID } from "node:crypto";
+export class LocalSession {
+    id;
+    requestId;
+    events = [];
+    listeners = new Set();
+    constructor(request, options = {}) {
+        this.id = options.id ?? randomUUID();
+        this.requestId = request.id;
+    }
+    emit(event) {
+        this.events.push(event);
+        for (const listener of this.listeners) {
+            listener(event);
+        }
+    }
+    onEvent(listener, options = {}) {
+        const replay = options.replay ?? true;
+        this.listeners.add(listener);
+        if (replay) {
+            for (const event of this.events) {
+                listener(event);
+            }
+        }
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    on(type, listener, options) {
+        return this.onEvent((event) => {
+            if (event.type === type) {
+                listener(event);
+            }
+        }, options);
+    }
+    history() {
+        return Object.freeze([...this.events]);
+    }
+    response(options = {}) {
+        return {
+            requestId: this.requestId,
+            ok: options.ok ?? true,
+            ...(options.payload === undefined ? {} : { payload: options.payload }),
+            ...(options.meta === undefined ? {} : { meta: options.meta }),
+            completedAt: new Date(),
+            session: this
+        };
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAczC,MAAM,OAAO,YAAY;IACd,EAAE,CAAS;IACX,SAAS,CAAS;IACnB,MAAM,GAAmB,EAAE,CAAC;IAC5B,SAAS,GAAG,IAAI,GAAG,EAAmB,CAAC;IAE/C,YAAY,OAAuB,EAAE,UAA2B,EAAE;QAChE,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,IAAI,UAAU,EAAE,CAAC;QACrC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,EAAE,CAAC;IAC9B,CAAC;IAED,IAAI,CAAC,KAAmB;QACtB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAExB,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,OAAO,CAAC,QAAyB,EAAE,UAAmC,EAAE;QACtE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC;QACtC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAE7B,IAAI,MAAM,EAAE,CAAC;YACX,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;QAED,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC,CAAC;IACJ,CAAC;IAED,EAAE,CACA,IAAW,EACX,QAAgD,EAChD,OAAiC;QAEjC,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YAC5B,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;gBACxB,QAAQ,CAAC,KAA8B,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC,EAAE,OAAO,CAAC,CAAC;IACd,CAAC;IAED,OAAO;QACL,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,QAAQ,CACN,UAAmD,EAAE;QAErD,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,IAAI;YACtB,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;YACtE,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;YAC7D,WAAW,EAAE,IAAI,IAAI,EAAE;YACvB,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;CACF"}

package/dist/testing/index.d.ts

@@ -0,0 +1,20 @@
+import type { Actor, Connector, ConnectorHandler, ControlRequest, ControlResponse } from "../types.js";
+export type MemoryRequestOptions<TMeta = Record<string, unknown>> = {
+    id?: string;
+    source?: string;
+    actor?: Actor;
+    meta?: TMeta;
+    receivedAt?: Date;
+};
+export declare class MemoryConnector<TRequestPayload = unknown, TResponsePayload = unknown, TRequestMeta = Record<string, unknown>, TResponseMeta = Record<string, unknown>> implements Connector<TRequestPayload, TResponsePayload, TRequestMeta, TResponseMeta> {
+    readonly name: string;
+    readonly responses: ControlResponse<TResponsePayload, TResponseMeta>[];
+    private handler;
+    private started;
+    constructor(name?: string);
+    start(handler: ConnectorHandler<TRequestPayload, TResponsePayload, TRequestMeta, TResponseMeta>): Promise<void>;
+    stop(): Promise<void>;
+    isStarted(): boolean;
+    send(payload: TRequestPayload, options?: MemoryRequestOptions<TRequestMeta>): Promise<ControlResponse<TResponsePayload, TResponseMeta>>;
+    dispatch(request: ControlRequest<TRequestPayload, TRequestMeta>): Promise<ControlResponse<TResponsePayload, TResponseMeta>>;
+}

package/dist/testing/index.js

@@ -0,0 +1,40 @@
+import { randomUUID } from "node:crypto";
+export class MemoryConnector {
+    name;
+    responses = [];
+    handler;
+    started = false;
+    constructor(name = "memory") {
+        this.name = name;
+    }
+    async start(handler) {
+        this.handler = handler;
+        this.started = true;
+    }
+    async stop() {
+        this.handler = undefined;
+        this.started = false;
+    }
+    isStarted() {
+        return this.started;
+    }
+    async send(payload, options = {}) {
+        return this.dispatch({
+            id: options.id ?? randomUUID(),
+            source: options.source ?? this.name,
+            ...(options.actor === undefined ? {} : { actor: options.actor }),
+            payload,
+            ...(options.meta === undefined ? {} : { meta: options.meta }),
+            receivedAt: options.receivedAt ?? new Date()
+        });
+    }
+    async dispatch(request) {
+        if (!this.handler) {
+            throw new Error(`MemoryConnector "${this.name}" is not started.`);
+        }
+        const response = await this.handler(request);
+        this.responses.push(response);
+        return response;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAiBzC,MAAM,OAAO,eAAe;IAUL;IAJZ,SAAS,GAAuD,EAAE,CAAC;IACpE,OAAO,CAA+F;IACtG,OAAO,GAAG,KAAK,CAAC;IAExB,YAAqB,OAAO,QAAQ;QAAf,SAAI,GAAJ,IAAI,CAAW;IAAG,CAAC;IAExC,KAAK,CAAC,KAAK,CAAC,OAAyF;QACnG,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;IACvB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,IAAI,CACR,OAAwB,EACxB,UAA8C,EAAE;QAEhD,OAAO,IAAI,CAAC,QAAQ,CAAC;YACnB,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,UAAU,EAAE;YAC9B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI;YACnC,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;YAChE,OAAO;YACP,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;YAC7D,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI,IAAI,EAAE;SAC7C,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,OAAsD;QAEtD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,CAAC,IAAI,mBAAmB,CAAC,CAAC;QACpE,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC7C,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9B,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}

package/dist/types.d.ts

@@ -0,0 +1,94 @@
+export type MaybePromise<T> = T | Promise<T>;
+export type Actor = {
+    id: string;
+    name?: string;
+};
+export type ControlError = {
+    message: string;
+    code?: string;
+};
+export type ControlRequest<TPayload = unknown, TMeta = Record<string, unknown>> = {
+    id: string;
+    source: string;
+    actor?: Actor;
+    payload: TPayload;
+    meta?: TMeta;
+    receivedAt: Date;
+};
+export type ControlResponse<TPayload = unknown, TMeta = Record<string, unknown>> = {
+    requestId: string;
+    ok: boolean;
+    payload?: TPayload;
+    error?: ControlError;
+    meta?: TMeta;
+    completedAt: Date;
+    session?: Session;
+};
+export type OutputSessionEvent = {
+    type: "output";
+    stream: "stdout" | "stderr";
+    data: string;
+};
+export type InputSessionEvent = {
+    type: "input";
+    data: string;
+};
+export type ResizeSessionEvent = {
+    type: "resize";
+    cols: number;
+    rows: number;
+};
+export type ErrorSessionEvent = {
+    type: "error";
+    message: string;
+    code?: string;
+};
+export type DoneSessionEvent = {
+    type: "done";
+    exitCode?: number;
+};
+export type CloseSessionEvent = {
+    type: "close";
+    reason?: string;
+};
+export type SessionEvent = OutputSessionEvent | InputSessionEvent | ResizeSessionEvent | ErrorSessionEvent | DoneSessionEvent | CloseSessionEvent;
+export type SessionEventType = SessionEvent["type"];
+export type SessionEventOf<TType extends SessionEventType> = Extract<SessionEvent, {
+    type: TType;
+}>;
+export type SessionListener<TEvent extends SessionEvent = SessionEvent> = (event: TEvent) => void;
+export type Unsubscribe = () => void;
+export type SessionSubscribeOptions = {
+    replay?: boolean;
+};
+export type SessionResponseOptions<TPayload = unknown, TMeta = Record<string, unknown>> = {
+    ok?: boolean;
+    payload?: TPayload;
+    meta?: TMeta;
+};
+export type Session = {
+    readonly id: string;
+    readonly requestId: string;
+    emit(event: SessionEvent): void;
+    onEvent(listener: SessionListener, options?: SessionSubscribeOptions): Unsubscribe;
+    on<TType extends SessionEventType>(type: TType, listener: SessionListener<SessionEventOf<TType>>, options?: SessionSubscribeOptions): Unsubscribe;
+    history(): readonly SessionEvent[];
+    response<TPayload = undefined, TMeta = Record<string, unknown>>(options?: SessionResponseOptions<TPayload, TMeta>): ControlResponse<TPayload, TMeta>;
+};
+export type RuntimeContext = {
+    createSession(request: ControlRequest, options?: {
+        id?: string;
+    }): Session;
+};
+export type RuntimeHandler<TRequestPayload = unknown, TResponsePayload = unknown, TRequestMeta = Record<string, unknown>, TResponseMeta = Record<string, unknown>> = (request: ControlRequest<TRequestPayload, TRequestMeta>, context: RuntimeContext) => MaybePromise<ControlResponse<TResponsePayload, TResponseMeta>>;
+export type ConnectorHandler<TRequestPayload = unknown, TResponsePayload = unknown, TRequestMeta = Record<string, unknown>, TResponseMeta = Record<string, unknown>> = (request: ControlRequest<TRequestPayload, TRequestMeta>) => Promise<ControlResponse<TResponsePayload, TResponseMeta>>;
+export type Connector<TRequestPayload = unknown, TResponsePayload = unknown, TRequestMeta = Record<string, unknown>, TResponseMeta = Record<string, unknown>> = {
+    name: string;
+    start(handler: ConnectorHandler<TRequestPayload, TResponsePayload, TRequestMeta, TResponseMeta>): Promise<void>;
+    stop(): Promise<void>;
+};
+export type ControlRuntime = {
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    isRunning(): boolean;
+};

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@nodeterm/sdk",
+  "version": "0.1.0",
+  "description": "Generic Node.js SDK for request/response and session-based communication between local machines and external tools.",
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "import": "./dist/testing/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "npm run build && node --test test/**/*.test.mjs",
+    "prepack": "npm run build && cp ../README.md README.md"
+  },
+  "keywords": [
+    "terminal",
+    "sdk",
+    "automation",
+    "remote-control",
+    "streaming"
+  ],
+  "devDependencies": {
+    "@types/node": "^20.19.25",
+    "typescript": "^5.9.3"
+  }
+}