@runtypelabs/sdk 10.1.2 → 10.1.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.cjs +5 -2
- package/dist/index.d.cts +62 -11
- package/dist/index.d.ts +62 -11
- package/dist/index.mjs +5 -2
- package/package.json +2 -2
package/dist/index.cjs
CHANGED
|
@@ -13854,7 +13854,10 @@ var Runtype = class {
|
|
|
13854
13854
|
}
|
|
13855
13855
|
/**
|
|
13856
13856
|
* Runs namespace - the one list of agent and flow runs, read from the span
|
|
13857
|
-
* store.
|
|
13857
|
+
* store. Each row states two separate facts: `origin` (who dispatched, from
|
|
13858
|
+
* the caller's principal; `test` is its deprecated alias) and `storeResults`
|
|
13859
|
+
* (whether the transcript was kept). A run that wrote no control-plane row
|
|
13860
|
+
* is still listed.
|
|
13858
13861
|
*
|
|
13859
13862
|
* @example
|
|
13860
13863
|
* ```typescript
|
|
@@ -14146,7 +14149,7 @@ function transformQueryParams(params) {
|
|
|
14146
14149
|
|
|
14147
14150
|
// src/version.ts
|
|
14148
14151
|
var FALLBACK_VERSION = "0.0.0";
|
|
14149
|
-
var SDK_VERSION = "10.1.
|
|
14152
|
+
var SDK_VERSION = "10.1.4".length > 0 ? "10.1.4" : FALLBACK_VERSION;
|
|
14150
14153
|
var RUNTYPE_CLIENT_KIND = "sdk";
|
|
14151
14154
|
var SDK_USER_AGENT = `runtype-sdk/${SDK_VERSION} (typescript)`;
|
|
14152
14155
|
|
package/dist/index.d.cts
CHANGED
|
@@ -25206,6 +25206,8 @@ interface paths {
|
|
|
25206
25206
|
content: {
|
|
25207
25207
|
"application/json": {
|
|
25208
25208
|
data: {
|
|
25209
|
+
/** @description True when the historical segment was served by the flat fallback plan because the deduplicating one was rejected, so a re-sent delivery can appear more than once. Absent on healthy responses. */
|
|
25210
|
+
dedupeFallback?: boolean;
|
|
25209
25211
|
/** @description True when part of the window could not be read, so entries may be missing. Evicted ordinary rows are recovered from R2 when old enough; receipt-backed recovery remains degraded when source time cannot prove ingestion. Absent on healthy responses. */
|
|
25210
25212
|
degraded?: boolean;
|
|
25211
25213
|
entries: {
|
|
@@ -25494,6 +25496,8 @@ interface paths {
|
|
|
25494
25496
|
byType: {
|
|
25495
25497
|
[key: string]: number;
|
|
25496
25498
|
};
|
|
25499
|
+
/** @description True when counts came from the flat fallback plan because the deduplicating one was rejected, so a re-sent delivery can be counted more than once. Such a response is never cached. Absent on healthy responses. */
|
|
25500
|
+
dedupeFallback?: boolean;
|
|
25497
25501
|
/** @description True when part of the window could not be read, so counts may be partial. Evicted ordinary rows are counted from R2 when old enough; receipt-backed recovery remains degraded when source time cannot prove ingestion. Absent on healthy responses, which are the only ones cached. */
|
|
25498
25502
|
degraded?: boolean;
|
|
25499
25503
|
histogram: {
|
|
@@ -30820,9 +30824,11 @@ interface paths {
|
|
|
30820
30824
|
fidelityTier: string | null;
|
|
30821
30825
|
/** @description Flow that ran. */
|
|
30822
30826
|
flowId: string | null;
|
|
30827
|
+
/** @description True when the dispatch carried a complete inline agent definition (name and model) beside or instead of an agentId, so the run executed that inline config and no stored version; such a row stamps no agentVersionId. False when the run executed the saved definition by reference. NULL when the header states nothing: a flow run, a lane that resolves no agent definition, or a row that predates the field. */
|
|
30828
|
+
inlineDefinition: boolean | null;
|
|
30823
30829
|
/** @description Messages the run started from. Absent means the overlay did not answer, which is not false and not null. */
|
|
30824
30830
|
inputMessages?: unknown;
|
|
30825
|
-
/** @description The run's first user message, secret-scrubbed and cut to 160 characters, so a list can say what a run was asked to do without reading content. Absent means no input text is recorded for this run, which is not an empty message: the span store holds no run-level input at all, so a run with no control-plane row (a flow leg, a storeResults:false
|
|
30831
|
+
/** @description The run's first user message, secret-scrubbed and cut to 160 characters, so a list can say what a run was asked to do without reading content. Absent means no input text is recorded for this run, which is not an empty message: the span store holds no run-level input at all, so a run with no control-plane row (a flow leg, a storeResults:false run) has none. */
|
|
30826
30832
|
inputPreview?: string | null;
|
|
30827
30833
|
/** @description Input tokens reported. */
|
|
30828
30834
|
inputTokens: number | null;
|
|
@@ -30835,6 +30841,11 @@ interface paths {
|
|
|
30835
30841
|
kind: "agent" | "flow";
|
|
30836
30842
|
/** @description Last heartbeat. Absent means the overlay did not answer, which is not false and not null. */
|
|
30837
30843
|
lastHeartbeatAt?: string | null;
|
|
30844
|
+
/**
|
|
30845
|
+
* @description Where the run was dispatched from, taken from the caller's authenticated principal and never from a request field: dashboard for a Clerk session, api for a management API key, internal for a Runtype worker. NULL means the header states nothing about it, which is not "unknown caller": headers written before this field shipped, lanes that never see an auth principal, and every backfilled row carry no origin stamp.
|
|
30846
|
+
* @enum {string|null}
|
|
30847
|
+
*/
|
|
30848
|
+
origin: "dashboard" | "api" | "internal" | null;
|
|
30838
30849
|
/** @description Framework identity the producer reported, for a versionless run group. Absent means the overlay did not answer, which is not false and not null. */
|
|
30839
30850
|
otelProducer?: unknown;
|
|
30840
30851
|
/** @description Output tokens reported. */
|
|
@@ -30871,11 +30882,16 @@ interface paths {
|
|
|
30871
30882
|
status: "queued" | "running" | "awaiting" | "completed" | "failed" | "cancelled";
|
|
30872
30883
|
/** @description Stop reason from the terminal frame. */
|
|
30873
30884
|
stopReason?: string | null;
|
|
30885
|
+
/** @description The persistence posture the dispatch declared. FALSE means the run wrote no control-plane row, no journal outputs and no span content, so a surface that reports a missing transcript keys on this and never on origin. NULL means the header states nothing, which is not "true": a lane that takes no such flag carries no stamp, and an ingested (OTLP) run declared none. A row served from the legacy control-plane lane answers true, because that row exists only when the run stored. */
|
|
30886
|
+
storeResults: boolean | null;
|
|
30874
30887
|
/** @description Product surface that entered this run. */
|
|
30875
30888
|
surfaceId: string | null;
|
|
30876
30889
|
/** @description Surface family (api, chat, webhook, schedule, ...). */
|
|
30877
30890
|
surfaceType: string | null;
|
|
30878
|
-
/**
|
|
30891
|
+
/**
|
|
30892
|
+
* @deprecated
|
|
30893
|
+
* @description DEPRECATED: a derived alias of origin, kept for one release — read origin instead. True when the run came from the dashboard, i.e. origin === "dashboard"; NULL exactly when origin is NULL. It is never derived from storeResults, which defaults to false across the whole flow lane and which an API caller sets for its own privacy reasons: reading it as "test" labelled production runs as tests. A run whose header predates origin therefore reads NULL rather than claiming either answer.
|
|
30894
|
+
*/
|
|
30879
30895
|
test: boolean | null;
|
|
30880
30896
|
/** @description Metered cost as a decimal string. */
|
|
30881
30897
|
totalCost: string | null;
|
|
@@ -40043,7 +40059,7 @@ interface paths {
|
|
|
40043
40059
|
};
|
|
40044
40060
|
/**
|
|
40045
40061
|
* List runs
|
|
40046
|
-
* @description Every agent and flow run in the span store, newest start first
|
|
40062
|
+
* @description Every agent and flow run in the span store, newest start first, including runs that write no control-plane row. Each row carries `origin` (dashboard | api | internal | null), read from the caller's authenticated principal, and `test` as its derived alias for `origin === "dashboard"`; both are null when the header states nothing. `overlay=live` adds live control-plane fields; the overlay never adds, drops or reorders a row. Returns 404 with `code: "run_history_unavailable"` when neither plane can serve the page, which a client renders as "no run history here" rather than as a failed read.
|
|
40047
40063
|
*/
|
|
40048
40064
|
get: {
|
|
40049
40065
|
parameters: {
|
|
@@ -50958,9 +50974,11 @@ interface components {
|
|
|
50958
50974
|
fidelityTier: string | null;
|
|
50959
50975
|
/** @description Flow that ran. */
|
|
50960
50976
|
flowId: string | null;
|
|
50977
|
+
/** @description True when the dispatch carried a complete inline agent definition (name and model) beside or instead of an agentId, so the run executed that inline config and no stored version; such a row stamps no agentVersionId. False when the run executed the saved definition by reference. NULL when the header states nothing: a flow run, a lane that resolves no agent definition, or a row that predates the field. */
|
|
50978
|
+
inlineDefinition: boolean | null;
|
|
50961
50979
|
/** @description Messages the run started from. Absent means the overlay did not answer, which is not false and not null. */
|
|
50962
50980
|
inputMessages?: unknown;
|
|
50963
|
-
/** @description The run's first user message, secret-scrubbed and cut to 160 characters, so a list can say what a run was asked to do without reading content. Absent means no input text is recorded for this run, which is not an empty message: the span store holds no run-level input at all, so a run with no control-plane row (a flow leg, a storeResults:false
|
|
50981
|
+
/** @description The run's first user message, secret-scrubbed and cut to 160 characters, so a list can say what a run was asked to do without reading content. Absent means no input text is recorded for this run, which is not an empty message: the span store holds no run-level input at all, so a run with no control-plane row (a flow leg, a storeResults:false run) has none. */
|
|
50964
50982
|
inputPreview?: string | null;
|
|
50965
50983
|
/** @description Input tokens reported. */
|
|
50966
50984
|
inputTokens: number | null;
|
|
@@ -50973,6 +50991,11 @@ interface components {
|
|
|
50973
50991
|
kind: "agent" | "flow";
|
|
50974
50992
|
/** @description Last heartbeat. Absent means the overlay did not answer, which is not false and not null. */
|
|
50975
50993
|
lastHeartbeatAt?: string | null;
|
|
50994
|
+
/**
|
|
50995
|
+
* @description Where the run was dispatched from, taken from the caller's authenticated principal and never from a request field: dashboard for a Clerk session, api for a management API key, internal for a Runtype worker. NULL means the header states nothing about it, which is not "unknown caller": headers written before this field shipped, lanes that never see an auth principal, and every backfilled row carry no origin stamp.
|
|
50996
|
+
* @enum {string|null}
|
|
50997
|
+
*/
|
|
50998
|
+
origin: "dashboard" | "api" | "internal" | null;
|
|
50976
50999
|
/** @description Framework identity the producer reported, for a versionless run group. Absent means the overlay did not answer, which is not false and not null. */
|
|
50977
51000
|
otelProducer?: unknown;
|
|
50978
51001
|
/** @description Output tokens reported. */
|
|
@@ -51009,11 +51032,16 @@ interface components {
|
|
|
51009
51032
|
status: "queued" | "running" | "awaiting" | "completed" | "failed" | "cancelled";
|
|
51010
51033
|
/** @description Stop reason from the terminal frame. */
|
|
51011
51034
|
stopReason?: string | null;
|
|
51035
|
+
/** @description The persistence posture the dispatch declared. FALSE means the run wrote no control-plane row, no journal outputs and no span content, so a surface that reports a missing transcript keys on this and never on origin. NULL means the header states nothing, which is not "true": a lane that takes no such flag carries no stamp, and an ingested (OTLP) run declared none. A row served from the legacy control-plane lane answers true, because that row exists only when the run stored. */
|
|
51036
|
+
storeResults: boolean | null;
|
|
51012
51037
|
/** @description Product surface that entered this run. */
|
|
51013
51038
|
surfaceId: string | null;
|
|
51014
51039
|
/** @description Surface family (api, chat, webhook, schedule, ...). */
|
|
51015
51040
|
surfaceType: string | null;
|
|
51016
|
-
/**
|
|
51041
|
+
/**
|
|
51042
|
+
* @deprecated
|
|
51043
|
+
* @description DEPRECATED: a derived alias of origin, kept for one release — read origin instead. True when the run came from the dashboard, i.e. origin === "dashboard"; NULL exactly when origin is NULL. It is never derived from storeResults, which defaults to false across the whole flow lane and which an API caller sets for its own privacy reasons: reading it as "test" labelled production runs as tests. A run whose header predates origin therefore reads NULL rather than claiming either answer.
|
|
51044
|
+
*/
|
|
51017
51045
|
test: boolean | null;
|
|
51018
51046
|
/** @description Metered cost as a decimal string. */
|
|
51019
51047
|
totalCost: string | null;
|
|
@@ -57909,9 +57937,29 @@ interface RunListRow {
|
|
|
57909
57937
|
totalCost: string | null;
|
|
57910
57938
|
selfReportedCost: string | null;
|
|
57911
57939
|
/**
|
|
57912
|
-
*
|
|
57913
|
-
*
|
|
57914
|
-
*
|
|
57940
|
+
* Where the run was dispatched from, taken from the caller's authenticated
|
|
57941
|
+
* principal and never from a request field. NULL means the header states
|
|
57942
|
+
* nothing about it: a lane that sees no principal, or a backfilled row.
|
|
57943
|
+
*/
|
|
57944
|
+
origin: 'dashboard' | 'api' | 'internal' | null;
|
|
57945
|
+
/**
|
|
57946
|
+
* The persistence posture the dispatch declared. `false` means the run kept no
|
|
57947
|
+
* control-plane row, no journal outputs and no span content, so a surface
|
|
57948
|
+
* reporting a missing transcript reads this and never `origin`.
|
|
57949
|
+
*/
|
|
57950
|
+
storeResults: boolean | null;
|
|
57951
|
+
/**
|
|
57952
|
+
* True when the dispatch carried a complete inline definition, so the run
|
|
57953
|
+
* executed that config and stamps no `agentVersionId`. False for a run of the
|
|
57954
|
+
* saved definition by reference. NULL when the header states nothing.
|
|
57955
|
+
*/
|
|
57956
|
+
inlineDefinition: boolean | null;
|
|
57957
|
+
/**
|
|
57958
|
+
* True when the run came from the dashboard (`origin === 'dashboard'`), such
|
|
57959
|
+
* as an editor test.
|
|
57960
|
+
* @deprecated Derived alias of `origin`; read `origin` instead. Kept for one
|
|
57961
|
+
* release. NULL exactly when `origin` is NULL, including on a run whose header
|
|
57962
|
+
* predates the field.
|
|
57915
57963
|
*/
|
|
57916
57964
|
test: boolean | null;
|
|
57917
57965
|
stopReason?: string | null;
|
|
@@ -57976,8 +58024,8 @@ interface RunListResponse {
|
|
|
57976
58024
|
}
|
|
57977
58025
|
/**
|
|
57978
58026
|
* Read-only namespace over `/v1/runs`, the one list of agent and flow runs.
|
|
57979
|
-
* A
|
|
57980
|
-
* rather than being absent.
|
|
58027
|
+
* A dashboard editor test is listed with `origin: 'dashboard'` (and its `test`
|
|
58028
|
+
* alias) rather than being absent.
|
|
57981
58029
|
*/
|
|
57982
58030
|
declare class RunsNamespace {
|
|
57983
58031
|
private readonly getClient;
|
|
@@ -58948,7 +58996,10 @@ declare class Runtype {
|
|
|
58948
58996
|
static get executions(): ExecutionsNamespace;
|
|
58949
58997
|
/**
|
|
58950
58998
|
* Runs namespace - the one list of agent and flow runs, read from the span
|
|
58951
|
-
* store.
|
|
58999
|
+
* store. Each row states two separate facts: `origin` (who dispatched, from
|
|
59000
|
+
* the caller's principal; `test` is its deprecated alias) and `storeResults`
|
|
59001
|
+
* (whether the transcript was kept). A run that wrote no control-plane row
|
|
59002
|
+
* is still listed.
|
|
58952
59003
|
*
|
|
58953
59004
|
* @example
|
|
58954
59005
|
* ```typescript
|
package/dist/index.d.ts
CHANGED
|
@@ -25206,6 +25206,8 @@ interface paths {
|
|
|
25206
25206
|
content: {
|
|
25207
25207
|
"application/json": {
|
|
25208
25208
|
data: {
|
|
25209
|
+
/** @description True when the historical segment was served by the flat fallback plan because the deduplicating one was rejected, so a re-sent delivery can appear more than once. Absent on healthy responses. */
|
|
25210
|
+
dedupeFallback?: boolean;
|
|
25209
25211
|
/** @description True when part of the window could not be read, so entries may be missing. Evicted ordinary rows are recovered from R2 when old enough; receipt-backed recovery remains degraded when source time cannot prove ingestion. Absent on healthy responses. */
|
|
25210
25212
|
degraded?: boolean;
|
|
25211
25213
|
entries: {
|
|
@@ -25494,6 +25496,8 @@ interface paths {
|
|
|
25494
25496
|
byType: {
|
|
25495
25497
|
[key: string]: number;
|
|
25496
25498
|
};
|
|
25499
|
+
/** @description True when counts came from the flat fallback plan because the deduplicating one was rejected, so a re-sent delivery can be counted more than once. Such a response is never cached. Absent on healthy responses. */
|
|
25500
|
+
dedupeFallback?: boolean;
|
|
25497
25501
|
/** @description True when part of the window could not be read, so counts may be partial. Evicted ordinary rows are counted from R2 when old enough; receipt-backed recovery remains degraded when source time cannot prove ingestion. Absent on healthy responses, which are the only ones cached. */
|
|
25498
25502
|
degraded?: boolean;
|
|
25499
25503
|
histogram: {
|
|
@@ -30820,9 +30824,11 @@ interface paths {
|
|
|
30820
30824
|
fidelityTier: string | null;
|
|
30821
30825
|
/** @description Flow that ran. */
|
|
30822
30826
|
flowId: string | null;
|
|
30827
|
+
/** @description True when the dispatch carried a complete inline agent definition (name and model) beside or instead of an agentId, so the run executed that inline config and no stored version; such a row stamps no agentVersionId. False when the run executed the saved definition by reference. NULL when the header states nothing: a flow run, a lane that resolves no agent definition, or a row that predates the field. */
|
|
30828
|
+
inlineDefinition: boolean | null;
|
|
30823
30829
|
/** @description Messages the run started from. Absent means the overlay did not answer, which is not false and not null. */
|
|
30824
30830
|
inputMessages?: unknown;
|
|
30825
|
-
/** @description The run's first user message, secret-scrubbed and cut to 160 characters, so a list can say what a run was asked to do without reading content. Absent means no input text is recorded for this run, which is not an empty message: the span store holds no run-level input at all, so a run with no control-plane row (a flow leg, a storeResults:false
|
|
30831
|
+
/** @description The run's first user message, secret-scrubbed and cut to 160 characters, so a list can say what a run was asked to do without reading content. Absent means no input text is recorded for this run, which is not an empty message: the span store holds no run-level input at all, so a run with no control-plane row (a flow leg, a storeResults:false run) has none. */
|
|
30826
30832
|
inputPreview?: string | null;
|
|
30827
30833
|
/** @description Input tokens reported. */
|
|
30828
30834
|
inputTokens: number | null;
|
|
@@ -30835,6 +30841,11 @@ interface paths {
|
|
|
30835
30841
|
kind: "agent" | "flow";
|
|
30836
30842
|
/** @description Last heartbeat. Absent means the overlay did not answer, which is not false and not null. */
|
|
30837
30843
|
lastHeartbeatAt?: string | null;
|
|
30844
|
+
/**
|
|
30845
|
+
* @description Where the run was dispatched from, taken from the caller's authenticated principal and never from a request field: dashboard for a Clerk session, api for a management API key, internal for a Runtype worker. NULL means the header states nothing about it, which is not "unknown caller": headers written before this field shipped, lanes that never see an auth principal, and every backfilled row carry no origin stamp.
|
|
30846
|
+
* @enum {string|null}
|
|
30847
|
+
*/
|
|
30848
|
+
origin: "dashboard" | "api" | "internal" | null;
|
|
30838
30849
|
/** @description Framework identity the producer reported, for a versionless run group. Absent means the overlay did not answer, which is not false and not null. */
|
|
30839
30850
|
otelProducer?: unknown;
|
|
30840
30851
|
/** @description Output tokens reported. */
|
|
@@ -30871,11 +30882,16 @@ interface paths {
|
|
|
30871
30882
|
status: "queued" | "running" | "awaiting" | "completed" | "failed" | "cancelled";
|
|
30872
30883
|
/** @description Stop reason from the terminal frame. */
|
|
30873
30884
|
stopReason?: string | null;
|
|
30885
|
+
/** @description The persistence posture the dispatch declared. FALSE means the run wrote no control-plane row, no journal outputs and no span content, so a surface that reports a missing transcript keys on this and never on origin. NULL means the header states nothing, which is not "true": a lane that takes no such flag carries no stamp, and an ingested (OTLP) run declared none. A row served from the legacy control-plane lane answers true, because that row exists only when the run stored. */
|
|
30886
|
+
storeResults: boolean | null;
|
|
30874
30887
|
/** @description Product surface that entered this run. */
|
|
30875
30888
|
surfaceId: string | null;
|
|
30876
30889
|
/** @description Surface family (api, chat, webhook, schedule, ...). */
|
|
30877
30890
|
surfaceType: string | null;
|
|
30878
|
-
/**
|
|
30891
|
+
/**
|
|
30892
|
+
* @deprecated
|
|
30893
|
+
* @description DEPRECATED: a derived alias of origin, kept for one release — read origin instead. True when the run came from the dashboard, i.e. origin === "dashboard"; NULL exactly when origin is NULL. It is never derived from storeResults, which defaults to false across the whole flow lane and which an API caller sets for its own privacy reasons: reading it as "test" labelled production runs as tests. A run whose header predates origin therefore reads NULL rather than claiming either answer.
|
|
30894
|
+
*/
|
|
30879
30895
|
test: boolean | null;
|
|
30880
30896
|
/** @description Metered cost as a decimal string. */
|
|
30881
30897
|
totalCost: string | null;
|
|
@@ -40043,7 +40059,7 @@ interface paths {
|
|
|
40043
40059
|
};
|
|
40044
40060
|
/**
|
|
40045
40061
|
* List runs
|
|
40046
|
-
* @description Every agent and flow run in the span store, newest start first
|
|
40062
|
+
* @description Every agent and flow run in the span store, newest start first, including runs that write no control-plane row. Each row carries `origin` (dashboard | api | internal | null), read from the caller's authenticated principal, and `test` as its derived alias for `origin === "dashboard"`; both are null when the header states nothing. `overlay=live` adds live control-plane fields; the overlay never adds, drops or reorders a row. Returns 404 with `code: "run_history_unavailable"` when neither plane can serve the page, which a client renders as "no run history here" rather than as a failed read.
|
|
40047
40063
|
*/
|
|
40048
40064
|
get: {
|
|
40049
40065
|
parameters: {
|
|
@@ -50958,9 +50974,11 @@ interface components {
|
|
|
50958
50974
|
fidelityTier: string | null;
|
|
50959
50975
|
/** @description Flow that ran. */
|
|
50960
50976
|
flowId: string | null;
|
|
50977
|
+
/** @description True when the dispatch carried a complete inline agent definition (name and model) beside or instead of an agentId, so the run executed that inline config and no stored version; such a row stamps no agentVersionId. False when the run executed the saved definition by reference. NULL when the header states nothing: a flow run, a lane that resolves no agent definition, or a row that predates the field. */
|
|
50978
|
+
inlineDefinition: boolean | null;
|
|
50961
50979
|
/** @description Messages the run started from. Absent means the overlay did not answer, which is not false and not null. */
|
|
50962
50980
|
inputMessages?: unknown;
|
|
50963
|
-
/** @description The run's first user message, secret-scrubbed and cut to 160 characters, so a list can say what a run was asked to do without reading content. Absent means no input text is recorded for this run, which is not an empty message: the span store holds no run-level input at all, so a run with no control-plane row (a flow leg, a storeResults:false
|
|
50981
|
+
/** @description The run's first user message, secret-scrubbed and cut to 160 characters, so a list can say what a run was asked to do without reading content. Absent means no input text is recorded for this run, which is not an empty message: the span store holds no run-level input at all, so a run with no control-plane row (a flow leg, a storeResults:false run) has none. */
|
|
50964
50982
|
inputPreview?: string | null;
|
|
50965
50983
|
/** @description Input tokens reported. */
|
|
50966
50984
|
inputTokens: number | null;
|
|
@@ -50973,6 +50991,11 @@ interface components {
|
|
|
50973
50991
|
kind: "agent" | "flow";
|
|
50974
50992
|
/** @description Last heartbeat. Absent means the overlay did not answer, which is not false and not null. */
|
|
50975
50993
|
lastHeartbeatAt?: string | null;
|
|
50994
|
+
/**
|
|
50995
|
+
* @description Where the run was dispatched from, taken from the caller's authenticated principal and never from a request field: dashboard for a Clerk session, api for a management API key, internal for a Runtype worker. NULL means the header states nothing about it, which is not "unknown caller": headers written before this field shipped, lanes that never see an auth principal, and every backfilled row carry no origin stamp.
|
|
50996
|
+
* @enum {string|null}
|
|
50997
|
+
*/
|
|
50998
|
+
origin: "dashboard" | "api" | "internal" | null;
|
|
50976
50999
|
/** @description Framework identity the producer reported, for a versionless run group. Absent means the overlay did not answer, which is not false and not null. */
|
|
50977
51000
|
otelProducer?: unknown;
|
|
50978
51001
|
/** @description Output tokens reported. */
|
|
@@ -51009,11 +51032,16 @@ interface components {
|
|
|
51009
51032
|
status: "queued" | "running" | "awaiting" | "completed" | "failed" | "cancelled";
|
|
51010
51033
|
/** @description Stop reason from the terminal frame. */
|
|
51011
51034
|
stopReason?: string | null;
|
|
51035
|
+
/** @description The persistence posture the dispatch declared. FALSE means the run wrote no control-plane row, no journal outputs and no span content, so a surface that reports a missing transcript keys on this and never on origin. NULL means the header states nothing, which is not "true": a lane that takes no such flag carries no stamp, and an ingested (OTLP) run declared none. A row served from the legacy control-plane lane answers true, because that row exists only when the run stored. */
|
|
51036
|
+
storeResults: boolean | null;
|
|
51012
51037
|
/** @description Product surface that entered this run. */
|
|
51013
51038
|
surfaceId: string | null;
|
|
51014
51039
|
/** @description Surface family (api, chat, webhook, schedule, ...). */
|
|
51015
51040
|
surfaceType: string | null;
|
|
51016
|
-
/**
|
|
51041
|
+
/**
|
|
51042
|
+
* @deprecated
|
|
51043
|
+
* @description DEPRECATED: a derived alias of origin, kept for one release — read origin instead. True when the run came from the dashboard, i.e. origin === "dashboard"; NULL exactly when origin is NULL. It is never derived from storeResults, which defaults to false across the whole flow lane and which an API caller sets for its own privacy reasons: reading it as "test" labelled production runs as tests. A run whose header predates origin therefore reads NULL rather than claiming either answer.
|
|
51044
|
+
*/
|
|
51017
51045
|
test: boolean | null;
|
|
51018
51046
|
/** @description Metered cost as a decimal string. */
|
|
51019
51047
|
totalCost: string | null;
|
|
@@ -57909,9 +57937,29 @@ interface RunListRow {
|
|
|
57909
57937
|
totalCost: string | null;
|
|
57910
57938
|
selfReportedCost: string | null;
|
|
57911
57939
|
/**
|
|
57912
|
-
*
|
|
57913
|
-
*
|
|
57914
|
-
*
|
|
57940
|
+
* Where the run was dispatched from, taken from the caller's authenticated
|
|
57941
|
+
* principal and never from a request field. NULL means the header states
|
|
57942
|
+
* nothing about it: a lane that sees no principal, or a backfilled row.
|
|
57943
|
+
*/
|
|
57944
|
+
origin: 'dashboard' | 'api' | 'internal' | null;
|
|
57945
|
+
/**
|
|
57946
|
+
* The persistence posture the dispatch declared. `false` means the run kept no
|
|
57947
|
+
* control-plane row, no journal outputs and no span content, so a surface
|
|
57948
|
+
* reporting a missing transcript reads this and never `origin`.
|
|
57949
|
+
*/
|
|
57950
|
+
storeResults: boolean | null;
|
|
57951
|
+
/**
|
|
57952
|
+
* True when the dispatch carried a complete inline definition, so the run
|
|
57953
|
+
* executed that config and stamps no `agentVersionId`. False for a run of the
|
|
57954
|
+
* saved definition by reference. NULL when the header states nothing.
|
|
57955
|
+
*/
|
|
57956
|
+
inlineDefinition: boolean | null;
|
|
57957
|
+
/**
|
|
57958
|
+
* True when the run came from the dashboard (`origin === 'dashboard'`), such
|
|
57959
|
+
* as an editor test.
|
|
57960
|
+
* @deprecated Derived alias of `origin`; read `origin` instead. Kept for one
|
|
57961
|
+
* release. NULL exactly when `origin` is NULL, including on a run whose header
|
|
57962
|
+
* predates the field.
|
|
57915
57963
|
*/
|
|
57916
57964
|
test: boolean | null;
|
|
57917
57965
|
stopReason?: string | null;
|
|
@@ -57976,8 +58024,8 @@ interface RunListResponse {
|
|
|
57976
58024
|
}
|
|
57977
58025
|
/**
|
|
57978
58026
|
* Read-only namespace over `/v1/runs`, the one list of agent and flow runs.
|
|
57979
|
-
* A
|
|
57980
|
-
* rather than being absent.
|
|
58027
|
+
* A dashboard editor test is listed with `origin: 'dashboard'` (and its `test`
|
|
58028
|
+
* alias) rather than being absent.
|
|
57981
58029
|
*/
|
|
57982
58030
|
declare class RunsNamespace {
|
|
57983
58031
|
private readonly getClient;
|
|
@@ -58948,7 +58996,10 @@ declare class Runtype {
|
|
|
58948
58996
|
static get executions(): ExecutionsNamespace;
|
|
58949
58997
|
/**
|
|
58950
58998
|
* Runs namespace - the one list of agent and flow runs, read from the span
|
|
58951
|
-
* store.
|
|
58999
|
+
* store. Each row states two separate facts: `origin` (who dispatched, from
|
|
59000
|
+
* the caller's principal; `test` is its deprecated alias) and `storeResults`
|
|
59001
|
+
* (whether the transcript was kept). A run that wrote no control-plane row
|
|
59002
|
+
* is still listed.
|
|
58952
59003
|
*
|
|
58953
59004
|
* @example
|
|
58954
59005
|
* ```typescript
|
package/dist/index.mjs
CHANGED
|
@@ -13639,7 +13639,10 @@ var Runtype = class {
|
|
|
13639
13639
|
}
|
|
13640
13640
|
/**
|
|
13641
13641
|
* Runs namespace - the one list of agent and flow runs, read from the span
|
|
13642
|
-
* store.
|
|
13642
|
+
* store. Each row states two separate facts: `origin` (who dispatched, from
|
|
13643
|
+
* the caller's principal; `test` is its deprecated alias) and `storeResults`
|
|
13644
|
+
* (whether the transcript was kept). A run that wrote no control-plane row
|
|
13645
|
+
* is still listed.
|
|
13643
13646
|
*
|
|
13644
13647
|
* @example
|
|
13645
13648
|
* ```typescript
|
|
@@ -13931,7 +13934,7 @@ function transformQueryParams(params) {
|
|
|
13931
13934
|
|
|
13932
13935
|
// src/version.ts
|
|
13933
13936
|
var FALLBACK_VERSION = "0.0.0";
|
|
13934
|
-
var SDK_VERSION = "10.1.
|
|
13937
|
+
var SDK_VERSION = "10.1.4".length > 0 ? "10.1.4" : FALLBACK_VERSION;
|
|
13935
13938
|
var RUNTYPE_CLIENT_KIND = "sdk";
|
|
13936
13939
|
var SDK_USER_AGENT = `runtype-sdk/${SDK_VERSION} (typescript)`;
|
|
13937
13940
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@runtypelabs/sdk",
|
|
3
|
-
"version": "10.1.
|
|
3
|
+
"version": "10.1.4",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"description": "TypeScript SDK for the Runtype API with fluent methods. Use it to quickly realize AI products, agents, and workflows.",
|
|
6
6
|
"main": "dist/index.cjs",
|
|
@@ -24,7 +24,7 @@
|
|
|
24
24
|
],
|
|
25
25
|
"dependencies": {},
|
|
26
26
|
"devDependencies": {
|
|
27
|
-
"@runtypelabs/shared": "3.
|
|
27
|
+
"@runtypelabs/shared": "3.58.1",
|
|
28
28
|
"openapi-typescript": "^7.13.0",
|
|
29
29
|
"tsup": "^8.0.2",
|
|
30
30
|
"typescript": "^6.0.3",
|