Stub for Agent RPC

[ruifigueira]

A proposal for a stub object for Agent RPC that better mimics method calls.

Usage example:

const { stub } = useAgent<MyAgent, {}>({ agent: "my-agent" });

// return type is promisified
stub.sayHello() satisfies Promise<string>;

// @ts-expect-error first argument is not a string
await stub.sayHello(1);

await stub.perform("some task", 1);
await stub.perform("another task");
// @ts-expect-error requires parameters
await stub.perform();

[changeset-bot]

🦋 Changeset detected

Latest commit: f823d11

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 2 packages

Name	Type
agents	Patch
hono-agents	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[threepointone]

love this idea. how about instead of calling this "stub", we call it rpc. so it'll be agent.rpc.f1()

[ruifigueira]

Sure, that even was the initial name but I changed it before submitting the PR 😅 I'll do it at the end of the day

[threepointone]

well, the nice thing about calling it "stub" is that's what we call it eslewhere in workers already. so maybe we it's fine to call it stub here. lemme review and land this!

[threepointone]

great implementation, so simple

[threepointone]

another banger, great PR