Initial release of go-telegram

A fully-generated, strongly-typed Go client for the Telegram Bot API.

* 176 methods + 301 types generated from Bot API v10.0
* 1408 auto-generated tests (8 scenarios per method)
* Typed unions throughout — no 'any' in the public surface
* Pluggable HTTP transport and JSON codec (default goccy/go-json)
* Built-in retry middleware honouring Telegram's retry_after
* Generic dispatcher with filters and conversation handlers
* Self-verifying codegen pipeline (regen → audit → emit → run tests)
* 14 example bots covering common patterns

dispatch/conversation/storage.go

@@ -0,0 +1,20 @@
+package conversation
+
+import (
+	"context"
+	"errors"
+)
+
+// ErrKeyNotFound is returned by Storage.Get when no conversation is active
+// for the given key.
+var ErrKeyNotFound = errors.New("conversation: key not found")
+
+// Storage persists per-user (or per-chat, per-message — depending on the
+// KeyStrategy in use) conversation state across update deliveries.
+//
+// Implementations must be safe for concurrent use.
+type Storage interface {
+	Get(ctx context.Context, key string) (State, error)
+	Set(ctx context.Context, key string, state State) error
+	Delete(ctx context.Context, key string) error
+}