feat(api): CMA Memory public beta

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 77
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/anthropic%2Fanthropic-887672e4d20da26b724d31b0da770624a3b296558994dde969b5784f48777e6f.yml
-openapi_spec_hash: 69278ebbb0d1aa0b322bbbd5128bcec5
-config_hash: 0f75c844d90999c12de1871c5dd37d2b
+configured_endpoints: 86
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/anthropic%2Fanthropic-78e8ea00cd66db850ab32db53b5e0037fb0b4a791b513393c03d9011406a6c78.yml
+openapi_spec_hash: 3f08b4e5296e181c7243aa92f4a3073e
+config_hash: 350c1adcf8bb17e1913ed80e189c5a52

api.md

@@ -25,9 +25,9 @@ type BetaService struct {
 	Environments BetaEnvironmentService
 	Sessions     BetaSessionService
 	Vaults       BetaVaultService
+	MemoryStores BetaMemoryStoreService
 	Files        BetaFileService
 	Skills       BetaSkillService
-	UserProfiles BetaUserProfileService
 }
 
 // NewBetaService generates a new service that applies the given options to each
@@ -42,9 +42,9 @@ func NewBetaService(opts ...option.RequestOption) (r BetaService) {
 	r.Environments = NewBetaEnvironmentService(opts...)
 	r.Sessions = NewBetaSessionService(opts...)
 	r.Vaults = NewBetaVaultService(opts...)
+	r.MemoryStores = NewBetaMemoryStoreService(opts...)
 	r.Files = NewBetaFileService(opts...)
 	r.Skills = NewBetaSkillService(opts...)
-	r.UserProfiles = NewBetaUserProfileService(opts...)
 	return
 }
 
@@ -73,7 +73,6 @@ const (
 	AnthropicBetaFastMode2026_02_01                   AnthropicBeta = "fast-mode-2026-02-01"
 	AnthropicBetaOutput300k2026_03_24                 AnthropicBeta = "output-300k-2026-03-24"
 	AnthropicBetaAdvisorTool2026_03_01                AnthropicBeta = "advisor-tool-2026-03-01"
-	AnthropicBetaUserProfiles2026_03_24               AnthropicBeta = "user-profiles-2026-03-24"
 )
 
 type BetaAPIError struct {

beta.go

@@ -0,0 +1,291 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+package anthropic
+
+import (
+	"context"
+	"errors"
+	"fmt"
+	"net/http"
+	"net/url"
+	"slices"
+	"time"
+
+	"github.com/anthropics/anthropic-sdk-go/internal/apijson"
+	"github.com/anthropics/anthropic-sdk-go/internal/apiquery"
+	"github.com/anthropics/anthropic-sdk-go/internal/requestconfig"
+	"github.com/anthropics/anthropic-sdk-go/option"
+	"github.com/anthropics/anthropic-sdk-go/packages/pagination"
+	"github.com/anthropics/anthropic-sdk-go/packages/param"
+	"github.com/anthropics/anthropic-sdk-go/packages/respjson"
+)
+
+// BetaMemoryStoreService contains methods and other services that help with
+// interacting with the anthropic API.
+//
+// Note, unlike clients, this service does not read variables from the environment
+// automatically. You should not instantiate this service directly, and instead use
+// the [NewBetaMemoryStoreService] method instead.
+type BetaMemoryStoreService struct {
+	Options        []option.RequestOption
+	Memories       BetaMemoryStoreMemoryService
+	MemoryVersions BetaMemoryStoreMemoryVersionService
+}
+
+// NewBetaMemoryStoreService generates a new service that applies the given options
+// to each request. These options are applied after the parent client's options (if
+// there is one), and before any request-specific options.
+func NewBetaMemoryStoreService(opts ...option.RequestOption) (r BetaMemoryStoreService) {
+	r = BetaMemoryStoreService{}
+	r.Options = opts
+	r.Memories = NewBetaMemoryStoreMemoryService(opts...)
+	r.MemoryVersions = NewBetaMemoryStoreMemoryVersionService(opts...)
+	return
+}
+
+// CreateMemoryStore
+func (r *BetaMemoryStoreService) New(ctx context.Context, params BetaMemoryStoreNewParams, opts ...option.RequestOption) (res *BetaManagedAgentsMemoryStore, err error) {
+	for _, v := range params.Betas {
+		opts = append(opts, option.WithHeaderAdd("anthropic-beta", fmt.Sprintf("%v", v)))
+	}
+	opts = slices.Concat(r.Options, opts)
+	opts = append([]option.RequestOption{option.WithHeader("anthropic-beta", "managed-agents-2026-04-01")}, opts...)
+	path := "v1/memory_stores?beta=true"
+	err = requestconfig.ExecuteNewRequest(ctx, http.MethodPost, path, params, &res, opts...)
+	return res, err
+}
+
+// GetMemoryStore
+func (r *BetaMemoryStoreService) Get(ctx context.Context, memoryStoreID string, query BetaMemoryStoreGetParams, opts ...option.RequestOption) (res *BetaManagedAgentsMemoryStore, err error) {
+	for _, v := range query.Betas {
+		opts = append(opts, option.WithHeaderAdd("anthropic-beta", fmt.Sprintf("%v", v)))
+	}
+	opts = slices.Concat(r.Options, opts)
+	opts = append([]option.RequestOption{option.WithHeader("anthropic-beta", "managed-agents-2026-04-01")}, opts...)
+	if memoryStoreID == "" {
+		err = errors.New("missing required memory_store_id parameter")
+		return nil, err
+	}
+	path := fmt.Sprintf("v1/memory_stores/%s?beta=true", memoryStoreID)
+	err = requestconfig.ExecuteNewRequest(ctx, http.MethodGet, path, nil, &res, opts...)
+	return res, err
+}
+
+// UpdateMemoryStore
+func (r *BetaMemoryStoreService) Update(ctx context.Context, memoryStoreID string, params BetaMemoryStoreUpdateParams, opts ...option.RequestOption) (res *BetaManagedAgentsMemoryStore, err error) {
+	for _, v := range params.Betas {
+		opts = append(opts, option.WithHeaderAdd("anthropic-beta", fmt.Sprintf("%v", v)))
+	}
+	opts = slices.Concat(r.Options, opts)
+	opts = append([]option.RequestOption{option.WithHeader("anthropic-beta", "managed-agents-2026-04-01")}, opts...)
+	if memoryStoreID == "" {
+		err = errors.New("missing required memory_store_id parameter")
+		return nil, err
+	}
+	path := fmt.Sprintf("v1/memory_stores/%s?beta=true", memoryStoreID)
+	err = requestconfig.ExecuteNewRequest(ctx, http.MethodPost, path, params, &res, opts...)
+	return res, err
+}
+
+// ListMemoryStores
+func (r *BetaMemoryStoreService) List(ctx context.Context, params BetaMemoryStoreListParams, opts ...option.RequestOption) (res *pagination.PageCursor[BetaManagedAgentsMemoryStore], err error) {
+	var raw *http.Response
+	for _, v := range params.Betas {
+		opts = append(opts, option.WithHeaderAdd("anthropic-beta", fmt.Sprintf("%v", v)))
+	}
+	opts = slices.Concat(r.Options, opts)
+	opts = append([]option.RequestOption{option.WithHeader("anthropic-beta", "managed-agents-2026-04-01"), option.WithResponseInto(&raw)}, opts...)
+	path := "v1/memory_stores?beta=true"
+	cfg, err := requestconfig.NewRequestConfig(ctx, http.MethodGet, path, params, &res, opts...)
+	if err != nil {
+		return nil, err
+	}
+	err = cfg.Execute()
+	if err != nil {
+		return nil, err
+	}
+	res.SetPageConfig(cfg, raw)
+	return res, nil
+}
+
+// ListMemoryStores
+func (r *BetaMemoryStoreService) ListAutoPaging(ctx context.Context, params BetaMemoryStoreListParams, opts ...option.RequestOption) *pagination.PageCursorAutoPager[BetaManagedAgentsMemoryStore] {
+	return pagination.NewPageCursorAutoPager(r.List(ctx, params, opts...))
+}
+
+// DeleteMemoryStore
+func (r *BetaMemoryStoreService) Delete(ctx context.Context, memoryStoreID string, body BetaMemoryStoreDeleteParams, opts ...option.RequestOption) (res *BetaManagedAgentsDeletedMemoryStore, err error) {
+	for _, v := range body.Betas {
+		opts = append(opts, option.WithHeaderAdd("anthropic-beta", fmt.Sprintf("%v", v)))
+	}
+	opts = slices.Concat(r.Options, opts)
+	opts = append([]option.RequestOption{option.WithHeader("anthropic-beta", "managed-agents-2026-04-01")}, opts...)
+	if memoryStoreID == "" {
+		err = errors.New("missing required memory_store_id parameter")
+		return nil, err
+	}
+	path := fmt.Sprintf("v1/memory_stores/%s?beta=true", memoryStoreID)
+	err = requestconfig.ExecuteNewRequest(ctx, http.MethodDelete, path, nil, &res, opts...)
+	return res, err
+}
+
+// ArchiveMemoryStore
+func (r *BetaMemoryStoreService) Archive(ctx context.Context, memoryStoreID string, body BetaMemoryStoreArchiveParams, opts ...option.RequestOption) (res *BetaManagedAgentsMemoryStore, err error) {
+	for _, v := range body.Betas {
+		opts = append(opts, option.WithHeaderAdd("anthropic-beta", fmt.Sprintf("%v", v)))
+	}
+	opts = slices.Concat(r.Options, opts)
+	opts = append([]option.RequestOption{option.WithHeader("anthropic-beta", "managed-agents-2026-04-01")}, opts...)
+	if memoryStoreID == "" {
+		err = errors.New("missing required memory_store_id parameter")
+		return nil, err
+	}
+	path := fmt.Sprintf("v1/memory_stores/%s/archive?beta=true", memoryStoreID)
+	err = requestconfig.ExecuteNewRequest(ctx, http.MethodPost, path, nil, &res, opts...)
+	return res, err
+}
+
+type BetaManagedAgentsDeletedMemoryStore struct {
+	ID string `json:"id" api:"required"`
+	// Any of "memory_store_deleted".
+	Type BetaManagedAgentsDeletedMemoryStoreType `json:"type" api:"required"`
+	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
+	JSON struct {
+		ID          respjson.Field
+		Type        respjson.Field
+		ExtraFields map[string]respjson.Field
+		raw         string
+	} `json:"-"`
+}
+
+// Returns the unmodified JSON received from the API
+func (r BetaManagedAgentsDeletedMemoryStore) RawJSON() string { return r.JSON.raw }
+func (r *BetaManagedAgentsDeletedMemoryStore) UnmarshalJSON(data []byte) error {
+	return apijson.UnmarshalRoot(data, r)
+}
+
+type BetaManagedAgentsDeletedMemoryStoreType string
+
+const (
+	BetaManagedAgentsDeletedMemoryStoreTypeMemoryStoreDeleted BetaManagedAgentsDeletedMemoryStoreType = "memory_store_deleted"
+)
+
+type BetaManagedAgentsMemoryStore struct {
+	ID string `json:"id" api:"required"`
+	// A timestamp in RFC 3339 format
+	CreatedAt time.Time `json:"created_at" api:"required" format:"date-time"`
+	Name      string    `json:"name" api:"required"`
+	// Any of "memory_store".
+	Type BetaManagedAgentsMemoryStoreType `json:"type" api:"required"`
+	// A timestamp in RFC 3339 format
+	UpdatedAt time.Time `json:"updated_at" api:"required" format:"date-time"`
+	// A timestamp in RFC 3339 format
+	ArchivedAt  time.Time         `json:"archived_at" api:"nullable" format:"date-time"`
+	Description string            `json:"description"`
+	Metadata    map[string]string `json:"metadata"`
+	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
+	JSON struct {
+		ID          respjson.Field
+		CreatedAt   respjson.Field
+		Name        respjson.Field
+		Type        respjson.Field
+		UpdatedAt   respjson.Field
+		ArchivedAt  respjson.Field
+		Description respjson.Field
+		Metadata    respjson.Field
+		ExtraFields map[string]respjson.Field
+		raw         string
+	} `json:"-"`
+}
+
+// Returns the unmodified JSON received from the API
+func (r BetaManagedAgentsMemoryStore) RawJSON() string { return r.JSON.raw }
+func (r *BetaManagedAgentsMemoryStore) UnmarshalJSON(data []byte) error {
+	return apijson.UnmarshalRoot(data, r)
+}
+
+type BetaManagedAgentsMemoryStoreType string
+
+const (
+	BetaManagedAgentsMemoryStoreTypeMemoryStore BetaManagedAgentsMemoryStoreType = "memory_store"
+)
+
+type BetaMemoryStoreNewParams struct {
+	Name        string            `json:"name" api:"required"`
+	Description param.Opt[string] `json:"description,omitzero"`
+	Metadata    map[string]string `json:"metadata,omitzero"`
+	// Optional header to specify the beta version(s) you want to use.
+	Betas []AnthropicBeta `header:"anthropic-beta,omitzero" json:"-"`
+	paramObj
+}
+
+func (r BetaMemoryStoreNewParams) MarshalJSON() (data []byte, err error) {
+	type shadow BetaMemoryStoreNewParams
+	return param.MarshalObject(r, (*shadow)(&r))
+}
+func (r *BetaMemoryStoreNewParams) UnmarshalJSON(data []byte) error {
+	return apijson.UnmarshalRoot(data, r)
+}
+
+type BetaMemoryStoreGetParams struct {
+	// Optional header to specify the beta version(s) you want to use.
+	Betas []AnthropicBeta `header:"anthropic-beta,omitzero" json:"-"`
+	paramObj
+}
+
+type BetaMemoryStoreUpdateParams struct {
+	Description param.Opt[string] `json:"description,omitzero"`
+	Name        param.Opt[string] `json:"name,omitzero"`
+	// Metadata patch. Set a key to a string to upsert it, or to null to delete it.
+	// Omit the field to preserve. The stored bag is limited to 16 keys (up to 64 chars
+	// each) with values up to 512 chars.
+	Metadata map[string]string `json:"metadata,omitzero"`
+	// Optional header to specify the beta version(s) you want to use.
+	Betas []AnthropicBeta `header:"anthropic-beta,omitzero" json:"-"`
+	paramObj
+}
+
+func (r BetaMemoryStoreUpdateParams) MarshalJSON() (data []byte, err error) {
+	type shadow BetaMemoryStoreUpdateParams
+	return param.MarshalObject(r, (*shadow)(&r))
+}
+func (r *BetaMemoryStoreUpdateParams) UnmarshalJSON(data []byte) error {
+	return apijson.UnmarshalRoot(data, r)
+}
+
+type BetaMemoryStoreListParams struct {
+	// Return stores created at or after this time (inclusive).
+	CreatedAtGte param.Opt[time.Time] `query:"created_at[gte],omitzero" format:"date-time" json:"-"`
+	// Return stores created at or before this time (inclusive).
+	CreatedAtLte param.Opt[time.Time] `query:"created_at[lte],omitzero" format:"date-time" json:"-"`
+	// Query parameter for include_archived
+	IncludeArchived param.Opt[bool] `query:"include_archived,omitzero" json:"-"`
+	// Query parameter for limit
+	Limit param.Opt[int64] `query:"limit,omitzero" json:"-"`
+	// Query parameter for page
+	Page param.Opt[string] `query:"page,omitzero" json:"-"`
+	// Optional header to specify the beta version(s) you want to use.
+	Betas []AnthropicBeta `header:"anthropic-beta,omitzero" json:"-"`
+	paramObj
+}
+
+// URLQuery serializes [BetaMemoryStoreListParams]'s query parameters as
+// `url.Values`.
+func (r BetaMemoryStoreListParams) URLQuery() (v url.Values, err error) {
+	return apiquery.MarshalWithSettings(r, apiquery.QuerySettings{
+		ArrayFormat:  apiquery.ArrayQueryFormatComma,
+		NestedFormat: apiquery.NestedQueryFormatBrackets,
+	})
+}
+
+type BetaMemoryStoreDeleteParams struct {
+	// Optional header to specify the beta version(s) you want to use.
+	Betas []AnthropicBeta `header:"anthropic-beta,omitzero" json:"-"`
+	paramObj
+}
+
+type BetaMemoryStoreArchiveParams struct {
+	// Optional header to specify the beta version(s) you want to use.
+	Betas []AnthropicBeta `header:"anthropic-beta,omitzero" json:"-"`
+	paramObj
+}