@tapflowio/agent-core 0.1.0-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 tapflow contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,23 @@
+# @tapflowio/agent-core
+
+Shared interface and utilities for [tapflow](https://github.com/jo-duchan/tapflow) agents.
+
+## What's inside
+
+- `DeviceAgent` interface — implemented by `@tapflowio/ios-agent` and `@tapflowio/android-agent`
+- `AgentRegistry` — maps platform name to agent class
+- Shared types: `Device`, `DeviceStatus`, `AgentResources`, `AndroidButton`
+- Internal utilities: `createResourceSampler`, `registerStreamWs` (used by agent implementations)
+
+## Usage
+
+This package is consumed by agent implementations and the tapflow CLI. You don't need to install it directly.
+
+```ts
+import type { DeviceAgent, Device } from '@tapflowio/agent-core'
+import { AgentRegistry } from '@tapflowio/agent-core'
+```
+
+## License
+
+[MIT](LICENSE) — part of the [tapflow](https://github.com/jo-duchan/tapflow) project.

package/dist/AgentRegistry.d.ts

@@ -0,0 +1,7 @@
+import type { DeviceAgent, DeviceAgentConstructor } from './DeviceAgent.js';
+export declare const AgentRegistry: {
+    register(platform: string, AgentClass: DeviceAgentConstructor): void;
+    get(platform: string): DeviceAgent;
+    clear(): void;
+};
+//# sourceMappingURL=AgentRegistry.d.ts.map

package/dist/AgentRegistry.d.ts.map

@@ -0,0 +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"}

package/dist/AgentRegistry.js

@@ -0,0 +1,23 @@
+const constructors = new Map();
+const instances = new Map();
+export const AgentRegistry = {
+    register(platform, AgentClass) {
+        constructors.set(platform, AgentClass);
+        instances.delete(platform);
+    },
+    get(platform) {
+        if (!constructors.has(platform)) {
+            throw new Error(`No agent registered for platform: ${platform}`);
+        }
+        if (!instances.has(platform)) {
+            const AgentClass = constructors.get(platform);
+            instances.set(platform, new AgentClass());
+        }
+        return instances.get(platform);
+    },
+    clear() {
+        constructors.clear();
+        instances.clear();
+    },
+};
+//# sourceMappingURL=AgentRegistry.js.map

package/dist/AgentRegistry.js.map

@@ -0,0 +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"}

package/dist/DeviceAgent.d.ts

@@ -0,0 +1,15 @@
+import type { Device } from './types.js';
+export interface DeviceAgent {
+    listDevices(): Promise<Device[]>;
+    boot(deviceId: string): Promise<void>;
+    shutdown(deviceId: string): Promise<void>;
+    installApp(path: string): Promise<void>;
+    launchApp(bundleId: string): Promise<void>;
+    screenshot(): Promise<Buffer>;
+    stream(): ReadableStream<Buffer>;
+    touchStart(x: number, y: number): void;
+    touchMove(x: number, y: number): Promise<void>;
+    touchEnd(): Promise<void>;
+}
+export type DeviceAgentConstructor = new () => DeviceAgent;
+//# sourceMappingURL=DeviceAgent.d.ts.map

package/dist/DeviceAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeviceAgent.d.ts","sourceRoot":"","sources":["../src/DeviceAgent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAExC,MAAM,WAAW,WAAW;IAC1B,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAChC,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACzC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACvC,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1C,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;IAC7B,MAAM,IAAI,cAAc,CAAC,MAAM,CAAC,CAAA;IAChC,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtC,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1B;AAED,MAAM,MAAM,sBAAsB,GAAG,UAAU,WAAW,CAAA"}

package/dist/DeviceAgent.js

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

package/dist/DeviceAgent.js.map

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

package/dist/index.d.ts

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

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { AgentRegistry } from './AgentRegistry.js';
+export { createLogger } from './logger.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":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA"}

package/dist/logger.d.ts

@@ -0,0 +1,9 @@
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface Logger {
+    debug(msg: string, meta?: unknown): void;
+    info(msg: string, meta?: unknown): void;
+    warn(msg: string, meta?: unknown): void;
+    error(msg: string, meta?: unknown): void;
+}
+export declare function createLogger(prefix: string): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACzC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACxC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACxC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC1C;AA+CD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/logger.js

@@ -0,0 +1,45 @@
+const LEVELS = { debug: 0, info: 1, warn: 2, error: 3 };
+function resolveLevel() {
+    const raw = process.env.LOG_LEVEL ?? 'info';
+    return LEVELS[raw] ?? LEVELS.info;
+}
+function print(fn, prefix, msg, meta) {
+    if (meta !== undefined) {
+        fn(`[${prefix}] ${msg}`, meta);
+    }
+    else {
+        fn(`[${prefix}] ${msg}`);
+    }
+}
+class ConsoleLogger {
+    prefix;
+    minLevel;
+    constructor(prefix) {
+        this.prefix = prefix;
+        this.minLevel = resolveLevel();
+    }
+    debug(msg, meta) {
+        if (this.minLevel > LEVELS.debug)
+            return;
+        print(console.debug, this.prefix, msg, meta);
+    }
+    info(msg, meta) {
+        if (this.minLevel > LEVELS.info)
+            return;
+        print(console.log, this.prefix, msg, meta);
+    }
+    warn(msg, meta) {
+        if (this.minLevel > LEVELS.warn)
+            return;
+        print(console.warn, this.prefix, msg, meta);
+    }
+    error(msg, meta) {
+        if (this.minLevel > LEVELS.error)
+            return;
+        print(console.error, this.prefix, msg, meta);
+    }
+}
+export function createLogger(prefix) {
+    return new ConsoleLogger(prefix);
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,GAA6B,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;AAElF,SAAS,YAAY;IACnB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM,CAAC;IAC5C,OAAO,MAAM,CAAC,GAAe,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC;AAChD,CAAC;AAED,SAAS,KAAK,CAAC,EAAgC,EAAE,MAAc,EAAE,GAAW,EAAE,IAAa;IACzF,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,EAAE,CAAC,IAAI,MAAM,KAAK,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC;IACjC,CAAC;SAAM,CAAC;QACN,EAAE,CAAC,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC;AAED,MAAM,aAAa;IACA,MAAM,CAAS;IACf,QAAQ,CAAS;IAElC,YAAY,MAAc;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,YAAY,EAAE,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,GAAW,EAAE,IAAc;QAC/B,IAAI,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,KAAK;YAAE,OAAO;QACzC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,CAAC,GAAW,EAAE,IAAc;QAC9B,IAAI,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,IAAI;YAAE,OAAO;QACxC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,CAAC,GAAW,EAAE,IAAc;QAC9B,IAAI,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,IAAI;YAAE,OAAO;QACxC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,GAAW,EAAE,IAAc;QAC/B,IAAI,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,KAAK;YAAE,OAAO;QACzC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IAC/C,CAAC;CACF;AAED,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,OAAO,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;AACnC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,28 @@
+export type Platform = 'ios' | 'android';
+export type DeviceStatus = 'booted' | 'shutdown' | 'unknown';
+export interface Device {
+    id: string;
+    name: string;
+    platform: Platform;
+    status: DeviceStatus;
+    typeId?: string;
+    osVersion?: string;
+}
+export interface Point {
+    x: number;
+    y: number;
+}
+export interface AgentResources {
+    cpuPercent: number;
+    memUsedMB: number;
+    memTotalMB: number;
+    slotsAvailable: number;
+    slotsTotal: number;
+    reportedAt: number;
+}
+export interface AndroidButton {
+    name: string;
+    accessibilityTitle: string;
+    keyCode: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAA;AAExC,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAA;AAE5D,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,QAAQ,CAAA;IAClB,MAAM,EAAE,YAAY,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,KAAK;IACpB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,cAAc,EAAE,MAAM,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;CACnB;AAGD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,kBAAkB,EAAE,MAAM,CAAA;IAC1B,OAAO,EAAE,MAAM,CAAA;CAChB"}

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/dist/utils/index.d.ts

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

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

@@ -0,0 +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"}

package/dist/utils/index.js

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

package/dist/utils/index.js.map

@@ -0,0 +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"}

package/dist/utils/resources.d.ts

@@ -0,0 +1,8 @@
+export declare function createResourceSampler(): {
+    getCpuPercent: () => number;
+    getMemoryUsage: () => {
+        memUsedMB: number;
+        memTotalMB: number;
+    };
+};
+//# sourceMappingURL=resources.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../src/utils/resources.ts"],"names":[],"mappings":"AAGA,wBAAgB,qBAAqB;yBAGT,MAAM;0BAmBL;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;EAmBrE"}

package/dist/utils/resources.js

@@ -0,0 +1,45 @@
+import os from 'os';
+import { spawnSync } from 'child_process';
+export function createResourceSampler() {
+    let lastCpuTimes = null;
+    function getCpuPercent() {
+        let idle = 0, total = 0;
+        for (const cpu of os.cpus()) {
+            const t = cpu.times;
+            idle += t.idle;
+            total += t.user + t.nice + t.sys + t.idle + t.irq;
+        }
+        if (!lastCpuTimes) {
+            lastCpuTimes = { idle, total };
+            return 0;
+        }
+        const idleDiff = idle - lastCpuTimes.idle;
+        const totalDiff = total - lastCpuTimes.total;
+        lastCpuTimes = { idle, total };
+        if (totalDiff === 0)
+            return 0;
+        return Math.min(100, Math.round((1 - idleDiff / totalDiff) * 1000) / 10);
+    }
+    // macOS: active + wired + compressed pages only. Falls back to os.freemem() on other OS.
+    function getMemoryUsage() {
+        const memTotalMB = Math.round(os.totalmem() / 1024 / 1024);
+        try {
+            const { stdout, status } = spawnSync('vm_stat', [], { encoding: 'utf8' });
+            if (status !== 0 || !stdout)
+                throw new Error('vm_stat failed');
+            const lines = stdout.split('\n');
+            const pageSize = parseInt(lines[0]?.match(/page size of (\d+)/)?.[1] ?? '16384');
+            const get = (key) => {
+                const m = lines.find((l) => l.startsWith(key))?.match(/:\s*(\d+)/);
+                return parseInt(m?.[1] ?? '0');
+            };
+            const pages = get('Pages active') + get('Pages wired down') + get('Pages occupied by compressor');
+            return { memUsedMB: Math.round(pages * pageSize / 1024 / 1024), memTotalMB };
+        }
+        catch {
+            return { memUsedMB: Math.round((os.totalmem() - os.freemem()) / 1024 / 1024), memTotalMB };
+        }
+    }
+    return { getCpuPercent, getMemoryUsage };
+}
+//# sourceMappingURL=resources.js.map

package/dist/utils/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../src/utils/resources.ts"],"names":[],"mappings":"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"}

package/dist/utils/stream.d.ts

@@ -0,0 +1,3 @@
+import { WebSocket } from 'ws';
+export declare function registerStreamWs(ws: WebSocket, sessionId: string): Promise<void>;
+//# sourceMappingURL=stream.d.ts.map

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

@@ -0,0 +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"}

package/dist/utils/stream.js

@@ -0,0 +1,19 @@
+// 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) {
+    return new Promise((resolve, reject) => {
+        ws.once('open', () => {
+            ws.send(JSON.stringify({ type: 'stream:register', sessionId }));
+        });
+        const onMsg = (data) => {
+            const msg = JSON.parse(data.toString());
+            if (msg.type === 'stream:registered') {
+                ws.off('message', onMsg);
+                resolve();
+            }
+        };
+        ws.on('message', onMsg);
+        ws.once('error', reject);
+    });
+}
+//# sourceMappingURL=stream.js.map

package/dist/utils/stream.js.map

@@ -0,0 +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"}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@tapflowio/agent-core",
+  "version": "0.1.0-alpha.1",
+  "description": "DeviceAgent interface, AgentRegistry, and shared utilities for tapflow agents",
+  "keywords": [
+    "tapflow",
+    "ios",
+    "android",
+    "simulator",
+    "emulator",
+    "device-agent"
+  ],
+  "homepage": "https://github.com/jo-duchan/tapflow",
+  "bugs": "https://github.com/jo-duchan/tapflow/issues",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jo-duchan/tapflow.git",
+    "directory": "packages/agent-core"
+  },
+  "license": "MIT",
+  "author": "tapflow contributors",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "tsx": "./src/index.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./utils": {
+      "source": "./src/utils/index.ts",
+      "tsx": "./src/utils/index.ts",
+      "import": "./dist/utils/index.js",
+      "default": "./dist/utils/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "ws": "^8.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/ws": "^8.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^2.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "lint": "eslint src"
+  }
+}