@cogenta/agents 0.2.0 → 0.4.0

package/dist/tools/core/content-schema.js

@@ -0,0 +1,83 @@
+import { VOCABULARY } from '@cogenta/blocks';
+import { z } from 'zod';
+import { defineTool } from '../define.js';
+const BlockFieldOutputSchema = z.object({
+    key: z.string(),
+    kind: z.string(),
+    required: z.boolean(),
+    options: z.record(z.string(), z.unknown()),
+});
+const BlockOutputSchema = z.object({
+    name: z.string(),
+    version: z.string(),
+    fields: z.array(BlockFieldOutputSchema),
+});
+const CollectionFieldOutputSchema = z.object({
+    key: z.string(),
+    kind: z.string(),
+    label: z.string().nullable(),
+    required: z.boolean(),
+    options: z.record(z.string(), z.unknown()),
+});
+const CollectionSchemaOutputSchema = z.object({
+    collection: z.string(),
+    labelSingular: z.string(),
+    labelPlural: z.string(),
+    routed: z.boolean(),
+    fields: z.array(CollectionFieldOutputSchema),
+});
+const OutputSchema = z.object({
+    collections: z.array(CollectionSchemaOutputSchema),
+    blocks: z.array(BlockOutputSchema),
+});
+const InputSchema = z.object({ collection: z.string().optional() });
+/**
+ * Built once, from `@cogenta/blocks`' own `VOCABULARY` — a plain data
+ * mapping, not a query, so it costs nothing to compute on every call and
+ * needs no caching.
+ */
+function blockVocabularyOutput() {
+    return VOCABULARY.map((block) => ({
+        name: block.name,
+        version: block.version,
+        fields: Object.entries(block.schema).map(([key, field]) => ({
+            key,
+            kind: field.kind,
+            required: field.required,
+            options: field.options,
+        })),
+    }));
+}
+export function createContentSchemaTool(service) {
+    return defineTool({
+        name: 'content.schema',
+        version: '1.0.0',
+        description: "Describe one or every collection's field shape (key, kind, required, label, kind-specific options) and this site's fixed block vocabulary (block type name, version, and its own field shape) — the type/field names a blocks-kind field's array items may use. Call this before content.write_draft to know which field keys and value shapes a collection actually accepts, instead of guessing.",
+        input: InputSchema,
+        output: OutputSchema,
+        permissions: ['content.read'],
+        sideEffects: false,
+        reversible: false,
+        cost: 'low',
+        async execute(input, ctx) {
+            const collections = await service.describe({ actor: ctx.actor }, input.collection);
+            return {
+                collections: collections.map((collection) => ({
+                    collection: collection.collection,
+                    labelSingular: collection.labelSingular,
+                    labelPlural: collection.labelPlural,
+                    routed: collection.routed,
+                    fields: collection.fields.map((field) => ({
+                        key: field.key,
+                        kind: field.kind,
+                        label: field.label,
+                        required: field.required,
+                        options: field.options,
+                    })),
+                })),
+                blocks: blockVocabularyOutput(),
+            };
+        },
+    });
+}
+//# sourceMappingURL=content-schema.js.map

package/dist/tools/core/content-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-schema.js","sourceRoot":"","sources":["../../../src/tools/core/content-schema.ts"],"names":[],"mappings":"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"}

package/dist/tools/core/deps-scan.d.ts

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+import type { ToolDefinition } from '../types.js';
+export interface DepsScanToolOptions {
+    /** Where this site's own `package.json` lives — `create-cogenta` always writes one at the project root. */
+    readonly projectRoot: string;
+    readonly readFileImpl?: (path: string) => Promise<string>;
+}
+declare const DepsScanInputSchema: z.ZodObject<{}, z.core.$strip>;
+type DepsScanInput = z.infer<typeof DepsScanInputSchema>;
+declare const DepsScanOutputSchema: z.ZodObject<{
+    scannedFile: z.ZodString;
+    totalDependencies: z.ZodNumber;
+    unpinned: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        range: z.ZodString;
+        kind: z.ZodEnum<{
+            dependencies: "dependencies";
+            devDependencies: "devDependencies";
+        }>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type DepsScanOutput = z.infer<typeof DepsScanOutputSchema>;
+export declare function createDepsScanTool(options: DepsScanToolOptions): ToolDefinition<DepsScanInput, DepsScanOutput>;
+export {};
+//# sourceMappingURL=deps-scan.d.ts.map

package/dist/tools/core/deps-scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deps-scan.d.ts","sourceRoot":"","sources":["../../../src/tools/core/deps-scan.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAsCjD,MAAM,WAAW,mBAAmB;IAClC,2GAA2G;IAC3G,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;CAC1D;AAED,QAAA,MAAM,mBAAmB,gCAAe,CAAA;AACxC,KAAK,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAQxD,QAAA,MAAM,oBAAoB;;;;;;;;;;;iBAIxB,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAOjE,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,mBAAmB,GAC3B,cAAc,CAAC,aAAa,EAAE,cAAc,CAAC,CAiC/C"}

package/dist/tools/core/deps-scan.js

@@ -0,0 +1,85 @@
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { z } from 'zod';
+import { defineTool } from '../define.js';
+/**
+ * `deps.scan` — the built-in Security Scanner agent's (`agents/builtins.ts`)
+ * one real capability, "réutilise... les vérifications déjà documentées dans
+ * AGENTS.md" (L22 task 1 item 5): AGENTS.md's own R9 discipline names an
+ * unpinned/wildcard version as exactly the kind of dependency risk this
+ * project already cares about, so this tool reads the site's own
+ * `package.json` (read-only, no shell exec, no network — zero new
+ * dependency, R9/R10) and flags any dependency whose version specifier is
+ * not pinned in the loose sense semver tooling already treats as "someone
+ * decided this range on purpose": `^`, `~`, an exact version, or
+ * `workspace:*` inside this monorepo itself. `*`, `latest`, `x`, and a bare
+ * tag (`next`) are flagged — a site that ships one of these has no way to
+ * know what it will actually install on the next `npm install`.
+ *
+ * Deliberately narrow: this reads declared ranges, not installed versions or
+ * known CVEs (a real vulnerability database is a service dependency this
+ * tool does not take — R1). "Audit du journal d'audit pour des motifs
+ * suspects" (the other half the lot names for this agent) is not built here;
+ * see this task's closing report for why it is left as a documented
+ * follow-up rather than a second, rushed tool.
+ */
+const UNPINNED_PATTERN = /^(\*|x|latest|next)$/iu;
+function isUnpinned(range) {
+    const trimmed = range.trim();
+    if (trimmed.length === 0)
+        return true;
+    if (trimmed.startsWith('workspace:'))
+        return false;
+    if (UNPINNED_PATTERN.test(trimmed))
+        return true;
+    // A real semver range operator, or an exact version, or a URL/file spec —
+    // none of those are "we don't know what we'll get".
+    if (/^[\^~]?\d/u.test(trimmed))
+        return false;
+    if (/^(git|file|https?):/u.test(trimmed))
+        return false;
+    return true;
+}
+const DepsScanInputSchema = z.object({});
+const DependencyFindingSchema = z.object({
+    name: z.string(),
+    range: z.string(),
+    kind: z.enum(['dependencies', 'devDependencies']),
+});
+const DepsScanOutputSchema = z.object({
+    scannedFile: z.string(),
+    totalDependencies: z.number(),
+    unpinned: z.array(DependencyFindingSchema),
+});
+export function createDepsScanTool(options) {
+    const read = options.readFileImpl ?? ((path) => readFile(path, 'utf8'));
+    const packageJsonPath = join(options.projectRoot, 'package.json');
+    return defineTool({
+        name: 'deps.scan',
+        version: '1.0.0',
+        description: "Scan this site's own package.json for dependencies with an unpinned or wildcard version.",
+        input: DepsScanInputSchema,
+        output: DepsScanOutputSchema,
+        permissions: ['deps.scan'],
+        sideEffects: false,
+        reversible: false,
+        cost: 'low',
+        async execute() {
+            const raw = await read(packageJsonPath);
+            const parsed = JSON.parse(raw);
+            const groups = ['dependencies', 'devDependencies'];
+            let total = 0;
+            const unpinned = [];
+            for (const kind of groups) {
+                const deps = parsed[kind] ?? {};
+                for (const [name, range] of Object.entries(deps)) {
+                    total += 1;
+                    if (isUnpinned(range))
+                        unpinned.push({ name, range, kind });
+                }
+            }
+            return { scannedFile: packageJsonPath, totalDependencies: total, unpinned };
+        },
+    });
+}
+//# sourceMappingURL=deps-scan.js.map

package/dist/tools/core/deps-scan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deps-scan.js","sourceRoot":"","sources":["../../../src/tools/core/deps-scan.ts"],"names":[],"mappings":"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"}

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

@@ -1,6 +1,22 @@
 import type { MediaAsset, MediaStore } from '@cogenta/core';
 import { z } from 'zod';
 import type { ToolDefinition } from '../types.js';
+/**
+ * `media.read`/`media.write`'s output shape — deliberately **not** the same
+ * type as `@cogenta/core`'s `MediaAsset` any more.
+ *
+ * Fiche 46 added `folderId` to `MediaAsset` (the media library's folder
+ * tree). Contract C (`docs/04-contrats.md`, ADR-0020) treats an existing
+ * tool's signature as figured: growing it — even by an additive field —
+ * needs a governance decision this session cannot make unilaterally (unlike
+ * contract A or D, contract C's own text carries no "additive is minor"
+ * exception for an already-shipped tool). Rather than touch it, `folderId`
+ * is stripped before this shape is built at all, so `media.read`/`.write`'s
+ * wire output is byte-for-byte what it was before this fiche — an agent
+ * asking to move a file between folders needs a new, separate tool, not
+ * this one grown quietly.
+ */
+type MediaToolAsset = Omit<MediaAsset, 'folderId'>;
 declare const ReadInputSchema: z.ZodObject<{
     id: z.ZodString;
 }, z.core.$strip>;
@@ -12,7 +28,7 @@ type ReadInput = z.infer<typeof ReadInputSchema>;
  * actual gate, enforced by the manifest before the call ever reaches the
  * store.
  */
-export declare function createMediaReadTool(store: MediaStore): ToolDefinition<ReadInput, MediaAsset>;
+export declare function createMediaReadTool(store: MediaStore): ToolDefinition<ReadInput, MediaToolAsset>;
 declare const WriteInputSchema: z.ZodObject<{
     id: z.ZodString;
     alt: z.ZodOptional<z.ZodString>;
@@ -33,6 +49,6 @@ type WriteInput = z.infer<typeof WriteInputSchema>;
  * editing an existing asset's accessibility metadata, which is the concrete
  * use case this tool exists for (e.g. an accessibility-review agent).
  */
-export declare function createMediaWriteTool(store: MediaStore): ToolDefinition<WriteInput, MediaAsset>;
+export declare function createMediaWriteTool(store: MediaStore): ToolDefinition<WriteInput, MediaToolAsset>;
 export {};
 //# sourceMappingURL=media.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../../src/tools/core/media.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAoB,MAAM,eAAe,CAAA;AAE7E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAqBjD,QAAA,MAAM,eAAe;;iBAA+B,CAAA;AACpD,KAAK,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAEhD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,cAAc,CAAC,SAAS,EAAE,UAAU,CAAC,CAuB5F;AAED,QAAA,MAAM,gBAAgB;;;;;;;;;iBAMpB,CAAA;AACF,KAAK,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAElD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,UAAU,GAAG,cAAc,CAAC,UAAU,EAAE,UAAU,CAAC,CAuB9F"}
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../../src/tools/core/media.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAoB,MAAM,eAAe,CAAA;AAE7E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAIjD;;;;;;;;;;;;;;GAcG;AACH,KAAK,cAAc,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAA;AA0BlD,QAAA,MAAM,eAAe;;iBAA+B,CAAA;AACpD,KAAK,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAEhD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,cAAc,CAAC,SAAS,EAAE,cAAc,CAAC,CAuBhG;AAED,QAAA,MAAM,gBAAgB;;;;;;;;;iBAMpB,CAAA;AACF,KAAK,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAElD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,UAAU,GAChB,cAAc,CAAC,UAAU,EAAE,cAAc,CAAC,CAuB5C"}

package/dist/tools/core/media.js

@@ -2,6 +2,10 @@ import { CogentaError } from '@cogenta/core';
 import { z } from 'zod';
 import { defineTool } from '../define.js';
 const FocalPointSchema = z.object({ x: z.number(), y: z.number() });
+function toToolAsset(asset) {
+    const { folderId: _folderId, ...rest } = asset;
+    return rest;
+}
 const MediaAssetSchema = z.object({
     id: z.string(),
     kind: z.enum(['image', 'video', 'audio', 'file']),
@@ -15,6 +19,8 @@ const MediaAssetSchema = z.object({
     decorativeJustification: z.string().nullable(),
     focal: FocalPointSchema.nullable(),
     storageKey: z.string(),
+    tags: z.array(z.string()),
+    contentHash: z.string(),
     createdAt: z.string(),
     createdBy: z.string().nullable(),
 });
@@ -46,7 +52,7 @@ export function createMediaReadTool(store) {
                     hint: 'Check the id, or list media to find the right one.',
                 });
             }
-            return asset;
+            return toToolAsset(asset);
         },
     });
 }
@@ -86,7 +92,7 @@ export function createMediaWriteTool(store) {
                     : { decorativeJustification: input.decorativeJustification }),
                 ...(input.focal === undefined ? {} : { focal: input.focal }),
             };
-            return store.update(input.id, update);
+            return toToolAsset(await store.update(input.id, update));
         },
     });
 }

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

@@ -1 +1 @@
-{"version":3,"file":"media.js","sourceRoot":"","sources":["../../../src/tools/core/media.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"media.js","sourceRoot":"","sources":["../../../src/tools/core/media.ts"],"names":[],"mappings":"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"}

package/dist/tools/core/not-found-log.d.ts

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+import type { ToolDefinition } from '../types.js';
+/**
+ * `logs.read_not_found` — L22 task 3, "le superagent avec accès aux
+ * journaux (jamais au code source)". This is the one log this lot wires an
+ * agent to: the 404 log `@cogenta/schema`'s `NotFoundLogStore` has kept
+ * since fiche 12, never previously reachable from a tool. It carries a path,
+ * a hit count and timestamps — no request body, no header, no IP, no user
+ * agent (the store's own doc comment says why: `AGENTS.md` § Logs forbids
+ * either) — so there is nothing here for R8 to worry about beyond what
+ * `assembleContext`'s `data` channel already does for any external text.
+ *
+ * A narrow structural type, not the full `NotFoundLogStore`, for the same
+ * reason `content.ts`'s `ContentServiceLike` is narrow: this tool only ever
+ * reads.
+ */
+export interface NotFoundLogReader {
+    list(options?: {
+        readonly limit?: number;
+    }): Promise<readonly {
+        readonly path: string;
+        readonly hits: number;
+        readonly firstSeen: number;
+        readonly lastSeen: number;
+        readonly lastReferrer: string | null;
+    }[]>;
+}
+declare const InputSchema: z.ZodObject<{
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+type Input = z.infer<typeof InputSchema>;
+declare const OutputSchema: z.ZodObject<{
+    entries: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        hits: z.ZodNumber;
+        firstSeen: z.ZodNumber;
+        lastSeen: z.ZodNumber;
+        lastReferrer: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type Output = z.infer<typeof OutputSchema>;
+export declare function createNotFoundLogReadTool(store: NotFoundLogReader): ToolDefinition<Input, Output>;
+export {};
+//# sourceMappingURL=not-found-log.d.ts.map

package/dist/tools/core/not-found-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"not-found-log.d.ts","sourceRoot":"","sources":["../../../src/tools/core/not-found-log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjD;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAClD,SAAS;QACP,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;QACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;QACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;QAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;QACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;KACrC,EAAE,CACJ,CAAA;CACF;AAED,QAAA,MAAM,WAAW;;iBAGf,CAAA;AACF,KAAK,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAA;AAUxC,QAAA,MAAM,YAAY;;;;;;;;iBAA8C,CAAA;AAChE,KAAK,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA;AAE1C,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,iBAAiB,GAAG,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,CAiBjG"}

package/dist/tools/core/not-found-log.js

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+import { defineTool } from '../define.js';
+const InputSchema = z.object({
+    /** Highest hit count first, same default and cap as the admin's own `/api/not-found`. */
+    limit: z.number().int().positive().max(200).optional(),
+});
+const EntrySchema = z.object({
+    path: z.string(),
+    hits: z.number(),
+    firstSeen: z.number(),
+    lastSeen: z.number(),
+    lastReferrer: z.string().nullable(),
+});
+const OutputSchema = z.object({ entries: z.array(EntrySchema) });
+export function createNotFoundLogReadTool(store) {
+    return defineTool({
+        name: 'logs.read_not_found',
+        version: '1.0.0',
+        description: "Read this site's log of public URLs that answered a 404, sorted by hit count — the paths worth investigating first.",
+        input: InputSchema,
+        output: OutputSchema,
+        permissions: ['logs.read'],
+        sideEffects: false,
+        reversible: false,
+        cost: 'low',
+        async execute(input) {
+            const entries = await store.list(input.limit === undefined ? {} : { limit: input.limit });
+            return { entries: [...entries] };
+        },
+    });
+}
+//# sourceMappingURL=not-found-log.js.map

package/dist/tools/core/not-found-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"not-found-log.js","sourceRoot":"","sources":["../../../src/tools/core/not-found-log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AA6BzC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,yFAAyF;IACzF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;CACvD,CAAC,CAAA;AAGF,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACpC,CAAC,CAAA;AAEF,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;AAGhE,MAAM,UAAU,yBAAyB,CAAC,KAAwB;IAChE,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,OAAO;QAChB,WAAW,EACT,qHAAqH;QACvH,KAAK,EAAE,WAAW;QAClB,MAAM,EAAE,YAAY;QACpB,WAAW,EAAE,CAAC,WAAW,CAAC;QAC1B,WAAW,EAAE,KAAK;QAClB,UAAU,EAAE,KAAK;QACjB,IAAI,EAAE,KAAK;QACX,KAAK,CAAC,OAAO,CAAC,KAAK;YACjB,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAA;YACzF,OAAO,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,EAAE,CAAA;QAClC,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

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.0",
+  "version": "0.4.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.3.0",
-    "@cogenta/render": "0.1.3",
-    "@cogenta/schema": "0.2.0"
+    "@cogenta/core": "0.6.0",
+    "@cogenta/render": "0.2.1",
+    "@cogenta/schema": "0.4.1",
+    "@cogenta/blocks": "1.0.1"
   },
   "devDependencies": {
     "typescript": "^7.0.2",