@runtypelabs/sdk 11.23.0 → 11.24.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.
package/dist/index.cjs CHANGED
@@ -4946,10 +4946,10 @@ var RecordsEndpoint = class {
4946
4946
  return this.client.postFormData("/records/upload-csv", formData);
4947
4947
  }
4948
4948
  /**
4949
- * Get record types (distinct values)
4949
+ * Get distinct record types, optionally including per-type counts and latest write timestamps.
4950
4950
  */
4951
- async getTypes() {
4952
- return this.client.get("/records?distinct=types");
4951
+ async getTypes(options) {
4952
+ return this.client.get(options?.includeSummary ? "/records?distinct=types&includeSummary=true" : "/records?distinct=types");
4953
4953
  }
4954
4954
  /**
4955
4955
  * Get example record by type and/or name
@@ -13944,7 +13944,12 @@ var RuntypeClient$1 = class {
13944
13944
  const relPath = path.startsWith("/") ? path.slice(1) : path;
13945
13945
  const url = new URL(relPath, base);
13946
13946
  if (params) Object.entries(params).forEach(([key, value]) => {
13947
- if (value !== void 0 && value !== null) url.searchParams.set(key, String(value));
13947
+ if (value !== void 0 && value !== null) {
13948
+ if (Array.isArray(value)) value.forEach((item) => {
13949
+ if (item !== void 0 && item !== null) url.searchParams.append(key, String(item));
13950
+ });
13951
+ else url.searchParams.set(key, String(value));
13952
+ }
13948
13953
  });
13949
13954
  return url.toString();
13950
13955
  }
@@ -14832,7 +14837,7 @@ function transformQueryParams(params) {
14832
14837
  return result;
14833
14838
  }
14834
14839
  // src/version.ts
14835
- const SDK_VERSION = "11.23.0";
14840
+ const SDK_VERSION = "11.24.0";
14836
14841
  /**
14837
14842
  * Canonical client identity the API uses for attribution
14838
14843
  * (`detectActorSource` in apps/api/src/lib/audit-log.ts keys `'sdk'` off the
package/dist/index.d.cts CHANGED
@@ -35858,6 +35858,8 @@ interface paths {
35858
35858
  kind: "agent" | "flow";
35859
35859
  /** @description Last heartbeat. Absent means the overlay did not answer, which is not false and not null. */
35860
35860
  lastHeartbeatAt?: string | null;
35861
+ /** @description Model of the run's first model call (served model when reported, otherwise requested model); null when no model call recorded one. */
35862
+ model?: string | null;
35861
35863
  /**
35862
35864
  * @description Where the run was dispatched from, taken from the caller's authenticated principal and never from a request field. ANY entrance that resolves a principal stamps it: a Clerk session answers dashboard; a management API key answers api, which includes the Runtype MCP server's tools and Code Mode, since both reach dispatch with a management key; and Runtype's own internal caller answers internal, for example the hosted /v1/mcp proxy. A lane that resolves NO principal carries NULL BY DESIGN: schedule, webhook, messaging, A2A, an agent exposed AS an MCP surface, subagent, nested flow, a client-token product surface (an end user is none of the three origins) and an ingested OTLP run. So NULL says "no authenticated principal at this entrance" rather than "unknown caller". The one NULL that is not a statement about the lane is a row whose header predates the field or came from the backfill: it stamps nothing even for a run that did resolve a principal.
35863
35865
  * @enum {string|null}
@@ -45421,6 +45423,8 @@ interface paths {
45421
45423
  name?: string;
45422
45424
  ownerId?: string;
45423
45425
  distinct?: string;
45426
+ /** @description When set to "true" with distinct=types, includes per-type record counts and latest write timestamps in summaries. */
45427
+ includeSummary?: string;
45424
45428
  includeFields?: string;
45425
45429
  include_fields?: string;
45426
45430
  product_surface_id?: string;
@@ -45478,6 +45482,12 @@ interface paths {
45478
45482
  [key: string]: unknown;
45479
45483
  };
45480
45484
  pagination: components["schemas"]["Pagination"];
45485
+ /** @description Per-type record counts and latest write timestamps when distinct=types and includeSummary=true. */
45486
+ summaries?: {
45487
+ latestUpdatedAt: string | null;
45488
+ total: number;
45489
+ type: string;
45490
+ }[];
45481
45491
  };
45482
45492
  };
45483
45493
  };
@@ -47331,8 +47341,8 @@ interface paths {
47331
47341
  agentId?: string | string[];
47332
47342
  /** @description Filter by flow id; repeat for a set. */
47333
47343
  flowId?: string | string[];
47334
- /** @description Filter by conversation id. */
47335
- conversationId?: string;
47344
+ /** @description Filter by conversation id; repeat for a set (at most 100 per request). */
47345
+ conversationId?: string | string[];
47336
47346
  /** @description Filter by surface id. */
47337
47347
  surfaceId?: string;
47338
47348
  /** @description Filter by surface family. */
@@ -47361,7 +47371,7 @@ interface paths {
47361
47371
  from?: string;
47362
47372
  /** @description Window end (ISO 8601). Defaults to now. */
47363
47373
  to?: string;
47364
- /** @description full (the default) returns every field. compact omits exactly these 16: stopReason, iterations, inputPreview, flowVersionId, agentVersionId, agentVersionLabel, agentVersionNumber, agentTargetResolution, otelProducer, lastHeartbeatAt, expiresAt, cancelRequestedAt, progress, pendingApproval, budgetExhausted and inputMessages. The status is still overlay-corrected on a compact page; only the fields differ. */
47374
+ /** @description full (the default) returns every field. compact omits exactly these 17: model, stopReason, iterations, inputPreview, flowVersionId, agentVersionId, agentVersionLabel, agentVersionNumber, agentTargetResolution, otelProducer, lastHeartbeatAt, expiresAt, cancelRequestedAt, progress, pendingApproval, budgetExhausted and inputMessages. The status is still overlay-corrected on a compact page; only the fields differ. */
47365
47375
  view?: "compact" | "full";
47366
47376
  /** @description live adds control-plane fields; defaults to live for a session, none for an API key. */
47367
47377
  overlay?: "live" | "none";
@@ -47481,8 +47491,8 @@ interface paths {
47481
47491
  agentId?: string | string[];
47482
47492
  /** @description Filter by flow id; repeat for a set. */
47483
47493
  flowId?: string | string[];
47484
- /** @description Filter by conversation id. */
47485
- conversationId?: string;
47494
+ /** @description Filter by conversation id; repeat for a set (at most 100 per request). */
47495
+ conversationId?: string | string[];
47486
47496
  /** @description Filter by surface id. */
47487
47497
  surfaceId?: string;
47488
47498
  /** @description Filter by surface family. */
@@ -47701,7 +47711,7 @@ interface paths {
47701
47711
  query?: {
47702
47712
  /** @description live adds control-plane fields; defaults to live for a session, none for an API key. */
47703
47713
  overlay?: "live" | "none";
47704
- /** @description full (the default) returns every field. compact omits exactly these 16: stopReason, iterations, inputPreview, flowVersionId, agentVersionId, agentVersionLabel, agentVersionNumber, agentTargetResolution, otelProducer, lastHeartbeatAt, expiresAt, cancelRequestedAt, progress, pendingApproval, budgetExhausted and inputMessages. The status is still overlay-corrected on a compact page; only the fields differ. */
47714
+ /** @description full (the default) returns every field. compact omits exactly these 17: model, stopReason, iterations, inputPreview, flowVersionId, agentVersionId, agentVersionLabel, agentVersionNumber, agentTargetResolution, otelProducer, lastHeartbeatAt, expiresAt, cancelRequestedAt, progress, pendingApproval, budgetExhausted and inputMessages. The status is still overlay-corrected on a compact page; only the fields differ. */
47705
47715
  view?: "compact" | "full";
47706
47716
  };
47707
47717
  header?: never;
@@ -65105,6 +65115,8 @@ interface components {
65105
65115
  kind: "agent" | "flow";
65106
65116
  /** @description Last heartbeat. Absent means the overlay did not answer, which is not false and not null. */
65107
65117
  lastHeartbeatAt?: string | null;
65118
+ /** @description Model of the run's first model call (served model when reported, otherwise requested model); null when no model call recorded one. */
65119
+ model?: string | null;
65108
65120
  /**
65109
65121
  * @description Where the run was dispatched from, taken from the caller's authenticated principal and never from a request field. ANY entrance that resolves a principal stamps it: a Clerk session answers dashboard; a management API key answers api, which includes the Runtype MCP server's tools and Code Mode, since both reach dispatch with a management key; and Runtype's own internal caller answers internal, for example the hosted /v1/mcp proxy. A lane that resolves NO principal carries NULL BY DESIGN: schedule, webhook, messaging, A2A, an agent exposed AS an MCP surface, subagent, nested flow, a client-token product surface (an end user is none of the three origins) and an ingested OTLP run. So NULL says "no authenticated principal at this entrance" rather than "unknown caller". The one NULL that is not a statement about the lane is a row whose header predates the field or came from the backfill: it stamps nothing even for a run that did resolve a principal.
65110
65122
  * @enum {string|null}
@@ -71798,11 +71810,18 @@ export declare class RecordsEndpoint {
71798
71810
  typeValue?: string;
71799
71811
  }): Promise<any>;
71800
71812
  /**
71801
- * Get record types (distinct values)
71813
+ * Get distinct record types, optionally including per-type counts and latest write timestamps.
71802
71814
  */
71803
- getTypes(): Promise<{
71815
+ getTypes(options?: {
71816
+ includeSummary?: boolean;
71817
+ }): Promise<{
71804
71818
  data: string[];
71805
71819
  total: number;
71820
+ summaries?: Array<{
71821
+ type: string;
71822
+ total: number;
71823
+ latestUpdatedAt: string | null;
71824
+ }>;
71806
71825
  }>;
71807
71826
  /**
71808
71827
  * Get example record by type and/or name
@@ -78007,6 +78026,8 @@ interface RunListRow {
78007
78026
  framework: string | null;
78008
78027
  endpointHost: string | null;
78009
78028
  } | null;
78029
+ /** Model of the run's first model call; null when no model call recorded one. */
78030
+ model?: string | null;
78010
78031
  stopReason?: string | null;
78011
78032
  iterations?: number | null;
78012
78033
  /**
@@ -78042,7 +78063,7 @@ interface RunListRow {
78042
78063
  interface RunListParams {
78043
78064
  agentId?: string | string[];
78044
78065
  flowId?: string | string[];
78045
- conversationId?: string;
78066
+ conversationId?: string | string[];
78046
78067
  surfaceId?: string;
78047
78068
  surfaceType?: string;
78048
78069
  recordId?: string;
package/dist/index.d.ts CHANGED
@@ -35858,6 +35858,8 @@ interface paths {
35858
35858
  kind: "agent" | "flow";
35859
35859
  /** @description Last heartbeat. Absent means the overlay did not answer, which is not false and not null. */
35860
35860
  lastHeartbeatAt?: string | null;
35861
+ /** @description Model of the run's first model call (served model when reported, otherwise requested model); null when no model call recorded one. */
35862
+ model?: string | null;
35861
35863
  /**
35862
35864
  * @description Where the run was dispatched from, taken from the caller's authenticated principal and never from a request field. ANY entrance that resolves a principal stamps it: a Clerk session answers dashboard; a management API key answers api, which includes the Runtype MCP server's tools and Code Mode, since both reach dispatch with a management key; and Runtype's own internal caller answers internal, for example the hosted /v1/mcp proxy. A lane that resolves NO principal carries NULL BY DESIGN: schedule, webhook, messaging, A2A, an agent exposed AS an MCP surface, subagent, nested flow, a client-token product surface (an end user is none of the three origins) and an ingested OTLP run. So NULL says "no authenticated principal at this entrance" rather than "unknown caller". The one NULL that is not a statement about the lane is a row whose header predates the field or came from the backfill: it stamps nothing even for a run that did resolve a principal.
35863
35865
  * @enum {string|null}
@@ -45421,6 +45423,8 @@ interface paths {
45421
45423
  name?: string;
45422
45424
  ownerId?: string;
45423
45425
  distinct?: string;
45426
+ /** @description When set to "true" with distinct=types, includes per-type record counts and latest write timestamps in summaries. */
45427
+ includeSummary?: string;
45424
45428
  includeFields?: string;
45425
45429
  include_fields?: string;
45426
45430
  product_surface_id?: string;
@@ -45478,6 +45482,12 @@ interface paths {
45478
45482
  [key: string]: unknown;
45479
45483
  };
45480
45484
  pagination: components["schemas"]["Pagination"];
45485
+ /** @description Per-type record counts and latest write timestamps when distinct=types and includeSummary=true. */
45486
+ summaries?: {
45487
+ latestUpdatedAt: string | null;
45488
+ total: number;
45489
+ type: string;
45490
+ }[];
45481
45491
  };
45482
45492
  };
45483
45493
  };
@@ -47331,8 +47341,8 @@ interface paths {
47331
47341
  agentId?: string | string[];
47332
47342
  /** @description Filter by flow id; repeat for a set. */
47333
47343
  flowId?: string | string[];
47334
- /** @description Filter by conversation id. */
47335
- conversationId?: string;
47344
+ /** @description Filter by conversation id; repeat for a set (at most 100 per request). */
47345
+ conversationId?: string | string[];
47336
47346
  /** @description Filter by surface id. */
47337
47347
  surfaceId?: string;
47338
47348
  /** @description Filter by surface family. */
@@ -47361,7 +47371,7 @@ interface paths {
47361
47371
  from?: string;
47362
47372
  /** @description Window end (ISO 8601). Defaults to now. */
47363
47373
  to?: string;
47364
- /** @description full (the default) returns every field. compact omits exactly these 16: stopReason, iterations, inputPreview, flowVersionId, agentVersionId, agentVersionLabel, agentVersionNumber, agentTargetResolution, otelProducer, lastHeartbeatAt, expiresAt, cancelRequestedAt, progress, pendingApproval, budgetExhausted and inputMessages. The status is still overlay-corrected on a compact page; only the fields differ. */
47374
+ /** @description full (the default) returns every field. compact omits exactly these 17: model, stopReason, iterations, inputPreview, flowVersionId, agentVersionId, agentVersionLabel, agentVersionNumber, agentTargetResolution, otelProducer, lastHeartbeatAt, expiresAt, cancelRequestedAt, progress, pendingApproval, budgetExhausted and inputMessages. The status is still overlay-corrected on a compact page; only the fields differ. */
47365
47375
  view?: "compact" | "full";
47366
47376
  /** @description live adds control-plane fields; defaults to live for a session, none for an API key. */
47367
47377
  overlay?: "live" | "none";
@@ -47481,8 +47491,8 @@ interface paths {
47481
47491
  agentId?: string | string[];
47482
47492
  /** @description Filter by flow id; repeat for a set. */
47483
47493
  flowId?: string | string[];
47484
- /** @description Filter by conversation id. */
47485
- conversationId?: string;
47494
+ /** @description Filter by conversation id; repeat for a set (at most 100 per request). */
47495
+ conversationId?: string | string[];
47486
47496
  /** @description Filter by surface id. */
47487
47497
  surfaceId?: string;
47488
47498
  /** @description Filter by surface family. */
@@ -47701,7 +47711,7 @@ interface paths {
47701
47711
  query?: {
47702
47712
  /** @description live adds control-plane fields; defaults to live for a session, none for an API key. */
47703
47713
  overlay?: "live" | "none";
47704
- /** @description full (the default) returns every field. compact omits exactly these 16: stopReason, iterations, inputPreview, flowVersionId, agentVersionId, agentVersionLabel, agentVersionNumber, agentTargetResolution, otelProducer, lastHeartbeatAt, expiresAt, cancelRequestedAt, progress, pendingApproval, budgetExhausted and inputMessages. The status is still overlay-corrected on a compact page; only the fields differ. */
47714
+ /** @description full (the default) returns every field. compact omits exactly these 17: model, stopReason, iterations, inputPreview, flowVersionId, agentVersionId, agentVersionLabel, agentVersionNumber, agentTargetResolution, otelProducer, lastHeartbeatAt, expiresAt, cancelRequestedAt, progress, pendingApproval, budgetExhausted and inputMessages. The status is still overlay-corrected on a compact page; only the fields differ. */
47705
47715
  view?: "compact" | "full";
47706
47716
  };
47707
47717
  header?: never;
@@ -65105,6 +65115,8 @@ interface components {
65105
65115
  kind: "agent" | "flow";
65106
65116
  /** @description Last heartbeat. Absent means the overlay did not answer, which is not false and not null. */
65107
65117
  lastHeartbeatAt?: string | null;
65118
+ /** @description Model of the run's first model call (served model when reported, otherwise requested model); null when no model call recorded one. */
65119
+ model?: string | null;
65108
65120
  /**
65109
65121
  * @description Where the run was dispatched from, taken from the caller's authenticated principal and never from a request field. ANY entrance that resolves a principal stamps it: a Clerk session answers dashboard; a management API key answers api, which includes the Runtype MCP server's tools and Code Mode, since both reach dispatch with a management key; and Runtype's own internal caller answers internal, for example the hosted /v1/mcp proxy. A lane that resolves NO principal carries NULL BY DESIGN: schedule, webhook, messaging, A2A, an agent exposed AS an MCP surface, subagent, nested flow, a client-token product surface (an end user is none of the three origins) and an ingested OTLP run. So NULL says "no authenticated principal at this entrance" rather than "unknown caller". The one NULL that is not a statement about the lane is a row whose header predates the field or came from the backfill: it stamps nothing even for a run that did resolve a principal.
65110
65122
  * @enum {string|null}
@@ -71798,11 +71810,18 @@ export declare class RecordsEndpoint {
71798
71810
  typeValue?: string;
71799
71811
  }): Promise<any>;
71800
71812
  /**
71801
- * Get record types (distinct values)
71813
+ * Get distinct record types, optionally including per-type counts and latest write timestamps.
71802
71814
  */
71803
- getTypes(): Promise<{
71815
+ getTypes(options?: {
71816
+ includeSummary?: boolean;
71817
+ }): Promise<{
71804
71818
  data: string[];
71805
71819
  total: number;
71820
+ summaries?: Array<{
71821
+ type: string;
71822
+ total: number;
71823
+ latestUpdatedAt: string | null;
71824
+ }>;
71806
71825
  }>;
71807
71826
  /**
71808
71827
  * Get example record by type and/or name
@@ -78007,6 +78026,8 @@ interface RunListRow {
78007
78026
  framework: string | null;
78008
78027
  endpointHost: string | null;
78009
78028
  } | null;
78029
+ /** Model of the run's first model call; null when no model call recorded one. */
78030
+ model?: string | null;
78010
78031
  stopReason?: string | null;
78011
78032
  iterations?: number | null;
78012
78033
  /**
@@ -78042,7 +78063,7 @@ interface RunListRow {
78042
78063
  interface RunListParams {
78043
78064
  agentId?: string | string[];
78044
78065
  flowId?: string | string[];
78045
- conversationId?: string;
78066
+ conversationId?: string | string[];
78046
78067
  surfaceId?: string;
78047
78068
  surfaceType?: string;
78048
78069
  recordId?: string;
package/dist/index.mjs CHANGED
@@ -4945,10 +4945,10 @@ var RecordsEndpoint = class {
4945
4945
  return this.client.postFormData("/records/upload-csv", formData);
4946
4946
  }
4947
4947
  /**
4948
- * Get record types (distinct values)
4948
+ * Get distinct record types, optionally including per-type counts and latest write timestamps.
4949
4949
  */
4950
- async getTypes() {
4951
- return this.client.get("/records?distinct=types");
4950
+ async getTypes(options) {
4951
+ return this.client.get(options?.includeSummary ? "/records?distinct=types&includeSummary=true" : "/records?distinct=types");
4952
4952
  }
4953
4953
  /**
4954
4954
  * Get example record by type and/or name
@@ -13943,7 +13943,12 @@ var RuntypeClient$1 = class {
13943
13943
  const relPath = path.startsWith("/") ? path.slice(1) : path;
13944
13944
  const url = new URL(relPath, base);
13945
13945
  if (params) Object.entries(params).forEach(([key, value]) => {
13946
- if (value !== void 0 && value !== null) url.searchParams.set(key, String(value));
13946
+ if (value !== void 0 && value !== null) {
13947
+ if (Array.isArray(value)) value.forEach((item) => {
13948
+ if (item !== void 0 && item !== null) url.searchParams.append(key, String(item));
13949
+ });
13950
+ else url.searchParams.set(key, String(value));
13951
+ }
13947
13952
  });
13948
13953
  return url.toString();
13949
13954
  }
@@ -14831,7 +14836,7 @@ function transformQueryParams(params) {
14831
14836
  return result;
14832
14837
  }
14833
14838
  // src/version.ts
14834
- const SDK_VERSION = "11.23.0";
14839
+ const SDK_VERSION = "11.24.0";
14835
14840
  /**
14836
14841
  * Canonical client identity the API uses for attribution
14837
14842
  * (`detectActorSource` in apps/api/src/lib/audit-log.ts keys `'sdk'` off the
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@runtypelabs/sdk",
3
- "version": "11.23.0",
3
+ "version": "11.24.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",
@@ -24,7 +24,7 @@
24
24
  ],
25
25
  "dependencies": {},
26
26
  "devDependencies": {
27
- "@runtypelabs/shared": "3.120.0",
27
+ "@runtypelabs/shared": "3.121.0",
28
28
  "openapi-typescript": "^7.13.0",
29
29
  "tsdown": "^0.23.2",
30
30
  "typescript": "^6.0.3",