From 2bdb4fc9ed0e93a7d2d7892849f17510c8372cf6 Mon Sep 17 00:00:00 2001 From: moonyue-w <300878504+moonyue-w@users.noreply.github.com> Date: Tue, 20 Oct 2026 17:16:02 +0800 Subject: [PATCH] feat(api): align existing contracts for 0.8.0 --- CHANGELOG.md | 17 +++ docs/api/forward/README.md | 5 + docs/api/forward/interfaces/Batch.md | 14 ++ docs/api/forward/interfaces/BatchNewParams.md | 8 ++ docs/api/forward/interfaces/Environment.md | 12 ++ .../interfaces/EnvironmentBindingInfo.md | 13 ++ .../forward/interfaces/EnvironmentConfig.md | 6 + .../interfaces/MemoryStoreCreateMountParam.md | 27 ++++ .../interfaces/MemoryStoreNewParams.md | 8 ++ docs/api/forward/interfaces/Schedule.md | 20 +++ docs/api/forward/interfaces/ScheduleRun.md | 20 +++ .../interfaces/ScheduleTriggerPolicy.md | 18 +++ docs/api/forward/interfaces/Session.md | 6 + .../forward/interfaces/SessionListParams.md | 8 ++ .../interfaces/SessionOutcomeEvaluation.md | 49 +++++++ docs/api/forward/interfaces/SessionThread.md | 12 ++ .../forward/interfaces/SessionThreadStats.md | 25 ++++ .../forward/interfaces/SessionThreadUsage.md | 13 ++ docs/api/forward/interfaces/Skill.md | 2 +- docs/api/forward/interfaces/Template.md | 8 ++ .../forward/interfaces/TemplateNewParams.md | 8 ++ .../interfaces/TemplateUpdateParams.md | 8 ++ docs/api/index/variables/VERSION.md | 2 +- docs/api/managed/README.md | 10 ++ docs/api/managed/interfaces/DreamOutput.md | 8 ++ ...anagedAgentsAgentArtifactDeliveredEvent.md | 51 +++++++ .../interfaces/ManagedAgentsBillingError.md | 8 ++ ...gedAgentsCredentialHostUnreachableError.md | 8 ++ ...gedAgentsGitHubRepositoryResourceParams.md | 4 +- .../ManagedAgentsGitRepositoryResource.md | 55 +++++++ ...anagedAgentsGitRepositoryResourceConfig.md | 39 +++++ ...anagedAgentsGitRepositoryResourceParams.md | 47 ++++++ ...nagedAgentsMCPAuthenticationFailedError.md | 8 ++ .../ManagedAgentsMCPConnectionFailedError.md | 8 ++ .../interfaces/ManagedAgentsMemoryStore.md | 18 +++ .../ManagedAgentsModelOverloadedError.md | 8 ++ .../ManagedAgentsModelRateLimitedError.md | 8 ++ .../ManagedAgentsModelRequestFailedError.md | 8 ++ .../interfaces/ManagedAgentsSessionThread.md | 8 +- .../interfaces/ManagedAgentsUnknownError.md | 8 ++ .../managed/interfaces/SelfHostedConfig.md | 6 + .../interfaces/SelfHostedConfigParams.md | 6 + .../interfaces/SessionResourceUpdateParams.md | 4 +- docs/api/managed/interfaces/Skill.md | 2 +- .../DeploymentNewParamsResourceUnion.md | 2 +- .../DeploymentUpdateParamsResourceUnion.md | 2 +- ...gentsGitRepositoryResourceCheckoutUnion.md | 9 ++ ...itRepositoryResourceConfigCheckoutUnion.md | 9 ++ ...edAgentsGitRepositoryResourceConfigType.md | 9 ++ ...itRepositoryResourceParamsCheckoutUnion.md | 9 ++ ...edAgentsGitRepositoryResourceParamsType.md | 9 ++ .../ManagedAgentsGitRepositoryResourceType.md | 9 ++ .../ManagedAgentsSessionEventUnion.md | 2 +- ...ManagedAgentsSessionResourceConfigUnion.md | 2 +- .../ManagedAgentsSessionResourceUnion.md | 2 +- .../ManagedAgentsStreamSessionEventsUnion.md | 2 +- ...gedAgentsStreamSessionThreadEventsUnion.md | 2 +- .../SessionNewParamsResourceUnion.md | 2 +- .../SessionResourceGetResponseUnion.md | 2 +- .../SessionResourceUpdateResponseUnion.md | 2 +- package-lock.json | 4 +- package.json | 2 +- src/forward/types.ts | 65 ++++++++- src/managed/types.ts | 136 +++++++++++++++--- src/version.ts | 2 +- tests/contract-alignment-080.test.mjs | 83 +++++++++++ tests/fixtures/contract-alignment-0.8.json | 120 ++++++++++++++++ tests/managed-types.ts | 19 +++ tests/types-smoke.ts | 29 ++++ 69 files changed, 1124 insertions(+), 41 deletions(-) create mode 100644 docs/api/forward/interfaces/EnvironmentBindingInfo.md create mode 100644 docs/api/forward/interfaces/MemoryStoreCreateMountParam.md create mode 100644 docs/api/forward/interfaces/SessionOutcomeEvaluation.md create mode 100644 docs/api/forward/interfaces/SessionThreadStats.md create mode 100644 docs/api/forward/interfaces/SessionThreadUsage.md create mode 100644 docs/api/managed/interfaces/ManagedAgentsAgentArtifactDeliveredEvent.md create mode 100644 docs/api/managed/interfaces/ManagedAgentsGitRepositoryResource.md create mode 100644 docs/api/managed/interfaces/ManagedAgentsGitRepositoryResourceConfig.md create mode 100644 docs/api/managed/interfaces/ManagedAgentsGitRepositoryResourceParams.md create mode 100644 docs/api/managed/type-aliases/ManagedAgentsGitRepositoryResourceCheckoutUnion.md create mode 100644 docs/api/managed/type-aliases/ManagedAgentsGitRepositoryResourceConfigCheckoutUnion.md create mode 100644 docs/api/managed/type-aliases/ManagedAgentsGitRepositoryResourceConfigType.md create mode 100644 docs/api/managed/type-aliases/ManagedAgentsGitRepositoryResourceParamsCheckoutUnion.md create mode 100644 docs/api/managed/type-aliases/ManagedAgentsGitRepositoryResourceParamsType.md create mode 100644 docs/api/managed/type-aliases/ManagedAgentsGitRepositoryResourceType.md create mode 100644 tests/contract-alignment-080.test.mjs create mode 100644 tests/fixtures/contract-alignment-0.8.json diff --git a/CHANGELOG.md b/CHANGELOG.md index c13020b..3677342 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -5,6 +5,23 @@ existing `0.1.0` release; earlier development prereleases are not listed. ## [Unreleased] +## [0.8.0] + +### Fixed + +- Align existing Managed Session and Deployment resource types with generic HTTP(S) `git_repository`, including write-only credentials, branch/commit checkout, and optional GitHub authorization for public repositories. +- Add Forward Template `max_tool_rounds`, Batch `ignore_idle_window` / `queue_reason`, and Session list `search`; preserve omitted, null, false, and zero values according to each API contract. +- Expose Forward Session outcome evaluations and Thread statistics/Credits, Schedule and Run source/input-version metadata, and trigger time boundaries. +- Support Forward MemoryStore creation with a native `mount` (Identity, Template, and optional access), preserving the create request's idempotency key for retries. +- Expose self-hosted Environment setup scripts, Forward Environment binding metadata, Managed MemoryStore status/count/size, and Dream output file paths. +- Decode flat `agent.artifact_delivered` fields and diagnostic `session.error.error.qoder_error_code` in Managed event history, Session SSE, and Thread SSE. No additional API endpoints are introduced. + +### Migration + +- Omitting `max_tool_rounds` on update preserves the configured limit; null clears it. `ignore_idle_window` accepts a boolean, with false as the server default. +- Treat an absent Schedule Run input version or Thread usage as unknown, not zero. Use `retry_status` rather than `qoder_error_code` to decide whether execution can retry. +- Handle null `Skill.latest_version` and optional legacy Managed Thread `usage` in TypeScript consumers. + ## [0.7.0] ### Fixed diff --git a/docs/api/forward/README.md b/docs/api/forward/README.md index ca32561..e3ab282 100644 --- a/docs/api/forward/README.md +++ b/docs/api/forward/README.md @@ -91,6 +91,7 @@ - [EffectiveConfigSession](interfaces/EffectiveConfigSession.md) - [EffectiveConfigSessionResourcesItem](interfaces/EffectiveConfigSessionResourcesItem.md) - [Environment](interfaces/Environment.md) +- [EnvironmentBindingInfo](interfaces/EnvironmentBindingInfo.md) - [EnvironmentConfig](interfaces/EnvironmentConfig.md) - [EnvironmentConfigPackages](interfaces/EnvironmentConfigPackages.md) - [EnvironmentListParams](interfaces/EnvironmentListParams.md) @@ -130,6 +131,7 @@ - [MCPServerParam](interfaces/MCPServerParam.md) - [Memory](interfaces/Memory.md) - [MemoryStore](interfaces/MemoryStore.md) +- [MemoryStoreCreateMountParam](interfaces/MemoryStoreCreateMountParam.md) - [MemoryStoreListParams](interfaces/MemoryStoreListParams.md) - [MemoryStoreMemoryListParams](interfaces/MemoryStoreMemoryListParams.md) - [MemoryStoreMemoryNewParams](interfaces/MemoryStoreMemoryNewParams.md) @@ -188,6 +190,7 @@ - [SessionListParams](interfaces/SessionListParams.md) - [SessionNewParams](interfaces/SessionNewParams.md) - [SessionNewParamsConfigParam](interfaces/SessionNewParamsConfigParam.md) +- [SessionOutcomeEvaluation](interfaces/SessionOutcomeEvaluation.md) - [SessionResource](interfaces/SessionResource.md) - [SessionResourceAddParams](interfaces/SessionResourceAddParams.md) - [SessionResourceSpec](interfaces/SessionResourceSpec.md) @@ -199,7 +202,9 @@ - [SessionThreadEventListParams](interfaces/SessionThreadEventListParams.md) - [SessionThreadEventStreamParams](interfaces/SessionThreadEventStreamParams.md) - [SessionThreadListParams](interfaces/SessionThreadListParams.md) +- [SessionThreadStats](interfaces/SessionThreadStats.md) - [SessionThreadStopReason](interfaces/SessionThreadStopReason.md) +- [SessionThreadUsage](interfaces/SessionThreadUsage.md) - [SessionUpdateParams](interfaces/SessionUpdateParams.md) - [SessionUpdateParamsConfigParam](interfaces/SessionUpdateParamsConfigParam.md) - [SessionUsage](interfaces/SessionUsage.md) diff --git a/docs/api/forward/interfaces/Batch.md b/docs/api/forward/interfaces/Batch.md index 2b8421c..6391aa6 100644 --- a/docs/api/forward/interfaces/Batch.md +++ b/docs/api/forward/interfaces/Batch.md @@ -94,6 +94,12 @@ Batch ID，前缀 `batch_`。 *** +### ignore\_idle\_window? + +> `optional` **ignore\_idle\_window?**: `boolean` + +*** + ### input\_file\_id > **input\_file\_id**: `string` @@ -134,6 +140,14 @@ Batch ID，前缀 `batch_`。 *** +### queue\_reason? + +> `optional` **queue\_reason?**: `string` + +Dynamic queue reason, present only when applicable to validating or queued Batches. + +*** + ### request\_counts > **request\_counts**: [`BatchRequestCounts`](BatchRequestCounts.md) diff --git a/docs/api/forward/interfaces/BatchNewParams.md b/docs/api/forward/interfaces/BatchNewParams.md index 250b8f1..5779470 100644 --- a/docs/api/forward/interfaces/BatchNewParams.md +++ b/docs/api/forward/interfaces/BatchNewParams.md @@ -30,6 +30,14 @@ Additional fields are preserved verbatim by the SDK. *** +### ignore\_idle\_window? + +> `optional` **ignore\_idle\_window?**: `boolean` + +Ignore the scheduling time window; capacity and FIFO priority still apply. + +*** + ### input\_file\_id > **input\_file\_id**: `string` diff --git a/docs/api/forward/interfaces/Environment.md b/docs/api/forward/interfaces/Environment.md index 5dbf4e5..40d10bc 100644 --- a/docs/api/forward/interfaces/Environment.md +++ b/docs/api/forward/interfaces/Environment.md @@ -20,6 +20,12 @@ Additional fields are preserved verbatim by the SDK. *** +### binding\_info? + +> `optional` **binding\_info?**: [`EnvironmentBindingInfo`](EnvironmentBindingInfo.md) + +*** + ### config > **config**: [`EnvironmentConfig`](EnvironmentConfig.md) @@ -38,6 +44,12 @@ Additional fields are preserved verbatim by the SDK. *** +### icon\_url? + +> `optional` **icon\_url?**: `string` \| `null` + +*** + ### id > **id**: `string` diff --git a/docs/api/forward/interfaces/EnvironmentBindingInfo.md b/docs/api/forward/interfaces/EnvironmentBindingInfo.md new file mode 100644 index 0000000..1df4edd --- /dev/null +++ b/docs/api/forward/interfaces/EnvironmentBindingInfo.md @@ -0,0 +1,13 @@ +[**qca-sdk**](../../README.md) + +*** + +[qca-sdk](../../README.md) / [forward](../README.md) / EnvironmentBindingInfo + +# Interface: EnvironmentBindingInfo + +## Properties + +### agent\_template\_count + +> **agent\_template\_count**: `number` diff --git a/docs/api/forward/interfaces/EnvironmentConfig.md b/docs/api/forward/interfaces/EnvironmentConfig.md index d7da122..06a32e7 100644 --- a/docs/api/forward/interfaces/EnvironmentConfig.md +++ b/docs/api/forward/interfaces/EnvironmentConfig.md @@ -20,6 +20,12 @@ Additional fields are preserved verbatim by the SDK. *** +### setup\_script? + +> `optional` **setup\_script?**: `string` + +*** + ### type > **type**: `string` diff --git a/docs/api/forward/interfaces/MemoryStoreCreateMountParam.md b/docs/api/forward/interfaces/MemoryStoreCreateMountParam.md new file mode 100644 index 0000000..73ec653 --- /dev/null +++ b/docs/api/forward/interfaces/MemoryStoreCreateMountParam.md @@ -0,0 +1,27 @@ +[**qca-sdk**](../../README.md) + +*** + +[qca-sdk](../../README.md) / [forward](../README.md) / MemoryStoreCreateMountParam + +# Interface: MemoryStoreCreateMountParam + +## Properties + +### access? + +> `optional` **access?**: `"read_only"` \| `"read_write"` + +Defaults to read_only. + +*** + +### identity\_id + +> **identity\_id**: `string` + +*** + +### template\_id + +> **template\_id**: `string` diff --git a/docs/api/forward/interfaces/MemoryStoreNewParams.md b/docs/api/forward/interfaces/MemoryStoreNewParams.md index c1fcd81..cf13324 100644 --- a/docs/api/forward/interfaces/MemoryStoreNewParams.md +++ b/docs/api/forward/interfaces/MemoryStoreNewParams.md @@ -38,6 +38,14 @@ Additional fields are preserved verbatim by the SDK. *** +### mount? + +> `optional` **mount?**: [`MemoryStoreCreateMountParam`](MemoryStoreCreateMountParam.md) + +Establish this mount before returning; use the same key and body to resume creation. + +*** + ### name > **name**: `string` diff --git a/docs/api/forward/interfaces/Schedule.md b/docs/api/forward/interfaces/Schedule.md index 843c0bf..0474eb6 100644 --- a/docs/api/forward/interfaces/Schedule.md +++ b/docs/api/forward/interfaces/Schedule.md @@ -62,6 +62,14 @@ Additional fields are preserved verbatim by the SDK. *** +### initial\_events\_version? + +> `optional` **initial\_events\_version?**: `number` + +Server-maintained input version, incremented when initial_events changes. + +*** + ### metadata > **metadata**: `Record`\<`string`, `unknown`\> @@ -86,6 +94,18 @@ Additional fields are preserved verbatim by the SDK. *** +### source? + +> `optional` **source?**: `string` + +*** + +### source\_session\_id? + +> `optional` **source\_session\_id?**: `string` \| `null` + +*** + ### status > **status**: `string` diff --git a/docs/api/forward/interfaces/ScheduleRun.md b/docs/api/forward/interfaces/ScheduleRun.md index 9483400..3710bd5 100644 --- a/docs/api/forward/interfaces/ScheduleRun.md +++ b/docs/api/forward/interfaces/ScheduleRun.md @@ -78,6 +78,14 @@ Forward Identity ID。 *** +### initial\_events\_version? + +> `optional` **initial\_events\_version?**: `number` + +Server-selected input version; a missing Run version is unknown. + +*** + ### push\_finished\_at > **push\_finished\_at**: `string` @@ -126,6 +134,18 @@ null|本次执行创建或使用的 Session。 *** +### source? + +> `optional` **source?**: `string` + +*** + +### source\_session\_id? + +> `optional` **source\_session\_id?**: `string` \| `null` + +*** + ### started\_at > **started\_at**: `string` diff --git a/docs/api/forward/interfaces/ScheduleTriggerPolicy.md b/docs/api/forward/interfaces/ScheduleTriggerPolicy.md index 9f2ee6a..53f18cb 100644 --- a/docs/api/forward/interfaces/ScheduleTriggerPolicy.md +++ b/docs/api/forward/interfaces/ScheduleTriggerPolicy.md @@ -20,6 +20,24 @@ Additional fields are preserved verbatim by the SDK. *** +### last\_run\_at? + +> `optional` **last\_run\_at?**: `string` \| `null` + +*** + +### start\_at? + +> `optional` **start\_at?**: `string` + +*** + +### stop\_at? + +> `optional` **stop\_at?**: `string` + +*** + ### timezone > **timezone**: `string` diff --git a/docs/api/forward/interfaces/Session.md b/docs/api/forward/interfaces/Session.md index ac54157..ab01677 100644 --- a/docs/api/forward/interfaces/Session.md +++ b/docs/api/forward/interfaces/Session.md @@ -54,6 +54,12 @@ Forward Identity ID。 *** +### outcome\_evaluations? + +> `optional` **outcome\_evaluations?**: [`SessionOutcomeEvaluation`](SessionOutcomeEvaluation.md)[] + +*** + ### resources > **resources**: [`SessionResource`](SessionResource.md)[] diff --git a/docs/api/forward/interfaces/SessionListParams.md b/docs/api/forward/interfaces/SessionListParams.md index 7b71125..e0d0208 100644 --- a/docs/api/forward/interfaces/SessionListParams.md +++ b/docs/api/forward/interfaces/SessionListParams.md @@ -94,6 +94,14 @@ Additional fields are preserved verbatim by the SDK. *** +### search? + +> `optional` **search?**: `string` + +Match an exact sess_ ID or search Session titles. + +*** + ### source\_type? > `optional` **source\_type?**: `string` \| `null` diff --git a/docs/api/forward/interfaces/SessionOutcomeEvaluation.md b/docs/api/forward/interfaces/SessionOutcomeEvaluation.md new file mode 100644 index 0000000..a03aba0 --- /dev/null +++ b/docs/api/forward/interfaces/SessionOutcomeEvaluation.md @@ -0,0 +1,49 @@ +[**qca-sdk**](../../README.md) + +*** + +[qca-sdk](../../README.md) / [forward](../README.md) / SessionOutcomeEvaluation + +# Interface: SessionOutcomeEvaluation + +## Properties + +### completed\_at + +> **completed\_at**: `string` \| `null` + +*** + +### description + +> **description**: `string` + +*** + +### explanation + +> **explanation**: `string` \| `null` + +*** + +### iteration + +> **iteration**: `number` + +*** + +### outcome\_id + +> **outcome\_id**: `string` + +*** + +### result + +> **result**: `string` + +*** + +### type + +> **type**: `string` diff --git a/docs/api/forward/interfaces/SessionThread.md b/docs/api/forward/interfaces/SessionThread.md index 2c7eb72..7ca3a24 100644 --- a/docs/api/forward/interfaces/SessionThread.md +++ b/docs/api/forward/interfaces/SessionThread.md @@ -62,6 +62,12 @@ Additional fields are preserved verbatim by the SDK. *** +### stats? + +> `optional` **stats?**: [`SessionThreadStats`](SessionThreadStats.md) + +*** + ### status > **status**: `string` @@ -89,3 +95,9 @@ Additional fields are preserved verbatim by the SDK. ### updated\_at > **updated\_at**: `string` + +*** + +### usage? + +> `optional` **usage?**: [`SessionThreadUsage`](SessionThreadUsage.md) diff --git a/docs/api/forward/interfaces/SessionThreadStats.md b/docs/api/forward/interfaces/SessionThreadStats.md new file mode 100644 index 0000000..a668153 --- /dev/null +++ b/docs/api/forward/interfaces/SessionThreadStats.md @@ -0,0 +1,25 @@ +[**qca-sdk**](../../README.md) + +*** + +[qca-sdk](../../README.md) / [forward](../README.md) / SessionThreadStats + +# Interface: SessionThreadStats + +## Properties + +### active\_seconds + +> **active\_seconds**: `number` + +*** + +### duration\_seconds + +> **duration\_seconds**: `number` + +*** + +### startup\_seconds? + +> `optional` **startup\_seconds?**: `number` diff --git a/docs/api/forward/interfaces/SessionThreadUsage.md b/docs/api/forward/interfaces/SessionThreadUsage.md new file mode 100644 index 0000000..9d4895e --- /dev/null +++ b/docs/api/forward/interfaces/SessionThreadUsage.md @@ -0,0 +1,13 @@ +[**qca-sdk**](../../README.md) + +*** + +[qca-sdk](../../README.md) / [forward](../README.md) / SessionThreadUsage + +# Interface: SessionThreadUsage + +## Properties + +### total\_credits? + +> `optional` **total\_credits?**: `number` diff --git a/docs/api/forward/interfaces/Skill.md b/docs/api/forward/interfaces/Skill.md index ae46df6..db1ad7b 100644 --- a/docs/api/forward/interfaces/Skill.md +++ b/docs/api/forward/interfaces/Skill.md @@ -58,7 +58,7 @@ Additional fields are preserved verbatim by the SDK. ### latest\_version -> **latest\_version**: `string` +> **latest\_version**: `string` \| `null` *** diff --git a/docs/api/forward/interfaces/Template.md b/docs/api/forward/interfaces/Template.md index b1ca1c2..dbdfccb 100644 --- a/docs/api/forward/interfaces/Template.md +++ b/docs/api/forward/interfaces/Template.md @@ -68,6 +68,14 @@ Replaces the complete managed tool list. Null or an empty list disables it. *** +### max\_tool\_rounds? + +> `optional` **max\_tool\_rounds?**: `number` + +Omitted when the explicit limit is unset. + +*** + ### mcp\_servers > **mcp\_servers**: [`MCPServer`](MCPServer.md)[] diff --git a/docs/api/forward/interfaces/TemplateNewParams.md b/docs/api/forward/interfaces/TemplateNewParams.md index 875197c..229bfc5 100644 --- a/docs/api/forward/interfaces/TemplateNewParams.md +++ b/docs/api/forward/interfaces/TemplateNewParams.md @@ -70,6 +70,14 @@ Replaces the complete managed tool list. Null or an empty list disables it. *** +### max\_tool\_rounds? + +> `optional` **max\_tool\_rounds?**: `number` \| `null` + +Positive maximum tool-call rounds per Turn. Omit or pass null to use the platform default. + +*** + ### mcp\_servers? > `optional` **mcp\_servers?**: [`MCPServerParam`](MCPServerParam.md)[] \| `null` diff --git a/docs/api/forward/interfaces/TemplateUpdateParams.md b/docs/api/forward/interfaces/TemplateUpdateParams.md index 4b4aaeb..f7d27c8 100644 --- a/docs/api/forward/interfaces/TemplateUpdateParams.md +++ b/docs/api/forward/interfaces/TemplateUpdateParams.md @@ -70,6 +70,14 @@ Replaces the complete managed tool list. Null or an empty list disables it. *** +### max\_tool\_rounds? + +> `optional` **max\_tool\_rounds?**: `number` \| `null` + +Positive maximum tool-call rounds per Turn. Omit to preserve the limit; null clears it. + +*** + ### mcp\_servers? > `optional` **mcp\_servers?**: [`MCPServerParam`](MCPServerParam.md)[] \| `null` diff --git a/docs/api/index/variables/VERSION.md b/docs/api/index/variables/VERSION.md index ac57c50..4bdac20 100644 --- a/docs/api/index/variables/VERSION.md +++ b/docs/api/index/variables/VERSION.md @@ -6,4 +6,4 @@ # Variable: VERSION -> `const` **VERSION**: `"0.7.0"` = `'0.7.0'` +> `const` **VERSION**: `"0.8.0"` = `'0.8.0'` diff --git a/docs/api/managed/README.md b/docs/api/managed/README.md index 6c3c6ee..9e41243 100644 --- a/docs/api/managed/README.md +++ b/docs/api/managed/README.md @@ -143,6 +143,7 @@ - [ManagedAgentsAgent](interfaces/ManagedAgentsAgent.md) - [ManagedAgentsAgentArchivedDeploymentPausedReasonError](interfaces/ManagedAgentsAgentArchivedDeploymentPausedReasonError.md) - [ManagedAgentsAgentArchivedRunError](interfaces/ManagedAgentsAgentArchivedRunError.md) +- [ManagedAgentsAgentArtifactDeliveredEvent](interfaces/ManagedAgentsAgentArtifactDeliveredEvent.md) - [ManagedAgentsAgentCustomToolUseEvent](interfaces/ManagedAgentsAgentCustomToolUseEvent.md) - [ManagedAgentsAgentMCPToolResultEvent](interfaces/ManagedAgentsAgentMCPToolResultEvent.md) - [ManagedAgentsAgentMCPToolUseEvent](interfaces/ManagedAgentsAgentMCPToolUseEvent.md) @@ -251,6 +252,9 @@ - [ManagedAgentsGitHubRepositoryResource](interfaces/ManagedAgentsGitHubRepositoryResource.md) - [ManagedAgentsGitHubRepositoryResourceConfig](interfaces/ManagedAgentsGitHubRepositoryResourceConfig.md) - [ManagedAgentsGitHubRepositoryResourceParams](interfaces/ManagedAgentsGitHubRepositoryResourceParams.md) +- [ManagedAgentsGitRepositoryResource](interfaces/ManagedAgentsGitRepositoryResource.md) +- [ManagedAgentsGitRepositoryResourceConfig](interfaces/ManagedAgentsGitRepositoryResourceConfig.md) +- [ManagedAgentsGitRepositoryResourceParams](interfaces/ManagedAgentsGitRepositoryResourceParams.md) - [ManagedAgentsGlobToolConfig](interfaces/ManagedAgentsGlobToolConfig.md) - [ManagedAgentsGlobToolConfigParams](interfaces/ManagedAgentsGlobToolConfigParams.md) - [ManagedAgentsGrepToolConfig](interfaces/ManagedAgentsGrepToolConfig.md) @@ -733,6 +737,12 @@ - [ManagedAgentsGitHubRepositoryResourceParamsCheckoutUnion](type-aliases/ManagedAgentsGitHubRepositoryResourceParamsCheckoutUnion.md) - [ManagedAgentsGitHubRepositoryResourceParamsType](type-aliases/ManagedAgentsGitHubRepositoryResourceParamsType.md) - [ManagedAgentsGitHubRepositoryResourceType](type-aliases/ManagedAgentsGitHubRepositoryResourceType.md) +- [ManagedAgentsGitRepositoryResourceCheckoutUnion](type-aliases/ManagedAgentsGitRepositoryResourceCheckoutUnion.md) +- [ManagedAgentsGitRepositoryResourceConfigCheckoutUnion](type-aliases/ManagedAgentsGitRepositoryResourceConfigCheckoutUnion.md) +- [ManagedAgentsGitRepositoryResourceConfigType](type-aliases/ManagedAgentsGitRepositoryResourceConfigType.md) +- [ManagedAgentsGitRepositoryResourceParamsCheckoutUnion](type-aliases/ManagedAgentsGitRepositoryResourceParamsCheckoutUnion.md) +- [ManagedAgentsGitRepositoryResourceParamsType](type-aliases/ManagedAgentsGitRepositoryResourceParamsType.md) +- [ManagedAgentsGitRepositoryResourceType](type-aliases/ManagedAgentsGitRepositoryResourceType.md) - [ManagedAgentsGlobToolConfigParamsPermissionPolicyUnion](type-aliases/ManagedAgentsGlobToolConfigParamsPermissionPolicyUnion.md) - [ManagedAgentsGlobToolConfigParamsType](type-aliases/ManagedAgentsGlobToolConfigParamsType.md) - [ManagedAgentsGlobToolConfigPermissionPolicyUnion](type-aliases/ManagedAgentsGlobToolConfigPermissionPolicyUnion.md) diff --git a/docs/api/managed/interfaces/DreamOutput.md b/docs/api/managed/interfaces/DreamOutput.md index fc103b4..04909fe 100644 --- a/docs/api/managed/interfaces/DreamOutput.md +++ b/docs/api/managed/interfaces/DreamOutput.md @@ -10,6 +10,14 @@ An output memory store the dream writes consolidated memories into. ## Properties +### files\_touched? + +> `optional` **files\_touched?**: `string`[] + +Paths of memory files created, modified or deleted. + +*** + ### memory\_store\_id > **memory\_store\_id**: `string` diff --git a/docs/api/managed/interfaces/ManagedAgentsAgentArtifactDeliveredEvent.md b/docs/api/managed/interfaces/ManagedAgentsAgentArtifactDeliveredEvent.md new file mode 100644 index 0000000..808629c --- /dev/null +++ b/docs/api/managed/interfaces/ManagedAgentsAgentArtifactDeliveredEvent.md @@ -0,0 +1,51 @@ +[**qca-sdk**](../../README.md) + +*** + +[qca-sdk](../../README.md) / [managed](../README.md) / ManagedAgentsAgentArtifactDeliveredEvent + +# Interface: ManagedAgentsAgentArtifactDeliveredEvent + +A server-generated event for one successfully delivered artifact file. + +## Properties + +### content\_type + +> **content\_type**: `string` + +*** + +### file\_id + +> **file\_id**: `string` + +*** + +### id + +> **id**: `string` + +*** + +### original\_filename + +> **original\_filename**: `string` + +*** + +### processed\_at? + +> `optional` **processed\_at?**: `string` + +*** + +### size + +> **size**: `number` + +*** + +### type + +> **type**: `"agent.artifact_delivered"` diff --git a/docs/api/managed/interfaces/ManagedAgentsBillingError.md b/docs/api/managed/interfaces/ManagedAgentsBillingError.md index 9301b02..0c641bb 100644 --- a/docs/api/managed/interfaces/ManagedAgentsBillingError.md +++ b/docs/api/managed/interfaces/ManagedAgentsBillingError.md @@ -20,6 +20,14 @@ Human-readable error description. *** +### qoder\_error\_code? + +> `optional` **qoder\_error\_code?**: `string` + +Diagnostic only; use retry_status to determine retry behavior. + +*** + ### retry\_status > **retry\_status**: [`ManagedAgentsBillingErrorRetryStatusUnion`](../type-aliases/ManagedAgentsBillingErrorRetryStatusUnion.md) diff --git a/docs/api/managed/interfaces/ManagedAgentsCredentialHostUnreachableError.md b/docs/api/managed/interfaces/ManagedAgentsCredentialHostUnreachableError.md index b7e9f6e..d0fdcf1 100644 --- a/docs/api/managed/interfaces/ManagedAgentsCredentialHostUnreachableError.md +++ b/docs/api/managed/interfaces/ManagedAgentsCredentialHostUnreachableError.md @@ -27,6 +27,14 @@ Human-readable error description. *** +### qoder\_error\_code? + +> `optional` **qoder\_error\_code?**: `string` + +Diagnostic only; use retry_status to determine retry behavior. + +*** + ### retry\_status > **retry\_status**: [`ManagedAgentsCredentialHostUnreachableErrorRetryStatusUnion`](../type-aliases/ManagedAgentsCredentialHostUnreachableErrorRetryStatusUnion.md) diff --git a/docs/api/managed/interfaces/ManagedAgentsGitHubRepositoryResourceParams.md b/docs/api/managed/interfaces/ManagedAgentsGitHubRepositoryResourceParams.md index 7b49ddc..1f5b83f 100644 --- a/docs/api/managed/interfaces/ManagedAgentsGitHubRepositoryResourceParams.md +++ b/docs/api/managed/interfaces/ManagedAgentsGitHubRepositoryResourceParams.md @@ -10,9 +10,9 @@ Mount a GitHub repository into the session's container. ## Properties -### authorization\_token +### authorization\_token? -> **authorization\_token**: `string` +> `optional` **authorization\_token?**: `string` GitHub authorization token used to clone the repository. diff --git a/docs/api/managed/interfaces/ManagedAgentsGitRepositoryResource.md b/docs/api/managed/interfaces/ManagedAgentsGitRepositoryResource.md new file mode 100644 index 0000000..b66db79 --- /dev/null +++ b/docs/api/managed/interfaces/ManagedAgentsGitRepositoryResource.md @@ -0,0 +1,55 @@ +[**qca-sdk**](../../README.md) + +*** + +[qca-sdk](../../README.md) / [managed](../README.md) / ManagedAgentsGitRepositoryResource + +# Interface: ManagedAgentsGitRepositoryResource + +## Properties + +### checkout? + +> `optional` **checkout?**: [`ManagedAgentsGitHubRepositoryResourceCheckoutUnion`](../type-aliases/ManagedAgentsGitHubRepositoryResourceCheckoutUnion.md) \| `null` + +*** + +### created\_at + +> **created\_at**: `string` + +A timestamp in RFC 3339 format + +*** + +### id + +> **id**: `string` + +*** + +### mount\_path + +> **mount\_path**: `string` + +*** + +### type + +> **type**: `"git_repository"` + +Any of "git_repository". + +*** + +### updated\_at + +> **updated\_at**: `string` + +A timestamp in RFC 3339 format + +*** + +### url + +> **url**: `string` diff --git a/docs/api/managed/interfaces/ManagedAgentsGitRepositoryResourceConfig.md b/docs/api/managed/interfaces/ManagedAgentsGitRepositoryResourceConfig.md new file mode 100644 index 0000000..5f9f9e8 --- /dev/null +++ b/docs/api/managed/interfaces/ManagedAgentsGitRepositoryResourceConfig.md @@ -0,0 +1,39 @@ +[**qca-sdk**](../../README.md) + +*** + +[qca-sdk](../../README.md) / [managed](../README.md) / ManagedAgentsGitRepositoryResourceConfig + +# Interface: ManagedAgentsGitRepositoryResourceConfig + +## Properties + +### checkout? + +> `optional` **checkout?**: [`ManagedAgentsGitHubRepositoryResourceConfigCheckoutUnion`](../type-aliases/ManagedAgentsGitHubRepositoryResourceConfigCheckoutUnion.md) \| `null` + +Branch or commit to check out. Defaults to the repository's default branch. + +*** + +### mount\_path? + +> `optional` **mount\_path?**: `string` \| `null` + +Mount path in the container. Derived from the repository name when omitted. + +*** + +### type + +> **type**: `"git_repository"` + +Any of "git_repository". + +*** + +### url + +> **url**: `string` + +HTTP(S) Git URL of the repository diff --git a/docs/api/managed/interfaces/ManagedAgentsGitRepositoryResourceParams.md b/docs/api/managed/interfaces/ManagedAgentsGitRepositoryResourceParams.md new file mode 100644 index 0000000..02862e6 --- /dev/null +++ b/docs/api/managed/interfaces/ManagedAgentsGitRepositoryResourceParams.md @@ -0,0 +1,47 @@ +[**qca-sdk**](../../README.md) + +*** + +[qca-sdk](../../README.md) / [managed](../README.md) / ManagedAgentsGitRepositoryResourceParams + +# Interface: ManagedAgentsGitRepositoryResourceParams + +## Properties + +### checkout? + +> `optional` **checkout?**: [`ManagedAgentsGitHubRepositoryResourceParamsCheckoutUnion`](../type-aliases/ManagedAgentsGitHubRepositoryResourceParamsCheckoutUnion.md) \| `null` + +Branch or commit to check out. Defaults to the repository's default branch. + +*** + +### mount\_path? + +> `optional` **mount\_path?**: `string` \| `null` + +Mount path in the container. Derived from the repository name when omitted. + +*** + +### password? + +> `optional` **password?**: `string` + +Password or access token; include the username in the repository URL. + +*** + +### type + +> **type**: `"git_repository"` + +Any of "git_repository". + +*** + +### url + +> **url**: `string` + +HTTP(S) Git URL of the repository diff --git a/docs/api/managed/interfaces/ManagedAgentsMCPAuthenticationFailedError.md b/docs/api/managed/interfaces/ManagedAgentsMCPAuthenticationFailedError.md index 8dae40d..40bf605 100644 --- a/docs/api/managed/interfaces/ManagedAgentsMCPAuthenticationFailedError.md +++ b/docs/api/managed/interfaces/ManagedAgentsMCPAuthenticationFailedError.md @@ -26,6 +26,14 @@ Human-readable error description. *** +### qoder\_error\_code? + +> `optional` **qoder\_error\_code?**: `string` + +Diagnostic only; use retry_status to determine retry behavior. + +*** + ### retry\_status > **retry\_status**: [`ManagedAgentsMCPAuthenticationFailedErrorRetryStatusUnion`](../type-aliases/ManagedAgentsMCPAuthenticationFailedErrorRetryStatusUnion.md) diff --git a/docs/api/managed/interfaces/ManagedAgentsMCPConnectionFailedError.md b/docs/api/managed/interfaces/ManagedAgentsMCPConnectionFailedError.md index 470e168..465e6fc 100644 --- a/docs/api/managed/interfaces/ManagedAgentsMCPConnectionFailedError.md +++ b/docs/api/managed/interfaces/ManagedAgentsMCPConnectionFailedError.md @@ -26,6 +26,14 @@ Human-readable error description. *** +### qoder\_error\_code? + +> `optional` **qoder\_error\_code?**: `string` + +Diagnostic only; use retry_status to determine retry behavior. + +*** + ### retry\_status > **retry\_status**: [`ManagedAgentsMCPConnectionFailedErrorRetryStatusUnion`](../type-aliases/ManagedAgentsMCPConnectionFailedErrorRetryStatusUnion.md) diff --git a/docs/api/managed/interfaces/ManagedAgentsMemoryStore.md b/docs/api/managed/interfaces/ManagedAgentsMemoryStore.md index 246de10..2620bf5 100644 --- a/docs/api/managed/interfaces/ManagedAgentsMemoryStore.md +++ b/docs/api/managed/interfaces/ManagedAgentsMemoryStore.md @@ -38,6 +38,12 @@ be useful to the agent. Empty string when unset. *** +### entry\_count? + +> `optional` **entry\_count?**: `number` + +*** + ### id > **id**: `string` @@ -67,6 +73,18 @@ under `/mnt/memory/` is derived from this name. *** +### status? + +> `optional` **status?**: `string` + +*** + +### total\_size? + +> `optional` **total\_size?**: `number` + +*** + ### type > **type**: `"memory_store"` diff --git a/docs/api/managed/interfaces/ManagedAgentsModelOverloadedError.md b/docs/api/managed/interfaces/ManagedAgentsModelOverloadedError.md index 6763418..aa9ed48 100644 --- a/docs/api/managed/interfaces/ManagedAgentsModelOverloadedError.md +++ b/docs/api/managed/interfaces/ManagedAgentsModelOverloadedError.md @@ -19,6 +19,14 @@ Human-readable error description. *** +### qoder\_error\_code? + +> `optional` **qoder\_error\_code?**: `string` + +Diagnostic only; use retry_status to determine retry behavior. + +*** + ### retry\_status > **retry\_status**: [`ManagedAgentsModelOverloadedErrorRetryStatusUnion`](../type-aliases/ManagedAgentsModelOverloadedErrorRetryStatusUnion.md) diff --git a/docs/api/managed/interfaces/ManagedAgentsModelRateLimitedError.md b/docs/api/managed/interfaces/ManagedAgentsModelRateLimitedError.md index bd42315..daf519a 100644 --- a/docs/api/managed/interfaces/ManagedAgentsModelRateLimitedError.md +++ b/docs/api/managed/interfaces/ManagedAgentsModelRateLimitedError.md @@ -18,6 +18,14 @@ Human-readable error description. *** +### qoder\_error\_code? + +> `optional` **qoder\_error\_code?**: `string` + +Diagnostic only; use retry_status to determine retry behavior. + +*** + ### retry\_status > **retry\_status**: [`ManagedAgentsModelRateLimitedErrorRetryStatusUnion`](../type-aliases/ManagedAgentsModelRateLimitedErrorRetryStatusUnion.md) diff --git a/docs/api/managed/interfaces/ManagedAgentsModelRequestFailedError.md b/docs/api/managed/interfaces/ManagedAgentsModelRequestFailedError.md index 6f7cfd1..9b8ee6f 100644 --- a/docs/api/managed/interfaces/ManagedAgentsModelRequestFailedError.md +++ b/docs/api/managed/interfaces/ManagedAgentsModelRequestFailedError.md @@ -18,6 +18,14 @@ Human-readable error description. *** +### qoder\_error\_code? + +> `optional` **qoder\_error\_code?**: `string` + +Diagnostic only; use retry_status to determine retry behavior. + +*** + ### retry\_status > **retry\_status**: [`ManagedAgentsModelRequestFailedErrorRetryStatusUnion`](../type-aliases/ManagedAgentsModelRequestFailedErrorRetryStatusUnion.md) diff --git a/docs/api/managed/interfaces/ManagedAgentsSessionThread.md b/docs/api/managed/interfaces/ManagedAgentsSessionThread.md index 0f0b470..7636f69 100644 --- a/docs/api/managed/interfaces/ManagedAgentsSessionThread.md +++ b/docs/api/managed/interfaces/ManagedAgentsSessionThread.md @@ -94,8 +94,10 @@ A timestamp in RFC 3339 format *** -### usage +### ~~usage?~~ -> **usage**: [`ManagedAgentsSessionThreadUsage`](ManagedAgentsSessionThreadUsage.md) +> `optional` **usage?**: [`ManagedAgentsSessionThreadUsage`](ManagedAgentsSessionThreadUsage.md) -Cumulative token usage for a session thread across all turns. +#### Deprecated + +Legacy usage; current Managed Thread responses omit this field. diff --git a/docs/api/managed/interfaces/ManagedAgentsUnknownError.md b/docs/api/managed/interfaces/ManagedAgentsUnknownError.md index 43aa4c7..362c736 100644 --- a/docs/api/managed/interfaces/ManagedAgentsUnknownError.md +++ b/docs/api/managed/interfaces/ManagedAgentsUnknownError.md @@ -20,6 +20,14 @@ Human-readable error description. *** +### qoder\_error\_code? + +> `optional` **qoder\_error\_code?**: `string` + +Diagnostic only; use retry_status to determine retry behavior. + +*** + ### retry\_status > **retry\_status**: [`ManagedAgentsUnknownErrorRetryStatusUnion`](../type-aliases/ManagedAgentsUnknownErrorRetryStatusUnion.md) diff --git a/docs/api/managed/interfaces/SelfHostedConfig.md b/docs/api/managed/interfaces/SelfHostedConfig.md index 2bef9e3..f3e3b98 100644 --- a/docs/api/managed/interfaces/SelfHostedConfig.md +++ b/docs/api/managed/interfaces/SelfHostedConfig.md @@ -10,6 +10,12 @@ Configuration for self-hosted environments. ## Properties +### setup\_script? + +> `optional` **setup\_script?**: `string` + +*** + ### type? > `optional` **type?**: `"self_hosted"` diff --git a/docs/api/managed/interfaces/SelfHostedConfigParams.md b/docs/api/managed/interfaces/SelfHostedConfigParams.md index 5c39bbd..be571d0 100644 --- a/docs/api/managed/interfaces/SelfHostedConfigParams.md +++ b/docs/api/managed/interfaces/SelfHostedConfigParams.md @@ -13,6 +13,12 @@ This struct has a constant value, construct it with ## Properties +### setup\_script? + +> `optional` **setup\_script?**: `string` + +*** + ### type? > `optional` **type?**: `"self_hosted"` \| `null` diff --git a/docs/api/managed/interfaces/SessionResourceUpdateParams.md b/docs/api/managed/interfaces/SessionResourceUpdateParams.md index 0830a6c..5c292a1 100644 --- a/docs/api/managed/interfaces/SessionResourceUpdateParams.md +++ b/docs/api/managed/interfaces/SessionResourceUpdateParams.md @@ -12,8 +12,8 @@ > `optional` **authorization\_token?**: `string` \| `null` -New authorization token for the resource. Currently only `github_repository` -resources support token rotation. +GitHub access token; also accepted for legacy generic Git clients. +For generic Git, prefer password and do not send conflicting credentials. *** diff --git a/docs/api/managed/interfaces/Skill.md b/docs/api/managed/interfaces/Skill.md index 0f1e2d6..e3205d3 100644 --- a/docs/api/managed/interfaces/Skill.md +++ b/docs/api/managed/interfaces/Skill.md @@ -38,7 +38,7 @@ The format and length of IDs may change over time. ### latest\_version -> **latest\_version**: `string` +> **latest\_version**: `string` \| `null` ID of the newest Skill Version — what `latest` references resolve to. Always set: a Skill holds at least one version. diff --git a/docs/api/managed/type-aliases/DeploymentNewParamsResourceUnion.md b/docs/api/managed/type-aliases/DeploymentNewParamsResourceUnion.md index 19485d3..00a8ac0 100644 --- a/docs/api/managed/type-aliases/DeploymentNewParamsResourceUnion.md +++ b/docs/api/managed/type-aliases/DeploymentNewParamsResourceUnion.md @@ -6,4 +6,4 @@ # Type Alias: DeploymentNewParamsResourceUnion -> **DeploymentNewParamsResourceUnion** = [`ManagedAgentsGitHubRepositoryResourceParams`](../interfaces/ManagedAgentsGitHubRepositoryResourceParams.md) \| [`ManagedAgentsFileResourceParams`](../interfaces/ManagedAgentsFileResourceParams.md) \| [`ManagedAgentsMemoryStoreResourceParam`](../interfaces/ManagedAgentsMemoryStoreResourceParam.md) +> **DeploymentNewParamsResourceUnion** = [`ManagedAgentsGitRepositoryResourceParams`](../interfaces/ManagedAgentsGitRepositoryResourceParams.md) \| [`ManagedAgentsGitHubRepositoryResourceParams`](../interfaces/ManagedAgentsGitHubRepositoryResourceParams.md) \| [`ManagedAgentsFileResourceParams`](../interfaces/ManagedAgentsFileResourceParams.md) \| [`ManagedAgentsMemoryStoreResourceParam`](../interfaces/ManagedAgentsMemoryStoreResourceParam.md) diff --git a/docs/api/managed/type-aliases/DeploymentUpdateParamsResourceUnion.md b/docs/api/managed/type-aliases/DeploymentUpdateParamsResourceUnion.md index 9e5b4f2..eacfa67 100644 --- a/docs/api/managed/type-aliases/DeploymentUpdateParamsResourceUnion.md +++ b/docs/api/managed/type-aliases/DeploymentUpdateParamsResourceUnion.md @@ -6,4 +6,4 @@ # Type Alias: DeploymentUpdateParamsResourceUnion -> **DeploymentUpdateParamsResourceUnion** = [`ManagedAgentsGitHubRepositoryResourceParams`](../interfaces/ManagedAgentsGitHubRepositoryResourceParams.md) \| [`ManagedAgentsFileResourceParams`](../interfaces/ManagedAgentsFileResourceParams.md) \| [`ManagedAgentsMemoryStoreResourceParam`](../interfaces/ManagedAgentsMemoryStoreResourceParam.md) +> **DeploymentUpdateParamsResourceUnion** = [`ManagedAgentsGitRepositoryResourceParams`](../interfaces/ManagedAgentsGitRepositoryResourceParams.md) \| [`ManagedAgentsGitHubRepositoryResourceParams`](../interfaces/ManagedAgentsGitHubRepositoryResourceParams.md) \| [`ManagedAgentsFileResourceParams`](../interfaces/ManagedAgentsFileResourceParams.md) \| [`ManagedAgentsMemoryStoreResourceParam`](../interfaces/ManagedAgentsMemoryStoreResourceParam.md) diff --git a/docs/api/managed/type-aliases/ManagedAgentsGitRepositoryResourceCheckoutUnion.md b/docs/api/managed/type-aliases/ManagedAgentsGitRepositoryResourceCheckoutUnion.md new file mode 100644 index 0000000..e588460 --- /dev/null +++ b/docs/api/managed/type-aliases/ManagedAgentsGitRepositoryResourceCheckoutUnion.md @@ -0,0 +1,9 @@ +[**qca-sdk**](../../README.md) + +*** + +[qca-sdk](../../README.md) / [managed](../README.md) / ManagedAgentsGitRepositoryResourceCheckoutUnion + +# Type Alias: ManagedAgentsGitRepositoryResourceCheckoutUnion + +> **ManagedAgentsGitRepositoryResourceCheckoutUnion** = [`ManagedAgentsGitHubRepositoryResourceCheckoutUnion`](ManagedAgentsGitHubRepositoryResourceCheckoutUnion.md) diff --git a/docs/api/managed/type-aliases/ManagedAgentsGitRepositoryResourceConfigCheckoutUnion.md b/docs/api/managed/type-aliases/ManagedAgentsGitRepositoryResourceConfigCheckoutUnion.md new file mode 100644 index 0000000..93790a4 --- /dev/null +++ b/docs/api/managed/type-aliases/ManagedAgentsGitRepositoryResourceConfigCheckoutUnion.md @@ -0,0 +1,9 @@ +[**qca-sdk**](../../README.md) + +*** + +[qca-sdk](../../README.md) / [managed](../README.md) / ManagedAgentsGitRepositoryResourceConfigCheckoutUnion + +# Type Alias: ManagedAgentsGitRepositoryResourceConfigCheckoutUnion + +> **ManagedAgentsGitRepositoryResourceConfigCheckoutUnion** = [`ManagedAgentsGitHubRepositoryResourceConfigCheckoutUnion`](ManagedAgentsGitHubRepositoryResourceConfigCheckoutUnion.md) diff --git a/docs/api/managed/type-aliases/ManagedAgentsGitRepositoryResourceConfigType.md b/docs/api/managed/type-aliases/ManagedAgentsGitRepositoryResourceConfigType.md new file mode 100644 index 0000000..7524a31 --- /dev/null +++ b/docs/api/managed/type-aliases/ManagedAgentsGitRepositoryResourceConfigType.md @@ -0,0 +1,9 @@ +[**qca-sdk**](../../README.md) + +*** + +[qca-sdk](../../README.md) / [managed](../README.md) / ManagedAgentsGitRepositoryResourceConfigType + +# Type Alias: ManagedAgentsGitRepositoryResourceConfigType + +> **ManagedAgentsGitRepositoryResourceConfigType** = `"git_repository"` diff --git a/docs/api/managed/type-aliases/ManagedAgentsGitRepositoryResourceParamsCheckoutUnion.md b/docs/api/managed/type-aliases/ManagedAgentsGitRepositoryResourceParamsCheckoutUnion.md new file mode 100644 index 0000000..971465a --- /dev/null +++ b/docs/api/managed/type-aliases/ManagedAgentsGitRepositoryResourceParamsCheckoutUnion.md @@ -0,0 +1,9 @@ +[**qca-sdk**](../../README.md) + +*** + +[qca-sdk](../../README.md) / [managed](../README.md) / ManagedAgentsGitRepositoryResourceParamsCheckoutUnion + +# Type Alias: ManagedAgentsGitRepositoryResourceParamsCheckoutUnion + +> **ManagedAgentsGitRepositoryResourceParamsCheckoutUnion** = [`ManagedAgentsGitHubRepositoryResourceParamsCheckoutUnion`](ManagedAgentsGitHubRepositoryResourceParamsCheckoutUnion.md) diff --git a/docs/api/managed/type-aliases/ManagedAgentsGitRepositoryResourceParamsType.md b/docs/api/managed/type-aliases/ManagedAgentsGitRepositoryResourceParamsType.md new file mode 100644 index 0000000..24a7e40 --- /dev/null +++ b/docs/api/managed/type-aliases/ManagedAgentsGitRepositoryResourceParamsType.md @@ -0,0 +1,9 @@ +[**qca-sdk**](../../README.md) + +*** + +[qca-sdk](../../README.md) / [managed](../README.md) / ManagedAgentsGitRepositoryResourceParamsType + +# Type Alias: ManagedAgentsGitRepositoryResourceParamsType + +> **ManagedAgentsGitRepositoryResourceParamsType** = `"git_repository"` diff --git a/docs/api/managed/type-aliases/ManagedAgentsGitRepositoryResourceType.md b/docs/api/managed/type-aliases/ManagedAgentsGitRepositoryResourceType.md new file mode 100644 index 0000000..1af6be8 --- /dev/null +++ b/docs/api/managed/type-aliases/ManagedAgentsGitRepositoryResourceType.md @@ -0,0 +1,9 @@ +[**qca-sdk**](../../README.md) + +*** + +[qca-sdk](../../README.md) / [managed](../README.md) / ManagedAgentsGitRepositoryResourceType + +# Type Alias: ManagedAgentsGitRepositoryResourceType + +> **ManagedAgentsGitRepositoryResourceType** = `"git_repository"` diff --git a/docs/api/managed/type-aliases/ManagedAgentsSessionEventUnion.md b/docs/api/managed/type-aliases/ManagedAgentsSessionEventUnion.md index 600a212..98d0372 100644 --- a/docs/api/managed/type-aliases/ManagedAgentsSessionEventUnion.md +++ b/docs/api/managed/type-aliases/ManagedAgentsSessionEventUnion.md @@ -6,4 +6,4 @@ # Type Alias: ManagedAgentsSessionEventUnion -> **ManagedAgentsSessionEventUnion** = [`ManagedAgentsUserMessageEvent`](../interfaces/ManagedAgentsUserMessageEvent.md) \| [`ManagedAgentsUserInterruptEvent`](../interfaces/ManagedAgentsUserInterruptEvent.md) \| [`ManagedAgentsUserToolConfirmationEvent`](../interfaces/ManagedAgentsUserToolConfirmationEvent.md) \| [`ManagedAgentsUserCustomToolResultEvent`](../interfaces/ManagedAgentsUserCustomToolResultEvent.md) \| [`ManagedAgentsAgentCustomToolUseEvent`](../interfaces/ManagedAgentsAgentCustomToolUseEvent.md) \| [`ManagedAgentsAgentMessageEvent`](../interfaces/ManagedAgentsAgentMessageEvent.md) \| [`ManagedAgentsAgentThinkingEvent`](../interfaces/ManagedAgentsAgentThinkingEvent.md) \| [`ManagedAgentsAgentMCPToolUseEvent`](../interfaces/ManagedAgentsAgentMCPToolUseEvent.md) \| [`ManagedAgentsAgentMCPToolResultEvent`](../interfaces/ManagedAgentsAgentMCPToolResultEvent.md) \| [`ManagedAgentsAgentToolUseEvent`](../interfaces/ManagedAgentsAgentToolUseEvent.md) \| [`ManagedAgentsAgentToolResultEvent`](../interfaces/ManagedAgentsAgentToolResultEvent.md) \| [`ManagedAgentsAgentThreadMessageReceivedEvent`](../interfaces/ManagedAgentsAgentThreadMessageReceivedEvent.md) \| [`ManagedAgentsAgentThreadMessageSentEvent`](../interfaces/ManagedAgentsAgentThreadMessageSentEvent.md) \| [`ManagedAgentsAgentThreadContextCompactedEvent`](../interfaces/ManagedAgentsAgentThreadContextCompactedEvent.md) \| [`ManagedAgentsSessionErrorEvent`](../interfaces/ManagedAgentsSessionErrorEvent.md) \| [`ManagedAgentsSessionStatusRescheduledEvent`](../interfaces/ManagedAgentsSessionStatusRescheduledEvent.md) \| [`ManagedAgentsSessionStatusRunningEvent`](../interfaces/ManagedAgentsSessionStatusRunningEvent.md) \| [`ManagedAgentsSessionStatusIdleEvent`](../interfaces/ManagedAgentsSessionStatusIdleEvent.md) \| [`ManagedAgentsSessionStatusTerminatedEvent`](../interfaces/ManagedAgentsSessionStatusTerminatedEvent.md) \| [`ManagedAgentsSessionThreadCreatedEvent`](../interfaces/ManagedAgentsSessionThreadCreatedEvent.md) \| [`ManagedAgentsSpanOutcomeEvaluationStartEvent`](../interfaces/ManagedAgentsSpanOutcomeEvaluationStartEvent.md) \| [`ManagedAgentsSpanOutcomeEvaluationEndEvent`](../interfaces/ManagedAgentsSpanOutcomeEvaluationEndEvent.md) \| [`ManagedAgentsSpanModelRequestStartEvent`](../interfaces/ManagedAgentsSpanModelRequestStartEvent.md) \| [`ManagedAgentsSpanModelRequestEndEvent`](../interfaces/ManagedAgentsSpanModelRequestEndEvent.md) \| [`ManagedAgentsSpanOutcomeEvaluationOngoingEvent`](../interfaces/ManagedAgentsSpanOutcomeEvaluationOngoingEvent.md) \| [`ManagedAgentsUserDefineOutcomeEvent`](../interfaces/ManagedAgentsUserDefineOutcomeEvent.md) \| [`ManagedAgentsSessionDeletedEvent`](../interfaces/ManagedAgentsSessionDeletedEvent.md) \| [`ManagedAgentsSessionThreadStatusRunningEvent`](../interfaces/ManagedAgentsSessionThreadStatusRunningEvent.md) \| [`ManagedAgentsSessionThreadStatusIdleEvent`](../interfaces/ManagedAgentsSessionThreadStatusIdleEvent.md) \| [`ManagedAgentsSessionThreadStatusTerminatedEvent`](../interfaces/ManagedAgentsSessionThreadStatusTerminatedEvent.md) \| [`ManagedAgentsUserToolResultEvent`](../interfaces/ManagedAgentsUserToolResultEvent.md) \| [`ManagedAgentsSessionThreadStatusRescheduledEvent`](../interfaces/ManagedAgentsSessionThreadStatusRescheduledEvent.md) \| [`ManagedAgentsSessionUpdatedEvent`](../interfaces/ManagedAgentsSessionUpdatedEvent.md) \| [`ManagedAgentsSystemMessageEvent`](../interfaces/ManagedAgentsSystemMessageEvent.md) \| [`ManagedAgentsSessionUsageEvent`](../interfaces/ManagedAgentsSessionUsageEvent.md) +> **ManagedAgentsSessionEventUnion** = [`ManagedAgentsUserMessageEvent`](../interfaces/ManagedAgentsUserMessageEvent.md) \| [`ManagedAgentsUserInterruptEvent`](../interfaces/ManagedAgentsUserInterruptEvent.md) \| [`ManagedAgentsUserToolConfirmationEvent`](../interfaces/ManagedAgentsUserToolConfirmationEvent.md) \| [`ManagedAgentsUserCustomToolResultEvent`](../interfaces/ManagedAgentsUserCustomToolResultEvent.md) \| [`ManagedAgentsAgentCustomToolUseEvent`](../interfaces/ManagedAgentsAgentCustomToolUseEvent.md) \| [`ManagedAgentsAgentMessageEvent`](../interfaces/ManagedAgentsAgentMessageEvent.md) \| [`ManagedAgentsAgentThinkingEvent`](../interfaces/ManagedAgentsAgentThinkingEvent.md) \| [`ManagedAgentsAgentMCPToolUseEvent`](../interfaces/ManagedAgentsAgentMCPToolUseEvent.md) \| [`ManagedAgentsAgentMCPToolResultEvent`](../interfaces/ManagedAgentsAgentMCPToolResultEvent.md) \| [`ManagedAgentsAgentToolUseEvent`](../interfaces/ManagedAgentsAgentToolUseEvent.md) \| [`ManagedAgentsAgentToolResultEvent`](../interfaces/ManagedAgentsAgentToolResultEvent.md) \| [`ManagedAgentsAgentThreadMessageReceivedEvent`](../interfaces/ManagedAgentsAgentThreadMessageReceivedEvent.md) \| [`ManagedAgentsAgentThreadMessageSentEvent`](../interfaces/ManagedAgentsAgentThreadMessageSentEvent.md) \| [`ManagedAgentsAgentThreadContextCompactedEvent`](../interfaces/ManagedAgentsAgentThreadContextCompactedEvent.md) \| [`ManagedAgentsSessionErrorEvent`](../interfaces/ManagedAgentsSessionErrorEvent.md) \| [`ManagedAgentsSessionStatusRescheduledEvent`](../interfaces/ManagedAgentsSessionStatusRescheduledEvent.md) \| [`ManagedAgentsSessionStatusRunningEvent`](../interfaces/ManagedAgentsSessionStatusRunningEvent.md) \| [`ManagedAgentsSessionStatusIdleEvent`](../interfaces/ManagedAgentsSessionStatusIdleEvent.md) \| [`ManagedAgentsSessionStatusTerminatedEvent`](../interfaces/ManagedAgentsSessionStatusTerminatedEvent.md) \| [`ManagedAgentsSessionThreadCreatedEvent`](../interfaces/ManagedAgentsSessionThreadCreatedEvent.md) \| [`ManagedAgentsSpanOutcomeEvaluationStartEvent`](../interfaces/ManagedAgentsSpanOutcomeEvaluationStartEvent.md) \| [`ManagedAgentsSpanOutcomeEvaluationEndEvent`](../interfaces/ManagedAgentsSpanOutcomeEvaluationEndEvent.md) \| [`ManagedAgentsSpanModelRequestStartEvent`](../interfaces/ManagedAgentsSpanModelRequestStartEvent.md) \| [`ManagedAgentsSpanModelRequestEndEvent`](../interfaces/ManagedAgentsSpanModelRequestEndEvent.md) \| [`ManagedAgentsSpanOutcomeEvaluationOngoingEvent`](../interfaces/ManagedAgentsSpanOutcomeEvaluationOngoingEvent.md) \| [`ManagedAgentsUserDefineOutcomeEvent`](../interfaces/ManagedAgentsUserDefineOutcomeEvent.md) \| [`ManagedAgentsSessionDeletedEvent`](../interfaces/ManagedAgentsSessionDeletedEvent.md) \| [`ManagedAgentsSessionThreadStatusRunningEvent`](../interfaces/ManagedAgentsSessionThreadStatusRunningEvent.md) \| [`ManagedAgentsSessionThreadStatusIdleEvent`](../interfaces/ManagedAgentsSessionThreadStatusIdleEvent.md) \| [`ManagedAgentsSessionThreadStatusTerminatedEvent`](../interfaces/ManagedAgentsSessionThreadStatusTerminatedEvent.md) \| [`ManagedAgentsUserToolResultEvent`](../interfaces/ManagedAgentsUserToolResultEvent.md) \| [`ManagedAgentsSessionThreadStatusRescheduledEvent`](../interfaces/ManagedAgentsSessionThreadStatusRescheduledEvent.md) \| [`ManagedAgentsSessionUpdatedEvent`](../interfaces/ManagedAgentsSessionUpdatedEvent.md) \| [`ManagedAgentsSystemMessageEvent`](../interfaces/ManagedAgentsSystemMessageEvent.md) \| [`ManagedAgentsSessionUsageEvent`](../interfaces/ManagedAgentsSessionUsageEvent.md) \| [`ManagedAgentsAgentArtifactDeliveredEvent`](../interfaces/ManagedAgentsAgentArtifactDeliveredEvent.md) diff --git a/docs/api/managed/type-aliases/ManagedAgentsSessionResourceConfigUnion.md b/docs/api/managed/type-aliases/ManagedAgentsSessionResourceConfigUnion.md index 1f61341..34ffb5e 100644 --- a/docs/api/managed/type-aliases/ManagedAgentsSessionResourceConfigUnion.md +++ b/docs/api/managed/type-aliases/ManagedAgentsSessionResourceConfigUnion.md @@ -6,4 +6,4 @@ # Type Alias: ManagedAgentsSessionResourceConfigUnion -> **ManagedAgentsSessionResourceConfigUnion** = [`ManagedAgentsGitHubRepositoryResourceConfig`](../interfaces/ManagedAgentsGitHubRepositoryResourceConfig.md) \| [`ManagedAgentsFileResourceConfig`](../interfaces/ManagedAgentsFileResourceConfig.md) \| [`ManagedAgentsMemoryStoreResourceConfig`](../interfaces/ManagedAgentsMemoryStoreResourceConfig.md) +> **ManagedAgentsSessionResourceConfigUnion** = [`ManagedAgentsGitRepositoryResourceConfig`](../interfaces/ManagedAgentsGitRepositoryResourceConfig.md) \| [`ManagedAgentsGitHubRepositoryResourceConfig`](../interfaces/ManagedAgentsGitHubRepositoryResourceConfig.md) \| [`ManagedAgentsFileResourceConfig`](../interfaces/ManagedAgentsFileResourceConfig.md) \| [`ManagedAgentsMemoryStoreResourceConfig`](../interfaces/ManagedAgentsMemoryStoreResourceConfig.md) diff --git a/docs/api/managed/type-aliases/ManagedAgentsSessionResourceUnion.md b/docs/api/managed/type-aliases/ManagedAgentsSessionResourceUnion.md index bf46e17..f6a4181 100644 --- a/docs/api/managed/type-aliases/ManagedAgentsSessionResourceUnion.md +++ b/docs/api/managed/type-aliases/ManagedAgentsSessionResourceUnion.md @@ -6,4 +6,4 @@ # Type Alias: ManagedAgentsSessionResourceUnion -> **ManagedAgentsSessionResourceUnion** = [`ManagedAgentsGitHubRepositoryResource`](../interfaces/ManagedAgentsGitHubRepositoryResource.md) \| [`ManagedAgentsFileResource`](../interfaces/ManagedAgentsFileResource.md) \| [`ManagedAgentsMemoryStoreResource`](../interfaces/ManagedAgentsMemoryStoreResource.md) +> **ManagedAgentsSessionResourceUnion** = [`ManagedAgentsGitRepositoryResource`](../interfaces/ManagedAgentsGitRepositoryResource.md) \| [`ManagedAgentsGitHubRepositoryResource`](../interfaces/ManagedAgentsGitHubRepositoryResource.md) \| [`ManagedAgentsFileResource`](../interfaces/ManagedAgentsFileResource.md) \| [`ManagedAgentsMemoryStoreResource`](../interfaces/ManagedAgentsMemoryStoreResource.md) diff --git a/docs/api/managed/type-aliases/ManagedAgentsStreamSessionEventsUnion.md b/docs/api/managed/type-aliases/ManagedAgentsStreamSessionEventsUnion.md index 65e9e7f..e341d69 100644 --- a/docs/api/managed/type-aliases/ManagedAgentsStreamSessionEventsUnion.md +++ b/docs/api/managed/type-aliases/ManagedAgentsStreamSessionEventsUnion.md @@ -6,4 +6,4 @@ # Type Alias: ManagedAgentsStreamSessionEventsUnion -> **ManagedAgentsStreamSessionEventsUnion** = [`ManagedAgentsUserMessageEvent`](../interfaces/ManagedAgentsUserMessageEvent.md) \| [`ManagedAgentsUserInterruptEvent`](../interfaces/ManagedAgentsUserInterruptEvent.md) \| [`ManagedAgentsUserToolConfirmationEvent`](../interfaces/ManagedAgentsUserToolConfirmationEvent.md) \| [`ManagedAgentsUserCustomToolResultEvent`](../interfaces/ManagedAgentsUserCustomToolResultEvent.md) \| [`ManagedAgentsAgentCustomToolUseEvent`](../interfaces/ManagedAgentsAgentCustomToolUseEvent.md) \| [`ManagedAgentsAgentMessageEvent`](../interfaces/ManagedAgentsAgentMessageEvent.md) \| [`ManagedAgentsAgentThinkingEvent`](../interfaces/ManagedAgentsAgentThinkingEvent.md) \| [`ManagedAgentsAgentMCPToolUseEvent`](../interfaces/ManagedAgentsAgentMCPToolUseEvent.md) \| [`ManagedAgentsAgentMCPToolResultEvent`](../interfaces/ManagedAgentsAgentMCPToolResultEvent.md) \| [`ManagedAgentsAgentToolUseEvent`](../interfaces/ManagedAgentsAgentToolUseEvent.md) \| [`ManagedAgentsAgentToolResultEvent`](../interfaces/ManagedAgentsAgentToolResultEvent.md) \| [`ManagedAgentsAgentThreadMessageReceivedEvent`](../interfaces/ManagedAgentsAgentThreadMessageReceivedEvent.md) \| [`ManagedAgentsAgentThreadMessageSentEvent`](../interfaces/ManagedAgentsAgentThreadMessageSentEvent.md) \| [`ManagedAgentsAgentThreadContextCompactedEvent`](../interfaces/ManagedAgentsAgentThreadContextCompactedEvent.md) \| [`ManagedAgentsSessionErrorEvent`](../interfaces/ManagedAgentsSessionErrorEvent.md) \| [`ManagedAgentsSessionStatusRescheduledEvent`](../interfaces/ManagedAgentsSessionStatusRescheduledEvent.md) \| [`ManagedAgentsSessionStatusRunningEvent`](../interfaces/ManagedAgentsSessionStatusRunningEvent.md) \| [`ManagedAgentsSessionStatusIdleEvent`](../interfaces/ManagedAgentsSessionStatusIdleEvent.md) \| [`ManagedAgentsSessionStatusTerminatedEvent`](../interfaces/ManagedAgentsSessionStatusTerminatedEvent.md) \| [`ManagedAgentsSessionThreadCreatedEvent`](../interfaces/ManagedAgentsSessionThreadCreatedEvent.md) \| [`ManagedAgentsSpanOutcomeEvaluationStartEvent`](../interfaces/ManagedAgentsSpanOutcomeEvaluationStartEvent.md) \| [`ManagedAgentsSpanOutcomeEvaluationEndEvent`](../interfaces/ManagedAgentsSpanOutcomeEvaluationEndEvent.md) \| [`ManagedAgentsSpanModelRequestStartEvent`](../interfaces/ManagedAgentsSpanModelRequestStartEvent.md) \| [`ManagedAgentsSpanModelRequestEndEvent`](../interfaces/ManagedAgentsSpanModelRequestEndEvent.md) \| [`ManagedAgentsSpanOutcomeEvaluationOngoingEvent`](../interfaces/ManagedAgentsSpanOutcomeEvaluationOngoingEvent.md) \| [`ManagedAgentsUserDefineOutcomeEvent`](../interfaces/ManagedAgentsUserDefineOutcomeEvent.md) \| [`ManagedAgentsSessionDeletedEvent`](../interfaces/ManagedAgentsSessionDeletedEvent.md) \| [`ManagedAgentsSessionThreadStatusRunningEvent`](../interfaces/ManagedAgentsSessionThreadStatusRunningEvent.md) \| [`ManagedAgentsSessionThreadStatusIdleEvent`](../interfaces/ManagedAgentsSessionThreadStatusIdleEvent.md) \| [`ManagedAgentsSessionThreadStatusTerminatedEvent`](../interfaces/ManagedAgentsSessionThreadStatusTerminatedEvent.md) \| [`ManagedAgentsUserToolResultEvent`](../interfaces/ManagedAgentsUserToolResultEvent.md) \| [`ManagedAgentsSessionThreadStatusRescheduledEvent`](../interfaces/ManagedAgentsSessionThreadStatusRescheduledEvent.md) \| [`ManagedAgentsSessionUpdatedEvent`](../interfaces/ManagedAgentsSessionUpdatedEvent.md) \| [`ManagedAgentsStartEvent`](../interfaces/ManagedAgentsStartEvent.md) \| [`ManagedAgentsDeltaEvent`](../interfaces/ManagedAgentsDeltaEvent.md) \| [`ManagedAgentsSystemMessageEvent`](../interfaces/ManagedAgentsSystemMessageEvent.md) \| [`ManagedAgentsSessionUsageEvent`](../interfaces/ManagedAgentsSessionUsageEvent.md) +> **ManagedAgentsStreamSessionEventsUnion** = [`ManagedAgentsUserMessageEvent`](../interfaces/ManagedAgentsUserMessageEvent.md) \| [`ManagedAgentsUserInterruptEvent`](../interfaces/ManagedAgentsUserInterruptEvent.md) \| [`ManagedAgentsUserToolConfirmationEvent`](../interfaces/ManagedAgentsUserToolConfirmationEvent.md) \| [`ManagedAgentsUserCustomToolResultEvent`](../interfaces/ManagedAgentsUserCustomToolResultEvent.md) \| [`ManagedAgentsAgentCustomToolUseEvent`](../interfaces/ManagedAgentsAgentCustomToolUseEvent.md) \| [`ManagedAgentsAgentMessageEvent`](../interfaces/ManagedAgentsAgentMessageEvent.md) \| [`ManagedAgentsAgentThinkingEvent`](../interfaces/ManagedAgentsAgentThinkingEvent.md) \| [`ManagedAgentsAgentMCPToolUseEvent`](../interfaces/ManagedAgentsAgentMCPToolUseEvent.md) \| [`ManagedAgentsAgentMCPToolResultEvent`](../interfaces/ManagedAgentsAgentMCPToolResultEvent.md) \| [`ManagedAgentsAgentToolUseEvent`](../interfaces/ManagedAgentsAgentToolUseEvent.md) \| [`ManagedAgentsAgentToolResultEvent`](../interfaces/ManagedAgentsAgentToolResultEvent.md) \| [`ManagedAgentsAgentThreadMessageReceivedEvent`](../interfaces/ManagedAgentsAgentThreadMessageReceivedEvent.md) \| [`ManagedAgentsAgentThreadMessageSentEvent`](../interfaces/ManagedAgentsAgentThreadMessageSentEvent.md) \| [`ManagedAgentsAgentThreadContextCompactedEvent`](../interfaces/ManagedAgentsAgentThreadContextCompactedEvent.md) \| [`ManagedAgentsSessionErrorEvent`](../interfaces/ManagedAgentsSessionErrorEvent.md) \| [`ManagedAgentsSessionStatusRescheduledEvent`](../interfaces/ManagedAgentsSessionStatusRescheduledEvent.md) \| [`ManagedAgentsSessionStatusRunningEvent`](../interfaces/ManagedAgentsSessionStatusRunningEvent.md) \| [`ManagedAgentsSessionStatusIdleEvent`](../interfaces/ManagedAgentsSessionStatusIdleEvent.md) \| [`ManagedAgentsSessionStatusTerminatedEvent`](../interfaces/ManagedAgentsSessionStatusTerminatedEvent.md) \| [`ManagedAgentsSessionThreadCreatedEvent`](../interfaces/ManagedAgentsSessionThreadCreatedEvent.md) \| [`ManagedAgentsSpanOutcomeEvaluationStartEvent`](../interfaces/ManagedAgentsSpanOutcomeEvaluationStartEvent.md) \| [`ManagedAgentsSpanOutcomeEvaluationEndEvent`](../interfaces/ManagedAgentsSpanOutcomeEvaluationEndEvent.md) \| [`ManagedAgentsSpanModelRequestStartEvent`](../interfaces/ManagedAgentsSpanModelRequestStartEvent.md) \| [`ManagedAgentsSpanModelRequestEndEvent`](../interfaces/ManagedAgentsSpanModelRequestEndEvent.md) \| [`ManagedAgentsSpanOutcomeEvaluationOngoingEvent`](../interfaces/ManagedAgentsSpanOutcomeEvaluationOngoingEvent.md) \| [`ManagedAgentsUserDefineOutcomeEvent`](../interfaces/ManagedAgentsUserDefineOutcomeEvent.md) \| [`ManagedAgentsSessionDeletedEvent`](../interfaces/ManagedAgentsSessionDeletedEvent.md) \| [`ManagedAgentsSessionThreadStatusRunningEvent`](../interfaces/ManagedAgentsSessionThreadStatusRunningEvent.md) \| [`ManagedAgentsSessionThreadStatusIdleEvent`](../interfaces/ManagedAgentsSessionThreadStatusIdleEvent.md) \| [`ManagedAgentsSessionThreadStatusTerminatedEvent`](../interfaces/ManagedAgentsSessionThreadStatusTerminatedEvent.md) \| [`ManagedAgentsUserToolResultEvent`](../interfaces/ManagedAgentsUserToolResultEvent.md) \| [`ManagedAgentsSessionThreadStatusRescheduledEvent`](../interfaces/ManagedAgentsSessionThreadStatusRescheduledEvent.md) \| [`ManagedAgentsSessionUpdatedEvent`](../interfaces/ManagedAgentsSessionUpdatedEvent.md) \| [`ManagedAgentsStartEvent`](../interfaces/ManagedAgentsStartEvent.md) \| [`ManagedAgentsDeltaEvent`](../interfaces/ManagedAgentsDeltaEvent.md) \| [`ManagedAgentsSystemMessageEvent`](../interfaces/ManagedAgentsSystemMessageEvent.md) \| [`ManagedAgentsSessionUsageEvent`](../interfaces/ManagedAgentsSessionUsageEvent.md) \| [`ManagedAgentsAgentArtifactDeliveredEvent`](../interfaces/ManagedAgentsAgentArtifactDeliveredEvent.md) diff --git a/docs/api/managed/type-aliases/ManagedAgentsStreamSessionThreadEventsUnion.md b/docs/api/managed/type-aliases/ManagedAgentsStreamSessionThreadEventsUnion.md index dc07344..b98d4e9 100644 --- a/docs/api/managed/type-aliases/ManagedAgentsStreamSessionThreadEventsUnion.md +++ b/docs/api/managed/type-aliases/ManagedAgentsStreamSessionThreadEventsUnion.md @@ -6,4 +6,4 @@ # Type Alias: ManagedAgentsStreamSessionThreadEventsUnion -> **ManagedAgentsStreamSessionThreadEventsUnion** = [`ManagedAgentsUserMessageEvent`](../interfaces/ManagedAgentsUserMessageEvent.md) \| [`ManagedAgentsUserInterruptEvent`](../interfaces/ManagedAgentsUserInterruptEvent.md) \| [`ManagedAgentsUserToolConfirmationEvent`](../interfaces/ManagedAgentsUserToolConfirmationEvent.md) \| [`ManagedAgentsUserCustomToolResultEvent`](../interfaces/ManagedAgentsUserCustomToolResultEvent.md) \| [`ManagedAgentsAgentCustomToolUseEvent`](../interfaces/ManagedAgentsAgentCustomToolUseEvent.md) \| [`ManagedAgentsAgentMessageEvent`](../interfaces/ManagedAgentsAgentMessageEvent.md) \| [`ManagedAgentsAgentThinkingEvent`](../interfaces/ManagedAgentsAgentThinkingEvent.md) \| [`ManagedAgentsAgentMCPToolUseEvent`](../interfaces/ManagedAgentsAgentMCPToolUseEvent.md) \| [`ManagedAgentsAgentMCPToolResultEvent`](../interfaces/ManagedAgentsAgentMCPToolResultEvent.md) \| [`ManagedAgentsAgentToolUseEvent`](../interfaces/ManagedAgentsAgentToolUseEvent.md) \| [`ManagedAgentsAgentToolResultEvent`](../interfaces/ManagedAgentsAgentToolResultEvent.md) \| [`ManagedAgentsAgentThreadMessageReceivedEvent`](../interfaces/ManagedAgentsAgentThreadMessageReceivedEvent.md) \| [`ManagedAgentsAgentThreadMessageSentEvent`](../interfaces/ManagedAgentsAgentThreadMessageSentEvent.md) \| [`ManagedAgentsAgentThreadContextCompactedEvent`](../interfaces/ManagedAgentsAgentThreadContextCompactedEvent.md) \| [`ManagedAgentsSessionErrorEvent`](../interfaces/ManagedAgentsSessionErrorEvent.md) \| [`ManagedAgentsSessionStatusRescheduledEvent`](../interfaces/ManagedAgentsSessionStatusRescheduledEvent.md) \| [`ManagedAgentsSessionStatusRunningEvent`](../interfaces/ManagedAgentsSessionStatusRunningEvent.md) \| [`ManagedAgentsSessionStatusIdleEvent`](../interfaces/ManagedAgentsSessionStatusIdleEvent.md) \| [`ManagedAgentsSessionStatusTerminatedEvent`](../interfaces/ManagedAgentsSessionStatusTerminatedEvent.md) \| [`ManagedAgentsSessionThreadCreatedEvent`](../interfaces/ManagedAgentsSessionThreadCreatedEvent.md) \| [`ManagedAgentsSpanOutcomeEvaluationStartEvent`](../interfaces/ManagedAgentsSpanOutcomeEvaluationStartEvent.md) \| [`ManagedAgentsSpanOutcomeEvaluationEndEvent`](../interfaces/ManagedAgentsSpanOutcomeEvaluationEndEvent.md) \| [`ManagedAgentsSpanModelRequestStartEvent`](../interfaces/ManagedAgentsSpanModelRequestStartEvent.md) \| [`ManagedAgentsSpanModelRequestEndEvent`](../interfaces/ManagedAgentsSpanModelRequestEndEvent.md) \| [`ManagedAgentsSpanOutcomeEvaluationOngoingEvent`](../interfaces/ManagedAgentsSpanOutcomeEvaluationOngoingEvent.md) \| [`ManagedAgentsUserDefineOutcomeEvent`](../interfaces/ManagedAgentsUserDefineOutcomeEvent.md) \| [`ManagedAgentsSessionDeletedEvent`](../interfaces/ManagedAgentsSessionDeletedEvent.md) \| [`ManagedAgentsSessionThreadStatusRunningEvent`](../interfaces/ManagedAgentsSessionThreadStatusRunningEvent.md) \| [`ManagedAgentsSessionThreadStatusIdleEvent`](../interfaces/ManagedAgentsSessionThreadStatusIdleEvent.md) \| [`ManagedAgentsSessionThreadStatusTerminatedEvent`](../interfaces/ManagedAgentsSessionThreadStatusTerminatedEvent.md) \| [`ManagedAgentsUserToolResultEvent`](../interfaces/ManagedAgentsUserToolResultEvent.md) \| [`ManagedAgentsSessionThreadStatusRescheduledEvent`](../interfaces/ManagedAgentsSessionThreadStatusRescheduledEvent.md) \| [`ManagedAgentsSessionUpdatedEvent`](../interfaces/ManagedAgentsSessionUpdatedEvent.md) \| [`ManagedAgentsStartEvent`](../interfaces/ManagedAgentsStartEvent.md) \| [`ManagedAgentsDeltaEvent`](../interfaces/ManagedAgentsDeltaEvent.md) \| [`ManagedAgentsSystemMessageEvent`](../interfaces/ManagedAgentsSystemMessageEvent.md) \| [`ManagedAgentsSessionUsageEvent`](../interfaces/ManagedAgentsSessionUsageEvent.md) +> **ManagedAgentsStreamSessionThreadEventsUnion** = [`ManagedAgentsUserMessageEvent`](../interfaces/ManagedAgentsUserMessageEvent.md) \| [`ManagedAgentsUserInterruptEvent`](../interfaces/ManagedAgentsUserInterruptEvent.md) \| [`ManagedAgentsUserToolConfirmationEvent`](../interfaces/ManagedAgentsUserToolConfirmationEvent.md) \| [`ManagedAgentsUserCustomToolResultEvent`](../interfaces/ManagedAgentsUserCustomToolResultEvent.md) \| [`ManagedAgentsAgentCustomToolUseEvent`](../interfaces/ManagedAgentsAgentCustomToolUseEvent.md) \| [`ManagedAgentsAgentMessageEvent`](../interfaces/ManagedAgentsAgentMessageEvent.md) \| [`ManagedAgentsAgentThinkingEvent`](../interfaces/ManagedAgentsAgentThinkingEvent.md) \| [`ManagedAgentsAgentMCPToolUseEvent`](../interfaces/ManagedAgentsAgentMCPToolUseEvent.md) \| [`ManagedAgentsAgentMCPToolResultEvent`](../interfaces/ManagedAgentsAgentMCPToolResultEvent.md) \| [`ManagedAgentsAgentToolUseEvent`](../interfaces/ManagedAgentsAgentToolUseEvent.md) \| [`ManagedAgentsAgentToolResultEvent`](../interfaces/ManagedAgentsAgentToolResultEvent.md) \| [`ManagedAgentsAgentThreadMessageReceivedEvent`](../interfaces/ManagedAgentsAgentThreadMessageReceivedEvent.md) \| [`ManagedAgentsAgentThreadMessageSentEvent`](../interfaces/ManagedAgentsAgentThreadMessageSentEvent.md) \| [`ManagedAgentsAgentThreadContextCompactedEvent`](../interfaces/ManagedAgentsAgentThreadContextCompactedEvent.md) \| [`ManagedAgentsSessionErrorEvent`](../interfaces/ManagedAgentsSessionErrorEvent.md) \| [`ManagedAgentsSessionStatusRescheduledEvent`](../interfaces/ManagedAgentsSessionStatusRescheduledEvent.md) \| [`ManagedAgentsSessionStatusRunningEvent`](../interfaces/ManagedAgentsSessionStatusRunningEvent.md) \| [`ManagedAgentsSessionStatusIdleEvent`](../interfaces/ManagedAgentsSessionStatusIdleEvent.md) \| [`ManagedAgentsSessionStatusTerminatedEvent`](../interfaces/ManagedAgentsSessionStatusTerminatedEvent.md) \| [`ManagedAgentsSessionThreadCreatedEvent`](../interfaces/ManagedAgentsSessionThreadCreatedEvent.md) \| [`ManagedAgentsSpanOutcomeEvaluationStartEvent`](../interfaces/ManagedAgentsSpanOutcomeEvaluationStartEvent.md) \| [`ManagedAgentsSpanOutcomeEvaluationEndEvent`](../interfaces/ManagedAgentsSpanOutcomeEvaluationEndEvent.md) \| [`ManagedAgentsSpanModelRequestStartEvent`](../interfaces/ManagedAgentsSpanModelRequestStartEvent.md) \| [`ManagedAgentsSpanModelRequestEndEvent`](../interfaces/ManagedAgentsSpanModelRequestEndEvent.md) \| [`ManagedAgentsSpanOutcomeEvaluationOngoingEvent`](../interfaces/ManagedAgentsSpanOutcomeEvaluationOngoingEvent.md) \| [`ManagedAgentsUserDefineOutcomeEvent`](../interfaces/ManagedAgentsUserDefineOutcomeEvent.md) \| [`ManagedAgentsSessionDeletedEvent`](../interfaces/ManagedAgentsSessionDeletedEvent.md) \| [`ManagedAgentsSessionThreadStatusRunningEvent`](../interfaces/ManagedAgentsSessionThreadStatusRunningEvent.md) \| [`ManagedAgentsSessionThreadStatusIdleEvent`](../interfaces/ManagedAgentsSessionThreadStatusIdleEvent.md) \| [`ManagedAgentsSessionThreadStatusTerminatedEvent`](../interfaces/ManagedAgentsSessionThreadStatusTerminatedEvent.md) \| [`ManagedAgentsUserToolResultEvent`](../interfaces/ManagedAgentsUserToolResultEvent.md) \| [`ManagedAgentsSessionThreadStatusRescheduledEvent`](../interfaces/ManagedAgentsSessionThreadStatusRescheduledEvent.md) \| [`ManagedAgentsSessionUpdatedEvent`](../interfaces/ManagedAgentsSessionUpdatedEvent.md) \| [`ManagedAgentsStartEvent`](../interfaces/ManagedAgentsStartEvent.md) \| [`ManagedAgentsDeltaEvent`](../interfaces/ManagedAgentsDeltaEvent.md) \| [`ManagedAgentsSystemMessageEvent`](../interfaces/ManagedAgentsSystemMessageEvent.md) \| [`ManagedAgentsSessionUsageEvent`](../interfaces/ManagedAgentsSessionUsageEvent.md) \| [`ManagedAgentsAgentArtifactDeliveredEvent`](../interfaces/ManagedAgentsAgentArtifactDeliveredEvent.md) diff --git a/docs/api/managed/type-aliases/SessionNewParamsResourceUnion.md b/docs/api/managed/type-aliases/SessionNewParamsResourceUnion.md index b04d8ce..1f57bd6 100644 --- a/docs/api/managed/type-aliases/SessionNewParamsResourceUnion.md +++ b/docs/api/managed/type-aliases/SessionNewParamsResourceUnion.md @@ -6,4 +6,4 @@ # Type Alias: SessionNewParamsResourceUnion -> **SessionNewParamsResourceUnion** = [`ManagedAgentsGitHubRepositoryResourceParams`](../interfaces/ManagedAgentsGitHubRepositoryResourceParams.md) \| [`ManagedAgentsFileResourceParams`](../interfaces/ManagedAgentsFileResourceParams.md) \| [`ManagedAgentsMemoryStoreResourceParam`](../interfaces/ManagedAgentsMemoryStoreResourceParam.md) +> **SessionNewParamsResourceUnion** = [`ManagedAgentsGitRepositoryResourceParams`](../interfaces/ManagedAgentsGitRepositoryResourceParams.md) \| [`ManagedAgentsGitHubRepositoryResourceParams`](../interfaces/ManagedAgentsGitHubRepositoryResourceParams.md) \| [`ManagedAgentsFileResourceParams`](../interfaces/ManagedAgentsFileResourceParams.md) \| [`ManagedAgentsMemoryStoreResourceParam`](../interfaces/ManagedAgentsMemoryStoreResourceParam.md) diff --git a/docs/api/managed/type-aliases/SessionResourceGetResponseUnion.md b/docs/api/managed/type-aliases/SessionResourceGetResponseUnion.md index b5584bf..f84f5cc 100644 --- a/docs/api/managed/type-aliases/SessionResourceGetResponseUnion.md +++ b/docs/api/managed/type-aliases/SessionResourceGetResponseUnion.md @@ -6,4 +6,4 @@ # Type Alias: SessionResourceGetResponseUnion -> **SessionResourceGetResponseUnion** = [`ManagedAgentsGitHubRepositoryResource`](../interfaces/ManagedAgentsGitHubRepositoryResource.md) \| [`ManagedAgentsFileResource`](../interfaces/ManagedAgentsFileResource.md) \| [`ManagedAgentsMemoryStoreResource`](../interfaces/ManagedAgentsMemoryStoreResource.md) +> **SessionResourceGetResponseUnion** = [`ManagedAgentsGitRepositoryResource`](../interfaces/ManagedAgentsGitRepositoryResource.md) \| [`ManagedAgentsGitHubRepositoryResource`](../interfaces/ManagedAgentsGitHubRepositoryResource.md) \| [`ManagedAgentsFileResource`](../interfaces/ManagedAgentsFileResource.md) \| [`ManagedAgentsMemoryStoreResource`](../interfaces/ManagedAgentsMemoryStoreResource.md) diff --git a/docs/api/managed/type-aliases/SessionResourceUpdateResponseUnion.md b/docs/api/managed/type-aliases/SessionResourceUpdateResponseUnion.md index d993388..fc88e12 100644 --- a/docs/api/managed/type-aliases/SessionResourceUpdateResponseUnion.md +++ b/docs/api/managed/type-aliases/SessionResourceUpdateResponseUnion.md @@ -6,4 +6,4 @@ # Type Alias: SessionResourceUpdateResponseUnion -> **SessionResourceUpdateResponseUnion** = [`ManagedAgentsGitHubRepositoryResource`](../interfaces/ManagedAgentsGitHubRepositoryResource.md) \| [`ManagedAgentsFileResource`](../interfaces/ManagedAgentsFileResource.md) \| [`ManagedAgentsMemoryStoreResource`](../interfaces/ManagedAgentsMemoryStoreResource.md) +> **SessionResourceUpdateResponseUnion** = [`ManagedAgentsGitRepositoryResource`](../interfaces/ManagedAgentsGitRepositoryResource.md) \| [`ManagedAgentsGitHubRepositoryResource`](../interfaces/ManagedAgentsGitHubRepositoryResource.md) \| [`ManagedAgentsFileResource`](../interfaces/ManagedAgentsFileResource.md) \| [`ManagedAgentsMemoryStoreResource`](../interfaces/ManagedAgentsMemoryStoreResource.md) diff --git a/package-lock.json b/package-lock.json index 2a35dfa..7b3ae5b 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "qca-sdk", - "version": "0.7.0", + "version": "0.8.0", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "qca-sdk", - "version": "0.7.0", + "version": "0.8.0", "license": "MIT", "dependencies": { "ws": "^8.22.0" diff --git a/package.json b/package.json index 7f99fe1..3994dd0 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "qca-sdk", - "version": "0.7.0", + "version": "0.8.0", "description": "TypeScript SDK for Qoder Cloud Agents Forward and Managed APIs", "author": "Qoder", "license": "MIT", diff --git a/src/forward/types.ts b/src/forward/types.ts index 595e004..85755bb 100644 --- a/src/forward/types.ts +++ b/src/forward/types.ts @@ -68,6 +68,8 @@ export interface BatchListParams { } export interface BatchNewParams { + /** Ignore the scheduling time window; capacity and FIFO priority still apply. */ + ignore_idle_window?: boolean; /** * 通过 Files API 上传的 JSONL 文件 ID。 */ @@ -111,6 +113,9 @@ export interface BatchFile { } export interface Batch { + ignore_idle_window?: boolean; + /** Dynamic queue reason, present only when applicable to validating or queued Batches. */ + queue_reason?: string; /** * Batch ID，前缀 `batch_`。 */ @@ -955,6 +960,8 @@ export interface EnvironmentUpdateParams { } export interface Environment { + icon_url?: string | null; + binding_info?: EnvironmentBindingInfo; id: string; type: string; name: string; @@ -970,6 +977,7 @@ export interface Environment { } export interface EnvironmentConfig { + setup_script?: string; type: string; packages: EnvironmentConfigPackages; /** Additional fields are preserved verbatim by the SDK. */ @@ -1522,6 +1530,8 @@ export interface MemoryStoreListParams { } export interface MemoryStoreNewParams { + /** Establish this mount before returning; use the same key and body to resume creation. */ + mount?: MemoryStoreCreateMountParam; /** * Store 展示名，非空。不允许非打印控制字符（`U+0000`–`U+001F`、`U+007F`），换行 `\n`、回车 `\r`、制表 `\t` 除外。 */ @@ -1963,6 +1973,10 @@ export interface ScheduleArchiveManyResponse { } export interface Schedule { + source?: string; + source_session_id?: string | null; + /** Server-maintained input version, incremented when initial_events changes. */ + initial_events_version?: number; id: string; identity_id: string; template_id: string; @@ -2005,6 +2019,9 @@ export interface ScheduleSinksItemTarget { } export interface ScheduleTriggerPolicy { + start_at?: string; + stop_at?: string; + last_run_at?: string | null; type: string; expression: string; timezone: string; @@ -2084,6 +2101,10 @@ export interface ScheduleRunGetParams { } export interface ScheduleRun { + source?: string; + source_session_id?: string | null; + /** Server-selected input version; a missing Run version is unknown. */ + initial_events_version?: number; /** * Schedule Run ID。 */ @@ -2172,6 +2193,8 @@ export interface ScheduleRunTriggerContext { } export interface SessionListParams { + /** Match an exact sess_ ID or search Session titles. */ + search?: string; /** * 按一个或多个 Identity ID 过滤，支持逗号分隔。 */ @@ -2316,6 +2339,7 @@ export interface SessionCancelParams { } export interface Session { + outcome_evaluations?: Array; /** * Session ID。 */ @@ -2577,6 +2601,8 @@ export interface SessionThreadArchiveParams { } export interface SessionThread { + stats?: SessionThreadStats; + usage?: SessionThreadUsage; id: string; type: string; session_id: string; @@ -2748,7 +2774,7 @@ export interface Skill { display_title: string; description: string; source: string; - latest_version: string; + latest_version: string | null; metadata: Record; created_at: string; updated_at: string; @@ -2840,6 +2866,8 @@ export interface TemplateListParams { } export interface TemplateNewParams { + /** Positive maximum tool-call rounds per Turn. Omit or pass null to use the platform default. */ + max_tool_rounds?: number | null; /** Replaces the complete managed tool list. Null or an empty list disables it. */ managed_tool_config?: ManagedToolConfig | null; /** @@ -2911,6 +2939,8 @@ export interface TemplateNewParams { } export interface TemplateUpdateParams { + /** Positive maximum tool-call rounds per Turn. Omit to preserve the limit; null clears it. */ + max_tool_rounds?: number | null; /** Replaces the complete managed tool list. Null or an empty list disables it. */ managed_tool_config?: ManagedToolConfig | null; /** @@ -3008,6 +3038,8 @@ export interface TemplateCloneParams { } export interface Template { + /** Omitted when the explicit limit is unset. */ + max_tool_rounds?: number; /** Replaces the complete managed tool list. Null or an empty list disables it. */ managed_tool_config?: ManagedToolConfig | null; /** @@ -3385,3 +3417,34 @@ export interface DriveClearResponse { deleted_count: number; [key: string]: unknown; } + +export interface SessionOutcomeEvaluation { + type: string; + outcome_id: string; + description: string; + iteration: number; + result: string; + explanation: string | null; + completed_at: string | null; +} + +export interface SessionThreadStats { + active_seconds: number; + duration_seconds: number; + startup_seconds?: number; +} + +export interface SessionThreadUsage { + total_credits?: number; +} + +export interface MemoryStoreCreateMountParam { + identity_id: string; + template_id: string; + /** Defaults to read_only. */ + access?: "read_only" | "read_write"; +} + +export interface EnvironmentBindingInfo { + agent_template_count: number; +} diff --git a/src/managed/types.ts b/src/managed/types.ts index e936027..80d6b65 100644 --- a/src/managed/types.ts +++ b/src/managed/types.ts @@ -2057,7 +2057,7 @@ export interface ManagedAgentsSelfHostedResourcesUnsupportedDeploymentPausedReas export type ManagedAgentsSelfHostedResourcesUnsupportedDeploymentPausedReasonErrorType = "self_hosted_resources_unsupported_error"; -export type ManagedAgentsSessionResourceConfigUnion = ManagedAgentsGitHubRepositoryResourceConfig | ManagedAgentsFileResourceConfig | ManagedAgentsMemoryStoreResourceConfig; +export type ManagedAgentsSessionResourceConfigUnion = ManagedAgentsGitRepositoryResourceConfig | ManagedAgentsGitHubRepositoryResourceConfig | ManagedAgentsFileResourceConfig | ManagedAgentsMemoryStoreResourceConfig; /** * A referenced resource no longer exists and its kind was not reported. @@ -2192,7 +2192,7 @@ export interface DeploymentNewParams { export type DeploymentNewParamsAgentUnion = string | ManagedAgentsAgentParams; -export type DeploymentNewParamsResourceUnion = ManagedAgentsGitHubRepositoryResourceParams | ManagedAgentsFileResourceParams | ManagedAgentsMemoryStoreResourceParam; +export type DeploymentNewParamsResourceUnion = ManagedAgentsGitRepositoryResourceParams | ManagedAgentsGitHubRepositoryResourceParams | ManagedAgentsFileResourceParams | ManagedAgentsMemoryStoreResourceParam; export interface DeploymentGetParams { workspace_id?: string; @@ -2262,7 +2262,7 @@ export interface DeploymentUpdateParams { export type DeploymentUpdateParamsAgentUnion = string | ManagedAgentsAgentParams; -export type DeploymentUpdateParamsResourceUnion = ManagedAgentsGitHubRepositoryResourceParams | ManagedAgentsFileResourceParams | ManagedAgentsMemoryStoreResourceParam; +export type DeploymentUpdateParamsResourceUnion = ManagedAgentsGitRepositoryResourceParams | ManagedAgentsGitHubRepositoryResourceParams | ManagedAgentsFileResourceParams | ManagedAgentsMemoryStoreResourceParam; export interface DeploymentListParams { before_id?: string; @@ -2892,6 +2892,8 @@ export type DreamModelConfigParamSpeed = "standard" | "fast"; * An output memory store the dream writes consolidated memories into. */ export interface DreamOutput { + /** Paths of memory files created, modified or deleted. */ + files_touched?: Array; memory_store_id: string; /** * Any of "memory_store". @@ -3368,6 +3370,7 @@ export type PackagesParamsType = "packages"; * Configuration for self-hosted environments. */ export interface SelfHostedConfig { + setup_script?: string; /** * Environment type */ @@ -3381,6 +3384,7 @@ export interface SelfHostedConfig { * `NewSelfHostedConfigParams`. */ export interface SelfHostedConfigParams { + setup_script?: string; /** * Environment type */ @@ -4048,6 +4052,9 @@ export type ManagedAgentsDeletedMemoryStoreType = "memory_store_deleted"; * agent can read and write. */ export interface ManagedAgentsMemoryStore { + status?: string; + entry_count?: number; + total_size?: number; /** * Unique identifier for the memory store (a `memstore_...` tagged ID). Use this * when attaching the store to a session, or in the `{memory_store_id}` path @@ -6667,7 +6674,7 @@ export interface ManagedAgentsGitHubRepositoryResourceParams { /** * GitHub authorization token used to clone the repository. */ - authorization_token: string; + authorization_token?: string; /** * Any of "github_repository". */ @@ -7333,7 +7340,7 @@ export type SessionNewParamsAgentUnion = string | ManagedAgentsAgentParams | Man export type SessionNewParamsInitialEventUnion = ManagedAgentsUserMessageEventParams | ManagedAgentsUserDefineOutcomeEventParams; -export type SessionNewParamsResourceUnion = ManagedAgentsGitHubRepositoryResourceParams | ManagedAgentsFileResourceParams | ManagedAgentsMemoryStoreResourceParam; +export type SessionNewParamsResourceUnion = ManagedAgentsGitRepositoryResourceParams | ManagedAgentsGitHubRepositoryResourceParams | ManagedAgentsFileResourceParams | ManagedAgentsMemoryStoreResourceParam; export interface SessionGetParams { workspace_id?: string; @@ -7958,6 +7965,8 @@ export interface ManagedAgentsBase64ImageSourceParam { * succeed; the caller must resolve the billing state. */ export interface ManagedAgentsBillingError { + /** Diagnostic only; use retry_status to determine retry behavior. */ + qoder_error_code?: string; /** * Human-readable error description. */ @@ -7981,6 +7990,8 @@ export type ManagedAgentsBillingErrorType = "billing_error"; * a host the environment's network policy does not permit. */ export interface ManagedAgentsCredentialHostUnreachableError { + /** Diagnostic only; use retry_status to determine retry behavior. */ + qoder_error_code?: string; /** * ID of the affected credential. */ @@ -8196,6 +8207,8 @@ export type ManagedAgentsImageBlockSourceUnionParam = ManagedAgentsBase64ImageSo * Authentication to an MCP server failed. */ export interface ManagedAgentsMCPAuthenticationFailedError { + /** Diagnostic only; use retry_status to determine retry behavior. */ + qoder_error_code?: string; /** * Name of the MCP server that failed authentication. */ @@ -8227,6 +8240,8 @@ export type ManagedAgentsMCPAuthenticationFailedErrorType = "mcp_authentication_ * Failed to connect to an MCP server. */ export interface ManagedAgentsMCPConnectionFailedError { + /** Diagnostic only; use retry_status to determine retry behavior. */ + qoder_error_code?: string; /** * Name of the MCP server that failed to connect. */ @@ -8259,6 +8274,8 @@ export type ManagedAgentsMCPConnectionFailedErrorType = "mcp_connection_failed_e * exhausted. */ export interface ManagedAgentsModelOverloadedError { + /** Diagnostic only; use retry_status to determine retry behavior. */ + qoder_error_code?: string; /** * Human-readable error description. */ @@ -8286,6 +8303,8 @@ export type ManagedAgentsModelOverloadedErrorType = "model_overloaded_error"; * The model request was rate-limited. */ export interface ManagedAgentsModelRateLimitedError { + /** Diagnostic only; use retry_status to determine retry behavior. */ + qoder_error_code?: string; /** * Human-readable error description. */ @@ -8313,6 +8332,8 @@ export type ManagedAgentsModelRateLimitedErrorType = "model_rate_limited_error"; * A model request failed for a reason other than overload or rate-limiting. */ export interface ManagedAgentsModelRequestFailedError { + /** Diagnostic only; use retry_status to determine retry behavior. */ + qoder_error_code?: string; /** * Human-readable error description. */ @@ -8643,7 +8664,7 @@ export interface ManagedAgentsSessionErrorEventErrorUnionRetryStatus { export type ManagedAgentsSessionErrorEventType = "session.error"; -export type ManagedAgentsSessionEventUnion = ManagedAgentsUserMessageEvent | ManagedAgentsUserInterruptEvent | ManagedAgentsUserToolConfirmationEvent | ManagedAgentsUserCustomToolResultEvent | ManagedAgentsAgentCustomToolUseEvent | ManagedAgentsAgentMessageEvent | ManagedAgentsAgentThinkingEvent | ManagedAgentsAgentMCPToolUseEvent | ManagedAgentsAgentMCPToolResultEvent | ManagedAgentsAgentToolUseEvent | ManagedAgentsAgentToolResultEvent | ManagedAgentsAgentThreadMessageReceivedEvent | ManagedAgentsAgentThreadMessageSentEvent | ManagedAgentsAgentThreadContextCompactedEvent | ManagedAgentsSessionErrorEvent | ManagedAgentsSessionStatusRescheduledEvent | ManagedAgentsSessionStatusRunningEvent | ManagedAgentsSessionStatusIdleEvent | ManagedAgentsSessionStatusTerminatedEvent | ManagedAgentsSessionThreadCreatedEvent | ManagedAgentsSpanOutcomeEvaluationStartEvent | ManagedAgentsSpanOutcomeEvaluationEndEvent | ManagedAgentsSpanModelRequestStartEvent | ManagedAgentsSpanModelRequestEndEvent | ManagedAgentsSpanOutcomeEvaluationOngoingEvent | ManagedAgentsUserDefineOutcomeEvent | ManagedAgentsSessionDeletedEvent | ManagedAgentsSessionThreadStatusRunningEvent | ManagedAgentsSessionThreadStatusIdleEvent | ManagedAgentsSessionThreadStatusTerminatedEvent | ManagedAgentsUserToolResultEvent | ManagedAgentsSessionThreadStatusRescheduledEvent | ManagedAgentsSessionUpdatedEvent | ManagedAgentsSystemMessageEvent | ManagedAgentsSessionUsageEvent; +export type ManagedAgentsSessionEventUnion = ManagedAgentsUserMessageEvent | ManagedAgentsUserInterruptEvent | ManagedAgentsUserToolConfirmationEvent | ManagedAgentsUserCustomToolResultEvent | ManagedAgentsAgentCustomToolUseEvent | ManagedAgentsAgentMessageEvent | ManagedAgentsAgentThinkingEvent | ManagedAgentsAgentMCPToolUseEvent | ManagedAgentsAgentMCPToolResultEvent | ManagedAgentsAgentToolUseEvent | ManagedAgentsAgentToolResultEvent | ManagedAgentsAgentThreadMessageReceivedEvent | ManagedAgentsAgentThreadMessageSentEvent | ManagedAgentsAgentThreadContextCompactedEvent | ManagedAgentsSessionErrorEvent | ManagedAgentsSessionStatusRescheduledEvent | ManagedAgentsSessionStatusRunningEvent | ManagedAgentsSessionStatusIdleEvent | ManagedAgentsSessionStatusTerminatedEvent | ManagedAgentsSessionThreadCreatedEvent | ManagedAgentsSpanOutcomeEvaluationStartEvent | ManagedAgentsSpanOutcomeEvaluationEndEvent | ManagedAgentsSpanModelRequestStartEvent | ManagedAgentsSpanModelRequestEndEvent | ManagedAgentsSpanOutcomeEvaluationOngoingEvent | ManagedAgentsUserDefineOutcomeEvent | ManagedAgentsSessionDeletedEvent | ManagedAgentsSessionThreadStatusRunningEvent | ManagedAgentsSessionThreadStatusIdleEvent | ManagedAgentsSessionThreadStatusTerminatedEvent | ManagedAgentsUserToolResultEvent | ManagedAgentsSessionThreadStatusRescheduledEvent | ManagedAgentsSessionUpdatedEvent | ManagedAgentsSystemMessageEvent | ManagedAgentsSessionUsageEvent | ManagedAgentsAgentArtifactDeliveredEvent; export type ManagedAgentsSessionEventUnionContent = Array | Array | Array | Array | Array | Array | Array | Array | Array; @@ -9215,7 +9236,7 @@ export interface ManagedAgentsSpanOutcomeEvaluationStartEvent { export type ManagedAgentsSpanOutcomeEvaluationStartEventType = "span.outcome_evaluation_start"; -export type ManagedAgentsStreamSessionEventsUnion = ManagedAgentsUserMessageEvent | ManagedAgentsUserInterruptEvent | ManagedAgentsUserToolConfirmationEvent | ManagedAgentsUserCustomToolResultEvent | ManagedAgentsAgentCustomToolUseEvent | ManagedAgentsAgentMessageEvent | ManagedAgentsAgentThinkingEvent | ManagedAgentsAgentMCPToolUseEvent | ManagedAgentsAgentMCPToolResultEvent | ManagedAgentsAgentToolUseEvent | ManagedAgentsAgentToolResultEvent | ManagedAgentsAgentThreadMessageReceivedEvent | ManagedAgentsAgentThreadMessageSentEvent | ManagedAgentsAgentThreadContextCompactedEvent | ManagedAgentsSessionErrorEvent | ManagedAgentsSessionStatusRescheduledEvent | ManagedAgentsSessionStatusRunningEvent | ManagedAgentsSessionStatusIdleEvent | ManagedAgentsSessionStatusTerminatedEvent | ManagedAgentsSessionThreadCreatedEvent | ManagedAgentsSpanOutcomeEvaluationStartEvent | ManagedAgentsSpanOutcomeEvaluationEndEvent | ManagedAgentsSpanModelRequestStartEvent | ManagedAgentsSpanModelRequestEndEvent | ManagedAgentsSpanOutcomeEvaluationOngoingEvent | ManagedAgentsUserDefineOutcomeEvent | ManagedAgentsSessionDeletedEvent | ManagedAgentsSessionThreadStatusRunningEvent | ManagedAgentsSessionThreadStatusIdleEvent | ManagedAgentsSessionThreadStatusTerminatedEvent | ManagedAgentsUserToolResultEvent | ManagedAgentsSessionThreadStatusRescheduledEvent | ManagedAgentsSessionUpdatedEvent | ManagedAgentsStartEvent | ManagedAgentsDeltaEvent | ManagedAgentsSystemMessageEvent | ManagedAgentsSessionUsageEvent; +export type ManagedAgentsStreamSessionEventsUnion = ManagedAgentsUserMessageEvent | ManagedAgentsUserInterruptEvent | ManagedAgentsUserToolConfirmationEvent | ManagedAgentsUserCustomToolResultEvent | ManagedAgentsAgentCustomToolUseEvent | ManagedAgentsAgentMessageEvent | ManagedAgentsAgentThinkingEvent | ManagedAgentsAgentMCPToolUseEvent | ManagedAgentsAgentMCPToolResultEvent | ManagedAgentsAgentToolUseEvent | ManagedAgentsAgentToolResultEvent | ManagedAgentsAgentThreadMessageReceivedEvent | ManagedAgentsAgentThreadMessageSentEvent | ManagedAgentsAgentThreadContextCompactedEvent | ManagedAgentsSessionErrorEvent | ManagedAgentsSessionStatusRescheduledEvent | ManagedAgentsSessionStatusRunningEvent | ManagedAgentsSessionStatusIdleEvent | ManagedAgentsSessionStatusTerminatedEvent | ManagedAgentsSessionThreadCreatedEvent | ManagedAgentsSpanOutcomeEvaluationStartEvent | ManagedAgentsSpanOutcomeEvaluationEndEvent | ManagedAgentsSpanModelRequestStartEvent | ManagedAgentsSpanModelRequestEndEvent | ManagedAgentsSpanOutcomeEvaluationOngoingEvent | ManagedAgentsUserDefineOutcomeEvent | ManagedAgentsSessionDeletedEvent | ManagedAgentsSessionThreadStatusRunningEvent | ManagedAgentsSessionThreadStatusIdleEvent | ManagedAgentsSessionThreadStatusTerminatedEvent | ManagedAgentsUserToolResultEvent | ManagedAgentsSessionThreadStatusRescheduledEvent | ManagedAgentsSessionUpdatedEvent | ManagedAgentsStartEvent | ManagedAgentsDeltaEvent | ManagedAgentsSystemMessageEvent | ManagedAgentsSessionUsageEvent | ManagedAgentsAgentArtifactDeliveredEvent; export type ManagedAgentsStreamSessionEventsUnionContent = Array | Array | Array | Array | Array | Array | Array | Array | Array; @@ -9350,6 +9371,8 @@ export type ManagedAgentsTextRubricParamsType = "text"; * `retry_status` and `message` alone. */ export interface ManagedAgentsUnknownError { + /** Diagnostic only; use retry_status to determine retry behavior. */ + qoder_error_code?: string; /** * Human-readable error description. */ @@ -10004,11 +10027,11 @@ export type ManagedAgentsMemoryStoreResourceType = "memory_store"; */ export type ManagedAgentsMemoryStoreResourceAccess = "read_write" | "read_only"; -export type ManagedAgentsSessionResourceUnion = ManagedAgentsGitHubRepositoryResource | ManagedAgentsFileResource | ManagedAgentsMemoryStoreResource; +export type ManagedAgentsSessionResourceUnion = ManagedAgentsGitRepositoryResource | ManagedAgentsGitHubRepositoryResource | ManagedAgentsFileResource | ManagedAgentsMemoryStoreResource; -export type SessionResourceGetResponseUnion = ManagedAgentsGitHubRepositoryResource | ManagedAgentsFileResource | ManagedAgentsMemoryStoreResource; +export type SessionResourceGetResponseUnion = ManagedAgentsGitRepositoryResource | ManagedAgentsGitHubRepositoryResource | ManagedAgentsFileResource | ManagedAgentsMemoryStoreResource; -export type SessionResourceUpdateResponseUnion = ManagedAgentsGitHubRepositoryResource | ManagedAgentsFileResource | ManagedAgentsMemoryStoreResource; +export type SessionResourceUpdateResponseUnion = ManagedAgentsGitRepositoryResource | ManagedAgentsGitHubRepositoryResource | ManagedAgentsFileResource | ManagedAgentsMemoryStoreResource; export interface SessionResourceGetParams { session_id: string; @@ -10023,8 +10046,8 @@ export interface SessionResourceUpdateParams { password?: string | null; session_id: string; /** - * New authorization token for the resource. Currently only `github_repository` - * resources support token rotation. + * GitHub access token; also accepted for legacy generic Git clients. + * For generic Git, prefer password and do not send conflicting credentials. */ authorization_token?: string | null; workspace_id?: string; @@ -10131,9 +10154,9 @@ export interface ManagedAgentsSessionThread { */ updated_at: string; /** - * Cumulative token usage for a session thread across all turns. + * @deprecated Legacy usage; current Managed Thread responses omit this field. */ - usage: ManagedAgentsSessionThreadUsage; + usage?: ManagedAgentsSessionThreadUsage; } export type ManagedAgentsSessionThreadAgentUnion = ManagedAgentsSessionThreadAgent | ManagedAgentsAdvisor; @@ -10221,7 +10244,7 @@ export interface ManagedAgentsSessionThreadUsage { server_tool_use?: ManagedAgentsServerToolUsage | null; } -export type ManagedAgentsStreamSessionThreadEventsUnion = ManagedAgentsUserMessageEvent | ManagedAgentsUserInterruptEvent | ManagedAgentsUserToolConfirmationEvent | ManagedAgentsUserCustomToolResultEvent | ManagedAgentsAgentCustomToolUseEvent | ManagedAgentsAgentMessageEvent | ManagedAgentsAgentThinkingEvent | ManagedAgentsAgentMCPToolUseEvent | ManagedAgentsAgentMCPToolResultEvent | ManagedAgentsAgentToolUseEvent | ManagedAgentsAgentToolResultEvent | ManagedAgentsAgentThreadMessageReceivedEvent | ManagedAgentsAgentThreadMessageSentEvent | ManagedAgentsAgentThreadContextCompactedEvent | ManagedAgentsSessionErrorEvent | ManagedAgentsSessionStatusRescheduledEvent | ManagedAgentsSessionStatusRunningEvent | ManagedAgentsSessionStatusIdleEvent | ManagedAgentsSessionStatusTerminatedEvent | ManagedAgentsSessionThreadCreatedEvent | ManagedAgentsSpanOutcomeEvaluationStartEvent | ManagedAgentsSpanOutcomeEvaluationEndEvent | ManagedAgentsSpanModelRequestStartEvent | ManagedAgentsSpanModelRequestEndEvent | ManagedAgentsSpanOutcomeEvaluationOngoingEvent | ManagedAgentsUserDefineOutcomeEvent | ManagedAgentsSessionDeletedEvent | ManagedAgentsSessionThreadStatusRunningEvent | ManagedAgentsSessionThreadStatusIdleEvent | ManagedAgentsSessionThreadStatusTerminatedEvent | ManagedAgentsUserToolResultEvent | ManagedAgentsSessionThreadStatusRescheduledEvent | ManagedAgentsSessionUpdatedEvent | ManagedAgentsStartEvent | ManagedAgentsDeltaEvent | ManagedAgentsSystemMessageEvent | ManagedAgentsSessionUsageEvent; +export type ManagedAgentsStreamSessionThreadEventsUnion = ManagedAgentsUserMessageEvent | ManagedAgentsUserInterruptEvent | ManagedAgentsUserToolConfirmationEvent | ManagedAgentsUserCustomToolResultEvent | ManagedAgentsAgentCustomToolUseEvent | ManagedAgentsAgentMessageEvent | ManagedAgentsAgentThinkingEvent | ManagedAgentsAgentMCPToolUseEvent | ManagedAgentsAgentMCPToolResultEvent | ManagedAgentsAgentToolUseEvent | ManagedAgentsAgentToolResultEvent | ManagedAgentsAgentThreadMessageReceivedEvent | ManagedAgentsAgentThreadMessageSentEvent | ManagedAgentsAgentThreadContextCompactedEvent | ManagedAgentsSessionErrorEvent | ManagedAgentsSessionStatusRescheduledEvent | ManagedAgentsSessionStatusRunningEvent | ManagedAgentsSessionStatusIdleEvent | ManagedAgentsSessionStatusTerminatedEvent | ManagedAgentsSessionThreadCreatedEvent | ManagedAgentsSpanOutcomeEvaluationStartEvent | ManagedAgentsSpanOutcomeEvaluationEndEvent | ManagedAgentsSpanModelRequestStartEvent | ManagedAgentsSpanModelRequestEndEvent | ManagedAgentsSpanOutcomeEvaluationOngoingEvent | ManagedAgentsUserDefineOutcomeEvent | ManagedAgentsSessionDeletedEvent | ManagedAgentsSessionThreadStatusRunningEvent | ManagedAgentsSessionThreadStatusIdleEvent | ManagedAgentsSessionThreadStatusTerminatedEvent | ManagedAgentsUserToolResultEvent | ManagedAgentsSessionThreadStatusRescheduledEvent | ManagedAgentsSessionUpdatedEvent | ManagedAgentsStartEvent | ManagedAgentsDeltaEvent | ManagedAgentsSystemMessageEvent | ManagedAgentsSessionUsageEvent | ManagedAgentsAgentArtifactDeliveredEvent; export type ManagedAgentsStreamSessionThreadEventsUnionContent = Array | Array | Array | Array | Array | Array | Array | Array | Array; @@ -10384,7 +10407,7 @@ export interface Skill { * ID of the newest Skill Version — what `latest` references resolve to. Always * set: a Skill holds at least one version. */ - latest_version: string; + latest_version: string | null; /** * Where the Skill comes from. * @@ -11625,3 +11648,84 @@ export interface DeploymentScopedRunListParams { export interface DeploymentScopedRunRetrieveParams extends DeploymentRunRetrieveParams { deployment_id: string; } + +export interface ManagedAgentsGitRepositoryResourceParams { + /** + * Password or access token; include the username in the repository URL. + */ + password?: string; + /** + * Any of "git_repository". + */ + type: ManagedAgentsGitRepositoryResourceParamsType; + /** + * HTTP(S) Git URL of the repository + */ + url: string; + /** + * Mount path in the container. Derived from the repository name when omitted. + */ + mount_path?: string | null; + /** + * Branch or commit to check out. Defaults to the repository's default branch. + */ + checkout?: ManagedAgentsGitRepositoryResourceParamsCheckoutUnion | null; +} + +export type ManagedAgentsGitRepositoryResourceParamsType = "git_repository"; +export type ManagedAgentsGitRepositoryResourceParamsCheckoutUnion = ManagedAgentsGitHubRepositoryResourceParamsCheckoutUnion; + +export interface ManagedAgentsGitRepositoryResource { + id: string; + /** + * A timestamp in RFC 3339 format + */ + created_at: string; + mount_path: string; + /** + * Any of "git_repository". + */ + type: ManagedAgentsGitRepositoryResourceType; + /** + * A timestamp in RFC 3339 format + */ + updated_at: string; + url: string; + checkout?: ManagedAgentsGitRepositoryResourceCheckoutUnion | null; +} + +export type ManagedAgentsGitRepositoryResourceType = "git_repository"; +export type ManagedAgentsGitRepositoryResourceCheckoutUnion = ManagedAgentsGitHubRepositoryResourceCheckoutUnion; + +export interface ManagedAgentsGitRepositoryResourceConfig { + /** + * Any of "git_repository". + */ + type: ManagedAgentsGitRepositoryResourceConfigType; + /** + * HTTP(S) Git URL of the repository + */ + url: string; + /** + * Branch or commit to check out. Defaults to the repository's default branch. + */ + checkout?: ManagedAgentsGitRepositoryResourceConfigCheckoutUnion | null; + /** + * Mount path in the container. Derived from the repository name when omitted. + */ + mount_path?: string | null; +} + +export type ManagedAgentsGitRepositoryResourceConfigType = "git_repository"; +export type ManagedAgentsGitRepositoryResourceConfigCheckoutUnion = ManagedAgentsGitHubRepositoryResourceConfigCheckoutUnion; + +/** A server-generated event for one successfully delivered artifact file. */ +export interface ManagedAgentsAgentArtifactDeliveredEvent { + id: string; + type: "agent.artifact_delivered"; + file_id: string; + original_filename: string; + size: number; + content_type: string; + processed_at?: string; +} diff --git a/src/version.ts b/src/version.ts index d956404..0664804 100644 --- a/src/version.ts +++ b/src/version.ts @@ -3,4 +3,4 @@ // describe a version that was never published; `npm run build` compares the two. // Declared here rather than imported from package.json so bundlers do not have to // resolve JSON from outside src/. -export const VERSION = '0.7.0'; +export const VERSION = '0.8.0'; diff --git a/tests/contract-alignment-080.test.mjs b/tests/contract-alignment-080.test.mjs new file mode 100644 index 0000000..ac0b514 --- /dev/null +++ b/tests/contract-alignment-080.test.mjs @@ -0,0 +1,83 @@ +import assert from 'node:assert/strict'; +import test from 'node:test'; +import { readFileSync } from 'node:fs'; +import { testClient, response } from './helpers.mjs'; + +// Existing API contracts from docs.qoder.com/cloud-agents/api, 2026-10-20. +const fixture = JSON.parse(readFileSync(new URL('./fixtures/contract-alignment-0.8.json', import.meta.url))); + +test('Forward limits preserve omission/null, Batch preserves false, search is a query', async () => { + const calls = []; + const client = testClient('forward', async req => { + const body = req.method === 'GET' ? undefined : await req.json(); + calls.push({ req, body }); + if (req.method === 'GET') { + assert.equal(new URL(req.url).searchParams.get('search'), 'report & 中文'); + return response({ data: [], has_more: false }); + } + return response(body); + }); + for (const limits of [{}, { max_tool_rounds: null }, { max_tool_rounds: 3 }]) { + const base = { name: 'sdk-contract', model: 'model', environment_id: 'env_one' }; + await client.templates.create({ ...base, ...limits }); + assert.deepEqual(calls.at(-1).body, { ...base, ...limits }); + await client.templates.update('tmpl_one', limits); + assert.deepEqual(calls.at(-1).body, limits); + } + for (const flag of [{}, { ignore_idle_window: false }, { ignore_idle_window: true }]) { + const body = { input_file_id: 'file_one', completion_window: '24h', ...flag }; + await client.batches.create(body); + assert.deepEqual(calls.at(-1).body, body); + } + await client.sessions.list({ search: 'report & 中文' }); +}); + +test('MemoryStore create plus mount replays one operation with the same key and body', async () => { + let count = 0; + const client = testClient('forward', async req => { + count++; + assert.equal(new URL(req.url).pathname, '/api/v1/forward/memory_stores'); + assert.equal(req.headers.get('Idempotency-Key'), 'mount-one'); + assert.deepEqual(await req.json(), { name: 'sdk-contract', mount: fixture.mount }); + return response({ id: 'mem_one' }); + }); + for (let i = 0; i < 2; i++) await client.memoryStores.create({ name: 'sdk-contract', mount: fixture.mount, idempotency_key: 'mount-one' }); + assert.equal(count, 2); +}); + +test('Managed Session/Deployment Git resources and self-hosted setup script reach the wire', async () => { + const calls = []; + const client = testClient('managed', async req => { + calls.push(await req.json()); + return response({ id: 'contract_one' }); + }); + const resources = [fixture.git, fixture.github]; + await client.sessions.create({ agent: 'agent_one', environment_id: 'env_one', resources }); + assert.deepEqual(calls.at(-1).resources, resources); + await client.deployments.create({ agent: 'agent_one', environment_id: 'env_one', name: 'sdk-contract', initial_events: [], resources }); + assert.deepEqual(calls.at(-1).resources, resources); + await client.deployments.update('dep_one', { resources }); + assert.deepEqual(calls.at(-1), { resources }); + const config = fixture.environment.config; + await client.environments.create({ name: 'sdk-contract', config }); + assert.deepEqual(calls.at(-1), { name: 'sdk-contract', config }); + await client.environments.update('env_one', { config }); + assert.deepEqual(calls.at(-1), { config }); + await client.sessions.resources.update('sesr_one', { session_id: 'sess_one', password: ' token with spaces ' }); + assert.deepEqual(calls.at(-1), { password: ' token with spaces ' }); +}); + +test('Managed artifact fields and diagnostics survive history and both SSE paths', async () => { + const events = fixture.events; + const client = testClient('managed', req => req.url.endsWith('/stream') + ? new Response(events.map(e => `id: ${e.id}\nevent: ${e.type}\ndata: ${JSON.stringify(e)}\n\n`).join(''), { headers: { 'content-type': 'text/event-stream' } }) + : response({ data: events, has_more: false })); + assert.deepEqual((await client.sessions.events.list('sess_one')).data, events); + for (const stream of [ + await client.sessions.events.streamEvents('sess_one'), + await client.sessions.threads.events.streamEvents('sthr_one', { session_id: 'sess_one' }), + ]) { + const items = []; for await (const event of stream) items.push(event); + assert.deepEqual(items, events); + } +}); diff --git a/tests/fixtures/contract-alignment-0.8.json b/tests/fixtures/contract-alignment-0.8.json new file mode 100644 index 0000000..53b2050 --- /dev/null +++ b/tests/fixtures/contract-alignment-0.8.json @@ -0,0 +1,120 @@ +{ + "source": "https://docs.qoder.com/cloud-agents/api/sessions/schemas", + "retrieved_at": "2026-10-20", + "git": { + "type": "git_repository", + "url": "https://user@git.example.test/team/repo.git", + "password": "contract-placeholder", + "mount_path": "/repos/demo", + "checkout": { + "type": "branch", + "name": "main" + } + }, + "github": { + "type": "github_repository", + "url": "https://github.com/QoderAI/forward-quickstart" + }, + "mount": { + "identity_id": "idn_one", + "template_id": "tmpl_one", + "access": "read_write" + }, + "environment": { + "id": "env_one", + "config": { + "type": "self_hosted", + "setup_script": "echo sdk-contract" + }, + "icon_url": null, + "binding_info": { + "agent_template_count": 0 + } + }, + "session": { + "id": "sess_one", + "outcome_evaluations": [ + { + "type": "outcome_evaluation", + "outcome_id": "out_one", + "description": "Deliver report", + "iteration": 0, + "result": "pending", + "explanation": null, + "completed_at": null + } + ] + }, + "thread": { + "id": "sthr_one", + "stats": { + "active_seconds": 0, + "duration_seconds": 0, + "startup_seconds": 0 + }, + "usage": { + "total_credits": 0 + } + }, + "schedule": { + "id": "sch_one", + "source": "api", + "source_session_id": null, + "initial_events_version": 2, + "trigger_policy": { + "type": "cron", + "expression": "0 * * * *", + "timezone": "UTC", + "start_at": "2026-10-20T00:00:00Z", + "stop_at": "2026-10-21T00:00:00Z", + "last_run_at": null + } + }, + "run": { + "id": "run_one", + "source": "tool", + "source_session_id": "sess_one" + }, + "memory_store": { + "id": "mem_one", + "status": "active", + "entry_count": 0, + "total_size": 0 + }, + "dream": { + "id": "dream_one", + "outputs": [ + { + "type": "memory_store", + "memory_store_id": "mem_one", + "files_touched": [ + "notes.md", + "summary.md" + ] + } + ] + }, + "events": [ + { + "id": "evt_artifact", + "type": "agent.artifact_delivered", + "file_id": "file_one", + "original_filename": "report.txt", + "size": 0, + "content_type": "text/plain", + "processed_at": "2026-10-20T00:00:00Z" + }, + { + "id": "evt_error", + "type": "session.error", + "error": { + "type": "model_request_failed_error", + "message": "Contract fixture", + "qoder_error_code": "TEST_DIAGNOSTIC", + "retry_status": { + "type": "terminal" + } + } + } + ] +} diff --git a/tests/managed-types.ts b/tests/managed-types.ts index 6e89721..d8c25a6 100644 --- a/tests/managed-types.ts +++ b/tests/managed-types.ts @@ -1,5 +1,24 @@ // Canonical documented request-body fixtures must remain assignable to public wire types. import type * as M from '../src/managed/types.js'; +const genericGit080: M.ManagedAgentsGitRepositoryResourceParams = { type: 'git_repository', url: 'https://git.example.test/repo.git', password: 'contract-placeholder', checkout: { type: 'branch', name: 'main' } }; +const publicGithub080: M.ManagedAgentsGitHubRepositoryResourceParams = { type: 'github_repository', url: 'https://github.com/QoderAI/forward-quickstart' }; +const resources080: M.SessionNewParams = { agent: 'agent_one', environment_id: 'env_one', resources: [genericGit080, publicGithub080] }; +const deployment080: M.DeploymentUpdateParams = { resources: [genericGit080, publicGithub080] }; +const setup080: M.EnvironmentNewParams = { name: 'sdk-contract', config: { type: 'self_hosted', setup_script: 'echo sdk-contract' } }; +const artifact080: M.ManagedAgentsAgentArtifactDeliveredEvent = { id: 'evt', type: 'agent.artifact_delivered', file_id: 'file', original_filename: 'report.txt', size: 0, content_type: 'text/plain' }; +const latest080: M.Skill['latest_version'] = null; +const withoutUsage080: Pick = { id: 'sthr' }; +function typedResponses080(event: M.ManagedAgentsSessionEventUnion, stream: M.ManagedAgentsStreamSessionEventsUnion, threadStream: M.ManagedAgentsStreamSessionThreadEventsUnion, memory: M.ManagedAgentsMemoryStore, dream: M.Dream) { + for (const item of [event, stream, threadStream]) { + if (item.type === 'agent.artifact_delivered') { const size: number = item.size; void size; } + if (item.type === 'session.error') { const code: string | undefined = item.error.qoder_error_code; void code; } + } + const status: string | undefined = memory.status; + const entries: number | undefined = memory.entry_count; + const files: string[] | undefined = dream.outputs[0]?.files_touched; + void [status, entries, files]; +} +void [resources080, deployment080, setup080, artifact080, latest080, withoutUsage080, typedResponses080]; const request0: M.AgentCreateParams = {"name": "doc-test-agent", "model": "ultimate", "system": "You are a documentation testing assistant.", "tools": [{"type": "agent_toolset_20260401", "enabled_tools": ["Bash", "Read", "Write", "Edit", "Glob", "Grep", "WebFetch", "WebSearch"]}], "mcp_servers": [{"type": "url", "name": "weather-service", "url": "https://mcp.example.com/mcp"}]}; const request1: M.AgentCreateParams = {"name": "doc-test-agent-tuned", "model": {"id": "ultimate", "effort": "high", "context_window": 400000}, "system": "You are a documentation testing assistant."}; const request2: M.AgentUpdateParams = {"name": "doc-test-agent-updated", "model": "ultimate", "system": "You are an updated documentation testing assistant.", "description": "Used for API documentation testing", "version": 1}; diff --git a/tests/types-smoke.ts b/tests/types-smoke.ts index b87579f..4edb2b1 100644 --- a/tests/types-smoke.ts +++ b/tests/types-smoke.ts @@ -235,3 +235,32 @@ async function ownershipAndPairingTypes() { void credits; } void ownershipAndPairingTypes; + +import type * as F080 from 'qca-sdk/forward'; +async function alignment080Types() { + await forward.templates.update('tmpl', { max_tool_rounds: null }); + await forward.templates.update('tmpl', { max_tool_rounds: 3 }); + await forward.batches.create({ input_file_id: 'file', completion_window: '24h', ignore_idle_window: false }); + // @ts-expect-error Batch opt-out is boolean, never null. + forward.batches.create({ input_file_id: 'file', completion_window: '24h', ignore_idle_window: null }); + await forward.sessions.list({ search: 'report & 中文' }); + await forward.memoryStores.create({ name: 'sdk-contract', idempotency_key: 'mount-one', mount: { identity_id: 'idn', template_id: 'tmpl', access: 'read_write' } }); + // @ts-expect-error A mount requires its template and identity. + forward.memoryStores.create({ name: 'sdk-contract', idempotency_key: 'mount-one', mount: { identity_id: 'idn' } }); + const session = await forward.sessions.retrieve('sess'); + const evaluations: F080.SessionOutcomeEvaluation[] | undefined = session.outcome_evaluations; + const thread = await forward.sessions.threads.retrieve('sess', 'sthr'); + const credits: number | undefined = thread.usage?.total_credits; + const startup: number | undefined = thread.stats?.startup_seconds; + const schedule = await forward.schedules.retrieve('sch'); + const source: string | undefined = schedule.source; + const sourceSession: string | null | undefined = schedule.source_session_id; + const version: number | undefined = schedule.initial_events_version; + const lastRun: string | null | undefined = schedule.trigger_policy.last_run_at; + const env = await forward.environments.retrieve('env'); + const setup: string | undefined = env.config.setup_script; + const count: number | undefined = env.binding_info?.agent_template_count; + const latest: F080.Skill['latest_version'] = null; + void [evaluations, credits, startup, source, sourceSession, version, lastRun, setup, count, latest]; +} +void alignment080Types;