@tapflowio/agent-core 0.1.0 → 0.2.1

package/dist/AgentRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentRegistry.d.ts","sourceRoot":"","sources":["../src/AgentRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAK3E,eAAO,MAAM,aAAa;uBACL,MAAM,cAAc,sBAAsB,GAAG,IAAI;kBAKtD,MAAM,GAAG,WAAW;aAWzB,IAAI;CAId,CAAA"}
+{"version":3,"file":"AgentRegistry.d.ts","sourceRoot":"","sources":["../src/AgentRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAM3E,eAAO,MAAM,aAAa;uBACL,MAAM,cAAc,sBAAsB,GAAG,IAAI;kBAKtD,MAAM,GAAG,WAAW;aAWzB,IAAI;CAId,CAAA"}

package/dist/AgentRegistry.js

@@ -1,3 +1,4 @@
+import { PlatformError } from './errors.js';
 const constructors = new Map();
 const instances = new Map();
 export const AgentRegistry = {
@@ -7,7 +8,7 @@ export const AgentRegistry = {
     },
     get(platform) {
         if (!constructors.has(platform)) {
-            throw new Error(`No agent registered for platform: ${platform}`);
+            throw new PlatformError(`No agent registered for platform: ${platform}`);
         }
         if (!instances.has(platform)) {
             const AgentClass = constructors.get(platform);

package/dist/AgentRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"AgentRegistry.js","sourceRoot":"","sources":["../src/AgentRegistry.ts"],"names":[],"mappings":"AAEA,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkC,CAAA;AAC9D,MAAM,SAAS,GAAG,IAAI,GAAG,EAAuB,CAAA;AAEhD,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,QAAQ,CAAC,QAAgB,EAAE,UAAkC;QAC3D,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAA;QACtC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IAC5B,CAAC;IAED,GAAG,CAAC,QAAgB;QAClB,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,qCAAqC,QAAQ,EAAE,CAAC,CAAA;QAClE,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,MAAM,UAAU,GAAG,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAA;YAC9C,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,UAAU,EAAE,CAAC,CAAA;QAC3C,CAAC;QACD,OAAO,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAA;IACjC,CAAC;IAED,KAAK;QACH,YAAY,CAAC,KAAK,EAAE,CAAA;QACpB,SAAS,CAAC,KAAK,EAAE,CAAA;IACnB,CAAC;CACF,CAAA"}
+{"version":3,"file":"AgentRegistry.js","sourceRoot":"","sources":["../src/AgentRegistry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE3C,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkC,CAAA;AAC9D,MAAM,SAAS,GAAG,IAAI,GAAG,EAAuB,CAAA;AAEhD,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,QAAQ,CAAC,QAAgB,EAAE,UAAkC;QAC3D,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAA;QACtC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IAC5B,CAAC;IAED,GAAG,CAAC,QAAgB;QAClB,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,aAAa,CAAC,qCAAqC,QAAQ,EAAE,CAAC,CAAA;QAC1E,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,MAAM,UAAU,GAAG,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAA;YAC9C,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,UAAU,EAAE,CAAC,CAAA;QAC3C,CAAC;QACD,OAAO,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAA;IACjC,CAAC;IAED,KAAK;QACH,YAAY,CAAC,KAAK,EAAE,CAAA;QACpB,SAAS,CAAC,KAAK,EAAE,CAAA;IACnB,CAAC;CACF,CAAA"}

package/dist/errors.d.ts

@@ -0,0 +1,11 @@
+declare class TapflowError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare class ValidationError extends TapflowError {
+}
+export declare class PlatformError extends TapflowError {
+}
+export declare class AuthError extends TapflowError {
+}
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,cAAM,YAAa,SAAQ,KAAK;gBAClB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAKpD;AAED,qBAAa,eAAgB,SAAQ,YAAY;CAAG;AAEpD,qBAAa,aAAc,SAAQ,YAAY;CAAG;AAElD,qBAAa,SAAU,SAAQ,YAAY;CAAG"}

package/dist/errors.js

@@ -0,0 +1,14 @@
+class TapflowError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = new.target.name;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+export class ValidationError extends TapflowError {
+}
+export class PlatformError extends TapflowError {
+}
+export class AuthError extends TapflowError {
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,YAAa,SAAQ,KAAK;IAC9B,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QACvB,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAA;QAC3B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IACnD,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,YAAY;CAAG;AAEpD,MAAM,OAAO,aAAc,SAAQ,YAAY;CAAG;AAElD,MAAM,OAAO,SAAU,SAAQ,YAAY;CAAG"}

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export type { Platform, DeviceStatus, Device, Point, AndroidButton, AgentResources } from './types.js';
 export type { DeviceAgent, DeviceAgentConstructor } from './DeviceAgent.js';
 export { AgentRegistry } from './AgentRegistry.js';
+export { ValidationError, PlatformError, AuthError } from './errors.js';
 export type { Logger, LogLevel } from './logger.js';
 export { createLogger } from './logger.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AACtG,YAAY,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AACtG,YAAY,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA"}

package/dist/index.js

@@ -1,3 +1,4 @@
 export { AgentRegistry } from './AgentRegistry.js';
+export { ValidationError, PlatformError, AuthError } from './errors.js';
 export { createLogger } from './logger.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA"}

package/dist/utils/index.d.ts

@@ -1,3 +1,3 @@
 export { createResourceSampler } from './resources.js';
-export { registerStreamWs } from './stream.js';
+export { registerStreamWs, sendBinaryWithBackpressure, createRateLimitedDropWarn, DEFAULT_BACKPRESSURE_BYTES, } from './stream.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AACtD,OAAO,EACL,gBAAgB,EAChB,0BAA0B,EAC1B,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,aAAa,CAAA"}

package/dist/utils/index.js

@@ -1,3 +1,3 @@
 export { createResourceSampler } from './resources.js';
-export { registerStreamWs } from './stream.js';
+export { registerStreamWs, sendBinaryWithBackpressure, createRateLimitedDropWarn, DEFAULT_BACKPRESSURE_BYTES, } from './stream.js';
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AACtD,OAAO,EACL,gBAAgB,EAChB,0BAA0B,EAC1B,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,aAAa,CAAA"}

package/dist/utils/stream.d.ts

@@ -1,3 +1,7 @@
 import { WebSocket } from 'ws';
+import type { Logger } from '../logger.js';
+export declare const DEFAULT_BACKPRESSURE_BYTES = 1048576;
+export declare function sendBinaryWithBackpressure(ws: WebSocket, data: Parameters<WebSocket['send']>[0], threshold: number, onDrop: () => void): void;
+export declare function createRateLimitedDropWarn(logger: Logger, context: string, intervalMs?: number): () => void;
 export declare function registerStreamWs(ws: WebSocket, sessionId: string): Promise<void>;
 //# sourceMappingURL=stream.d.ts.map

package/dist/utils/stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/utils/stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAA;AAI9B,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBhF"}
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/utils/stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAA;AAC9B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAE1C,eAAO,MAAM,0BAA0B,UAAY,CAAA;AAEnD,wBAAgB,0BAA0B,CACxC,EAAE,EAAE,SAAS,EACb,IAAI,EAAE,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EACtC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,IAAI,GACjB,IAAI,CAON;AAID,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,UAAU,SAAO,GAChB,MAAM,IAAI,CAYZ;AAID,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBhF"}

package/dist/utils/stream.js

@@ -1,3 +1,29 @@
+import { WebSocket } from 'ws';
+export const DEFAULT_BACKPRESSURE_BYTES = 1_048_576; // 1 MB
+export function sendBinaryWithBackpressure(ws, data, threshold, onDrop) {
+    if (ws.readyState !== WebSocket.OPEN)
+        return;
+    if (ws.bufferedAmount >= threshold) {
+        onDrop();
+        return;
+    }
+    ws.send(data, { binary: true });
+}
+// Returns a rate-limited warn callback for use as onDrop.
+// At most one warn per intervalMs per call site; resets the drop counter after each warn.
+export function createRateLimitedDropWarn(logger, context, intervalMs = 1000) {
+    let lastWarnAt = 0;
+    let dropCount = 0;
+    return () => {
+        dropCount++;
+        const now = Date.now();
+        if (now - lastWarnAt >= intervalMs) {
+            lastWarnAt = now;
+            logger.warn(`ws backpressure: ${dropCount} frame(s) dropped [${context}]`);
+            dropCount = 0;
+        }
+    };
+}
 // Performs the stream:register handshake on an already-created WebSocket.
 // Caller is responsible for creating the WebSocket and storing it for cleanup before calling this.
 export function registerStreamWs(ws, sessionId) {

package/dist/utils/stream.js.map

@@ -1 +1 @@
-{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../src/utils/stream.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,mGAAmG;AACnG,MAAM,UAAU,gBAAgB,CAAC,EAAa,EAAE,SAAiB;IAC/D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE;YACnB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,SAAS,EAAE,CAAC,CAAC,CAAA;QACjE,CAAC,CAAC,CAAA;QAEF,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,EAAE;YAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAA;YACvC,IAAI,GAAG,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;gBACrC,EAAE,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;gBACxB,OAAO,EAAE,CAAA;YACX,CAAC;QACH,CAAC,CAAA;QACD,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;QACvB,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;IAC1B,CAAC,CAAC,CAAA;AACJ,CAAC"}
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../src/utils/stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAA;AAG9B,MAAM,CAAC,MAAM,0BAA0B,GAAG,SAAS,CAAA,CAAC,OAAO;AAE3D,MAAM,UAAU,0BAA0B,CACxC,EAAa,EACb,IAAsC,EACtC,SAAiB,EACjB,MAAkB;IAElB,IAAI,EAAE,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI;QAAE,OAAM;IAC5C,IAAI,EAAE,CAAC,cAAc,IAAI,SAAS,EAAE,CAAC;QACnC,MAAM,EAAE,CAAA;QACR,OAAM;IACR,CAAC;IACD,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;AACjC,CAAC;AAED,0DAA0D;AAC1D,0FAA0F;AAC1F,MAAM,UAAU,yBAAyB,CACvC,MAAc,EACd,OAAe,EACf,UAAU,GAAG,IAAI;IAEjB,IAAI,UAAU,GAAG,CAAC,CAAA;IAClB,IAAI,SAAS,GAAG,CAAC,CAAA;IACjB,OAAO,GAAG,EAAE;QACV,SAAS,EAAE,CAAA;QACX,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACtB,IAAI,GAAG,GAAG,UAAU,IAAI,UAAU,EAAE,CAAC;YACnC,UAAU,GAAG,GAAG,CAAA;YAChB,MAAM,CAAC,IAAI,CAAC,oBAAoB,SAAS,sBAAsB,OAAO,GAAG,CAAC,CAAA;YAC1E,SAAS,GAAG,CAAC,CAAA;QACf,CAAC;IACH,CAAC,CAAA;AACH,CAAC;AAED,0EAA0E;AAC1E,mGAAmG;AACnG,MAAM,UAAU,gBAAgB,CAAC,EAAa,EAAE,SAAiB;IAC/D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE;YACnB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,SAAS,EAAE,CAAC,CAAC,CAAA;QACjE,CAAC,CAAC,CAAA;QAEF,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,EAAE;YAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAA;YACvC,IAAI,GAAG,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;gBACrC,EAAE,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;gBACxB,OAAO,EAAE,CAAA;YACX,CAAC;QACH,CAAC,CAAA;QACD,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;QACvB,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;IAC1B,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tapflowio/agent-core",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "DeviceAgent interface, AgentRegistry, and shared utilities for tapflow agents",
   "keywords": [
     "tapflow",
@@ -24,12 +24,14 @@
   "types": "dist/index.d.ts",
   "exports": {
     ".": {
+      "types": "./src/index.ts",
       "source": "./src/index.ts",
       "tsx": "./src/index.ts",
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     },
     "./utils": {
+      "types": "./src/utils/index.ts",
       "source": "./src/utils/index.ts",
       "tsx": "./src/utils/index.ts",
       "import": "./dist/utils/index.js",