Repository navigation
Bump @fastagent-sh/fastagent from 0.30.3 to 0.31.0.
Included
- Configuration and deployment instances (#998, #1003, #1009, #1014).
- A deployment is an instance of its own, named by its configuration (
name, else the program's name), with its own manifest (fly.<name>.toml,fastagent.<name>.compose.yml,agentcore.<name>.template.yaml). - The image holds only the program;
deploydelivers the instance configuration viaFASTAGENT_NAME,FASTAGENT_RELEASE_ID, andFASTAGENT_CONFIG_JSON, and reads no default value file. - Environment layers apply in order: program defaults < instance config < env vars (
FASTAGENT_THINKING_LEVEL,FASTAGENT_HTTP_API,FASTAGENT_HTTP_PUBLIC_URL,FASTAGENT_INGRESS) < CLI flags.
- A deployment is an instance of its own, named by its configuration (
- Channel turns and sessions (#1001, #1002, #1005, #1007, #1008, #1012, #1016).
- Group timelines keep one session per sender; turns steer into the target session (including replies) and fold recent discussion within the model's context budget.
- Opening a new Feishu topic forks the session holding the message it was opened on; Telegram keeps un-summoned messages 14 days and warns about group privacy mode during setup.
- Embedding and authoring (#988, #993, #994, #996, #1010 / #1028, #1013 / #1029).
openAgent(definition, { root })withoutconfigreads<root>/fastagent.json.addContent,removeContent, andlistContentwork over built definitions withinstance.config, and content directories may contain or sit inside the definition directory.addMcpServerandremoveMcpServermanage an instance'smcpServersunder the same lock and validation rules asopenAgent.openAgentopens when a configured default model is absent from the catalog, leavinginfo().defaultModelunset and reportinginfo().unusableDefault.
- Dependencies and fixes:
@earendil-works/chord,pi-ai,pi-durable, andpi-schemaupdated to 1.5.2 (#1027); stops wait for the whole process group (#1015).
Breaking changes
No compatibility layer, as before 1.0.
info()separates program and instance identity:info().nameandinfo().descriptionbelong to the instance;info().agentholds the program'snameanddescription;info().startersmoves to the top level ofAgentInfo(#998).fastagent.config.tsremovesextensions(put extensions undersrc/extensions/), and programdefaultsrefusechannels.<name>.app.deploy.*is no longer allowed in an instance'sfastagent.json(#998).deployreads only the renamed per-instance manifests (fly.<name>.toml,fastagent.<name>.compose.yml,agentcore.<name>.template.yaml) and warns once when it sees an old generated manifest. The/etc/fastagent/layer,FASTAGENT_CONFIG,fastagent.release.json, andFASTAGENT_RELEASE_FILEare removed (#1003, #1009).openAgent(definition, { root })reads<root>/fastagent.jsonwhen present; passconfig(including{}) if<root>/fastagent.jsonshould be ignored (#996).openAgentno longer throws on an unknown configured default model (explicitmodeloptions remain strict) (#1028).
Known limitations
- Codex provider session resources can outlive
agent.close()(#896; fixed onearendil-works/pimain in #11961, not yet in pi 1.5.2). chord@1.5.2declaresreactas an exact optional peer (19.3.0), which can causeERESOLVEin projects with anotherreactpatch version until the upstream range fix is released.- Multi-instance deploy plans and variable delivery (#1003, #1009) were verified with test runners, not re-run on live Fly, Railway, AgentCore, or Docker hosts.
Verification
npm run lint,npm run typecheck,npm test(80 files, 329 passed),npm run test:integration(16 files, 28 passed),npm pack --dry-run --jsonon PR #1030 (chore/release-0.31.0).