golem-add-http-endpoint-ts

Exposes TypeScript Golem agent methods as REST-like HTTP endpoints via decorators.

Updated May 17, 2026
One-click install
npx skills add https://github.com/Rust-soham/golem-claw --skill golem-add-http-endpoint-ts-rust-soham
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: golem-add-http-endpoint-ts
Source: https://github.com/Rust-soham/golem-claw/tree/main/packages/golem/.agents/skills/golem-add-http-endpoint-ts
Command: npx skills add https://github.com/Rust-soham/golem-claw --skill golem-add-http-endpoint-ts-rust-soham

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you publish a TypeScript Golem agent over HTTP so users can call your agent’s methods through well-defined REST-like endpoints instead of using an internal or non-HTTP interface.

Core Features & Use Cases

  • HTTP mounting for agents: Set a base mount path on the @agent() decorator so endpoint routes attach to a consistent URL prefix.
  • Route exposure via decorators: Use @endpoint() to map specific agent methods to HTTP verbs (get/post/put/delete/custom) and URL paths.
  • HTTP API deployment wiring: Add the httpApi deployment configuration in golem.yaml so the endpoints are actually reachable in a target domain.
  • Typed request/response mapping: Rely on Golem’s return-type-to-HTTP-status/body mapping (including void, undefined, Result, and UnstructuredBinary) for predictable HTTP behavior.
  • Use cases: exposing task/operations agents as endpoints, turning agent actions into a backend REST service, mounting an agent at a path with variables derived from constructor parameters.

Quick Start

Add a mount to your @agent() decorator, annotate methods with @endpoint() for your desired HTTP routes, and then add an httpApi deployment section in golem.yaml for your domain.

Frequently Asked Questions about golem-add-http-endpoint-ts

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I expose a TypeScript Golem agent as a REST API?▼

To expose a TypeScript Golem agent as a REST API, add a `mount` path to the `@agent()` decorator, annotate methods with `@endpoint()` for HTTP verbs, and configure `httpApi` deployment in `golem.yaml`.

How do I map Golem agent methods to specific HTTP verbs and URL paths?▼

You map Golem agent methods to HTTP verbs and URL paths using the `@endpoint()` decorator, specifying exactly one HTTP method per decorator alongside the desired route path.

How does Golem handle typed request and response mapping for HTTP endpoints?▼

Golem handles typed request and response mapping for HTTP endpoints by relying on return-type-to-HTTP mappings, including `void`, `undefined`, `Result`, and `UnstructuredBinary` for predictable HTTP status codes and body formatting.

How do I configure golem.yaml to make my HTTP endpoints reachable?▼

To make HTTP endpoints reachable, you add an `httpApi` deployment section in your `golem.yaml` file to serve the agent on a target domain.

Can I mount a Golem agent at a URL path with variables from constructor parameters?▼

Yes, you can mount a Golem agent at a URL path with variables derived from constructor parameters by setting a base `mount` path on the `@agent()` decorator for consistent URL prefixing.