Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 17 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
5 changes: 5 additions & 0 deletions docs/api/forward/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand Down Expand Up @@ -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)
Expand Down Expand Up @@ -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)
Expand All @@ -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)
Expand Down
14 changes: 14 additions & 0 deletions docs/api/forward/interfaces/Batch.md
Original file line number Diff line number Diff line change
Expand Up @@ -94,6 +94,12 @@ Batch ID,前缀 `batch_`。

***

### ignore\_idle\_window?

> `optional` **ignore\_idle\_window?**: `boolean`

***

### input\_file\_id

> **input\_file\_id**: `string`
Expand Down Expand Up @@ -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)
Expand Down
8 changes: 8 additions & 0 deletions docs/api/forward/interfaces/BatchNewParams.md
Original file line number Diff line number Diff line change
Expand Up @@ -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`
Expand Down
12 changes: 12 additions & 0 deletions docs/api/forward/interfaces/Environment.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand All @@ -38,6 +44,12 @@ Additional fields are preserved verbatim by the SDK.

***

### icon\_url?

> `optional` **icon\_url?**: `string` \| `null`

***

### id

> **id**: `string`
Expand Down
13 changes: 13 additions & 0 deletions docs/api/forward/interfaces/EnvironmentBindingInfo.md
Original file line number Diff line number Diff line change
@@ -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`
6 changes: 6 additions & 0 deletions docs/api/forward/interfaces/EnvironmentConfig.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,12 @@ Additional fields are preserved verbatim by the SDK.

***

### setup\_script?

> `optional` **setup\_script?**: `string`

***

### type

> **type**: `string`
27 changes: 27 additions & 0 deletions docs/api/forward/interfaces/MemoryStoreCreateMountParam.md
Original file line number Diff line number Diff line change
@@ -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`
8 changes: 8 additions & 0 deletions docs/api/forward/interfaces/MemoryStoreNewParams.md
Original file line number Diff line number Diff line change
Expand Up @@ -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`
Expand Down
20 changes: 20 additions & 0 deletions docs/api/forward/interfaces/Schedule.md
Original file line number Diff line number Diff line change
Expand Up @@ -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`\>
Expand All @@ -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`
Expand Down
20 changes: 20 additions & 0 deletions docs/api/forward/interfaces/ScheduleRun.md
Original file line number Diff line number Diff line change
Expand Up @@ -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`
Expand Down Expand Up @@ -126,6 +134,18 @@ null|本次执行创建或使用的 Session。

***

### source?

> `optional` **source?**: `string`

***

### source\_session\_id?

> `optional` **source\_session\_id?**: `string` \| `null`

***

### started\_at

> **started\_at**: `string`
Expand Down
18 changes: 18 additions & 0 deletions docs/api/forward/interfaces/ScheduleTriggerPolicy.md
Original file line number Diff line number Diff line change
Expand Up @@ -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`
Expand Down
6 changes: 6 additions & 0 deletions docs/api/forward/interfaces/Session.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,6 +54,12 @@ Forward Identity ID。

***

### outcome\_evaluations?

> `optional` **outcome\_evaluations?**: [`SessionOutcomeEvaluation`](SessionOutcomeEvaluation.md)[]

***

### resources

> **resources**: [`SessionResource`](SessionResource.md)[]
Expand Down
8 changes: 8 additions & 0 deletions docs/api/forward/interfaces/SessionListParams.md
Original file line number Diff line number Diff line change
Expand Up @@ -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`
Expand Down
49 changes: 49 additions & 0 deletions docs/api/forward/interfaces/SessionOutcomeEvaluation.md
Original file line number Diff line number Diff line change
@@ -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`
12 changes: 12 additions & 0 deletions docs/api/forward/interfaces/SessionThread.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,6 +62,12 @@ Additional fields are preserved verbatim by the SDK.

***

### stats?

> `optional` **stats?**: [`SessionThreadStats`](SessionThreadStats.md)

***

### status

> **status**: `string`
Expand Down Expand Up @@ -89,3 +95,9 @@ Additional fields are preserved verbatim by the SDK.
### updated\_at

> **updated\_at**: `string`

***

### usage?

> `optional` **usage?**: [`SessionThreadUsage`](SessionThreadUsage.md)
Loading
Loading