feat: code-first agents (base44.agents.create) by yardend-wix · Pull Request #205 · base44/javascript-sdk

yardend-wix · 2026-06-23T10:10:22Z

Adds a code-first way to build AI agents in the SDK, under base44.agents.

base44.agents.create({ model, system, tools }) — define an agent in code and run it with .run({ prompt }). The SDK runs the tool-calling loop against the Base44 AI Gateway; model is just a string (e.g. "claude_sonnet_4_6"), and the connection is handled by the client.
tool({ description, parameters, execute }) — define a tool the agent can call.
.asTool() — turn SDK resources into tools an agent can use:
- a backend function → base44.functions.asTool(name, { description })
- another agent → agent.asTool({ name, description }) (sub-agents)
- an entity → base44.entities.<Name>.asTool({ operations }) (read-only by default; opt into create/update/delete)

The existing base44.agents conversation methods and InvokeLLM are untouched.

Built on the Base44 AI Gateway: base44-dev/apper#12366

Implement tool() identity factory as a public API seam and serializeTools() to map tools to OpenAI function-tool format. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

…th impl Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

…en thunk type Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

…tly (drop fragile data-unwrap) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

claude · 2026-06-23T10:10:34Z

Claude encountered an error —— View job

I'll analyze this and get back to you.

github-actions · 2026-06-23T10:10:55Z

🚀 Package Preview Available!

Install this PR's preview build with npm:

npm i @base44-preview/sdk@0.8.34-pr.205.d800012

Prefer not to change any import paths? Install using npm alias so your code still imports @base44/sdk:

npm i "@base44/sdk@npm:@base44-preview/sdk@0.8.34-pr.205.d800012"

Or add it to your package.json dependencies:

{
  "dependencies": {
    "@base44/sdk": "npm:@base44-preview/sdk@0.8.34-pr.205.d800012"
  }
}

📦 Preview Package: @base44-preview/sdk@0.8.34-pr.205.d800012
🔗 View this commit on GitHub

_{Preview published to npm registry — try new features instantly!}

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

…e dynamicAgents Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

…; single base44.agents namespace Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

@example

- Agent.run and Agent.asTool: added full @param/@returns/@example peer-depth JSDoc - AgentConfig: expanded interface-level block + all seven fields documented - RunOptions: added @example with AbortController pattern - tool() factory: added @param/@returns/@example - No internal planning language found or removed (grep clean) - Runtime behavior, signatures, and tests unchanged Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

…ests

…asts Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

…onse behavior identical

…nts/ Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

…confined to the adapter Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

…age[] history mapping Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

…ions vocabulary Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

…larify loop internals - RunUsage: rename promptTokens/completionTokens -> inputTokens/outputTokens - RunResult: add totalUsage (summed across all model calls); usage is the final call - Step: carry per-call usage so totalUsage is auditable - openai-compatible adapter maps prompt_tokens/completion_tokens/base44_credits accordingly - readability: clearer names (modelResult, matchedTool, totalUsage, sumUsage) and multi-line returns in loop.ts / openai-compatible.ts Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

…ault) - read_/create_/update_/delete_<Entity> tools built from operations allow-list - read uses a filter (query/sort/limit/skip/fields); create/update/delete wired to the entity handler - read-only default; writes opt-in via operations - params are deferred-schema (open object for create/update) — schema-derived params are a follow-up - drop internal-discussion/roadmap notes from agents-module comments Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

claude · 2026-06-24T17:26:53Z

Claude encountered an error —— View job

I'll analyze this and get back to you.

- Tool/JSONSchema defined in agents.types (the owner); entities/functions import them directly, matching the repo's cross-module type convention - usage aggregation across steps (usage + totalUsage + per-step) - typed FinishReason for RunResult; provider/gateway seam cleanups Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

claude · 2026-06-25T07:48:12Z

Claude encountered an error —— View job

I'll analyze this and get back to you.

Transport is now a wire-agnostic authenticated JSON POST; the provider supplies the path (/chat/completions). Lets future Anthropic/Gemini providers reuse the same transport with their own paths, no changes here. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

claude · 2026-06-25T12:10:53Z

Claude encountered an error —— View job

I'll analyze this and get back to you.

yardend-wix and others added 12 commits June 23, 2026 11:29

feat(dynamic-agents): add types module

3d46dc5

feat(dynamic-agents): add gateway transport

dad3c39

feat(dynamic-agents): add tool() factory and serialization

ce89421

Implement tool() identity factory as a public API seam and serializeTools() to map tools to OpenAI function-tool format. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

feat(dynamic-agents): add request body builder with param whitelist

e1dc740

feat(dynamic-agents): add agent loop and create/run module

7ba9f1e

fix(dynamic-agents): revert clone() in transport; align run() type wi…

e3e2dfc

…th impl Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

feat(dynamic-agents): wire module into client (user + service role)

516796e

fix(dynamic-agents): declare dynamicAgents on client type; fix getTok…

869ada4

…en thunk type Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

feat(dynamic-agents): export tool() and public types

8c4f307

feat(dynamic-agents): implement Agent.asTool sub-agent tool

14fdf1f

feat(dynamic-agents): add functions.asTool

7584305

fix(dynamic-agents): functions.asTool returns the function body direc…

6efe0c0

…tly (drop fragile data-unwrap) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

yardend-wix and others added 9 commits June 23, 2026 20:38

refactor(agents): split tool.ts and agent-loop.ts out of dynamic-agents

b9a90d5

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

feat(agents): add base44.agents.create (code-defined agents) alongsid…

c2c0505

…e dynamicAgents Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

refactor(agents): remove dynamicAgents surface and module-level run()…

a57ae27

…; single base44.agents namespace Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

docs(agents): cross-link Agent in create() @returns

bf3875e

test(agents): align test conventions and add type-level tests

90d2674

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

test(agents): exercise real AgentsModule.create return type in type t…

fb62a08

…ests

refactor(agents): type the gateway completion shapes; drop loop any-c…

3b30d06

…asts Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

fix(agents): restore optional-chain on choices to keep malformed-resp…

db81086

…onse behavior identical

yardend-wix closed this Jun 24, 2026

yardend-wix and others added 6 commits June 24, 2026 11:21

refactor(agents): move agents module + internals into src/modules/age…

9d8366a

…nts/ Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

feat(agents): add neutral LanguageModel seam + openAIProvider adapter

a909694

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

chore(agents): drop unused imports in provider adapter + test

d95048c

refactor(agents): loop talks to the LanguageModel seam; OpenAI logic …

1822ff0

…confined to the adapter Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

refactor(agents): system as a neutral message role; faithful ChatMess…

c4e0ce1

…age[] history mapping Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

refactor(agents): rename provider to openai-compatible / chat-complet…

bd675c8

…ions vocabulary Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

yardend-wix and others added 2 commits June 24, 2026 17:10

yardend-wix reopened this Jun 24, 2026

yardend-wix changed the title ~~feat: Dynamic Agents SDK (base44.dynamicAgents)~~ feat: code-first agents (base44.agents.create) Jun 24, 2026

yardend-wix closed this Jun 28, 2026

Navigation Menu

Uh oh!

feat: code-first agents (base44.agents.create) - #205

feat: code-first agents (base44.agents.create)#205
yardend-wix wants to merge 31 commits into
mainfrom
feature/dynamic-agents

yardend-wix commented Jun 23, 2026 •

edited

Loading

Uh oh!

claude Bot commented Jun 23, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Jun 23, 2026 •

edited

Loading

Uh oh!

claude Bot commented Jun 24, 2026 •

edited

Loading

Uh oh!

claude Bot commented Jun 25, 2026 •

edited

Loading

Uh oh!

claude Bot commented Jun 25, 2026 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Uh oh!

Conversation

yardend-wix commented Jun 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

claude Bot commented Jun 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Jun 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🚀 Package Preview Available!

Uh oh!

claude Bot commented Jun 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

claude Bot commented Jun 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

claude Bot commented Jun 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

yardend-wix commented Jun 23, 2026 •

edited

Loading

claude Bot commented Jun 23, 2026 •

edited

Loading

github-actions Bot commented Jun 23, 2026 •

edited

Loading

claude Bot commented Jun 24, 2026 •

edited

Loading

claude Bot commented Jun 25, 2026 •

edited

Loading

claude Bot commented Jun 25, 2026 •

edited

Loading