update AI provider documentation (#2897)

* feat: add prometheus monitoring wrapper

Reintroduces the Prometheus metrics wrapper previously available in the
plugins repository, updated for go-micro v5. Exposes request count and
latency histograms for handlers, subscribers, and outgoing client calls
via NewHandlerWrapper, NewSubscriberWrapper, NewCallWrapper and
NewClientWrapper, labelled with service/endpoint/status.

Options cover namespace, subsystem, const labels, histogram buckets and
a custom registerer; duplicate collectors (e.g. from multiple wrappers
sharing the same config) are reused transparently via a cached
metrics bundle.

Fixes #2893

* fix(registry/etcd): clear lease/register caches on KeepAlive channel closure

When the etcd client's long-lived KeepAlive channel closes (e.g. because
the lease expired on the server side during a network partition), the
previous cleanup only removed the channel bookkeeping. The stale entries
in `leases` and `register` caused the next registerNode() heartbeat to
hit the "unchanged hash" short-circuit and skip re-registration entirely,
so the service permanently disappeared from etcd.

Extract the cleanup into handleKeepAliveClosed and also drop the cached
lease id and hash so the next heartbeat performs a full Grant+Put and
the service recovers within one RegisterInterval.

Regression introduced by #2822; fix is symmetric with the existing
synchronous KeepAliveOnce recovery path that propagates
rpctypes.ErrLeaseNotFound.

* docs: add AI provider integration guide and Supported AI Providers section

Add a step-by-step guide for AI infrastructure companies to implement
ai.Model and contribute a provider to go-micro. Covers the full
lifecycle: skeleton, tool call handling, tests, registration, and PR
checklist.

Add a "Supported AI Providers" section to the project README that lists
current providers (Anthropic, OpenAI) in a table and links to the
integration guide with a call-to-action for new providers and sponsors.

Streamline the "Adding a New Provider" section in ai/README.md to point
to the new guide instead of duplicating a full code listing.

* Update contribution guidelines in README.md

Removed Discord contact information for platform contributions.

---------

Co-authored-by: Claude <noreply@anthropic.com>

Author: asim

README.md

@@ -376,6 +376,7 @@ Package reference: https://pkg.go.dev/go-micro.dev/v5
 - [Getting Started](internal/website/docs/getting-started.md)
 - [Data Model](internal/website/docs/model.md)
 - [MCP & AI Agents](internal/website/docs/mcp.md)
+- [AI Provider Integration](internal/website/docs/guides/ai-provider-guide.md)
 - [Plugins Overview](internal/website/docs/plugins.md)
 - [Learn by Example](internal/website/docs/examples/index.md)
 - [Deployment Guide](internal/website/docs/deployment.md)
@@ -388,6 +389,26 @@ Package reference: https://pkg.go.dev/go-micro.dev/v5
 - [TLS Security Migration](internal/website/docs/TLS_SECURITY_UPDATE.md)
 - [Security Migration Guide](internal/website/docs/SECURITY_MIGRATION.md)
 
+## Supported AI Providers
+
+Go Micro’s `ai` package gives every provider the same interface: `Init`, `Generate`, `Stream`, and functional options. Swap providers with a single import.
+
+| Provider | Import | Default Model |
+|----------|--------|---------------|
+| **Anthropic** | `go-micro.dev/v5/ai/anthropic` | `claude-sonnet-4-20250514` |
+| **OpenAI** | `go-micro.dev/v5/ai/openai` | `gpt-4o` |
+
+Any provider that exposes an OpenAI-compatible API can also be used directly:
+
+```go
+m := ai.New("openai",
+    ai.WithAPIKey("your-key"),
+    ai.WithBaseURL("https://api.yourprovider.com"),
+)
+```
+
+**Want to add your platform?** See the [AI Provider Integration Guide](internal/website/docs/guides/ai-provider-guide.md) for how to implement `ai.Model` and submit a PR. We welcome both code contributions and sponsorships from AI infrastructure companies — reach out via a [GitHub issue](https://github.com/micro/go-micro/issues).
+
 ## Adopters
 
 - [Sourse](https://sourse.eu) - Work in the field of earth observation, including embedded Kubernetes running onboard aircraft, and we’ve built a mission management SaaS platform using Go Micro.

ai/README.md

@@ -165,70 +165,21 @@ m := ai.New(provider, ai.WithAPIKey("..."))
 
 ## Adding a New Provider
 
-1. Create a new package under `ai/`:
+See the full **[AI Provider Integration Guide](../internal/website/docs/guides/ai-provider-guide.md)** for a step-by-step walkthrough, checklist, and design notes.
 
-```go
-package myprovider
-
-import "go-micro.dev/v5/ai"
-
-func init() {
-    ai.Register("myprovider", func(opts ...ai.Option) ai.Model {
-        return NewProvider(opts...)
-    })
-}
-
-type Provider struct {
-    opts ai.Options
-}
+Quick summary:
 
-func NewProvider(opts ...ai.Option) *Provider {
-    options := ai.NewOptions(opts...)
-    // Set defaults
-    if options.Model == "" {
-        options.Model = "my-default-model"
-    }
-    if options.BaseURL == "" {
-        options.BaseURL = "https://api.myprovider.com"
-    }
-    return &Provider{opts: options}
-}
-
-func (p *Provider) Init(opts ...ai.Option) error {
-    for _, o := range opts {
-        o(&p.opts)
-    }
-    return nil
-}
-
-func (p *Provider) Options() ai.Options {
-    return p.opts
-}
-
-func (p *Provider) String() string {
-    return "myprovider"
-}
-
-func (p *Provider) Generate(ctx context.Context, req *ai.Request, opts ...ai.GenerateOption) (*ai.Response, error) {
-    // Implement your provider logic
-    // - Build API request
-    // - Make HTTP call
-    // - Parse response
-    // - Handle tools if ToolHandler is set
-    return &ai.Response{}, nil
-}
-
-func (p *Provider) Stream(ctx context.Context, req *ai.Request, opts ...ai.GenerateOption) (ai.Stream, error) {
-    return nil, fmt.Errorf("streaming not implemented")
-}
-```
-
-2. Import your provider:
+1. Create `ai/yourprovider/yourprovider.go` implementing `ai.Model`.
+2. Call `ai.Register("yourprovider", ...)` in `init()`.
+3. Add tests in `ai/yourprovider/yourprovider_test.go`.
+4. Users enable the provider with a blank import:
 
 ```go
-import _ "go-micro.dev/v5/ai/myprovider"
+import _ "go-micro.dev/v5/ai/yourprovider"
 ```
 
+We welcome contributions and sponsorships from AI infrastructure companies — see the guide for details.
+
 ## Comparison with Other Packages
 
 The ai package follows the same patterns as other go-micro packages: