@cogenta/agents 0.2.1 → 0.5.0

package/dist/tools/core/redirects.d.ts

@@ -0,0 +1,51 @@
+import { z } from 'zod';
+import type { ToolDefinition } from '../types.js';
+/**
+ * `redirects.create` — L22 task 3's one corrective action: a monitoring
+ * agent that has read `logs.read_not_found` and picked a destination (via
+ * `content.list`) hands both here. It is deliberately the *only* write this
+ * lot gives an agent onto the redirect table — editing or deleting an
+ * existing rule stays a human-only action in the admin's Redirections
+ * screen (`packages/admin/src/routes/redirects.tsx`), which this tool never
+ * touches.
+ *
+ * `reversible: true` with a real `revert`: the redirect this call created is
+ * exactly the one thing `revert` removes, by `from` — R6's bar for letting
+ * `autonomous` autonomy apply this itself without forced human approval on
+ * top of the autonomy gate.
+ *
+ * A narrow structural type, not the full `RedirectStore`: only the three
+ * methods this tool actually calls.
+ */
+export interface RedirectWriter {
+    add(input: {
+        readonly from: string;
+        readonly to: string;
+        readonly status?: 301 | 302 | 307 | 308;
+        readonly reason?: 'slug-change' | 'manual' | 'import' | 'agent';
+    }): Promise<{
+        readonly id: string;
+        readonly from: string;
+        readonly to: string;
+        readonly status: number;
+        readonly createdAt: number;
+    }>;
+    remove(from: string): Promise<boolean>;
+}
+declare const InputSchema: z.ZodObject<{
+    from: z.ZodString;
+    to: z.ZodString;
+    status: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<301>, z.ZodLiteral<302>, z.ZodLiteral<307>, z.ZodLiteral<308>]>>;
+}, z.core.$strip>;
+type Input = z.infer<typeof InputSchema>;
+declare const OutputSchema: z.ZodObject<{
+    id: z.ZodString;
+    from: z.ZodString;
+    to: z.ZodString;
+    status: z.ZodNumber;
+    createdAt: z.ZodNumber;
+}, z.core.$strip>;
+type Output = z.infer<typeof OutputSchema>;
+export declare function createRedirectCreateTool(store: RedirectWriter): ToolDefinition<Input, Output>;
+export {};
+//# sourceMappingURL=redirects.d.ts.map

package/dist/tools/core/redirects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redirects.d.ts","sourceRoot":"","sources":["../../../src/tools/core/redirects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,KAAK,EAAE;QACT,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;QACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;QACnB,QAAQ,CAAC,MAAM,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAA;QACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAA;KAChE,GAAG,OAAO,CAAC;QACV,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;QACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;QACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;QACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;QACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAC3B,CAAC,CAAA;IACF,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACvC;AAED,QAAA,MAAM,WAAW;;;;iBAOf,CAAA;AACF,KAAK,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAA;AAExC,QAAA,MAAM,YAAY;;;;;;iBAMhB,CAAA;AACF,KAAK,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA;AAE1C,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,cAAc,GAAG,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,CAgC7F"}

package/dist/tools/core/redirects.js

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+import { defineTool } from '../define.js';
+const InputSchema = z.object({
+    from: z.string().min(1),
+    to: z.string().min(1),
+    // 410 (Gone) is deliberately not offered here: this tool exists to send
+    // visitors *somewhere*, never to mark a page dead — an admin who decides
+    // that is the right call makes it by hand, in the Redirections screen.
+    status: z.union([z.literal(301), z.literal(302), z.literal(307), z.literal(308)]).optional(),
+});
+const OutputSchema = z.object({
+    id: z.string(),
+    from: z.string(),
+    to: z.string(),
+    status: z.number(),
+    createdAt: z.number(),
+});
+export function createRedirectCreateTool(store) {
+    return defineTool({
+        name: 'redirects.create',
+        version: '1.0.0',
+        description: 'Create (or replace) a redirect from one site path to another. Always recorded with reason "agent", never "manual", so it is visible in the Redirections screen as agent-made.',
+        input: InputSchema,
+        output: OutputSchema,
+        permissions: ['redirects.write'],
+        sideEffects: true,
+        reversible: true,
+        cost: 'low',
+        rateLimit: { perHour: 30 },
+        async execute(input) {
+            const record = await store.add({
+                from: input.from,
+                to: input.to,
+                ...(input.status === undefined ? {} : { status: input.status }),
+                reason: 'agent',
+            });
+            return {
+                id: record.id,
+                from: record.from,
+                to: record.to,
+                status: record.status,
+                createdAt: record.createdAt,
+            };
+        },
+        async revert(receipt) {
+            await store.remove(receipt.from);
+        },
+    });
+}
+//# sourceMappingURL=redirects.js.map

package/dist/tools/core/redirects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redirects.js","sourceRoot":"","sources":["../../../src/tools/core/redirects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAoCzC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,wEAAwE;IACxE,yEAAyE;IACzE,uEAAuE;IACvE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC7F,CAAC,CAAA;AAGF,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACtB,CAAC,CAAA;AAGF,MAAM,UAAU,wBAAwB,CAAC,KAAqB;IAC5D,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,OAAO;QAChB,WAAW,EACT,+KAA+K;QACjL,KAAK,EAAE,WAAW;QAClB,MAAM,EAAE,YAAY;QACpB,WAAW,EAAE,CAAC,iBAAiB,CAAC;QAChC,WAAW,EAAE,IAAI;QACjB,UAAU,EAAE,IAAI;QAChB,IAAI,EAAE,KAAK;QACX,SAAS,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QAC1B,KAAK,CAAC,OAAO,CAAC,KAAK;YACjB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC;gBAC7B,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,EAAE,EAAE,KAAK,CAAC,EAAE;gBACZ,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;gBAC/D,MAAM,EAAE,OAAO;aAChB,CAAC,CAAA;YACF,OAAO;gBACL,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,SAAS,EAAE,MAAM,CAAC,SAAS;aAC5B,CAAA;QACH,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,OAAO;YAClB,MAAM,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QAClC,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cogenta/agents",
-  "version": "0.2.1",
+  "version": "0.5.0",
   "description": "The agentic runtime: LLM provider abstraction, tool-calling, execution loop, permissions, memory, budgets, audit.",
   "license": "MPL-2.0",
   "type": "module",
@@ -27,10 +27,12 @@
     "directory": "packages/agents"
   },
   "dependencies": {
+    "@langchain/langgraph": "^1.4.12",
     "zod": "^4.4.3",
-    "@cogenta/core": "0.4.0",
-    "@cogenta/schema": "0.3.0",
-    "@cogenta/render": "0.1.4"
+    "@cogenta/blocks": "1.0.2",
+    "@cogenta/core": "0.7.0",
+    "@cogenta/render": "0.2.2",
+    "@cogenta/schema": "0.5.0"
   },
   "devDependencies": {
     "typescript": "^7.0.2",