Skip to content

Add generic agent reflection and TypeScript clients - #3777

Merged
noise64 merged 48 commits into
mainfrom
reflection-base-and-ts
Sep 11, 2026
Merged

Add generic agent reflection and TypeScript clients#3777
noise64 merged 48 commits into
mainfrom
reflection-base-and-ts

Conversation

@noise64

@noise64 noise64 commented Aug 26, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor
  • resolves GOL-44
  • resolves GOL-45
  • hardens reflected lifecycle creation cleanup and requires agent view permission for full-ID type lookup
  • makes reflection identity environment-scoped with component-free ParsedAgentId; the runtime resolves and authorizes the deployed implementation while AgentType.implementedBy remains metadata
  • exposes reflection host identities as direct WIT string values without a generated host AgentId alias; structured core/management AgentId and public ParsedAgentId remain unchanged
  • moves generic schema renderers into golem-schema and keeps only platform renderers in golem-common
  • replaces TypeScript clientFor(...) with definition-owned .client factories across the SDK, bridge, REPL, templates, tests, skills, and docs
  • completes immutable shared graph decoding, strict/optional lookup documentation, ComponentId SDK exposure, required-output validation, integer bounds/precision behavior, and reusable fatal UTF-8 decoding
  • adds the common and TypeScript reflection skills and regenerates skill-derived documentation and WIT declarations

Verification

  • focused lifecycle, authorization, payload, renderer, reflection, decoder, and reflected RPC integration tests
  • TypeScript build, declaration/type tests, full unit suite, lint, formatting, and 4 GB agent-template build
  • Scala guest declarations and all three runtime role contracts
  • MoonBit binding regeneration plus SDK-wide moon check --target wasm
  • reflection playground type-check and component build
  • WIT and generated-document drift checks
  • merged latest main at d43c34ddb and reran local WIT, Rust, TypeScript, Scala, MoonBit, runtime-contract, and template validation
  • refreshed CI for head 461105d70 pending

@netlify

netlify Bot commented Aug 26, 2026 •
edited
Loading

Copy link
Copy Markdown

✅ Deploy Preview for golemcloud canceled.

Name Link
🔨 Latest commit 461105d
🔍 Latest deploy log https://app.netlify.com/projects/golemcloud/deploys/6aa40d120238480008bf5171

@noise64 noise64 changed the title WIP: add generic agent reflection host support WIP: generic agent reflection host support + initial TS reflection Aug 26, 2026
@noise64 noise64 changed the title WIP: generic agent reflection host support + initial TS reflection Add generic agent reflection and TypeScript clients Aug 28, 2026
@github-actions

github-actions Bot commented Aug 31, 2026 •
edited
Loading

Copy link
Copy Markdown

📖 Docs preview: https://docs-kf0k4d3m6-golem-cloud.vercel.app

Built from commit 461105d7032107698eb59e43ea14448e04e2f648 by docs.yaml.

@noise64 noise64 mentioned this pull request Sep 2, 2026
Closed
noise64 added 25 commits September 8, 2026 17:39
@noise64
WIP: add generic agent reflection host support
b5193f8
@noise64
Regenerate MoonBit reflection bindings
34b0c04
@noise64
WIP: add TypeScript agent reflection vertical slice
8122639
@noise64
Add separate RPC creation paths for reflected clients
496bc67
@noise64
Refine reflection API naming and RPC behavior
4ba00ad
@noise64
Keep static RPC call sites fail-fast
19ccca9
@noise64
Add canonical reflected schema rendering
5628544
@noise64
Add aligned TypeScript reflection client levels
5367d05
@noise64
Keep schema values compatible across SDK entries
71e30b0
@noise64
Delay strict UTF-8 decoder initialization
58988cb
@noise64
Adopt definition-owned clients and agent identities in TS
4584f20
@noise64
Migrate TypeScript RPC guidance to definition clients
d505f91
@noise64
Inline definition clients in TypeScript examples
23e2be3
@noise64
Map agent RPC errors in TypeScript
63e9c26
@noise64
Remove lifecycle mode from AgentId-bound clients
141d246
@noise64
Close ephemeral lifecycle contract gaps
977eff8
@noise64
Format merged TypeScript SDK files
0ded4e5
@noise64
Forward fallible RPC creation in debug context
e13dfa0
@noise64
Document and test TypeScript agent reflection
83a71fc
@noise64
Raise TypeScript CI declaration heap
2e387e5
@noise64
Regenerate Scala agent host declarations
870b700
@noise64
Document AgentId schema construction paths
aaa9091
@noise64
Move schema rendering into golem-schema
797d14f
@noise64
Preserve persisted reflection payload tags
dd29d9d
@noise64
Finish TypeScript reflection contracts
a58bee0
@noise64
noise64 marked this pull request as ready for review September 9, 2026 12:23
@noise64
noise64 requested a review from a team September 9, 2026 12:23
@noise64
noise64 marked this pull request as draft September 9, 2026 14:48
vigoo
vigoo reviewed Sep 10, 2026
View reviewed changes
Comment thread sdks/ts/packages/golem-ts-sdk/src/client.ts Outdated
Comment thread wit/deps/golem-agent/host.wit Outdated
@noise64
noise64 marked this pull request as ready for review September 10, 2026 11:13
@noise64
noise64 marked this pull request as draft September 10, 2026 13:35
vigoo
vigoo reviewed Sep 10, 2026
View reviewed changes
Comment thread cli/golem-cli/wit/deps/golem-agent/host.wit Outdated
vigoo
vigoo reviewed Sep 10, 2026
View reviewed changes
Comment thread sdks/moonbit/golem_sdk/wit/deps/golem-agent/host.wit Outdated
@noise64
noise64 marked this pull request as ready for review September 11, 2026 10:17
@noise64
noise64 marked this pull request as draft September 11, 2026 10:19
@noise64
Merge origin/main into reflection-base-and-ts
50597c0
@noise64
Adapt reflection lookup to worker service errors
07f4cbf
@noise64
Refresh reflection stack CI
2503faa
@noise64
Clarify reflection worker metadata lookup
4efec6a
@noise64
Merge origin/main into reflection-base-and-ts
8982f65 
# Conflicts:
#	golem-common/src/schema/render/json_schema.rs
#	golem-common/src/schema/render/mod.rs
#	golem-common/src/schema/render/tests/json_value_tests.rs
#	golem-registry-service/src/services/component/write.rs
#	golem-registry-service/src/services/deployment/deployment_context.rs
#	golem-worker-executor/src/durable_host/wasm_rpc/mod.rs
#	golem-worker-executor/src/worker/agent_config.rs
#	golem-worker-service/src/custom_api/openapi/schema_mapping.rs
#	golem-worker-service/src/custom_api/rich_request.rs
#	golem-worker-service/src/mcp/invoke/agent_method_input.rs
#	golem-worker-service/src/mcp/invoke/constructor_param_extraction.rs
#	golem-worker-service/src/mcp/invoke/multimodal_params_extraction.rs
#	sdks/ts/packages/golem-ts-sdk/src/host/quota.ts
@noise64
Merge remote-tracking branch 'origin/main' into reflection-base-and-ts
d34c989 
# Conflicts:
#	sdks/ts/packages/golem-ts-sdk/src/bridge/agent.ts
#	sdks/ts/packages/golem-ts-sdk/tests/bridge.test.ts
@noise64
Merge remote-tracking branch 'origin/main' into reflection-base-and-ts
b5f6dc9
@noise64
Handle assignment tracking test results
461105d
@noise64
noise64 marked this pull request as ready for review September 11, 2026 15:00
@noise64
noise64 merged commit 0283e61 into main Sep 11, 2026
69 checks passed
@noise64
noise64 deleted the reflection-base-and-ts branch September 11, 2026 15:04
@github-actions github-actions Bot locked and limited conversation to collaborators Sep 11, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Reviewers

@vigoo vigoo vigoo approved these changes

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@noise64 @vigoo