creator

package
v0.7.39-dev.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 9, 2026 License: MIT, MIT Imports: 2 Imported by: 0

README

The Knowledge Creator

The Knowledge Creator is the QuickAgent that builds knowledge packs. You give it documents, a brief (what the pack should cover and for whom), or both, and it compiles them into a small wiki of short, cited markdown pages. A QuickAgent run can then search that wiki to answer questions. Adding documents to an existing pack runs it again, and it rewrites only the pages the new documents change. Specific documents make the best knowledge: without them it researches the web and its own knowledge, which can be wrong or out of date.

This is the package that runs

The Knowledge Creator is built into the Agentry CLI and the desktop app, and it runs from there: on your computer when you run agentry knowledge create or agentry knowledge add (or build a pack in the desktop), and on an Agentry sandbox host when you create knowledge in Agentry. This release has the same bytes. The registry built its archive from the package the CLI carries, and the archive's digest is the one the CLI reports. Run agentry builtins to print it and compare it with the digest on this page.

Installing this release does not give you the Knowledge Creator. The application runs it as a built-in, with the steps and tools listed below. If you install this release, it runs as an ordinary QuickAgent with only what its manifest declares.

What the application does around it

The manifest declares no network access, no file access and no commands, and one data category, files. When Agentry builds a pack:

  • Before the run, the runner decodes each document to text: a PDF, an office file or an image becomes a .txt file, and a text document stays as it is. The Knowledge Creator runs no decoder itself. It reads the text through the inputs channel (list_inputs, read_input).
  • During the run, when it extends an existing pack, it can read the pack as it stands with knowledge_list, knowledge_search and knowledge_read. It writes each page with write_report. Like every run, it has a scratch folder for its working notes, private to the run and deleted with it, and grep and glob to search its documents, the pack and that folder.
  • When the build searches the web (the default for a build with no documents, a choice for one with them), the application grants it two tools its manifest does not declare: web_search and web_read. AI Review reads every search result and every page before the model does, and one it flags, or cannot scan, is withheld. On your computer that takes your own TypeSafe key and a search key; in Agentry the registry searches and scans. It cites a page it read as [src: web:<url>] and keeps no copy of it, and cites what its model knows as [src: model]. A brief is kept in the pack as sources/brief.md. web_read opens only an address one of the build's own searches returned. A page whose text is drawn by scripts is rendered in a headless Chromium the application runs once a page, on a network whose one way out admits public sites alone; the model never drives that browser, and AI Review reads the rendered text before the model does.
  • A repository or an address, when the person names one, is fetched before the run by the step a run's input source takes: in the files container, on a network of its own behind a proxy to that host alone, an access token on the step's input and nowhere else. A git repository's files are staged as documents under repo-<host>-<path>/ (nothing inside .git is fetched), a file at an address under its own name; both are decoded as a run's are, counted against the pack's cap and kept in the pack beside the pages. The Knowledge Creator never fetches anything itself.
  • Its guide. The release ships a knowledge pack, knowledge/pack-writing-guide: how a page reads, citing, building from many documents, reading a repository, and researching the web. The application attaches it to every build, beside the pack a build extends.
  • After the run, the application checks every page and drops any that break the pack's rules, regenerates the index and appends the log. A pack built in Agentry is scanned before it is final.

INSTRUCTION.md is the instruction the model follows. It covers where its knowledge comes from (the documents, then the pack, then the web, then its own), how pages are named and cited, and why the pack is written one document or subject at a time, so a build stopped by its budget keeps what it wrote.

Documentation

Overview

Package creator is the Knowledge Creator: the QuickAgent package that compiles documents into a knowledge pack, embedded in the CLI and run by the runner as a built-in package — part of the application, never a release a person installs. Its contract declares no egress, no filesystem, no exec and the files data category: the runner decodes the documents before the run (pkg/runner/decode), the agent reads their text through the inputs channel and the pack as it stands through the knowledge tools, and writes pages through write_report; pkg/knowledge applies them. From 1.2.0 a build may be given a brief instead of documents, and the application may grant it web_search and web_read, which its manifest does not declare (they ride on the built-in, pkg/runner/localrun): it researches what the documents and the pack do not hold, every result read by AI Review first, and cites web pages as [src: web:<url>] and its model's own knowledge as [src: model].

Index

Constants

View Source
const (
	Namespace = "agentry"
	Name      = "knowledge-creator"
	Version   = "1.5.0"
)

The package's identity, as its manifest declares it.

View Source
const GuideName = "pack-writing-guide"

GuideName is the knowledge pack the Knowledge Creator ships in its own release, its guide to writing a pack: how a page reads, citing, many documents, and researching the web. The runner gives it to every run of the package (localrun's withShippedPacks), beside the pack a build extends; a pack of the same name is refused. Its manifest.json and index are generated (TestThePackWritingGuideIsCurrent).

View Source
const LocalTimeoutFloorSeconds = 3600

LocalTimeoutFloorSeconds is the least a knowledge build on this computer is given: 60 minutes, what a build in Agentry gets on the tiers that can build, where the runner policy's run timeout defaults to 15. A policy that allows more keeps its own, and a timeout named for the build wins either way (localrun.Builtin.LocalBudgets). It is a timeout alone: a build on this computer has no token limit, and its tool-call cap is the policy's.

Variables

This section is empty.

Functions

func FS

func FS() fs.FS

FS is the package's tree: agent.yaml, INSTRUCTION.md, README.md and LICENSE at its root (a public release carries the last two), and under knowledge/ the pack it ships (GuideName).

Types

This section is empty.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL