@@ -17,7 +17,7 @@ require (

 	github.com/aws/aws-sdk-go-v2/credentials v1.19.13

 	github.com/aws/aws-sdk-go-v2/feature/ec2/imds v1.18.21

 	github.com/aws/aws-sdk-go-v2/service/cloudwatchlogs v1.66.0

-	github.com/aws/smithy-go v1.24.2

+	github.com/aws/smithy-go v1.25.0

 	github.com/cloudflare/cfssl v1.6.5

 	github.com/containerd/cgroups/v3 v3.1.3

 	github.com/containerd/containerd/api v1.10.0

@@ -113,8 +113,8 @@ github.com/aws/aws-sdk-go-v2/service/ssooidc v1.35.18 h1:mP49nTpfKtpXLt5SLn8Uv8z

 github.com/aws/aws-sdk-go-v2/service/ssooidc v1.35.18/go.mod h1:YO8TrYtFdl5w/4vmjL8zaBSsiNp3w0L1FfKVKenZT7w=

 github.com/aws/aws-sdk-go-v2/service/sts v1.41.10 h1:p8ogvvLugcR/zLBXTXrTkj0RYBUdErbMnAFFp12Lm/U=

 github.com/aws/aws-sdk-go-v2/service/sts v1.41.10/go.mod h1:60dv0eZJfeVXfbT1tFJinbHrDfSJ2GZl4Q//OSSNAVw=

-github.com/aws/smithy-go v1.24.2 h1:FzA3bu/nt/vDvmnkg+R8Xl46gmzEDam6mZ1hzmwXFng=

-github.com/aws/smithy-go v1.24.2/go.mod h1:YE2RhdIuDbA5E5bTdciG9KrW3+TiEONeUWCqxX9i1Fc=

+github.com/aws/smithy-go v1.25.0 h1:Sz/XJ64rwuiKtB6j98nDIPyYrV1nVNJ4YU74gttcl5U=

+github.com/aws/smithy-go v1.25.0/go.mod h1:YE2RhdIuDbA5E5bTdciG9KrW3+TiEONeUWCqxX9i1Fc=

 github.com/beorn7/perks v0.0.0-20180321164747-3a771d992973/go.mod h1:Dwedo/Wpr24TaqPxmxbtue+5NUziq4I4S80YR8gNf3Q=

 github.com/beorn7/perks v1.0.0/go.mod h1:KWe93zE9D1o94FZ5RNwFwVgaQK1VOXiVxmqh+CedLV8=

 github.com/beorn7/perks v1.0.1 h1:VlbKKnNfV8bJzeqoa4cOKqO6bYr3WgKZxO8Z16+hsOM=

new file mode 100644

@@ -0,0 +1,172 @@

+# AGENTS.md

+

+## Project overview

+

+smithy-go is the Go code generator and runtime for [Smithy](https://smithy.io/).

+It has two major components:

+

+1. **Codegen** (`codegen/`) — A Smithy build plugin written in Java that

+   generates Go client/server/shape code from Smithy models.

+2. **Runtime** (`./`, top-level Go module) — The Go packages that generated

+   code depends on at runtime.

+

+The primary downstream consumer is

+[aws-sdk-go-v2](https://github.com/aws/aws-sdk-go-v2).

+

+## Repository layout

+

+```

+.                               # Root Go module (github.com/aws/smithy-go)

+├── auth/                       # Auth identity + scheme interfaces

+│   └── bearer/                 # Bearer token auth

+├── aws-http-auth/              # Separate module: AWS SigV4/SigV4A HTTP signing

+├── codegen/                    # Java/Gradle: Smithy code generator

+│   ├── smithy-go-codegen/      # Main codegen source (Java)

+│   └── smithy-go-codegen-test/ # Codegen integration tests

+├── container/                  # Generic container types

+├── context/                    # Context helpers

+├── document/                   # Smithy document type abstraction

+│   └── json/                   # JSON document codec

+├── encoding/                   # Wire format encoders/decoders

+│   ├── cbor/                   # CBOR (used by rpcv2Cbor)

+│   ├── httpbinding/            # HTTP binding serde helpers

+│   ├── json/                   # JSON encoder/decoder

+│   └── xml/                    # XML encoder/decoder

+├── endpoints/                  # Endpoint resolution types

+├── internal/                   # Internal utilities (singleflight, etc.)

+├── io/                         # I/O helpers

+├── logging/                    # Logging interfaces

+├── metrics/                    # Metrics interfaces

+│   └── smithyotelmetrics/      # Separate module: OpenTelemetry metrics adapter

+├── middleware/                 # Middleware stack (the core of the operation pipeline)

+├── ptr/                        # Pointer-to/from-value helpers

+├── testing/                    # Test assertion helpers for generated protocol tests

+│   └── xml/                    # XML comparison utilities

+├── time/                       # Smithy timestamp format helpers

+├── tracing/                    # Tracing interfaces

+│   └── smithyoteltracing/      # Separate module: OpenTelemetry tracing adapter

+└── transport/

+    └── http/                   # HTTP request/response types and middleware

+```

+

+## Building and testing

+

+### Runtime (Go)

+

+```bash

+# Run unit tests

+make unit

+```

+

+### Codegen (Java)

+

+```bash

+# Build and test codegen

+cd codegen && ./gradlew build

+

+# Publish to local Maven for downstream use

+cd codegen && ./gradlew publishToMavenLocal

+```

+

+The codegen artifact version is fixed at `0.1.0` and is not published to

+Maven Central — you **MUST** `publishToMavenLocal`.

+

+## Runtime architecture

+

+### Middleware stack

+

+The operation pipeline is built on a middleware stack defined in `middleware/`.

+Steps execute in order: Initialize → Serialize → Build → Finalize →

+Deserialize. Each step is a `middleware.Step` that holds an ordered list of

+middleware. The codegen generates middleware registrations for each operation.

+

+### Encoding packages

+

+Each wire format has its own encoder/decoder under `encoding/`. These are

+low-level — they produce/consume raw tokens or values, not full Smithy shapes.

+Generated serde code calls into these packages.

+

+## Codegen: GoWriter and template system

+

+GoWriter extends Smithy's `SymbolWriter` and is the primary mechanism for

+generating Go source. It has **two distinct writing styles** that must not be

+confused.

+

+### Style 1: Positional args (`writer.write` / `writer.openBlock`)

+

+Inherited from `SymbolWriter`. Arguments are positional and referenced with

+`$`-prefixed format characters. Each `$X` consumes the next argument in order.

+

+Format characters:

+- `$L` — Literal (toString). Strings, names, anything that should be inserted

+  verbatim.

+- `$S` — String, quoted. Wraps the value in Go double-quotes.

+- `$T` — Type (Symbol). Inserts the symbol name and auto-adds its import.

+- `$P` — Pointable type (Symbol). Like `$T` but prepends `*` if the symbol is

+  marked pointable.

+- `$W` — Writable. Evaluates a `Writable` (lambda/closure) inline.

+- `$D` — Dependency. Adds a `GoDependency` import, expands to empty string.

+

+Numbered variants (`$1L`, `$2T`, etc.) allow reusing the same argument

+multiple times. The number is 1-indexed and refers to the position in the

+argument list:

+

+```java

+// $1L is used twice, $2L once — only 2 args needed

+writer.write("type $1L struct{}\nvar _ $2L = (*$1L)(nil)",

+    DEFAULT_NAME, INTERFACE_NAME);

+```

+

+`openBlock`/`closeBlock` manage indentation for braced blocks. Arguments are

+positional:

+

+```java

+writer.openBlock("func (c $P) $T(ctx $T) ($P, error) {", "}",

+    serviceSymbol, operationSymbol, contextSymbol, outputSymbol,

+    () -> {

+        writer.write("return nil, nil");

+    });

+```

+

+### Style 2: Named template args (`goTemplate` / `writeGoTemplate`)

+

+Uses `$name:X` syntax where `name` is a key in a `Map<String, Object>` and `X`

+is the format character. Arguments are passed as one or more maps. This is the

+**preferred style for new code** — it is more readable and less error-prone

+than positional args.

+

+```java

+return goTemplate("""

+    func $name:L(v $cborValue:T) ($type:T, error) {

+        return $coercer:T(v)

+    }

+    """,

+    Map.of(

+        "name", getDeserializerName(shape),

+        "cborValue", SmithyGoTypes.Encoding.Cbor.Value,

+        "type", symbolProvider.toSymbol(shape),

+        "coercer", coercer

+    ));

+```

+

+Rules:

+- `goTemplate(String, Map...)` is a **static** method that returns a

+  `Writable` (a `Consumer<GoWriter>` lambda). It does NOT write immediately.

+- `writeGoTemplate(String, Map...)` is an **instance** method that writes

+  immediately to the writer.

+- Maps are merged into the writer's context scope for the duration of the

+  template. Multiple maps can be passed and are applied in order.

+- The writer pre-populates common symbols in context: `fmt.Sprintf`,

+  `fmt.Errorf`, `errors.As`, `context.Context`, `time.Now`.

+

+### Composing writables

+

+- `ChainWritable` — Collects multiple `Writable`s and composes them with

+  newlines between each. Use `.compose()` (with newlines) or

+  `.compose(false)` (without).

+

+### Symbol constants

+

+For symbols, use `SmithyGoDependency.*.valueSymbol("Name")` or

+`SmithyGoDependency.*.pointableSymbol("Name")`.

+

@@ -1,8 +1,28 @@

-# Release (2026-02-27)

+# Release (2026-04-15)

+

+## General Highlights

+* **Dependency Update**: Updated to the latest SDK module versions

+

+## Module Highlights

+* `github.com/aws/smithy-go`: v1.25.0

+  * **Feature**: Add support for endpointBdd trait

+

+# Release (2026-04-02)

 ## General Highlights

 * **Dependency Update**: Updated to the latest SDK module versions

+## Module Highlights

+* `github.com/aws/smithy-go`: v1.24.3

+  * **Bug Fix**: Add additional sigv4 configuration.

+* `github.com/aws/smithy-go/aws-http-auth`: [v1.1.3](aws-http-auth/CHANGELOG.md#v113-2026-04-02)

+  * **Bug Fix**: Add additional sigv4 configuration.

+

+# Release (2026-02-27)

+

+## General Highlights

+* **Dependency Update**: Bump minimum go version to 1.24.

+

 # Release (2026-02-20)

 ## General Highlights

new file mode 100644

@@ -0,0 +1,16 @@

+package rulesfn

+

+import "strings"

+

+// Split splits the input string by the delimiter and returns the resulting

+// parts. If limit is > 0, at most limit substrings are returned.

+// Returns a slice with a single empty string if the input is empty.

+func Split(input, delimiter string, limit int) []string {

+	if len(input) == 0 {

+		return []string{""}

+	}

+	if limit > 0 {

+		return strings.SplitN(input, delimiter, limit)

+	}

+	return strings.Split(input, delimiter)

+}

@@ -3,4 +3,4 @@

 package smithy

 // goModuleVersion is the tagged release for this module

-const goModuleVersion = "1.24.2"

+const goModuleVersion = "1.25.0"

@@ -273,7 +273,7 @@ github.com/aws/aws-sdk-go-v2/service/ssooidc/types

 github.com/aws/aws-sdk-go-v2/service/sts

 github.com/aws/aws-sdk-go-v2/service/sts/internal/endpoints

 github.com/aws/aws-sdk-go-v2/service/sts/types

-# github.com/aws/smithy-go v1.24.2

+# github.com/aws/smithy-go v1.25.0

 ## explicit; go 1.24

 github.com/aws/smithy-go

 github.com/aws/smithy-go/auth