@runtypelabs/sdk 7.2.1 → 7.3.0

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.
Files changed (5) hide show
  1. package/dist/index.cjs +1 -1
  2. package/dist/index.d.cts +43 -18
  3. package/dist/index.d.ts +43 -18
  4. package/dist/index.mjs +1 -1
  5. package/package.json +1 -1
package/dist/index.cjs CHANGED
@@ -6452,7 +6452,7 @@ var Runtype = class {
6452
6452
 
6453
6453
  // src/version.ts
6454
6454
  var FALLBACK_VERSION = "0.0.0";
6455
- var SDK_VERSION = "7.2.1".length > 0 ? "7.2.1" : FALLBACK_VERSION;
6455
+ var SDK_VERSION = "7.3.0".length > 0 ? "7.3.0" : FALLBACK_VERSION;
6456
6456
  var RUNTYPE_CLIENT_KIND = "sdk";
6457
6457
  var SDK_USER_AGENT = `runtype-sdk/${SDK_VERSION} (typescript)`;
6458
6458
 
package/dist/index.d.cts CHANGED
@@ -506,6 +506,12 @@ interface paths {
506
506
  cursor?: string;
507
507
  includeCount?: string;
508
508
  search?: string;
509
+ /** @description Filter to a single agent type. */
510
+ agentType?: "runtype" | "external" | "claude_managed";
511
+ /** @description Deprecated alias for `agentType`. */
512
+ agent_type?: "runtype" | "external" | "claude_managed";
513
+ /** @description Response representation. `full` (default) preserves complete values; `compact` shortens every string value longer than 100 characters to a 100-character preview followed by `…`. */
514
+ view?: "full" | "compact";
509
515
  };
510
516
  header?: never;
511
517
  path?: never;
@@ -521,6 +527,7 @@ interface paths {
521
527
  content: {
522
528
  "application/json": {
523
529
  data: {
530
+ agentType: string;
524
531
  capabilityCount: number;
525
532
  config: {
526
533
  [key: string]: unknown;
@@ -1705,7 +1712,7 @@ interface paths {
1705
1712
  };
1706
1713
  /**
1707
1714
  * Update agent
1708
- * @description Update an existing agent. Supports partial updates — only provided fields are changed. Config updates are deep-merged.
1715
+ * @description Update an existing agent. Supports partial updates — only provided fields are changed. Both config and externalConfig are merged onto the stored values, so a partial write preserves keys it omits (notably externalConfig.protocol and externalConfig.cachedAgentCard). To REMOVE a value, send it explicitly as null: a null field clears that field, and externalConfig: null clears the whole object. Nested values replace atomically — sending auth replaces the entire auth block, so switching auth type cannot reuse the previous credential. Repointing an external agent (endpoint, agentCardUrl or protocol) discards the cached agent card, which is re-fetched by POST /agents/{id}/refresh-agent-card. Moving externalConfig.endpoint to a different host additionally requires re-sending externalConfig.auth: a stored credential is never carried to a host it was not configured against, so a repoint that omits auth is rejected with 400.
1709
1716
  */
1710
1717
  put: {
1711
1718
  parameters: {
@@ -1968,13 +1975,13 @@ interface paths {
1968
1975
  description?: string;
1969
1976
  externalConfig?: {
1970
1977
  /** Format: uri */
1971
- agentCardUrl?: string;
1978
+ agentCardUrl?: string | null;
1972
1979
  auth?: {
1973
1980
  credentials?: string;
1974
1981
  headerName?: string;
1975
1982
  /** @enum {string} */
1976
1983
  type: "none" | "bearer" | "api_key" | "basic";
1977
- };
1984
+ } | null;
1978
1985
  cachedAgentCard?: {
1979
1986
  capabilities?: {
1980
1987
  pushNotifications?: boolean;
@@ -1998,15 +2005,15 @@ interface paths {
1998
2005
  };
1999
2006
  }[];
2000
2007
  version?: string;
2001
- };
2008
+ } | null;
2002
2009
  /** Format: uri */
2003
- endpoint: string;
2004
- /** @enum {string} */
2005
- framework?: "langchain" | "vercel_ai" | "crewai" | "cloudflare" | "autogen" | "flue" | "custom";
2006
- /** @enum {string} */
2007
- protocol?: "a2a" | "runtype-stream";
2008
- retryCount?: number;
2009
- skillOrchestration?: ("delegate" | "managed") | ("agent_skill" | "runtype" | "none");
2010
+ endpoint?: string;
2011
+ /** @enum {string|null} */
2012
+ framework?: "langchain" | "vercel_ai" | "crewai" | "cloudflare" | "autogen" | "flue" | "custom" | null;
2013
+ /** @enum {string|null} */
2014
+ protocol?: "a2a" | "runtype-stream" | null;
2015
+ retryCount?: number | null;
2016
+ skillOrchestration?: ("delegate" | "managed") | ("agent_skill" | "runtype" | "none") | null;
2010
2017
  skillOrchestrator?: {
2011
2018
  frequencyPenalty?: number;
2012
2019
  model: string;
@@ -2026,7 +2033,7 @@ interface paths {
2026
2033
  temperature?: number;
2027
2034
  topK?: number;
2028
2035
  topP?: number;
2029
- };
2036
+ } | null;
2030
2037
  skillsOverride?: {
2031
2038
  enabled: boolean;
2032
2039
  exposedDescription?: string;
@@ -2035,8 +2042,8 @@ interface paths {
2035
2042
  isNew?: boolean;
2036
2043
  /** @enum {string} */
2037
2044
  role?: "orchestrator" | "tool" | "standalone" | "hidden";
2038
- }[];
2039
- timeoutMs?: number;
2045
+ }[] | null;
2046
+ timeoutMs?: number | null;
2040
2047
  } | null;
2041
2048
  icon?: string;
2042
2049
  maxTurns?: number;
@@ -7999,6 +8006,8 @@ interface paths {
7999
8006
  limit?: string;
8000
8007
  cursor?: string;
8001
8008
  includeCount?: string;
8009
+ /** @description Response representation. `full` (default) preserves complete values; `compact` shortens every string value longer than 100 characters to a 100-character preview followed by `…`. */
8010
+ view?: "full" | "compact";
8002
8011
  };
8003
8012
  header?: never;
8004
8013
  path?: never;
@@ -8762,6 +8771,8 @@ interface paths {
8762
8771
  name?: string;
8763
8772
  cursor?: string;
8764
8773
  limit?: string;
8774
+ /** @description Response representation. `full` (default) preserves complete values; `compact` shortens every string value longer than 100 characters to a 100-character preview followed by `…`. */
8775
+ view?: "full" | "compact";
8765
8776
  };
8766
8777
  header?: never;
8767
8778
  path?: never;
@@ -16697,6 +16708,8 @@ interface paths {
16697
16708
  direction?: string;
16698
16709
  includeCount?: string;
16699
16710
  search?: string;
16711
+ /** @description Response representation. `full` (default) preserves complete values; `compact` shortens every string value longer than 100 characters to a 100-character preview followed by `…`. */
16712
+ view?: "full" | "compact";
16700
16713
  };
16701
16714
  header?: never;
16702
16715
  path?: never;
@@ -26177,6 +26190,8 @@ interface paths {
26177
26190
  limit?: string;
26178
26191
  cursor?: string;
26179
26192
  search?: string;
26193
+ /** @description Response representation. `full` (default) preserves complete values; `compact` shortens every string value longer than 100 characters to a 100-character preview followed by `…`. */
26194
+ view?: "full" | "compact";
26180
26195
  };
26181
26196
  header?: never;
26182
26197
  path?: never;
@@ -29017,12 +29032,12 @@ interface paths {
29017
29032
  surfaceId: string;
29018
29033
  /** @description Advisory findings about this binding. Present only when non-empty; never blocks the mutation. */
29019
29034
  warnings?: {
29020
- /** @description Stable advisory code, e.g. `APPROVAL_UNANSWERABLE_ON_SURFACE` when an approval-gated agent is bound to a surface with no human to answer the prompt. */
29035
+ /** @description Stable advisory code: `APPROVAL_UNANSWERABLE_ON_SURFACE` when an approval-gated agent is bound to a surface with no human to answer the prompt, or `APPROVAL_REPLY_CAPTURE_ON_SURFACE` when the pairing works but the decision is read from the reply the person texts back. */
29021
29036
  code: string;
29022
29037
  message: string;
29023
29038
  path: string;
29024
29039
  /** @enum {string} */
29025
- severity: "warning";
29040
+ severity: "warning" | "recommendation";
29026
29041
  suggestedFix?: string;
29027
29042
  }[];
29028
29043
  };
@@ -29171,12 +29186,12 @@ interface paths {
29171
29186
  surfaceId: string;
29172
29187
  /** @description Advisory findings about this binding. Present only when non-empty; never blocks the mutation. */
29173
29188
  warnings?: {
29174
- /** @description Stable advisory code, e.g. `APPROVAL_UNANSWERABLE_ON_SURFACE` when an approval-gated agent is bound to a surface with no human to answer the prompt. */
29189
+ /** @description Stable advisory code: `APPROVAL_UNANSWERABLE_ON_SURFACE` when an approval-gated agent is bound to a surface with no human to answer the prompt, or `APPROVAL_REPLY_CAPTURE_ON_SURFACE` when the pairing works but the decision is read from the reply the person texts back. */
29175
29190
  code: string;
29176
29191
  message: string;
29177
29192
  path: string;
29178
29193
  /** @enum {string} */
29179
- severity: "warning";
29194
+ severity: "warning" | "recommendation";
29180
29195
  suggestedFix?: string;
29181
29196
  }[];
29182
29197
  };
@@ -32262,6 +32277,8 @@ interface paths {
32262
32277
  search?: string;
32263
32278
  /** @description Filter by model ID */
32264
32279
  model?: string;
32280
+ /** @description Response representation. `full` (default) preserves complete values; `compact` shortens every string value longer than 100 characters to a 100-character preview followed by `…`. */
32281
+ view?: "full" | "compact";
32265
32282
  };
32266
32283
  header?: never;
32267
32284
  path?: never;
@@ -34364,6 +34381,8 @@ interface paths {
34364
34381
  min_size_kb?: string;
34365
34382
  max_size_kb?: string;
34366
34383
  recordFilter?: string;
34384
+ /** @description Response representation. `full` (default) preserves complete values; `compact` shortens every string value longer than 100 characters to a 100-character preview followed by `…`. */
34385
+ view?: "full" | "compact";
34367
34386
  };
34368
34387
  header?: never;
34369
34388
  path?: never;
@@ -37772,6 +37791,8 @@ interface paths {
37772
37791
  search?: string;
37773
37792
  /** @description Filter by status */
37774
37793
  status?: "active" | "paused";
37794
+ /** @description Response representation. `full` (default) preserves complete values; `compact` shortens every string value longer than 100 characters to a 100-character preview followed by `…`. */
37795
+ view?: "full" | "compact";
37775
37796
  };
37776
37797
  header?: never;
37777
37798
  path?: never;
@@ -40078,6 +40099,8 @@ interface paths {
40078
40099
  cursor?: string;
40079
40100
  direction?: string;
40080
40101
  includeCount?: string;
40102
+ /** @description Response representation. `full` (default) preserves complete values; `compact` shortens every string value longer than 100 characters to a 100-character preview followed by `…`. */
40103
+ view?: "full" | "compact";
40081
40104
  };
40082
40105
  header?: never;
40083
40106
  path?: never;
@@ -41449,6 +41472,8 @@ interface paths {
41449
41472
  isActive?: string;
41450
41473
  ids?: string;
41451
41474
  include?: string;
41475
+ /** @description Response representation. `full` (default) preserves complete values; `compact` shortens every string value longer than 100 characters to a 100-character preview followed by `…`. */
41476
+ view?: "full" | "compact";
41452
41477
  };
41453
41478
  header?: never;
41454
41479
  path?: never;
package/dist/index.d.ts CHANGED
@@ -506,6 +506,12 @@ interface paths {
506
506
  cursor?: string;
507
507
  includeCount?: string;
508
508
  search?: string;
509
+ /** @description Filter to a single agent type. */
510
+ agentType?: "runtype" | "external" | "claude_managed";
511
+ /** @description Deprecated alias for `agentType`. */
512
+ agent_type?: "runtype" | "external" | "claude_managed";
513
+ /** @description Response representation. `full` (default) preserves complete values; `compact` shortens every string value longer than 100 characters to a 100-character preview followed by `…`. */
514
+ view?: "full" | "compact";
509
515
  };
510
516
  header?: never;
511
517
  path?: never;
@@ -521,6 +527,7 @@ interface paths {
521
527
  content: {
522
528
  "application/json": {
523
529
  data: {
530
+ agentType: string;
524
531
  capabilityCount: number;
525
532
  config: {
526
533
  [key: string]: unknown;
@@ -1705,7 +1712,7 @@ interface paths {
1705
1712
  };
1706
1713
  /**
1707
1714
  * Update agent
1708
- * @description Update an existing agent. Supports partial updates — only provided fields are changed. Config updates are deep-merged.
1715
+ * @description Update an existing agent. Supports partial updates — only provided fields are changed. Both config and externalConfig are merged onto the stored values, so a partial write preserves keys it omits (notably externalConfig.protocol and externalConfig.cachedAgentCard). To REMOVE a value, send it explicitly as null: a null field clears that field, and externalConfig: null clears the whole object. Nested values replace atomically — sending auth replaces the entire auth block, so switching auth type cannot reuse the previous credential. Repointing an external agent (endpoint, agentCardUrl or protocol) discards the cached agent card, which is re-fetched by POST /agents/{id}/refresh-agent-card. Moving externalConfig.endpoint to a different host additionally requires re-sending externalConfig.auth: a stored credential is never carried to a host it was not configured against, so a repoint that omits auth is rejected with 400.
1709
1716
  */
1710
1717
  put: {
1711
1718
  parameters: {
@@ -1968,13 +1975,13 @@ interface paths {
1968
1975
  description?: string;
1969
1976
  externalConfig?: {
1970
1977
  /** Format: uri */
1971
- agentCardUrl?: string;
1978
+ agentCardUrl?: string | null;
1972
1979
  auth?: {
1973
1980
  credentials?: string;
1974
1981
  headerName?: string;
1975
1982
  /** @enum {string} */
1976
1983
  type: "none" | "bearer" | "api_key" | "basic";
1977
- };
1984
+ } | null;
1978
1985
  cachedAgentCard?: {
1979
1986
  capabilities?: {
1980
1987
  pushNotifications?: boolean;
@@ -1998,15 +2005,15 @@ interface paths {
1998
2005
  };
1999
2006
  }[];
2000
2007
  version?: string;
2001
- };
2008
+ } | null;
2002
2009
  /** Format: uri */
2003
- endpoint: string;
2004
- /** @enum {string} */
2005
- framework?: "langchain" | "vercel_ai" | "crewai" | "cloudflare" | "autogen" | "flue" | "custom";
2006
- /** @enum {string} */
2007
- protocol?: "a2a" | "runtype-stream";
2008
- retryCount?: number;
2009
- skillOrchestration?: ("delegate" | "managed") | ("agent_skill" | "runtype" | "none");
2010
+ endpoint?: string;
2011
+ /** @enum {string|null} */
2012
+ framework?: "langchain" | "vercel_ai" | "crewai" | "cloudflare" | "autogen" | "flue" | "custom" | null;
2013
+ /** @enum {string|null} */
2014
+ protocol?: "a2a" | "runtype-stream" | null;
2015
+ retryCount?: number | null;
2016
+ skillOrchestration?: ("delegate" | "managed") | ("agent_skill" | "runtype" | "none") | null;
2010
2017
  skillOrchestrator?: {
2011
2018
  frequencyPenalty?: number;
2012
2019
  model: string;
@@ -2026,7 +2033,7 @@ interface paths {
2026
2033
  temperature?: number;
2027
2034
  topK?: number;
2028
2035
  topP?: number;
2029
- };
2036
+ } | null;
2030
2037
  skillsOverride?: {
2031
2038
  enabled: boolean;
2032
2039
  exposedDescription?: string;
@@ -2035,8 +2042,8 @@ interface paths {
2035
2042
  isNew?: boolean;
2036
2043
  /** @enum {string} */
2037
2044
  role?: "orchestrator" | "tool" | "standalone" | "hidden";
2038
- }[];
2039
- timeoutMs?: number;
2045
+ }[] | null;
2046
+ timeoutMs?: number | null;
2040
2047
  } | null;
2041
2048
  icon?: string;
2042
2049
  maxTurns?: number;
@@ -7999,6 +8006,8 @@ interface paths {
7999
8006
  limit?: string;
8000
8007
  cursor?: string;
8001
8008
  includeCount?: string;
8009
+ /** @description Response representation. `full` (default) preserves complete values; `compact` shortens every string value longer than 100 characters to a 100-character preview followed by `…`. */
8010
+ view?: "full" | "compact";
8002
8011
  };
8003
8012
  header?: never;
8004
8013
  path?: never;
@@ -8762,6 +8771,8 @@ interface paths {
8762
8771
  name?: string;
8763
8772
  cursor?: string;
8764
8773
  limit?: string;
8774
+ /** @description Response representation. `full` (default) preserves complete values; `compact` shortens every string value longer than 100 characters to a 100-character preview followed by `…`. */
8775
+ view?: "full" | "compact";
8765
8776
  };
8766
8777
  header?: never;
8767
8778
  path?: never;
@@ -16697,6 +16708,8 @@ interface paths {
16697
16708
  direction?: string;
16698
16709
  includeCount?: string;
16699
16710
  search?: string;
16711
+ /** @description Response representation. `full` (default) preserves complete values; `compact` shortens every string value longer than 100 characters to a 100-character preview followed by `…`. */
16712
+ view?: "full" | "compact";
16700
16713
  };
16701
16714
  header?: never;
16702
16715
  path?: never;
@@ -26177,6 +26190,8 @@ interface paths {
26177
26190
  limit?: string;
26178
26191
  cursor?: string;
26179
26192
  search?: string;
26193
+ /** @description Response representation. `full` (default) preserves complete values; `compact` shortens every string value longer than 100 characters to a 100-character preview followed by `…`. */
26194
+ view?: "full" | "compact";
26180
26195
  };
26181
26196
  header?: never;
26182
26197
  path?: never;
@@ -29017,12 +29032,12 @@ interface paths {
29017
29032
  surfaceId: string;
29018
29033
  /** @description Advisory findings about this binding. Present only when non-empty; never blocks the mutation. */
29019
29034
  warnings?: {
29020
- /** @description Stable advisory code, e.g. `APPROVAL_UNANSWERABLE_ON_SURFACE` when an approval-gated agent is bound to a surface with no human to answer the prompt. */
29035
+ /** @description Stable advisory code: `APPROVAL_UNANSWERABLE_ON_SURFACE` when an approval-gated agent is bound to a surface with no human to answer the prompt, or `APPROVAL_REPLY_CAPTURE_ON_SURFACE` when the pairing works but the decision is read from the reply the person texts back. */
29021
29036
  code: string;
29022
29037
  message: string;
29023
29038
  path: string;
29024
29039
  /** @enum {string} */
29025
- severity: "warning";
29040
+ severity: "warning" | "recommendation";
29026
29041
  suggestedFix?: string;
29027
29042
  }[];
29028
29043
  };
@@ -29171,12 +29186,12 @@ interface paths {
29171
29186
  surfaceId: string;
29172
29187
  /** @description Advisory findings about this binding. Present only when non-empty; never blocks the mutation. */
29173
29188
  warnings?: {
29174
- /** @description Stable advisory code, e.g. `APPROVAL_UNANSWERABLE_ON_SURFACE` when an approval-gated agent is bound to a surface with no human to answer the prompt. */
29189
+ /** @description Stable advisory code: `APPROVAL_UNANSWERABLE_ON_SURFACE` when an approval-gated agent is bound to a surface with no human to answer the prompt, or `APPROVAL_REPLY_CAPTURE_ON_SURFACE` when the pairing works but the decision is read from the reply the person texts back. */
29175
29190
  code: string;
29176
29191
  message: string;
29177
29192
  path: string;
29178
29193
  /** @enum {string} */
29179
- severity: "warning";
29194
+ severity: "warning" | "recommendation";
29180
29195
  suggestedFix?: string;
29181
29196
  }[];
29182
29197
  };
@@ -32262,6 +32277,8 @@ interface paths {
32262
32277
  search?: string;
32263
32278
  /** @description Filter by model ID */
32264
32279
  model?: string;
32280
+ /** @description Response representation. `full` (default) preserves complete values; `compact` shortens every string value longer than 100 characters to a 100-character preview followed by `…`. */
32281
+ view?: "full" | "compact";
32265
32282
  };
32266
32283
  header?: never;
32267
32284
  path?: never;
@@ -34364,6 +34381,8 @@ interface paths {
34364
34381
  min_size_kb?: string;
34365
34382
  max_size_kb?: string;
34366
34383
  recordFilter?: string;
34384
+ /** @description Response representation. `full` (default) preserves complete values; `compact` shortens every string value longer than 100 characters to a 100-character preview followed by `…`. */
34385
+ view?: "full" | "compact";
34367
34386
  };
34368
34387
  header?: never;
34369
34388
  path?: never;
@@ -37772,6 +37791,8 @@ interface paths {
37772
37791
  search?: string;
37773
37792
  /** @description Filter by status */
37774
37793
  status?: "active" | "paused";
37794
+ /** @description Response representation. `full` (default) preserves complete values; `compact` shortens every string value longer than 100 characters to a 100-character preview followed by `…`. */
37795
+ view?: "full" | "compact";
37775
37796
  };
37776
37797
  header?: never;
37777
37798
  path?: never;
@@ -40078,6 +40099,8 @@ interface paths {
40078
40099
  cursor?: string;
40079
40100
  direction?: string;
40080
40101
  includeCount?: string;
40102
+ /** @description Response representation. `full` (default) preserves complete values; `compact` shortens every string value longer than 100 characters to a 100-character preview followed by `…`. */
40103
+ view?: "full" | "compact";
40081
40104
  };
40082
40105
  header?: never;
40083
40106
  path?: never;
@@ -41449,6 +41472,8 @@ interface paths {
41449
41472
  isActive?: string;
41450
41473
  ids?: string;
41451
41474
  include?: string;
41475
+ /** @description Response representation. `full` (default) preserves complete values; `compact` shortens every string value longer than 100 characters to a 100-character preview followed by `…`. */
41476
+ view?: "full" | "compact";
41452
41477
  };
41453
41478
  header?: never;
41454
41479
  path?: never;
package/dist/index.mjs CHANGED
@@ -6264,7 +6264,7 @@ var Runtype = class {
6264
6264
 
6265
6265
  // src/version.ts
6266
6266
  var FALLBACK_VERSION = "0.0.0";
6267
- var SDK_VERSION = "7.2.1".length > 0 ? "7.2.1" : FALLBACK_VERSION;
6267
+ var SDK_VERSION = "7.3.0".length > 0 ? "7.3.0" : FALLBACK_VERSION;
6268
6268
  var RUNTYPE_CLIENT_KIND = "sdk";
6269
6269
  var SDK_USER_AGENT = `runtype-sdk/${SDK_VERSION} (typescript)`;
6270
6270
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@runtypelabs/sdk",
3
- "version": "7.2.1",
3
+ "version": "7.3.0",
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",