@interchained/portal-agent 0.1.0

package/dist/sentinel.js

@@ -0,0 +1,75 @@
+/**
+ * Sentinel — reviews Runner output before it touches the codebase.
+ *
+ * The sentinel is a stronger/slower model that:
+ * 1. Checks that the patch actually fixes what it claims to fix
+ * 2. Verifies no forbidden claims or brand violations were introduced
+ * 3. Confirms the change is faithful to the app contract
+ * 4. Produces a human-readable review summary for the approval UI
+ */
+import { AiAssistClient } from "./aiassist.js";
+export class Sentinel {
+    client;
+    constructor(config = {}) {
+        this.client = new AiAssistClient({
+            apiKey: config.apiKey ?? process.env["AIASSIST_API_KEY"] ?? process.env["VITE_AIAS_API_KEY"] ?? "",
+            baseUrl: config.baseUrl,
+            model: config.model ?? "gpt-4o",
+            timeoutMs: config.timeoutMs ?? 90_000,
+        });
+    }
+    /** Review a generated patch against the app contract */
+    async review(opts) {
+        const contractStr = JSON.stringify(opts.contract, null, 2);
+        const prompt = `You are a code sentinel reviewing an AI-generated patch.
+Your job: verify the patch is safe, faithful to the app contract, and actually fixes what it claims.
+
+App Contract:
+\`\`\`json
+${contractStr}
+\`\`\`
+
+Agent task: ${opts.agentTask}
+File: ${opts.filePath}
+
+ORIGINAL:
+\`\`\`tsx
+${opts.original}
+\`\`\`
+
+PROPOSED PATCH:
+\`\`\`tsx
+${opts.proposed}
+\`\`\`
+
+Check for:
+1. Forbidden claims from policies.forbiddenClaims
+2. Forbidden phrases from brand.forbiddenPhrases
+3. Changed brand colors without explicit permission
+4. Hallucinated data (phone numbers, prices, names not in data sources)
+5. Whether the patch faithfully serves the stated goals
+6. Whether it actually fixes the agent task
+
+Respond as JSON:
+{
+  "approved": true/false,
+  "summary": "one sentence summary of what the patch does",
+  "violations": ["list of issues if any"],
+  "annotations": [{"line": null, "type": "ok|warning|violation", "note": "..."}]
+}`;
+        const raw = await this.client.complete(prompt, undefined, { temperature: 0.1, maxTokens: 2_000 });
+        try {
+            const jsonStr = raw.replace(/^```json\s*/i, "").replace(/\s*```$/, "").trim();
+            return JSON.parse(jsonStr);
+        }
+        catch {
+            return {
+                approved: false,
+                summary: "Sentinel could not parse its own review — manual review required.",
+                violations: ["Unparseable sentinel response"],
+                annotations: [],
+            };
+        }
+    }
+}
+//# sourceMappingURL=sentinel.js.map

package/dist/sentinel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sentinel.js","sourceRoot":"","sources":["../src/sentinel.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,cAAc,EAAuB,MAAM,eAAe,CAAC;AAepE,MAAM,OAAO,QAAQ;IACX,MAAM,CAAiB;IAE/B,YAAY,SAAkC,EAAE;QAC9C,IAAI,CAAC,MAAM,GAAG,IAAI,cAAc,CAAC;YAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,EAAE;YAClG,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,QAAQ;YAC/B,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,MAAM;SACtC,CAAC,CAAC;IACL,CAAC;IAED,wDAAwD;IACxD,KAAK,CAAC,MAAM,CAAC,IAMZ;QACC,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAE3D,MAAM,MAAM,GAAG;;;;;EAKjB,WAAW;;;cAGC,IAAI,CAAC,SAAS;QACpB,IAAI,CAAC,QAAQ;;;;EAInB,IAAI,CAAC,QAAQ;;;;;EAKb,IAAI,CAAC,QAAQ;;;;;;;;;;;;;;;;;EAiBb,CAAC;QAEC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QAElG,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAC9E,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAmB,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;gBACL,QAAQ,EAAE,KAAK;gBACf,OAAO,EAAE,mEAAmE;gBAC5E,UAAU,EAAE,CAAC,+BAA+B,CAAC;gBAC7C,WAAW,EAAE,EAAE;aAChB,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@interchained/portal-agent",
+  "version": "0.1.0",
+  "description": "Agent runtime for Portal — AiAssist.net runner/sentinel, audit, generate, improve, guard",
+  "license": "GPL-3.0-or-later",
+  "author": "Interchained <dev@interchained.org>",
+  "type": "module",
+  "exports": {
+    ".": { "import": "./dist/index.js", "types": "./dist/index.d.ts" }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": ["dist", "README.md", "LICENSE"],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run typecheck && npm run build"
+  },
+  "dependencies": {
+    "@interchained/portal-contract": "workspace:*",
+    "picocolors": "^1.0.1",
+    "ora": "^8.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.12.7",
+    "typescript": "^5.4.5"
+  },
+  "engines": { "node": ">=18" },
+  "publishConfig": { "access": "public" }
+}