@orgloop/transform-agent-gate 0.1.8

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OrgLoop 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/dist/agent-gate.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Agent-gate transform — gates events on running agent sessions.
+ *
+ * Shells out to `agent-ctl list --json` and checks if any sessions matching
+ * the configured filter are still running. If sessions ARE running, the event
+ * is dropped (returns null). If NO matching sessions are running, the event
+ * passes through.
+ *
+ * Fails open: CLI errors pass the event through rather than blocking.
+ */
+import type { OrgLoopEvent, Transform, TransformContext } from '@orgloop/sdk';
+export interface AgentGateConfig {
+    /** Path to agent-ctl binary (default: "agent-ctl") */
+    binary_path?: string;
+    /** Only count sessions from this adapter (e.g. "claude-code") */
+    adapter_filter?: string;
+    /** Only count sessions with these statuses as "running" (default: ["running"]) */
+    active_statuses?: string[];
+    /** Timeout for CLI call in ms (default: 5000) */
+    timeout?: number;
+}
+interface AgentSession {
+    status: string;
+    adapter: string;
+    [key: string]: unknown;
+}
+/**
+ * Execute agent-ctl list --json and parse the output.
+ * Exported for testability (allows mocking in tests).
+ */
+export declare function execAgentCtl(binaryPath: string, timeoutMs: number): Promise<AgentSession[]>;
+export declare class AgentGateTransform implements Transform {
+    readonly id = "agent-gate";
+    private binaryPath;
+    private adapterFilter;
+    private activeStatuses;
+    private timeoutMs;
+    /** Override for testing — allows injecting a mock executor */
+    _execFn: typeof execAgentCtl;
+    init(config: Record<string, unknown>): Promise<void>;
+    execute(event: OrgLoopEvent, _context: TransformContext): Promise<OrgLoopEvent | null>;
+    shutdown(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=agent-gate.d.ts.map

package/dist/agent-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-gate.d.ts","sourceRoot":"","sources":["../src/agent-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAE9E,MAAM,WAAW,eAAe;IAC/B,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kFAAkF;IAClF,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,YAAY;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAQD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAgB3F;AAED,qBAAa,kBAAmB,YAAW,SAAS;IACnD,QAAQ,CAAC,EAAE,gBAAgB;IAC3B,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,cAAc,CAAqC;IAC3D,OAAO,CAAC,SAAS,CAAmB;IAEpC,8DAA8D;IAC9D,OAAO,EAAE,OAAO,YAAY,CAAgB;IAEtC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBpD,OAAO,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAwBtF,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B"}

package/dist/agent-gate.js

@@ -0,0 +1,80 @@
+/**
+ * Agent-gate transform — gates events on running agent sessions.
+ *
+ * Shells out to `agent-ctl list --json` and checks if any sessions matching
+ * the configured filter are still running. If sessions ARE running, the event
+ * is dropped (returns null). If NO matching sessions are running, the event
+ * passes through.
+ *
+ * Fails open: CLI errors pass the event through rather than blocking.
+ */
+import { execFile } from 'node:child_process';
+const KNOWN_CONFIG_KEYS = new Set(['binary_path', 'adapter_filter', 'active_statuses', 'timeout']);
+const DEFAULT_BINARY = 'agent-ctl';
+const DEFAULT_ACTIVE_STATUSES = ['running'];
+const DEFAULT_TIMEOUT = 5000;
+/**
+ * Execute agent-ctl list --json and parse the output.
+ * Exported for testability (allows mocking in tests).
+ */
+export function execAgentCtl(binaryPath, timeoutMs) {
+    return new Promise((resolve, reject) => {
+        execFile(binaryPath, ['list', '--json'], { timeout: timeoutMs }, (error, stdout) => {
+            if (error) {
+                reject(error);
+                return;
+            }
+            try {
+                const parsed = JSON.parse(stdout);
+                const sessions = Array.isArray(parsed) ? parsed : (parsed.sessions ?? []);
+                resolve(sessions);
+            }
+            catch (parseError) {
+                reject(new Error(`Failed to parse agent-ctl output: ${parseError}`));
+            }
+        });
+    });
+}
+export class AgentGateTransform {
+    id = 'agent-gate';
+    binaryPath = DEFAULT_BINARY;
+    adapterFilter;
+    activeStatuses = DEFAULT_ACTIVE_STATUSES;
+    timeoutMs = DEFAULT_TIMEOUT;
+    /** Override for testing — allows injecting a mock executor */
+    _execFn = execAgentCtl;
+    async init(config) {
+        const unknownKeys = Object.keys(config).filter((k) => !KNOWN_CONFIG_KEYS.has(k));
+        if (unknownKeys.length > 0) {
+            throw new Error(`Agent-gate transform: unknown config keys: ${unknownKeys.join(', ')}. ` +
+                `Valid keys are: ${[...KNOWN_CONFIG_KEYS].join(', ')}`);
+        }
+        const c = config;
+        this.binaryPath = c.binary_path ?? DEFAULT_BINARY;
+        this.adapterFilter = c.adapter_filter;
+        this.activeStatuses = c.active_statuses ?? DEFAULT_ACTIVE_STATUSES;
+        this.timeoutMs = c.timeout ?? DEFAULT_TIMEOUT;
+    }
+    async execute(event, _context) {
+        let sessions;
+        try {
+            sessions = await this._execFn(this.binaryPath, this.timeoutMs);
+        }
+        catch {
+            // Fail open — if we can't check, let the event through
+            return event;
+        }
+        const activeSessions = sessions.filter((s) => this.activeStatuses.includes(s.status) &&
+            (!this.adapterFilter || s.adapter === this.adapterFilter));
+        // If active sessions exist, gate is closed — drop the event
+        if (activeSessions.length > 0) {
+            return null;
+        }
+        // No active sessions — gate is open, pass through
+        return event;
+    }
+    async shutdown() {
+        // No resources to clean up
+    }
+}
+//# sourceMappingURL=agent-gate.js.map

package/dist/agent-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-gate.js","sourceRoot":"","sources":["../src/agent-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAoB9C,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,CAAC,aAAa,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,SAAS,CAAC,CAAC,CAAC;AAEnG,MAAM,cAAc,GAAG,WAAW,CAAC;AACnC,MAAM,uBAAuB,GAAG,CAAC,SAAS,CAAC,CAAC;AAC5C,MAAM,eAAe,GAAG,IAAI,CAAC;AAE7B;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,UAAkB,EAAE,SAAiB;IACjE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACtC,QAAQ,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;YAClF,IAAI,KAAK,EAAE,CAAC;gBACX,MAAM,CAAC,KAAK,CAAC,CAAC;gBACd,OAAO;YACR,CAAC;YACD,IAAI,CAAC;gBACJ,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBAClC,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;gBAC1E,OAAO,CAAC,QAA0B,CAAC,CAAC;YACrC,CAAC;YAAC,OAAO,UAAU,EAAE,CAAC;gBACrB,MAAM,CAAC,IAAI,KAAK,CAAC,qCAAqC,UAAU,EAAE,CAAC,CAAC,CAAC;YACtE,CAAC;QACF,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,kBAAkB;IACrB,EAAE,GAAG,YAAY,CAAC;IACnB,UAAU,GAAG,cAAc,CAAC;IAC5B,aAAa,CAAqB;IAClC,cAAc,GAAa,uBAAuB,CAAC;IACnD,SAAS,GAAG,eAAe,CAAC;IAEpC,8DAA8D;IAC9D,OAAO,GAAwB,YAAY,CAAC;IAE5C,KAAK,CAAC,IAAI,CAAC,MAA+B;QACzC,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACjF,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CACd,8CAA8C,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;gBACvE,mBAAmB,CAAC,GAAG,iBAAiB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACvD,CAAC;QACH,CAAC;QAED,MAAM,CAAC,GAAG,MAAoC,CAAC;QAC/C,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,WAAW,IAAI,cAAc,CAAC;QAClD,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC,cAAc,CAAC;QACtC,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC,eAAe,IAAI,uBAAuB,CAAC;QACnE,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,OAAO,IAAI,eAAe,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAmB,EAAE,QAA0B;QAC5D,IAAI,QAAwB,CAAC;QAC7B,IAAI,CAAC;YACJ,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAChE,CAAC;QAAC,MAAM,CAAC;YACR,uDAAuD;YACvD,OAAO,KAAK,CAAC;QACd,CAAC;QAED,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CACrC,CAAC,CAAC,EAAE,EAAE,CACL,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;YACtC,CAAC,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC,aAAa,CAAC,CAC1D,CAAC;QAEF,4DAA4D;QAC5D,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC;QACb,CAAC;QAED,kDAAkD;QAClD,OAAO,KAAK,CAAC;IACd,CAAC;IAED,KAAK,CAAC,QAAQ;QACb,2BAA2B;IAC5B,CAAC;CACD"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @orgloop/transform-agent-gate — registration entry point.
+ */
+import type { TransformRegistration } from '@orgloop/sdk';
+export declare function register(): TransformRegistration;
+export { AgentGateTransform } from './agent-gate.js';
+export type { AgentGateConfig } from './agent-gate.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;;GAEG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAG1D,wBAAgB,QAAQ,IAAI,qBAAqB,CA+BhD;AAED,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,38 @@
+/**
+ * @orgloop/transform-agent-gate — registration entry point.
+ */
+import { AgentGateTransform } from './agent-gate.js';
+export function register() {
+    return {
+        id: 'agent-gate',
+        transform: AgentGateTransform,
+        configSchema: {
+            type: 'object',
+            properties: {
+                binary_path: {
+                    type: 'string',
+                    description: 'Path to agent-ctl binary.',
+                    default: 'agent-ctl',
+                },
+                adapter_filter: {
+                    type: 'string',
+                    description: 'Only count sessions from this adapter (e.g. "claude-code").',
+                },
+                active_statuses: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Statuses considered "running" (default: ["running"]).',
+                    default: ['running'],
+                },
+                timeout: {
+                    type: 'number',
+                    description: 'Timeout for CLI call in ms.',
+                    default: 5000,
+                },
+            },
+            additionalProperties: false,
+        },
+    };
+}
+export { AgentGateTransform } from './agent-gate.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;;GAEG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,UAAU,QAAQ;IACvB,OAAO;QACN,EAAE,EAAE,YAAY;QAChB,SAAS,EAAE,kBAAkB;QAC7B,YAAY,EAAE;YACb,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACX,WAAW,EAAE;oBACZ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,2BAA2B;oBACxC,OAAO,EAAE,WAAW;iBACpB;gBACD,cAAc,EAAE;oBACf,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,6DAA6D;iBAC1E;gBACD,eAAe,EAAE;oBAChB,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EAAE,uDAAuD;oBACpE,OAAO,EAAE,CAAC,SAAS,CAAC;iBACpB;gBACD,OAAO,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,6BAA6B;oBAC1C,OAAO,EAAE,IAAI;iBACb;aACD;YACD,oBAAoB,EAAE,KAAK;SAC3B;KACD,CAAC;AACH,CAAC;AAED,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@orgloop/transform-agent-gate",
+  "version": "0.1.8",
+  "description": "OrgLoop agent-gate transform — gates events on running agent sessions via agent-ctl",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "dependencies": {
+    "@orgloop/sdk": "0.1.8"
+  },
+  "orgloop": {
+    "type": "transform",
+    "id": "agent-gate"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}