@runtypelabs/sdk 4.19.1 → 4.20.0

package/dist/index.cjs

@@ -64,11 +64,14 @@ __export(index_exports, {
   PromptsEndpoint: () => PromptsEndpoint,
   PromptsNamespace: () => PromptsNamespace,
   ProviderKeysEndpoint: () => ProviderKeysEndpoint,
+  RUNTYPE_CLIENT_KIND: () => RUNTYPE_CLIENT_KIND,
   RecordsEndpoint: () => RecordsEndpoint,
   Runtype: () => Runtype,
   RuntypeApiError: () => RuntypeApiError,
   RuntypeClient: () => RuntypeClient2,
   RuntypeFlowBuilder: () => RuntypeFlowBuilder,
+  SDK_USER_AGENT: () => SDK_USER_AGENT,
+  SDK_VERSION: () => SDK_VERSION,
   STEP_FIELD_REGISTRY: () => STEP_FIELD_REGISTRY,
   STEP_TYPE_TO_METHOD: () => STEP_TYPE_TO_METHOD,
   SchedulesEndpoint: () => SchedulesEndpoint,
@@ -140,6 +143,7 @@ __export(index_exports, {
   parseOffloadedOutputId: () => parseOffloadedOutputId,
   parseSSEChunk: () => parseSSEChunk,
   processStream: () => processStream,
+  pullFpo: () => pullFpo,
   registerWorkflowHook: () => registerWorkflowHook,
   resolveStallStopAfter: () => resolveStallStopAfter,
   resolveWorkflowHook: () => resolveWorkflowHook,
@@ -4423,13 +4427,17 @@ function defineFpo(fpo) {
   return fpo;
 }
 async function ensureFpo(client, fpo, options = {}) {
-  const { dryRun, onConflict } = options;
+  const { dryRun, onConflict, prune } = options;
   return client.post("/products/ensure-fpo", {
     fpo,
     ...dryRun ? { dryRun: true } : {},
-    ...onConflict ? { onConflict } : {}
+    ...onConflict ? { onConflict } : {},
+    ...prune ? { prune: true } : {}
   });
 }
+async function pullFpo(client, name) {
+  return client.get("/products/pull-fpo", { name });
+}
 
 // src/products-namespace.ts
 var ProductsNamespace = class {
@@ -4487,6 +4495,24 @@ var ProductsNamespace = class {
   async ensureFpo(fpo, options = {}) {
     return ensureFpo(this.getClient(), fpo, options);
   }
+  /**
+   * Reconstruct a self-contained Full Product Object from the live product graph
+   * (resolved by name) — the absorb-drift direction of `ensureFpo`. Feeding the
+   * returned `fpo` back into `ensureFpo` converges to `unchanged`.
+   *
+   * records/schedules/secrets are not reconstructed and `tools` is emitted empty
+   * (tool refs are portable `tool:<name>`); inspect `result.warnings` for
+   * per-pull caveats.
+   *
+   * @example
+   * ```typescript
+   * const { fpo } = await Runtype.products.pullFpo('Support Copilot')
+   * await Runtype.products.ensureFpo(fpo, { dryRun: true }) // → result: 'unchanged'
+   * ```
+   */
+  async pullFpo(name) {
+    return pullFpo(this.getClient(), name);
+  }
 };
 
 // src/surfaces-ensure.ts
@@ -5223,6 +5249,12 @@ var Runtype = class {
   }
 };
 
+// src/version.ts
+var FALLBACK_VERSION = "0.0.0";
+var SDK_VERSION = "4.20.0".length > 0 ? "4.20.0" : FALLBACK_VERSION;
+var RUNTYPE_CLIENT_KIND = "sdk";
+var SDK_USER_AGENT = `runtype-sdk/${SDK_VERSION} (typescript)`;
+
 // src/generated-tool-gate.ts
 var TOOL_NAME_PATTERN = /^[A-Za-z][A-Za-z0-9_]{1,63}$/;
 var DEFAULT_MAX_CODE_LENGTH = 12e3;
@@ -11609,6 +11641,14 @@ var RuntypeClient2 = class {
     this.timeout = config.timeout === void 0 ? 3e4 : config.timeout;
     this.headers = {
       "Content-Type": "application/json",
+      // Advertise client identity + version so the API can attribute SDK traffic
+      // (see detectActorSource in apps/api/src/lib/audit-log.ts). Defaults come
+      // first so callers that wrap this client with their own attribution — the
+      // CLI sends `X-Runtype-Client: cli` + `runtype-cli/<v>` — override them.
+      // `User-Agent` is a forbidden header in browsers and is silently dropped
+      // there; `X-Runtype-Client` is the reliable cross-environment signal.
+      "X-Runtype-Client": RUNTYPE_CLIENT_KIND,
+      "User-Agent": SDK_USER_AGENT,
       ...config.headers || {}
     };
     if (config.apiKey) {
@@ -11690,7 +11730,8 @@ var RuntypeClient2 = class {
       description: entry.description,
       parametersSchema: entry.parametersSchema,
       ...entry.origin ? { origin: entry.origin } : {},
-      ...entry.pageOrigin ? { pageOrigin: entry.pageOrigin } : {}
+      ...entry.pageOrigin ? { pageOrigin: entry.pageOrigin } : {},
+      ...entry.untrustedContentHint ? { untrustedContentHint: true } : {}
     })) : [];
     const modifiedRequest = {
       ...request6,
@@ -12878,11 +12919,14 @@ var STEP_TYPE_TO_METHOD = {
   PromptsEndpoint,
   PromptsNamespace,
   ProviderKeysEndpoint,
+  RUNTYPE_CLIENT_KIND,
   RecordsEndpoint,
   Runtype,
   RuntypeApiError,
   RuntypeClient,
   RuntypeFlowBuilder,
+  SDK_USER_AGENT,
+  SDK_VERSION,
   STEP_FIELD_REGISTRY,
   STEP_TYPE_TO_METHOD,
   SchedulesEndpoint,
@@ -12954,6 +12998,7 @@ var STEP_TYPE_TO_METHOD = {
   parseOffloadedOutputId,
   parseSSEChunk,
   processStream,
+  pullFpo,
   registerWorkflowHook,
   resolveStallStopAfter,
   resolveWorkflowHook,