@openagentsy/hooks 0.0.0-stage → 0.2.1

package/dist/shell-env.js

@@ -0,0 +1,34 @@
+/**
+ * The environment every agent shell sees.
+ *
+ * The shell env hook tightens only: it removes the switches that skip the
+ * hooks and the keys that belong to the board, and it marks the shell as
+ * an agent's. It never adds a credential, because a credential in a shell
+ * is a credential in every log the shell writes.
+ */
+/** The variables that are removed. */
+export const STRIPPED_ENV_VARS = [
+    'HUSKY',
+    'HUSKY_SKIP_HOOKS',
+    'SKIP_SIMPLE_GIT_HOOKS',
+    'TOGETHER_API_KEY',
+    'TYPESAFE_API_KEY',
+];
+/**
+ * Apply the policy to a shell environment.
+ *
+ * The environment is changed in place, because that is the shape the host
+ * hands over: the shell env hook fills an object and the shell reads it, and
+ * the V2 shell domain hands the plugin the same object before the child is
+ * spawned.
+ *
+ * The values are optional, because the V2 event types the environment of a
+ * shell that way. A key that is absent is a key that is not there.
+ */
+export function applyShellEnvPolicy(env) {
+    for (const key of STRIPPED_ENV_VARS)
+        delete env[key];
+    env.TURBO_TELEMETRY_DISABLED = '1';
+    env.OPENAGENTSY_AGENT = '1';
+}
+//# sourceMappingURL=shell-env.js.map

package/dist/shell-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-env.js","sourceRoot":"","sources":["../src/shell-env.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,sCAAsC;AACtC,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,OAAO;IACP,kBAAkB;IAClB,uBAAuB;IACvB,kBAAkB;IAClB,kBAAkB;CACV,CAAC;AAEX;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAuC;IACzE,KAAK,MAAM,GAAG,IAAI,iBAAiB;QAAE,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;IACrD,GAAG,CAAC,wBAAwB,GAAG,GAAG,CAAC;IACnC,GAAG,CAAC,iBAAiB,GAAG,GAAG,CAAC;AAC9B,CAAC"}

package/dist/shell-env.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=shell-env.test.d.ts.map

package/dist/shell-env.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-env.test.d.ts","sourceRoot":"","sources":["../src/shell-env.test.ts"],"names":[],"mappings":""}

package/dist/shell-env.test.js

@@ -0,0 +1,45 @@
+import { describe, expect, it } from 'vitest';
+import { applyShellEnvPolicy } from './shell-env.js';
+describe('applyShellEnvPolicy', () => {
+    it('takes the skip switches and the board keys out', () => {
+        const env = {
+            HUSKY: '0',
+            HUSKY_SKIP_HOOKS: '1',
+            SKIP_SIMPLE_GIT_HOOKS: '1',
+            TOGETHER_API_KEY: 'a-key',
+            TYPESAFE_API_KEY: 'a-key',
+            PATH: '/usr/bin',
+        };
+        applyShellEnvPolicy(env);
+        expect(env.HUSKY).toBeUndefined();
+        expect(env.HUSKY_SKIP_HOOKS).toBeUndefined();
+        expect(env.SKIP_SIMPLE_GIT_HOOKS).toBeUndefined();
+        expect(env.TOGETHER_API_KEY).toBeUndefined();
+        expect(env.TYPESAFE_API_KEY).toBeUndefined();
+        expect(env.PATH).toBe('/usr/bin');
+    });
+    it('turns the telemetry off and marks the shell as an agent', () => {
+        const env = {};
+        applyShellEnvPolicy(env);
+        expect(env.TURBO_TELEMETRY_DISABLED).toBe('1');
+        expect(env.OPENAGENTSY_AGENT).toBe('1');
+    });
+    it('never adds anything else', () => {
+        const env = {};
+        applyShellEnvPolicy(env);
+        expect(Object.keys(env).sort()).toEqual(['OPENAGENTSY_AGENT', 'TURBO_TELEMETRY_DISABLED']);
+    });
+    it('takes a key out of an environment that holds an absent value', () => {
+        // The V2 event types the environment of a shell that way: a value may be
+        // absent. The policy is the same either way.
+        const env = {
+            TYPESAFE_API_KEY: 'a-key',
+            PATH: undefined,
+        };
+        applyShellEnvPolicy(env);
+        expect(env.TYPESAFE_API_KEY).toBeUndefined();
+        expect(env.PATH).toBeUndefined();
+        expect(env.OPENAGENTSY_AGENT).toBe('1');
+    });
+});
+//# sourceMappingURL=shell-env.test.js.map

package/dist/shell-env.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-env.test.js","sourceRoot":"","sources":["../src/shell-env.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAErD,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,GAAG,GAA2B;YAClC,KAAK,EAAE,GAAG;YACV,gBAAgB,EAAE,GAAG;YACrB,qBAAqB,EAAE,GAAG;YAC1B,gBAAgB,EAAE,OAAO;YACzB,gBAAgB,EAAE,OAAO;YACzB,IAAI,EAAE,UAAU;SACjB,CAAC;QACF,mBAAmB,CAAC,GAAG,CAAC,CAAC;QACzB,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,aAAa,EAAE,CAAC;QAClC,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,aAAa,EAAE,CAAC;QAC7C,MAAM,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC,aAAa,EAAE,CAAC;QAClD,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,aAAa,EAAE,CAAC;QAC7C,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,aAAa,EAAE,CAAC;QAC7C,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,GAAG,GAA2B,EAAE,CAAC;QACvC,mBAAmB,CAAC,GAAG,CAAC,CAAC;QACzB,MAAM,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/C,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,GAAG,GAA2B,EAAE,CAAC;QACvC,mBAAmB,CAAC,GAAG,CAAC,CAAC;QACzB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,mBAAmB,EAAE,0BAA0B,CAAC,CAAC,CAAC;IAC7F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,yEAAyE;QACzE,6CAA6C;QAC7C,MAAM,GAAG,GAAuC;YAC9C,gBAAgB,EAAE,OAAO;YACzB,IAAI,EAAE,SAAS;SAChB,CAAC;QACF,mBAAmB,CAAC,GAAG,CAAC,CAAC;QACzB,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,aAAa,EAAE,CAAC;QAC7C,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC;QACjC,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,51 @@
 {
   "name": "@openagentsy/hooks",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.1",
+  "author": "Grand Slopulissimo <slopulissimo@voxslopuli.org>",
+  "type": "module",
+  "exports": {
+    ".": "./dist/index.js",
+    "./*": "./dist/*.js"
+  },
+  "types": "./dist/index.d.ts",
+  "main": "./dist/index.js",
+  "scripts": {
+    "build": "tsc -b tsconfig.json",
+    "typecheck": "tsc -b tsconfig.json"
+  },
+  "dependencies": {
+    "@openagentsy/core": "^0.2.1",
+    "@openagentsy/quality": "^0.2.1",
+    "zod": "4.6.7"
+  },
+  "devDependencies": {
+    "@types/node": "^24.3.0",
+    "typescript": "^5.9.2"
+  },
+  "license": "GPL-3.0-or-later",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/voxslopuli/openagentsy.git"
+  },
+  "homepage": "https://github.com/voxslopuli/openagentsy#readme",
+  "bugs": {
+    "url": "https://github.com/voxslopuli/openagentsy/issues"
+  },
+  "engines": {
+    "node": ">=22.5.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "The OpenAgentsy guardrails: the rule registry, the default rules, the output checks, the shell policy and the approval gate.",
+  "keywords": [
+    "agents",
+    "hooks",
+    "guardrails",
+    "policy",
+    "opencode"
+  ],
+  "files": [
+    "dist"
+  ]
+}