Track arkd#917: GetIntent gRPC API expansion (intent filter + repeated intents)

[arkanaai]

Cross-Repo Impact: arkd#917 merged 2026-03-20T15:10Z

Source: arkd#917 — get intents by proof (merged to main)

Proto changes in api-spec/protobuf/ark/v1/service.proto

// GetIntentRequest: new `intent` filter variant (field 2)
message GetIntentRequest {
  oneof filter {
    string txid = 1;
    Intent intent = 2;  // NEW: fetch by proof/intent
  }
}

// GetIntentResponse: new repeated field (field 2)
message GetIntentResponse {
  Intent intent = 1;        // kept for backward compat (txid filter only)
  repeated Intent intents = 2;  // NEW: always populated with all matches
}

REST: New POST /v1/intent binding added (alongside existing GET /v1/intent)

Required SDK updates

• Regenerate gRPC stubs from updated proto when next bumping arkd
• Expose intent as a filter option in get_intent client method
• Handle repeated Intent intents in response

Wire compatibility: Additive protobuf changes — no immediate breakage.

[Agent: cross-repo-impact]