Skip to content

The open-source agent harness - the runtime layer that turns an LLM into a working agent.

1.2 KB
Raw Blame
  • Workspace source MUST remain ESM so exports["trueforge-dev"] can load src/ without a build. That condition name MUST NOT be "development" (or "production") — the package publishes from its own root with files: ["dist", "README.md"], so src/ is never in the tarball, and Vite/webpack default to auto-activating a literal "development" condition in dev mode with no consumer opt-in, which would break resolution for any such consumer. dist/ output MUST expose CJS .js and ESM .mjs outputs alongside .d.ts.
  • Top-level public package surfaces (core, agent-session, and other exported entrypoints) MAY use optional (?) properties for caller ergonomics.
  • Within this package, records, snapshots, store INPUT types, and other internal contracts MUST NOT use ?. Absence MUST be an explicit required | null or | undefined field; prefer null for domain absence and undefined only when update/patch semantics must distinguish “not provided” from “clear.” Public surfaces adapt by supplying those explicit absences when calling inward. This forces internal object literals to be exhaustive under tsc, preventing forgotten fields and silent data loss.