agent-lattice 0.9.12 → 0.9.13

package/README.md

@@ -31,6 +31,25 @@ for await (const message of agent.query("Say hello")) {
 }
 ```
 
+`createAgent()` includes a private workspace and the built-in file/shell tools
+by default. Use `createBareAgent()` when your host wants to provide every prompt
+and tool explicitly:
+
+```ts
+import { createBareAgent, createBuiltinTools } from "agent-lattice";
+
+const agent = createBareAgent({
+  apiKey: process.env.DEEPSEEK_API_KEY,
+  baseURL: "https://api.deepseek.com/anthropic",
+  model: "deepseek-v4-flash",
+  systemPrompt: "You are a concise engineering assistant.",
+  tools: createBuiltinTools({
+    cwd: process.cwd(),
+    allowedDirectories: [process.cwd()],
+  }),
+});
+```
+
 Pass `{ stream: false }` to disable model streaming for a query:
 
 ```ts
@@ -596,7 +615,8 @@ sends a diagnostic follow-up to the upstream mailbox.
 
 ## Agent Workspace Tools
 
-AgentLattice includes an opt-in set of workspace tools:
+`createAgent()` includes a private workspace and these built-in tools by
+default:
 
 - `Read`
 - `Write`
@@ -606,14 +626,18 @@ AgentLattice includes an opt-in set of workspace tools:
 - `Grep`
 - `Bash`
 
+Use `createBuiltinTools()` or `createAgentWorkspaceTools()` when you want to
+assemble the tool list yourself, especially with `createBareAgent()`:
+
 ```ts
-import { createAgent, createAgentWorkspaceTools } from "agent-lattice";
+import { createBareAgent, createBuiltinTools } from "agent-lattice";
 
-const agent = createAgent({
+const agent = createBareAgent({
   apiKey: process.env.DEEPSEEK_API_KEY,
   baseURL: "https://api.deepseek.com/anthropic",
   model: "deepseek-v4-flash",
-  tools: createAgentWorkspaceTools({
+  systemPrompt: "Use the configured project directory for file work.",
+  tools: createBuiltinTools({
     cwd: process.cwd(),
     allowedDirectories: [process.cwd()],
   }),
@@ -626,12 +650,12 @@ const agent = createAgent({
 });
 ```
 
-These tools are not enabled by default. `Read`, `LS`, `Glob`, and `Grep` are
-read-only observation tools and are not gated by workspace grants. `Write`,
-`Edit`, and obvious Bash writes are gated to the configured workspace roots and
-task-scoped shared workspace grants, so production hosts should pair write and
-shell access with a permission callback. Shell redirects to `/dev/null` are
-treated as discard targets, not workspace writes.
+`Read`, `LS`, `Glob`, and `Grep` are read-only observation tools and are not
+gated by workspace grants. `Write`, `Edit`, and obvious Bash writes are gated to
+the configured workspace roots and task-scoped shared workspace grants, so
+production hosts should pair write and shell access with a permission callback.
+Shell redirects to `/dev/null` are treated as discard targets, not workspace
+writes.
 
 ## Multi-turn Session
 

package/dist/index.d.ts

@@ -365,6 +365,7 @@ export type AgentOptions = {
     modelClient?: ModelClient;
     tracer?: ContextTracer;
 };
+export type BareAgentOptions = Omit<AgentOptions, "workspace">;
 export type AgentWorkspaceToolsOptions = {
     cwd?: string;
     allowedDirectories?: string[];
@@ -488,6 +489,8 @@ export declare function delegateTool(name: string, description: string, agent: A
     task: string;
 }>;
 export declare function createAgent(options: AgentOptions): Agent;
+export declare function createBareAgent(options: BareAgentOptions): Agent;
+export declare function createBuiltinTools(options?: AgentWorkspaceToolsOptions): Array<ToolDefinition<any>>;
 export declare function createJsonlContextTracer(options: JsonlContextTracerOptions): ContextTracer;
 export declare function createCompositeContextTracer(tracers: Array<ContextTracer | undefined | null>): ContextTracer;
 export declare function createLangSmithContextTracer(options: LangSmithContextTracerOptions): ContextTracer;