Skip to content

feat: add optional _meta request metadata to all command parameters #379

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Don Jayamanne (DonJayamanne) merged 3 commits into from
Aug 3, 2026
Merged

feat: add optional _meta request metadata to all command parameters #379

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
e9b809f
feat: add optional `_meta` request metadata to all command parameters
DonJayamanne Aug 3, 2026
8e9801c
feat: add optional `meta` field to SubscribeParams and related functions
DonJayamanne Aug 3, 2026
24334f5
feat: add optional `meta` field to resource read and completions para…
DonJayamanne Aug 3, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
78 changes: 78 additions & 0 deletions clients/go/ahptypes/commands.generated.go
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -94,6 +94,9 @@ const (
type InitializeParams struct {
// Channel URI this command targets.
Channel URI `json:"channel"`
// Optional JSON-serializable metadata associated with this request.
// Receivers MUST ignore keys they do not understand.
Meta map[string]json.RawMessage `json:"_meta,omitempty"`
// Protocol versions the client is willing to speak, ordered from most
// preferred to least preferred. Each entry is a [SemVer](https://semver.org)
// `MAJOR.MINOR.PATCH` string (e.g. `"0.1.0"`).
Expand Down Expand Up @@ -215,6 +218,9 @@ type Implementation struct {
type ReconnectParams struct {
// Channel URI this command targets.
Channel URI `json:"channel"`
// Optional JSON-serializable metadata associated with this request.
// Receivers MUST ignore keys they do not understand.
Meta map[string]json.RawMessage `json:"_meta,omitempty"`
// Client identifier from the original connection
ClientId string `json:"clientId"`
// Last `serverSeq` the client received
Expand Down Expand Up @@ -251,6 +257,9 @@ type ReconnectSnapshotResult struct {
type SubscribeParams struct {
// Channel URI this command targets.
Channel URI `json:"channel"`
// Optional JSON-serializable metadata associated with this request.
// Receivers MUST ignore keys they do not understand.
Meta map[string]json.RawMessage `json:"_meta,omitempty"`
// Optional delivery preferences for this subscription.
//
// Servers MAY use these preferences to buffer and coalesce high-frequency
Expand Down Expand Up @@ -313,6 +322,9 @@ type SessionForkSource struct {
type CreateSessionParams struct {
// Channel URI this command targets.
Channel URI `json:"channel"`
// Optional JSON-serializable metadata associated with this request.
// Receivers MUST ignore keys they do not understand.
Meta map[string]json.RawMessage `json:"_meta,omitempty"`
// Agent provider ID
Provider *string `json:"provider,omitempty"`
// The working directories the session's agent is granted tool access to.
Expand Down Expand Up @@ -363,6 +375,9 @@ type CreateSessionParams struct {
type DisposeSessionParams struct {
// Channel URI this command targets.
Channel URI `json:"channel"`
// Optional JSON-serializable metadata associated with this request.
// Receivers MUST ignore keys they do not understand.
Meta map[string]json.RawMessage `json:"_meta,omitempty"`
}

// Copies source history through a completed turn into the new chat.
Expand Down Expand Up @@ -405,6 +420,9 @@ type SideChatSource struct {
type CreateChatParams struct {
// Channel URI this command targets.
Channel URI `json:"channel"`
// Optional JSON-serializable metadata associated with this request.
// Receivers MUST ignore keys they do not understand.
Meta map[string]json.RawMessage `json:"_meta,omitempty"`
// Chat URI (client-chosen, e.g. `ahp-chat:/<uuid>`).
Chat URI `json:"chat"`
// Optional initial message for the new chat.
Expand Down Expand Up @@ -439,6 +457,9 @@ type CreateChatParams struct {
type DisposeChatParams struct {
// Channel URI this command targets.
Channel URI `json:"channel"`
// Optional JSON-serializable metadata associated with this request.
// Receivers MUST ignore keys they do not understand.
Meta map[string]json.RawMessage `json:"_meta,omitempty"`
}

// Returns a list of session summaries. Used to populate session lists and sidebars.
Expand All @@ -456,6 +477,9 @@ type DisposeChatParams struct {
type ListSessionsParams struct {
// Channel URI this command targets.
Channel URI `json:"channel"`
// Optional JSON-serializable metadata associated with this request.
// Receivers MUST ignore keys they do not understand.
Meta map[string]json.RawMessage `json:"_meta,omitempty"`
// Maximum number of entries to return in this page. The server SHOULD respect
// this bound but MAY return fewer entries and MAY impose its own upper cap.
// Omit to let the server choose the page size.
Expand Down Expand Up @@ -494,6 +518,9 @@ type ListSessionsResult struct {
type ResourceReadParams struct {
// Channel URI this command targets.
Channel URI `json:"channel"`
// Optional JSON-serializable metadata associated with this request.
// Receivers MUST ignore keys they do not understand.
Meta map[string]json.RawMessage `json:"_meta,omitempty"`
// Content URI from a `ContentRef`
Uri string `json:"uri"`
// Preferred encoding for the returned data (default: server-chosen)
Expand Down Expand Up @@ -531,6 +558,9 @@ type ResourceReadResult struct {
type ResourceWriteParams struct {
// Channel URI this command targets.
Channel URI `json:"channel"`
// Optional JSON-serializable metadata associated with this request.
// Receivers MUST ignore keys they do not understand.
Meta map[string]json.RawMessage `json:"_meta,omitempty"`
// Target file URI on the server filesystem
Uri URI `json:"uri"`
// Content encoded as a string
Expand Down Expand Up @@ -580,6 +610,9 @@ type ResourceWriteResult struct {
type ResourceListParams struct {
// Channel URI this command targets.
Channel URI `json:"channel"`
// Optional JSON-serializable metadata associated with this request.
// Receivers MUST ignore keys they do not understand.
Meta map[string]json.RawMessage `json:"_meta,omitempty"`
// Directory URI on the server filesystem
Uri URI `json:"uri"`
}
Expand Down Expand Up @@ -608,6 +641,9 @@ type DirectoryEntry struct {
type ResourceCopyParams struct {
// Channel URI this command targets.
Channel URI `json:"channel"`
// Optional JSON-serializable metadata associated with this request.
// Receivers MUST ignore keys they do not understand.
Meta map[string]json.RawMessage `json:"_meta,omitempty"`
// Source URI to copy from
Source URI `json:"source"`
// Destination URI to copy to
Expand All @@ -630,6 +666,9 @@ type ResourceCopyResult struct {
type ResourceDeleteParams struct {
// Channel URI this command targets.
Channel URI `json:"channel"`
// Optional JSON-serializable metadata associated with this request.
// Receivers MUST ignore keys they do not understand.
Meta map[string]json.RawMessage `json:"_meta,omitempty"`
// URI of the resource to delete
Uri URI `json:"uri"`
// If `true` and the target is a directory, delete it and all its contents
Expand All @@ -653,6 +692,9 @@ type ResourceDeleteResult struct {
type ResourceMoveParams struct {
// Channel URI this command targets.
Channel URI `json:"channel"`
// Optional JSON-serializable metadata associated with this request.
// Receivers MUST ignore keys they do not understand.
Meta map[string]json.RawMessage `json:"_meta,omitempty"`
// Source URI to move from
Source URI `json:"source"`
// Destination URI to move to
Expand Down Expand Up @@ -682,6 +724,9 @@ type ResourceMoveResult struct {
type ResourceResolveParams struct {
// Channel URI this command targets.
Channel URI `json:"channel"`
// Optional JSON-serializable metadata associated with this request.
// Receivers MUST ignore keys they do not understand.
Meta map[string]json.RawMessage `json:"_meta,omitempty"`
// URI to resolve
Uri URI `json:"uri"`
// When `true` (default), follow symlinks and report the metadata of the
Expand Down Expand Up @@ -725,6 +770,9 @@ type ResourceResolveResult struct {
type ResourceMkdirParams struct {
// Channel URI this command targets.
Channel URI `json:"channel"`
// Optional JSON-serializable metadata associated with this request.
// Receivers MUST ignore keys they do not understand.
Meta map[string]json.RawMessage `json:"_meta,omitempty"`
// Directory URI to create (parents created as needed).
Uri URI `json:"uri"`
}
Expand Down Expand Up @@ -759,6 +807,9 @@ type ResourceMkdirResult struct {
type ResourceRequestParams struct {
// Channel URI this command targets.
Channel URI `json:"channel"`
// Optional JSON-serializable metadata associated with this request.
// Receivers MUST ignore keys they do not understand.
Meta map[string]json.RawMessage `json:"_meta,omitempty"`
// Resource URI being requested. Typically a `file:` URI on the receiver's
// filesystem, but any URI scheme that the receiver mediates access to is
// allowed.
Expand Down Expand Up @@ -793,6 +844,9 @@ type ResourceRequestResult struct {
type CreateResourceWatchParams struct {
// Channel URI this command targets.
Channel URI `json:"channel"`
// Optional JSON-serializable metadata associated with this request.
// Receivers MUST ignore keys they do not understand.
Meta map[string]json.RawMessage `json:"_meta,omitempty"`
// URI to watch.
Uri URI `json:"uri"`
// If `true`, the receiver MUST report changes for descendants of `uri`.
Expand Down Expand Up @@ -829,6 +883,9 @@ type CreateResourceWatchResult struct {
type FetchTurnsParams struct {
// Channel URI this command targets.
Channel URI `json:"channel"`
// Optional JSON-serializable metadata associated with this request.
// Receivers MUST ignore keys they do not understand.
Meta map[string]json.RawMessage `json:"_meta,omitempty"`
// Opaque cursor from `ChatState.turnsNextCursor`.
//
// The host MUST reject unrecognised cursors with `InvalidParams`. Omit only
Expand Down Expand Up @@ -879,6 +936,9 @@ type DispatchActionParams struct {
type AuthenticateParams struct {
// Channel URI this command targets.
Channel URI `json:"channel"`
// Optional JSON-serializable metadata associated with this request.
// Receivers MUST ignore keys they do not understand.
Meta map[string]json.RawMessage `json:"_meta,omitempty"`
// The protected resource identifier. MUST match a `resource` value the
// server has advertised — via `ProtectedResourceMetadata` in
// `AgentInfo.protectedResources`, or via a live
Expand Down Expand Up @@ -911,6 +971,9 @@ type AuthenticateResult struct {
type CreateTerminalParams struct {
// Channel URI this command targets.
Channel URI `json:"channel"`
// Optional JSON-serializable metadata associated with this request.
// Receivers MUST ignore keys they do not understand.
Meta map[string]json.RawMessage `json:"_meta,omitempty"`
// Initial owner of the terminal
Claim TerminalClaim `json:"claim"`
// Human-readable terminal name
Expand All @@ -930,6 +993,9 @@ type CreateTerminalParams struct {
type DisposeTerminalParams struct {
// Channel URI this command targets.
Channel URI `json:"channel"`
// Optional JSON-serializable metadata associated with this request.
// Receivers MUST ignore keys they do not understand.
Meta map[string]json.RawMessage `json:"_meta,omitempty"`
}

// Iteratively resolves the session configuration schema. The client sends the
Expand All @@ -944,6 +1010,9 @@ type DisposeTerminalParams struct {
type ResolveSessionConfigParams struct {
// Channel URI this command targets.
Channel URI `json:"channel"`
// Optional JSON-serializable metadata associated with this request.
// Receivers MUST ignore keys they do not understand.
Meta map[string]json.RawMessage `json:"_meta,omitempty"`
// Agent provider ID
Provider *string `json:"provider,omitempty"`
// Working directory for the session
Expand All @@ -968,6 +1037,9 @@ type ResolveSessionConfigResult struct {
type SessionConfigCompletionsParams struct {
// Channel URI this command targets.
Channel URI `json:"channel"`
// Optional JSON-serializable metadata associated with this request.
// Receivers MUST ignore keys they do not understand.
Meta map[string]json.RawMessage `json:"_meta,omitempty"`
// Agent provider ID
Provider *string `json:"provider,omitempty"`
// Working directory for the session
Expand Down Expand Up @@ -1006,6 +1078,9 @@ type SessionConfigValueItem struct {
type CompletionsParams struct {
// Channel URI this command targets.
Channel URI `json:"channel"`
// Optional JSON-serializable metadata associated with this request.
// Receivers MUST ignore keys they do not understand.
Meta map[string]json.RawMessage `json:"_meta,omitempty"`
// What kind of completion is being requested.
Kind CompletionItemKind `json:"kind"`
// The complete text of the input being completed (e.g. the full user
Expand Down Expand Up @@ -1065,6 +1140,9 @@ type CompletionsResult struct {
type InvokeChangesetOperationParams struct {
// Channel URI this command targets.
Channel URI `json:"channel"`
// Optional JSON-serializable metadata associated with this request.
// Receivers MUST ignore keys they do not understand.
Meta map[string]json.RawMessage `json:"_meta,omitempty"`
// Matches {@link ChangesetOperation.id} from the changeset's `operations` list.
OperationId string `json:"operationId"`
// Target of the operation. Required iff the chosen scope is
Expand Down
Loading
Loading