@agent-tool-calls/machine 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @agent-tool-calls/machine — cross-platform OS operations.
+ *
+ * Real Mac implementation + Windows stub. Platform is selected at runtime.
+ * No Timmy or AI-framework imports — this stays a plain, reusable library.
+ */
+import type { MachineAdapter } from './types';
+export * from './types';
+export type Platform = 'mac' | 'windows' | 'linux';
+export declare function currentPlatform(): Platform;
+export declare function createMachine(): MachineAdapter;

package/dist/index.js

@@ -0,0 +1,48 @@
+"use strict";
+/**
+ * @agent-tool-calls/machine — cross-platform OS operations.
+ *
+ * Real Mac implementation + Windows stub. Platform is selected at runtime.
+ * No Timmy or AI-framework imports — this stays a plain, reusable library.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.currentPlatform = currentPlatform;
+exports.createMachine = createMachine;
+const mac_1 = require("./mac");
+const windows_1 = require("./windows");
+__exportStar(require("./types"), exports);
+function currentPlatform() {
+    switch (process.platform) {
+        case 'win32':
+            return 'windows';
+        case 'darwin':
+            return 'mac';
+        default:
+            return 'linux';
+    }
+}
+function createMachine() {
+    switch (process.platform) {
+        case 'win32':
+            return new windows_1.WindowsAdapter();
+        case 'darwin':
+            return new mac_1.MacAdapter();
+        default:
+            throw new Error(`@agent-tool-calls/machine: platform '${process.platform}' is not supported yet (only macOS; Windows stub lands in Phase 11)`);
+    }
+}
+//# 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;;;;;GAKG;;;;;;;;;;;;;;;;AAUH,0CASC;AAED,sCAWC;AA9BD,+BAAkC;AAClC,uCAA0C;AAG1C,0CAAuB;AAIvB,SAAgB,eAAe;IAC7B,QAAQ,OAAO,CAAC,QAAQ,EAAE,CAAC;QACzB,KAAK,OAAO;YACV,OAAO,SAAS,CAAA;QAClB,KAAK,QAAQ;YACX,OAAO,KAAK,CAAA;QACd;YACE,OAAO,OAAO,CAAA;IAClB,CAAC;AACH,CAAC;AAED,SAAgB,aAAa;IAC3B,QAAQ,OAAO,CAAC,QAAQ,EAAE,CAAC;QACzB,KAAK,OAAO;YACV,OAAO,IAAI,wBAAc,EAAE,CAAA;QAC7B,KAAK,QAAQ;YACX,OAAO,IAAI,gBAAU,EAAE,CAAA;QACzB;YACE,MAAM,IAAI,KAAK,CACb,wCAAwC,OAAO,CAAC,QAAQ,qEAAqE,CAC9H,CAAA;IACL,CAAC;AACH,CAAC"}

package/dist/mac.d.ts

@@ -0,0 +1,11 @@
+import type { FileEntry, MachineAdapter, ProcessInfo, Runner } from './types';
+export declare class MacAdapter implements MachineAdapter {
+    private readonly run;
+    constructor(run?: Runner);
+    openApp(name: string): Promise<void>;
+    playMedia(uri: string): Promise<void>;
+    listDirectory(path: string): Promise<FileEntry[]>;
+    deleteFile(path: string): Promise<void>;
+    killProcess(pid: number): Promise<void>;
+    getRunningProcesses(): Promise<ProcessInfo[]>;
+}

package/dist/mac.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MacAdapter = void 0;
+const promises_1 = require("node:fs/promises");
+const node_child_process_1 = require("node:child_process");
+const node_util_1 = require("node:util");
+const defaultRunner = async (cmd, args) => {
+    const { stdout } = await (0, node_util_1.promisify)(node_child_process_1.execFile)(cmd, args);
+    return { stdout };
+};
+class MacAdapter {
+    run;
+    constructor(run = defaultRunner) {
+        this.run = run;
+    }
+    async openApp(name) {
+        await this.run('open', ['-a', name]);
+    }
+    async playMedia(uri) {
+        await this.run('open', [uri]);
+    }
+    async listDirectory(path) {
+        const ents = await (0, promises_1.readdir)(path, { withFileTypes: true });
+        return ents.map((e) => ({ name: e.name, isDirectory: e.isDirectory() }));
+    }
+    async deleteFile(path) {
+        await (0, promises_1.rm)(path);
+    }
+    async killProcess(pid) {
+        process.kill(pid);
+    }
+    async getRunningProcesses() {
+        const { stdout } = await this.run('ps', ['-axo', 'pid=,comm=']);
+        return stdout
+            .trim()
+            .split('\n')
+            .map((line) => {
+            const m = line.trim().match(/^(\d+)\s+(.*)$/);
+            return m ? { pid: Number(m[1]), name: m[2] } : null;
+        })
+            .filter((p) => p !== null);
+    }
+}
+exports.MacAdapter = MacAdapter;
+//# sourceMappingURL=mac.js.map

package/dist/mac.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mac.js","sourceRoot":"","sources":["../src/mac.ts"],"names":[],"mappings":";;;AAAA,+CAA8C;AAC9C,2DAA6C;AAC7C,yCAAqC;AAGrC,MAAM,aAAa,GAAW,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;IAChD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAA,qBAAS,EAAC,6BAAQ,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IACvD,OAAO,EAAE,MAAM,EAAE,CAAA;AACnB,CAAC,CAAA;AAED,MAAa,UAAU;IACQ;IAA7B,YAA6B,MAAc,aAAa;QAA3B,QAAG,GAAH,GAAG,CAAwB;IAAG,CAAC;IAE5D,KAAK,CAAC,OAAO,CAAC,IAAY;QACxB,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAA;IACtC,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,GAAW;QACzB,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;IAC/B,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,IAAY;QAC9B,MAAM,IAAI,GAAG,MAAM,IAAA,kBAAO,EAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAA;QACzD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAA;IAC1E,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,IAAY;QAC3B,MAAM,IAAA,aAAE,EAAC,IAAI,CAAC,CAAA;IAChB,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,GAAW;QAC3B,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACnB,CAAC;IAED,KAAK,CAAC,mBAAmB;QACvB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAA;QAC/D,OAAO,MAAM;aACV,IAAI,EAAE;aACN,KAAK,CAAC,IAAI,CAAC;aACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACZ,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAA;YAC7C,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;QACrD,CAAC,CAAC;aACD,MAAM,CAAC,CAAC,CAAC,EAAoB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAA;IAChD,CAAC;CACF;AAnCD,gCAmCC"}

package/dist/types.d.ts

@@ -0,0 +1,20 @@
+export interface FileEntry {
+    name: string;
+    isDirectory: boolean;
+}
+export interface ProcessInfo {
+    pid: number;
+    name: string;
+}
+/** Injectable shell runner so adapters are unit-testable without real side effects. */
+export type Runner = (cmd: string, args: string[]) => Promise<{
+    stdout: string;
+}>;
+export interface MachineAdapter {
+    openApp(name: string): Promise<void>;
+    playMedia(uri: string): Promise<void>;
+    listDirectory(path: string): Promise<FileEntry[]>;
+    deleteFile(path: string): Promise<void>;
+    killProcess(pid: number): Promise<void>;
+    getRunningProcesses(): Promise<ProcessInfo[]>;
+}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# 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/windows.d.ts

@@ -0,0 +1,9 @@
+import type { MachineAdapter } from './types';
+export declare class WindowsAdapter implements MachineAdapter {
+    openApp: () => Promise<never>;
+    playMedia: () => Promise<never>;
+    listDirectory: () => Promise<never>;
+    deleteFile: () => Promise<never>;
+    killProcess: () => Promise<never>;
+    getRunningProcesses: () => Promise<never>;
+}

package/dist/windows.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WindowsAdapter = void 0;
+const ni = (op) => async () => {
+    throw new Error(`WindowsAdapter.${op} not implemented (Phase 11 Windows port)`);
+};
+class WindowsAdapter {
+    openApp = ni('openApp');
+    playMedia = ni('playMedia');
+    listDirectory = ni('listDirectory');
+    deleteFile = ni('deleteFile');
+    killProcess = ni('killProcess');
+    getRunningProcesses = ni('getRunningProcesses');
+}
+exports.WindowsAdapter = WindowsAdapter;
+//# sourceMappingURL=windows.js.map

package/dist/windows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"windows.js","sourceRoot":"","sources":["../src/windows.ts"],"names":[],"mappings":";;;AAEA,MAAM,EAAE,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,KAAK,IAAoB,EAAE;IACpD,MAAM,IAAI,KAAK,CAAC,kBAAkB,EAAE,0CAA0C,CAAC,CAAA;AACjF,CAAC,CAAA;AAED,MAAa,cAAc;IACzB,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;IACvB,SAAS,GAAG,EAAE,CAAC,WAAW,CAAC,CAAA;IAC3B,aAAa,GAAG,EAAE,CAAC,eAAe,CAAC,CAAA;IACnC,UAAU,GAAG,EAAE,CAAC,YAAY,CAAC,CAAA;IAC7B,WAAW,GAAG,EAAE,CAAC,aAAa,CAAC,CAAA;IAC/B,mBAAmB,GAAG,EAAE,CAAC,qBAAqB,CAAC,CAAA;CAChD;AAPD,wCAOC"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@agent-tool-calls/machine",
+  "version": "0.1.0",
+  "description": "Cross-platform OS operations — open apps, play media, list/delete files, manage processes",
+  "keywords": [
+    "os",
+    "automation",
+    "agent",
+    "tools",
+    "macos"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/omatsetyadi/agent-tool-calls.git",
+    "directory": "packages/machine"
+  },
+  "homepage": "https://github.com/omatsetyadi/agent-tool-calls#readme",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^6.0.0",
+    "vitest": "^3.2.6"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  }
+}