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.