feat: add contextforge v1.0.0-beta-1 compatibility

- add Tag struct with custom JSON marshal/unmarshal for API asymmetry
- change Prompt.ID from int to string
- add helper functions: NewTags(), TagNames(), NewTag()
- update integration test setup for mcp-contextforge-gateway==1.0.0b1
- update all examples and tests for new types

Author: leefowlercu

CLAUDE.md

@@ -12,7 +12,7 @@ A Go SDK for the [IBM ContextForge MCP Gateway](https://github.com/IBM/mcp-conte
 - [Quick Start](#quick-start)
 - [Usage Guide](#usage-guide)
   - [Client Configuration](#client-configuration)
-  - [Pointer Helpers](#pointer-helpers)
+  - [Pointer Helpers and Tags](#pointer-helpers-and-tags)
   - [Managing Tools](#managing-tools)
   - [Managing Resources](#managing-resources)
   - [Managing Gateways](#managing-gateways)
@@ -111,7 +111,8 @@ func main() {
 
     fmt.Printf("Found %d tools:\n", len(tools))
     for _, tool := range tools {
-        fmt.Printf("- %s: %s\n", tool.Name, *tool.Description)
+        desc := contextforge.StringValue(tool.Description) // Safe nil handling
+        fmt.Printf("- %s: %s\n", tool.Name, desc)
     }
 
     // Get a specific tool
@@ -158,7 +159,7 @@ if err != nil {
 // Note: NewClient automatically adds trailing slash if missing
 ```
 
-### Pointer Helpers
+### Pointer Helpers and Tags
 
 The SDK uses pointers and slices to distinguish between three states for optional fields:
 
@@ -211,6 +212,23 @@ update3 := &contextforge.ResourceUpdate{
 }
 ```
 
+**Tag type handling:**
+
+Tags have different types for input vs output due to API response format changes in v1.0.0:
+
+- **Create/Update types** use `[]string` for input (e.g., `ResourceCreate.Tags`, `PromptCreate.Tags`)
+- **Read types** return `[]Tag` structs with `ID` and `Label` fields (e.g., `Tool.Tags`, `Prompt.Tags`)
+
+Helper functions for conversion:
+
+```go
+// Convert strings to Tag structs (for update operations on read types)
+tags := contextforge.NewTags([]string{"tag1", "tag2"})
+
+// Extract tag names from Tag structs
+names := contextforge.TagNames(tool.Tags) // Returns []string{"tag1", "tag2"}
+```
+
 ### Managing Tools
 
 ```go
@@ -492,19 +510,19 @@ if err == nil {
 // Get prompt without arguments
 result, _, err = client.Prompts.GetNoArgs(ctx, "simple-prompt")
 
-// Update prompt
+// Update prompt (promptID is a string)
 update := &contextforge.PromptUpdate{
     Description: contextforge.String("Updated description"),
     Template:    contextforge.String("Updated template: {{new_arg}}"),
 }
-updated, _, err := client.Prompts.Update(ctx, 123, update)
+updated, _, err := client.Prompts.Update(ctx, "prompt-id", update)
 
 // Toggle prompt status
-toggled, _, err := client.Prompts.Toggle(ctx, 123, true) // activate
-toggled, _, err = client.Prompts.Toggle(ctx, 123, false) // deactivate
+toggled, _, err := client.Prompts.Toggle(ctx, "prompt-id", true) // activate
+toggled, _, err = client.Prompts.Toggle(ctx, "prompt-id", false) // deactivate
 
 // Delete prompt
-_, err = client.Prompts.Delete(ctx, 123)
+_, err = client.Prompts.Delete(ctx, "prompt-id")
 ```
 
 ### Managing Agents
@@ -1149,7 +1167,9 @@ This SDK follows the service-oriented architecture pattern established by [googl
 
 - **FlexibleID** - Handles API inconsistencies where IDs may be returned as integers or strings
 - **Timestamp** - Custom timestamp parsing for API responses without timezone information
+- **Tag** - Handles tag objects with `ID` and `Label` fields; custom JSON marshal/unmarshal for API compatibility
 - **Pointer helpers** - `String()`, `Int()`, `Bool()`, `Time()` for working with optional fields
+- **Tag helpers** - `NewTags()`, `NewTag()`, `TagNames()` for converting between `[]string` and `[]Tag`
 
 ## Links
 
@@ -1162,7 +1182,7 @@ This SDK follows the service-oriented architecture pattern established by [googl
 
 ### Upstream ContextForge API Bugs
 
-The SDK integration tests have identified six bugs in ContextForge v0.8.0. These bugs are in the upstream API, not the SDK implementation. Affected tests are skipped and will be re-enabled once upstream bugs are fixed.
+The SDK integration tests have identified six bugs in ContextForge (confirmed in both v0.8.0 and v1.0.0-BETA-1). These bugs are in the upstream API, not the SDK implementation. Affected tests are skipped and will be re-enabled once upstream bugs are fixed.
 
 **CONTEXTFORGE-001: Toggle Endpoints Return Stale State**
 The `POST /prompts/{id}/toggle` and `POST /resources/{id}/toggle` endpoints return stale `isActive` state despite correctly updating the database. See [`docs/upstream-bugs/prompt-toggle.md`](docs/upstream-bugs/prompt-toggle.md).

README.md

@@ -131,7 +131,7 @@ func TestAgentsService_Create(t *testing.T) {
 		}
 
 		w.Header().Set("Content-Type", "application/json")
-		fmt.Fprint(w, `{"id":"456","name":"new-agent","slug":"new-agent","endpointUrl":"https://example.com/new-agent","description":"A new agent","agentType":"generic","protocolVersion":"1.0","enabled":true,"reachable":false,"tags":["test"]}`)
+		fmt.Fprint(w, `{"id":"456","name":"new-agent","slug":"new-agent","endpointUrl":"https://example.com/new-agent","description":"A new agent","agentType":"generic","protocolVersion":"1.0","enabled":true,"reachable":false,"tags":[{"id":"test","label":"test"}]}`)
 	})
 
 	ctx := context.Background()
@@ -213,7 +213,7 @@ func TestAgentsService_Update(t *testing.T) {
 		}
 
 		w.Header().Set("Content-Type", "application/json")
-		fmt.Fprint(w, `{"id":"123","name":"test-agent","slug":"test-agent","endpointUrl":"https://example.com/agent","description":"Updated description","agentType":"generic","protocolVersion":"1.0","enabled":true,"reachable":true,"tags":["updated"]}`)
+		fmt.Fprint(w, `{"id":"123","name":"test-agent","slug":"test-agent","endpointUrl":"https://example.com/agent","description":"Updated description","agentType":"generic","protocolVersion":"1.0","enabled":true,"reachable":true,"tags":[{"id":"updated","label":"updated"}]}`)
 	})
 
 	ctx := context.Background()

contextforge/agents_test.go

@@ -115,8 +115,9 @@ func (s *PromptsService) Create(ctx context.Context, prompt *PromptCreate, opts
 
 // Update updates an existing prompt.
 // Note: The API does not wrap the request body for prompt updates.
-func (s *PromptsService) Update(ctx context.Context, promptID int, prompt *PromptUpdate) (*Prompt, *Response, error) {
-	u := fmt.Sprintf("prompts/%d", promptID)
+// Note: promptID changed from int to string in v1.0.0.
+func (s *PromptsService) Update(ctx context.Context, promptID string, prompt *PromptUpdate) (*Prompt, *Response, error) {
+	u := fmt.Sprintf("prompts/%s", promptID)
 
 	req, err := s.client.NewRequest(http.MethodPut, u, prompt)
 	if err != nil {
@@ -133,8 +134,9 @@ func (s *PromptsService) Update(ctx context.Context, promptID int, prompt *Promp
 }
 
 // Delete deletes a prompt by its ID.
-func (s *PromptsService) Delete(ctx context.Context, promptID int) (*Response, error) {
-	u := fmt.Sprintf("prompts/%d", promptID)
+// Note: promptID changed from int to string in v1.0.0.
+func (s *PromptsService) Delete(ctx context.Context, promptID string) (*Response, error) {
+	u := fmt.Sprintf("prompts/%s", promptID)
 
 	req, err := s.client.NewRequest(http.MethodDelete, u, nil)
 	if err != nil {
@@ -150,8 +152,9 @@ func (s *PromptsService) Delete(ctx context.Context, promptID int) (*Response, e
 }
 
 // Toggle toggles a prompt's active status.
-func (s *PromptsService) Toggle(ctx context.Context, promptID int, activate bool) (*Prompt, *Response, error) {
-	u := fmt.Sprintf("prompts/%d/toggle?activate=%t", promptID, activate)
+// Note: promptID changed from int to string in v1.0.0.
+func (s *PromptsService) Toggle(ctx context.Context, promptID string, activate bool) (*Prompt, *Response, error) {
+	u := fmt.Sprintf("prompts/%s/toggle?activate=%t", promptID, activate)
 
 	req, err := s.client.NewRequest(http.MethodPost, u, nil)
 	if err != nil {

contextforge/prompts.go

@@ -16,7 +16,7 @@ func TestPromptsService_List(t *testing.T) {
 		testMethod(t, r, "GET")
 		w.Header().Set("Content-Type", "application/json")
 		w.Header().Set("X-Next-Cursor", "next123")
-		fmt.Fprint(w, `[{"id":1,"name":"test-prompt","description":"A test","template":"Hello {{name}}","arguments":[],"isActive":true,"tags":[],"metrics":{"totalExecutions":10,"successfulExecutions":9,"failedExecutions":1,"failureRate":0.1}}]`)
+		fmt.Fprint(w, `[{"id":"1","name":"test-prompt","description":"A test","template":"Hello {{name}}","arguments":[],"isActive":true,"tags":[],"metrics":{"totalExecutions":10,"successfulExecutions":9,"failedExecutions":1,"failureRate":0.1}}]`)
 	})
 
 	ctx := context.Background()
@@ -268,7 +268,7 @@ func TestPromptsService_Create(t *testing.T) {
 		}
 
 		w.Header().Set("Content-Type", "application/json")
-		fmt.Fprint(w, `{"id":456,"name":"new-prompt","description":"A new prompt","template":"Hello {{name}}","arguments":[{"name":"name","required":true}],"isActive":true,"tags":["test"],"metrics":{"totalExecutions":0,"successfulExecutions":0,"failedExecutions":0,"failureRate":0}}`)
+		fmt.Fprint(w, `{"id":"456","name":"new-prompt","description":"A new prompt","template":"Hello {{name}}","arguments":[{"name":"name","required":true}],"isActive":true,"tags":[{"id":"test","label":"test"}],"metrics":{"totalExecutions":0,"successfulExecutions":0,"failedExecutions":0,"failureRate":0}}`)
 	})
 
 	ctx := context.Background()
@@ -278,8 +278,8 @@ func TestPromptsService_Create(t *testing.T) {
 		t.Errorf("Prompts.Create returned error: %v", err)
 	}
 
-	if prompt.ID != 456 {
-		t.Errorf("Prompts.Create returned prompt ID %d, want %d", prompt.ID, 456)
+	if prompt.ID != "456" {
+		t.Errorf("Prompts.Create returned prompt ID %q, want %q", prompt.ID, "456")
 	}
 
 	if prompt.Name != "new-prompt" {
@@ -315,7 +315,7 @@ func TestPromptsService_Create_WithOptions(t *testing.T) {
 		}
 
 		w.Header().Set("Content-Type", "application/json")
-		fmt.Fprint(w, `{"id":456,"name":"new-prompt","template":"Hello {{name}}","arguments":[],"isActive":true,"teamId":"team-123","visibility":"private","metrics":{"totalExecutions":0,"successfulExecutions":0,"failedExecutions":0,"failureRate":0}}`)
+		fmt.Fprint(w, `{"id":"456","name":"new-prompt","template":"Hello {{name}}","arguments":[],"isActive":true,"teamId":"team-123","visibility":"private","metrics":{"totalExecutions":0,"successfulExecutions":0,"failedExecutions":0,"failureRate":0}}`)
 	})
 
 	ctx := context.Background()
@@ -352,11 +352,11 @@ func TestPromptsService_Update(t *testing.T) {
 		}
 
 		w.Header().Set("Content-Type", "application/json")
-		fmt.Fprint(w, `{"id":123,"name":"updated-prompt","description":"An updated prompt","template":"Hello {{name}}","arguments":[],"isActive":true,"metrics":{"totalExecutions":0,"successfulExecutions":0,"failedExecutions":0,"failureRate":0}}`)
+		fmt.Fprint(w, `{"id":"123","name":"updated-prompt","description":"An updated prompt","template":"Hello {{name}}","arguments":[],"isActive":true,"metrics":{"totalExecutions":0,"successfulExecutions":0,"failedExecutions":0,"failureRate":0}}`)
 	})
 
 	ctx := context.Background()
-	prompt, _, err := client.Prompts.Update(ctx, 123, input)
+	prompt, _, err := client.Prompts.Update(ctx, "123", input)
 
 	if err != nil {
 		t.Errorf("Prompts.Update returned error: %v", err)
@@ -377,7 +377,7 @@ func TestPromptsService_Delete(t *testing.T) {
 	})
 
 	ctx := context.Background()
-	_, err := client.Prompts.Delete(ctx, 123)
+	_, err := client.Prompts.Delete(ctx, "123")
 
 	if err != nil {
 		t.Errorf("Prompts.Delete returned error: %v", err)
@@ -398,11 +398,11 @@ func TestPromptsService_Toggle(t *testing.T) {
 		}
 
 		w.Header().Set("Content-Type", "application/json")
-		fmt.Fprint(w, `{"status":"success","message":"Prompt activated","prompt":{"id":123,"name":"test-prompt","template":"Hello {{name}}","arguments":[],"isActive":true,"metrics":{"totalExecutions":0,"successfulExecutions":0,"failedExecutions":0,"failureRate":0}}}`)
+		fmt.Fprint(w, `{"status":"success","message":"Prompt activated","prompt":{"id":"123","name":"test-prompt","template":"Hello {{name}}","arguments":[],"isActive":true,"metrics":{"totalExecutions":0,"successfulExecutions":0,"failedExecutions":0,"failureRate":0}}}`)
 	})
 
 	ctx := context.Background()
-	prompt, _, err := client.Prompts.Toggle(ctx, 123, true)
+	prompt, _, err := client.Prompts.Toggle(ctx, "123", true)
 
 	if err != nil {
 		t.Errorf("Prompts.Toggle returned error: %v", err)
@@ -431,11 +431,11 @@ func TestPromptsService_Toggle_Deactivate(t *testing.T) {
 		}
 
 		w.Header().Set("Content-Type", "application/json")
-		fmt.Fprint(w, `{"status":"success","message":"Prompt deactivated","prompt":{"id":123,"name":"test-prompt","template":"Hello {{name}}","arguments":[],"isActive":false,"metrics":{"totalExecutions":0,"successfulExecutions":0,"failedExecutions":0,"failureRate":0}}}`)
+		fmt.Fprint(w, `{"status":"success","message":"Prompt deactivated","prompt":{"id":"123","name":"test-prompt","template":"Hello {{name}}","arguments":[],"isActive":false,"metrics":{"totalExecutions":0,"successfulExecutions":0,"failedExecutions":0,"failureRate":0}}}`)
 	})
 
 	ctx := context.Background()
-	prompt, _, err := client.Prompts.Toggle(ctx, 123, false)
+	prompt, _, err := client.Prompts.Toggle(ctx, "123", false)
 
 	if err != nil {
 		t.Errorf("Prompts.Toggle returned error: %v", err)

contextforge/prompts_test.go

@@ -135,7 +135,7 @@ type toggleResourceResponse struct {
 	MimeType          *string     `json:"mime_type,omitempty"`
 	Size              *int        `json:"size,omitempty"`
 	IsActive          bool        `json:"is_active"`
-	Tags              []string    `json:"tags,omitempty"`
+	Tags              []Tag       `json:"tags,omitempty"`
 	TeamID            *string     `json:"team_id,omitempty"`
 	Team              *string     `json:"team,omitempty"`
 	OwnerEmail        *string     `json:"owner_email,omitempty"`

contextforge/resources.go

@@ -123,7 +123,7 @@ func TestServersService_Create(t *testing.T) {
 		}
 
 		w.Header().Set("Content-Type", "application/json")
-		fmt.Fprint(w, `{"id":"456","name":"new-server","description":"A new server","isActive":true,"tags":["test"],"metrics":{"totalExecutions":0,"successfulExecutions":0,"failedExecutions":0,"failureRate":0}}`)
+		fmt.Fprint(w, `{"id":"456","name":"new-server","description":"A new server","isActive":true,"tags":[{"id":"test","label":"test"}],"metrics":{"totalExecutions":0,"successfulExecutions":0,"failedExecutions":0,"failureRate":0}}`)
 	})
 
 	ctx := context.Background()
@@ -411,7 +411,7 @@ func TestServersService_ListPrompts(t *testing.T) {
 	mux.HandleFunc("/servers/123/prompts", func(w http.ResponseWriter, r *http.Request) {
 		testMethod(t, r, "GET")
 		w.Header().Set("Content-Type", "application/json")
-		fmt.Fprint(w, `[{"id":1,"name":"test-prompt","template":"Hello {{name}}","arguments":[],"isActive":true,"tags":[],"metrics":{"totalExecutions":0,"successfulExecutions":0,"failedExecutions":0,"failureRate":0}}]`)
+		fmt.Fprint(w, `[{"id":"1","name":"test-prompt","template":"Hello {{name}}","arguments":[],"isActive":true,"tags":[],"metrics":{"totalExecutions":0,"successfulExecutions":0,"failedExecutions":0,"failureRate":0}}]`)
 	})
 
 	ctx := context.Background()