# Bulk Workspace Resources ## Apply a workspace resource bundle `client.BulkWorkspaceResources.Apply(ctx, workspaceID, body) (*BulkWorkspaceApply, error)` **post** `/v1/workspaces/{workspaceId}/bulk_workspace_applies` Asynchronously applies a declarative bundle of workspace resources. Returns the operation immediately in PENDING; clients poll Get to track progress. ### Parameters - `workspaceID string` - `body BulkWorkspaceResourceApplyParams` - `Data param.Field[BulkWorkspaceApplyData]` ### Returns - `type BulkWorkspaceApply struct{…}` The operation resource produced by a call to BulkWorkspaceResources.Apply. It carries the input bundle in `data`, the lifecycle state in `status`, and aggregate counts in `info`. - `Data BulkWorkspaceApplyData` - `BundleKey string` Required. Bundle ownership key. Resources created or updated by an Apply have their `metadata.bundle_key` set to this value. On subsequent applies with the same bundle_key, resources currently bearing this bundle_key but absent from the spec are soft-deleted. - `Agents map[string, AgentEntry]` Agents to upsert, keyed by external_id. - `Name string` - `Spec AgentSpec` Agent specification (user-provided configuration) - `Status AgentSpecStatus` Status of the agent - `const AgentSpecStatusAgentStatusUnspecified AgentSpecStatus = "AGENT_STATUS_UNSPECIFIED"` - `const AgentSpecStatusAgentStatusDraft AgentSpecStatus = "AGENT_STATUS_DRAFT"` - `const AgentSpecStatusAgentStatusPublished AgentSpecStatus = "AGENT_STATUS_PUBLISHED"` - `const AgentSpecStatusAgentStatusArchived AgentSpecStatus = "AGENT_STATUS_ARCHIVED"` - `VariationSelectionMode AgentSpecVariationSelectionMode` Controls how variations are automatically selected when creating objectives Defaults to RANDOM when unspecified - `const AgentSpecVariationSelectionModeVariationSelectionModeUnspecified AgentSpecVariationSelectionMode = "VARIATION_SELECTION_MODE_UNSPECIFIED"` - `const AgentSpecVariationSelectionModeVariationSelectionModeRandom AgentSpecVariationSelectionMode = "VARIATION_SELECTION_MODE_RANDOM"` - `const AgentSpecVariationSelectionModeVariationSelectionModeWeighted AgentSpecVariationSelectionMode = "VARIATION_SELECTION_MODE_WEIGHTED"` - `Description string` Description of the agent's purpose - `InputDataSchema map[string, unknown]` InputDataSchema is used for enforcing a data input when objectives are created. This is valuable when using liquid formatting in agent variation prompts. Input data schema is also valuable when using an agent as a sub-agent, as the schema is used as the tool's input parameter schema. If omitted, the sub-agent schema will be loaded with a simple "prompt" free text string as its schema. - `OutputDefinition map[string, unknown]` Optional output definition for objectives created for this agent. When provided, Cadenya will append a tool to that will be called by the LLM in use by the variant to extract information in the format provided here. Use this option when you want structured data to be created by your objectives. - `WebhookEventsURL string` The URL that Cadenya will send events for any objective assigned to the agent. - `Labels map[string, string]` - `Schedules map[string, AgentScheduleEntry]` Schedules under this agent, keyed by external_id. - `Name string` - `Spec AgentScheduleSpec` AgentScheduleSpec is the user-provided configuration for a schedule. - `InitialMessage string` The initial message passed to CreateObjective on each fire. Becomes the first user message in the objective's chat history. - `Schedule AgentScheduleSpecSchedule` Schedule defines WHEN the schedule fires. Temporal-style structured form: a list of calendar rules (wall-clock) and/or interval rules (duration), OR'd together. At least one rule is required. - `Calendars []ScheduleCalendar` Wall-clock rules. May be empty if `intervals` is non-empty. - `Comment string` - `DayOfMonth []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `DayOfWeek []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Hour []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Minute []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Month []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Second []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Intervals []ScheduleInterval` Duration-based rules. May be empty if `calendars` is non-empty. - `Every string` - `Offset string` Phase shift within `every`. Must be < `every` (enforced at runtime). - `Timezone string` IANA tz name (e.g. "America/New_York"). Required. Applies to calendars; intervals fire on wall-clock cadence anchored in this zone. - `Data unknown` Optional input data passed to the objective. If the agent has an input_data_schema, this must satisfy it. - `OverlapPolicy AgentScheduleSpecOverlapPolicy` What to do when the previous run is still in flight. Defaults to SKIP. - `const AgentScheduleSpecOverlapPolicyOverlapPolicyUnspecified AgentScheduleSpecOverlapPolicy = "OVERLAP_POLICY_UNSPECIFIED"` - `const AgentScheduleSpecOverlapPolicyOverlapPolicyAllow AgentScheduleSpecOverlapPolicy = "OVERLAP_POLICY_ALLOW"` - `const AgentScheduleSpecOverlapPolicyOverlapPolicySkip AgentScheduleSpecOverlapPolicy = "OVERLAP_POLICY_SKIP"` - `Status AgentScheduleSpecStatus` Lifecycle. Defaults to ACTIVE on create when unspecified. - `const AgentScheduleSpecStatusAgentScheduleStatusUnspecified AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_UNSPECIFIED"` - `const AgentScheduleSpecStatusAgentScheduleStatusActive AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_ACTIVE"` - `const AgentScheduleSpecStatusAgentScheduleStatusPaused AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_PAUSED"` - `const AgentScheduleSpecStatusAgentScheduleStatusArchived AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_ARCHIVED"` - `VariationID string` Optional explicit variation. When unset, the agent's variation_selection_mode chooses per fire. - `Labels map[string, string]` - `Variations map[string, AgentVariationEntry]` Variations under this agent, keyed by external_id. - `Name string` - `Spec AgentVariationSpec` AgentVariationSpec defines the operational configuration for a variation - `CompactionConfig AgentVariationSpecCompactionConfig` CompactionConfig defines how context window compaction behaves for objectives using this variation. - `Summarization CompactionConfigSummarizationStrategy` SummarizationStrategy configures LLM-powered summarization of older conversation turns. - `Instructions string` Custom instructions that guide what the summarizer preserves. Replaces the default summarization prompt entirely. Example: "Preserve all code snippets, variable names, and technical decisions." - `ToolResultClearing CompactionConfigToolResultClearingStrategy` ToolResultClearingStrategy configures clearing of older tool result content. - `PreserveRecentResults int64` Number of most recent tool call results to keep intact. Older tool results have their content replaced with "[result cleared]" while preserving the assistant tool call message (function name, arguments). Default: 2 - `TriggerThreshold float64` Trigger threshold as a percentage of the model's context window (0.0 to 1.0). When input tokens reach this percentage of the model's limit, compaction triggers. Default: 0.75 (75%) - `Constraints AgentVariationSpecConstraints` Execution constraints - `MaxSubObjectives int64` The maximum number of sub-objectives that can be created. 0 means no limit. - `MaxToolCalls int64` The maximum number of tool calls that can be made. 0 means no limit. - `Description string` Human-readable description of what this variation does or when it should be used - `EnableEpisodicMemory bool` Enable episodic memory for objectives using this variation. When true, the system automatically creates a document namespace for each objective using the objective's episodic_key as the external_id, allowing the agent to store and retrieve documents specific to that episode. - `EpisodicMemoryTtl int64` How long episodic memories should be retained. After this duration, episodic document namespaces can be automatically cleaned up. If not set, episodic memories are retained indefinitely. - `ModelConfig AgentVariationSpecModelConfig` ModelConfig defines the model configuration for a variation - `ModelID string` The model identifier in family/model format (e.g., "claude/opus-4.6", "claude/sonnet-4.5") - `Temperature float64` Sampling temperature for model inference (0.0 to 1.0) Lower values produce more deterministic outputs, higher values increase randomness - `ProgressiveDiscovery AgentVariationSpecProgressiveDiscovery` ProgressiveDiscovery is used to indicate that the agent should automatically discover tools that are not explicitly assigned to it. Max tools is the maximum number of tools that can be discovered per search. Hints are optional hints for tool search. These are used in conjunction with the context-aware tool search and can help select the best tools for the task. - `Hints []string` - `MaxTools int64` - `RerankThreshold float64` Rerank Threshold is an optional value that instructs whether or not to run a search result through a embedding/reranker process which can improve performance and reduce context bloat when tools reach the configured threshold. If a tool match must exceed 0.8, for example, the tool very closely match the query the tool search performed. - `Prompt string` The system prompt for this variation - `Weight int64` Weight for weighted random selection (>= 0). P(v) = v.weight / sum(all_weights). Only used when the agent's variation_selection_mode is WEIGHTED. A weight of 0 means never auto-selected, but can still be chosen explicitly via variation_id on CreateObjectiveRequest. - `Assignments []VariationAssignmentEntry` Reconciled list — server adjusts the variation's assignments to exactly this set when the variation is bundle-owned. - `SubAgentID string` - `ToolID string` - `ToolSetID string` - `Labels map[string, string]` - `MemoryLayers []VariationMemoryLayerEntry` Reconciled list of memory layer assignments. Up to 10 entries. - `MemoryLayerID string` external_id: form. Canonical IDs are rejected. - `Position int64` - `AutomaticallyPublishAgents bool` When true, every agent created or updated by this Apply has its status forced to AGENT_STATUS_PUBLISHED, regardless of the status declared in the agent's AgentSpec. Useful when the bundle represents a production configuration and you want all of its agents live without setting status: AGENT_STATUS_PUBLISHED on each entry. Default false: each agent's AgentSpec.status controls (which is AGENT_STATUS_DRAFT on create when unspecified). - `MemoryLayers map[string, MemoryLayerEntry]` Memory layers to upsert, keyed by external_id. - `Name string` - `Spec MemoryLayerSpec` - `Type MemoryLayerSpecType` - `const MemoryLayerSpecTypeMemoryLayerTypeUnspecified MemoryLayerSpecType = "MEMORY_LAYER_TYPE_UNSPECIFIED"` - `const MemoryLayerSpecTypeMemoryLayerTypeEpisodic MemoryLayerSpecType = "MEMORY_LAYER_TYPE_EPISODIC"` - `const MemoryLayerSpecTypeMemoryLayerTypeSkills MemoryLayerSpecType = "MEMORY_LAYER_TYPE_SKILLS"` - `Description string` Human-readable description of the layer's purpose. Encouraged for user-created layers; system-managed layers may have a generated description. - `ExpiresAt Time` For layers with a finite lifetime (e.g., episodic), the time at which the layer becomes eligible for cleanup. Set by the system; unset for persistent layers. - `SystemManaged bool` Server-set. True for layers managed by the system (e.g., episodic layers created automatically when an objective uses an episodic_key). System-managed layers cannot be assigned to objective stacks via the API and cannot be mutated by clients — their lifecycle is controlled entirely by the runtime. - `Entries map[string, MemoryEntryItem]` Memory entries in this layer, keyed by external_id. - `Key string` - `Content string` - `Description string` - `UploadID string` - `Labels map[string, string]` - `SourceURL string` Optional URL pointing to the source of this apply (GitHub PR, Jenkins build, GitLab pipeline, etc.). Surfaced in the dashboard so users can jump from an apply back to the change that produced it. Free-form HTTPS URI; not interpreted by the server. - `ToolSets map[string, ToolSetEntry]` Tool sets to upsert, keyed by external_id. - `Name string` - `Spec ToolSetSpec` - `Adapter ToolSetAdapter` - `HTTP ToolSetAdapterHTTP` - `BaseURL string` - `Headers map[string, string]` - `Mcp ToolSetAdapterMcp` - `ExcludeTools ToolFilter` Top-level filter with simple boolean logic (no nesting) - `Operator ToolFilterOperator` - `const ToolFilterOperatorOperatorUnspecified ToolFilterOperator = "OPERATOR_UNSPECIFIED"` - `const ToolFilterOperatorOperatorAnd ToolFilterOperator = "OPERATOR_AND"` - `const ToolFilterOperatorOperatorOr ToolFilterOperator = "OPERATOR_OR"` - `Filters []AttributeFilter` - `Attribute AttributeFilterAttribute` - `const AttributeFilterAttributeAttributeUnspecified AttributeFilterAttribute = "ATTRIBUTE_UNSPECIFIED"` - `const AttributeFilterAttributeAttributeName AttributeFilterAttribute = "ATTRIBUTE_NAME"` - `const AttributeFilterAttributeAttributeTitle AttributeFilterAttribute = "ATTRIBUTE_TITLE"` - `const AttributeFilterAttributeAttributeDescription AttributeFilterAttribute = "ATTRIBUTE_DESCRIPTION"` - `Matcher StringMatcher` String matching operations - `CaseSensitive bool` - `Contains string` - `EndsWith string` - `Exact string` - `Regex string` - `StartsWith string` - `Headers map[string, string]` - `IncludeTools ToolFilter` Top-level filter with simple boolean logic (no nesting) - `ToolApprovals ApprovalRequirementFilter` Approval filters that will automatically set the approval requirement on tools synced from an external source - `Always bool` - `Only ToolFilter` Top-level filter with simple boolean logic (no nesting) - `URL string` - `OpenAPI ToolSetAdapterOpenAPI` - `BaseURL string` Base URL for dispatching tool calls. If set, overrides the server resolved from the spec's servers array. - `ExcludeTools ToolFilter` Top-level filter with simple boolean logic (no nesting) - `Headers map[string, string]` Headers sent when fetching the spec from a URL and when dispatching tool calls. - `IncludeTools ToolFilter` Top-level filter with simple boolean logic (no nesting) - `ServerName string` Name of the server entry in the spec's servers array (OpenAPI 3.2 server.name field). Used to select which server URL to dispatch to when base_url is not set. If unset, the first server is used. Ignored when base_url is set. - `ToolApprovals ApprovalRequirementFilter` Approval filters that will automatically set the approval requirement on tools synced from an external source - `UploadID string` ID of a COMPLETE Upload containing the OpenAPI spec document. - `URL string` URL to fetch the OpenAPI spec from. Synced automatically every hour. - `Description string` - `Labels map[string, string]` - `Tools map[string, ToolEntry]` Tools in this tool set, keyed by external_id. - `Name string` - `Spec ToolSpec` - `Config ToolSpecConfig` Config defines the adapter to use for the tool. This is used to determine how the tool is called. For example, if the tool is an HTTP tool, the adapter will be Http. If the tool is an inline tool, the adapter will be Inline. - `HTTP ConfigHTTP` - `RequestMethod ConfigHTTPRequestMethod` - `const ConfigHTTPRequestMethodHTTPMethodUnspecified ConfigHTTPRequestMethod = "HTTP_METHOD_UNSPECIFIED"` - `const ConfigHTTPRequestMethodGet ConfigHTTPRequestMethod = "GET"` - `const ConfigHTTPRequestMethodPost ConfigHTTPRequestMethod = "POST"` - `const ConfigHTTPRequestMethodPut ConfigHTTPRequestMethod = "PUT"` - `const ConfigHTTPRequestMethodPatch ConfigHTTPRequestMethod = "PATCH"` - `const ConfigHTTPRequestMethodDelete ConfigHTTPRequestMethod = "DELETE"` - `Headers map[string, string]` - `Path string` - `Query string` - `RequestBodyContentType string` - `RequestBodyTemplate string` These are only used when the request method is a POST, PUT, or PATCH - `ToolName string` The tool name (commonly an "operation id" in OpenAPI specs) to call on the HTTP adapter. This is used to match the tool spec to the correct endpoint on the HTTP adapter. it will be derived from the name of the tool if not provided. - `Mcp ConfigMcp` - `ToolDescription string` - `ToolName string` - `ToolTitle string` - `OpenAPI ConfigOpenAPI` - `Method string` - `OperationID string` - `Path string` - `Description string` - `Parameters map[string, unknown]` - `Status ToolSpecStatus` - `const ToolSpecStatusToolStatusUnspecified ToolSpecStatus = "TOOL_STATUS_UNSPECIFIED"` - `const ToolSpecStatusToolStatusAvailable ToolSpecStatus = "TOOL_STATUS_AVAILABLE"` - `const ToolSpecStatusToolStatusOmitted ToolSpecStatus = "TOOL_STATUS_OMITTED"` - `const ToolSpecStatusToolStatusArchived ToolSpecStatus = "TOOL_STATUS_ARCHIVED"` - `RequiresApproval bool` - `Labels map[string, string]` - `Metadata OperationMetadata` Metadata for ephemeral operations and activities (e.g., objectives, executions, runs) - `ID string` Unique identifier for the operation (prefixed ULID, e.g., "obj_01HXK...") - `AccountID string` Account this operation belongs to for multi-tenant isolation (prefixed ULID) - `CreatedAt Time` Timestamp when this operation was created ULID includes timestamp information, but this explicit field enables easier querying - `ProfileID string` ID of the actor (user or service account) that created this operation - `WorkspaceID string` Workspace this operation belongs to for organizational grouping (prefixed ULID) - `ExternalID string` External ID for the operation (e.g., a workflow ID from an external system) - `Labels map[string, string]` Arbitrary key-value pairs for categorization and filtering Examples: {"priority": "high", "source": "api", "workflow": "onboarding"} - `Status BulkWorkspaceApplyStatus` - `State BulkWorkspaceApplyStatusState` - `const BulkWorkspaceApplyStatusStateStateUnspecified BulkWorkspaceApplyStatusState = "STATE_UNSPECIFIED"` - `const BulkWorkspaceApplyStatusStateStatePending BulkWorkspaceApplyStatusState = "STATE_PENDING"` - `const BulkWorkspaceApplyStatusStateStateValidating BulkWorkspaceApplyStatusState = "STATE_VALIDATING"` - `const BulkWorkspaceApplyStatusStateStateRunning BulkWorkspaceApplyStatusState = "STATE_RUNNING"` - `const BulkWorkspaceApplyStatusStateStateSucceeded BulkWorkspaceApplyStatusState = "STATE_SUCCEEDED"` - `const BulkWorkspaceApplyStatusStateStatePartiallyApplied BulkWorkspaceApplyStatusState = "STATE_PARTIALLY_APPLIED"` - `const BulkWorkspaceApplyStatusStateStateFailed BulkWorkspaceApplyStatusState = "STATE_FAILED"` - `const BulkWorkspaceApplyStatusStateStateCancelled BulkWorkspaceApplyStatusState = "STATE_CANCELLED"` - `Message string` - `PreflightError BulkWorkspaceApplyStatusPreflightError` The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). - `Code int64` The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. - `Details []BulkWorkspaceApplyStatusPreflightErrorDetail` A list of messages that carry the error details. There is a common set of message types for APIs to use. - `Type string` The type of the serialized message. - `Message string` A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. - `Info BulkWorkspaceApplyInfo` - `CompletedAt Time` - `CreatedBy Profile` A profile identifies a user or non-human principal (such as an API key) at the account level. Profiles are account-scoped and can be granted access to multiple workspaces. - `Metadata AccountResourceMetadata` AccountResourceMetadata is used to represent a resource that is associated to an account but not to a workspace. - `ID string` Unique identifier for the resource (prefixed ULID, e.g., "apikey_01HXK...") - `AccountID string` Account this resource belongs to for multi-tenant isolation (prefixed ULID) - `Name string` Human-readable name for the resource (e.g., "Customer Support Agent", "Email Tool") Required for resources that users interact with directly - `ProfileID string` - `ExternalID string` External ID for the resource (e.g., a workflow ID from an external system) - `Labels map[string, string]` Arbitrary key-value pairs for categorization and filtering Examples: {"environment": "production", "team": "platform", "version": "v2"} - `Spec ProfileSpec` Configuration for a profile. - `Type ProfileSpecType` Whether this profile represents a human user, an API key, or a system principal. - `const ProfileSpecTypeProfileTypeUnspecified ProfileSpecType = "PROFILE_TYPE_UNSPECIFIED"` - `const ProfileSpecTypeProfileTypeUser ProfileSpecType = "PROFILE_TYPE_USER"` - `const ProfileSpecTypeProfileTypeAPIKey ProfileSpecType = "PROFILE_TYPE_API_KEY"` - `const ProfileSpecTypeProfileTypeSystem ProfileSpecType = "PROFILE_TYPE_SYSTEM"` - `Email string` Email address of the profile. Required and unique within an account for user profiles. - `Name string` Display name (e.g., "Bobby Tables"). - `CreatedCount int64` - `DeletedCount int64` - `FailedCount int64` - `StartedAt Time` - `TotalCount int64` - `UnchangedCount int64` - `UpdatedCount int64` ### Example ```go package main import ( "context" "fmt" "github.com/cadenya/cadenya-go" "github.com/cadenya/cadenya-go/option" ) func main() { client := cadenya.NewClient( option.WithAPIKey("My API Key"), ) bulkWorkspaceApply, err := client.BulkWorkspaceResources.Apply( context.TODO(), "workspaceId", cadenya.BulkWorkspaceResourceApplyParams{ Data: cadenya.F(cadenya.BulkWorkspaceApplyDataParam{ BundleKey: cadenya.F("bundleKey"), }), }, ) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", bulkWorkspaceApply.Data) } ``` #### Response ```json { "data": { "bundleKey": "bundleKey", "agents": { "foo": { "name": "name", "spec": { "status": "AGENT_STATUS_UNSPECIFIED", "variationSelectionMode": "VARIATION_SELECTION_MODE_UNSPECIFIED", "description": "description", "inputDataSchema": { "foo": "bar" }, "outputDefinition": { "foo": "bar" }, "webhookEventsUrl": "webhookEventsUrl" }, "labels": { "foo": "string" }, "schedules": { "foo": { "name": "name", "spec": { "initialMessage": "initialMessage", "schedule": { "calendars": [ { "comment": "comment", "dayOfMonth": [ { "end": 0, "start": 0, "step": 0 } ], "dayOfWeek": [ { "end": 0, "start": 0, "step": 0 } ], "hour": [ { "end": 0, "start": 0, "step": 0 } ], "minute": [ { "end": 0, "start": 0, "step": 0 } ], "month": [ { "end": 0, "start": 0, "step": 0 } ], "second": [ { "end": 0, "start": 0, "step": 0 } ] } ], "intervals": [ { "every": "-160513s", "offset": "-160513s" } ], "timezone": "timezone" }, "data": {}, "overlapPolicy": "OVERLAP_POLICY_UNSPECIFIED", "status": "AGENT_SCHEDULE_STATUS_UNSPECIFIED", "variationId": "variationId" }, "labels": { "foo": "string" } } }, "variations": { "foo": { "name": "name", "spec": { "compactionConfig": { "summarization": { "instructions": "instructions" }, "toolResultClearing": { "preserveRecentResults": 0 }, "triggerThreshold": 0 }, "constraints": { "maxSubObjectives": 0, "maxToolCalls": 0 }, "description": "description", "enableEpisodicMemory": true, "episodicMemoryTtl": 0, "modelConfig": { "modelId": "modelId", "temperature": 0 }, "progressiveDiscovery": { "hints": [ "string" ], "maxTools": 0, "rerankThreshold": 0 }, "prompt": "prompt", "weight": 0 }, "assignments": [ { "subAgentId": "subAgentId", "toolId": "toolId", "toolSetId": "toolSetId" } ], "labels": { "foo": "string" }, "memoryLayers": [ { "memoryLayerId": "memoryLayerId", "position": 0 } ] } } } }, "automaticallyPublishAgents": true, "memoryLayers": { "foo": { "name": "name", "spec": { "type": "MEMORY_LAYER_TYPE_UNSPECIFIED", "description": "description", "expiresAt": "2019-12-27T18:11:19.117Z", "systemManaged": true }, "entries": { "foo": { "key": "key", "content": "content", "description": "description", "uploadId": "uploadId" } }, "labels": { "foo": "string" } } }, "sourceUrl": "sourceUrl", "toolSets": { "foo": { "name": "name", "spec": { "adapter": { "http": { "baseUrl": "baseUrl", "headers": { "foo": "string" } }, "mcp": { "excludeTools": { "operator": "OPERATOR_UNSPECIFIED", "filters": [ { "attribute": "ATTRIBUTE_UNSPECIFIED", "matcher": { "caseSensitive": true, "contains": "contains", "endsWith": "endsWith", "exact": "exact", "regex": "regex", "startsWith": "startsWith" } } ] }, "headers": { "foo": "string" }, "includeTools": { "operator": "OPERATOR_UNSPECIFIED", "filters": [ { "attribute": "ATTRIBUTE_UNSPECIFIED", "matcher": { "caseSensitive": true, "contains": "contains", "endsWith": "endsWith", "exact": "exact", "regex": "regex", "startsWith": "startsWith" } } ] }, "toolApprovals": { "always": true, "only": { "operator": "OPERATOR_UNSPECIFIED", "filters": [ { "attribute": "ATTRIBUTE_UNSPECIFIED", "matcher": { "caseSensitive": true, "contains": "contains", "endsWith": "endsWith", "exact": "exact", "regex": "regex", "startsWith": "startsWith" } } ] } }, "url": "url" }, "openapi": { "baseUrl": "baseUrl", "excludeTools": { "operator": "OPERATOR_UNSPECIFIED", "filters": [ { "attribute": "ATTRIBUTE_UNSPECIFIED", "matcher": { "caseSensitive": true, "contains": "contains", "endsWith": "endsWith", "exact": "exact", "regex": "regex", "startsWith": "startsWith" } } ] }, "headers": { "foo": "string" }, "includeTools": { "operator": "OPERATOR_UNSPECIFIED", "filters": [ { "attribute": "ATTRIBUTE_UNSPECIFIED", "matcher": { "caseSensitive": true, "contains": "contains", "endsWith": "endsWith", "exact": "exact", "regex": "regex", "startsWith": "startsWith" } } ] }, "serverName": "serverName", "toolApprovals": { "always": true, "only": { "operator": "OPERATOR_UNSPECIFIED", "filters": [ { "attribute": "ATTRIBUTE_UNSPECIFIED", "matcher": { "caseSensitive": true, "contains": "contains", "endsWith": "endsWith", "exact": "exact", "regex": "regex", "startsWith": "startsWith" } } ] } }, "uploadId": "uploadId", "url": "url" } }, "description": "description" }, "labels": { "foo": "string" }, "tools": { "foo": { "name": "name", "spec": { "config": { "http": { "requestMethod": "HTTP_METHOD_UNSPECIFIED", "headers": { "foo": "string" }, "path": "path", "query": "query", "requestBodyContentType": "requestBodyContentType", "requestBodyTemplate": "requestBodyTemplate", "toolName": "toolName" }, "mcp": { "toolDescription": "toolDescription", "toolName": "toolName", "toolTitle": "toolTitle" }, "openapi": { "method": "method", "operationId": "operationId", "path": "path" } }, "description": "description", "parameters": { "foo": "bar" }, "status": "TOOL_STATUS_UNSPECIFIED", "requiresApproval": true }, "labels": { "foo": "string" } } } } } }, "metadata": { "id": "id", "accountId": "accountId", "createdAt": "2019-12-27T18:11:19.117Z", "profileId": "profileId", "workspaceId": "workspaceId", "externalId": "externalId", "labels": { "foo": "string" } }, "status": { "state": "STATE_UNSPECIFIED", "message": "message", "preflightError": { "code": 0, "details": [ { "@type": "@type" } ], "message": "message" } }, "info": { "completedAt": "2019-12-27T18:11:19.117Z", "createdBy": { "metadata": { "id": "id", "accountId": "accountId", "name": "name", "profileId": "profileId", "externalId": "externalId", "labels": { "foo": "string" } }, "spec": { "type": "PROFILE_TYPE_UNSPECIFIED", "email": "email", "name": "name" } }, "createdCount": 0, "deletedCount": 0, "failedCount": 0, "startedAt": "2019-12-27T18:11:19.117Z", "totalCount": 0, "unchangedCount": 0, "updatedCount": 0 } } ``` ## Get a bulk workspace apply operation `client.BulkWorkspaceResources.Get(ctx, workspaceID, id) (*BulkWorkspaceApply, error)` **get** `/v1/workspaces/{workspaceId}/bulk_workspace_applies/{id}` Retrieves a bulk workspace apply operation by ID. ### Parameters - `workspaceID string` - `id string` ### Returns - `type BulkWorkspaceApply struct{…}` The operation resource produced by a call to BulkWorkspaceResources.Apply. It carries the input bundle in `data`, the lifecycle state in `status`, and aggregate counts in `info`. - `Data BulkWorkspaceApplyData` - `BundleKey string` Required. Bundle ownership key. Resources created or updated by an Apply have their `metadata.bundle_key` set to this value. On subsequent applies with the same bundle_key, resources currently bearing this bundle_key but absent from the spec are soft-deleted. - `Agents map[string, AgentEntry]` Agents to upsert, keyed by external_id. - `Name string` - `Spec AgentSpec` Agent specification (user-provided configuration) - `Status AgentSpecStatus` Status of the agent - `const AgentSpecStatusAgentStatusUnspecified AgentSpecStatus = "AGENT_STATUS_UNSPECIFIED"` - `const AgentSpecStatusAgentStatusDraft AgentSpecStatus = "AGENT_STATUS_DRAFT"` - `const AgentSpecStatusAgentStatusPublished AgentSpecStatus = "AGENT_STATUS_PUBLISHED"` - `const AgentSpecStatusAgentStatusArchived AgentSpecStatus = "AGENT_STATUS_ARCHIVED"` - `VariationSelectionMode AgentSpecVariationSelectionMode` Controls how variations are automatically selected when creating objectives Defaults to RANDOM when unspecified - `const AgentSpecVariationSelectionModeVariationSelectionModeUnspecified AgentSpecVariationSelectionMode = "VARIATION_SELECTION_MODE_UNSPECIFIED"` - `const AgentSpecVariationSelectionModeVariationSelectionModeRandom AgentSpecVariationSelectionMode = "VARIATION_SELECTION_MODE_RANDOM"` - `const AgentSpecVariationSelectionModeVariationSelectionModeWeighted AgentSpecVariationSelectionMode = "VARIATION_SELECTION_MODE_WEIGHTED"` - `Description string` Description of the agent's purpose - `InputDataSchema map[string, unknown]` InputDataSchema is used for enforcing a data input when objectives are created. This is valuable when using liquid formatting in agent variation prompts. Input data schema is also valuable when using an agent as a sub-agent, as the schema is used as the tool's input parameter schema. If omitted, the sub-agent schema will be loaded with a simple "prompt" free text string as its schema. - `OutputDefinition map[string, unknown]` Optional output definition for objectives created for this agent. When provided, Cadenya will append a tool to that will be called by the LLM in use by the variant to extract information in the format provided here. Use this option when you want structured data to be created by your objectives. - `WebhookEventsURL string` The URL that Cadenya will send events for any objective assigned to the agent. - `Labels map[string, string]` - `Schedules map[string, AgentScheduleEntry]` Schedules under this agent, keyed by external_id. - `Name string` - `Spec AgentScheduleSpec` AgentScheduleSpec is the user-provided configuration for a schedule. - `InitialMessage string` The initial message passed to CreateObjective on each fire. Becomes the first user message in the objective's chat history. - `Schedule AgentScheduleSpecSchedule` Schedule defines WHEN the schedule fires. Temporal-style structured form: a list of calendar rules (wall-clock) and/or interval rules (duration), OR'd together. At least one rule is required. - `Calendars []ScheduleCalendar` Wall-clock rules. May be empty if `intervals` is non-empty. - `Comment string` - `DayOfMonth []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `DayOfWeek []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Hour []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Minute []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Month []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Second []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Intervals []ScheduleInterval` Duration-based rules. May be empty if `calendars` is non-empty. - `Every string` - `Offset string` Phase shift within `every`. Must be < `every` (enforced at runtime). - `Timezone string` IANA tz name (e.g. "America/New_York"). Required. Applies to calendars; intervals fire on wall-clock cadence anchored in this zone. - `Data unknown` Optional input data passed to the objective. If the agent has an input_data_schema, this must satisfy it. - `OverlapPolicy AgentScheduleSpecOverlapPolicy` What to do when the previous run is still in flight. Defaults to SKIP. - `const AgentScheduleSpecOverlapPolicyOverlapPolicyUnspecified AgentScheduleSpecOverlapPolicy = "OVERLAP_POLICY_UNSPECIFIED"` - `const AgentScheduleSpecOverlapPolicyOverlapPolicyAllow AgentScheduleSpecOverlapPolicy = "OVERLAP_POLICY_ALLOW"` - `const AgentScheduleSpecOverlapPolicyOverlapPolicySkip AgentScheduleSpecOverlapPolicy = "OVERLAP_POLICY_SKIP"` - `Status AgentScheduleSpecStatus` Lifecycle. Defaults to ACTIVE on create when unspecified. - `const AgentScheduleSpecStatusAgentScheduleStatusUnspecified AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_UNSPECIFIED"` - `const AgentScheduleSpecStatusAgentScheduleStatusActive AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_ACTIVE"` - `const AgentScheduleSpecStatusAgentScheduleStatusPaused AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_PAUSED"` - `const AgentScheduleSpecStatusAgentScheduleStatusArchived AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_ARCHIVED"` - `VariationID string` Optional explicit variation. When unset, the agent's variation_selection_mode chooses per fire. - `Labels map[string, string]` - `Variations map[string, AgentVariationEntry]` Variations under this agent, keyed by external_id. - `Name string` - `Spec AgentVariationSpec` AgentVariationSpec defines the operational configuration for a variation - `CompactionConfig AgentVariationSpecCompactionConfig` CompactionConfig defines how context window compaction behaves for objectives using this variation. - `Summarization CompactionConfigSummarizationStrategy` SummarizationStrategy configures LLM-powered summarization of older conversation turns. - `Instructions string` Custom instructions that guide what the summarizer preserves. Replaces the default summarization prompt entirely. Example: "Preserve all code snippets, variable names, and technical decisions." - `ToolResultClearing CompactionConfigToolResultClearingStrategy` ToolResultClearingStrategy configures clearing of older tool result content. - `PreserveRecentResults int64` Number of most recent tool call results to keep intact. Older tool results have their content replaced with "[result cleared]" while preserving the assistant tool call message (function name, arguments). Default: 2 - `TriggerThreshold float64` Trigger threshold as a percentage of the model's context window (0.0 to 1.0). When input tokens reach this percentage of the model's limit, compaction triggers. Default: 0.75 (75%) - `Constraints AgentVariationSpecConstraints` Execution constraints - `MaxSubObjectives int64` The maximum number of sub-objectives that can be created. 0 means no limit. - `MaxToolCalls int64` The maximum number of tool calls that can be made. 0 means no limit. - `Description string` Human-readable description of what this variation does or when it should be used - `EnableEpisodicMemory bool` Enable episodic memory for objectives using this variation. When true, the system automatically creates a document namespace for each objective using the objective's episodic_key as the external_id, allowing the agent to store and retrieve documents specific to that episode. - `EpisodicMemoryTtl int64` How long episodic memories should be retained. After this duration, episodic document namespaces can be automatically cleaned up. If not set, episodic memories are retained indefinitely. - `ModelConfig AgentVariationSpecModelConfig` ModelConfig defines the model configuration for a variation - `ModelID string` The model identifier in family/model format (e.g., "claude/opus-4.6", "claude/sonnet-4.5") - `Temperature float64` Sampling temperature for model inference (0.0 to 1.0) Lower values produce more deterministic outputs, higher values increase randomness - `ProgressiveDiscovery AgentVariationSpecProgressiveDiscovery` ProgressiveDiscovery is used to indicate that the agent should automatically discover tools that are not explicitly assigned to it. Max tools is the maximum number of tools that can be discovered per search. Hints are optional hints for tool search. These are used in conjunction with the context-aware tool search and can help select the best tools for the task. - `Hints []string` - `MaxTools int64` - `RerankThreshold float64` Rerank Threshold is an optional value that instructs whether or not to run a search result through a embedding/reranker process which can improve performance and reduce context bloat when tools reach the configured threshold. If a tool match must exceed 0.8, for example, the tool very closely match the query the tool search performed. - `Prompt string` The system prompt for this variation - `Weight int64` Weight for weighted random selection (>= 0). P(v) = v.weight / sum(all_weights). Only used when the agent's variation_selection_mode is WEIGHTED. A weight of 0 means never auto-selected, but can still be chosen explicitly via variation_id on CreateObjectiveRequest. - `Assignments []VariationAssignmentEntry` Reconciled list — server adjusts the variation's assignments to exactly this set when the variation is bundle-owned. - `SubAgentID string` - `ToolID string` - `ToolSetID string` - `Labels map[string, string]` - `MemoryLayers []VariationMemoryLayerEntry` Reconciled list of memory layer assignments. Up to 10 entries. - `MemoryLayerID string` external_id: form. Canonical IDs are rejected. - `Position int64` - `AutomaticallyPublishAgents bool` When true, every agent created or updated by this Apply has its status forced to AGENT_STATUS_PUBLISHED, regardless of the status declared in the agent's AgentSpec. Useful when the bundle represents a production configuration and you want all of its agents live without setting status: AGENT_STATUS_PUBLISHED on each entry. Default false: each agent's AgentSpec.status controls (which is AGENT_STATUS_DRAFT on create when unspecified). - `MemoryLayers map[string, MemoryLayerEntry]` Memory layers to upsert, keyed by external_id. - `Name string` - `Spec MemoryLayerSpec` - `Type MemoryLayerSpecType` - `const MemoryLayerSpecTypeMemoryLayerTypeUnspecified MemoryLayerSpecType = "MEMORY_LAYER_TYPE_UNSPECIFIED"` - `const MemoryLayerSpecTypeMemoryLayerTypeEpisodic MemoryLayerSpecType = "MEMORY_LAYER_TYPE_EPISODIC"` - `const MemoryLayerSpecTypeMemoryLayerTypeSkills MemoryLayerSpecType = "MEMORY_LAYER_TYPE_SKILLS"` - `Description string` Human-readable description of the layer's purpose. Encouraged for user-created layers; system-managed layers may have a generated description. - `ExpiresAt Time` For layers with a finite lifetime (e.g., episodic), the time at which the layer becomes eligible for cleanup. Set by the system; unset for persistent layers. - `SystemManaged bool` Server-set. True for layers managed by the system (e.g., episodic layers created automatically when an objective uses an episodic_key). System-managed layers cannot be assigned to objective stacks via the API and cannot be mutated by clients — their lifecycle is controlled entirely by the runtime. - `Entries map[string, MemoryEntryItem]` Memory entries in this layer, keyed by external_id. - `Key string` - `Content string` - `Description string` - `UploadID string` - `Labels map[string, string]` - `SourceURL string` Optional URL pointing to the source of this apply (GitHub PR, Jenkins build, GitLab pipeline, etc.). Surfaced in the dashboard so users can jump from an apply back to the change that produced it. Free-form HTTPS URI; not interpreted by the server. - `ToolSets map[string, ToolSetEntry]` Tool sets to upsert, keyed by external_id. - `Name string` - `Spec ToolSetSpec` - `Adapter ToolSetAdapter` - `HTTP ToolSetAdapterHTTP` - `BaseURL string` - `Headers map[string, string]` - `Mcp ToolSetAdapterMcp` - `ExcludeTools ToolFilter` Top-level filter with simple boolean logic (no nesting) - `Operator ToolFilterOperator` - `const ToolFilterOperatorOperatorUnspecified ToolFilterOperator = "OPERATOR_UNSPECIFIED"` - `const ToolFilterOperatorOperatorAnd ToolFilterOperator = "OPERATOR_AND"` - `const ToolFilterOperatorOperatorOr ToolFilterOperator = "OPERATOR_OR"` - `Filters []AttributeFilter` - `Attribute AttributeFilterAttribute` - `const AttributeFilterAttributeAttributeUnspecified AttributeFilterAttribute = "ATTRIBUTE_UNSPECIFIED"` - `const AttributeFilterAttributeAttributeName AttributeFilterAttribute = "ATTRIBUTE_NAME"` - `const AttributeFilterAttributeAttributeTitle AttributeFilterAttribute = "ATTRIBUTE_TITLE"` - `const AttributeFilterAttributeAttributeDescription AttributeFilterAttribute = "ATTRIBUTE_DESCRIPTION"` - `Matcher StringMatcher` String matching operations - `CaseSensitive bool` - `Contains string` - `EndsWith string` - `Exact string` - `Regex string` - `StartsWith string` - `Headers map[string, string]` - `IncludeTools ToolFilter` Top-level filter with simple boolean logic (no nesting) - `ToolApprovals ApprovalRequirementFilter` Approval filters that will automatically set the approval requirement on tools synced from an external source - `Always bool` - `Only ToolFilter` Top-level filter with simple boolean logic (no nesting) - `URL string` - `OpenAPI ToolSetAdapterOpenAPI` - `BaseURL string` Base URL for dispatching tool calls. If set, overrides the server resolved from the spec's servers array. - `ExcludeTools ToolFilter` Top-level filter with simple boolean logic (no nesting) - `Headers map[string, string]` Headers sent when fetching the spec from a URL and when dispatching tool calls. - `IncludeTools ToolFilter` Top-level filter with simple boolean logic (no nesting) - `ServerName string` Name of the server entry in the spec's servers array (OpenAPI 3.2 server.name field). Used to select which server URL to dispatch to when base_url is not set. If unset, the first server is used. Ignored when base_url is set. - `ToolApprovals ApprovalRequirementFilter` Approval filters that will automatically set the approval requirement on tools synced from an external source - `UploadID string` ID of a COMPLETE Upload containing the OpenAPI spec document. - `URL string` URL to fetch the OpenAPI spec from. Synced automatically every hour. - `Description string` - `Labels map[string, string]` - `Tools map[string, ToolEntry]` Tools in this tool set, keyed by external_id. - `Name string` - `Spec ToolSpec` - `Config ToolSpecConfig` Config defines the adapter to use for the tool. This is used to determine how the tool is called. For example, if the tool is an HTTP tool, the adapter will be Http. If the tool is an inline tool, the adapter will be Inline. - `HTTP ConfigHTTP` - `RequestMethod ConfigHTTPRequestMethod` - `const ConfigHTTPRequestMethodHTTPMethodUnspecified ConfigHTTPRequestMethod = "HTTP_METHOD_UNSPECIFIED"` - `const ConfigHTTPRequestMethodGet ConfigHTTPRequestMethod = "GET"` - `const ConfigHTTPRequestMethodPost ConfigHTTPRequestMethod = "POST"` - `const ConfigHTTPRequestMethodPut ConfigHTTPRequestMethod = "PUT"` - `const ConfigHTTPRequestMethodPatch ConfigHTTPRequestMethod = "PATCH"` - `const ConfigHTTPRequestMethodDelete ConfigHTTPRequestMethod = "DELETE"` - `Headers map[string, string]` - `Path string` - `Query string` - `RequestBodyContentType string` - `RequestBodyTemplate string` These are only used when the request method is a POST, PUT, or PATCH - `ToolName string` The tool name (commonly an "operation id" in OpenAPI specs) to call on the HTTP adapter. This is used to match the tool spec to the correct endpoint on the HTTP adapter. it will be derived from the name of the tool if not provided. - `Mcp ConfigMcp` - `ToolDescription string` - `ToolName string` - `ToolTitle string` - `OpenAPI ConfigOpenAPI` - `Method string` - `OperationID string` - `Path string` - `Description string` - `Parameters map[string, unknown]` - `Status ToolSpecStatus` - `const ToolSpecStatusToolStatusUnspecified ToolSpecStatus = "TOOL_STATUS_UNSPECIFIED"` - `const ToolSpecStatusToolStatusAvailable ToolSpecStatus = "TOOL_STATUS_AVAILABLE"` - `const ToolSpecStatusToolStatusOmitted ToolSpecStatus = "TOOL_STATUS_OMITTED"` - `const ToolSpecStatusToolStatusArchived ToolSpecStatus = "TOOL_STATUS_ARCHIVED"` - `RequiresApproval bool` - `Labels map[string, string]` - `Metadata OperationMetadata` Metadata for ephemeral operations and activities (e.g., objectives, executions, runs) - `ID string` Unique identifier for the operation (prefixed ULID, e.g., "obj_01HXK...") - `AccountID string` Account this operation belongs to for multi-tenant isolation (prefixed ULID) - `CreatedAt Time` Timestamp when this operation was created ULID includes timestamp information, but this explicit field enables easier querying - `ProfileID string` ID of the actor (user or service account) that created this operation - `WorkspaceID string` Workspace this operation belongs to for organizational grouping (prefixed ULID) - `ExternalID string` External ID for the operation (e.g., a workflow ID from an external system) - `Labels map[string, string]` Arbitrary key-value pairs for categorization and filtering Examples: {"priority": "high", "source": "api", "workflow": "onboarding"} - `Status BulkWorkspaceApplyStatus` - `State BulkWorkspaceApplyStatusState` - `const BulkWorkspaceApplyStatusStateStateUnspecified BulkWorkspaceApplyStatusState = "STATE_UNSPECIFIED"` - `const BulkWorkspaceApplyStatusStateStatePending BulkWorkspaceApplyStatusState = "STATE_PENDING"` - `const BulkWorkspaceApplyStatusStateStateValidating BulkWorkspaceApplyStatusState = "STATE_VALIDATING"` - `const BulkWorkspaceApplyStatusStateStateRunning BulkWorkspaceApplyStatusState = "STATE_RUNNING"` - `const BulkWorkspaceApplyStatusStateStateSucceeded BulkWorkspaceApplyStatusState = "STATE_SUCCEEDED"` - `const BulkWorkspaceApplyStatusStateStatePartiallyApplied BulkWorkspaceApplyStatusState = "STATE_PARTIALLY_APPLIED"` - `const BulkWorkspaceApplyStatusStateStateFailed BulkWorkspaceApplyStatusState = "STATE_FAILED"` - `const BulkWorkspaceApplyStatusStateStateCancelled BulkWorkspaceApplyStatusState = "STATE_CANCELLED"` - `Message string` - `PreflightError BulkWorkspaceApplyStatusPreflightError` The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). - `Code int64` The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. - `Details []BulkWorkspaceApplyStatusPreflightErrorDetail` A list of messages that carry the error details. There is a common set of message types for APIs to use. - `Type string` The type of the serialized message. - `Message string` A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. - `Info BulkWorkspaceApplyInfo` - `CompletedAt Time` - `CreatedBy Profile` A profile identifies a user or non-human principal (such as an API key) at the account level. Profiles are account-scoped and can be granted access to multiple workspaces. - `Metadata AccountResourceMetadata` AccountResourceMetadata is used to represent a resource that is associated to an account but not to a workspace. - `ID string` Unique identifier for the resource (prefixed ULID, e.g., "apikey_01HXK...") - `AccountID string` Account this resource belongs to for multi-tenant isolation (prefixed ULID) - `Name string` Human-readable name for the resource (e.g., "Customer Support Agent", "Email Tool") Required for resources that users interact with directly - `ProfileID string` - `ExternalID string` External ID for the resource (e.g., a workflow ID from an external system) - `Labels map[string, string]` Arbitrary key-value pairs for categorization and filtering Examples: {"environment": "production", "team": "platform", "version": "v2"} - `Spec ProfileSpec` Configuration for a profile. - `Type ProfileSpecType` Whether this profile represents a human user, an API key, or a system principal. - `const ProfileSpecTypeProfileTypeUnspecified ProfileSpecType = "PROFILE_TYPE_UNSPECIFIED"` - `const ProfileSpecTypeProfileTypeUser ProfileSpecType = "PROFILE_TYPE_USER"` - `const ProfileSpecTypeProfileTypeAPIKey ProfileSpecType = "PROFILE_TYPE_API_KEY"` - `const ProfileSpecTypeProfileTypeSystem ProfileSpecType = "PROFILE_TYPE_SYSTEM"` - `Email string` Email address of the profile. Required and unique within an account for user profiles. - `Name string` Display name (e.g., "Bobby Tables"). - `CreatedCount int64` - `DeletedCount int64` - `FailedCount int64` - `StartedAt Time` - `TotalCount int64` - `UnchangedCount int64` - `UpdatedCount int64` ### Example ```go package main import ( "context" "fmt" "github.com/cadenya/cadenya-go" "github.com/cadenya/cadenya-go/option" ) func main() { client := cadenya.NewClient( option.WithAPIKey("My API Key"), ) bulkWorkspaceApply, err := client.BulkWorkspaceResources.Get( context.TODO(), "workspaceId", "id", ) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", bulkWorkspaceApply.Data) } ``` #### Response ```json { "data": { "bundleKey": "bundleKey", "agents": { "foo": { "name": "name", "spec": { "status": "AGENT_STATUS_UNSPECIFIED", "variationSelectionMode": "VARIATION_SELECTION_MODE_UNSPECIFIED", "description": "description", "inputDataSchema": { "foo": "bar" }, "outputDefinition": { "foo": "bar" }, "webhookEventsUrl": "webhookEventsUrl" }, "labels": { "foo": "string" }, "schedules": { "foo": { "name": "name", "spec": { "initialMessage": "initialMessage", "schedule": { "calendars": [ { "comment": "comment", "dayOfMonth": [ { "end": 0, "start": 0, "step": 0 } ], "dayOfWeek": [ { "end": 0, "start": 0, "step": 0 } ], "hour": [ { "end": 0, "start": 0, "step": 0 } ], "minute": [ { "end": 0, "start": 0, "step": 0 } ], "month": [ { "end": 0, "start": 0, "step": 0 } ], "second": [ { "end": 0, "start": 0, "step": 0 } ] } ], "intervals": [ { "every": "-160513s", "offset": "-160513s" } ], "timezone": "timezone" }, "data": {}, "overlapPolicy": "OVERLAP_POLICY_UNSPECIFIED", "status": "AGENT_SCHEDULE_STATUS_UNSPECIFIED", "variationId": "variationId" }, "labels": { "foo": "string" } } }, "variations": { "foo": { "name": "name", "spec": { "compactionConfig": { "summarization": { "instructions": "instructions" }, "toolResultClearing": { "preserveRecentResults": 0 }, "triggerThreshold": 0 }, "constraints": { "maxSubObjectives": 0, "maxToolCalls": 0 }, "description": "description", "enableEpisodicMemory": true, "episodicMemoryTtl": 0, "modelConfig": { "modelId": "modelId", "temperature": 0 }, "progressiveDiscovery": { "hints": [ "string" ], "maxTools": 0, "rerankThreshold": 0 }, "prompt": "prompt", "weight": 0 }, "assignments": [ { "subAgentId": "subAgentId", "toolId": "toolId", "toolSetId": "toolSetId" } ], "labels": { "foo": "string" }, "memoryLayers": [ { "memoryLayerId": "memoryLayerId", "position": 0 } ] } } } }, "automaticallyPublishAgents": true, "memoryLayers": { "foo": { "name": "name", "spec": { "type": "MEMORY_LAYER_TYPE_UNSPECIFIED", "description": "description", "expiresAt": "2019-12-27T18:11:19.117Z", "systemManaged": true }, "entries": { "foo": { "key": "key", "content": "content", "description": "description", "uploadId": "uploadId" } }, "labels": { "foo": "string" } } }, "sourceUrl": "sourceUrl", "toolSets": { "foo": { "name": "name", "spec": { "adapter": { "http": { "baseUrl": "baseUrl", "headers": { "foo": "string" } }, "mcp": { "excludeTools": { "operator": "OPERATOR_UNSPECIFIED", "filters": [ { "attribute": "ATTRIBUTE_UNSPECIFIED", "matcher": { "caseSensitive": true, "contains": "contains", "endsWith": "endsWith", "exact": "exact", "regex": "regex", "startsWith": "startsWith" } } ] }, "headers": { "foo": "string" }, "includeTools": { "operator": "OPERATOR_UNSPECIFIED", "filters": [ { "attribute": "ATTRIBUTE_UNSPECIFIED", "matcher": { "caseSensitive": true, "contains": "contains", "endsWith": "endsWith", "exact": "exact", "regex": "regex", "startsWith": "startsWith" } } ] }, "toolApprovals": { "always": true, "only": { "operator": "OPERATOR_UNSPECIFIED", "filters": [ { "attribute": "ATTRIBUTE_UNSPECIFIED", "matcher": { "caseSensitive": true, "contains": "contains", "endsWith": "endsWith", "exact": "exact", "regex": "regex", "startsWith": "startsWith" } } ] } }, "url": "url" }, "openapi": { "baseUrl": "baseUrl", "excludeTools": { "operator": "OPERATOR_UNSPECIFIED", "filters": [ { "attribute": "ATTRIBUTE_UNSPECIFIED", "matcher": { "caseSensitive": true, "contains": "contains", "endsWith": "endsWith", "exact": "exact", "regex": "regex", "startsWith": "startsWith" } } ] }, "headers": { "foo": "string" }, "includeTools": { "operator": "OPERATOR_UNSPECIFIED", "filters": [ { "attribute": "ATTRIBUTE_UNSPECIFIED", "matcher": { "caseSensitive": true, "contains": "contains", "endsWith": "endsWith", "exact": "exact", "regex": "regex", "startsWith": "startsWith" } } ] }, "serverName": "serverName", "toolApprovals": { "always": true, "only": { "operator": "OPERATOR_UNSPECIFIED", "filters": [ { "attribute": "ATTRIBUTE_UNSPECIFIED", "matcher": { "caseSensitive": true, "contains": "contains", "endsWith": "endsWith", "exact": "exact", "regex": "regex", "startsWith": "startsWith" } } ] } }, "uploadId": "uploadId", "url": "url" } }, "description": "description" }, "labels": { "foo": "string" }, "tools": { "foo": { "name": "name", "spec": { "config": { "http": { "requestMethod": "HTTP_METHOD_UNSPECIFIED", "headers": { "foo": "string" }, "path": "path", "query": "query", "requestBodyContentType": "requestBodyContentType", "requestBodyTemplate": "requestBodyTemplate", "toolName": "toolName" }, "mcp": { "toolDescription": "toolDescription", "toolName": "toolName", "toolTitle": "toolTitle" }, "openapi": { "method": "method", "operationId": "operationId", "path": "path" } }, "description": "description", "parameters": { "foo": "bar" }, "status": "TOOL_STATUS_UNSPECIFIED", "requiresApproval": true }, "labels": { "foo": "string" } } } } } }, "metadata": { "id": "id", "accountId": "accountId", "createdAt": "2019-12-27T18:11:19.117Z", "profileId": "profileId", "workspaceId": "workspaceId", "externalId": "externalId", "labels": { "foo": "string" } }, "status": { "state": "STATE_UNSPECIFIED", "message": "message", "preflightError": { "code": 0, "details": [ { "@type": "@type" } ], "message": "message" } }, "info": { "completedAt": "2019-12-27T18:11:19.117Z", "createdBy": { "metadata": { "id": "id", "accountId": "accountId", "name": "name", "profileId": "profileId", "externalId": "externalId", "labels": { "foo": "string" } }, "spec": { "type": "PROFILE_TYPE_UNSPECIFIED", "email": "email", "name": "name" } }, "createdCount": 0, "deletedCount": 0, "failedCount": 0, "startedAt": "2019-12-27T18:11:19.117Z", "totalCount": 0, "unchangedCount": 0, "updatedCount": 0 } } ``` ## List bulk workspace apply operations `client.BulkWorkspaceResources.List(ctx, workspaceID, query) (*CursorPagination[BulkWorkspaceApply], error)` **get** `/v1/workspaces/{workspaceId}/bulk_workspace_applies` Lists past and in-flight bulk workspace apply operations in the workspace. ### Parameters - `workspaceID string` - `query BulkWorkspaceResourceListParams` - `BundleKey param.Field[string]` Filter by bundle_key — list every apply for a given bundle. - `Cursor param.Field[string]` Pagination cursor from previous response - `Limit param.Field[int64]` Maximum number of results to return - `SortOrder param.Field[string]` Sort order for results (asc or desc by creation time) - `State param.Field[BulkWorkspaceResourceListParamsState]` Filter by lifecycle state. - `const BulkWorkspaceResourceListParamsStateStateUnspecified BulkWorkspaceResourceListParamsState = "STATE_UNSPECIFIED"` - `const BulkWorkspaceResourceListParamsStateStatePending BulkWorkspaceResourceListParamsState = "STATE_PENDING"` - `const BulkWorkspaceResourceListParamsStateStateValidating BulkWorkspaceResourceListParamsState = "STATE_VALIDATING"` - `const BulkWorkspaceResourceListParamsStateStateRunning BulkWorkspaceResourceListParamsState = "STATE_RUNNING"` - `const BulkWorkspaceResourceListParamsStateStateSucceeded BulkWorkspaceResourceListParamsState = "STATE_SUCCEEDED"` - `const BulkWorkspaceResourceListParamsStateStatePartiallyApplied BulkWorkspaceResourceListParamsState = "STATE_PARTIALLY_APPLIED"` - `const BulkWorkspaceResourceListParamsStateStateFailed BulkWorkspaceResourceListParamsState = "STATE_FAILED"` - `const BulkWorkspaceResourceListParamsStateStateCancelled BulkWorkspaceResourceListParamsState = "STATE_CANCELLED"` ### Returns - `type BulkWorkspaceApply struct{…}` The operation resource produced by a call to BulkWorkspaceResources.Apply. It carries the input bundle in `data`, the lifecycle state in `status`, and aggregate counts in `info`. - `Data BulkWorkspaceApplyData` - `BundleKey string` Required. Bundle ownership key. Resources created or updated by an Apply have their `metadata.bundle_key` set to this value. On subsequent applies with the same bundle_key, resources currently bearing this bundle_key but absent from the spec are soft-deleted. - `Agents map[string, AgentEntry]` Agents to upsert, keyed by external_id. - `Name string` - `Spec AgentSpec` Agent specification (user-provided configuration) - `Status AgentSpecStatus` Status of the agent - `const AgentSpecStatusAgentStatusUnspecified AgentSpecStatus = "AGENT_STATUS_UNSPECIFIED"` - `const AgentSpecStatusAgentStatusDraft AgentSpecStatus = "AGENT_STATUS_DRAFT"` - `const AgentSpecStatusAgentStatusPublished AgentSpecStatus = "AGENT_STATUS_PUBLISHED"` - `const AgentSpecStatusAgentStatusArchived AgentSpecStatus = "AGENT_STATUS_ARCHIVED"` - `VariationSelectionMode AgentSpecVariationSelectionMode` Controls how variations are automatically selected when creating objectives Defaults to RANDOM when unspecified - `const AgentSpecVariationSelectionModeVariationSelectionModeUnspecified AgentSpecVariationSelectionMode = "VARIATION_SELECTION_MODE_UNSPECIFIED"` - `const AgentSpecVariationSelectionModeVariationSelectionModeRandom AgentSpecVariationSelectionMode = "VARIATION_SELECTION_MODE_RANDOM"` - `const AgentSpecVariationSelectionModeVariationSelectionModeWeighted AgentSpecVariationSelectionMode = "VARIATION_SELECTION_MODE_WEIGHTED"` - `Description string` Description of the agent's purpose - `InputDataSchema map[string, unknown]` InputDataSchema is used for enforcing a data input when objectives are created. This is valuable when using liquid formatting in agent variation prompts. Input data schema is also valuable when using an agent as a sub-agent, as the schema is used as the tool's input parameter schema. If omitted, the sub-agent schema will be loaded with a simple "prompt" free text string as its schema. - `OutputDefinition map[string, unknown]` Optional output definition for objectives created for this agent. When provided, Cadenya will append a tool to that will be called by the LLM in use by the variant to extract information in the format provided here. Use this option when you want structured data to be created by your objectives. - `WebhookEventsURL string` The URL that Cadenya will send events for any objective assigned to the agent. - `Labels map[string, string]` - `Schedules map[string, AgentScheduleEntry]` Schedules under this agent, keyed by external_id. - `Name string` - `Spec AgentScheduleSpec` AgentScheduleSpec is the user-provided configuration for a schedule. - `InitialMessage string` The initial message passed to CreateObjective on each fire. Becomes the first user message in the objective's chat history. - `Schedule AgentScheduleSpecSchedule` Schedule defines WHEN the schedule fires. Temporal-style structured form: a list of calendar rules (wall-clock) and/or interval rules (duration), OR'd together. At least one rule is required. - `Calendars []ScheduleCalendar` Wall-clock rules. May be empty if `intervals` is non-empty. - `Comment string` - `DayOfMonth []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `DayOfWeek []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Hour []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Minute []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Month []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Second []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Intervals []ScheduleInterval` Duration-based rules. May be empty if `calendars` is non-empty. - `Every string` - `Offset string` Phase shift within `every`. Must be < `every` (enforced at runtime). - `Timezone string` IANA tz name (e.g. "America/New_York"). Required. Applies to calendars; intervals fire on wall-clock cadence anchored in this zone. - `Data unknown` Optional input data passed to the objective. If the agent has an input_data_schema, this must satisfy it. - `OverlapPolicy AgentScheduleSpecOverlapPolicy` What to do when the previous run is still in flight. Defaults to SKIP. - `const AgentScheduleSpecOverlapPolicyOverlapPolicyUnspecified AgentScheduleSpecOverlapPolicy = "OVERLAP_POLICY_UNSPECIFIED"` - `const AgentScheduleSpecOverlapPolicyOverlapPolicyAllow AgentScheduleSpecOverlapPolicy = "OVERLAP_POLICY_ALLOW"` - `const AgentScheduleSpecOverlapPolicyOverlapPolicySkip AgentScheduleSpecOverlapPolicy = "OVERLAP_POLICY_SKIP"` - `Status AgentScheduleSpecStatus` Lifecycle. Defaults to ACTIVE on create when unspecified. - `const AgentScheduleSpecStatusAgentScheduleStatusUnspecified AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_UNSPECIFIED"` - `const AgentScheduleSpecStatusAgentScheduleStatusActive AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_ACTIVE"` - `const AgentScheduleSpecStatusAgentScheduleStatusPaused AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_PAUSED"` - `const AgentScheduleSpecStatusAgentScheduleStatusArchived AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_ARCHIVED"` - `VariationID string` Optional explicit variation. When unset, the agent's variation_selection_mode chooses per fire. - `Labels map[string, string]` - `Variations map[string, AgentVariationEntry]` Variations under this agent, keyed by external_id. - `Name string` - `Spec AgentVariationSpec` AgentVariationSpec defines the operational configuration for a variation - `CompactionConfig AgentVariationSpecCompactionConfig` CompactionConfig defines how context window compaction behaves for objectives using this variation. - `Summarization CompactionConfigSummarizationStrategy` SummarizationStrategy configures LLM-powered summarization of older conversation turns. - `Instructions string` Custom instructions that guide what the summarizer preserves. Replaces the default summarization prompt entirely. Example: "Preserve all code snippets, variable names, and technical decisions." - `ToolResultClearing CompactionConfigToolResultClearingStrategy` ToolResultClearingStrategy configures clearing of older tool result content. - `PreserveRecentResults int64` Number of most recent tool call results to keep intact. Older tool results have their content replaced with "[result cleared]" while preserving the assistant tool call message (function name, arguments). Default: 2 - `TriggerThreshold float64` Trigger threshold as a percentage of the model's context window (0.0 to 1.0). When input tokens reach this percentage of the model's limit, compaction triggers. Default: 0.75 (75%) - `Constraints AgentVariationSpecConstraints` Execution constraints - `MaxSubObjectives int64` The maximum number of sub-objectives that can be created. 0 means no limit. - `MaxToolCalls int64` The maximum number of tool calls that can be made. 0 means no limit. - `Description string` Human-readable description of what this variation does or when it should be used - `EnableEpisodicMemory bool` Enable episodic memory for objectives using this variation. When true, the system automatically creates a document namespace for each objective using the objective's episodic_key as the external_id, allowing the agent to store and retrieve documents specific to that episode. - `EpisodicMemoryTtl int64` How long episodic memories should be retained. After this duration, episodic document namespaces can be automatically cleaned up. If not set, episodic memories are retained indefinitely. - `ModelConfig AgentVariationSpecModelConfig` ModelConfig defines the model configuration for a variation - `ModelID string` The model identifier in family/model format (e.g., "claude/opus-4.6", "claude/sonnet-4.5") - `Temperature float64` Sampling temperature for model inference (0.0 to 1.0) Lower values produce more deterministic outputs, higher values increase randomness - `ProgressiveDiscovery AgentVariationSpecProgressiveDiscovery` ProgressiveDiscovery is used to indicate that the agent should automatically discover tools that are not explicitly assigned to it. Max tools is the maximum number of tools that can be discovered per search. Hints are optional hints for tool search. These are used in conjunction with the context-aware tool search and can help select the best tools for the task. - `Hints []string` - `MaxTools int64` - `RerankThreshold float64` Rerank Threshold is an optional value that instructs whether or not to run a search result through a embedding/reranker process which can improve performance and reduce context bloat when tools reach the configured threshold. If a tool match must exceed 0.8, for example, the tool very closely match the query the tool search performed. - `Prompt string` The system prompt for this variation - `Weight int64` Weight for weighted random selection (>= 0). P(v) = v.weight / sum(all_weights). Only used when the agent's variation_selection_mode is WEIGHTED. A weight of 0 means never auto-selected, but can still be chosen explicitly via variation_id on CreateObjectiveRequest. - `Assignments []VariationAssignmentEntry` Reconciled list — server adjusts the variation's assignments to exactly this set when the variation is bundle-owned. - `SubAgentID string` - `ToolID string` - `ToolSetID string` - `Labels map[string, string]` - `MemoryLayers []VariationMemoryLayerEntry` Reconciled list of memory layer assignments. Up to 10 entries. - `MemoryLayerID string` external_id: form. Canonical IDs are rejected. - `Position int64` - `AutomaticallyPublishAgents bool` When true, every agent created or updated by this Apply has its status forced to AGENT_STATUS_PUBLISHED, regardless of the status declared in the agent's AgentSpec. Useful when the bundle represents a production configuration and you want all of its agents live without setting status: AGENT_STATUS_PUBLISHED on each entry. Default false: each agent's AgentSpec.status controls (which is AGENT_STATUS_DRAFT on create when unspecified). - `MemoryLayers map[string, MemoryLayerEntry]` Memory layers to upsert, keyed by external_id. - `Name string` - `Spec MemoryLayerSpec` - `Type MemoryLayerSpecType` - `const MemoryLayerSpecTypeMemoryLayerTypeUnspecified MemoryLayerSpecType = "MEMORY_LAYER_TYPE_UNSPECIFIED"` - `const MemoryLayerSpecTypeMemoryLayerTypeEpisodic MemoryLayerSpecType = "MEMORY_LAYER_TYPE_EPISODIC"` - `const MemoryLayerSpecTypeMemoryLayerTypeSkills MemoryLayerSpecType = "MEMORY_LAYER_TYPE_SKILLS"` - `Description string` Human-readable description of the layer's purpose. Encouraged for user-created layers; system-managed layers may have a generated description. - `ExpiresAt Time` For layers with a finite lifetime (e.g., episodic), the time at which the layer becomes eligible for cleanup. Set by the system; unset for persistent layers. - `SystemManaged bool` Server-set. True for layers managed by the system (e.g., episodic layers created automatically when an objective uses an episodic_key). System-managed layers cannot be assigned to objective stacks via the API and cannot be mutated by clients — their lifecycle is controlled entirely by the runtime. - `Entries map[string, MemoryEntryItem]` Memory entries in this layer, keyed by external_id. - `Key string` - `Content string` - `Description string` - `UploadID string` - `Labels map[string, string]` - `SourceURL string` Optional URL pointing to the source of this apply (GitHub PR, Jenkins build, GitLab pipeline, etc.). Surfaced in the dashboard so users can jump from an apply back to the change that produced it. Free-form HTTPS URI; not interpreted by the server. - `ToolSets map[string, ToolSetEntry]` Tool sets to upsert, keyed by external_id. - `Name string` - `Spec ToolSetSpec` - `Adapter ToolSetAdapter` - `HTTP ToolSetAdapterHTTP` - `BaseURL string` - `Headers map[string, string]` - `Mcp ToolSetAdapterMcp` - `ExcludeTools ToolFilter` Top-level filter with simple boolean logic (no nesting) - `Operator ToolFilterOperator` - `const ToolFilterOperatorOperatorUnspecified ToolFilterOperator = "OPERATOR_UNSPECIFIED"` - `const ToolFilterOperatorOperatorAnd ToolFilterOperator = "OPERATOR_AND"` - `const ToolFilterOperatorOperatorOr ToolFilterOperator = "OPERATOR_OR"` - `Filters []AttributeFilter` - `Attribute AttributeFilterAttribute` - `const AttributeFilterAttributeAttributeUnspecified AttributeFilterAttribute = "ATTRIBUTE_UNSPECIFIED"` - `const AttributeFilterAttributeAttributeName AttributeFilterAttribute = "ATTRIBUTE_NAME"` - `const AttributeFilterAttributeAttributeTitle AttributeFilterAttribute = "ATTRIBUTE_TITLE"` - `const AttributeFilterAttributeAttributeDescription AttributeFilterAttribute = "ATTRIBUTE_DESCRIPTION"` - `Matcher StringMatcher` String matching operations - `CaseSensitive bool` - `Contains string` - `EndsWith string` - `Exact string` - `Regex string` - `StartsWith string` - `Headers map[string, string]` - `IncludeTools ToolFilter` Top-level filter with simple boolean logic (no nesting) - `ToolApprovals ApprovalRequirementFilter` Approval filters that will automatically set the approval requirement on tools synced from an external source - `Always bool` - `Only ToolFilter` Top-level filter with simple boolean logic (no nesting) - `URL string` - `OpenAPI ToolSetAdapterOpenAPI` - `BaseURL string` Base URL for dispatching tool calls. If set, overrides the server resolved from the spec's servers array. - `ExcludeTools ToolFilter` Top-level filter with simple boolean logic (no nesting) - `Headers map[string, string]` Headers sent when fetching the spec from a URL and when dispatching tool calls. - `IncludeTools ToolFilter` Top-level filter with simple boolean logic (no nesting) - `ServerName string` Name of the server entry in the spec's servers array (OpenAPI 3.2 server.name field). Used to select which server URL to dispatch to when base_url is not set. If unset, the first server is used. Ignored when base_url is set. - `ToolApprovals ApprovalRequirementFilter` Approval filters that will automatically set the approval requirement on tools synced from an external source - `UploadID string` ID of a COMPLETE Upload containing the OpenAPI spec document. - `URL string` URL to fetch the OpenAPI spec from. Synced automatically every hour. - `Description string` - `Labels map[string, string]` - `Tools map[string, ToolEntry]` Tools in this tool set, keyed by external_id. - `Name string` - `Spec ToolSpec` - `Config ToolSpecConfig` Config defines the adapter to use for the tool. This is used to determine how the tool is called. For example, if the tool is an HTTP tool, the adapter will be Http. If the tool is an inline tool, the adapter will be Inline. - `HTTP ConfigHTTP` - `RequestMethod ConfigHTTPRequestMethod` - `const ConfigHTTPRequestMethodHTTPMethodUnspecified ConfigHTTPRequestMethod = "HTTP_METHOD_UNSPECIFIED"` - `const ConfigHTTPRequestMethodGet ConfigHTTPRequestMethod = "GET"` - `const ConfigHTTPRequestMethodPost ConfigHTTPRequestMethod = "POST"` - `const ConfigHTTPRequestMethodPut ConfigHTTPRequestMethod = "PUT"` - `const ConfigHTTPRequestMethodPatch ConfigHTTPRequestMethod = "PATCH"` - `const ConfigHTTPRequestMethodDelete ConfigHTTPRequestMethod = "DELETE"` - `Headers map[string, string]` - `Path string` - `Query string` - `RequestBodyContentType string` - `RequestBodyTemplate string` These are only used when the request method is a POST, PUT, or PATCH - `ToolName string` The tool name (commonly an "operation id" in OpenAPI specs) to call on the HTTP adapter. This is used to match the tool spec to the correct endpoint on the HTTP adapter. it will be derived from the name of the tool if not provided. - `Mcp ConfigMcp` - `ToolDescription string` - `ToolName string` - `ToolTitle string` - `OpenAPI ConfigOpenAPI` - `Method string` - `OperationID string` - `Path string` - `Description string` - `Parameters map[string, unknown]` - `Status ToolSpecStatus` - `const ToolSpecStatusToolStatusUnspecified ToolSpecStatus = "TOOL_STATUS_UNSPECIFIED"` - `const ToolSpecStatusToolStatusAvailable ToolSpecStatus = "TOOL_STATUS_AVAILABLE"` - `const ToolSpecStatusToolStatusOmitted ToolSpecStatus = "TOOL_STATUS_OMITTED"` - `const ToolSpecStatusToolStatusArchived ToolSpecStatus = "TOOL_STATUS_ARCHIVED"` - `RequiresApproval bool` - `Labels map[string, string]` - `Metadata OperationMetadata` Metadata for ephemeral operations and activities (e.g., objectives, executions, runs) - `ID string` Unique identifier for the operation (prefixed ULID, e.g., "obj_01HXK...") - `AccountID string` Account this operation belongs to for multi-tenant isolation (prefixed ULID) - `CreatedAt Time` Timestamp when this operation was created ULID includes timestamp information, but this explicit field enables easier querying - `ProfileID string` ID of the actor (user or service account) that created this operation - `WorkspaceID string` Workspace this operation belongs to for organizational grouping (prefixed ULID) - `ExternalID string` External ID for the operation (e.g., a workflow ID from an external system) - `Labels map[string, string]` Arbitrary key-value pairs for categorization and filtering Examples: {"priority": "high", "source": "api", "workflow": "onboarding"} - `Status BulkWorkspaceApplyStatus` - `State BulkWorkspaceApplyStatusState` - `const BulkWorkspaceApplyStatusStateStateUnspecified BulkWorkspaceApplyStatusState = "STATE_UNSPECIFIED"` - `const BulkWorkspaceApplyStatusStateStatePending BulkWorkspaceApplyStatusState = "STATE_PENDING"` - `const BulkWorkspaceApplyStatusStateStateValidating BulkWorkspaceApplyStatusState = "STATE_VALIDATING"` - `const BulkWorkspaceApplyStatusStateStateRunning BulkWorkspaceApplyStatusState = "STATE_RUNNING"` - `const BulkWorkspaceApplyStatusStateStateSucceeded BulkWorkspaceApplyStatusState = "STATE_SUCCEEDED"` - `const BulkWorkspaceApplyStatusStateStatePartiallyApplied BulkWorkspaceApplyStatusState = "STATE_PARTIALLY_APPLIED"` - `const BulkWorkspaceApplyStatusStateStateFailed BulkWorkspaceApplyStatusState = "STATE_FAILED"` - `const BulkWorkspaceApplyStatusStateStateCancelled BulkWorkspaceApplyStatusState = "STATE_CANCELLED"` - `Message string` - `PreflightError BulkWorkspaceApplyStatusPreflightError` The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). - `Code int64` The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. - `Details []BulkWorkspaceApplyStatusPreflightErrorDetail` A list of messages that carry the error details. There is a common set of message types for APIs to use. - `Type string` The type of the serialized message. - `Message string` A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. - `Info BulkWorkspaceApplyInfo` - `CompletedAt Time` - `CreatedBy Profile` A profile identifies a user or non-human principal (such as an API key) at the account level. Profiles are account-scoped and can be granted access to multiple workspaces. - `Metadata AccountResourceMetadata` AccountResourceMetadata is used to represent a resource that is associated to an account but not to a workspace. - `ID string` Unique identifier for the resource (prefixed ULID, e.g., "apikey_01HXK...") - `AccountID string` Account this resource belongs to for multi-tenant isolation (prefixed ULID) - `Name string` Human-readable name for the resource (e.g., "Customer Support Agent", "Email Tool") Required for resources that users interact with directly - `ProfileID string` - `ExternalID string` External ID for the resource (e.g., a workflow ID from an external system) - `Labels map[string, string]` Arbitrary key-value pairs for categorization and filtering Examples: {"environment": "production", "team": "platform", "version": "v2"} - `Spec ProfileSpec` Configuration for a profile. - `Type ProfileSpecType` Whether this profile represents a human user, an API key, or a system principal. - `const ProfileSpecTypeProfileTypeUnspecified ProfileSpecType = "PROFILE_TYPE_UNSPECIFIED"` - `const ProfileSpecTypeProfileTypeUser ProfileSpecType = "PROFILE_TYPE_USER"` - `const ProfileSpecTypeProfileTypeAPIKey ProfileSpecType = "PROFILE_TYPE_API_KEY"` - `const ProfileSpecTypeProfileTypeSystem ProfileSpecType = "PROFILE_TYPE_SYSTEM"` - `Email string` Email address of the profile. Required and unique within an account for user profiles. - `Name string` Display name (e.g., "Bobby Tables"). - `CreatedCount int64` - `DeletedCount int64` - `FailedCount int64` - `StartedAt Time` - `TotalCount int64` - `UnchangedCount int64` - `UpdatedCount int64` ### Example ```go package main import ( "context" "fmt" "github.com/cadenya/cadenya-go" "github.com/cadenya/cadenya-go/option" ) func main() { client := cadenya.NewClient( option.WithAPIKey("My API Key"), ) page, err := client.BulkWorkspaceResources.List( context.TODO(), "workspaceId", cadenya.BulkWorkspaceResourceListParams{ }, ) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", page) } ``` #### Response ```json { "items": [ { "data": { "bundleKey": "bundleKey", "agents": { "foo": { "name": "name", "spec": { "status": "AGENT_STATUS_UNSPECIFIED", "variationSelectionMode": "VARIATION_SELECTION_MODE_UNSPECIFIED", "description": "description", "inputDataSchema": { "foo": "bar" }, "outputDefinition": { "foo": "bar" }, "webhookEventsUrl": "webhookEventsUrl" }, "labels": { "foo": "string" }, "schedules": { "foo": { "name": "name", "spec": { "initialMessage": "initialMessage", "schedule": { "calendars": [ { "comment": "comment", "dayOfMonth": [ { "end": 0, "start": 0, "step": 0 } ], "dayOfWeek": [ { "end": 0, "start": 0, "step": 0 } ], "hour": [ { "end": 0, "start": 0, "step": 0 } ], "minute": [ { "end": 0, "start": 0, "step": 0 } ], "month": [ { "end": 0, "start": 0, "step": 0 } ], "second": [ { "end": 0, "start": 0, "step": 0 } ] } ], "intervals": [ { "every": "-160513s", "offset": "-160513s" } ], "timezone": "timezone" }, "data": {}, "overlapPolicy": "OVERLAP_POLICY_UNSPECIFIED", "status": "AGENT_SCHEDULE_STATUS_UNSPECIFIED", "variationId": "variationId" }, "labels": { "foo": "string" } } }, "variations": { "foo": { "name": "name", "spec": { "compactionConfig": { "summarization": { "instructions": "instructions" }, "toolResultClearing": { "preserveRecentResults": 0 }, "triggerThreshold": 0 }, "constraints": { "maxSubObjectives": 0, "maxToolCalls": 0 }, "description": "description", "enableEpisodicMemory": true, "episodicMemoryTtl": 0, "modelConfig": { "modelId": "modelId", "temperature": 0 }, "progressiveDiscovery": { "hints": [ "string" ], "maxTools": 0, "rerankThreshold": 0 }, "prompt": "prompt", "weight": 0 }, "assignments": [ { "subAgentId": "subAgentId", "toolId": "toolId", "toolSetId": "toolSetId" } ], "labels": { "foo": "string" }, "memoryLayers": [ { "memoryLayerId": "memoryLayerId", "position": 0 } ] } } } }, "automaticallyPublishAgents": true, "memoryLayers": { "foo": { "name": "name", "spec": { "type": "MEMORY_LAYER_TYPE_UNSPECIFIED", "description": "description", "expiresAt": "2019-12-27T18:11:19.117Z", "systemManaged": true }, "entries": { "foo": { "key": "key", "content": "content", "description": "description", "uploadId": "uploadId" } }, "labels": { "foo": "string" } } }, "sourceUrl": "sourceUrl", "toolSets": { "foo": { "name": "name", "spec": { "adapter": { "http": { "baseUrl": "baseUrl", "headers": { "foo": "string" } }, "mcp": { "excludeTools": { "operator": "OPERATOR_UNSPECIFIED", "filters": [ { "attribute": "ATTRIBUTE_UNSPECIFIED", "matcher": { "caseSensitive": true, "contains": "contains", "endsWith": "endsWith", "exact": "exact", "regex": "regex", "startsWith": "startsWith" } } ] }, "headers": { "foo": "string" }, "includeTools": { "operator": "OPERATOR_UNSPECIFIED", "filters": [ { "attribute": "ATTRIBUTE_UNSPECIFIED", "matcher": { "caseSensitive": true, "contains": "contains", "endsWith": "endsWith", "exact": "exact", "regex": "regex", "startsWith": "startsWith" } } ] }, "toolApprovals": { "always": true, "only": { "operator": "OPERATOR_UNSPECIFIED", "filters": [ { "attribute": "ATTRIBUTE_UNSPECIFIED", "matcher": { "caseSensitive": true, "contains": "contains", "endsWith": "endsWith", "exact": "exact", "regex": "regex", "startsWith": "startsWith" } } ] } }, "url": "url" }, "openapi": { "baseUrl": "baseUrl", "excludeTools": { "operator": "OPERATOR_UNSPECIFIED", "filters": [ { "attribute": "ATTRIBUTE_UNSPECIFIED", "matcher": { "caseSensitive": true, "contains": "contains", "endsWith": "endsWith", "exact": "exact", "regex": "regex", "startsWith": "startsWith" } } ] }, "headers": { "foo": "string" }, "includeTools": { "operator": "OPERATOR_UNSPECIFIED", "filters": [ { "attribute": "ATTRIBUTE_UNSPECIFIED", "matcher": { "caseSensitive": true, "contains": "contains", "endsWith": "endsWith", "exact": "exact", "regex": "regex", "startsWith": "startsWith" } } ] }, "serverName": "serverName", "toolApprovals": { "always": true, "only": { "operator": "OPERATOR_UNSPECIFIED", "filters": [ { "attribute": "ATTRIBUTE_UNSPECIFIED", "matcher": { "caseSensitive": true, "contains": "contains", "endsWith": "endsWith", "exact": "exact", "regex": "regex", "startsWith": "startsWith" } } ] } }, "uploadId": "uploadId", "url": "url" } }, "description": "description" }, "labels": { "foo": "string" }, "tools": { "foo": { "name": "name", "spec": { "config": { "http": { "requestMethod": "HTTP_METHOD_UNSPECIFIED", "headers": { "foo": "string" }, "path": "path", "query": "query", "requestBodyContentType": "requestBodyContentType", "requestBodyTemplate": "requestBodyTemplate", "toolName": "toolName" }, "mcp": { "toolDescription": "toolDescription", "toolName": "toolName", "toolTitle": "toolTitle" }, "openapi": { "method": "method", "operationId": "operationId", "path": "path" } }, "description": "description", "parameters": { "foo": "bar" }, "status": "TOOL_STATUS_UNSPECIFIED", "requiresApproval": true }, "labels": { "foo": "string" } } } } } }, "metadata": { "id": "id", "accountId": "accountId", "createdAt": "2019-12-27T18:11:19.117Z", "profileId": "profileId", "workspaceId": "workspaceId", "externalId": "externalId", "labels": { "foo": "string" } }, "status": { "state": "STATE_UNSPECIFIED", "message": "message", "preflightError": { "code": 0, "details": [ { "@type": "@type" } ], "message": "message" } }, "info": { "completedAt": "2019-12-27T18:11:19.117Z", "createdBy": { "metadata": { "id": "id", "accountId": "accountId", "name": "name", "profileId": "profileId", "externalId": "externalId", "labels": { "foo": "string" } }, "spec": { "type": "PROFILE_TYPE_UNSPECIFIED", "email": "email", "name": "name" } }, "createdCount": 0, "deletedCount": 0, "failedCount": 0, "startedAt": "2019-12-27T18:11:19.117Z", "totalCount": 0, "unchangedCount": 0, "updatedCount": 0 } } ], "pagination": { "nextCursor": "nextCursor", "total": 0 } } ``` ## Domain Types ### Agent Entry - `type AgentEntry struct{…}` - `Name string` - `Spec AgentSpec` Agent specification (user-provided configuration) - `Status AgentSpecStatus` Status of the agent - `const AgentSpecStatusAgentStatusUnspecified AgentSpecStatus = "AGENT_STATUS_UNSPECIFIED"` - `const AgentSpecStatusAgentStatusDraft AgentSpecStatus = "AGENT_STATUS_DRAFT"` - `const AgentSpecStatusAgentStatusPublished AgentSpecStatus = "AGENT_STATUS_PUBLISHED"` - `const AgentSpecStatusAgentStatusArchived AgentSpecStatus = "AGENT_STATUS_ARCHIVED"` - `VariationSelectionMode AgentSpecVariationSelectionMode` Controls how variations are automatically selected when creating objectives Defaults to RANDOM when unspecified - `const AgentSpecVariationSelectionModeVariationSelectionModeUnspecified AgentSpecVariationSelectionMode = "VARIATION_SELECTION_MODE_UNSPECIFIED"` - `const AgentSpecVariationSelectionModeVariationSelectionModeRandom AgentSpecVariationSelectionMode = "VARIATION_SELECTION_MODE_RANDOM"` - `const AgentSpecVariationSelectionModeVariationSelectionModeWeighted AgentSpecVariationSelectionMode = "VARIATION_SELECTION_MODE_WEIGHTED"` - `Description string` Description of the agent's purpose - `InputDataSchema map[string, unknown]` InputDataSchema is used for enforcing a data input when objectives are created. This is valuable when using liquid formatting in agent variation prompts. Input data schema is also valuable when using an agent as a sub-agent, as the schema is used as the tool's input parameter schema. If omitted, the sub-agent schema will be loaded with a simple "prompt" free text string as its schema. - `OutputDefinition map[string, unknown]` Optional output definition for objectives created for this agent. When provided, Cadenya will append a tool to that will be called by the LLM in use by the variant to extract information in the format provided here. Use this option when you want structured data to be created by your objectives. - `WebhookEventsURL string` The URL that Cadenya will send events for any objective assigned to the agent. - `Labels map[string, string]` - `Schedules map[string, AgentScheduleEntry]` Schedules under this agent, keyed by external_id. - `Name string` - `Spec AgentScheduleSpec` AgentScheduleSpec is the user-provided configuration for a schedule. - `InitialMessage string` The initial message passed to CreateObjective on each fire. Becomes the first user message in the objective's chat history. - `Schedule AgentScheduleSpecSchedule` Schedule defines WHEN the schedule fires. Temporal-style structured form: a list of calendar rules (wall-clock) and/or interval rules (duration), OR'd together. At least one rule is required. - `Calendars []ScheduleCalendar` Wall-clock rules. May be empty if `intervals` is non-empty. - `Comment string` - `DayOfMonth []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `DayOfWeek []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Hour []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Minute []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Month []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Second []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Intervals []ScheduleInterval` Duration-based rules. May be empty if `calendars` is non-empty. - `Every string` - `Offset string` Phase shift within `every`. Must be < `every` (enforced at runtime). - `Timezone string` IANA tz name (e.g. "America/New_York"). Required. Applies to calendars; intervals fire on wall-clock cadence anchored in this zone. - `Data unknown` Optional input data passed to the objective. If the agent has an input_data_schema, this must satisfy it. - `OverlapPolicy AgentScheduleSpecOverlapPolicy` What to do when the previous run is still in flight. Defaults to SKIP. - `const AgentScheduleSpecOverlapPolicyOverlapPolicyUnspecified AgentScheduleSpecOverlapPolicy = "OVERLAP_POLICY_UNSPECIFIED"` - `const AgentScheduleSpecOverlapPolicyOverlapPolicyAllow AgentScheduleSpecOverlapPolicy = "OVERLAP_POLICY_ALLOW"` - `const AgentScheduleSpecOverlapPolicyOverlapPolicySkip AgentScheduleSpecOverlapPolicy = "OVERLAP_POLICY_SKIP"` - `Status AgentScheduleSpecStatus` Lifecycle. Defaults to ACTIVE on create when unspecified. - `const AgentScheduleSpecStatusAgentScheduleStatusUnspecified AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_UNSPECIFIED"` - `const AgentScheduleSpecStatusAgentScheduleStatusActive AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_ACTIVE"` - `const AgentScheduleSpecStatusAgentScheduleStatusPaused AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_PAUSED"` - `const AgentScheduleSpecStatusAgentScheduleStatusArchived AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_ARCHIVED"` - `VariationID string` Optional explicit variation. When unset, the agent's variation_selection_mode chooses per fire. - `Labels map[string, string]` - `Variations map[string, AgentVariationEntry]` Variations under this agent, keyed by external_id. - `Name string` - `Spec AgentVariationSpec` AgentVariationSpec defines the operational configuration for a variation - `CompactionConfig AgentVariationSpecCompactionConfig` CompactionConfig defines how context window compaction behaves for objectives using this variation. - `Summarization CompactionConfigSummarizationStrategy` SummarizationStrategy configures LLM-powered summarization of older conversation turns. - `Instructions string` Custom instructions that guide what the summarizer preserves. Replaces the default summarization prompt entirely. Example: "Preserve all code snippets, variable names, and technical decisions." - `ToolResultClearing CompactionConfigToolResultClearingStrategy` ToolResultClearingStrategy configures clearing of older tool result content. - `PreserveRecentResults int64` Number of most recent tool call results to keep intact. Older tool results have their content replaced with "[result cleared]" while preserving the assistant tool call message (function name, arguments). Default: 2 - `TriggerThreshold float64` Trigger threshold as a percentage of the model's context window (0.0 to 1.0). When input tokens reach this percentage of the model's limit, compaction triggers. Default: 0.75 (75%) - `Constraints AgentVariationSpecConstraints` Execution constraints - `MaxSubObjectives int64` The maximum number of sub-objectives that can be created. 0 means no limit. - `MaxToolCalls int64` The maximum number of tool calls that can be made. 0 means no limit. - `Description string` Human-readable description of what this variation does or when it should be used - `EnableEpisodicMemory bool` Enable episodic memory for objectives using this variation. When true, the system automatically creates a document namespace for each objective using the objective's episodic_key as the external_id, allowing the agent to store and retrieve documents specific to that episode. - `EpisodicMemoryTtl int64` How long episodic memories should be retained. After this duration, episodic document namespaces can be automatically cleaned up. If not set, episodic memories are retained indefinitely. - `ModelConfig AgentVariationSpecModelConfig` ModelConfig defines the model configuration for a variation - `ModelID string` The model identifier in family/model format (e.g., "claude/opus-4.6", "claude/sonnet-4.5") - `Temperature float64` Sampling temperature for model inference (0.0 to 1.0) Lower values produce more deterministic outputs, higher values increase randomness - `ProgressiveDiscovery AgentVariationSpecProgressiveDiscovery` ProgressiveDiscovery is used to indicate that the agent should automatically discover tools that are not explicitly assigned to it. Max tools is the maximum number of tools that can be discovered per search. Hints are optional hints for tool search. These are used in conjunction with the context-aware tool search and can help select the best tools for the task. - `Hints []string` - `MaxTools int64` - `RerankThreshold float64` Rerank Threshold is an optional value that instructs whether or not to run a search result through a embedding/reranker process which can improve performance and reduce context bloat when tools reach the configured threshold. If a tool match must exceed 0.8, for example, the tool very closely match the query the tool search performed. - `Prompt string` The system prompt for this variation - `Weight int64` Weight for weighted random selection (>= 0). P(v) = v.weight / sum(all_weights). Only used when the agent's variation_selection_mode is WEIGHTED. A weight of 0 means never auto-selected, but can still be chosen explicitly via variation_id on CreateObjectiveRequest. - `Assignments []VariationAssignmentEntry` Reconciled list — server adjusts the variation's assignments to exactly this set when the variation is bundle-owned. - `SubAgentID string` - `ToolID string` - `ToolSetID string` - `Labels map[string, string]` - `MemoryLayers []VariationMemoryLayerEntry` Reconciled list of memory layer assignments. Up to 10 entries. - `MemoryLayerID string` external_id: form. Canonical IDs are rejected. - `Position int64` ### Agent Schedule Entry - `type AgentScheduleEntry struct{…}` - `Name string` - `Spec AgentScheduleSpec` AgentScheduleSpec is the user-provided configuration for a schedule. - `InitialMessage string` The initial message passed to CreateObjective on each fire. Becomes the first user message in the objective's chat history. - `Schedule AgentScheduleSpecSchedule` Schedule defines WHEN the schedule fires. Temporal-style structured form: a list of calendar rules (wall-clock) and/or interval rules (duration), OR'd together. At least one rule is required. - `Calendars []ScheduleCalendar` Wall-clock rules. May be empty if `intervals` is non-empty. - `Comment string` - `DayOfMonth []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `DayOfWeek []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Hour []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Minute []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Month []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Second []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Intervals []ScheduleInterval` Duration-based rules. May be empty if `calendars` is non-empty. - `Every string` - `Offset string` Phase shift within `every`. Must be < `every` (enforced at runtime). - `Timezone string` IANA tz name (e.g. "America/New_York"). Required. Applies to calendars; intervals fire on wall-clock cadence anchored in this zone. - `Data unknown` Optional input data passed to the objective. If the agent has an input_data_schema, this must satisfy it. - `OverlapPolicy AgentScheduleSpecOverlapPolicy` What to do when the previous run is still in flight. Defaults to SKIP. - `const AgentScheduleSpecOverlapPolicyOverlapPolicyUnspecified AgentScheduleSpecOverlapPolicy = "OVERLAP_POLICY_UNSPECIFIED"` - `const AgentScheduleSpecOverlapPolicyOverlapPolicyAllow AgentScheduleSpecOverlapPolicy = "OVERLAP_POLICY_ALLOW"` - `const AgentScheduleSpecOverlapPolicyOverlapPolicySkip AgentScheduleSpecOverlapPolicy = "OVERLAP_POLICY_SKIP"` - `Status AgentScheduleSpecStatus` Lifecycle. Defaults to ACTIVE on create when unspecified. - `const AgentScheduleSpecStatusAgentScheduleStatusUnspecified AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_UNSPECIFIED"` - `const AgentScheduleSpecStatusAgentScheduleStatusActive AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_ACTIVE"` - `const AgentScheduleSpecStatusAgentScheduleStatusPaused AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_PAUSED"` - `const AgentScheduleSpecStatusAgentScheduleStatusArchived AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_ARCHIVED"` - `VariationID string` Optional explicit variation. When unset, the agent's variation_selection_mode chooses per fire. - `Labels map[string, string]` ### Agent Variation Entry - `type AgentVariationEntry struct{…}` - `Name string` - `Spec AgentVariationSpec` AgentVariationSpec defines the operational configuration for a variation - `CompactionConfig AgentVariationSpecCompactionConfig` CompactionConfig defines how context window compaction behaves for objectives using this variation. - `Summarization CompactionConfigSummarizationStrategy` SummarizationStrategy configures LLM-powered summarization of older conversation turns. - `Instructions string` Custom instructions that guide what the summarizer preserves. Replaces the default summarization prompt entirely. Example: "Preserve all code snippets, variable names, and technical decisions." - `ToolResultClearing CompactionConfigToolResultClearingStrategy` ToolResultClearingStrategy configures clearing of older tool result content. - `PreserveRecentResults int64` Number of most recent tool call results to keep intact. Older tool results have their content replaced with "[result cleared]" while preserving the assistant tool call message (function name, arguments). Default: 2 - `TriggerThreshold float64` Trigger threshold as a percentage of the model's context window (0.0 to 1.0). When input tokens reach this percentage of the model's limit, compaction triggers. Default: 0.75 (75%) - `Constraints AgentVariationSpecConstraints` Execution constraints - `MaxSubObjectives int64` The maximum number of sub-objectives that can be created. 0 means no limit. - `MaxToolCalls int64` The maximum number of tool calls that can be made. 0 means no limit. - `Description string` Human-readable description of what this variation does or when it should be used - `EnableEpisodicMemory bool` Enable episodic memory for objectives using this variation. When true, the system automatically creates a document namespace for each objective using the objective's episodic_key as the external_id, allowing the agent to store and retrieve documents specific to that episode. - `EpisodicMemoryTtl int64` How long episodic memories should be retained. After this duration, episodic document namespaces can be automatically cleaned up. If not set, episodic memories are retained indefinitely. - `ModelConfig AgentVariationSpecModelConfig` ModelConfig defines the model configuration for a variation - `ModelID string` The model identifier in family/model format (e.g., "claude/opus-4.6", "claude/sonnet-4.5") - `Temperature float64` Sampling temperature for model inference (0.0 to 1.0) Lower values produce more deterministic outputs, higher values increase randomness - `ProgressiveDiscovery AgentVariationSpecProgressiveDiscovery` ProgressiveDiscovery is used to indicate that the agent should automatically discover tools that are not explicitly assigned to it. Max tools is the maximum number of tools that can be discovered per search. Hints are optional hints for tool search. These are used in conjunction with the context-aware tool search and can help select the best tools for the task. - `Hints []string` - `MaxTools int64` - `RerankThreshold float64` Rerank Threshold is an optional value that instructs whether or not to run a search result through a embedding/reranker process which can improve performance and reduce context bloat when tools reach the configured threshold. If a tool match must exceed 0.8, for example, the tool very closely match the query the tool search performed. - `Prompt string` The system prompt for this variation - `Weight int64` Weight for weighted random selection (>= 0). P(v) = v.weight / sum(all_weights). Only used when the agent's variation_selection_mode is WEIGHTED. A weight of 0 means never auto-selected, but can still be chosen explicitly via variation_id on CreateObjectiveRequest. - `Assignments []VariationAssignmentEntry` Reconciled list — server adjusts the variation's assignments to exactly this set when the variation is bundle-owned. - `SubAgentID string` - `ToolID string` - `ToolSetID string` - `Labels map[string, string]` - `MemoryLayers []VariationMemoryLayerEntry` Reconciled list of memory layer assignments. Up to 10 entries. - `MemoryLayerID string` external_id: form. Canonical IDs are rejected. - `Position int64` ### Bulk Workspace Apply - `type BulkWorkspaceApply struct{…}` The operation resource produced by a call to BulkWorkspaceResources.Apply. It carries the input bundle in `data`, the lifecycle state in `status`, and aggregate counts in `info`. - `Data BulkWorkspaceApplyData` - `BundleKey string` Required. Bundle ownership key. Resources created or updated by an Apply have their `metadata.bundle_key` set to this value. On subsequent applies with the same bundle_key, resources currently bearing this bundle_key but absent from the spec are soft-deleted. - `Agents map[string, AgentEntry]` Agents to upsert, keyed by external_id. - `Name string` - `Spec AgentSpec` Agent specification (user-provided configuration) - `Status AgentSpecStatus` Status of the agent - `const AgentSpecStatusAgentStatusUnspecified AgentSpecStatus = "AGENT_STATUS_UNSPECIFIED"` - `const AgentSpecStatusAgentStatusDraft AgentSpecStatus = "AGENT_STATUS_DRAFT"` - `const AgentSpecStatusAgentStatusPublished AgentSpecStatus = "AGENT_STATUS_PUBLISHED"` - `const AgentSpecStatusAgentStatusArchived AgentSpecStatus = "AGENT_STATUS_ARCHIVED"` - `VariationSelectionMode AgentSpecVariationSelectionMode` Controls how variations are automatically selected when creating objectives Defaults to RANDOM when unspecified - `const AgentSpecVariationSelectionModeVariationSelectionModeUnspecified AgentSpecVariationSelectionMode = "VARIATION_SELECTION_MODE_UNSPECIFIED"` - `const AgentSpecVariationSelectionModeVariationSelectionModeRandom AgentSpecVariationSelectionMode = "VARIATION_SELECTION_MODE_RANDOM"` - `const AgentSpecVariationSelectionModeVariationSelectionModeWeighted AgentSpecVariationSelectionMode = "VARIATION_SELECTION_MODE_WEIGHTED"` - `Description string` Description of the agent's purpose - `InputDataSchema map[string, unknown]` InputDataSchema is used for enforcing a data input when objectives are created. This is valuable when using liquid formatting in agent variation prompts. Input data schema is also valuable when using an agent as a sub-agent, as the schema is used as the tool's input parameter schema. If omitted, the sub-agent schema will be loaded with a simple "prompt" free text string as its schema. - `OutputDefinition map[string, unknown]` Optional output definition for objectives created for this agent. When provided, Cadenya will append a tool to that will be called by the LLM in use by the variant to extract information in the format provided here. Use this option when you want structured data to be created by your objectives. - `WebhookEventsURL string` The URL that Cadenya will send events for any objective assigned to the agent. - `Labels map[string, string]` - `Schedules map[string, AgentScheduleEntry]` Schedules under this agent, keyed by external_id. - `Name string` - `Spec AgentScheduleSpec` AgentScheduleSpec is the user-provided configuration for a schedule. - `InitialMessage string` The initial message passed to CreateObjective on each fire. Becomes the first user message in the objective's chat history. - `Schedule AgentScheduleSpecSchedule` Schedule defines WHEN the schedule fires. Temporal-style structured form: a list of calendar rules (wall-clock) and/or interval rules (duration), OR'd together. At least one rule is required. - `Calendars []ScheduleCalendar` Wall-clock rules. May be empty if `intervals` is non-empty. - `Comment string` - `DayOfMonth []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `DayOfWeek []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Hour []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Minute []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Month []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Second []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Intervals []ScheduleInterval` Duration-based rules. May be empty if `calendars` is non-empty. - `Every string` - `Offset string` Phase shift within `every`. Must be < `every` (enforced at runtime). - `Timezone string` IANA tz name (e.g. "America/New_York"). Required. Applies to calendars; intervals fire on wall-clock cadence anchored in this zone. - `Data unknown` Optional input data passed to the objective. If the agent has an input_data_schema, this must satisfy it. - `OverlapPolicy AgentScheduleSpecOverlapPolicy` What to do when the previous run is still in flight. Defaults to SKIP. - `const AgentScheduleSpecOverlapPolicyOverlapPolicyUnspecified AgentScheduleSpecOverlapPolicy = "OVERLAP_POLICY_UNSPECIFIED"` - `const AgentScheduleSpecOverlapPolicyOverlapPolicyAllow AgentScheduleSpecOverlapPolicy = "OVERLAP_POLICY_ALLOW"` - `const AgentScheduleSpecOverlapPolicyOverlapPolicySkip AgentScheduleSpecOverlapPolicy = "OVERLAP_POLICY_SKIP"` - `Status AgentScheduleSpecStatus` Lifecycle. Defaults to ACTIVE on create when unspecified. - `const AgentScheduleSpecStatusAgentScheduleStatusUnspecified AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_UNSPECIFIED"` - `const AgentScheduleSpecStatusAgentScheduleStatusActive AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_ACTIVE"` - `const AgentScheduleSpecStatusAgentScheduleStatusPaused AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_PAUSED"` - `const AgentScheduleSpecStatusAgentScheduleStatusArchived AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_ARCHIVED"` - `VariationID string` Optional explicit variation. When unset, the agent's variation_selection_mode chooses per fire. - `Labels map[string, string]` - `Variations map[string, AgentVariationEntry]` Variations under this agent, keyed by external_id. - `Name string` - `Spec AgentVariationSpec` AgentVariationSpec defines the operational configuration for a variation - `CompactionConfig AgentVariationSpecCompactionConfig` CompactionConfig defines how context window compaction behaves for objectives using this variation. - `Summarization CompactionConfigSummarizationStrategy` SummarizationStrategy configures LLM-powered summarization of older conversation turns. - `Instructions string` Custom instructions that guide what the summarizer preserves. Replaces the default summarization prompt entirely. Example: "Preserve all code snippets, variable names, and technical decisions." - `ToolResultClearing CompactionConfigToolResultClearingStrategy` ToolResultClearingStrategy configures clearing of older tool result content. - `PreserveRecentResults int64` Number of most recent tool call results to keep intact. Older tool results have their content replaced with "[result cleared]" while preserving the assistant tool call message (function name, arguments). Default: 2 - `TriggerThreshold float64` Trigger threshold as a percentage of the model's context window (0.0 to 1.0). When input tokens reach this percentage of the model's limit, compaction triggers. Default: 0.75 (75%) - `Constraints AgentVariationSpecConstraints` Execution constraints - `MaxSubObjectives int64` The maximum number of sub-objectives that can be created. 0 means no limit. - `MaxToolCalls int64` The maximum number of tool calls that can be made. 0 means no limit. - `Description string` Human-readable description of what this variation does or when it should be used - `EnableEpisodicMemory bool` Enable episodic memory for objectives using this variation. When true, the system automatically creates a document namespace for each objective using the objective's episodic_key as the external_id, allowing the agent to store and retrieve documents specific to that episode. - `EpisodicMemoryTtl int64` How long episodic memories should be retained. After this duration, episodic document namespaces can be automatically cleaned up. If not set, episodic memories are retained indefinitely. - `ModelConfig AgentVariationSpecModelConfig` ModelConfig defines the model configuration for a variation - `ModelID string` The model identifier in family/model format (e.g., "claude/opus-4.6", "claude/sonnet-4.5") - `Temperature float64` Sampling temperature for model inference (0.0 to 1.0) Lower values produce more deterministic outputs, higher values increase randomness - `ProgressiveDiscovery AgentVariationSpecProgressiveDiscovery` ProgressiveDiscovery is used to indicate that the agent should automatically discover tools that are not explicitly assigned to it. Max tools is the maximum number of tools that can be discovered per search. Hints are optional hints for tool search. These are used in conjunction with the context-aware tool search and can help select the best tools for the task. - `Hints []string` - `MaxTools int64` - `RerankThreshold float64` Rerank Threshold is an optional value that instructs whether or not to run a search result through a embedding/reranker process which can improve performance and reduce context bloat when tools reach the configured threshold. If a tool match must exceed 0.8, for example, the tool very closely match the query the tool search performed. - `Prompt string` The system prompt for this variation - `Weight int64` Weight for weighted random selection (>= 0). P(v) = v.weight / sum(all_weights). Only used when the agent's variation_selection_mode is WEIGHTED. A weight of 0 means never auto-selected, but can still be chosen explicitly via variation_id on CreateObjectiveRequest. - `Assignments []VariationAssignmentEntry` Reconciled list — server adjusts the variation's assignments to exactly this set when the variation is bundle-owned. - `SubAgentID string` - `ToolID string` - `ToolSetID string` - `Labels map[string, string]` - `MemoryLayers []VariationMemoryLayerEntry` Reconciled list of memory layer assignments. Up to 10 entries. - `MemoryLayerID string` external_id: form. Canonical IDs are rejected. - `Position int64` - `AutomaticallyPublishAgents bool` When true, every agent created or updated by this Apply has its status forced to AGENT_STATUS_PUBLISHED, regardless of the status declared in the agent's AgentSpec. Useful when the bundle represents a production configuration and you want all of its agents live without setting status: AGENT_STATUS_PUBLISHED on each entry. Default false: each agent's AgentSpec.status controls (which is AGENT_STATUS_DRAFT on create when unspecified). - `MemoryLayers map[string, MemoryLayerEntry]` Memory layers to upsert, keyed by external_id. - `Name string` - `Spec MemoryLayerSpec` - `Type MemoryLayerSpecType` - `const MemoryLayerSpecTypeMemoryLayerTypeUnspecified MemoryLayerSpecType = "MEMORY_LAYER_TYPE_UNSPECIFIED"` - `const MemoryLayerSpecTypeMemoryLayerTypeEpisodic MemoryLayerSpecType = "MEMORY_LAYER_TYPE_EPISODIC"` - `const MemoryLayerSpecTypeMemoryLayerTypeSkills MemoryLayerSpecType = "MEMORY_LAYER_TYPE_SKILLS"` - `Description string` Human-readable description of the layer's purpose. Encouraged for user-created layers; system-managed layers may have a generated description. - `ExpiresAt Time` For layers with a finite lifetime (e.g., episodic), the time at which the layer becomes eligible for cleanup. Set by the system; unset for persistent layers. - `SystemManaged bool` Server-set. True for layers managed by the system (e.g., episodic layers created automatically when an objective uses an episodic_key). System-managed layers cannot be assigned to objective stacks via the API and cannot be mutated by clients — their lifecycle is controlled entirely by the runtime. - `Entries map[string, MemoryEntryItem]` Memory entries in this layer, keyed by external_id. - `Key string` - `Content string` - `Description string` - `UploadID string` - `Labels map[string, string]` - `SourceURL string` Optional URL pointing to the source of this apply (GitHub PR, Jenkins build, GitLab pipeline, etc.). Surfaced in the dashboard so users can jump from an apply back to the change that produced it. Free-form HTTPS URI; not interpreted by the server. - `ToolSets map[string, ToolSetEntry]` Tool sets to upsert, keyed by external_id. - `Name string` - `Spec ToolSetSpec` - `Adapter ToolSetAdapter` - `HTTP ToolSetAdapterHTTP` - `BaseURL string` - `Headers map[string, string]` - `Mcp ToolSetAdapterMcp` - `ExcludeTools ToolFilter` Top-level filter with simple boolean logic (no nesting) - `Operator ToolFilterOperator` - `const ToolFilterOperatorOperatorUnspecified ToolFilterOperator = "OPERATOR_UNSPECIFIED"` - `const ToolFilterOperatorOperatorAnd ToolFilterOperator = "OPERATOR_AND"` - `const ToolFilterOperatorOperatorOr ToolFilterOperator = "OPERATOR_OR"` - `Filters []AttributeFilter` - `Attribute AttributeFilterAttribute` - `const AttributeFilterAttributeAttributeUnspecified AttributeFilterAttribute = "ATTRIBUTE_UNSPECIFIED"` - `const AttributeFilterAttributeAttributeName AttributeFilterAttribute = "ATTRIBUTE_NAME"` - `const AttributeFilterAttributeAttributeTitle AttributeFilterAttribute = "ATTRIBUTE_TITLE"` - `const AttributeFilterAttributeAttributeDescription AttributeFilterAttribute = "ATTRIBUTE_DESCRIPTION"` - `Matcher StringMatcher` String matching operations - `CaseSensitive bool` - `Contains string` - `EndsWith string` - `Exact string` - `Regex string` - `StartsWith string` - `Headers map[string, string]` - `IncludeTools ToolFilter` Top-level filter with simple boolean logic (no nesting) - `ToolApprovals ApprovalRequirementFilter` Approval filters that will automatically set the approval requirement on tools synced from an external source - `Always bool` - `Only ToolFilter` Top-level filter with simple boolean logic (no nesting) - `URL string` - `OpenAPI ToolSetAdapterOpenAPI` - `BaseURL string` Base URL for dispatching tool calls. If set, overrides the server resolved from the spec's servers array. - `ExcludeTools ToolFilter` Top-level filter with simple boolean logic (no nesting) - `Headers map[string, string]` Headers sent when fetching the spec from a URL and when dispatching tool calls. - `IncludeTools ToolFilter` Top-level filter with simple boolean logic (no nesting) - `ServerName string` Name of the server entry in the spec's servers array (OpenAPI 3.2 server.name field). Used to select which server URL to dispatch to when base_url is not set. If unset, the first server is used. Ignored when base_url is set. - `ToolApprovals ApprovalRequirementFilter` Approval filters that will automatically set the approval requirement on tools synced from an external source - `UploadID string` ID of a COMPLETE Upload containing the OpenAPI spec document. - `URL string` URL to fetch the OpenAPI spec from. Synced automatically every hour. - `Description string` - `Labels map[string, string]` - `Tools map[string, ToolEntry]` Tools in this tool set, keyed by external_id. - `Name string` - `Spec ToolSpec` - `Config ToolSpecConfig` Config defines the adapter to use for the tool. This is used to determine how the tool is called. For example, if the tool is an HTTP tool, the adapter will be Http. If the tool is an inline tool, the adapter will be Inline. - `HTTP ConfigHTTP` - `RequestMethod ConfigHTTPRequestMethod` - `const ConfigHTTPRequestMethodHTTPMethodUnspecified ConfigHTTPRequestMethod = "HTTP_METHOD_UNSPECIFIED"` - `const ConfigHTTPRequestMethodGet ConfigHTTPRequestMethod = "GET"` - `const ConfigHTTPRequestMethodPost ConfigHTTPRequestMethod = "POST"` - `const ConfigHTTPRequestMethodPut ConfigHTTPRequestMethod = "PUT"` - `const ConfigHTTPRequestMethodPatch ConfigHTTPRequestMethod = "PATCH"` - `const ConfigHTTPRequestMethodDelete ConfigHTTPRequestMethod = "DELETE"` - `Headers map[string, string]` - `Path string` - `Query string` - `RequestBodyContentType string` - `RequestBodyTemplate string` These are only used when the request method is a POST, PUT, or PATCH - `ToolName string` The tool name (commonly an "operation id" in OpenAPI specs) to call on the HTTP adapter. This is used to match the tool spec to the correct endpoint on the HTTP adapter. it will be derived from the name of the tool if not provided. - `Mcp ConfigMcp` - `ToolDescription string` - `ToolName string` - `ToolTitle string` - `OpenAPI ConfigOpenAPI` - `Method string` - `OperationID string` - `Path string` - `Description string` - `Parameters map[string, unknown]` - `Status ToolSpecStatus` - `const ToolSpecStatusToolStatusUnspecified ToolSpecStatus = "TOOL_STATUS_UNSPECIFIED"` - `const ToolSpecStatusToolStatusAvailable ToolSpecStatus = "TOOL_STATUS_AVAILABLE"` - `const ToolSpecStatusToolStatusOmitted ToolSpecStatus = "TOOL_STATUS_OMITTED"` - `const ToolSpecStatusToolStatusArchived ToolSpecStatus = "TOOL_STATUS_ARCHIVED"` - `RequiresApproval bool` - `Labels map[string, string]` - `Metadata OperationMetadata` Metadata for ephemeral operations and activities (e.g., objectives, executions, runs) - `ID string` Unique identifier for the operation (prefixed ULID, e.g., "obj_01HXK...") - `AccountID string` Account this operation belongs to for multi-tenant isolation (prefixed ULID) - `CreatedAt Time` Timestamp when this operation was created ULID includes timestamp information, but this explicit field enables easier querying - `ProfileID string` ID of the actor (user or service account) that created this operation - `WorkspaceID string` Workspace this operation belongs to for organizational grouping (prefixed ULID) - `ExternalID string` External ID for the operation (e.g., a workflow ID from an external system) - `Labels map[string, string]` Arbitrary key-value pairs for categorization and filtering Examples: {"priority": "high", "source": "api", "workflow": "onboarding"} - `Status BulkWorkspaceApplyStatus` - `State BulkWorkspaceApplyStatusState` - `const BulkWorkspaceApplyStatusStateStateUnspecified BulkWorkspaceApplyStatusState = "STATE_UNSPECIFIED"` - `const BulkWorkspaceApplyStatusStateStatePending BulkWorkspaceApplyStatusState = "STATE_PENDING"` - `const BulkWorkspaceApplyStatusStateStateValidating BulkWorkspaceApplyStatusState = "STATE_VALIDATING"` - `const BulkWorkspaceApplyStatusStateStateRunning BulkWorkspaceApplyStatusState = "STATE_RUNNING"` - `const BulkWorkspaceApplyStatusStateStateSucceeded BulkWorkspaceApplyStatusState = "STATE_SUCCEEDED"` - `const BulkWorkspaceApplyStatusStateStatePartiallyApplied BulkWorkspaceApplyStatusState = "STATE_PARTIALLY_APPLIED"` - `const BulkWorkspaceApplyStatusStateStateFailed BulkWorkspaceApplyStatusState = "STATE_FAILED"` - `const BulkWorkspaceApplyStatusStateStateCancelled BulkWorkspaceApplyStatusState = "STATE_CANCELLED"` - `Message string` - `PreflightError BulkWorkspaceApplyStatusPreflightError` The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). - `Code int64` The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. - `Details []BulkWorkspaceApplyStatusPreflightErrorDetail` A list of messages that carry the error details. There is a common set of message types for APIs to use. - `Type string` The type of the serialized message. - `Message string` A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. - `Info BulkWorkspaceApplyInfo` - `CompletedAt Time` - `CreatedBy Profile` A profile identifies a user or non-human principal (such as an API key) at the account level. Profiles are account-scoped and can be granted access to multiple workspaces. - `Metadata AccountResourceMetadata` AccountResourceMetadata is used to represent a resource that is associated to an account but not to a workspace. - `ID string` Unique identifier for the resource (prefixed ULID, e.g., "apikey_01HXK...") - `AccountID string` Account this resource belongs to for multi-tenant isolation (prefixed ULID) - `Name string` Human-readable name for the resource (e.g., "Customer Support Agent", "Email Tool") Required for resources that users interact with directly - `ProfileID string` - `ExternalID string` External ID for the resource (e.g., a workflow ID from an external system) - `Labels map[string, string]` Arbitrary key-value pairs for categorization and filtering Examples: {"environment": "production", "team": "platform", "version": "v2"} - `Spec ProfileSpec` Configuration for a profile. - `Type ProfileSpecType` Whether this profile represents a human user, an API key, or a system principal. - `const ProfileSpecTypeProfileTypeUnspecified ProfileSpecType = "PROFILE_TYPE_UNSPECIFIED"` - `const ProfileSpecTypeProfileTypeUser ProfileSpecType = "PROFILE_TYPE_USER"` - `const ProfileSpecTypeProfileTypeAPIKey ProfileSpecType = "PROFILE_TYPE_API_KEY"` - `const ProfileSpecTypeProfileTypeSystem ProfileSpecType = "PROFILE_TYPE_SYSTEM"` - `Email string` Email address of the profile. Required and unique within an account for user profiles. - `Name string` Display name (e.g., "Bobby Tables"). - `CreatedCount int64` - `DeletedCount int64` - `FailedCount int64` - `StartedAt Time` - `TotalCount int64` - `UnchangedCount int64` - `UpdatedCount int64` ### Bulk Workspace Apply Data - `type BulkWorkspaceApplyData struct{…}` - `BundleKey string` Required. Bundle ownership key. Resources created or updated by an Apply have their `metadata.bundle_key` set to this value. On subsequent applies with the same bundle_key, resources currently bearing this bundle_key but absent from the spec are soft-deleted. - `Agents map[string, AgentEntry]` Agents to upsert, keyed by external_id. - `Name string` - `Spec AgentSpec` Agent specification (user-provided configuration) - `Status AgentSpecStatus` Status of the agent - `const AgentSpecStatusAgentStatusUnspecified AgentSpecStatus = "AGENT_STATUS_UNSPECIFIED"` - `const AgentSpecStatusAgentStatusDraft AgentSpecStatus = "AGENT_STATUS_DRAFT"` - `const AgentSpecStatusAgentStatusPublished AgentSpecStatus = "AGENT_STATUS_PUBLISHED"` - `const AgentSpecStatusAgentStatusArchived AgentSpecStatus = "AGENT_STATUS_ARCHIVED"` - `VariationSelectionMode AgentSpecVariationSelectionMode` Controls how variations are automatically selected when creating objectives Defaults to RANDOM when unspecified - `const AgentSpecVariationSelectionModeVariationSelectionModeUnspecified AgentSpecVariationSelectionMode = "VARIATION_SELECTION_MODE_UNSPECIFIED"` - `const AgentSpecVariationSelectionModeVariationSelectionModeRandom AgentSpecVariationSelectionMode = "VARIATION_SELECTION_MODE_RANDOM"` - `const AgentSpecVariationSelectionModeVariationSelectionModeWeighted AgentSpecVariationSelectionMode = "VARIATION_SELECTION_MODE_WEIGHTED"` - `Description string` Description of the agent's purpose - `InputDataSchema map[string, unknown]` InputDataSchema is used for enforcing a data input when objectives are created. This is valuable when using liquid formatting in agent variation prompts. Input data schema is also valuable when using an agent as a sub-agent, as the schema is used as the tool's input parameter schema. If omitted, the sub-agent schema will be loaded with a simple "prompt" free text string as its schema. - `OutputDefinition map[string, unknown]` Optional output definition for objectives created for this agent. When provided, Cadenya will append a tool to that will be called by the LLM in use by the variant to extract information in the format provided here. Use this option when you want structured data to be created by your objectives. - `WebhookEventsURL string` The URL that Cadenya will send events for any objective assigned to the agent. - `Labels map[string, string]` - `Schedules map[string, AgentScheduleEntry]` Schedules under this agent, keyed by external_id. - `Name string` - `Spec AgentScheduleSpec` AgentScheduleSpec is the user-provided configuration for a schedule. - `InitialMessage string` The initial message passed to CreateObjective on each fire. Becomes the first user message in the objective's chat history. - `Schedule AgentScheduleSpecSchedule` Schedule defines WHEN the schedule fires. Temporal-style structured form: a list of calendar rules (wall-clock) and/or interval rules (duration), OR'd together. At least one rule is required. - `Calendars []ScheduleCalendar` Wall-clock rules. May be empty if `intervals` is non-empty. - `Comment string` - `DayOfMonth []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `DayOfWeek []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Hour []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Minute []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Month []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Second []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Intervals []ScheduleInterval` Duration-based rules. May be empty if `calendars` is non-empty. - `Every string` - `Offset string` Phase shift within `every`. Must be < `every` (enforced at runtime). - `Timezone string` IANA tz name (e.g. "America/New_York"). Required. Applies to calendars; intervals fire on wall-clock cadence anchored in this zone. - `Data unknown` Optional input data passed to the objective. If the agent has an input_data_schema, this must satisfy it. - `OverlapPolicy AgentScheduleSpecOverlapPolicy` What to do when the previous run is still in flight. Defaults to SKIP. - `const AgentScheduleSpecOverlapPolicyOverlapPolicyUnspecified AgentScheduleSpecOverlapPolicy = "OVERLAP_POLICY_UNSPECIFIED"` - `const AgentScheduleSpecOverlapPolicyOverlapPolicyAllow AgentScheduleSpecOverlapPolicy = "OVERLAP_POLICY_ALLOW"` - `const AgentScheduleSpecOverlapPolicyOverlapPolicySkip AgentScheduleSpecOverlapPolicy = "OVERLAP_POLICY_SKIP"` - `Status AgentScheduleSpecStatus` Lifecycle. Defaults to ACTIVE on create when unspecified. - `const AgentScheduleSpecStatusAgentScheduleStatusUnspecified AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_UNSPECIFIED"` - `const AgentScheduleSpecStatusAgentScheduleStatusActive AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_ACTIVE"` - `const AgentScheduleSpecStatusAgentScheduleStatusPaused AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_PAUSED"` - `const AgentScheduleSpecStatusAgentScheduleStatusArchived AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_ARCHIVED"` - `VariationID string` Optional explicit variation. When unset, the agent's variation_selection_mode chooses per fire. - `Labels map[string, string]` - `Variations map[string, AgentVariationEntry]` Variations under this agent, keyed by external_id. - `Name string` - `Spec AgentVariationSpec` AgentVariationSpec defines the operational configuration for a variation - `CompactionConfig AgentVariationSpecCompactionConfig` CompactionConfig defines how context window compaction behaves for objectives using this variation. - `Summarization CompactionConfigSummarizationStrategy` SummarizationStrategy configures LLM-powered summarization of older conversation turns. - `Instructions string` Custom instructions that guide what the summarizer preserves. Replaces the default summarization prompt entirely. Example: "Preserve all code snippets, variable names, and technical decisions." - `ToolResultClearing CompactionConfigToolResultClearingStrategy` ToolResultClearingStrategy configures clearing of older tool result content. - `PreserveRecentResults int64` Number of most recent tool call results to keep intact. Older tool results have their content replaced with "[result cleared]" while preserving the assistant tool call message (function name, arguments). Default: 2 - `TriggerThreshold float64` Trigger threshold as a percentage of the model's context window (0.0 to 1.0). When input tokens reach this percentage of the model's limit, compaction triggers. Default: 0.75 (75%) - `Constraints AgentVariationSpecConstraints` Execution constraints - `MaxSubObjectives int64` The maximum number of sub-objectives that can be created. 0 means no limit. - `MaxToolCalls int64` The maximum number of tool calls that can be made. 0 means no limit. - `Description string` Human-readable description of what this variation does or when it should be used - `EnableEpisodicMemory bool` Enable episodic memory for objectives using this variation. When true, the system automatically creates a document namespace for each objective using the objective's episodic_key as the external_id, allowing the agent to store and retrieve documents specific to that episode. - `EpisodicMemoryTtl int64` How long episodic memories should be retained. After this duration, episodic document namespaces can be automatically cleaned up. If not set, episodic memories are retained indefinitely. - `ModelConfig AgentVariationSpecModelConfig` ModelConfig defines the model configuration for a variation - `ModelID string` The model identifier in family/model format (e.g., "claude/opus-4.6", "claude/sonnet-4.5") - `Temperature float64` Sampling temperature for model inference (0.0 to 1.0) Lower values produce more deterministic outputs, higher values increase randomness - `ProgressiveDiscovery AgentVariationSpecProgressiveDiscovery` ProgressiveDiscovery is used to indicate that the agent should automatically discover tools that are not explicitly assigned to it. Max tools is the maximum number of tools that can be discovered per search. Hints are optional hints for tool search. These are used in conjunction with the context-aware tool search and can help select the best tools for the task. - `Hints []string` - `MaxTools int64` - `RerankThreshold float64` Rerank Threshold is an optional value that instructs whether or not to run a search result through a embedding/reranker process which can improve performance and reduce context bloat when tools reach the configured threshold. If a tool match must exceed 0.8, for example, the tool very closely match the query the tool search performed. - `Prompt string` The system prompt for this variation - `Weight int64` Weight for weighted random selection (>= 0). P(v) = v.weight / sum(all_weights). Only used when the agent's variation_selection_mode is WEIGHTED. A weight of 0 means never auto-selected, but can still be chosen explicitly via variation_id on CreateObjectiveRequest. - `Assignments []VariationAssignmentEntry` Reconciled list — server adjusts the variation's assignments to exactly this set when the variation is bundle-owned. - `SubAgentID string` - `ToolID string` - `ToolSetID string` - `Labels map[string, string]` - `MemoryLayers []VariationMemoryLayerEntry` Reconciled list of memory layer assignments. Up to 10 entries. - `MemoryLayerID string` external_id: form. Canonical IDs are rejected. - `Position int64` - `AutomaticallyPublishAgents bool` When true, every agent created or updated by this Apply has its status forced to AGENT_STATUS_PUBLISHED, regardless of the status declared in the agent's AgentSpec. Useful when the bundle represents a production configuration and you want all of its agents live without setting status: AGENT_STATUS_PUBLISHED on each entry. Default false: each agent's AgentSpec.status controls (which is AGENT_STATUS_DRAFT on create when unspecified). - `MemoryLayers map[string, MemoryLayerEntry]` Memory layers to upsert, keyed by external_id. - `Name string` - `Spec MemoryLayerSpec` - `Type MemoryLayerSpecType` - `const MemoryLayerSpecTypeMemoryLayerTypeUnspecified MemoryLayerSpecType = "MEMORY_LAYER_TYPE_UNSPECIFIED"` - `const MemoryLayerSpecTypeMemoryLayerTypeEpisodic MemoryLayerSpecType = "MEMORY_LAYER_TYPE_EPISODIC"` - `const MemoryLayerSpecTypeMemoryLayerTypeSkills MemoryLayerSpecType = "MEMORY_LAYER_TYPE_SKILLS"` - `Description string` Human-readable description of the layer's purpose. Encouraged for user-created layers; system-managed layers may have a generated description. - `ExpiresAt Time` For layers with a finite lifetime (e.g., episodic), the time at which the layer becomes eligible for cleanup. Set by the system; unset for persistent layers. - `SystemManaged bool` Server-set. True for layers managed by the system (e.g., episodic layers created automatically when an objective uses an episodic_key). System-managed layers cannot be assigned to objective stacks via the API and cannot be mutated by clients — their lifecycle is controlled entirely by the runtime. - `Entries map[string, MemoryEntryItem]` Memory entries in this layer, keyed by external_id. - `Key string` - `Content string` - `Description string` - `UploadID string` - `Labels map[string, string]` - `SourceURL string` Optional URL pointing to the source of this apply (GitHub PR, Jenkins build, GitLab pipeline, etc.). Surfaced in the dashboard so users can jump from an apply back to the change that produced it. Free-form HTTPS URI; not interpreted by the server. - `ToolSets map[string, ToolSetEntry]` Tool sets to upsert, keyed by external_id. - `Name string` - `Spec ToolSetSpec` - `Adapter ToolSetAdapter` - `HTTP ToolSetAdapterHTTP` - `BaseURL string` - `Headers map[string, string]` - `Mcp ToolSetAdapterMcp` - `ExcludeTools ToolFilter` Top-level filter with simple boolean logic (no nesting) - `Operator ToolFilterOperator` - `const ToolFilterOperatorOperatorUnspecified ToolFilterOperator = "OPERATOR_UNSPECIFIED"` - `const ToolFilterOperatorOperatorAnd ToolFilterOperator = "OPERATOR_AND"` - `const ToolFilterOperatorOperatorOr ToolFilterOperator = "OPERATOR_OR"` - `Filters []AttributeFilter` - `Attribute AttributeFilterAttribute` - `const AttributeFilterAttributeAttributeUnspecified AttributeFilterAttribute = "ATTRIBUTE_UNSPECIFIED"` - `const AttributeFilterAttributeAttributeName AttributeFilterAttribute = "ATTRIBUTE_NAME"` - `const AttributeFilterAttributeAttributeTitle AttributeFilterAttribute = "ATTRIBUTE_TITLE"` - `const AttributeFilterAttributeAttributeDescription AttributeFilterAttribute = "ATTRIBUTE_DESCRIPTION"` - `Matcher StringMatcher` String matching operations - `CaseSensitive bool` - `Contains string` - `EndsWith string` - `Exact string` - `Regex string` - `StartsWith string` - `Headers map[string, string]` - `IncludeTools ToolFilter` Top-level filter with simple boolean logic (no nesting) - `ToolApprovals ApprovalRequirementFilter` Approval filters that will automatically set the approval requirement on tools synced from an external source - `Always bool` - `Only ToolFilter` Top-level filter with simple boolean logic (no nesting) - `URL string` - `OpenAPI ToolSetAdapterOpenAPI` - `BaseURL string` Base URL for dispatching tool calls. If set, overrides the server resolved from the spec's servers array. - `ExcludeTools ToolFilter` Top-level filter with simple boolean logic (no nesting) - `Headers map[string, string]` Headers sent when fetching the spec from a URL and when dispatching tool calls. - `IncludeTools ToolFilter` Top-level filter with simple boolean logic (no nesting) - `ServerName string` Name of the server entry in the spec's servers array (OpenAPI 3.2 server.name field). Used to select which server URL to dispatch to when base_url is not set. If unset, the first server is used. Ignored when base_url is set. - `ToolApprovals ApprovalRequirementFilter` Approval filters that will automatically set the approval requirement on tools synced from an external source - `UploadID string` ID of a COMPLETE Upload containing the OpenAPI spec document. - `URL string` URL to fetch the OpenAPI spec from. Synced automatically every hour. - `Description string` - `Labels map[string, string]` - `Tools map[string, ToolEntry]` Tools in this tool set, keyed by external_id. - `Name string` - `Spec ToolSpec` - `Config ToolSpecConfig` Config defines the adapter to use for the tool. This is used to determine how the tool is called. For example, if the tool is an HTTP tool, the adapter will be Http. If the tool is an inline tool, the adapter will be Inline. - `HTTP ConfigHTTP` - `RequestMethod ConfigHTTPRequestMethod` - `const ConfigHTTPRequestMethodHTTPMethodUnspecified ConfigHTTPRequestMethod = "HTTP_METHOD_UNSPECIFIED"` - `const ConfigHTTPRequestMethodGet ConfigHTTPRequestMethod = "GET"` - `const ConfigHTTPRequestMethodPost ConfigHTTPRequestMethod = "POST"` - `const ConfigHTTPRequestMethodPut ConfigHTTPRequestMethod = "PUT"` - `const ConfigHTTPRequestMethodPatch ConfigHTTPRequestMethod = "PATCH"` - `const ConfigHTTPRequestMethodDelete ConfigHTTPRequestMethod = "DELETE"` - `Headers map[string, string]` - `Path string` - `Query string` - `RequestBodyContentType string` - `RequestBodyTemplate string` These are only used when the request method is a POST, PUT, or PATCH - `ToolName string` The tool name (commonly an "operation id" in OpenAPI specs) to call on the HTTP adapter. This is used to match the tool spec to the correct endpoint on the HTTP adapter. it will be derived from the name of the tool if not provided. - `Mcp ConfigMcp` - `ToolDescription string` - `ToolName string` - `ToolTitle string` - `OpenAPI ConfigOpenAPI` - `Method string` - `OperationID string` - `Path string` - `Description string` - `Parameters map[string, unknown]` - `Status ToolSpecStatus` - `const ToolSpecStatusToolStatusUnspecified ToolSpecStatus = "TOOL_STATUS_UNSPECIFIED"` - `const ToolSpecStatusToolStatusAvailable ToolSpecStatus = "TOOL_STATUS_AVAILABLE"` - `const ToolSpecStatusToolStatusOmitted ToolSpecStatus = "TOOL_STATUS_OMITTED"` - `const ToolSpecStatusToolStatusArchived ToolSpecStatus = "TOOL_STATUS_ARCHIVED"` - `RequiresApproval bool` - `Labels map[string, string]` ### Bulk Workspace Apply Info - `type BulkWorkspaceApplyInfo struct{…}` - `CompletedAt Time` - `CreatedBy Profile` A profile identifies a user or non-human principal (such as an API key) at the account level. Profiles are account-scoped and can be granted access to multiple workspaces. - `Metadata AccountResourceMetadata` AccountResourceMetadata is used to represent a resource that is associated to an account but not to a workspace. - `ID string` Unique identifier for the resource (prefixed ULID, e.g., "apikey_01HXK...") - `AccountID string` Account this resource belongs to for multi-tenant isolation (prefixed ULID) - `Name string` Human-readable name for the resource (e.g., "Customer Support Agent", "Email Tool") Required for resources that users interact with directly - `ProfileID string` - `ExternalID string` External ID for the resource (e.g., a workflow ID from an external system) - `Labels map[string, string]` Arbitrary key-value pairs for categorization and filtering Examples: {"environment": "production", "team": "platform", "version": "v2"} - `Spec ProfileSpec` Configuration for a profile. - `Type ProfileSpecType` Whether this profile represents a human user, an API key, or a system principal. - `const ProfileSpecTypeProfileTypeUnspecified ProfileSpecType = "PROFILE_TYPE_UNSPECIFIED"` - `const ProfileSpecTypeProfileTypeUser ProfileSpecType = "PROFILE_TYPE_USER"` - `const ProfileSpecTypeProfileTypeAPIKey ProfileSpecType = "PROFILE_TYPE_API_KEY"` - `const ProfileSpecTypeProfileTypeSystem ProfileSpecType = "PROFILE_TYPE_SYSTEM"` - `Email string` Email address of the profile. Required and unique within an account for user profiles. - `Name string` Display name (e.g., "Bobby Tables"). - `CreatedCount int64` - `DeletedCount int64` - `FailedCount int64` - `StartedAt Time` - `TotalCount int64` - `UnchangedCount int64` - `UpdatedCount int64` ### Bulk Workspace Apply Status - `type BulkWorkspaceApplyStatus struct{…}` - `State BulkWorkspaceApplyStatusState` - `const BulkWorkspaceApplyStatusStateStateUnspecified BulkWorkspaceApplyStatusState = "STATE_UNSPECIFIED"` - `const BulkWorkspaceApplyStatusStateStatePending BulkWorkspaceApplyStatusState = "STATE_PENDING"` - `const BulkWorkspaceApplyStatusStateStateValidating BulkWorkspaceApplyStatusState = "STATE_VALIDATING"` - `const BulkWorkspaceApplyStatusStateStateRunning BulkWorkspaceApplyStatusState = "STATE_RUNNING"` - `const BulkWorkspaceApplyStatusStateStateSucceeded BulkWorkspaceApplyStatusState = "STATE_SUCCEEDED"` - `const BulkWorkspaceApplyStatusStateStatePartiallyApplied BulkWorkspaceApplyStatusState = "STATE_PARTIALLY_APPLIED"` - `const BulkWorkspaceApplyStatusStateStateFailed BulkWorkspaceApplyStatusState = "STATE_FAILED"` - `const BulkWorkspaceApplyStatusStateStateCancelled BulkWorkspaceApplyStatusState = "STATE_CANCELLED"` - `Message string` - `PreflightError BulkWorkspaceApplyStatusPreflightError` The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). - `Code int64` The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. - `Details []BulkWorkspaceApplyStatusPreflightErrorDetail` A list of messages that carry the error details. There is a common set of message types for APIs to use. - `Type string` The type of the serialized message. - `Message string` A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. ### Memory Entry Item - `type MemoryEntryItem struct{…}` - `Key string` - `Content string` - `Description string` - `UploadID string` ### Memory Layer Entry - `type MemoryLayerEntry struct{…}` - `Name string` - `Spec MemoryLayerSpec` - `Type MemoryLayerSpecType` - `const MemoryLayerSpecTypeMemoryLayerTypeUnspecified MemoryLayerSpecType = "MEMORY_LAYER_TYPE_UNSPECIFIED"` - `const MemoryLayerSpecTypeMemoryLayerTypeEpisodic MemoryLayerSpecType = "MEMORY_LAYER_TYPE_EPISODIC"` - `const MemoryLayerSpecTypeMemoryLayerTypeSkills MemoryLayerSpecType = "MEMORY_LAYER_TYPE_SKILLS"` - `Description string` Human-readable description of the layer's purpose. Encouraged for user-created layers; system-managed layers may have a generated description. - `ExpiresAt Time` For layers with a finite lifetime (e.g., episodic), the time at which the layer becomes eligible for cleanup. Set by the system; unset for persistent layers. - `SystemManaged bool` Server-set. True for layers managed by the system (e.g., episodic layers created automatically when an objective uses an episodic_key). System-managed layers cannot be assigned to objective stacks via the API and cannot be mutated by clients — their lifecycle is controlled entirely by the runtime. - `Entries map[string, MemoryEntryItem]` Memory entries in this layer, keyed by external_id. - `Key string` - `Content string` - `Description string` - `UploadID string` - `Labels map[string, string]` ### Tool Entry - `type ToolEntry struct{…}` - `Name string` - `Spec ToolSpec` - `Config ToolSpecConfig` Config defines the adapter to use for the tool. This is used to determine how the tool is called. For example, if the tool is an HTTP tool, the adapter will be Http. If the tool is an inline tool, the adapter will be Inline. - `HTTP ConfigHTTP` - `RequestMethod ConfigHTTPRequestMethod` - `const ConfigHTTPRequestMethodHTTPMethodUnspecified ConfigHTTPRequestMethod = "HTTP_METHOD_UNSPECIFIED"` - `const ConfigHTTPRequestMethodGet ConfigHTTPRequestMethod = "GET"` - `const ConfigHTTPRequestMethodPost ConfigHTTPRequestMethod = "POST"` - `const ConfigHTTPRequestMethodPut ConfigHTTPRequestMethod = "PUT"` - `const ConfigHTTPRequestMethodPatch ConfigHTTPRequestMethod = "PATCH"` - `const ConfigHTTPRequestMethodDelete ConfigHTTPRequestMethod = "DELETE"` - `Headers map[string, string]` - `Path string` - `Query string` - `RequestBodyContentType string` - `RequestBodyTemplate string` These are only used when the request method is a POST, PUT, or PATCH - `ToolName string` The tool name (commonly an "operation id" in OpenAPI specs) to call on the HTTP adapter. This is used to match the tool spec to the correct endpoint on the HTTP adapter. it will be derived from the name of the tool if not provided. - `Mcp ConfigMcp` - `ToolDescription string` - `ToolName string` - `ToolTitle string` - `OpenAPI ConfigOpenAPI` - `Method string` - `OperationID string` - `Path string` - `Description string` - `Parameters map[string, unknown]` - `Status ToolSpecStatus` - `const ToolSpecStatusToolStatusUnspecified ToolSpecStatus = "TOOL_STATUS_UNSPECIFIED"` - `const ToolSpecStatusToolStatusAvailable ToolSpecStatus = "TOOL_STATUS_AVAILABLE"` - `const ToolSpecStatusToolStatusOmitted ToolSpecStatus = "TOOL_STATUS_OMITTED"` - `const ToolSpecStatusToolStatusArchived ToolSpecStatus = "TOOL_STATUS_ARCHIVED"` - `RequiresApproval bool` - `Labels map[string, string]` ### Tool Set Entry - `type ToolSetEntry struct{…}` - `Name string` - `Spec ToolSetSpec` - `Adapter ToolSetAdapter` - `HTTP ToolSetAdapterHTTP` - `BaseURL string` - `Headers map[string, string]` - `Mcp ToolSetAdapterMcp` - `ExcludeTools ToolFilter` Top-level filter with simple boolean logic (no nesting) - `Operator ToolFilterOperator` - `const ToolFilterOperatorOperatorUnspecified ToolFilterOperator = "OPERATOR_UNSPECIFIED"` - `const ToolFilterOperatorOperatorAnd ToolFilterOperator = "OPERATOR_AND"` - `const ToolFilterOperatorOperatorOr ToolFilterOperator = "OPERATOR_OR"` - `Filters []AttributeFilter` - `Attribute AttributeFilterAttribute` - `const AttributeFilterAttributeAttributeUnspecified AttributeFilterAttribute = "ATTRIBUTE_UNSPECIFIED"` - `const AttributeFilterAttributeAttributeName AttributeFilterAttribute = "ATTRIBUTE_NAME"` - `const AttributeFilterAttributeAttributeTitle AttributeFilterAttribute = "ATTRIBUTE_TITLE"` - `const AttributeFilterAttributeAttributeDescription AttributeFilterAttribute = "ATTRIBUTE_DESCRIPTION"` - `Matcher StringMatcher` String matching operations - `CaseSensitive bool` - `Contains string` - `EndsWith string` - `Exact string` - `Regex string` - `StartsWith string` - `Headers map[string, string]` - `IncludeTools ToolFilter` Top-level filter with simple boolean logic (no nesting) - `ToolApprovals ApprovalRequirementFilter` Approval filters that will automatically set the approval requirement on tools synced from an external source - `Always bool` - `Only ToolFilter` Top-level filter with simple boolean logic (no nesting) - `URL string` - `OpenAPI ToolSetAdapterOpenAPI` - `BaseURL string` Base URL for dispatching tool calls. If set, overrides the server resolved from the spec's servers array. - `ExcludeTools ToolFilter` Top-level filter with simple boolean logic (no nesting) - `Headers map[string, string]` Headers sent when fetching the spec from a URL and when dispatching tool calls. - `IncludeTools ToolFilter` Top-level filter with simple boolean logic (no nesting) - `ServerName string` Name of the server entry in the spec's servers array (OpenAPI 3.2 server.name field). Used to select which server URL to dispatch to when base_url is not set. If unset, the first server is used. Ignored when base_url is set. - `ToolApprovals ApprovalRequirementFilter` Approval filters that will automatically set the approval requirement on tools synced from an external source - `UploadID string` ID of a COMPLETE Upload containing the OpenAPI spec document. - `URL string` URL to fetch the OpenAPI spec from. Synced automatically every hour. - `Description string` - `Labels map[string, string]` - `Tools map[string, ToolEntry]` Tools in this tool set, keyed by external_id. - `Name string` - `Spec ToolSpec` - `Config ToolSpecConfig` Config defines the adapter to use for the tool. This is used to determine how the tool is called. For example, if the tool is an HTTP tool, the adapter will be Http. If the tool is an inline tool, the adapter will be Inline. - `HTTP ConfigHTTP` - `RequestMethod ConfigHTTPRequestMethod` - `const ConfigHTTPRequestMethodHTTPMethodUnspecified ConfigHTTPRequestMethod = "HTTP_METHOD_UNSPECIFIED"` - `const ConfigHTTPRequestMethodGet ConfigHTTPRequestMethod = "GET"` - `const ConfigHTTPRequestMethodPost ConfigHTTPRequestMethod = "POST"` - `const ConfigHTTPRequestMethodPut ConfigHTTPRequestMethod = "PUT"` - `const ConfigHTTPRequestMethodPatch ConfigHTTPRequestMethod = "PATCH"` - `const ConfigHTTPRequestMethodDelete ConfigHTTPRequestMethod = "DELETE"` - `Headers map[string, string]` - `Path string` - `Query string` - `RequestBodyContentType string` - `RequestBodyTemplate string` These are only used when the request method is a POST, PUT, or PATCH - `ToolName string` The tool name (commonly an "operation id" in OpenAPI specs) to call on the HTTP adapter. This is used to match the tool spec to the correct endpoint on the HTTP adapter. it will be derived from the name of the tool if not provided. - `Mcp ConfigMcp` - `ToolDescription string` - `ToolName string` - `ToolTitle string` - `OpenAPI ConfigOpenAPI` - `Method string` - `OperationID string` - `Path string` - `Description string` - `Parameters map[string, unknown]` - `Status ToolSpecStatus` - `const ToolSpecStatusToolStatusUnspecified ToolSpecStatus = "TOOL_STATUS_UNSPECIFIED"` - `const ToolSpecStatusToolStatusAvailable ToolSpecStatus = "TOOL_STATUS_AVAILABLE"` - `const ToolSpecStatusToolStatusOmitted ToolSpecStatus = "TOOL_STATUS_OMITTED"` - `const ToolSpecStatusToolStatusArchived ToolSpecStatus = "TOOL_STATUS_ARCHIVED"` - `RequiresApproval bool` - `Labels map[string, string]` ### Variation Assignment Entry - `type VariationAssignmentEntry struct{…}` - `SubAgentID string` - `ToolID string` - `ToolSetID string` ### Variation Memory Layer Entry - `type VariationMemoryLayerEntry struct{…}` - `MemoryLayerID string` external_id: form. Canonical IDs are rejected. - `Position int64` # Results ## List per-resource results for a bulk workspace apply `client.BulkWorkspaceResources.Results.List(ctx, workspaceID, bulkWorkspaceApplyID, query) (*CursorPagination[BulkWorkspaceApplyResult], error)` **get** `/v1/workspaces/{workspaceId}/bulk_workspace_applies/{bulkWorkspaceApplyId}/results` Lists each resource action recorded by a bulk workspace apply operation. ### Parameters - `workspaceID string` - `bulkWorkspaceApplyID string` - `query BulkWorkspaceResourceResultListParams` - `Action param.Field[BulkWorkspaceResourceResultListParamsAction]` Filter by action. - `const BulkWorkspaceResourceResultListParamsActionActionUnspecified BulkWorkspaceResourceResultListParamsAction = "ACTION_UNSPECIFIED"` - `const BulkWorkspaceResourceResultListParamsActionActionCreated BulkWorkspaceResourceResultListParamsAction = "ACTION_CREATED"` - `const BulkWorkspaceResourceResultListParamsActionActionUpdated BulkWorkspaceResourceResultListParamsAction = "ACTION_UPDATED"` - `const BulkWorkspaceResourceResultListParamsActionActionUnchanged BulkWorkspaceResourceResultListParamsAction = "ACTION_UNCHANGED"` - `const BulkWorkspaceResourceResultListParamsActionActionDeleted BulkWorkspaceResourceResultListParamsAction = "ACTION_DELETED"` - `const BulkWorkspaceResourceResultListParamsActionActionFailed BulkWorkspaceResourceResultListParamsAction = "ACTION_FAILED"` - `Cursor param.Field[string]` Pagination cursor from previous response - `Limit param.Field[int64]` Maximum number of results to return - `SortOrder param.Field[string]` Sort order for results (asc or desc by creation time) - `Type param.Field[string]` Filter by data.type discriminator (e.g., "toolSet", "memoryEntry"). ### Returns - `type BulkWorkspaceApplyResult struct{…}` One row of the per-resource result list for a BulkWorkspaceApply. Each row is itself an operation that can be paginated, sorted by created_at, and addressed individually. - `Data BulkWorkspaceApplyResultData` Outcome for a single resource within a bulk apply. The `type` field is the discriminator string naming the populated `outcome` oneof variant (e.g., "toolSet", "memoryEntry"). Every outcome shell carries an `action` enum and either a resulting resource snapshot (for ACTION_CREATED, ACTION_UPDATED, ACTION_UNCHANGED, ACTION_DELETED) or a google.rpc.Status (for ACTION_FAILED). - `Agent BulkWorkspaceApplyResultDataAgentOutcome` - `Action BulkWorkspaceApplyResultDataAgentOutcomeAction` - `const BulkWorkspaceApplyResultDataAgentOutcomeActionActionUnspecified BulkWorkspaceApplyResultDataAgentOutcomeAction = "ACTION_UNSPECIFIED"` - `const BulkWorkspaceApplyResultDataAgentOutcomeActionActionCreated BulkWorkspaceApplyResultDataAgentOutcomeAction = "ACTION_CREATED"` - `const BulkWorkspaceApplyResultDataAgentOutcomeActionActionUpdated BulkWorkspaceApplyResultDataAgentOutcomeAction = "ACTION_UPDATED"` - `const BulkWorkspaceApplyResultDataAgentOutcomeActionActionUnchanged BulkWorkspaceApplyResultDataAgentOutcomeAction = "ACTION_UNCHANGED"` - `const BulkWorkspaceApplyResultDataAgentOutcomeActionActionDeleted BulkWorkspaceApplyResultDataAgentOutcomeAction = "ACTION_DELETED"` - `const BulkWorkspaceApplyResultDataAgentOutcomeActionActionFailed BulkWorkspaceApplyResultDataAgentOutcomeAction = "ACTION_FAILED"` - `Error BulkWorkspaceApplyResultDataAgentOutcomeError` The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). - `Code int64` The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. - `Details []BulkWorkspaceApplyResultDataAgentOutcomeErrorDetail` A list of messages that carry the error details. There is a common set of message types for APIs to use. - `Type string` The type of the serialized message. - `Message string` A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. - `ExternalID string` - `Resource Agent` Agent resource - `Metadata ResourceMetadata` Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - `ID string` Unique identifier for the resource (prefixed ULID, e.g., "agent_01HXK...") - `AccountID string` Account this resource belongs to for multi-tenant isolation (prefixed ULID) - `CreatedAt Time` Timestamp when this resource was created - `Name string` Human-readable name for the resource (e.g., "Customer Support Agent", "Email Tool") Required for resources that users interact with directly - `ProfileID string` ID of the actor (user or service account) that created this resource - `WorkspaceID string` Workspace this resource belongs to for organizational grouping (prefixed ULID) - `BundleKey string` Optional bundle ownership key. When set, indicates the resource is managed by a configuration bundle identified by this key. Used by BulkWorkspaceResources.Apply to track which resources belong to which bundle for reconciliation / soft-delete on re-apply. - `ExternalID string` External ID for the resource (e.g., a workflow ID from an external system) - `Labels map[string, string]` Arbitrary key-value pairs for categorization and filtering Examples: {"environment": "production", "team": "platform", "version": "v2"} - `Spec AgentSpec` Agent specification (user-provided configuration) - `Status AgentSpecStatus` Status of the agent - `const AgentSpecStatusAgentStatusUnspecified AgentSpecStatus = "AGENT_STATUS_UNSPECIFIED"` - `const AgentSpecStatusAgentStatusDraft AgentSpecStatus = "AGENT_STATUS_DRAFT"` - `const AgentSpecStatusAgentStatusPublished AgentSpecStatus = "AGENT_STATUS_PUBLISHED"` - `const AgentSpecStatusAgentStatusArchived AgentSpecStatus = "AGENT_STATUS_ARCHIVED"` - `VariationSelectionMode AgentSpecVariationSelectionMode` Controls how variations are automatically selected when creating objectives Defaults to RANDOM when unspecified - `const AgentSpecVariationSelectionModeVariationSelectionModeUnspecified AgentSpecVariationSelectionMode = "VARIATION_SELECTION_MODE_UNSPECIFIED"` - `const AgentSpecVariationSelectionModeVariationSelectionModeRandom AgentSpecVariationSelectionMode = "VARIATION_SELECTION_MODE_RANDOM"` - `const AgentSpecVariationSelectionModeVariationSelectionModeWeighted AgentSpecVariationSelectionMode = "VARIATION_SELECTION_MODE_WEIGHTED"` - `Description string` Description of the agent's purpose - `InputDataSchema map[string, unknown]` InputDataSchema is used for enforcing a data input when objectives are created. This is valuable when using liquid formatting in agent variation prompts. Input data schema is also valuable when using an agent as a sub-agent, as the schema is used as the tool's input parameter schema. If omitted, the sub-agent schema will be loaded with a simple "prompt" free text string as its schema. - `OutputDefinition map[string, unknown]` Optional output definition for objectives created for this agent. When provided, Cadenya will append a tool to that will be called by the LLM in use by the variant to extract information in the format provided here. Use this option when you want structured data to be created by your objectives. - `WebhookEventsURL string` The URL that Cadenya will send events for any objective assigned to the agent. - `Info AgentInfo` AgentInfo contains simple information about an agent for display or quick reference - `CreatedBy Profile` A profile identifies a user or non-human principal (such as an API key) at the account level. Profiles are account-scoped and can be granted access to multiple workspaces. - `Metadata AccountResourceMetadata` AccountResourceMetadata is used to represent a resource that is associated to an account but not to a workspace. - `ID string` Unique identifier for the resource (prefixed ULID, e.g., "apikey_01HXK...") - `AccountID string` Account this resource belongs to for multi-tenant isolation (prefixed ULID) - `Name string` Human-readable name for the resource (e.g., "Customer Support Agent", "Email Tool") Required for resources that users interact with directly - `ProfileID string` - `ExternalID string` External ID for the resource (e.g., a workflow ID from an external system) - `Labels map[string, string]` Arbitrary key-value pairs for categorization and filtering Examples: {"environment": "production", "team": "platform", "version": "v2"} - `Spec ProfileSpec` Configuration for a profile. - `Type ProfileSpecType` Whether this profile represents a human user, an API key, or a system principal. - `const ProfileSpecTypeProfileTypeUnspecified ProfileSpecType = "PROFILE_TYPE_UNSPECIFIED"` - `const ProfileSpecTypeProfileTypeUser ProfileSpecType = "PROFILE_TYPE_USER"` - `const ProfileSpecTypeProfileTypeAPIKey ProfileSpecType = "PROFILE_TYPE_API_KEY"` - `const ProfileSpecTypeProfileTypeSystem ProfileSpecType = "PROFILE_TYPE_SYSTEM"` - `Email string` Email address of the profile. Required and unique within an account for user profiles. - `Name string` Display name (e.g., "Bobby Tables"). - `VariationCount int64` - `AgentSchedule BulkWorkspaceApplyResultDataAgentScheduleOutcome` - `Action BulkWorkspaceApplyResultDataAgentScheduleOutcomeAction` - `const BulkWorkspaceApplyResultDataAgentScheduleOutcomeActionActionUnspecified BulkWorkspaceApplyResultDataAgentScheduleOutcomeAction = "ACTION_UNSPECIFIED"` - `const BulkWorkspaceApplyResultDataAgentScheduleOutcomeActionActionCreated BulkWorkspaceApplyResultDataAgentScheduleOutcomeAction = "ACTION_CREATED"` - `const BulkWorkspaceApplyResultDataAgentScheduleOutcomeActionActionUpdated BulkWorkspaceApplyResultDataAgentScheduleOutcomeAction = "ACTION_UPDATED"` - `const BulkWorkspaceApplyResultDataAgentScheduleOutcomeActionActionUnchanged BulkWorkspaceApplyResultDataAgentScheduleOutcomeAction = "ACTION_UNCHANGED"` - `const BulkWorkspaceApplyResultDataAgentScheduleOutcomeActionActionDeleted BulkWorkspaceApplyResultDataAgentScheduleOutcomeAction = "ACTION_DELETED"` - `const BulkWorkspaceApplyResultDataAgentScheduleOutcomeActionActionFailed BulkWorkspaceApplyResultDataAgentScheduleOutcomeAction = "ACTION_FAILED"` - `Error BulkWorkspaceApplyResultDataAgentScheduleOutcomeError` The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). - `Code int64` The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. - `Details []BulkWorkspaceApplyResultDataAgentScheduleOutcomeErrorDetail` A list of messages that carry the error details. There is a common set of message types for APIs to use. - `Type string` The type of the serialized message. - `Message string` A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. - `ExternalID string` - `Resource AgentSchedule` AgentSchedule resource — a recurring trigger attached to an agent that creates objectives on its cadence. - `Metadata ResourceMetadata` Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - `Spec AgentScheduleSpec` AgentScheduleSpec is the user-provided configuration for a schedule. - `InitialMessage string` The initial message passed to CreateObjective on each fire. Becomes the first user message in the objective's chat history. - `Schedule AgentScheduleSpecSchedule` Schedule defines WHEN the schedule fires. Temporal-style structured form: a list of calendar rules (wall-clock) and/or interval rules (duration), OR'd together. At least one rule is required. - `Calendars []ScheduleCalendar` Wall-clock rules. May be empty if `intervals` is non-empty. - `Comment string` - `DayOfMonth []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `DayOfWeek []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Hour []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Minute []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Month []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Second []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Intervals []ScheduleInterval` Duration-based rules. May be empty if `calendars` is non-empty. - `Every string` - `Offset string` Phase shift within `every`. Must be < `every` (enforced at runtime). - `Timezone string` IANA tz name (e.g. "America/New_York"). Required. Applies to calendars; intervals fire on wall-clock cadence anchored in this zone. - `Data unknown` Optional input data passed to the objective. If the agent has an input_data_schema, this must satisfy it. - `OverlapPolicy AgentScheduleSpecOverlapPolicy` What to do when the previous run is still in flight. Defaults to SKIP. - `const AgentScheduleSpecOverlapPolicyOverlapPolicyUnspecified AgentScheduleSpecOverlapPolicy = "OVERLAP_POLICY_UNSPECIFIED"` - `const AgentScheduleSpecOverlapPolicyOverlapPolicyAllow AgentScheduleSpecOverlapPolicy = "OVERLAP_POLICY_ALLOW"` - `const AgentScheduleSpecOverlapPolicyOverlapPolicySkip AgentScheduleSpecOverlapPolicy = "OVERLAP_POLICY_SKIP"` - `Status AgentScheduleSpecStatus` Lifecycle. Defaults to ACTIVE on create when unspecified. - `const AgentScheduleSpecStatusAgentScheduleStatusUnspecified AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_UNSPECIFIED"` - `const AgentScheduleSpecStatusAgentScheduleStatusActive AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_ACTIVE"` - `const AgentScheduleSpecStatusAgentScheduleStatusPaused AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_PAUSED"` - `const AgentScheduleSpecStatusAgentScheduleStatusArchived AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_ARCHIVED"` - `VariationID string` Optional explicit variation. When unset, the agent's variation_selection_mode chooses per fire. - `Info AgentScheduleInfo` AgentScheduleInfo provides read-only runtime data about a schedule. - `CreatedBy Profile` A profile identifies a user or non-human principal (such as an API key) at the account level. Profiles are account-scoped and can be granted access to multiple workspaces. - `LastFireAt Time` When the schedule last fired (regardless of objective outcome). - `LastObjectiveID string` ID of the most recent objective the schedule created. - `LastSkippedAt Time` When the schedule most recently skipped a fire (SKIP policy + prior in flight). - `LastSkipReason string` Reason for the most recent skip (e.g. "previous objective still running"). - `NextFireAt Time` When the schedule will next fire. Computed from the spec; absent when the schedule is PAUSED/ARCHIVED or has no future fire times. - `TotalFires int64` Lifetime count of objectives created by this schedule. - `AgentVariation BulkWorkspaceApplyResultDataAgentVariationOutcome` - `Action BulkWorkspaceApplyResultDataAgentVariationOutcomeAction` - `const BulkWorkspaceApplyResultDataAgentVariationOutcomeActionActionUnspecified BulkWorkspaceApplyResultDataAgentVariationOutcomeAction = "ACTION_UNSPECIFIED"` - `const BulkWorkspaceApplyResultDataAgentVariationOutcomeActionActionCreated BulkWorkspaceApplyResultDataAgentVariationOutcomeAction = "ACTION_CREATED"` - `const BulkWorkspaceApplyResultDataAgentVariationOutcomeActionActionUpdated BulkWorkspaceApplyResultDataAgentVariationOutcomeAction = "ACTION_UPDATED"` - `const BulkWorkspaceApplyResultDataAgentVariationOutcomeActionActionUnchanged BulkWorkspaceApplyResultDataAgentVariationOutcomeAction = "ACTION_UNCHANGED"` - `const BulkWorkspaceApplyResultDataAgentVariationOutcomeActionActionDeleted BulkWorkspaceApplyResultDataAgentVariationOutcomeAction = "ACTION_DELETED"` - `const BulkWorkspaceApplyResultDataAgentVariationOutcomeActionActionFailed BulkWorkspaceApplyResultDataAgentVariationOutcomeAction = "ACTION_FAILED"` - `Error BulkWorkspaceApplyResultDataAgentVariationOutcomeError` The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). - `Code int64` The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. - `Details []BulkWorkspaceApplyResultDataAgentVariationOutcomeErrorDetail` A list of messages that carry the error details. There is a common set of message types for APIs to use. - `Type string` The type of the serialized message. - `Message string` A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. - `ExternalID string` - `Resource AgentVariation` AgentVariation resource - `Metadata ResourceMetadata` Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - `Spec AgentVariationSpec` AgentVariationSpec defines the operational configuration for a variation - `CompactionConfig AgentVariationSpecCompactionConfig` CompactionConfig defines how context window compaction behaves for objectives using this variation. - `Summarization CompactionConfigSummarizationStrategy` SummarizationStrategy configures LLM-powered summarization of older conversation turns. - `Instructions string` Custom instructions that guide what the summarizer preserves. Replaces the default summarization prompt entirely. Example: "Preserve all code snippets, variable names, and technical decisions." - `ToolResultClearing CompactionConfigToolResultClearingStrategy` ToolResultClearingStrategy configures clearing of older tool result content. - `PreserveRecentResults int64` Number of most recent tool call results to keep intact. Older tool results have their content replaced with "[result cleared]" while preserving the assistant tool call message (function name, arguments). Default: 2 - `TriggerThreshold float64` Trigger threshold as a percentage of the model's context window (0.0 to 1.0). When input tokens reach this percentage of the model's limit, compaction triggers. Default: 0.75 (75%) - `Constraints AgentVariationSpecConstraints` Execution constraints - `MaxSubObjectives int64` The maximum number of sub-objectives that can be created. 0 means no limit. - `MaxToolCalls int64` The maximum number of tool calls that can be made. 0 means no limit. - `Description string` Human-readable description of what this variation does or when it should be used - `EnableEpisodicMemory bool` Enable episodic memory for objectives using this variation. When true, the system automatically creates a document namespace for each objective using the objective's episodic_key as the external_id, allowing the agent to store and retrieve documents specific to that episode. - `EpisodicMemoryTtl int64` How long episodic memories should be retained. After this duration, episodic document namespaces can be automatically cleaned up. If not set, episodic memories are retained indefinitely. - `ModelConfig AgentVariationSpecModelConfig` ModelConfig defines the model configuration for a variation - `ModelID string` The model identifier in family/model format (e.g., "claude/opus-4.6", "claude/sonnet-4.5") - `Temperature float64` Sampling temperature for model inference (0.0 to 1.0) Lower values produce more deterministic outputs, higher values increase randomness - `ProgressiveDiscovery AgentVariationSpecProgressiveDiscovery` ProgressiveDiscovery is used to indicate that the agent should automatically discover tools that are not explicitly assigned to it. Max tools is the maximum number of tools that can be discovered per search. Hints are optional hints for tool search. These are used in conjunction with the context-aware tool search and can help select the best tools for the task. - `Hints []string` - `MaxTools int64` - `RerankThreshold float64` Rerank Threshold is an optional value that instructs whether or not to run a search result through a embedding/reranker process which can improve performance and reduce context bloat when tools reach the configured threshold. If a tool match must exceed 0.8, for example, the tool very closely match the query the tool search performed. - `Prompt string` The system prompt for this variation - `Weight int64` Weight for weighted random selection (>= 0). P(v) = v.weight / sum(all_weights). Only used when the agent's variation_selection_mode is WEIGHTED. A weight of 0 means never auto-selected, but can still be chosen explicitly via variation_id on CreateObjectiveRequest. - `Info AgentVariationInfo` AgentVariationInfo provides read-only summary information about a variation - `Assignments []VariationAssignment` All tools, tool sets, and sub-agents assigned to this variation. Populated on reads so clients can render a variation's full assignment list without calling the add/remove endpoints just to enumerate. - `ID string` - `Agent BareMetadata` BareMetadata contains the minimal metadata for a resource: the ID and an optional human-readable name. These are used for reference fields where the full metadata (account scoping, timestamps, labels, external IDs) is not needed — e.g., the tool references inside an agent variation spec or the tools assigned to an objective. Both fields are server-populated; clients provide IDs through sibling fields rather than by constructing a BareMetadata themselves. - `ID string` - `Name string` Human-readable name of the referenced resource, populated by the server on reads for convenience. Absent on references to resources that do not have a name (e.g., objective tasks). - `Tool BareMetadata` BareMetadata contains the minimal metadata for a resource: the ID and an optional human-readable name. These are used for reference fields where the full metadata (account scoping, timestamps, labels, external IDs) is not needed — e.g., the tool references inside an agent variation spec or the tools assigned to an objective. Both fields are server-populated; clients provide IDs through sibling fields rather than by constructing a BareMetadata themselves. - `ToolSet BareMetadata` BareMetadata contains the minimal metadata for a resource: the ID and an optional human-readable name. These are used for reference fields where the full metadata (account scoping, timestamps, labels, external IDs) is not needed — e.g., the tool references inside an agent variation spec or the tools assigned to an objective. Both fields are server-populated; clients provide IDs through sibling fields rather than by constructing a BareMetadata themselves. - `CreatedBy Profile` A profile identifies a user or non-human principal (such as an API key) at the account level. Profiles are account-scoped and can be granted access to multiple workspaces. - `FeedbackCount int64` Total number of objective feedbacks received for this variation - `MemoryLayerAssignments []VariationMemoryLayerAssignment` Read-only list of memory layer assignments for this variation, returned in ascending `position` (bottom → top). Capped at 10 entries. - `ID string` Assignment row id — handle for removing the assignment. Distinct from the referenced memory layer's id. - `MemoryLayer BareMetadata` BareMetadata contains the minimal metadata for a resource: the ID and an optional human-readable name. These are used for reference fields where the full metadata (account scoping, timestamps, labels, external IDs) is not needed — e.g., the tool references inside an agent variation spec or the tools assigned to an objective. Both fields are server-populated; clients provide IDs through sibling fields rather than by constructing a BareMetadata themselves. - `Position int64` Position in the variation's baseline stack. Lower values sit lower; the highest-position assignment is on top of the variation's baseline. Gaps are fine — only relative position matters. Positions must be unique within a variation; a request that would collide with an existing assignment's position is rejected with InvalidArgument. - `MemoryLayerCount int64` Count of memory layer assignments. - `Model ResourceMetadata` Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - `Score float64` Thompson Sampling score: posterior mean of Beta(ts_alpha, ts_beta). Range [0, 1] where 0.5 = neutral, >0.5 = positive, <0.5 = negative. - `SubAgentCount int64` Number of sub-agents assigned to this variation - `ToolCount int64` Number of individual tools assigned to this variation - `ToolSetCount int64` Number of tool sets assigned to this variation - `MemoryEntry BulkWorkspaceApplyResultDataMemoryEntryOutcome` - `Action BulkWorkspaceApplyResultDataMemoryEntryOutcomeAction` - `const BulkWorkspaceApplyResultDataMemoryEntryOutcomeActionActionUnspecified BulkWorkspaceApplyResultDataMemoryEntryOutcomeAction = "ACTION_UNSPECIFIED"` - `const BulkWorkspaceApplyResultDataMemoryEntryOutcomeActionActionCreated BulkWorkspaceApplyResultDataMemoryEntryOutcomeAction = "ACTION_CREATED"` - `const BulkWorkspaceApplyResultDataMemoryEntryOutcomeActionActionUpdated BulkWorkspaceApplyResultDataMemoryEntryOutcomeAction = "ACTION_UPDATED"` - `const BulkWorkspaceApplyResultDataMemoryEntryOutcomeActionActionUnchanged BulkWorkspaceApplyResultDataMemoryEntryOutcomeAction = "ACTION_UNCHANGED"` - `const BulkWorkspaceApplyResultDataMemoryEntryOutcomeActionActionDeleted BulkWorkspaceApplyResultDataMemoryEntryOutcomeAction = "ACTION_DELETED"` - `const BulkWorkspaceApplyResultDataMemoryEntryOutcomeActionActionFailed BulkWorkspaceApplyResultDataMemoryEntryOutcomeAction = "ACTION_FAILED"` - `Error BulkWorkspaceApplyResultDataMemoryEntryOutcomeError` The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). - `Code int64` The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. - `Details []BulkWorkspaceApplyResultDataMemoryEntryOutcomeErrorDetail` A list of messages that carry the error details. There is a common set of message types for APIs to use. - `Type string` The type of the serialized message. - `Message string` A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. - `ExternalID string` - `Resource MemoryEntry` MemoryEntry is a single keyed value within a MemoryLayer. Entries are addressed by their key, which follows the S3 object key safe-character convention (see MemoryEntrySpec.key for the full rule). Keys are unique within a single layer; the same key may appear in multiple layers, in which case the LIFO stack-walk determines which one wins for a given objective. MemoryEntry is the summary shape, returned by ListMemoryEntries. It does not carry the entry body — callers that need the body must fetch the entry individually via GetMemoryEntry, which returns a MemoryEntryDetail. - `Metadata ResourceMetadata` Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - `Spec MemoryEntrySpec` MemoryEntrySpec is the metadata portion of an entry — the fields that identify and describe it, without the body. It appears on both the summary (MemoryEntry) and detail (MemoryEntryDetail) views. - `Key string` The lookup key for this entry within its layer. Must conform to the S3 object key safe-characters spec: ASCII alphanumerics and the special characters !, -, _, ., *, ', (, ), and /. Forward slashes may be used to suggest hierarchy (e.g., "skills/postmortem/write"), but lookups are flat — the key is a single opaque string, not a path. Additional rules enforced by the service: - May not begin or end with / - May not contain consecutive slashes (//) - May not begin with reserved prefixes (cadenya/, system/) - Case-sensitive - Unique within the parent layer For skills entries, this key is also the id the model passes to memory_load_skill when it decides to load the entry's content. - `Description string` One-line "when to use this" hint shown in the frontmatter manifest for skills entries. The model uses this to decide whether to load the body, so it should be written for the model as the audience. Ignored for layer types that do not advertise frontmatter. - `Info MemoryEntryInfo` - `CreatedBy Profile` A profile identifies a user or non-human principal (such as an API key) at the account level. Profiles are account-scoped and can be granted access to multiple workspaces. - `MemoryLayer ResourceMetadata` Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - `MemoryLayer BulkWorkspaceApplyResultDataMemoryLayerOutcome` - `Action BulkWorkspaceApplyResultDataMemoryLayerOutcomeAction` - `const BulkWorkspaceApplyResultDataMemoryLayerOutcomeActionActionUnspecified BulkWorkspaceApplyResultDataMemoryLayerOutcomeAction = "ACTION_UNSPECIFIED"` - `const BulkWorkspaceApplyResultDataMemoryLayerOutcomeActionActionCreated BulkWorkspaceApplyResultDataMemoryLayerOutcomeAction = "ACTION_CREATED"` - `const BulkWorkspaceApplyResultDataMemoryLayerOutcomeActionActionUpdated BulkWorkspaceApplyResultDataMemoryLayerOutcomeAction = "ACTION_UPDATED"` - `const BulkWorkspaceApplyResultDataMemoryLayerOutcomeActionActionUnchanged BulkWorkspaceApplyResultDataMemoryLayerOutcomeAction = "ACTION_UNCHANGED"` - `const BulkWorkspaceApplyResultDataMemoryLayerOutcomeActionActionDeleted BulkWorkspaceApplyResultDataMemoryLayerOutcomeAction = "ACTION_DELETED"` - `const BulkWorkspaceApplyResultDataMemoryLayerOutcomeActionActionFailed BulkWorkspaceApplyResultDataMemoryLayerOutcomeAction = "ACTION_FAILED"` - `Error BulkWorkspaceApplyResultDataMemoryLayerOutcomeError` The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). - `Code int64` The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. - `Details []BulkWorkspaceApplyResultDataMemoryLayerOutcomeErrorDetail` A list of messages that carry the error details. There is a common set of message types for APIs to use. - `Type string` The type of the serialized message. - `Message string` A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. - `ExternalID string` - `Resource MemoryLayer` MemoryLayer is a named container of memory entries that can be composed into an objective's memory stack. Layers are workspace-scoped resources. The layer type controls how its entries participate in the agent loop — see MemoryLayerType for details. See "Memory stack composition" above for how layers compose at lookup time. - `Metadata ResourceMetadata` Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - `Spec MemoryLayerSpec` - `Type MemoryLayerSpecType` - `const MemoryLayerSpecTypeMemoryLayerTypeUnspecified MemoryLayerSpecType = "MEMORY_LAYER_TYPE_UNSPECIFIED"` - `const MemoryLayerSpecTypeMemoryLayerTypeEpisodic MemoryLayerSpecType = "MEMORY_LAYER_TYPE_EPISODIC"` - `const MemoryLayerSpecTypeMemoryLayerTypeSkills MemoryLayerSpecType = "MEMORY_LAYER_TYPE_SKILLS"` - `Description string` Human-readable description of the layer's purpose. Encouraged for user-created layers; system-managed layers may have a generated description. - `ExpiresAt Time` For layers with a finite lifetime (e.g., episodic), the time at which the layer becomes eligible for cleanup. Set by the system; unset for persistent layers. - `SystemManaged bool` Server-set. True for layers managed by the system (e.g., episodic layers created automatically when an objective uses an episodic_key). System-managed layers cannot be assigned to objective stacks via the API and cannot be mutated by clients — their lifecycle is controlled entirely by the runtime. - `Info MemoryLayerInfo` - `CreatedBy Profile` A profile identifies a user or non-human principal (such as an API key) at the account level. Profiles are account-scoped and can be granted access to multiple workspaces. - `EntryCount int64` Number of entries currently in this layer. - `LastUsedAt Time` Timestamp of the most recent objective that resolved against this layer. Useful for surfacing unused layers in the dashboard. - `Tool BulkWorkspaceApplyResultDataToolOutcome` - `Action BulkWorkspaceApplyResultDataToolOutcomeAction` - `const BulkWorkspaceApplyResultDataToolOutcomeActionActionUnspecified BulkWorkspaceApplyResultDataToolOutcomeAction = "ACTION_UNSPECIFIED"` - `const BulkWorkspaceApplyResultDataToolOutcomeActionActionCreated BulkWorkspaceApplyResultDataToolOutcomeAction = "ACTION_CREATED"` - `const BulkWorkspaceApplyResultDataToolOutcomeActionActionUpdated BulkWorkspaceApplyResultDataToolOutcomeAction = "ACTION_UPDATED"` - `const BulkWorkspaceApplyResultDataToolOutcomeActionActionUnchanged BulkWorkspaceApplyResultDataToolOutcomeAction = "ACTION_UNCHANGED"` - `const BulkWorkspaceApplyResultDataToolOutcomeActionActionDeleted BulkWorkspaceApplyResultDataToolOutcomeAction = "ACTION_DELETED"` - `const BulkWorkspaceApplyResultDataToolOutcomeActionActionFailed BulkWorkspaceApplyResultDataToolOutcomeAction = "ACTION_FAILED"` - `Error BulkWorkspaceApplyResultDataToolOutcomeError` The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). - `Code int64` The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. - `Details []BulkWorkspaceApplyResultDataToolOutcomeErrorDetail` A list of messages that carry the error details. There is a common set of message types for APIs to use. - `Type string` The type of the serialized message. - `Message string` A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. - `ExternalID string` - `Resource Tool` - `Metadata ResourceMetadata` Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - `Spec ToolSpec` - `Config ToolSpecConfig` Config defines the adapter to use for the tool. This is used to determine how the tool is called. For example, if the tool is an HTTP tool, the adapter will be Http. If the tool is an inline tool, the adapter will be Inline. - `HTTP ConfigHTTP` - `RequestMethod ConfigHTTPRequestMethod` - `const ConfigHTTPRequestMethodHTTPMethodUnspecified ConfigHTTPRequestMethod = "HTTP_METHOD_UNSPECIFIED"` - `const ConfigHTTPRequestMethodGet ConfigHTTPRequestMethod = "GET"` - `const ConfigHTTPRequestMethodPost ConfigHTTPRequestMethod = "POST"` - `const ConfigHTTPRequestMethodPut ConfigHTTPRequestMethod = "PUT"` - `const ConfigHTTPRequestMethodPatch ConfigHTTPRequestMethod = "PATCH"` - `const ConfigHTTPRequestMethodDelete ConfigHTTPRequestMethod = "DELETE"` - `Headers map[string, string]` - `Path string` - `Query string` - `RequestBodyContentType string` - `RequestBodyTemplate string` These are only used when the request method is a POST, PUT, or PATCH - `ToolName string` The tool name (commonly an "operation id" in OpenAPI specs) to call on the HTTP adapter. This is used to match the tool spec to the correct endpoint on the HTTP adapter. it will be derived from the name of the tool if not provided. - `Mcp ConfigMcp` - `ToolDescription string` - `ToolName string` - `ToolTitle string` - `OpenAPI ConfigOpenAPI` - `Method string` - `OperationID string` - `Path string` - `Description string` - `Parameters map[string, unknown]` - `Status ToolSpecStatus` - `const ToolSpecStatusToolStatusUnspecified ToolSpecStatus = "TOOL_STATUS_UNSPECIFIED"` - `const ToolSpecStatusToolStatusAvailable ToolSpecStatus = "TOOL_STATUS_AVAILABLE"` - `const ToolSpecStatusToolStatusOmitted ToolSpecStatus = "TOOL_STATUS_OMITTED"` - `const ToolSpecStatusToolStatusArchived ToolSpecStatus = "TOOL_STATUS_ARCHIVED"` - `RequiresApproval bool` - `Info ToolInfo` - `CreatedBy Profile` A profile identifies a user or non-human principal (such as an API key) at the account level. Profiles are account-scoped and can be granted access to multiple workspaces. - `ToolSet ResourceMetadata` Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - `ToolSet BulkWorkspaceApplyResultDataToolSetOutcome` - `Action BulkWorkspaceApplyResultDataToolSetOutcomeAction` - `const BulkWorkspaceApplyResultDataToolSetOutcomeActionActionUnspecified BulkWorkspaceApplyResultDataToolSetOutcomeAction = "ACTION_UNSPECIFIED"` - `const BulkWorkspaceApplyResultDataToolSetOutcomeActionActionCreated BulkWorkspaceApplyResultDataToolSetOutcomeAction = "ACTION_CREATED"` - `const BulkWorkspaceApplyResultDataToolSetOutcomeActionActionUpdated BulkWorkspaceApplyResultDataToolSetOutcomeAction = "ACTION_UPDATED"` - `const BulkWorkspaceApplyResultDataToolSetOutcomeActionActionUnchanged BulkWorkspaceApplyResultDataToolSetOutcomeAction = "ACTION_UNCHANGED"` - `const BulkWorkspaceApplyResultDataToolSetOutcomeActionActionDeleted BulkWorkspaceApplyResultDataToolSetOutcomeAction = "ACTION_DELETED"` - `const BulkWorkspaceApplyResultDataToolSetOutcomeActionActionFailed BulkWorkspaceApplyResultDataToolSetOutcomeAction = "ACTION_FAILED"` - `Error BulkWorkspaceApplyResultDataToolSetOutcomeError` The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). - `Code int64` The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. - `Details []BulkWorkspaceApplyResultDataToolSetOutcomeErrorDetail` A list of messages that carry the error details. There is a common set of message types for APIs to use. - `Type string` The type of the serialized message. - `Message string` A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. - `ExternalID string` - `Resource ToolSet` - `Metadata ResourceMetadata` Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - `Spec ToolSetSpec` - `Adapter ToolSetAdapter` - `HTTP ToolSetAdapterHTTP` - `BaseURL string` - `Headers map[string, string]` - `Mcp ToolSetAdapterMcp` - `ExcludeTools ToolFilter` Top-level filter with simple boolean logic (no nesting) - `Operator ToolFilterOperator` - `const ToolFilterOperatorOperatorUnspecified ToolFilterOperator = "OPERATOR_UNSPECIFIED"` - `const ToolFilterOperatorOperatorAnd ToolFilterOperator = "OPERATOR_AND"` - `const ToolFilterOperatorOperatorOr ToolFilterOperator = "OPERATOR_OR"` - `Filters []AttributeFilter` - `Attribute AttributeFilterAttribute` - `const AttributeFilterAttributeAttributeUnspecified AttributeFilterAttribute = "ATTRIBUTE_UNSPECIFIED"` - `const AttributeFilterAttributeAttributeName AttributeFilterAttribute = "ATTRIBUTE_NAME"` - `const AttributeFilterAttributeAttributeTitle AttributeFilterAttribute = "ATTRIBUTE_TITLE"` - `const AttributeFilterAttributeAttributeDescription AttributeFilterAttribute = "ATTRIBUTE_DESCRIPTION"` - `Matcher StringMatcher` String matching operations - `CaseSensitive bool` - `Contains string` - `EndsWith string` - `Exact string` - `Regex string` - `StartsWith string` - `Headers map[string, string]` - `IncludeTools ToolFilter` Top-level filter with simple boolean logic (no nesting) - `ToolApprovals ApprovalRequirementFilter` Approval filters that will automatically set the approval requirement on tools synced from an external source - `Always bool` - `Only ToolFilter` Top-level filter with simple boolean logic (no nesting) - `URL string` - `OpenAPI ToolSetAdapterOpenAPI` - `BaseURL string` Base URL for dispatching tool calls. If set, overrides the server resolved from the spec's servers array. - `ExcludeTools ToolFilter` Top-level filter with simple boolean logic (no nesting) - `Headers map[string, string]` Headers sent when fetching the spec from a URL and when dispatching tool calls. - `IncludeTools ToolFilter` Top-level filter with simple boolean logic (no nesting) - `ServerName string` Name of the server entry in the spec's servers array (OpenAPI 3.2 server.name field). Used to select which server URL to dispatch to when base_url is not set. If unset, the first server is used. Ignored when base_url is set. - `ToolApprovals ApprovalRequirementFilter` Approval filters that will automatically set the approval requirement on tools synced from an external source - `UploadID string` ID of a COMPLETE Upload containing the OpenAPI spec document. - `URL string` URL to fetch the OpenAPI spec from. Synced automatically every hour. - `Description string` - `Info ToolSetInfo` Tool set information - `AgentCount int64` - `CreatedBy Profile` A profile identifies a user or non-human principal (such as an API key) at the account level. Profiles are account-scoped and can be granted access to multiple workspaces. - `LastSync Time` - `ToolCount int64` - `Type string` - `VariationAssignment BulkWorkspaceApplyResultDataVariationAssignmentOutcome` - `Action BulkWorkspaceApplyResultDataVariationAssignmentOutcomeAction` - `const BulkWorkspaceApplyResultDataVariationAssignmentOutcomeActionActionUnspecified BulkWorkspaceApplyResultDataVariationAssignmentOutcomeAction = "ACTION_UNSPECIFIED"` - `const BulkWorkspaceApplyResultDataVariationAssignmentOutcomeActionActionCreated BulkWorkspaceApplyResultDataVariationAssignmentOutcomeAction = "ACTION_CREATED"` - `const BulkWorkspaceApplyResultDataVariationAssignmentOutcomeActionActionUpdated BulkWorkspaceApplyResultDataVariationAssignmentOutcomeAction = "ACTION_UPDATED"` - `const BulkWorkspaceApplyResultDataVariationAssignmentOutcomeActionActionUnchanged BulkWorkspaceApplyResultDataVariationAssignmentOutcomeAction = "ACTION_UNCHANGED"` - `const BulkWorkspaceApplyResultDataVariationAssignmentOutcomeActionActionDeleted BulkWorkspaceApplyResultDataVariationAssignmentOutcomeAction = "ACTION_DELETED"` - `const BulkWorkspaceApplyResultDataVariationAssignmentOutcomeActionActionFailed BulkWorkspaceApplyResultDataVariationAssignmentOutcomeAction = "ACTION_FAILED"` - `Error BulkWorkspaceApplyResultDataVariationAssignmentOutcomeError` The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). - `Code int64` The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. - `Details []BulkWorkspaceApplyResultDataVariationAssignmentOutcomeErrorDetail` A list of messages that carry the error details. There is a common set of message types for APIs to use. - `Type string` The type of the serialized message. - `Message string` A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. - `Resource VariationAssignment` A read-only reference to a single tool, tool set, or sub-agent attached to a variation. Read the full set of assignments via `AgentVariationInfo.assignments`; mutations go through the dedicated add/remove assignment endpoints. The `id` identifies the assignment itself (not the referenced resource) and is the handle used to remove the assignment. It is returned by the add endpoint and present on every entry in `AgentVariationInfo.assignments`. - `ID string` - `Agent BareMetadata` BareMetadata contains the minimal metadata for a resource: the ID and an optional human-readable name. These are used for reference fields where the full metadata (account scoping, timestamps, labels, external IDs) is not needed — e.g., the tool references inside an agent variation spec or the tools assigned to an objective. Both fields are server-populated; clients provide IDs through sibling fields rather than by constructing a BareMetadata themselves. - `Tool BareMetadata` BareMetadata contains the minimal metadata for a resource: the ID and an optional human-readable name. These are used for reference fields where the full metadata (account scoping, timestamps, labels, external IDs) is not needed — e.g., the tool references inside an agent variation spec or the tools assigned to an objective. Both fields are server-populated; clients provide IDs through sibling fields rather than by constructing a BareMetadata themselves. - `ToolSet BareMetadata` BareMetadata contains the minimal metadata for a resource: the ID and an optional human-readable name. These are used for reference fields where the full metadata (account scoping, timestamps, labels, external IDs) is not needed — e.g., the tool references inside an agent variation spec or the tools assigned to an objective. Both fields are server-populated; clients provide IDs through sibling fields rather than by constructing a BareMetadata themselves. - `VariationMemoryLayer BulkWorkspaceApplyResultDataVariationMemoryLayerOutcome` - `Action BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeAction` - `const BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeActionActionUnspecified BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeAction = "ACTION_UNSPECIFIED"` - `const BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeActionActionCreated BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeAction = "ACTION_CREATED"` - `const BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeActionActionUpdated BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeAction = "ACTION_UPDATED"` - `const BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeActionActionUnchanged BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeAction = "ACTION_UNCHANGED"` - `const BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeActionActionDeleted BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeAction = "ACTION_DELETED"` - `const BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeActionActionFailed BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeAction = "ACTION_FAILED"` - `Error BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeError` The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). - `Code int64` The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. - `Details []BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeErrorDetail` A list of messages that carry the error details. There is a common set of message types for APIs to use. - `Type string` The type of the serialized message. - `Message string` A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. - `Resource VariationMemoryLayerAssignment` VariationMemoryLayerAssignment attaches a single MemoryLayer to a variation at a given position in the variation's baseline memory stack. A variation has at most one assignment per memory_layer_id. Variations only support whole-layer attachments — entry pinning is an objective-level capability. - `ID string` Assignment row id — handle for removing the assignment. Distinct from the referenced memory layer's id. - `MemoryLayer BareMetadata` BareMetadata contains the minimal metadata for a resource: the ID and an optional human-readable name. These are used for reference fields where the full metadata (account scoping, timestamps, labels, external IDs) is not needed — e.g., the tool references inside an agent variation spec or the tools assigned to an objective. Both fields are server-populated; clients provide IDs through sibling fields rather than by constructing a BareMetadata themselves. - `Position int64` Position in the variation's baseline stack. Lower values sit lower; the highest-position assignment is on top of the variation's baseline. Gaps are fine — only relative position matters. Positions must be unique within a variation; a request that would collide with an existing assignment's position is rejected with InvalidArgument. - `Metadata OperationMetadata` Metadata for ephemeral operations and activities (e.g., objectives, executions, runs) - `ID string` Unique identifier for the operation (prefixed ULID, e.g., "obj_01HXK...") - `AccountID string` Account this operation belongs to for multi-tenant isolation (prefixed ULID) - `CreatedAt Time` Timestamp when this operation was created ULID includes timestamp information, but this explicit field enables easier querying - `ProfileID string` ID of the actor (user or service account) that created this operation - `WorkspaceID string` Workspace this operation belongs to for organizational grouping (prefixed ULID) - `ExternalID string` External ID for the operation (e.g., a workflow ID from an external system) - `Labels map[string, string]` Arbitrary key-value pairs for categorization and filtering Examples: {"priority": "high", "source": "api", "workflow": "onboarding"} ### Example ```go package main import ( "context" "fmt" "github.com/cadenya/cadenya-go" "github.com/cadenya/cadenya-go/option" ) func main() { client := cadenya.NewClient( option.WithAPIKey("My API Key"), ) page, err := client.BulkWorkspaceResources.Results.List( context.TODO(), "workspaceId", "bulkWorkspaceApplyId", cadenya.BulkWorkspaceResourceResultListParams{ }, ) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", page) } ``` #### Response ```json { "items": [ { "data": { "agent": { "action": "ACTION_UNSPECIFIED", "error": { "code": 0, "details": [ { "@type": "@type" } ], "message": "message" }, "externalId": "externalId", "resource": { "metadata": { "id": "id", "accountId": "accountId", "createdAt": "2019-12-27T18:11:19.117Z", "name": "name", "profileId": "profileId", "workspaceId": "workspaceId", "bundleKey": "bundleKey", "externalId": "externalId", "labels": { "foo": "string" } }, "spec": { "status": "AGENT_STATUS_UNSPECIFIED", "variationSelectionMode": "VARIATION_SELECTION_MODE_UNSPECIFIED", "description": "description", "inputDataSchema": { "foo": "bar" }, "outputDefinition": { "foo": "bar" }, "webhookEventsUrl": "webhookEventsUrl" }, "info": { "createdBy": { "metadata": { "id": "id", "accountId": "accountId", "name": "name", "profileId": "profileId", "externalId": "externalId", "labels": { "foo": "string" } }, "spec": { "type": "PROFILE_TYPE_UNSPECIFIED", "email": "email", "name": "name" } }, "variationCount": 0 } } }, "agentSchedule": { "action": "ACTION_UNSPECIFIED", "error": { "code": 0, "details": [ { "@type": "@type" } ], "message": "message" }, "externalId": "externalId", "resource": { "metadata": { "id": "id", "accountId": "accountId", "createdAt": "2019-12-27T18:11:19.117Z", "name": "name", "profileId": "profileId", "workspaceId": "workspaceId", "bundleKey": "bundleKey", "externalId": "externalId", "labels": { "foo": "string" } }, "spec": { "initialMessage": "initialMessage", "schedule": { "calendars": [ { "comment": "comment", "dayOfMonth": [ { "end": 0, "start": 0, "step": 0 } ], "dayOfWeek": [ { "end": 0, "start": 0, "step": 0 } ], "hour": [ { "end": 0, "start": 0, "step": 0 } ], "minute": [ { "end": 0, "start": 0, "step": 0 } ], "month": [ { "end": 0, "start": 0, "step": 0 } ], "second": [ { "end": 0, "start": 0, "step": 0 } ] } ], "intervals": [ { "every": "-160513s", "offset": "-160513s" } ], "timezone": "timezone" }, "data": {}, "overlapPolicy": "OVERLAP_POLICY_UNSPECIFIED", "status": "AGENT_SCHEDULE_STATUS_UNSPECIFIED", "variationId": "variationId" }, "info": { "createdBy": { "metadata": { "id": "id", "accountId": "accountId", "name": "name", "profileId": "profileId", "externalId": "externalId", "labels": { "foo": "string" } }, "spec": { "type": "PROFILE_TYPE_UNSPECIFIED", "email": "email", "name": "name" } }, "lastFireAt": "2019-12-27T18:11:19.117Z", "lastObjectiveId": "lastObjectiveId", "lastSkippedAt": "2019-12-27T18:11:19.117Z", "lastSkipReason": "lastSkipReason", "nextFireAt": "2019-12-27T18:11:19.117Z", "totalFires": 0 } } }, "agentVariation": { "action": "ACTION_UNSPECIFIED", "error": { "code": 0, "details": [ { "@type": "@type" } ], "message": "message" }, "externalId": "externalId", "resource": { "metadata": { "id": "id", "accountId": "accountId", "createdAt": "2019-12-27T18:11:19.117Z", "name": "name", "profileId": "profileId", "workspaceId": "workspaceId", "bundleKey": "bundleKey", "externalId": "externalId", "labels": { "foo": "string" } }, "spec": { "compactionConfig": { "summarization": { "instructions": "instructions" }, "toolResultClearing": { "preserveRecentResults": 0 }, "triggerThreshold": 0 }, "constraints": { "maxSubObjectives": 0, "maxToolCalls": 0 }, "description": "description", "enableEpisodicMemory": true, "episodicMemoryTtl": 0, "modelConfig": { "modelId": "modelId", "temperature": 0 }, "progressiveDiscovery": { "hints": [ "string" ], "maxTools": 0, "rerankThreshold": 0 }, "prompt": "prompt", "weight": 0 }, "info": { "assignments": [ { "id": "id", "agent": { "id": "id", "name": "name" }, "tool": { "id": "id", "name": "name" }, "toolSet": { "id": "id", "name": "name" } } ], "createdBy": { "metadata": { "id": "id", "accountId": "accountId", "name": "name", "profileId": "profileId", "externalId": "externalId", "labels": { "foo": "string" } }, "spec": { "type": "PROFILE_TYPE_UNSPECIFIED", "email": "email", "name": "name" } }, "feedbackCount": 0, "memoryLayerAssignments": [ { "id": "id", "memoryLayer": { "id": "id", "name": "name" }, "position": 0 } ], "memoryLayerCount": 0, "model": { "id": "id", "accountId": "accountId", "createdAt": "2019-12-27T18:11:19.117Z", "name": "name", "profileId": "profileId", "workspaceId": "workspaceId", "bundleKey": "bundleKey", "externalId": "externalId", "labels": { "foo": "string" } }, "score": 0, "subAgentCount": 0, "toolCount": 0, "toolSetCount": 0 } } }, "memoryEntry": { "action": "ACTION_UNSPECIFIED", "error": { "code": 0, "details": [ { "@type": "@type" } ], "message": "message" }, "externalId": "externalId", "resource": { "metadata": { "id": "id", "accountId": "accountId", "createdAt": "2019-12-27T18:11:19.117Z", "name": "name", "profileId": "profileId", "workspaceId": "workspaceId", "bundleKey": "bundleKey", "externalId": "externalId", "labels": { "foo": "string" } }, "spec": { "key": "key", "description": "description" }, "info": { "createdBy": { "metadata": { "id": "id", "accountId": "accountId", "name": "name", "profileId": "profileId", "externalId": "externalId", "labels": { "foo": "string" } }, "spec": { "type": "PROFILE_TYPE_UNSPECIFIED", "email": "email", "name": "name" } }, "memoryLayer": { "id": "id", "accountId": "accountId", "createdAt": "2019-12-27T18:11:19.117Z", "name": "name", "profileId": "profileId", "workspaceId": "workspaceId", "bundleKey": "bundleKey", "externalId": "externalId", "labels": { "foo": "string" } } } } }, "memoryLayer": { "action": "ACTION_UNSPECIFIED", "error": { "code": 0, "details": [ { "@type": "@type" } ], "message": "message" }, "externalId": "externalId", "resource": { "metadata": { "id": "id", "accountId": "accountId", "createdAt": "2019-12-27T18:11:19.117Z", "name": "name", "profileId": "profileId", "workspaceId": "workspaceId", "bundleKey": "bundleKey", "externalId": "externalId", "labels": { "foo": "string" } }, "spec": { "type": "MEMORY_LAYER_TYPE_UNSPECIFIED", "description": "description", "expiresAt": "2019-12-27T18:11:19.117Z", "systemManaged": true }, "info": { "createdBy": { "metadata": { "id": "id", "accountId": "accountId", "name": "name", "profileId": "profileId", "externalId": "externalId", "labels": { "foo": "string" } }, "spec": { "type": "PROFILE_TYPE_UNSPECIFIED", "email": "email", "name": "name" } }, "entryCount": 0, "lastUsedAt": "2019-12-27T18:11:19.117Z" } } }, "tool": { "action": "ACTION_UNSPECIFIED", "error": { "code": 0, "details": [ { "@type": "@type" } ], "message": "message" }, "externalId": "externalId", "resource": { "metadata": { "id": "id", "accountId": "accountId", "createdAt": "2019-12-27T18:11:19.117Z", "name": "name", "profileId": "profileId", "workspaceId": "workspaceId", "bundleKey": "bundleKey", "externalId": "externalId", "labels": { "foo": "string" } }, "spec": { "config": { "http": { "requestMethod": "HTTP_METHOD_UNSPECIFIED", "headers": { "foo": "string" }, "path": "path", "query": "query", "requestBodyContentType": "requestBodyContentType", "requestBodyTemplate": "requestBodyTemplate", "toolName": "toolName" }, "mcp": { "toolDescription": "toolDescription", "toolName": "toolName", "toolTitle": "toolTitle" }, "openapi": { "method": "method", "operationId": "operationId", "path": "path" } }, "description": "description", "parameters": { "foo": "bar" }, "status": "TOOL_STATUS_UNSPECIFIED", "requiresApproval": true }, "info": { "createdBy": { "metadata": { "id": "id", "accountId": "accountId", "name": "name", "profileId": "profileId", "externalId": "externalId", "labels": { "foo": "string" } }, "spec": { "type": "PROFILE_TYPE_UNSPECIFIED", "email": "email", "name": "name" } }, "toolSet": { "id": "id", "accountId": "accountId", "createdAt": "2019-12-27T18:11:19.117Z", "name": "name", "profileId": "profileId", "workspaceId": "workspaceId", "bundleKey": "bundleKey", "externalId": "externalId", "labels": { "foo": "string" } } } } }, "toolSet": { "action": "ACTION_UNSPECIFIED", "error": { "code": 0, "details": [ { "@type": "@type" } ], "message": "message" }, "externalId": "externalId", "resource": { "metadata": { "id": "id", "accountId": "accountId", "createdAt": "2019-12-27T18:11:19.117Z", "name": "name", "profileId": "profileId", "workspaceId": "workspaceId", "bundleKey": "bundleKey", "externalId": "externalId", "labels": { "foo": "string" } }, "spec": { "adapter": { "http": { "baseUrl": "baseUrl", "headers": { "foo": "string" } }, "mcp": { "excludeTools": { "operator": "OPERATOR_UNSPECIFIED", "filters": [ { "attribute": "ATTRIBUTE_UNSPECIFIED", "matcher": { "caseSensitive": true, "contains": "contains", "endsWith": "endsWith", "exact": "exact", "regex": "regex", "startsWith": "startsWith" } } ] }, "headers": { "foo": "string" }, "includeTools": { "operator": "OPERATOR_UNSPECIFIED", "filters": [ { "attribute": "ATTRIBUTE_UNSPECIFIED", "matcher": { "caseSensitive": true, "contains": "contains", "endsWith": "endsWith", "exact": "exact", "regex": "regex", "startsWith": "startsWith" } } ] }, "toolApprovals": { "always": true, "only": { "operator": "OPERATOR_UNSPECIFIED", "filters": [ { "attribute": "ATTRIBUTE_UNSPECIFIED", "matcher": { "caseSensitive": true, "contains": "contains", "endsWith": "endsWith", "exact": "exact", "regex": "regex", "startsWith": "startsWith" } } ] } }, "url": "url" }, "openapi": { "baseUrl": "baseUrl", "excludeTools": { "operator": "OPERATOR_UNSPECIFIED", "filters": [ { "attribute": "ATTRIBUTE_UNSPECIFIED", "matcher": { "caseSensitive": true, "contains": "contains", "endsWith": "endsWith", "exact": "exact", "regex": "regex", "startsWith": "startsWith" } } ] }, "headers": { "foo": "string" }, "includeTools": { "operator": "OPERATOR_UNSPECIFIED", "filters": [ { "attribute": "ATTRIBUTE_UNSPECIFIED", "matcher": { "caseSensitive": true, "contains": "contains", "endsWith": "endsWith", "exact": "exact", "regex": "regex", "startsWith": "startsWith" } } ] }, "serverName": "serverName", "toolApprovals": { "always": true, "only": { "operator": "OPERATOR_UNSPECIFIED", "filters": [ { "attribute": "ATTRIBUTE_UNSPECIFIED", "matcher": { "caseSensitive": true, "contains": "contains", "endsWith": "endsWith", "exact": "exact", "regex": "regex", "startsWith": "startsWith" } } ] } }, "uploadId": "uploadId", "url": "url" } }, "description": "description" }, "info": { "agentCount": 0, "createdBy": { "metadata": { "id": "id", "accountId": "accountId", "name": "name", "profileId": "profileId", "externalId": "externalId", "labels": { "foo": "string" } }, "spec": { "type": "PROFILE_TYPE_UNSPECIFIED", "email": "email", "name": "name" } }, "lastSync": "2019-12-27T18:11:19.117Z", "toolCount": 0 } } }, "type": "type", "variationAssignment": { "action": "ACTION_UNSPECIFIED", "error": { "code": 0, "details": [ { "@type": "@type" } ], "message": "message" }, "resource": { "id": "id", "agent": { "id": "id", "name": "name" }, "tool": { "id": "id", "name": "name" }, "toolSet": { "id": "id", "name": "name" } } }, "variationMemoryLayer": { "action": "ACTION_UNSPECIFIED", "error": { "code": 0, "details": [ { "@type": "@type" } ], "message": "message" }, "resource": { "id": "id", "memoryLayer": { "id": "id", "name": "name" }, "position": 0 } } }, "metadata": { "id": "id", "accountId": "accountId", "createdAt": "2019-12-27T18:11:19.117Z", "profileId": "profileId", "workspaceId": "workspaceId", "externalId": "externalId", "labels": { "foo": "string" } } } ], "pagination": { "nextCursor": "nextCursor", "total": 0 } } ``` ## Domain Types ### Bulk Workspace Apply Result - `type BulkWorkspaceApplyResult struct{…}` One row of the per-resource result list for a BulkWorkspaceApply. Each row is itself an operation that can be paginated, sorted by created_at, and addressed individually. - `Data BulkWorkspaceApplyResultData` Outcome for a single resource within a bulk apply. The `type` field is the discriminator string naming the populated `outcome` oneof variant (e.g., "toolSet", "memoryEntry"). Every outcome shell carries an `action` enum and either a resulting resource snapshot (for ACTION_CREATED, ACTION_UPDATED, ACTION_UNCHANGED, ACTION_DELETED) or a google.rpc.Status (for ACTION_FAILED). - `Agent BulkWorkspaceApplyResultDataAgentOutcome` - `Action BulkWorkspaceApplyResultDataAgentOutcomeAction` - `const BulkWorkspaceApplyResultDataAgentOutcomeActionActionUnspecified BulkWorkspaceApplyResultDataAgentOutcomeAction = "ACTION_UNSPECIFIED"` - `const BulkWorkspaceApplyResultDataAgentOutcomeActionActionCreated BulkWorkspaceApplyResultDataAgentOutcomeAction = "ACTION_CREATED"` - `const BulkWorkspaceApplyResultDataAgentOutcomeActionActionUpdated BulkWorkspaceApplyResultDataAgentOutcomeAction = "ACTION_UPDATED"` - `const BulkWorkspaceApplyResultDataAgentOutcomeActionActionUnchanged BulkWorkspaceApplyResultDataAgentOutcomeAction = "ACTION_UNCHANGED"` - `const BulkWorkspaceApplyResultDataAgentOutcomeActionActionDeleted BulkWorkspaceApplyResultDataAgentOutcomeAction = "ACTION_DELETED"` - `const BulkWorkspaceApplyResultDataAgentOutcomeActionActionFailed BulkWorkspaceApplyResultDataAgentOutcomeAction = "ACTION_FAILED"` - `Error BulkWorkspaceApplyResultDataAgentOutcomeError` The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). - `Code int64` The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. - `Details []BulkWorkspaceApplyResultDataAgentOutcomeErrorDetail` A list of messages that carry the error details. There is a common set of message types for APIs to use. - `Type string` The type of the serialized message. - `Message string` A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. - `ExternalID string` - `Resource Agent` Agent resource - `Metadata ResourceMetadata` Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - `ID string` Unique identifier for the resource (prefixed ULID, e.g., "agent_01HXK...") - `AccountID string` Account this resource belongs to for multi-tenant isolation (prefixed ULID) - `CreatedAt Time` Timestamp when this resource was created - `Name string` Human-readable name for the resource (e.g., "Customer Support Agent", "Email Tool") Required for resources that users interact with directly - `ProfileID string` ID of the actor (user or service account) that created this resource - `WorkspaceID string` Workspace this resource belongs to for organizational grouping (prefixed ULID) - `BundleKey string` Optional bundle ownership key. When set, indicates the resource is managed by a configuration bundle identified by this key. Used by BulkWorkspaceResources.Apply to track which resources belong to which bundle for reconciliation / soft-delete on re-apply. - `ExternalID string` External ID for the resource (e.g., a workflow ID from an external system) - `Labels map[string, string]` Arbitrary key-value pairs for categorization and filtering Examples: {"environment": "production", "team": "platform", "version": "v2"} - `Spec AgentSpec` Agent specification (user-provided configuration) - `Status AgentSpecStatus` Status of the agent - `const AgentSpecStatusAgentStatusUnspecified AgentSpecStatus = "AGENT_STATUS_UNSPECIFIED"` - `const AgentSpecStatusAgentStatusDraft AgentSpecStatus = "AGENT_STATUS_DRAFT"` - `const AgentSpecStatusAgentStatusPublished AgentSpecStatus = "AGENT_STATUS_PUBLISHED"` - `const AgentSpecStatusAgentStatusArchived AgentSpecStatus = "AGENT_STATUS_ARCHIVED"` - `VariationSelectionMode AgentSpecVariationSelectionMode` Controls how variations are automatically selected when creating objectives Defaults to RANDOM when unspecified - `const AgentSpecVariationSelectionModeVariationSelectionModeUnspecified AgentSpecVariationSelectionMode = "VARIATION_SELECTION_MODE_UNSPECIFIED"` - `const AgentSpecVariationSelectionModeVariationSelectionModeRandom AgentSpecVariationSelectionMode = "VARIATION_SELECTION_MODE_RANDOM"` - `const AgentSpecVariationSelectionModeVariationSelectionModeWeighted AgentSpecVariationSelectionMode = "VARIATION_SELECTION_MODE_WEIGHTED"` - `Description string` Description of the agent's purpose - `InputDataSchema map[string, unknown]` InputDataSchema is used for enforcing a data input when objectives are created. This is valuable when using liquid formatting in agent variation prompts. Input data schema is also valuable when using an agent as a sub-agent, as the schema is used as the tool's input parameter schema. If omitted, the sub-agent schema will be loaded with a simple "prompt" free text string as its schema. - `OutputDefinition map[string, unknown]` Optional output definition for objectives created for this agent. When provided, Cadenya will append a tool to that will be called by the LLM in use by the variant to extract information in the format provided here. Use this option when you want structured data to be created by your objectives. - `WebhookEventsURL string` The URL that Cadenya will send events for any objective assigned to the agent. - `Info AgentInfo` AgentInfo contains simple information about an agent for display or quick reference - `CreatedBy Profile` A profile identifies a user or non-human principal (such as an API key) at the account level. Profiles are account-scoped and can be granted access to multiple workspaces. - `Metadata AccountResourceMetadata` AccountResourceMetadata is used to represent a resource that is associated to an account but not to a workspace. - `ID string` Unique identifier for the resource (prefixed ULID, e.g., "apikey_01HXK...") - `AccountID string` Account this resource belongs to for multi-tenant isolation (prefixed ULID) - `Name string` Human-readable name for the resource (e.g., "Customer Support Agent", "Email Tool") Required for resources that users interact with directly - `ProfileID string` - `ExternalID string` External ID for the resource (e.g., a workflow ID from an external system) - `Labels map[string, string]` Arbitrary key-value pairs for categorization and filtering Examples: {"environment": "production", "team": "platform", "version": "v2"} - `Spec ProfileSpec` Configuration for a profile. - `Type ProfileSpecType` Whether this profile represents a human user, an API key, or a system principal. - `const ProfileSpecTypeProfileTypeUnspecified ProfileSpecType = "PROFILE_TYPE_UNSPECIFIED"` - `const ProfileSpecTypeProfileTypeUser ProfileSpecType = "PROFILE_TYPE_USER"` - `const ProfileSpecTypeProfileTypeAPIKey ProfileSpecType = "PROFILE_TYPE_API_KEY"` - `const ProfileSpecTypeProfileTypeSystem ProfileSpecType = "PROFILE_TYPE_SYSTEM"` - `Email string` Email address of the profile. Required and unique within an account for user profiles. - `Name string` Display name (e.g., "Bobby Tables"). - `VariationCount int64` - `AgentSchedule BulkWorkspaceApplyResultDataAgentScheduleOutcome` - `Action BulkWorkspaceApplyResultDataAgentScheduleOutcomeAction` - `const BulkWorkspaceApplyResultDataAgentScheduleOutcomeActionActionUnspecified BulkWorkspaceApplyResultDataAgentScheduleOutcomeAction = "ACTION_UNSPECIFIED"` - `const BulkWorkspaceApplyResultDataAgentScheduleOutcomeActionActionCreated BulkWorkspaceApplyResultDataAgentScheduleOutcomeAction = "ACTION_CREATED"` - `const BulkWorkspaceApplyResultDataAgentScheduleOutcomeActionActionUpdated BulkWorkspaceApplyResultDataAgentScheduleOutcomeAction = "ACTION_UPDATED"` - `const BulkWorkspaceApplyResultDataAgentScheduleOutcomeActionActionUnchanged BulkWorkspaceApplyResultDataAgentScheduleOutcomeAction = "ACTION_UNCHANGED"` - `const BulkWorkspaceApplyResultDataAgentScheduleOutcomeActionActionDeleted BulkWorkspaceApplyResultDataAgentScheduleOutcomeAction = "ACTION_DELETED"` - `const BulkWorkspaceApplyResultDataAgentScheduleOutcomeActionActionFailed BulkWorkspaceApplyResultDataAgentScheduleOutcomeAction = "ACTION_FAILED"` - `Error BulkWorkspaceApplyResultDataAgentScheduleOutcomeError` The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). - `Code int64` The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. - `Details []BulkWorkspaceApplyResultDataAgentScheduleOutcomeErrorDetail` A list of messages that carry the error details. There is a common set of message types for APIs to use. - `Type string` The type of the serialized message. - `Message string` A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. - `ExternalID string` - `Resource AgentSchedule` AgentSchedule resource — a recurring trigger attached to an agent that creates objectives on its cadence. - `Metadata ResourceMetadata` Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - `Spec AgentScheduleSpec` AgentScheduleSpec is the user-provided configuration for a schedule. - `InitialMessage string` The initial message passed to CreateObjective on each fire. Becomes the first user message in the objective's chat history. - `Schedule AgentScheduleSpecSchedule` Schedule defines WHEN the schedule fires. Temporal-style structured form: a list of calendar rules (wall-clock) and/or interval rules (duration), OR'd together. At least one rule is required. - `Calendars []ScheduleCalendar` Wall-clock rules. May be empty if `intervals` is non-empty. - `Comment string` - `DayOfMonth []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `DayOfWeek []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Hour []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Minute []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Month []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Second []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Intervals []ScheduleInterval` Duration-based rules. May be empty if `calendars` is non-empty. - `Every string` - `Offset string` Phase shift within `every`. Must be < `every` (enforced at runtime). - `Timezone string` IANA tz name (e.g. "America/New_York"). Required. Applies to calendars; intervals fire on wall-clock cadence anchored in this zone. - `Data unknown` Optional input data passed to the objective. If the agent has an input_data_schema, this must satisfy it. - `OverlapPolicy AgentScheduleSpecOverlapPolicy` What to do when the previous run is still in flight. Defaults to SKIP. - `const AgentScheduleSpecOverlapPolicyOverlapPolicyUnspecified AgentScheduleSpecOverlapPolicy = "OVERLAP_POLICY_UNSPECIFIED"` - `const AgentScheduleSpecOverlapPolicyOverlapPolicyAllow AgentScheduleSpecOverlapPolicy = "OVERLAP_POLICY_ALLOW"` - `const AgentScheduleSpecOverlapPolicyOverlapPolicySkip AgentScheduleSpecOverlapPolicy = "OVERLAP_POLICY_SKIP"` - `Status AgentScheduleSpecStatus` Lifecycle. Defaults to ACTIVE on create when unspecified. - `const AgentScheduleSpecStatusAgentScheduleStatusUnspecified AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_UNSPECIFIED"` - `const AgentScheduleSpecStatusAgentScheduleStatusActive AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_ACTIVE"` - `const AgentScheduleSpecStatusAgentScheduleStatusPaused AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_PAUSED"` - `const AgentScheduleSpecStatusAgentScheduleStatusArchived AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_ARCHIVED"` - `VariationID string` Optional explicit variation. When unset, the agent's variation_selection_mode chooses per fire. - `Info AgentScheduleInfo` AgentScheduleInfo provides read-only runtime data about a schedule. - `CreatedBy Profile` A profile identifies a user or non-human principal (such as an API key) at the account level. Profiles are account-scoped and can be granted access to multiple workspaces. - `LastFireAt Time` When the schedule last fired (regardless of objective outcome). - `LastObjectiveID string` ID of the most recent objective the schedule created. - `LastSkippedAt Time` When the schedule most recently skipped a fire (SKIP policy + prior in flight). - `LastSkipReason string` Reason for the most recent skip (e.g. "previous objective still running"). - `NextFireAt Time` When the schedule will next fire. Computed from the spec; absent when the schedule is PAUSED/ARCHIVED or has no future fire times. - `TotalFires int64` Lifetime count of objectives created by this schedule. - `AgentVariation BulkWorkspaceApplyResultDataAgentVariationOutcome` - `Action BulkWorkspaceApplyResultDataAgentVariationOutcomeAction` - `const BulkWorkspaceApplyResultDataAgentVariationOutcomeActionActionUnspecified BulkWorkspaceApplyResultDataAgentVariationOutcomeAction = "ACTION_UNSPECIFIED"` - `const BulkWorkspaceApplyResultDataAgentVariationOutcomeActionActionCreated BulkWorkspaceApplyResultDataAgentVariationOutcomeAction = "ACTION_CREATED"` - `const BulkWorkspaceApplyResultDataAgentVariationOutcomeActionActionUpdated BulkWorkspaceApplyResultDataAgentVariationOutcomeAction = "ACTION_UPDATED"` - `const BulkWorkspaceApplyResultDataAgentVariationOutcomeActionActionUnchanged BulkWorkspaceApplyResultDataAgentVariationOutcomeAction = "ACTION_UNCHANGED"` - `const BulkWorkspaceApplyResultDataAgentVariationOutcomeActionActionDeleted BulkWorkspaceApplyResultDataAgentVariationOutcomeAction = "ACTION_DELETED"` - `const BulkWorkspaceApplyResultDataAgentVariationOutcomeActionActionFailed BulkWorkspaceApplyResultDataAgentVariationOutcomeAction = "ACTION_FAILED"` - `Error BulkWorkspaceApplyResultDataAgentVariationOutcomeError` The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). - `Code int64` The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. - `Details []BulkWorkspaceApplyResultDataAgentVariationOutcomeErrorDetail` A list of messages that carry the error details. There is a common set of message types for APIs to use. - `Type string` The type of the serialized message. - `Message string` A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. - `ExternalID string` - `Resource AgentVariation` AgentVariation resource - `Metadata ResourceMetadata` Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - `Spec AgentVariationSpec` AgentVariationSpec defines the operational configuration for a variation - `CompactionConfig AgentVariationSpecCompactionConfig` CompactionConfig defines how context window compaction behaves for objectives using this variation. - `Summarization CompactionConfigSummarizationStrategy` SummarizationStrategy configures LLM-powered summarization of older conversation turns. - `Instructions string` Custom instructions that guide what the summarizer preserves. Replaces the default summarization prompt entirely. Example: "Preserve all code snippets, variable names, and technical decisions." - `ToolResultClearing CompactionConfigToolResultClearingStrategy` ToolResultClearingStrategy configures clearing of older tool result content. - `PreserveRecentResults int64` Number of most recent tool call results to keep intact. Older tool results have their content replaced with "[result cleared]" while preserving the assistant tool call message (function name, arguments). Default: 2 - `TriggerThreshold float64` Trigger threshold as a percentage of the model's context window (0.0 to 1.0). When input tokens reach this percentage of the model's limit, compaction triggers. Default: 0.75 (75%) - `Constraints AgentVariationSpecConstraints` Execution constraints - `MaxSubObjectives int64` The maximum number of sub-objectives that can be created. 0 means no limit. - `MaxToolCalls int64` The maximum number of tool calls that can be made. 0 means no limit. - `Description string` Human-readable description of what this variation does or when it should be used - `EnableEpisodicMemory bool` Enable episodic memory for objectives using this variation. When true, the system automatically creates a document namespace for each objective using the objective's episodic_key as the external_id, allowing the agent to store and retrieve documents specific to that episode. - `EpisodicMemoryTtl int64` How long episodic memories should be retained. After this duration, episodic document namespaces can be automatically cleaned up. If not set, episodic memories are retained indefinitely. - `ModelConfig AgentVariationSpecModelConfig` ModelConfig defines the model configuration for a variation - `ModelID string` The model identifier in family/model format (e.g., "claude/opus-4.6", "claude/sonnet-4.5") - `Temperature float64` Sampling temperature for model inference (0.0 to 1.0) Lower values produce more deterministic outputs, higher values increase randomness - `ProgressiveDiscovery AgentVariationSpecProgressiveDiscovery` ProgressiveDiscovery is used to indicate that the agent should automatically discover tools that are not explicitly assigned to it. Max tools is the maximum number of tools that can be discovered per search. Hints are optional hints for tool search. These are used in conjunction with the context-aware tool search and can help select the best tools for the task. - `Hints []string` - `MaxTools int64` - `RerankThreshold float64` Rerank Threshold is an optional value that instructs whether or not to run a search result through a embedding/reranker process which can improve performance and reduce context bloat when tools reach the configured threshold. If a tool match must exceed 0.8, for example, the tool very closely match the query the tool search performed. - `Prompt string` The system prompt for this variation - `Weight int64` Weight for weighted random selection (>= 0). P(v) = v.weight / sum(all_weights). Only used when the agent's variation_selection_mode is WEIGHTED. A weight of 0 means never auto-selected, but can still be chosen explicitly via variation_id on CreateObjectiveRequest. - `Info AgentVariationInfo` AgentVariationInfo provides read-only summary information about a variation - `Assignments []VariationAssignment` All tools, tool sets, and sub-agents assigned to this variation. Populated on reads so clients can render a variation's full assignment list without calling the add/remove endpoints just to enumerate. - `ID string` - `Agent BareMetadata` BareMetadata contains the minimal metadata for a resource: the ID and an optional human-readable name. These are used for reference fields where the full metadata (account scoping, timestamps, labels, external IDs) is not needed — e.g., the tool references inside an agent variation spec or the tools assigned to an objective. Both fields are server-populated; clients provide IDs through sibling fields rather than by constructing a BareMetadata themselves. - `ID string` - `Name string` Human-readable name of the referenced resource, populated by the server on reads for convenience. Absent on references to resources that do not have a name (e.g., objective tasks). - `Tool BareMetadata` BareMetadata contains the minimal metadata for a resource: the ID and an optional human-readable name. These are used for reference fields where the full metadata (account scoping, timestamps, labels, external IDs) is not needed — e.g., the tool references inside an agent variation spec or the tools assigned to an objective. Both fields are server-populated; clients provide IDs through sibling fields rather than by constructing a BareMetadata themselves. - `ToolSet BareMetadata` BareMetadata contains the minimal metadata for a resource: the ID and an optional human-readable name. These are used for reference fields where the full metadata (account scoping, timestamps, labels, external IDs) is not needed — e.g., the tool references inside an agent variation spec or the tools assigned to an objective. Both fields are server-populated; clients provide IDs through sibling fields rather than by constructing a BareMetadata themselves. - `CreatedBy Profile` A profile identifies a user or non-human principal (such as an API key) at the account level. Profiles are account-scoped and can be granted access to multiple workspaces. - `FeedbackCount int64` Total number of objective feedbacks received for this variation - `MemoryLayerAssignments []VariationMemoryLayerAssignment` Read-only list of memory layer assignments for this variation, returned in ascending `position` (bottom → top). Capped at 10 entries. - `ID string` Assignment row id — handle for removing the assignment. Distinct from the referenced memory layer's id. - `MemoryLayer BareMetadata` BareMetadata contains the minimal metadata for a resource: the ID and an optional human-readable name. These are used for reference fields where the full metadata (account scoping, timestamps, labels, external IDs) is not needed — e.g., the tool references inside an agent variation spec or the tools assigned to an objective. Both fields are server-populated; clients provide IDs through sibling fields rather than by constructing a BareMetadata themselves. - `Position int64` Position in the variation's baseline stack. Lower values sit lower; the highest-position assignment is on top of the variation's baseline. Gaps are fine — only relative position matters. Positions must be unique within a variation; a request that would collide with an existing assignment's position is rejected with InvalidArgument. - `MemoryLayerCount int64` Count of memory layer assignments. - `Model ResourceMetadata` Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - `Score float64` Thompson Sampling score: posterior mean of Beta(ts_alpha, ts_beta). Range [0, 1] where 0.5 = neutral, >0.5 = positive, <0.5 = negative. - `SubAgentCount int64` Number of sub-agents assigned to this variation - `ToolCount int64` Number of individual tools assigned to this variation - `ToolSetCount int64` Number of tool sets assigned to this variation - `MemoryEntry BulkWorkspaceApplyResultDataMemoryEntryOutcome` - `Action BulkWorkspaceApplyResultDataMemoryEntryOutcomeAction` - `const BulkWorkspaceApplyResultDataMemoryEntryOutcomeActionActionUnspecified BulkWorkspaceApplyResultDataMemoryEntryOutcomeAction = "ACTION_UNSPECIFIED"` - `const BulkWorkspaceApplyResultDataMemoryEntryOutcomeActionActionCreated BulkWorkspaceApplyResultDataMemoryEntryOutcomeAction = "ACTION_CREATED"` - `const BulkWorkspaceApplyResultDataMemoryEntryOutcomeActionActionUpdated BulkWorkspaceApplyResultDataMemoryEntryOutcomeAction = "ACTION_UPDATED"` - `const BulkWorkspaceApplyResultDataMemoryEntryOutcomeActionActionUnchanged BulkWorkspaceApplyResultDataMemoryEntryOutcomeAction = "ACTION_UNCHANGED"` - `const BulkWorkspaceApplyResultDataMemoryEntryOutcomeActionActionDeleted BulkWorkspaceApplyResultDataMemoryEntryOutcomeAction = "ACTION_DELETED"` - `const BulkWorkspaceApplyResultDataMemoryEntryOutcomeActionActionFailed BulkWorkspaceApplyResultDataMemoryEntryOutcomeAction = "ACTION_FAILED"` - `Error BulkWorkspaceApplyResultDataMemoryEntryOutcomeError` The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). - `Code int64` The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. - `Details []BulkWorkspaceApplyResultDataMemoryEntryOutcomeErrorDetail` A list of messages that carry the error details. There is a common set of message types for APIs to use. - `Type string` The type of the serialized message. - `Message string` A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. - `ExternalID string` - `Resource MemoryEntry` MemoryEntry is a single keyed value within a MemoryLayer. Entries are addressed by their key, which follows the S3 object key safe-character convention (see MemoryEntrySpec.key for the full rule). Keys are unique within a single layer; the same key may appear in multiple layers, in which case the LIFO stack-walk determines which one wins for a given objective. MemoryEntry is the summary shape, returned by ListMemoryEntries. It does not carry the entry body — callers that need the body must fetch the entry individually via GetMemoryEntry, which returns a MemoryEntryDetail. - `Metadata ResourceMetadata` Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - `Spec MemoryEntrySpec` MemoryEntrySpec is the metadata portion of an entry — the fields that identify and describe it, without the body. It appears on both the summary (MemoryEntry) and detail (MemoryEntryDetail) views. - `Key string` The lookup key for this entry within its layer. Must conform to the S3 object key safe-characters spec: ASCII alphanumerics and the special characters !, -, _, ., *, ', (, ), and /. Forward slashes may be used to suggest hierarchy (e.g., "skills/postmortem/write"), but lookups are flat — the key is a single opaque string, not a path. Additional rules enforced by the service: - May not begin or end with / - May not contain consecutive slashes (//) - May not begin with reserved prefixes (cadenya/, system/) - Case-sensitive - Unique within the parent layer For skills entries, this key is also the id the model passes to memory_load_skill when it decides to load the entry's content. - `Description string` One-line "when to use this" hint shown in the frontmatter manifest for skills entries. The model uses this to decide whether to load the body, so it should be written for the model as the audience. Ignored for layer types that do not advertise frontmatter. - `Info MemoryEntryInfo` - `CreatedBy Profile` A profile identifies a user or non-human principal (such as an API key) at the account level. Profiles are account-scoped and can be granted access to multiple workspaces. - `MemoryLayer ResourceMetadata` Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - `MemoryLayer BulkWorkspaceApplyResultDataMemoryLayerOutcome` - `Action BulkWorkspaceApplyResultDataMemoryLayerOutcomeAction` - `const BulkWorkspaceApplyResultDataMemoryLayerOutcomeActionActionUnspecified BulkWorkspaceApplyResultDataMemoryLayerOutcomeAction = "ACTION_UNSPECIFIED"` - `const BulkWorkspaceApplyResultDataMemoryLayerOutcomeActionActionCreated BulkWorkspaceApplyResultDataMemoryLayerOutcomeAction = "ACTION_CREATED"` - `const BulkWorkspaceApplyResultDataMemoryLayerOutcomeActionActionUpdated BulkWorkspaceApplyResultDataMemoryLayerOutcomeAction = "ACTION_UPDATED"` - `const BulkWorkspaceApplyResultDataMemoryLayerOutcomeActionActionUnchanged BulkWorkspaceApplyResultDataMemoryLayerOutcomeAction = "ACTION_UNCHANGED"` - `const BulkWorkspaceApplyResultDataMemoryLayerOutcomeActionActionDeleted BulkWorkspaceApplyResultDataMemoryLayerOutcomeAction = "ACTION_DELETED"` - `const BulkWorkspaceApplyResultDataMemoryLayerOutcomeActionActionFailed BulkWorkspaceApplyResultDataMemoryLayerOutcomeAction = "ACTION_FAILED"` - `Error BulkWorkspaceApplyResultDataMemoryLayerOutcomeError` The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). - `Code int64` The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. - `Details []BulkWorkspaceApplyResultDataMemoryLayerOutcomeErrorDetail` A list of messages that carry the error details. There is a common set of message types for APIs to use. - `Type string` The type of the serialized message. - `Message string` A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. - `ExternalID string` - `Resource MemoryLayer` MemoryLayer is a named container of memory entries that can be composed into an objective's memory stack. Layers are workspace-scoped resources. The layer type controls how its entries participate in the agent loop — see MemoryLayerType for details. See "Memory stack composition" above for how layers compose at lookup time. - `Metadata ResourceMetadata` Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - `Spec MemoryLayerSpec` - `Type MemoryLayerSpecType` - `const MemoryLayerSpecTypeMemoryLayerTypeUnspecified MemoryLayerSpecType = "MEMORY_LAYER_TYPE_UNSPECIFIED"` - `const MemoryLayerSpecTypeMemoryLayerTypeEpisodic MemoryLayerSpecType = "MEMORY_LAYER_TYPE_EPISODIC"` - `const MemoryLayerSpecTypeMemoryLayerTypeSkills MemoryLayerSpecType = "MEMORY_LAYER_TYPE_SKILLS"` - `Description string` Human-readable description of the layer's purpose. Encouraged for user-created layers; system-managed layers may have a generated description. - `ExpiresAt Time` For layers with a finite lifetime (e.g., episodic), the time at which the layer becomes eligible for cleanup. Set by the system; unset for persistent layers. - `SystemManaged bool` Server-set. True for layers managed by the system (e.g., episodic layers created automatically when an objective uses an episodic_key). System-managed layers cannot be assigned to objective stacks via the API and cannot be mutated by clients — their lifecycle is controlled entirely by the runtime. - `Info MemoryLayerInfo` - `CreatedBy Profile` A profile identifies a user or non-human principal (such as an API key) at the account level. Profiles are account-scoped and can be granted access to multiple workspaces. - `EntryCount int64` Number of entries currently in this layer. - `LastUsedAt Time` Timestamp of the most recent objective that resolved against this layer. Useful for surfacing unused layers in the dashboard. - `Tool BulkWorkspaceApplyResultDataToolOutcome` - `Action BulkWorkspaceApplyResultDataToolOutcomeAction` - `const BulkWorkspaceApplyResultDataToolOutcomeActionActionUnspecified BulkWorkspaceApplyResultDataToolOutcomeAction = "ACTION_UNSPECIFIED"` - `const BulkWorkspaceApplyResultDataToolOutcomeActionActionCreated BulkWorkspaceApplyResultDataToolOutcomeAction = "ACTION_CREATED"` - `const BulkWorkspaceApplyResultDataToolOutcomeActionActionUpdated BulkWorkspaceApplyResultDataToolOutcomeAction = "ACTION_UPDATED"` - `const BulkWorkspaceApplyResultDataToolOutcomeActionActionUnchanged BulkWorkspaceApplyResultDataToolOutcomeAction = "ACTION_UNCHANGED"` - `const BulkWorkspaceApplyResultDataToolOutcomeActionActionDeleted BulkWorkspaceApplyResultDataToolOutcomeAction = "ACTION_DELETED"` - `const BulkWorkspaceApplyResultDataToolOutcomeActionActionFailed BulkWorkspaceApplyResultDataToolOutcomeAction = "ACTION_FAILED"` - `Error BulkWorkspaceApplyResultDataToolOutcomeError` The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). - `Code int64` The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. - `Details []BulkWorkspaceApplyResultDataToolOutcomeErrorDetail` A list of messages that carry the error details. There is a common set of message types for APIs to use. - `Type string` The type of the serialized message. - `Message string` A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. - `ExternalID string` - `Resource Tool` - `Metadata ResourceMetadata` Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - `Spec ToolSpec` - `Config ToolSpecConfig` Config defines the adapter to use for the tool. This is used to determine how the tool is called. For example, if the tool is an HTTP tool, the adapter will be Http. If the tool is an inline tool, the adapter will be Inline. - `HTTP ConfigHTTP` - `RequestMethod ConfigHTTPRequestMethod` - `const ConfigHTTPRequestMethodHTTPMethodUnspecified ConfigHTTPRequestMethod = "HTTP_METHOD_UNSPECIFIED"` - `const ConfigHTTPRequestMethodGet ConfigHTTPRequestMethod = "GET"` - `const ConfigHTTPRequestMethodPost ConfigHTTPRequestMethod = "POST"` - `const ConfigHTTPRequestMethodPut ConfigHTTPRequestMethod = "PUT"` - `const ConfigHTTPRequestMethodPatch ConfigHTTPRequestMethod = "PATCH"` - `const ConfigHTTPRequestMethodDelete ConfigHTTPRequestMethod = "DELETE"` - `Headers map[string, string]` - `Path string` - `Query string` - `RequestBodyContentType string` - `RequestBodyTemplate string` These are only used when the request method is a POST, PUT, or PATCH - `ToolName string` The tool name (commonly an "operation id" in OpenAPI specs) to call on the HTTP adapter. This is used to match the tool spec to the correct endpoint on the HTTP adapter. it will be derived from the name of the tool if not provided. - `Mcp ConfigMcp` - `ToolDescription string` - `ToolName string` - `ToolTitle string` - `OpenAPI ConfigOpenAPI` - `Method string` - `OperationID string` - `Path string` - `Description string` - `Parameters map[string, unknown]` - `Status ToolSpecStatus` - `const ToolSpecStatusToolStatusUnspecified ToolSpecStatus = "TOOL_STATUS_UNSPECIFIED"` - `const ToolSpecStatusToolStatusAvailable ToolSpecStatus = "TOOL_STATUS_AVAILABLE"` - `const ToolSpecStatusToolStatusOmitted ToolSpecStatus = "TOOL_STATUS_OMITTED"` - `const ToolSpecStatusToolStatusArchived ToolSpecStatus = "TOOL_STATUS_ARCHIVED"` - `RequiresApproval bool` - `Info ToolInfo` - `CreatedBy Profile` A profile identifies a user or non-human principal (such as an API key) at the account level. Profiles are account-scoped and can be granted access to multiple workspaces. - `ToolSet ResourceMetadata` Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - `ToolSet BulkWorkspaceApplyResultDataToolSetOutcome` - `Action BulkWorkspaceApplyResultDataToolSetOutcomeAction` - `const BulkWorkspaceApplyResultDataToolSetOutcomeActionActionUnspecified BulkWorkspaceApplyResultDataToolSetOutcomeAction = "ACTION_UNSPECIFIED"` - `const BulkWorkspaceApplyResultDataToolSetOutcomeActionActionCreated BulkWorkspaceApplyResultDataToolSetOutcomeAction = "ACTION_CREATED"` - `const BulkWorkspaceApplyResultDataToolSetOutcomeActionActionUpdated BulkWorkspaceApplyResultDataToolSetOutcomeAction = "ACTION_UPDATED"` - `const BulkWorkspaceApplyResultDataToolSetOutcomeActionActionUnchanged BulkWorkspaceApplyResultDataToolSetOutcomeAction = "ACTION_UNCHANGED"` - `const BulkWorkspaceApplyResultDataToolSetOutcomeActionActionDeleted BulkWorkspaceApplyResultDataToolSetOutcomeAction = "ACTION_DELETED"` - `const BulkWorkspaceApplyResultDataToolSetOutcomeActionActionFailed BulkWorkspaceApplyResultDataToolSetOutcomeAction = "ACTION_FAILED"` - `Error BulkWorkspaceApplyResultDataToolSetOutcomeError` The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). - `Code int64` The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. - `Details []BulkWorkspaceApplyResultDataToolSetOutcomeErrorDetail` A list of messages that carry the error details. There is a common set of message types for APIs to use. - `Type string` The type of the serialized message. - `Message string` A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. - `ExternalID string` - `Resource ToolSet` - `Metadata ResourceMetadata` Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - `Spec ToolSetSpec` - `Adapter ToolSetAdapter` - `HTTP ToolSetAdapterHTTP` - `BaseURL string` - `Headers map[string, string]` - `Mcp ToolSetAdapterMcp` - `ExcludeTools ToolFilter` Top-level filter with simple boolean logic (no nesting) - `Operator ToolFilterOperator` - `const ToolFilterOperatorOperatorUnspecified ToolFilterOperator = "OPERATOR_UNSPECIFIED"` - `const ToolFilterOperatorOperatorAnd ToolFilterOperator = "OPERATOR_AND"` - `const ToolFilterOperatorOperatorOr ToolFilterOperator = "OPERATOR_OR"` - `Filters []AttributeFilter` - `Attribute AttributeFilterAttribute` - `const AttributeFilterAttributeAttributeUnspecified AttributeFilterAttribute = "ATTRIBUTE_UNSPECIFIED"` - `const AttributeFilterAttributeAttributeName AttributeFilterAttribute = "ATTRIBUTE_NAME"` - `const AttributeFilterAttributeAttributeTitle AttributeFilterAttribute = "ATTRIBUTE_TITLE"` - `const AttributeFilterAttributeAttributeDescription AttributeFilterAttribute = "ATTRIBUTE_DESCRIPTION"` - `Matcher StringMatcher` String matching operations - `CaseSensitive bool` - `Contains string` - `EndsWith string` - `Exact string` - `Regex string` - `StartsWith string` - `Headers map[string, string]` - `IncludeTools ToolFilter` Top-level filter with simple boolean logic (no nesting) - `ToolApprovals ApprovalRequirementFilter` Approval filters that will automatically set the approval requirement on tools synced from an external source - `Always bool` - `Only ToolFilter` Top-level filter with simple boolean logic (no nesting) - `URL string` - `OpenAPI ToolSetAdapterOpenAPI` - `BaseURL string` Base URL for dispatching tool calls. If set, overrides the server resolved from the spec's servers array. - `ExcludeTools ToolFilter` Top-level filter with simple boolean logic (no nesting) - `Headers map[string, string]` Headers sent when fetching the spec from a URL and when dispatching tool calls. - `IncludeTools ToolFilter` Top-level filter with simple boolean logic (no nesting) - `ServerName string` Name of the server entry in the spec's servers array (OpenAPI 3.2 server.name field). Used to select which server URL to dispatch to when base_url is not set. If unset, the first server is used. Ignored when base_url is set. - `ToolApprovals ApprovalRequirementFilter` Approval filters that will automatically set the approval requirement on tools synced from an external source - `UploadID string` ID of a COMPLETE Upload containing the OpenAPI spec document. - `URL string` URL to fetch the OpenAPI spec from. Synced automatically every hour. - `Description string` - `Info ToolSetInfo` Tool set information - `AgentCount int64` - `CreatedBy Profile` A profile identifies a user or non-human principal (such as an API key) at the account level. Profiles are account-scoped and can be granted access to multiple workspaces. - `LastSync Time` - `ToolCount int64` - `Type string` - `VariationAssignment BulkWorkspaceApplyResultDataVariationAssignmentOutcome` - `Action BulkWorkspaceApplyResultDataVariationAssignmentOutcomeAction` - `const BulkWorkspaceApplyResultDataVariationAssignmentOutcomeActionActionUnspecified BulkWorkspaceApplyResultDataVariationAssignmentOutcomeAction = "ACTION_UNSPECIFIED"` - `const BulkWorkspaceApplyResultDataVariationAssignmentOutcomeActionActionCreated BulkWorkspaceApplyResultDataVariationAssignmentOutcomeAction = "ACTION_CREATED"` - `const BulkWorkspaceApplyResultDataVariationAssignmentOutcomeActionActionUpdated BulkWorkspaceApplyResultDataVariationAssignmentOutcomeAction = "ACTION_UPDATED"` - `const BulkWorkspaceApplyResultDataVariationAssignmentOutcomeActionActionUnchanged BulkWorkspaceApplyResultDataVariationAssignmentOutcomeAction = "ACTION_UNCHANGED"` - `const BulkWorkspaceApplyResultDataVariationAssignmentOutcomeActionActionDeleted BulkWorkspaceApplyResultDataVariationAssignmentOutcomeAction = "ACTION_DELETED"` - `const BulkWorkspaceApplyResultDataVariationAssignmentOutcomeActionActionFailed BulkWorkspaceApplyResultDataVariationAssignmentOutcomeAction = "ACTION_FAILED"` - `Error BulkWorkspaceApplyResultDataVariationAssignmentOutcomeError` The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). - `Code int64` The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. - `Details []BulkWorkspaceApplyResultDataVariationAssignmentOutcomeErrorDetail` A list of messages that carry the error details. There is a common set of message types for APIs to use. - `Type string` The type of the serialized message. - `Message string` A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. - `Resource VariationAssignment` A read-only reference to a single tool, tool set, or sub-agent attached to a variation. Read the full set of assignments via `AgentVariationInfo.assignments`; mutations go through the dedicated add/remove assignment endpoints. The `id` identifies the assignment itself (not the referenced resource) and is the handle used to remove the assignment. It is returned by the add endpoint and present on every entry in `AgentVariationInfo.assignments`. - `ID string` - `Agent BareMetadata` BareMetadata contains the minimal metadata for a resource: the ID and an optional human-readable name. These are used for reference fields where the full metadata (account scoping, timestamps, labels, external IDs) is not needed — e.g., the tool references inside an agent variation spec or the tools assigned to an objective. Both fields are server-populated; clients provide IDs through sibling fields rather than by constructing a BareMetadata themselves. - `Tool BareMetadata` BareMetadata contains the minimal metadata for a resource: the ID and an optional human-readable name. These are used for reference fields where the full metadata (account scoping, timestamps, labels, external IDs) is not needed — e.g., the tool references inside an agent variation spec or the tools assigned to an objective. Both fields are server-populated; clients provide IDs through sibling fields rather than by constructing a BareMetadata themselves. - `ToolSet BareMetadata` BareMetadata contains the minimal metadata for a resource: the ID and an optional human-readable name. These are used for reference fields where the full metadata (account scoping, timestamps, labels, external IDs) is not needed — e.g., the tool references inside an agent variation spec or the tools assigned to an objective. Both fields are server-populated; clients provide IDs through sibling fields rather than by constructing a BareMetadata themselves. - `VariationMemoryLayer BulkWorkspaceApplyResultDataVariationMemoryLayerOutcome` - `Action BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeAction` - `const BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeActionActionUnspecified BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeAction = "ACTION_UNSPECIFIED"` - `const BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeActionActionCreated BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeAction = "ACTION_CREATED"` - `const BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeActionActionUpdated BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeAction = "ACTION_UPDATED"` - `const BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeActionActionUnchanged BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeAction = "ACTION_UNCHANGED"` - `const BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeActionActionDeleted BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeAction = "ACTION_DELETED"` - `const BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeActionActionFailed BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeAction = "ACTION_FAILED"` - `Error BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeError` The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). - `Code int64` The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. - `Details []BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeErrorDetail` A list of messages that carry the error details. There is a common set of message types for APIs to use. - `Type string` The type of the serialized message. - `Message string` A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. - `Resource VariationMemoryLayerAssignment` VariationMemoryLayerAssignment attaches a single MemoryLayer to a variation at a given position in the variation's baseline memory stack. A variation has at most one assignment per memory_layer_id. Variations only support whole-layer attachments — entry pinning is an objective-level capability. - `ID string` Assignment row id — handle for removing the assignment. Distinct from the referenced memory layer's id. - `MemoryLayer BareMetadata` BareMetadata contains the minimal metadata for a resource: the ID and an optional human-readable name. These are used for reference fields where the full metadata (account scoping, timestamps, labels, external IDs) is not needed — e.g., the tool references inside an agent variation spec or the tools assigned to an objective. Both fields are server-populated; clients provide IDs through sibling fields rather than by constructing a BareMetadata themselves. - `Position int64` Position in the variation's baseline stack. Lower values sit lower; the highest-position assignment is on top of the variation's baseline. Gaps are fine — only relative position matters. Positions must be unique within a variation; a request that would collide with an existing assignment's position is rejected with InvalidArgument. - `Metadata OperationMetadata` Metadata for ephemeral operations and activities (e.g., objectives, executions, runs) - `ID string` Unique identifier for the operation (prefixed ULID, e.g., "obj_01HXK...") - `AccountID string` Account this operation belongs to for multi-tenant isolation (prefixed ULID) - `CreatedAt Time` Timestamp when this operation was created ULID includes timestamp information, but this explicit field enables easier querying - `ProfileID string` ID of the actor (user or service account) that created this operation - `WorkspaceID string` Workspace this operation belongs to for organizational grouping (prefixed ULID) - `ExternalID string` External ID for the operation (e.g., a workflow ID from an external system) - `Labels map[string, string]` Arbitrary key-value pairs for categorization and filtering Examples: {"priority": "high", "source": "api", "workflow": "onboarding"} ### Bulk Workspace Apply Result Data - `type BulkWorkspaceApplyResultData struct{…}` Outcome for a single resource within a bulk apply. The `type` field is the discriminator string naming the populated `outcome` oneof variant (e.g., "toolSet", "memoryEntry"). Every outcome shell carries an `action` enum and either a resulting resource snapshot (for ACTION_CREATED, ACTION_UPDATED, ACTION_UNCHANGED, ACTION_DELETED) or a google.rpc.Status (for ACTION_FAILED). - `Agent BulkWorkspaceApplyResultDataAgentOutcome` - `Action BulkWorkspaceApplyResultDataAgentOutcomeAction` - `const BulkWorkspaceApplyResultDataAgentOutcomeActionActionUnspecified BulkWorkspaceApplyResultDataAgentOutcomeAction = "ACTION_UNSPECIFIED"` - `const BulkWorkspaceApplyResultDataAgentOutcomeActionActionCreated BulkWorkspaceApplyResultDataAgentOutcomeAction = "ACTION_CREATED"` - `const BulkWorkspaceApplyResultDataAgentOutcomeActionActionUpdated BulkWorkspaceApplyResultDataAgentOutcomeAction = "ACTION_UPDATED"` - `const BulkWorkspaceApplyResultDataAgentOutcomeActionActionUnchanged BulkWorkspaceApplyResultDataAgentOutcomeAction = "ACTION_UNCHANGED"` - `const BulkWorkspaceApplyResultDataAgentOutcomeActionActionDeleted BulkWorkspaceApplyResultDataAgentOutcomeAction = "ACTION_DELETED"` - `const BulkWorkspaceApplyResultDataAgentOutcomeActionActionFailed BulkWorkspaceApplyResultDataAgentOutcomeAction = "ACTION_FAILED"` - `Error BulkWorkspaceApplyResultDataAgentOutcomeError` The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). - `Code int64` The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. - `Details []BulkWorkspaceApplyResultDataAgentOutcomeErrorDetail` A list of messages that carry the error details. There is a common set of message types for APIs to use. - `Type string` The type of the serialized message. - `Message string` A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. - `ExternalID string` - `Resource Agent` Agent resource - `Metadata ResourceMetadata` Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - `ID string` Unique identifier for the resource (prefixed ULID, e.g., "agent_01HXK...") - `AccountID string` Account this resource belongs to for multi-tenant isolation (prefixed ULID) - `CreatedAt Time` Timestamp when this resource was created - `Name string` Human-readable name for the resource (e.g., "Customer Support Agent", "Email Tool") Required for resources that users interact with directly - `ProfileID string` ID of the actor (user or service account) that created this resource - `WorkspaceID string` Workspace this resource belongs to for organizational grouping (prefixed ULID) - `BundleKey string` Optional bundle ownership key. When set, indicates the resource is managed by a configuration bundle identified by this key. Used by BulkWorkspaceResources.Apply to track which resources belong to which bundle for reconciliation / soft-delete on re-apply. - `ExternalID string` External ID for the resource (e.g., a workflow ID from an external system) - `Labels map[string, string]` Arbitrary key-value pairs for categorization and filtering Examples: {"environment": "production", "team": "platform", "version": "v2"} - `Spec AgentSpec` Agent specification (user-provided configuration) - `Status AgentSpecStatus` Status of the agent - `const AgentSpecStatusAgentStatusUnspecified AgentSpecStatus = "AGENT_STATUS_UNSPECIFIED"` - `const AgentSpecStatusAgentStatusDraft AgentSpecStatus = "AGENT_STATUS_DRAFT"` - `const AgentSpecStatusAgentStatusPublished AgentSpecStatus = "AGENT_STATUS_PUBLISHED"` - `const AgentSpecStatusAgentStatusArchived AgentSpecStatus = "AGENT_STATUS_ARCHIVED"` - `VariationSelectionMode AgentSpecVariationSelectionMode` Controls how variations are automatically selected when creating objectives Defaults to RANDOM when unspecified - `const AgentSpecVariationSelectionModeVariationSelectionModeUnspecified AgentSpecVariationSelectionMode = "VARIATION_SELECTION_MODE_UNSPECIFIED"` - `const AgentSpecVariationSelectionModeVariationSelectionModeRandom AgentSpecVariationSelectionMode = "VARIATION_SELECTION_MODE_RANDOM"` - `const AgentSpecVariationSelectionModeVariationSelectionModeWeighted AgentSpecVariationSelectionMode = "VARIATION_SELECTION_MODE_WEIGHTED"` - `Description string` Description of the agent's purpose - `InputDataSchema map[string, unknown]` InputDataSchema is used for enforcing a data input when objectives are created. This is valuable when using liquid formatting in agent variation prompts. Input data schema is also valuable when using an agent as a sub-agent, as the schema is used as the tool's input parameter schema. If omitted, the sub-agent schema will be loaded with a simple "prompt" free text string as its schema. - `OutputDefinition map[string, unknown]` Optional output definition for objectives created for this agent. When provided, Cadenya will append a tool to that will be called by the LLM in use by the variant to extract information in the format provided here. Use this option when you want structured data to be created by your objectives. - `WebhookEventsURL string` The URL that Cadenya will send events for any objective assigned to the agent. - `Info AgentInfo` AgentInfo contains simple information about an agent for display or quick reference - `CreatedBy Profile` A profile identifies a user or non-human principal (such as an API key) at the account level. Profiles are account-scoped and can be granted access to multiple workspaces. - `Metadata AccountResourceMetadata` AccountResourceMetadata is used to represent a resource that is associated to an account but not to a workspace. - `ID string` Unique identifier for the resource (prefixed ULID, e.g., "apikey_01HXK...") - `AccountID string` Account this resource belongs to for multi-tenant isolation (prefixed ULID) - `Name string` Human-readable name for the resource (e.g., "Customer Support Agent", "Email Tool") Required for resources that users interact with directly - `ProfileID string` - `ExternalID string` External ID for the resource (e.g., a workflow ID from an external system) - `Labels map[string, string]` Arbitrary key-value pairs for categorization and filtering Examples: {"environment": "production", "team": "platform", "version": "v2"} - `Spec ProfileSpec` Configuration for a profile. - `Type ProfileSpecType` Whether this profile represents a human user, an API key, or a system principal. - `const ProfileSpecTypeProfileTypeUnspecified ProfileSpecType = "PROFILE_TYPE_UNSPECIFIED"` - `const ProfileSpecTypeProfileTypeUser ProfileSpecType = "PROFILE_TYPE_USER"` - `const ProfileSpecTypeProfileTypeAPIKey ProfileSpecType = "PROFILE_TYPE_API_KEY"` - `const ProfileSpecTypeProfileTypeSystem ProfileSpecType = "PROFILE_TYPE_SYSTEM"` - `Email string` Email address of the profile. Required and unique within an account for user profiles. - `Name string` Display name (e.g., "Bobby Tables"). - `VariationCount int64` - `AgentSchedule BulkWorkspaceApplyResultDataAgentScheduleOutcome` - `Action BulkWorkspaceApplyResultDataAgentScheduleOutcomeAction` - `const BulkWorkspaceApplyResultDataAgentScheduleOutcomeActionActionUnspecified BulkWorkspaceApplyResultDataAgentScheduleOutcomeAction = "ACTION_UNSPECIFIED"` - `const BulkWorkspaceApplyResultDataAgentScheduleOutcomeActionActionCreated BulkWorkspaceApplyResultDataAgentScheduleOutcomeAction = "ACTION_CREATED"` - `const BulkWorkspaceApplyResultDataAgentScheduleOutcomeActionActionUpdated BulkWorkspaceApplyResultDataAgentScheduleOutcomeAction = "ACTION_UPDATED"` - `const BulkWorkspaceApplyResultDataAgentScheduleOutcomeActionActionUnchanged BulkWorkspaceApplyResultDataAgentScheduleOutcomeAction = "ACTION_UNCHANGED"` - `const BulkWorkspaceApplyResultDataAgentScheduleOutcomeActionActionDeleted BulkWorkspaceApplyResultDataAgentScheduleOutcomeAction = "ACTION_DELETED"` - `const BulkWorkspaceApplyResultDataAgentScheduleOutcomeActionActionFailed BulkWorkspaceApplyResultDataAgentScheduleOutcomeAction = "ACTION_FAILED"` - `Error BulkWorkspaceApplyResultDataAgentScheduleOutcomeError` The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). - `Code int64` The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. - `Details []BulkWorkspaceApplyResultDataAgentScheduleOutcomeErrorDetail` A list of messages that carry the error details. There is a common set of message types for APIs to use. - `Type string` The type of the serialized message. - `Message string` A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. - `ExternalID string` - `Resource AgentSchedule` AgentSchedule resource — a recurring trigger attached to an agent that creates objectives on its cadence. - `Metadata ResourceMetadata` Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - `Spec AgentScheduleSpec` AgentScheduleSpec is the user-provided configuration for a schedule. - `InitialMessage string` The initial message passed to CreateObjective on each fire. Becomes the first user message in the objective's chat history. - `Schedule AgentScheduleSpecSchedule` Schedule defines WHEN the schedule fires. Temporal-style structured form: a list of calendar rules (wall-clock) and/or interval rules (duration), OR'd together. At least one rule is required. - `Calendars []ScheduleCalendar` Wall-clock rules. May be empty if `intervals` is non-empty. - `Comment string` - `DayOfMonth []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `DayOfWeek []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Hour []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Minute []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Month []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Second []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Intervals []ScheduleInterval` Duration-based rules. May be empty if `calendars` is non-empty. - `Every string` - `Offset string` Phase shift within `every`. Must be < `every` (enforced at runtime). - `Timezone string` IANA tz name (e.g. "America/New_York"). Required. Applies to calendars; intervals fire on wall-clock cadence anchored in this zone. - `Data unknown` Optional input data passed to the objective. If the agent has an input_data_schema, this must satisfy it. - `OverlapPolicy AgentScheduleSpecOverlapPolicy` What to do when the previous run is still in flight. Defaults to SKIP. - `const AgentScheduleSpecOverlapPolicyOverlapPolicyUnspecified AgentScheduleSpecOverlapPolicy = "OVERLAP_POLICY_UNSPECIFIED"` - `const AgentScheduleSpecOverlapPolicyOverlapPolicyAllow AgentScheduleSpecOverlapPolicy = "OVERLAP_POLICY_ALLOW"` - `const AgentScheduleSpecOverlapPolicyOverlapPolicySkip AgentScheduleSpecOverlapPolicy = "OVERLAP_POLICY_SKIP"` - `Status AgentScheduleSpecStatus` Lifecycle. Defaults to ACTIVE on create when unspecified. - `const AgentScheduleSpecStatusAgentScheduleStatusUnspecified AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_UNSPECIFIED"` - `const AgentScheduleSpecStatusAgentScheduleStatusActive AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_ACTIVE"` - `const AgentScheduleSpecStatusAgentScheduleStatusPaused AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_PAUSED"` - `const AgentScheduleSpecStatusAgentScheduleStatusArchived AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_ARCHIVED"` - `VariationID string` Optional explicit variation. When unset, the agent's variation_selection_mode chooses per fire. - `Info AgentScheduleInfo` AgentScheduleInfo provides read-only runtime data about a schedule. - `CreatedBy Profile` A profile identifies a user or non-human principal (such as an API key) at the account level. Profiles are account-scoped and can be granted access to multiple workspaces. - `LastFireAt Time` When the schedule last fired (regardless of objective outcome). - `LastObjectiveID string` ID of the most recent objective the schedule created. - `LastSkippedAt Time` When the schedule most recently skipped a fire (SKIP policy + prior in flight). - `LastSkipReason string` Reason for the most recent skip (e.g. "previous objective still running"). - `NextFireAt Time` When the schedule will next fire. Computed from the spec; absent when the schedule is PAUSED/ARCHIVED or has no future fire times. - `TotalFires int64` Lifetime count of objectives created by this schedule. - `AgentVariation BulkWorkspaceApplyResultDataAgentVariationOutcome` - `Action BulkWorkspaceApplyResultDataAgentVariationOutcomeAction` - `const BulkWorkspaceApplyResultDataAgentVariationOutcomeActionActionUnspecified BulkWorkspaceApplyResultDataAgentVariationOutcomeAction = "ACTION_UNSPECIFIED"` - `const BulkWorkspaceApplyResultDataAgentVariationOutcomeActionActionCreated BulkWorkspaceApplyResultDataAgentVariationOutcomeAction = "ACTION_CREATED"` - `const BulkWorkspaceApplyResultDataAgentVariationOutcomeActionActionUpdated BulkWorkspaceApplyResultDataAgentVariationOutcomeAction = "ACTION_UPDATED"` - `const BulkWorkspaceApplyResultDataAgentVariationOutcomeActionActionUnchanged BulkWorkspaceApplyResultDataAgentVariationOutcomeAction = "ACTION_UNCHANGED"` - `const BulkWorkspaceApplyResultDataAgentVariationOutcomeActionActionDeleted BulkWorkspaceApplyResultDataAgentVariationOutcomeAction = "ACTION_DELETED"` - `const BulkWorkspaceApplyResultDataAgentVariationOutcomeActionActionFailed BulkWorkspaceApplyResultDataAgentVariationOutcomeAction = "ACTION_FAILED"` - `Error BulkWorkspaceApplyResultDataAgentVariationOutcomeError` The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). - `Code int64` The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. - `Details []BulkWorkspaceApplyResultDataAgentVariationOutcomeErrorDetail` A list of messages that carry the error details. There is a common set of message types for APIs to use. - `Type string` The type of the serialized message. - `Message string` A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. - `ExternalID string` - `Resource AgentVariation` AgentVariation resource - `Metadata ResourceMetadata` Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - `Spec AgentVariationSpec` AgentVariationSpec defines the operational configuration for a variation - `CompactionConfig AgentVariationSpecCompactionConfig` CompactionConfig defines how context window compaction behaves for objectives using this variation. - `Summarization CompactionConfigSummarizationStrategy` SummarizationStrategy configures LLM-powered summarization of older conversation turns. - `Instructions string` Custom instructions that guide what the summarizer preserves. Replaces the default summarization prompt entirely. Example: "Preserve all code snippets, variable names, and technical decisions." - `ToolResultClearing CompactionConfigToolResultClearingStrategy` ToolResultClearingStrategy configures clearing of older tool result content. - `PreserveRecentResults int64` Number of most recent tool call results to keep intact. Older tool results have their content replaced with "[result cleared]" while preserving the assistant tool call message (function name, arguments). Default: 2 - `TriggerThreshold float64` Trigger threshold as a percentage of the model's context window (0.0 to 1.0). When input tokens reach this percentage of the model's limit, compaction triggers. Default: 0.75 (75%) - `Constraints AgentVariationSpecConstraints` Execution constraints - `MaxSubObjectives int64` The maximum number of sub-objectives that can be created. 0 means no limit. - `MaxToolCalls int64` The maximum number of tool calls that can be made. 0 means no limit. - `Description string` Human-readable description of what this variation does or when it should be used - `EnableEpisodicMemory bool` Enable episodic memory for objectives using this variation. When true, the system automatically creates a document namespace for each objective using the objective's episodic_key as the external_id, allowing the agent to store and retrieve documents specific to that episode. - `EpisodicMemoryTtl int64` How long episodic memories should be retained. After this duration, episodic document namespaces can be automatically cleaned up. If not set, episodic memories are retained indefinitely. - `ModelConfig AgentVariationSpecModelConfig` ModelConfig defines the model configuration for a variation - `ModelID string` The model identifier in family/model format (e.g., "claude/opus-4.6", "claude/sonnet-4.5") - `Temperature float64` Sampling temperature for model inference (0.0 to 1.0) Lower values produce more deterministic outputs, higher values increase randomness - `ProgressiveDiscovery AgentVariationSpecProgressiveDiscovery` ProgressiveDiscovery is used to indicate that the agent should automatically discover tools that are not explicitly assigned to it. Max tools is the maximum number of tools that can be discovered per search. Hints are optional hints for tool search. These are used in conjunction with the context-aware tool search and can help select the best tools for the task. - `Hints []string` - `MaxTools int64` - `RerankThreshold float64` Rerank Threshold is an optional value that instructs whether or not to run a search result through a embedding/reranker process which can improve performance and reduce context bloat when tools reach the configured threshold. If a tool match must exceed 0.8, for example, the tool very closely match the query the tool search performed. - `Prompt string` The system prompt for this variation - `Weight int64` Weight for weighted random selection (>= 0). P(v) = v.weight / sum(all_weights). Only used when the agent's variation_selection_mode is WEIGHTED. A weight of 0 means never auto-selected, but can still be chosen explicitly via variation_id on CreateObjectiveRequest. - `Info AgentVariationInfo` AgentVariationInfo provides read-only summary information about a variation - `Assignments []VariationAssignment` All tools, tool sets, and sub-agents assigned to this variation. Populated on reads so clients can render a variation's full assignment list without calling the add/remove endpoints just to enumerate. - `ID string` - `Agent BareMetadata` BareMetadata contains the minimal metadata for a resource: the ID and an optional human-readable name. These are used for reference fields where the full metadata (account scoping, timestamps, labels, external IDs) is not needed — e.g., the tool references inside an agent variation spec or the tools assigned to an objective. Both fields are server-populated; clients provide IDs through sibling fields rather than by constructing a BareMetadata themselves. - `ID string` - `Name string` Human-readable name of the referenced resource, populated by the server on reads for convenience. Absent on references to resources that do not have a name (e.g., objective tasks). - `Tool BareMetadata` BareMetadata contains the minimal metadata for a resource: the ID and an optional human-readable name. These are used for reference fields where the full metadata (account scoping, timestamps, labels, external IDs) is not needed — e.g., the tool references inside an agent variation spec or the tools assigned to an objective. Both fields are server-populated; clients provide IDs through sibling fields rather than by constructing a BareMetadata themselves. - `ToolSet BareMetadata` BareMetadata contains the minimal metadata for a resource: the ID and an optional human-readable name. These are used for reference fields where the full metadata (account scoping, timestamps, labels, external IDs) is not needed — e.g., the tool references inside an agent variation spec or the tools assigned to an objective. Both fields are server-populated; clients provide IDs through sibling fields rather than by constructing a BareMetadata themselves. - `CreatedBy Profile` A profile identifies a user or non-human principal (such as an API key) at the account level. Profiles are account-scoped and can be granted access to multiple workspaces. - `FeedbackCount int64` Total number of objective feedbacks received for this variation - `MemoryLayerAssignments []VariationMemoryLayerAssignment` Read-only list of memory layer assignments for this variation, returned in ascending `position` (bottom → top). Capped at 10 entries. - `ID string` Assignment row id — handle for removing the assignment. Distinct from the referenced memory layer's id. - `MemoryLayer BareMetadata` BareMetadata contains the minimal metadata for a resource: the ID and an optional human-readable name. These are used for reference fields where the full metadata (account scoping, timestamps, labels, external IDs) is not needed — e.g., the tool references inside an agent variation spec or the tools assigned to an objective. Both fields are server-populated; clients provide IDs through sibling fields rather than by constructing a BareMetadata themselves. - `Position int64` Position in the variation's baseline stack. Lower values sit lower; the highest-position assignment is on top of the variation's baseline. Gaps are fine — only relative position matters. Positions must be unique within a variation; a request that would collide with an existing assignment's position is rejected with InvalidArgument. - `MemoryLayerCount int64` Count of memory layer assignments. - `Model ResourceMetadata` Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - `Score float64` Thompson Sampling score: posterior mean of Beta(ts_alpha, ts_beta). Range [0, 1] where 0.5 = neutral, >0.5 = positive, <0.5 = negative. - `SubAgentCount int64` Number of sub-agents assigned to this variation - `ToolCount int64` Number of individual tools assigned to this variation - `ToolSetCount int64` Number of tool sets assigned to this variation - `MemoryEntry BulkWorkspaceApplyResultDataMemoryEntryOutcome` - `Action BulkWorkspaceApplyResultDataMemoryEntryOutcomeAction` - `const BulkWorkspaceApplyResultDataMemoryEntryOutcomeActionActionUnspecified BulkWorkspaceApplyResultDataMemoryEntryOutcomeAction = "ACTION_UNSPECIFIED"` - `const BulkWorkspaceApplyResultDataMemoryEntryOutcomeActionActionCreated BulkWorkspaceApplyResultDataMemoryEntryOutcomeAction = "ACTION_CREATED"` - `const BulkWorkspaceApplyResultDataMemoryEntryOutcomeActionActionUpdated BulkWorkspaceApplyResultDataMemoryEntryOutcomeAction = "ACTION_UPDATED"` - `const BulkWorkspaceApplyResultDataMemoryEntryOutcomeActionActionUnchanged BulkWorkspaceApplyResultDataMemoryEntryOutcomeAction = "ACTION_UNCHANGED"` - `const BulkWorkspaceApplyResultDataMemoryEntryOutcomeActionActionDeleted BulkWorkspaceApplyResultDataMemoryEntryOutcomeAction = "ACTION_DELETED"` - `const BulkWorkspaceApplyResultDataMemoryEntryOutcomeActionActionFailed BulkWorkspaceApplyResultDataMemoryEntryOutcomeAction = "ACTION_FAILED"` - `Error BulkWorkspaceApplyResultDataMemoryEntryOutcomeError` The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). - `Code int64` The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. - `Details []BulkWorkspaceApplyResultDataMemoryEntryOutcomeErrorDetail` A list of messages that carry the error details. There is a common set of message types for APIs to use. - `Type string` The type of the serialized message. - `Message string` A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. - `ExternalID string` - `Resource MemoryEntry` MemoryEntry is a single keyed value within a MemoryLayer. Entries are addressed by their key, which follows the S3 object key safe-character convention (see MemoryEntrySpec.key for the full rule). Keys are unique within a single layer; the same key may appear in multiple layers, in which case the LIFO stack-walk determines which one wins for a given objective. MemoryEntry is the summary shape, returned by ListMemoryEntries. It does not carry the entry body — callers that need the body must fetch the entry individually via GetMemoryEntry, which returns a MemoryEntryDetail. - `Metadata ResourceMetadata` Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - `Spec MemoryEntrySpec` MemoryEntrySpec is the metadata portion of an entry — the fields that identify and describe it, without the body. It appears on both the summary (MemoryEntry) and detail (MemoryEntryDetail) views. - `Key string` The lookup key for this entry within its layer. Must conform to the S3 object key safe-characters spec: ASCII alphanumerics and the special characters !, -, _, ., *, ', (, ), and /. Forward slashes may be used to suggest hierarchy (e.g., "skills/postmortem/write"), but lookups are flat — the key is a single opaque string, not a path. Additional rules enforced by the service: - May not begin or end with / - May not contain consecutive slashes (//) - May not begin with reserved prefixes (cadenya/, system/) - Case-sensitive - Unique within the parent layer For skills entries, this key is also the id the model passes to memory_load_skill when it decides to load the entry's content. - `Description string` One-line "when to use this" hint shown in the frontmatter manifest for skills entries. The model uses this to decide whether to load the body, so it should be written for the model as the audience. Ignored for layer types that do not advertise frontmatter. - `Info MemoryEntryInfo` - `CreatedBy Profile` A profile identifies a user or non-human principal (such as an API key) at the account level. Profiles are account-scoped and can be granted access to multiple workspaces. - `MemoryLayer ResourceMetadata` Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - `MemoryLayer BulkWorkspaceApplyResultDataMemoryLayerOutcome` - `Action BulkWorkspaceApplyResultDataMemoryLayerOutcomeAction` - `const BulkWorkspaceApplyResultDataMemoryLayerOutcomeActionActionUnspecified BulkWorkspaceApplyResultDataMemoryLayerOutcomeAction = "ACTION_UNSPECIFIED"` - `const BulkWorkspaceApplyResultDataMemoryLayerOutcomeActionActionCreated BulkWorkspaceApplyResultDataMemoryLayerOutcomeAction = "ACTION_CREATED"` - `const BulkWorkspaceApplyResultDataMemoryLayerOutcomeActionActionUpdated BulkWorkspaceApplyResultDataMemoryLayerOutcomeAction = "ACTION_UPDATED"` - `const BulkWorkspaceApplyResultDataMemoryLayerOutcomeActionActionUnchanged BulkWorkspaceApplyResultDataMemoryLayerOutcomeAction = "ACTION_UNCHANGED"` - `const BulkWorkspaceApplyResultDataMemoryLayerOutcomeActionActionDeleted BulkWorkspaceApplyResultDataMemoryLayerOutcomeAction = "ACTION_DELETED"` - `const BulkWorkspaceApplyResultDataMemoryLayerOutcomeActionActionFailed BulkWorkspaceApplyResultDataMemoryLayerOutcomeAction = "ACTION_FAILED"` - `Error BulkWorkspaceApplyResultDataMemoryLayerOutcomeError` The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). - `Code int64` The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. - `Details []BulkWorkspaceApplyResultDataMemoryLayerOutcomeErrorDetail` A list of messages that carry the error details. There is a common set of message types for APIs to use. - `Type string` The type of the serialized message. - `Message string` A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. - `ExternalID string` - `Resource MemoryLayer` MemoryLayer is a named container of memory entries that can be composed into an objective's memory stack. Layers are workspace-scoped resources. The layer type controls how its entries participate in the agent loop — see MemoryLayerType for details. See "Memory stack composition" above for how layers compose at lookup time. - `Metadata ResourceMetadata` Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - `Spec MemoryLayerSpec` - `Type MemoryLayerSpecType` - `const MemoryLayerSpecTypeMemoryLayerTypeUnspecified MemoryLayerSpecType = "MEMORY_LAYER_TYPE_UNSPECIFIED"` - `const MemoryLayerSpecTypeMemoryLayerTypeEpisodic MemoryLayerSpecType = "MEMORY_LAYER_TYPE_EPISODIC"` - `const MemoryLayerSpecTypeMemoryLayerTypeSkills MemoryLayerSpecType = "MEMORY_LAYER_TYPE_SKILLS"` - `Description string` Human-readable description of the layer's purpose. Encouraged for user-created layers; system-managed layers may have a generated description. - `ExpiresAt Time` For layers with a finite lifetime (e.g., episodic), the time at which the layer becomes eligible for cleanup. Set by the system; unset for persistent layers. - `SystemManaged bool` Server-set. True for layers managed by the system (e.g., episodic layers created automatically when an objective uses an episodic_key). System-managed layers cannot be assigned to objective stacks via the API and cannot be mutated by clients — their lifecycle is controlled entirely by the runtime. - `Info MemoryLayerInfo` - `CreatedBy Profile` A profile identifies a user or non-human principal (such as an API key) at the account level. Profiles are account-scoped and can be granted access to multiple workspaces. - `EntryCount int64` Number of entries currently in this layer. - `LastUsedAt Time` Timestamp of the most recent objective that resolved against this layer. Useful for surfacing unused layers in the dashboard. - `Tool BulkWorkspaceApplyResultDataToolOutcome` - `Action BulkWorkspaceApplyResultDataToolOutcomeAction` - `const BulkWorkspaceApplyResultDataToolOutcomeActionActionUnspecified BulkWorkspaceApplyResultDataToolOutcomeAction = "ACTION_UNSPECIFIED"` - `const BulkWorkspaceApplyResultDataToolOutcomeActionActionCreated BulkWorkspaceApplyResultDataToolOutcomeAction = "ACTION_CREATED"` - `const BulkWorkspaceApplyResultDataToolOutcomeActionActionUpdated BulkWorkspaceApplyResultDataToolOutcomeAction = "ACTION_UPDATED"` - `const BulkWorkspaceApplyResultDataToolOutcomeActionActionUnchanged BulkWorkspaceApplyResultDataToolOutcomeAction = "ACTION_UNCHANGED"` - `const BulkWorkspaceApplyResultDataToolOutcomeActionActionDeleted BulkWorkspaceApplyResultDataToolOutcomeAction = "ACTION_DELETED"` - `const BulkWorkspaceApplyResultDataToolOutcomeActionActionFailed BulkWorkspaceApplyResultDataToolOutcomeAction = "ACTION_FAILED"` - `Error BulkWorkspaceApplyResultDataToolOutcomeError` The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). - `Code int64` The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. - `Details []BulkWorkspaceApplyResultDataToolOutcomeErrorDetail` A list of messages that carry the error details. There is a common set of message types for APIs to use. - `Type string` The type of the serialized message. - `Message string` A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. - `ExternalID string` - `Resource Tool` - `Metadata ResourceMetadata` Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - `Spec ToolSpec` - `Config ToolSpecConfig` Config defines the adapter to use for the tool. This is used to determine how the tool is called. For example, if the tool is an HTTP tool, the adapter will be Http. If the tool is an inline tool, the adapter will be Inline. - `HTTP ConfigHTTP` - `RequestMethod ConfigHTTPRequestMethod` - `const ConfigHTTPRequestMethodHTTPMethodUnspecified ConfigHTTPRequestMethod = "HTTP_METHOD_UNSPECIFIED"` - `const ConfigHTTPRequestMethodGet ConfigHTTPRequestMethod = "GET"` - `const ConfigHTTPRequestMethodPost ConfigHTTPRequestMethod = "POST"` - `const ConfigHTTPRequestMethodPut ConfigHTTPRequestMethod = "PUT"` - `const ConfigHTTPRequestMethodPatch ConfigHTTPRequestMethod = "PATCH"` - `const ConfigHTTPRequestMethodDelete ConfigHTTPRequestMethod = "DELETE"` - `Headers map[string, string]` - `Path string` - `Query string` - `RequestBodyContentType string` - `RequestBodyTemplate string` These are only used when the request method is a POST, PUT, or PATCH - `ToolName string` The tool name (commonly an "operation id" in OpenAPI specs) to call on the HTTP adapter. This is used to match the tool spec to the correct endpoint on the HTTP adapter. it will be derived from the name of the tool if not provided. - `Mcp ConfigMcp` - `ToolDescription string` - `ToolName string` - `ToolTitle string` - `OpenAPI ConfigOpenAPI` - `Method string` - `OperationID string` - `Path string` - `Description string` - `Parameters map[string, unknown]` - `Status ToolSpecStatus` - `const ToolSpecStatusToolStatusUnspecified ToolSpecStatus = "TOOL_STATUS_UNSPECIFIED"` - `const ToolSpecStatusToolStatusAvailable ToolSpecStatus = "TOOL_STATUS_AVAILABLE"` - `const ToolSpecStatusToolStatusOmitted ToolSpecStatus = "TOOL_STATUS_OMITTED"` - `const ToolSpecStatusToolStatusArchived ToolSpecStatus = "TOOL_STATUS_ARCHIVED"` - `RequiresApproval bool` - `Info ToolInfo` - `CreatedBy Profile` A profile identifies a user or non-human principal (such as an API key) at the account level. Profiles are account-scoped and can be granted access to multiple workspaces. - `ToolSet ResourceMetadata` Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - `ToolSet BulkWorkspaceApplyResultDataToolSetOutcome` - `Action BulkWorkspaceApplyResultDataToolSetOutcomeAction` - `const BulkWorkspaceApplyResultDataToolSetOutcomeActionActionUnspecified BulkWorkspaceApplyResultDataToolSetOutcomeAction = "ACTION_UNSPECIFIED"` - `const BulkWorkspaceApplyResultDataToolSetOutcomeActionActionCreated BulkWorkspaceApplyResultDataToolSetOutcomeAction = "ACTION_CREATED"` - `const BulkWorkspaceApplyResultDataToolSetOutcomeActionActionUpdated BulkWorkspaceApplyResultDataToolSetOutcomeAction = "ACTION_UPDATED"` - `const BulkWorkspaceApplyResultDataToolSetOutcomeActionActionUnchanged BulkWorkspaceApplyResultDataToolSetOutcomeAction = "ACTION_UNCHANGED"` - `const BulkWorkspaceApplyResultDataToolSetOutcomeActionActionDeleted BulkWorkspaceApplyResultDataToolSetOutcomeAction = "ACTION_DELETED"` - `const BulkWorkspaceApplyResultDataToolSetOutcomeActionActionFailed BulkWorkspaceApplyResultDataToolSetOutcomeAction = "ACTION_FAILED"` - `Error BulkWorkspaceApplyResultDataToolSetOutcomeError` The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). - `Code int64` The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. - `Details []BulkWorkspaceApplyResultDataToolSetOutcomeErrorDetail` A list of messages that carry the error details. There is a common set of message types for APIs to use. - `Type string` The type of the serialized message. - `Message string` A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. - `ExternalID string` - `Resource ToolSet` - `Metadata ResourceMetadata` Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - `Spec ToolSetSpec` - `Adapter ToolSetAdapter` - `HTTP ToolSetAdapterHTTP` - `BaseURL string` - `Headers map[string, string]` - `Mcp ToolSetAdapterMcp` - `ExcludeTools ToolFilter` Top-level filter with simple boolean logic (no nesting) - `Operator ToolFilterOperator` - `const ToolFilterOperatorOperatorUnspecified ToolFilterOperator = "OPERATOR_UNSPECIFIED"` - `const ToolFilterOperatorOperatorAnd ToolFilterOperator = "OPERATOR_AND"` - `const ToolFilterOperatorOperatorOr ToolFilterOperator = "OPERATOR_OR"` - `Filters []AttributeFilter` - `Attribute AttributeFilterAttribute` - `const AttributeFilterAttributeAttributeUnspecified AttributeFilterAttribute = "ATTRIBUTE_UNSPECIFIED"` - `const AttributeFilterAttributeAttributeName AttributeFilterAttribute = "ATTRIBUTE_NAME"` - `const AttributeFilterAttributeAttributeTitle AttributeFilterAttribute = "ATTRIBUTE_TITLE"` - `const AttributeFilterAttributeAttributeDescription AttributeFilterAttribute = "ATTRIBUTE_DESCRIPTION"` - `Matcher StringMatcher` String matching operations - `CaseSensitive bool` - `Contains string` - `EndsWith string` - `Exact string` - `Regex string` - `StartsWith string` - `Headers map[string, string]` - `IncludeTools ToolFilter` Top-level filter with simple boolean logic (no nesting) - `ToolApprovals ApprovalRequirementFilter` Approval filters that will automatically set the approval requirement on tools synced from an external source - `Always bool` - `Only ToolFilter` Top-level filter with simple boolean logic (no nesting) - `URL string` - `OpenAPI ToolSetAdapterOpenAPI` - `BaseURL string` Base URL for dispatching tool calls. If set, overrides the server resolved from the spec's servers array. - `ExcludeTools ToolFilter` Top-level filter with simple boolean logic (no nesting) - `Headers map[string, string]` Headers sent when fetching the spec from a URL and when dispatching tool calls. - `IncludeTools ToolFilter` Top-level filter with simple boolean logic (no nesting) - `ServerName string` Name of the server entry in the spec's servers array (OpenAPI 3.2 server.name field). Used to select which server URL to dispatch to when base_url is not set. If unset, the first server is used. Ignored when base_url is set. - `ToolApprovals ApprovalRequirementFilter` Approval filters that will automatically set the approval requirement on tools synced from an external source - `UploadID string` ID of a COMPLETE Upload containing the OpenAPI spec document. - `URL string` URL to fetch the OpenAPI spec from. Synced automatically every hour. - `Description string` - `Info ToolSetInfo` Tool set information - `AgentCount int64` - `CreatedBy Profile` A profile identifies a user or non-human principal (such as an API key) at the account level. Profiles are account-scoped and can be granted access to multiple workspaces. - `LastSync Time` - `ToolCount int64` - `Type string` - `VariationAssignment BulkWorkspaceApplyResultDataVariationAssignmentOutcome` - `Action BulkWorkspaceApplyResultDataVariationAssignmentOutcomeAction` - `const BulkWorkspaceApplyResultDataVariationAssignmentOutcomeActionActionUnspecified BulkWorkspaceApplyResultDataVariationAssignmentOutcomeAction = "ACTION_UNSPECIFIED"` - `const BulkWorkspaceApplyResultDataVariationAssignmentOutcomeActionActionCreated BulkWorkspaceApplyResultDataVariationAssignmentOutcomeAction = "ACTION_CREATED"` - `const BulkWorkspaceApplyResultDataVariationAssignmentOutcomeActionActionUpdated BulkWorkspaceApplyResultDataVariationAssignmentOutcomeAction = "ACTION_UPDATED"` - `const BulkWorkspaceApplyResultDataVariationAssignmentOutcomeActionActionUnchanged BulkWorkspaceApplyResultDataVariationAssignmentOutcomeAction = "ACTION_UNCHANGED"` - `const BulkWorkspaceApplyResultDataVariationAssignmentOutcomeActionActionDeleted BulkWorkspaceApplyResultDataVariationAssignmentOutcomeAction = "ACTION_DELETED"` - `const BulkWorkspaceApplyResultDataVariationAssignmentOutcomeActionActionFailed BulkWorkspaceApplyResultDataVariationAssignmentOutcomeAction = "ACTION_FAILED"` - `Error BulkWorkspaceApplyResultDataVariationAssignmentOutcomeError` The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). - `Code int64` The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. - `Details []BulkWorkspaceApplyResultDataVariationAssignmentOutcomeErrorDetail` A list of messages that carry the error details. There is a common set of message types for APIs to use. - `Type string` The type of the serialized message. - `Message string` A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. - `Resource VariationAssignment` A read-only reference to a single tool, tool set, or sub-agent attached to a variation. Read the full set of assignments via `AgentVariationInfo.assignments`; mutations go through the dedicated add/remove assignment endpoints. The `id` identifies the assignment itself (not the referenced resource) and is the handle used to remove the assignment. It is returned by the add endpoint and present on every entry in `AgentVariationInfo.assignments`. - `ID string` - `Agent BareMetadata` BareMetadata contains the minimal metadata for a resource: the ID and an optional human-readable name. These are used for reference fields where the full metadata (account scoping, timestamps, labels, external IDs) is not needed — e.g., the tool references inside an agent variation spec or the tools assigned to an objective. Both fields are server-populated; clients provide IDs through sibling fields rather than by constructing a BareMetadata themselves. - `Tool BareMetadata` BareMetadata contains the minimal metadata for a resource: the ID and an optional human-readable name. These are used for reference fields where the full metadata (account scoping, timestamps, labels, external IDs) is not needed — e.g., the tool references inside an agent variation spec or the tools assigned to an objective. Both fields are server-populated; clients provide IDs through sibling fields rather than by constructing a BareMetadata themselves. - `ToolSet BareMetadata` BareMetadata contains the minimal metadata for a resource: the ID and an optional human-readable name. These are used for reference fields where the full metadata (account scoping, timestamps, labels, external IDs) is not needed — e.g., the tool references inside an agent variation spec or the tools assigned to an objective. Both fields are server-populated; clients provide IDs through sibling fields rather than by constructing a BareMetadata themselves. - `VariationMemoryLayer BulkWorkspaceApplyResultDataVariationMemoryLayerOutcome` - `Action BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeAction` - `const BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeActionActionUnspecified BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeAction = "ACTION_UNSPECIFIED"` - `const BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeActionActionCreated BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeAction = "ACTION_CREATED"` - `const BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeActionActionUpdated BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeAction = "ACTION_UPDATED"` - `const BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeActionActionUnchanged BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeAction = "ACTION_UNCHANGED"` - `const BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeActionActionDeleted BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeAction = "ACTION_DELETED"` - `const BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeActionActionFailed BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeAction = "ACTION_FAILED"` - `Error BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeError` The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). - `Code int64` The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. - `Details []BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeErrorDetail` A list of messages that carry the error details. There is a common set of message types for APIs to use. - `Type string` The type of the serialized message. - `Message string` A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. - `Resource VariationMemoryLayerAssignment` VariationMemoryLayerAssignment attaches a single MemoryLayer to a variation at a given position in the variation's baseline memory stack. A variation has at most one assignment per memory_layer_id. Variations only support whole-layer attachments — entry pinning is an objective-level capability. - `ID string` Assignment row id — handle for removing the assignment. Distinct from the referenced memory layer's id. - `MemoryLayer BareMetadata` BareMetadata contains the minimal metadata for a resource: the ID and an optional human-readable name. These are used for reference fields where the full metadata (account scoping, timestamps, labels, external IDs) is not needed — e.g., the tool references inside an agent variation spec or the tools assigned to an objective. Both fields are server-populated; clients provide IDs through sibling fields rather than by constructing a BareMetadata themselves. - `Position int64` Position in the variation's baseline stack. Lower values sit lower; the highest-position assignment is on top of the variation's baseline. Gaps are fine — only relative position matters. Positions must be unique within a variation; a request that would collide with an existing assignment's position is rejected with InvalidArgument. ### Bulk Workspace Apply Result Data Agent Outcome - `type BulkWorkspaceApplyResultDataAgentOutcome struct{…}` - `Action BulkWorkspaceApplyResultDataAgentOutcomeAction` - `const BulkWorkspaceApplyResultDataAgentOutcomeActionActionUnspecified BulkWorkspaceApplyResultDataAgentOutcomeAction = "ACTION_UNSPECIFIED"` - `const BulkWorkspaceApplyResultDataAgentOutcomeActionActionCreated BulkWorkspaceApplyResultDataAgentOutcomeAction = "ACTION_CREATED"` - `const BulkWorkspaceApplyResultDataAgentOutcomeActionActionUpdated BulkWorkspaceApplyResultDataAgentOutcomeAction = "ACTION_UPDATED"` - `const BulkWorkspaceApplyResultDataAgentOutcomeActionActionUnchanged BulkWorkspaceApplyResultDataAgentOutcomeAction = "ACTION_UNCHANGED"` - `const BulkWorkspaceApplyResultDataAgentOutcomeActionActionDeleted BulkWorkspaceApplyResultDataAgentOutcomeAction = "ACTION_DELETED"` - `const BulkWorkspaceApplyResultDataAgentOutcomeActionActionFailed BulkWorkspaceApplyResultDataAgentOutcomeAction = "ACTION_FAILED"` - `Error BulkWorkspaceApplyResultDataAgentOutcomeError` The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). - `Code int64` The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. - `Details []BulkWorkspaceApplyResultDataAgentOutcomeErrorDetail` A list of messages that carry the error details. There is a common set of message types for APIs to use. - `Type string` The type of the serialized message. - `Message string` A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. - `ExternalID string` - `Resource Agent` Agent resource - `Metadata ResourceMetadata` Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - `ID string` Unique identifier for the resource (prefixed ULID, e.g., "agent_01HXK...") - `AccountID string` Account this resource belongs to for multi-tenant isolation (prefixed ULID) - `CreatedAt Time` Timestamp when this resource was created - `Name string` Human-readable name for the resource (e.g., "Customer Support Agent", "Email Tool") Required for resources that users interact with directly - `ProfileID string` ID of the actor (user or service account) that created this resource - `WorkspaceID string` Workspace this resource belongs to for organizational grouping (prefixed ULID) - `BundleKey string` Optional bundle ownership key. When set, indicates the resource is managed by a configuration bundle identified by this key. Used by BulkWorkspaceResources.Apply to track which resources belong to which bundle for reconciliation / soft-delete on re-apply. - `ExternalID string` External ID for the resource (e.g., a workflow ID from an external system) - `Labels map[string, string]` Arbitrary key-value pairs for categorization and filtering Examples: {"environment": "production", "team": "platform", "version": "v2"} - `Spec AgentSpec` Agent specification (user-provided configuration) - `Status AgentSpecStatus` Status of the agent - `const AgentSpecStatusAgentStatusUnspecified AgentSpecStatus = "AGENT_STATUS_UNSPECIFIED"` - `const AgentSpecStatusAgentStatusDraft AgentSpecStatus = "AGENT_STATUS_DRAFT"` - `const AgentSpecStatusAgentStatusPublished AgentSpecStatus = "AGENT_STATUS_PUBLISHED"` - `const AgentSpecStatusAgentStatusArchived AgentSpecStatus = "AGENT_STATUS_ARCHIVED"` - `VariationSelectionMode AgentSpecVariationSelectionMode` Controls how variations are automatically selected when creating objectives Defaults to RANDOM when unspecified - `const AgentSpecVariationSelectionModeVariationSelectionModeUnspecified AgentSpecVariationSelectionMode = "VARIATION_SELECTION_MODE_UNSPECIFIED"` - `const AgentSpecVariationSelectionModeVariationSelectionModeRandom AgentSpecVariationSelectionMode = "VARIATION_SELECTION_MODE_RANDOM"` - `const AgentSpecVariationSelectionModeVariationSelectionModeWeighted AgentSpecVariationSelectionMode = "VARIATION_SELECTION_MODE_WEIGHTED"` - `Description string` Description of the agent's purpose - `InputDataSchema map[string, unknown]` InputDataSchema is used for enforcing a data input when objectives are created. This is valuable when using liquid formatting in agent variation prompts. Input data schema is also valuable when using an agent as a sub-agent, as the schema is used as the tool's input parameter schema. If omitted, the sub-agent schema will be loaded with a simple "prompt" free text string as its schema. - `OutputDefinition map[string, unknown]` Optional output definition for objectives created for this agent. When provided, Cadenya will append a tool to that will be called by the LLM in use by the variant to extract information in the format provided here. Use this option when you want structured data to be created by your objectives. - `WebhookEventsURL string` The URL that Cadenya will send events for any objective assigned to the agent. - `Info AgentInfo` AgentInfo contains simple information about an agent for display or quick reference - `CreatedBy Profile` A profile identifies a user or non-human principal (such as an API key) at the account level. Profiles are account-scoped and can be granted access to multiple workspaces. - `Metadata AccountResourceMetadata` AccountResourceMetadata is used to represent a resource that is associated to an account but not to a workspace. - `ID string` Unique identifier for the resource (prefixed ULID, e.g., "apikey_01HXK...") - `AccountID string` Account this resource belongs to for multi-tenant isolation (prefixed ULID) - `Name string` Human-readable name for the resource (e.g., "Customer Support Agent", "Email Tool") Required for resources that users interact with directly - `ProfileID string` - `ExternalID string` External ID for the resource (e.g., a workflow ID from an external system) - `Labels map[string, string]` Arbitrary key-value pairs for categorization and filtering Examples: {"environment": "production", "team": "platform", "version": "v2"} - `Spec ProfileSpec` Configuration for a profile. - `Type ProfileSpecType` Whether this profile represents a human user, an API key, or a system principal. - `const ProfileSpecTypeProfileTypeUnspecified ProfileSpecType = "PROFILE_TYPE_UNSPECIFIED"` - `const ProfileSpecTypeProfileTypeUser ProfileSpecType = "PROFILE_TYPE_USER"` - `const ProfileSpecTypeProfileTypeAPIKey ProfileSpecType = "PROFILE_TYPE_API_KEY"` - `const ProfileSpecTypeProfileTypeSystem ProfileSpecType = "PROFILE_TYPE_SYSTEM"` - `Email string` Email address of the profile. Required and unique within an account for user profiles. - `Name string` Display name (e.g., "Bobby Tables"). - `VariationCount int64` ### Bulk Workspace Apply Result Data Agent Schedule Outcome - `type BulkWorkspaceApplyResultDataAgentScheduleOutcome struct{…}` - `Action BulkWorkspaceApplyResultDataAgentScheduleOutcomeAction` - `const BulkWorkspaceApplyResultDataAgentScheduleOutcomeActionActionUnspecified BulkWorkspaceApplyResultDataAgentScheduleOutcomeAction = "ACTION_UNSPECIFIED"` - `const BulkWorkspaceApplyResultDataAgentScheduleOutcomeActionActionCreated BulkWorkspaceApplyResultDataAgentScheduleOutcomeAction = "ACTION_CREATED"` - `const BulkWorkspaceApplyResultDataAgentScheduleOutcomeActionActionUpdated BulkWorkspaceApplyResultDataAgentScheduleOutcomeAction = "ACTION_UPDATED"` - `const BulkWorkspaceApplyResultDataAgentScheduleOutcomeActionActionUnchanged BulkWorkspaceApplyResultDataAgentScheduleOutcomeAction = "ACTION_UNCHANGED"` - `const BulkWorkspaceApplyResultDataAgentScheduleOutcomeActionActionDeleted BulkWorkspaceApplyResultDataAgentScheduleOutcomeAction = "ACTION_DELETED"` - `const BulkWorkspaceApplyResultDataAgentScheduleOutcomeActionActionFailed BulkWorkspaceApplyResultDataAgentScheduleOutcomeAction = "ACTION_FAILED"` - `Error BulkWorkspaceApplyResultDataAgentScheduleOutcomeError` The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). - `Code int64` The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. - `Details []BulkWorkspaceApplyResultDataAgentScheduleOutcomeErrorDetail` A list of messages that carry the error details. There is a common set of message types for APIs to use. - `Type string` The type of the serialized message. - `Message string` A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. - `ExternalID string` - `Resource AgentSchedule` AgentSchedule resource — a recurring trigger attached to an agent that creates objectives on its cadence. - `Metadata ResourceMetadata` Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - `ID string` Unique identifier for the resource (prefixed ULID, e.g., "agent_01HXK...") - `AccountID string` Account this resource belongs to for multi-tenant isolation (prefixed ULID) - `CreatedAt Time` Timestamp when this resource was created - `Name string` Human-readable name for the resource (e.g., "Customer Support Agent", "Email Tool") Required for resources that users interact with directly - `ProfileID string` ID of the actor (user or service account) that created this resource - `WorkspaceID string` Workspace this resource belongs to for organizational grouping (prefixed ULID) - `BundleKey string` Optional bundle ownership key. When set, indicates the resource is managed by a configuration bundle identified by this key. Used by BulkWorkspaceResources.Apply to track which resources belong to which bundle for reconciliation / soft-delete on re-apply. - `ExternalID string` External ID for the resource (e.g., a workflow ID from an external system) - `Labels map[string, string]` Arbitrary key-value pairs for categorization and filtering Examples: {"environment": "production", "team": "platform", "version": "v2"} - `Spec AgentScheduleSpec` AgentScheduleSpec is the user-provided configuration for a schedule. - `InitialMessage string` The initial message passed to CreateObjective on each fire. Becomes the first user message in the objective's chat history. - `Schedule AgentScheduleSpecSchedule` Schedule defines WHEN the schedule fires. Temporal-style structured form: a list of calendar rules (wall-clock) and/or interval rules (duration), OR'd together. At least one rule is required. - `Calendars []ScheduleCalendar` Wall-clock rules. May be empty if `intervals` is non-empty. - `Comment string` - `DayOfMonth []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `DayOfWeek []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Hour []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Minute []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Month []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Second []ScheduleRange` - `End int64` - `Start int64` - `Step int64` - `Intervals []ScheduleInterval` Duration-based rules. May be empty if `calendars` is non-empty. - `Every string` - `Offset string` Phase shift within `every`. Must be < `every` (enforced at runtime). - `Timezone string` IANA tz name (e.g. "America/New_York"). Required. Applies to calendars; intervals fire on wall-clock cadence anchored in this zone. - `Data unknown` Optional input data passed to the objective. If the agent has an input_data_schema, this must satisfy it. - `OverlapPolicy AgentScheduleSpecOverlapPolicy` What to do when the previous run is still in flight. Defaults to SKIP. - `const AgentScheduleSpecOverlapPolicyOverlapPolicyUnspecified AgentScheduleSpecOverlapPolicy = "OVERLAP_POLICY_UNSPECIFIED"` - `const AgentScheduleSpecOverlapPolicyOverlapPolicyAllow AgentScheduleSpecOverlapPolicy = "OVERLAP_POLICY_ALLOW"` - `const AgentScheduleSpecOverlapPolicyOverlapPolicySkip AgentScheduleSpecOverlapPolicy = "OVERLAP_POLICY_SKIP"` - `Status AgentScheduleSpecStatus` Lifecycle. Defaults to ACTIVE on create when unspecified. - `const AgentScheduleSpecStatusAgentScheduleStatusUnspecified AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_UNSPECIFIED"` - `const AgentScheduleSpecStatusAgentScheduleStatusActive AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_ACTIVE"` - `const AgentScheduleSpecStatusAgentScheduleStatusPaused AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_PAUSED"` - `const AgentScheduleSpecStatusAgentScheduleStatusArchived AgentScheduleSpecStatus = "AGENT_SCHEDULE_STATUS_ARCHIVED"` - `VariationID string` Optional explicit variation. When unset, the agent's variation_selection_mode chooses per fire. - `Info AgentScheduleInfo` AgentScheduleInfo provides read-only runtime data about a schedule. - `CreatedBy Profile` A profile identifies a user or non-human principal (such as an API key) at the account level. Profiles are account-scoped and can be granted access to multiple workspaces. - `Metadata AccountResourceMetadata` AccountResourceMetadata is used to represent a resource that is associated to an account but not to a workspace. - `ID string` Unique identifier for the resource (prefixed ULID, e.g., "apikey_01HXK...") - `AccountID string` Account this resource belongs to for multi-tenant isolation (prefixed ULID) - `Name string` Human-readable name for the resource (e.g., "Customer Support Agent", "Email Tool") Required for resources that users interact with directly - `ProfileID string` - `ExternalID string` External ID for the resource (e.g., a workflow ID from an external system) - `Labels map[string, string]` Arbitrary key-value pairs for categorization and filtering Examples: {"environment": "production", "team": "platform", "version": "v2"} - `Spec ProfileSpec` Configuration for a profile. - `Type ProfileSpecType` Whether this profile represents a human user, an API key, or a system principal. - `const ProfileSpecTypeProfileTypeUnspecified ProfileSpecType = "PROFILE_TYPE_UNSPECIFIED"` - `const ProfileSpecTypeProfileTypeUser ProfileSpecType = "PROFILE_TYPE_USER"` - `const ProfileSpecTypeProfileTypeAPIKey ProfileSpecType = "PROFILE_TYPE_API_KEY"` - `const ProfileSpecTypeProfileTypeSystem ProfileSpecType = "PROFILE_TYPE_SYSTEM"` - `Email string` Email address of the profile. Required and unique within an account for user profiles. - `Name string` Display name (e.g., "Bobby Tables"). - `LastFireAt Time` When the schedule last fired (regardless of objective outcome). - `LastObjectiveID string` ID of the most recent objective the schedule created. - `LastSkippedAt Time` When the schedule most recently skipped a fire (SKIP policy + prior in flight). - `LastSkipReason string` Reason for the most recent skip (e.g. "previous objective still running"). - `NextFireAt Time` When the schedule will next fire. Computed from the spec; absent when the schedule is PAUSED/ARCHIVED or has no future fire times. - `TotalFires int64` Lifetime count of objectives created by this schedule. ### Bulk Workspace Apply Result Data Agent Variation Outcome - `type BulkWorkspaceApplyResultDataAgentVariationOutcome struct{…}` - `Action BulkWorkspaceApplyResultDataAgentVariationOutcomeAction` - `const BulkWorkspaceApplyResultDataAgentVariationOutcomeActionActionUnspecified BulkWorkspaceApplyResultDataAgentVariationOutcomeAction = "ACTION_UNSPECIFIED"` - `const BulkWorkspaceApplyResultDataAgentVariationOutcomeActionActionCreated BulkWorkspaceApplyResultDataAgentVariationOutcomeAction = "ACTION_CREATED"` - `const BulkWorkspaceApplyResultDataAgentVariationOutcomeActionActionUpdated BulkWorkspaceApplyResultDataAgentVariationOutcomeAction = "ACTION_UPDATED"` - `const BulkWorkspaceApplyResultDataAgentVariationOutcomeActionActionUnchanged BulkWorkspaceApplyResultDataAgentVariationOutcomeAction = "ACTION_UNCHANGED"` - `const BulkWorkspaceApplyResultDataAgentVariationOutcomeActionActionDeleted BulkWorkspaceApplyResultDataAgentVariationOutcomeAction = "ACTION_DELETED"` - `const BulkWorkspaceApplyResultDataAgentVariationOutcomeActionActionFailed BulkWorkspaceApplyResultDataAgentVariationOutcomeAction = "ACTION_FAILED"` - `Error BulkWorkspaceApplyResultDataAgentVariationOutcomeError` The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). - `Code int64` The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. - `Details []BulkWorkspaceApplyResultDataAgentVariationOutcomeErrorDetail` A list of messages that carry the error details. There is a common set of message types for APIs to use. - `Type string` The type of the serialized message. - `Message string` A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. - `ExternalID string` - `Resource AgentVariation` AgentVariation resource - `Metadata ResourceMetadata` Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - `ID string` Unique identifier for the resource (prefixed ULID, e.g., "agent_01HXK...") - `AccountID string` Account this resource belongs to for multi-tenant isolation (prefixed ULID) - `CreatedAt Time` Timestamp when this resource was created - `Name string` Human-readable name for the resource (e.g., "Customer Support Agent", "Email Tool") Required for resources that users interact with directly - `ProfileID string` ID of the actor (user or service account) that created this resource - `WorkspaceID string` Workspace this resource belongs to for organizational grouping (prefixed ULID) - `BundleKey string` Optional bundle ownership key. When set, indicates the resource is managed by a configuration bundle identified by this key. Used by BulkWorkspaceResources.Apply to track which resources belong to which bundle for reconciliation / soft-delete on re-apply. - `ExternalID string` External ID for the resource (e.g., a workflow ID from an external system) - `Labels map[string, string]` Arbitrary key-value pairs for categorization and filtering Examples: {"environment": "production", "team": "platform", "version": "v2"} - `Spec AgentVariationSpec` AgentVariationSpec defines the operational configuration for a variation - `CompactionConfig AgentVariationSpecCompactionConfig` CompactionConfig defines how context window compaction behaves for objectives using this variation. - `Summarization CompactionConfigSummarizationStrategy` SummarizationStrategy configures LLM-powered summarization of older conversation turns. - `Instructions string` Custom instructions that guide what the summarizer preserves. Replaces the default summarization prompt entirely. Example: "Preserve all code snippets, variable names, and technical decisions." - `ToolResultClearing CompactionConfigToolResultClearingStrategy` ToolResultClearingStrategy configures clearing of older tool result content. - `PreserveRecentResults int64` Number of most recent tool call results to keep intact. Older tool results have their content replaced with "[result cleared]" while preserving the assistant tool call message (function name, arguments). Default: 2 - `TriggerThreshold float64` Trigger threshold as a percentage of the model's context window (0.0 to 1.0). When input tokens reach this percentage of the model's limit, compaction triggers. Default: 0.75 (75%) - `Constraints AgentVariationSpecConstraints` Execution constraints - `MaxSubObjectives int64` The maximum number of sub-objectives that can be created. 0 means no limit. - `MaxToolCalls int64` The maximum number of tool calls that can be made. 0 means no limit. - `Description string` Human-readable description of what this variation does or when it should be used - `EnableEpisodicMemory bool` Enable episodic memory for objectives using this variation. When true, the system automatically creates a document namespace for each objective using the objective's episodic_key as the external_id, allowing the agent to store and retrieve documents specific to that episode. - `EpisodicMemoryTtl int64` How long episodic memories should be retained. After this duration, episodic document namespaces can be automatically cleaned up. If not set, episodic memories are retained indefinitely. - `ModelConfig AgentVariationSpecModelConfig` ModelConfig defines the model configuration for a variation - `ModelID string` The model identifier in family/model format (e.g., "claude/opus-4.6", "claude/sonnet-4.5") - `Temperature float64` Sampling temperature for model inference (0.0 to 1.0) Lower values produce more deterministic outputs, higher values increase randomness - `ProgressiveDiscovery AgentVariationSpecProgressiveDiscovery` ProgressiveDiscovery is used to indicate that the agent should automatically discover tools that are not explicitly assigned to it. Max tools is the maximum number of tools that can be discovered per search. Hints are optional hints for tool search. These are used in conjunction with the context-aware tool search and can help select the best tools for the task. - `Hints []string` - `MaxTools int64` - `RerankThreshold float64` Rerank Threshold is an optional value that instructs whether or not to run a search result through a embedding/reranker process which can improve performance and reduce context bloat when tools reach the configured threshold. If a tool match must exceed 0.8, for example, the tool very closely match the query the tool search performed. - `Prompt string` The system prompt for this variation - `Weight int64` Weight for weighted random selection (>= 0). P(v) = v.weight / sum(all_weights). Only used when the agent's variation_selection_mode is WEIGHTED. A weight of 0 means never auto-selected, but can still be chosen explicitly via variation_id on CreateObjectiveRequest. - `Info AgentVariationInfo` AgentVariationInfo provides read-only summary information about a variation - `Assignments []VariationAssignment` All tools, tool sets, and sub-agents assigned to this variation. Populated on reads so clients can render a variation's full assignment list without calling the add/remove endpoints just to enumerate. - `ID string` - `Agent BareMetadata` BareMetadata contains the minimal metadata for a resource: the ID and an optional human-readable name. These are used for reference fields where the full metadata (account scoping, timestamps, labels, external IDs) is not needed — e.g., the tool references inside an agent variation spec or the tools assigned to an objective. Both fields are server-populated; clients provide IDs through sibling fields rather than by constructing a BareMetadata themselves. - `ID string` - `Name string` Human-readable name of the referenced resource, populated by the server on reads for convenience. Absent on references to resources that do not have a name (e.g., objective tasks). - `Tool BareMetadata` BareMetadata contains the minimal metadata for a resource: the ID and an optional human-readable name. These are used for reference fields where the full metadata (account scoping, timestamps, labels, external IDs) is not needed — e.g., the tool references inside an agent variation spec or the tools assigned to an objective. Both fields are server-populated; clients provide IDs through sibling fields rather than by constructing a BareMetadata themselves. - `ToolSet BareMetadata` BareMetadata contains the minimal metadata for a resource: the ID and an optional human-readable name. These are used for reference fields where the full metadata (account scoping, timestamps, labels, external IDs) is not needed — e.g., the tool references inside an agent variation spec or the tools assigned to an objective. Both fields are server-populated; clients provide IDs through sibling fields rather than by constructing a BareMetadata themselves. - `CreatedBy Profile` A profile identifies a user or non-human principal (such as an API key) at the account level. Profiles are account-scoped and can be granted access to multiple workspaces. - `Metadata AccountResourceMetadata` AccountResourceMetadata is used to represent a resource that is associated to an account but not to a workspace. - `ID string` Unique identifier for the resource (prefixed ULID, e.g., "apikey_01HXK...") - `AccountID string` Account this resource belongs to for multi-tenant isolation (prefixed ULID) - `Name string` Human-readable name for the resource (e.g., "Customer Support Agent", "Email Tool") Required for resources that users interact with directly - `ProfileID string` - `ExternalID string` External ID for the resource (e.g., a workflow ID from an external system) - `Labels map[string, string]` Arbitrary key-value pairs for categorization and filtering Examples: {"environment": "production", "team": "platform", "version": "v2"} - `Spec ProfileSpec` Configuration for a profile. - `Type ProfileSpecType` Whether this profile represents a human user, an API key, or a system principal. - `const ProfileSpecTypeProfileTypeUnspecified ProfileSpecType = "PROFILE_TYPE_UNSPECIFIED"` - `const ProfileSpecTypeProfileTypeUser ProfileSpecType = "PROFILE_TYPE_USER"` - `const ProfileSpecTypeProfileTypeAPIKey ProfileSpecType = "PROFILE_TYPE_API_KEY"` - `const ProfileSpecTypeProfileTypeSystem ProfileSpecType = "PROFILE_TYPE_SYSTEM"` - `Email string` Email address of the profile. Required and unique within an account for user profiles. - `Name string` Display name (e.g., "Bobby Tables"). - `FeedbackCount int64` Total number of objective feedbacks received for this variation - `MemoryLayerAssignments []VariationMemoryLayerAssignment` Read-only list of memory layer assignments for this variation, returned in ascending `position` (bottom → top). Capped at 10 entries. - `ID string` Assignment row id — handle for removing the assignment. Distinct from the referenced memory layer's id. - `MemoryLayer BareMetadata` BareMetadata contains the minimal metadata for a resource: the ID and an optional human-readable name. These are used for reference fields where the full metadata (account scoping, timestamps, labels, external IDs) is not needed — e.g., the tool references inside an agent variation spec or the tools assigned to an objective. Both fields are server-populated; clients provide IDs through sibling fields rather than by constructing a BareMetadata themselves. - `Position int64` Position in the variation's baseline stack. Lower values sit lower; the highest-position assignment is on top of the variation's baseline. Gaps are fine — only relative position matters. Positions must be unique within a variation; a request that would collide with an existing assignment's position is rejected with InvalidArgument. - `MemoryLayerCount int64` Count of memory layer assignments. - `Model ResourceMetadata` Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - `Score float64` Thompson Sampling score: posterior mean of Beta(ts_alpha, ts_beta). Range [0, 1] where 0.5 = neutral, >0.5 = positive, <0.5 = negative. - `SubAgentCount int64` Number of sub-agents assigned to this variation - `ToolCount int64` Number of individual tools assigned to this variation - `ToolSetCount int64` Number of tool sets assigned to this variation ### Bulk Workspace Apply Result Data Memory Entry Outcome - `type BulkWorkspaceApplyResultDataMemoryEntryOutcome struct{…}` - `Action BulkWorkspaceApplyResultDataMemoryEntryOutcomeAction` - `const BulkWorkspaceApplyResultDataMemoryEntryOutcomeActionActionUnspecified BulkWorkspaceApplyResultDataMemoryEntryOutcomeAction = "ACTION_UNSPECIFIED"` - `const BulkWorkspaceApplyResultDataMemoryEntryOutcomeActionActionCreated BulkWorkspaceApplyResultDataMemoryEntryOutcomeAction = "ACTION_CREATED"` - `const BulkWorkspaceApplyResultDataMemoryEntryOutcomeActionActionUpdated BulkWorkspaceApplyResultDataMemoryEntryOutcomeAction = "ACTION_UPDATED"` - `const BulkWorkspaceApplyResultDataMemoryEntryOutcomeActionActionUnchanged BulkWorkspaceApplyResultDataMemoryEntryOutcomeAction = "ACTION_UNCHANGED"` - `const BulkWorkspaceApplyResultDataMemoryEntryOutcomeActionActionDeleted BulkWorkspaceApplyResultDataMemoryEntryOutcomeAction = "ACTION_DELETED"` - `const BulkWorkspaceApplyResultDataMemoryEntryOutcomeActionActionFailed BulkWorkspaceApplyResultDataMemoryEntryOutcomeAction = "ACTION_FAILED"` - `Error BulkWorkspaceApplyResultDataMemoryEntryOutcomeError` The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). - `Code int64` The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. - `Details []BulkWorkspaceApplyResultDataMemoryEntryOutcomeErrorDetail` A list of messages that carry the error details. There is a common set of message types for APIs to use. - `Type string` The type of the serialized message. - `Message string` A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. - `ExternalID string` - `Resource MemoryEntry` MemoryEntry is a single keyed value within a MemoryLayer. Entries are addressed by their key, which follows the S3 object key safe-character convention (see MemoryEntrySpec.key for the full rule). Keys are unique within a single layer; the same key may appear in multiple layers, in which case the LIFO stack-walk determines which one wins for a given objective. MemoryEntry is the summary shape, returned by ListMemoryEntries. It does not carry the entry body — callers that need the body must fetch the entry individually via GetMemoryEntry, which returns a MemoryEntryDetail. - `Metadata ResourceMetadata` Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - `ID string` Unique identifier for the resource (prefixed ULID, e.g., "agent_01HXK...") - `AccountID string` Account this resource belongs to for multi-tenant isolation (prefixed ULID) - `CreatedAt Time` Timestamp when this resource was created - `Name string` Human-readable name for the resource (e.g., "Customer Support Agent", "Email Tool") Required for resources that users interact with directly - `ProfileID string` ID of the actor (user or service account) that created this resource - `WorkspaceID string` Workspace this resource belongs to for organizational grouping (prefixed ULID) - `BundleKey string` Optional bundle ownership key. When set, indicates the resource is managed by a configuration bundle identified by this key. Used by BulkWorkspaceResources.Apply to track which resources belong to which bundle for reconciliation / soft-delete on re-apply. - `ExternalID string` External ID for the resource (e.g., a workflow ID from an external system) - `Labels map[string, string]` Arbitrary key-value pairs for categorization and filtering Examples: {"environment": "production", "team": "platform", "version": "v2"} - `Spec MemoryEntrySpec` MemoryEntrySpec is the metadata portion of an entry — the fields that identify and describe it, without the body. It appears on both the summary (MemoryEntry) and detail (MemoryEntryDetail) views. - `Key string` The lookup key for this entry within its layer. Must conform to the S3 object key safe-characters spec: ASCII alphanumerics and the special characters !, -, _, ., *, ', (, ), and /. Forward slashes may be used to suggest hierarchy (e.g., "skills/postmortem/write"), but lookups are flat — the key is a single opaque string, not a path. Additional rules enforced by the service: - May not begin or end with / - May not contain consecutive slashes (//) - May not begin with reserved prefixes (cadenya/, system/) - Case-sensitive - Unique within the parent layer For skills entries, this key is also the id the model passes to memory_load_skill when it decides to load the entry's content. - `Description string` One-line "when to use this" hint shown in the frontmatter manifest for skills entries. The model uses this to decide whether to load the body, so it should be written for the model as the audience. Ignored for layer types that do not advertise frontmatter. - `Info MemoryEntryInfo` - `CreatedBy Profile` A profile identifies a user or non-human principal (such as an API key) at the account level. Profiles are account-scoped and can be granted access to multiple workspaces. - `Metadata AccountResourceMetadata` AccountResourceMetadata is used to represent a resource that is associated to an account but not to a workspace. - `ID string` Unique identifier for the resource (prefixed ULID, e.g., "apikey_01HXK...") - `AccountID string` Account this resource belongs to for multi-tenant isolation (prefixed ULID) - `Name string` Human-readable name for the resource (e.g., "Customer Support Agent", "Email Tool") Required for resources that users interact with directly - `ProfileID string` - `ExternalID string` External ID for the resource (e.g., a workflow ID from an external system) - `Labels map[string, string]` Arbitrary key-value pairs for categorization and filtering Examples: {"environment": "production", "team": "platform", "version": "v2"} - `Spec ProfileSpec` Configuration for a profile. - `Type ProfileSpecType` Whether this profile represents a human user, an API key, or a system principal. - `const ProfileSpecTypeProfileTypeUnspecified ProfileSpecType = "PROFILE_TYPE_UNSPECIFIED"` - `const ProfileSpecTypeProfileTypeUser ProfileSpecType = "PROFILE_TYPE_USER"` - `const ProfileSpecTypeProfileTypeAPIKey ProfileSpecType = "PROFILE_TYPE_API_KEY"` - `const ProfileSpecTypeProfileTypeSystem ProfileSpecType = "PROFILE_TYPE_SYSTEM"` - `Email string` Email address of the profile. Required and unique within an account for user profiles. - `Name string` Display name (e.g., "Bobby Tables"). - `MemoryLayer ResourceMetadata` Standard metadata for persistent, named resources (e.g., agents, tools, prompts) ### Bulk Workspace Apply Result Data Memory Layer Outcome - `type BulkWorkspaceApplyResultDataMemoryLayerOutcome struct{…}` - `Action BulkWorkspaceApplyResultDataMemoryLayerOutcomeAction` - `const BulkWorkspaceApplyResultDataMemoryLayerOutcomeActionActionUnspecified BulkWorkspaceApplyResultDataMemoryLayerOutcomeAction = "ACTION_UNSPECIFIED"` - `const BulkWorkspaceApplyResultDataMemoryLayerOutcomeActionActionCreated BulkWorkspaceApplyResultDataMemoryLayerOutcomeAction = "ACTION_CREATED"` - `const BulkWorkspaceApplyResultDataMemoryLayerOutcomeActionActionUpdated BulkWorkspaceApplyResultDataMemoryLayerOutcomeAction = "ACTION_UPDATED"` - `const BulkWorkspaceApplyResultDataMemoryLayerOutcomeActionActionUnchanged BulkWorkspaceApplyResultDataMemoryLayerOutcomeAction = "ACTION_UNCHANGED"` - `const BulkWorkspaceApplyResultDataMemoryLayerOutcomeActionActionDeleted BulkWorkspaceApplyResultDataMemoryLayerOutcomeAction = "ACTION_DELETED"` - `const BulkWorkspaceApplyResultDataMemoryLayerOutcomeActionActionFailed BulkWorkspaceApplyResultDataMemoryLayerOutcomeAction = "ACTION_FAILED"` - `Error BulkWorkspaceApplyResultDataMemoryLayerOutcomeError` The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). - `Code int64` The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. - `Details []BulkWorkspaceApplyResultDataMemoryLayerOutcomeErrorDetail` A list of messages that carry the error details. There is a common set of message types for APIs to use. - `Type string` The type of the serialized message. - `Message string` A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. - `ExternalID string` - `Resource MemoryLayer` MemoryLayer is a named container of memory entries that can be composed into an objective's memory stack. Layers are workspace-scoped resources. The layer type controls how its entries participate in the agent loop — see MemoryLayerType for details. See "Memory stack composition" above for how layers compose at lookup time. - `Metadata ResourceMetadata` Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - `ID string` Unique identifier for the resource (prefixed ULID, e.g., "agent_01HXK...") - `AccountID string` Account this resource belongs to for multi-tenant isolation (prefixed ULID) - `CreatedAt Time` Timestamp when this resource was created - `Name string` Human-readable name for the resource (e.g., "Customer Support Agent", "Email Tool") Required for resources that users interact with directly - `ProfileID string` ID of the actor (user or service account) that created this resource - `WorkspaceID string` Workspace this resource belongs to for organizational grouping (prefixed ULID) - `BundleKey string` Optional bundle ownership key. When set, indicates the resource is managed by a configuration bundle identified by this key. Used by BulkWorkspaceResources.Apply to track which resources belong to which bundle for reconciliation / soft-delete on re-apply. - `ExternalID string` External ID for the resource (e.g., a workflow ID from an external system) - `Labels map[string, string]` Arbitrary key-value pairs for categorization and filtering Examples: {"environment": "production", "team": "platform", "version": "v2"} - `Spec MemoryLayerSpec` - `Type MemoryLayerSpecType` - `const MemoryLayerSpecTypeMemoryLayerTypeUnspecified MemoryLayerSpecType = "MEMORY_LAYER_TYPE_UNSPECIFIED"` - `const MemoryLayerSpecTypeMemoryLayerTypeEpisodic MemoryLayerSpecType = "MEMORY_LAYER_TYPE_EPISODIC"` - `const MemoryLayerSpecTypeMemoryLayerTypeSkills MemoryLayerSpecType = "MEMORY_LAYER_TYPE_SKILLS"` - `Description string` Human-readable description of the layer's purpose. Encouraged for user-created layers; system-managed layers may have a generated description. - `ExpiresAt Time` For layers with a finite lifetime (e.g., episodic), the time at which the layer becomes eligible for cleanup. Set by the system; unset for persistent layers. - `SystemManaged bool` Server-set. True for layers managed by the system (e.g., episodic layers created automatically when an objective uses an episodic_key). System-managed layers cannot be assigned to objective stacks via the API and cannot be mutated by clients — their lifecycle is controlled entirely by the runtime. - `Info MemoryLayerInfo` - `CreatedBy Profile` A profile identifies a user or non-human principal (such as an API key) at the account level. Profiles are account-scoped and can be granted access to multiple workspaces. - `Metadata AccountResourceMetadata` AccountResourceMetadata is used to represent a resource that is associated to an account but not to a workspace. - `ID string` Unique identifier for the resource (prefixed ULID, e.g., "apikey_01HXK...") - `AccountID string` Account this resource belongs to for multi-tenant isolation (prefixed ULID) - `Name string` Human-readable name for the resource (e.g., "Customer Support Agent", "Email Tool") Required for resources that users interact with directly - `ProfileID string` - `ExternalID string` External ID for the resource (e.g., a workflow ID from an external system) - `Labels map[string, string]` Arbitrary key-value pairs for categorization and filtering Examples: {"environment": "production", "team": "platform", "version": "v2"} - `Spec ProfileSpec` Configuration for a profile. - `Type ProfileSpecType` Whether this profile represents a human user, an API key, or a system principal. - `const ProfileSpecTypeProfileTypeUnspecified ProfileSpecType = "PROFILE_TYPE_UNSPECIFIED"` - `const ProfileSpecTypeProfileTypeUser ProfileSpecType = "PROFILE_TYPE_USER"` - `const ProfileSpecTypeProfileTypeAPIKey ProfileSpecType = "PROFILE_TYPE_API_KEY"` - `const ProfileSpecTypeProfileTypeSystem ProfileSpecType = "PROFILE_TYPE_SYSTEM"` - `Email string` Email address of the profile. Required and unique within an account for user profiles. - `Name string` Display name (e.g., "Bobby Tables"). - `EntryCount int64` Number of entries currently in this layer. - `LastUsedAt Time` Timestamp of the most recent objective that resolved against this layer. Useful for surfacing unused layers in the dashboard. ### Bulk Workspace Apply Result Data Tool Outcome - `type BulkWorkspaceApplyResultDataToolOutcome struct{…}` - `Action BulkWorkspaceApplyResultDataToolOutcomeAction` - `const BulkWorkspaceApplyResultDataToolOutcomeActionActionUnspecified BulkWorkspaceApplyResultDataToolOutcomeAction = "ACTION_UNSPECIFIED"` - `const BulkWorkspaceApplyResultDataToolOutcomeActionActionCreated BulkWorkspaceApplyResultDataToolOutcomeAction = "ACTION_CREATED"` - `const BulkWorkspaceApplyResultDataToolOutcomeActionActionUpdated BulkWorkspaceApplyResultDataToolOutcomeAction = "ACTION_UPDATED"` - `const BulkWorkspaceApplyResultDataToolOutcomeActionActionUnchanged BulkWorkspaceApplyResultDataToolOutcomeAction = "ACTION_UNCHANGED"` - `const BulkWorkspaceApplyResultDataToolOutcomeActionActionDeleted BulkWorkspaceApplyResultDataToolOutcomeAction = "ACTION_DELETED"` - `const BulkWorkspaceApplyResultDataToolOutcomeActionActionFailed BulkWorkspaceApplyResultDataToolOutcomeAction = "ACTION_FAILED"` - `Error BulkWorkspaceApplyResultDataToolOutcomeError` The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). - `Code int64` The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. - `Details []BulkWorkspaceApplyResultDataToolOutcomeErrorDetail` A list of messages that carry the error details. There is a common set of message types for APIs to use. - `Type string` The type of the serialized message. - `Message string` A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. - `ExternalID string` - `Resource Tool` - `Metadata ResourceMetadata` Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - `ID string` Unique identifier for the resource (prefixed ULID, e.g., "agent_01HXK...") - `AccountID string` Account this resource belongs to for multi-tenant isolation (prefixed ULID) - `CreatedAt Time` Timestamp when this resource was created - `Name string` Human-readable name for the resource (e.g., "Customer Support Agent", "Email Tool") Required for resources that users interact with directly - `ProfileID string` ID of the actor (user or service account) that created this resource - `WorkspaceID string` Workspace this resource belongs to for organizational grouping (prefixed ULID) - `BundleKey string` Optional bundle ownership key. When set, indicates the resource is managed by a configuration bundle identified by this key. Used by BulkWorkspaceResources.Apply to track which resources belong to which bundle for reconciliation / soft-delete on re-apply. - `ExternalID string` External ID for the resource (e.g., a workflow ID from an external system) - `Labels map[string, string]` Arbitrary key-value pairs for categorization and filtering Examples: {"environment": "production", "team": "platform", "version": "v2"} - `Spec ToolSpec` - `Config ToolSpecConfig` Config defines the adapter to use for the tool. This is used to determine how the tool is called. For example, if the tool is an HTTP tool, the adapter will be Http. If the tool is an inline tool, the adapter will be Inline. - `HTTP ConfigHTTP` - `RequestMethod ConfigHTTPRequestMethod` - `const ConfigHTTPRequestMethodHTTPMethodUnspecified ConfigHTTPRequestMethod = "HTTP_METHOD_UNSPECIFIED"` - `const ConfigHTTPRequestMethodGet ConfigHTTPRequestMethod = "GET"` - `const ConfigHTTPRequestMethodPost ConfigHTTPRequestMethod = "POST"` - `const ConfigHTTPRequestMethodPut ConfigHTTPRequestMethod = "PUT"` - `const ConfigHTTPRequestMethodPatch ConfigHTTPRequestMethod = "PATCH"` - `const ConfigHTTPRequestMethodDelete ConfigHTTPRequestMethod = "DELETE"` - `Headers map[string, string]` - `Path string` - `Query string` - `RequestBodyContentType string` - `RequestBodyTemplate string` These are only used when the request method is a POST, PUT, or PATCH - `ToolName string` The tool name (commonly an "operation id" in OpenAPI specs) to call on the HTTP adapter. This is used to match the tool spec to the correct endpoint on the HTTP adapter. it will be derived from the name of the tool if not provided. - `Mcp ConfigMcp` - `ToolDescription string` - `ToolName string` - `ToolTitle string` - `OpenAPI ConfigOpenAPI` - `Method string` - `OperationID string` - `Path string` - `Description string` - `Parameters map[string, unknown]` - `Status ToolSpecStatus` - `const ToolSpecStatusToolStatusUnspecified ToolSpecStatus = "TOOL_STATUS_UNSPECIFIED"` - `const ToolSpecStatusToolStatusAvailable ToolSpecStatus = "TOOL_STATUS_AVAILABLE"` - `const ToolSpecStatusToolStatusOmitted ToolSpecStatus = "TOOL_STATUS_OMITTED"` - `const ToolSpecStatusToolStatusArchived ToolSpecStatus = "TOOL_STATUS_ARCHIVED"` - `RequiresApproval bool` - `Info ToolInfo` - `CreatedBy Profile` A profile identifies a user or non-human principal (such as an API key) at the account level. Profiles are account-scoped and can be granted access to multiple workspaces. - `Metadata AccountResourceMetadata` AccountResourceMetadata is used to represent a resource that is associated to an account but not to a workspace. - `ID string` Unique identifier for the resource (prefixed ULID, e.g., "apikey_01HXK...") - `AccountID string` Account this resource belongs to for multi-tenant isolation (prefixed ULID) - `Name string` Human-readable name for the resource (e.g., "Customer Support Agent", "Email Tool") Required for resources that users interact with directly - `ProfileID string` - `ExternalID string` External ID for the resource (e.g., a workflow ID from an external system) - `Labels map[string, string]` Arbitrary key-value pairs for categorization and filtering Examples: {"environment": "production", "team": "platform", "version": "v2"} - `Spec ProfileSpec` Configuration for a profile. - `Type ProfileSpecType` Whether this profile represents a human user, an API key, or a system principal. - `const ProfileSpecTypeProfileTypeUnspecified ProfileSpecType = "PROFILE_TYPE_UNSPECIFIED"` - `const ProfileSpecTypeProfileTypeUser ProfileSpecType = "PROFILE_TYPE_USER"` - `const ProfileSpecTypeProfileTypeAPIKey ProfileSpecType = "PROFILE_TYPE_API_KEY"` - `const ProfileSpecTypeProfileTypeSystem ProfileSpecType = "PROFILE_TYPE_SYSTEM"` - `Email string` Email address of the profile. Required and unique within an account for user profiles. - `Name string` Display name (e.g., "Bobby Tables"). - `ToolSet ResourceMetadata` Standard metadata for persistent, named resources (e.g., agents, tools, prompts) ### Bulk Workspace Apply Result Data Tool Set Outcome - `type BulkWorkspaceApplyResultDataToolSetOutcome struct{…}` - `Action BulkWorkspaceApplyResultDataToolSetOutcomeAction` - `const BulkWorkspaceApplyResultDataToolSetOutcomeActionActionUnspecified BulkWorkspaceApplyResultDataToolSetOutcomeAction = "ACTION_UNSPECIFIED"` - `const BulkWorkspaceApplyResultDataToolSetOutcomeActionActionCreated BulkWorkspaceApplyResultDataToolSetOutcomeAction = "ACTION_CREATED"` - `const BulkWorkspaceApplyResultDataToolSetOutcomeActionActionUpdated BulkWorkspaceApplyResultDataToolSetOutcomeAction = "ACTION_UPDATED"` - `const BulkWorkspaceApplyResultDataToolSetOutcomeActionActionUnchanged BulkWorkspaceApplyResultDataToolSetOutcomeAction = "ACTION_UNCHANGED"` - `const BulkWorkspaceApplyResultDataToolSetOutcomeActionActionDeleted BulkWorkspaceApplyResultDataToolSetOutcomeAction = "ACTION_DELETED"` - `const BulkWorkspaceApplyResultDataToolSetOutcomeActionActionFailed BulkWorkspaceApplyResultDataToolSetOutcomeAction = "ACTION_FAILED"` - `Error BulkWorkspaceApplyResultDataToolSetOutcomeError` The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). - `Code int64` The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. - `Details []BulkWorkspaceApplyResultDataToolSetOutcomeErrorDetail` A list of messages that carry the error details. There is a common set of message types for APIs to use. - `Type string` The type of the serialized message. - `Message string` A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. - `ExternalID string` - `Resource ToolSet` - `Metadata ResourceMetadata` Standard metadata for persistent, named resources (e.g., agents, tools, prompts) - `ID string` Unique identifier for the resource (prefixed ULID, e.g., "agent_01HXK...") - `AccountID string` Account this resource belongs to for multi-tenant isolation (prefixed ULID) - `CreatedAt Time` Timestamp when this resource was created - `Name string` Human-readable name for the resource (e.g., "Customer Support Agent", "Email Tool") Required for resources that users interact with directly - `ProfileID string` ID of the actor (user or service account) that created this resource - `WorkspaceID string` Workspace this resource belongs to for organizational grouping (prefixed ULID) - `BundleKey string` Optional bundle ownership key. When set, indicates the resource is managed by a configuration bundle identified by this key. Used by BulkWorkspaceResources.Apply to track which resources belong to which bundle for reconciliation / soft-delete on re-apply. - `ExternalID string` External ID for the resource (e.g., a workflow ID from an external system) - `Labels map[string, string]` Arbitrary key-value pairs for categorization and filtering Examples: {"environment": "production", "team": "platform", "version": "v2"} - `Spec ToolSetSpec` - `Adapter ToolSetAdapter` - `HTTP ToolSetAdapterHTTP` - `BaseURL string` - `Headers map[string, string]` - `Mcp ToolSetAdapterMcp` - `ExcludeTools ToolFilter` Top-level filter with simple boolean logic (no nesting) - `Operator ToolFilterOperator` - `const ToolFilterOperatorOperatorUnspecified ToolFilterOperator = "OPERATOR_UNSPECIFIED"` - `const ToolFilterOperatorOperatorAnd ToolFilterOperator = "OPERATOR_AND"` - `const ToolFilterOperatorOperatorOr ToolFilterOperator = "OPERATOR_OR"` - `Filters []AttributeFilter` - `Attribute AttributeFilterAttribute` - `const AttributeFilterAttributeAttributeUnspecified AttributeFilterAttribute = "ATTRIBUTE_UNSPECIFIED"` - `const AttributeFilterAttributeAttributeName AttributeFilterAttribute = "ATTRIBUTE_NAME"` - `const AttributeFilterAttributeAttributeTitle AttributeFilterAttribute = "ATTRIBUTE_TITLE"` - `const AttributeFilterAttributeAttributeDescription AttributeFilterAttribute = "ATTRIBUTE_DESCRIPTION"` - `Matcher StringMatcher` String matching operations - `CaseSensitive bool` - `Contains string` - `EndsWith string` - `Exact string` - `Regex string` - `StartsWith string` - `Headers map[string, string]` - `IncludeTools ToolFilter` Top-level filter with simple boolean logic (no nesting) - `ToolApprovals ApprovalRequirementFilter` Approval filters that will automatically set the approval requirement on tools synced from an external source - `Always bool` - `Only ToolFilter` Top-level filter with simple boolean logic (no nesting) - `URL string` - `OpenAPI ToolSetAdapterOpenAPI` - `BaseURL string` Base URL for dispatching tool calls. If set, overrides the server resolved from the spec's servers array. - `ExcludeTools ToolFilter` Top-level filter with simple boolean logic (no nesting) - `Headers map[string, string]` Headers sent when fetching the spec from a URL and when dispatching tool calls. - `IncludeTools ToolFilter` Top-level filter with simple boolean logic (no nesting) - `ServerName string` Name of the server entry in the spec's servers array (OpenAPI 3.2 server.name field). Used to select which server URL to dispatch to when base_url is not set. If unset, the first server is used. Ignored when base_url is set. - `ToolApprovals ApprovalRequirementFilter` Approval filters that will automatically set the approval requirement on tools synced from an external source - `UploadID string` ID of a COMPLETE Upload containing the OpenAPI spec document. - `URL string` URL to fetch the OpenAPI spec from. Synced automatically every hour. - `Description string` - `Info ToolSetInfo` Tool set information - `AgentCount int64` - `CreatedBy Profile` A profile identifies a user or non-human principal (such as an API key) at the account level. Profiles are account-scoped and can be granted access to multiple workspaces. - `Metadata AccountResourceMetadata` AccountResourceMetadata is used to represent a resource that is associated to an account but not to a workspace. - `ID string` Unique identifier for the resource (prefixed ULID, e.g., "apikey_01HXK...") - `AccountID string` Account this resource belongs to for multi-tenant isolation (prefixed ULID) - `Name string` Human-readable name for the resource (e.g., "Customer Support Agent", "Email Tool") Required for resources that users interact with directly - `ProfileID string` - `ExternalID string` External ID for the resource (e.g., a workflow ID from an external system) - `Labels map[string, string]` Arbitrary key-value pairs for categorization and filtering Examples: {"environment": "production", "team": "platform", "version": "v2"} - `Spec ProfileSpec` Configuration for a profile. - `Type ProfileSpecType` Whether this profile represents a human user, an API key, or a system principal. - `const ProfileSpecTypeProfileTypeUnspecified ProfileSpecType = "PROFILE_TYPE_UNSPECIFIED"` - `const ProfileSpecTypeProfileTypeUser ProfileSpecType = "PROFILE_TYPE_USER"` - `const ProfileSpecTypeProfileTypeAPIKey ProfileSpecType = "PROFILE_TYPE_API_KEY"` - `const ProfileSpecTypeProfileTypeSystem ProfileSpecType = "PROFILE_TYPE_SYSTEM"` - `Email string` Email address of the profile. Required and unique within an account for user profiles. - `Name string` Display name (e.g., "Bobby Tables"). - `LastSync Time` - `ToolCount int64` ### Bulk Workspace Apply Result Data Variation Assignment Outcome - `type BulkWorkspaceApplyResultDataVariationAssignmentOutcome struct{…}` - `Action BulkWorkspaceApplyResultDataVariationAssignmentOutcomeAction` - `const BulkWorkspaceApplyResultDataVariationAssignmentOutcomeActionActionUnspecified BulkWorkspaceApplyResultDataVariationAssignmentOutcomeAction = "ACTION_UNSPECIFIED"` - `const BulkWorkspaceApplyResultDataVariationAssignmentOutcomeActionActionCreated BulkWorkspaceApplyResultDataVariationAssignmentOutcomeAction = "ACTION_CREATED"` - `const BulkWorkspaceApplyResultDataVariationAssignmentOutcomeActionActionUpdated BulkWorkspaceApplyResultDataVariationAssignmentOutcomeAction = "ACTION_UPDATED"` - `const BulkWorkspaceApplyResultDataVariationAssignmentOutcomeActionActionUnchanged BulkWorkspaceApplyResultDataVariationAssignmentOutcomeAction = "ACTION_UNCHANGED"` - `const BulkWorkspaceApplyResultDataVariationAssignmentOutcomeActionActionDeleted BulkWorkspaceApplyResultDataVariationAssignmentOutcomeAction = "ACTION_DELETED"` - `const BulkWorkspaceApplyResultDataVariationAssignmentOutcomeActionActionFailed BulkWorkspaceApplyResultDataVariationAssignmentOutcomeAction = "ACTION_FAILED"` - `Error BulkWorkspaceApplyResultDataVariationAssignmentOutcomeError` The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). - `Code int64` The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. - `Details []BulkWorkspaceApplyResultDataVariationAssignmentOutcomeErrorDetail` A list of messages that carry the error details. There is a common set of message types for APIs to use. - `Type string` The type of the serialized message. - `Message string` A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. - `Resource VariationAssignment` A read-only reference to a single tool, tool set, or sub-agent attached to a variation. Read the full set of assignments via `AgentVariationInfo.assignments`; mutations go through the dedicated add/remove assignment endpoints. The `id` identifies the assignment itself (not the referenced resource) and is the handle used to remove the assignment. It is returned by the add endpoint and present on every entry in `AgentVariationInfo.assignments`. - `ID string` - `Agent BareMetadata` BareMetadata contains the minimal metadata for a resource: the ID and an optional human-readable name. These are used for reference fields where the full metadata (account scoping, timestamps, labels, external IDs) is not needed — e.g., the tool references inside an agent variation spec or the tools assigned to an objective. Both fields are server-populated; clients provide IDs through sibling fields rather than by constructing a BareMetadata themselves. - `ID string` - `Name string` Human-readable name of the referenced resource, populated by the server on reads for convenience. Absent on references to resources that do not have a name (e.g., objective tasks). - `Tool BareMetadata` BareMetadata contains the minimal metadata for a resource: the ID and an optional human-readable name. These are used for reference fields where the full metadata (account scoping, timestamps, labels, external IDs) is not needed — e.g., the tool references inside an agent variation spec or the tools assigned to an objective. Both fields are server-populated; clients provide IDs through sibling fields rather than by constructing a BareMetadata themselves. - `ToolSet BareMetadata` BareMetadata contains the minimal metadata for a resource: the ID and an optional human-readable name. These are used for reference fields where the full metadata (account scoping, timestamps, labels, external IDs) is not needed — e.g., the tool references inside an agent variation spec or the tools assigned to an objective. Both fields are server-populated; clients provide IDs through sibling fields rather than by constructing a BareMetadata themselves. ### Bulk Workspace Apply Result Data Variation Memory Layer Outcome - `type BulkWorkspaceApplyResultDataVariationMemoryLayerOutcome struct{…}` - `Action BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeAction` - `const BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeActionActionUnspecified BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeAction = "ACTION_UNSPECIFIED"` - `const BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeActionActionCreated BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeAction = "ACTION_CREATED"` - `const BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeActionActionUpdated BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeAction = "ACTION_UPDATED"` - `const BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeActionActionUnchanged BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeAction = "ACTION_UNCHANGED"` - `const BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeActionActionDeleted BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeAction = "ACTION_DELETED"` - `const BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeActionActionFailed BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeAction = "ACTION_FAILED"` - `Error BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeError` The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). - `Code int64` The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code]. - `Details []BulkWorkspaceApplyResultDataVariationMemoryLayerOutcomeErrorDetail` A list of messages that carry the error details. There is a common set of message types for APIs to use. - `Type string` The type of the serialized message. - `Message string` A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client. - `Resource VariationMemoryLayerAssignment` VariationMemoryLayerAssignment attaches a single MemoryLayer to a variation at a given position in the variation's baseline memory stack. A variation has at most one assignment per memory_layer_id. Variations only support whole-layer attachments — entry pinning is an objective-level capability. - `ID string` Assignment row id — handle for removing the assignment. Distinct from the referenced memory layer's id. - `MemoryLayer BareMetadata` BareMetadata contains the minimal metadata for a resource: the ID and an optional human-readable name. These are used for reference fields where the full metadata (account scoping, timestamps, labels, external IDs) is not needed — e.g., the tool references inside an agent variation spec or the tools assigned to an objective. Both fields are server-populated; clients provide IDs through sibling fields rather than by constructing a BareMetadata themselves. - `ID string` - `Name string` Human-readable name of the referenced resource, populated by the server on reads for convenience. Absent on references to resources that do not have a name (e.g., objective tasks). - `Position int64` Position in the variation's baseline stack. Lower values sit lower; the highest-position assignment is on top of the variation's baseline. Gaps are fine — only relative position matters. Positions must be unique within a variation; a request that would collide with an existing assignment's position is rejected with InvalidArgument.