@adonis-agora/agent 0.36.0 → 0.37.0

package/dist/src/rag/tree/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/rag/tree/types.ts"],"names":[],"mappings":"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"}

package/dist/src/rag/tree/types.js

@@ -0,0 +1,21 @@
+/**
+ * The data model of tree navigation retrieval: a hierarchical table of contents per long document
+ * (PageIndex-style: sections with page ranges and summaries), built once at ingestion and read by an
+ * LLM at query time to walk to the relevant sections instead of ranking hundreds of look-alike chunks.
+ */
+/** Walk a tree depth-first (pre-order). */
+export function* walkTree(nodes, path = []) {
+    for (const node of nodes) {
+        yield { node, path };
+        yield* walkTree(node.children, [...path, node]);
+    }
+}
+/** Index a tree's nodes by id, each with its ancestors. */
+export function indexTree(tree) {
+    const index = new Map();
+    for (const entry of walkTree(tree.nodes)) {
+        index.set(entry.node.id, entry);
+    }
+    return index;
+}
+//# sourceMappingURL=types.js.map

package/dist/src/rag/tree/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/rag/tree/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkIH,2CAA2C;AAC3C,MAAM,SAAS,CAAC,CAAC,QAAQ,CACvB,KAAkC,EAClC,IAAI,GAAgC,EAAE;IAEtC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACrB,KAAK,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IAClD,CAAC;AACH,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,SAAS,CACvB,IAAiC;IAEjC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAyE,CAAC;IAC/F,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACzC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/stubs/database/migrations/create_agent_rag_trees.stub

@@ -0,0 +1,40 @@
+{{{
+  exports({ to: app.migrationsPath(`${new Date().getTime()}_create_agent_rag_trees.ts`) })
+}}}
+import { BaseSchema } from '@adonisjs/lucid/schema'
+import db from '@adonisjs/lucid/services/db'
+import { PgDocumentTreeStore } from '@adonis-agora/agent'
+
+/**
+ * The tables of \`PgDocumentTreeStore\`, the tree navigation store (PageIndex-style retrieval for long
+ * documents): one row per document tree (header columns, a \`jsonb\` metadata column filtered like the
+ * chunk table's, the nodes as \`jsonb\`) and one row per page/section of text the nodes point at.
+ * Postgres only; needs no extension. Delete this file if you do not use tree navigation.
+ *
+ * Like the other migrations, this DELEGATES rather than copying DDL: the store owns the column names
+ * its own queries depend on. Every statement is \`IF NOT EXISTS\`, so this is safe against a database
+ * where \`ensureSchema()\` already ran.
+ *
+ * SET \`TABLE\` / \`UNITS_TABLE\` only if you pass \`table\` / \`unitsTable\` to
+ * \`new PgDocumentTreeStore(db, { ... })\` (the units table defaults to the trees table + \`_units\`).
+ */
+const TABLE = 'agent_rag_trees'
+const UNITS_TABLE = 'agent_rag_trees_units'
+
+export default class extends BaseSchema {
+  /** Same reason as the agent tables migration: the DDL runs on the manager's own pooled connection. */
+  static disableTransactions = true
+
+  async up() {
+    const store = new PgDocumentTreeStore(db.connection(this.db.connectionName), {
+      table: TABLE,
+      unitsTable: UNITS_TABLE,
+    })
+    await store.ensureSchema()
+  }
+
+  async down() {
+    this.schema.dropTableIfExists(UNITS_TABLE)
+    this.schema.dropTableIfExists(TABLE)
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adonis-agora/agent",
-  "version": "0.36.0",
+  "version": "0.37.0",
   "description": "Governed, durable-backed AI agent (chat + tool-calling + governance) for AdonisJS — part of the Agora ecosystem.",
   "license": "MIT",
   "repository": {
@@ -146,6 +146,7 @@
     "dist/",
     "README.md",
     "CHANGELOG.md",
+    "NOTICE",
     "skills"
   ],
   "sideEffects": false,