@runtypelabs/sdk 4.19.1 → 4.20.0

package/dist/index.mjs

@@ -4270,13 +4270,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 {
@@ -4334,6 +4338,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
@@ -5070,6 +5092,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;
@@ -11456,6 +11484,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) {
@@ -11537,7 +11573,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,
@@ -12724,11 +12761,14 @@ export {
   PromptsEndpoint,
   PromptsNamespace,
   ProviderKeysEndpoint,
+  RUNTYPE_CLIENT_KIND,
   RecordsEndpoint,
   Runtype,
   RuntypeApiError,
   RuntypeClient2 as RuntypeClient,
   RuntypeFlowBuilder,
+  SDK_USER_AGENT,
+  SDK_VERSION,
   STEP_FIELD_REGISTRY,
   STEP_TYPE_TO_METHOD,
   SchedulesEndpoint,
@@ -12800,6 +12840,7 @@ export {
   parseOffloadedOutputId,
   parseSSEChunk,
   processStream,
+  pullFpo,
   registerWorkflowHook,
   resolveStallStopAfter,
   resolveWorkflowHook,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runtypelabs/sdk",
-  "version": "4.19.1",
+  "version": "4.20.0",
   "type": "module",
   "description": "TypeScript SDK for the Runtype API with fluent methods. Use it to quickly realize AI products, agents, and workflows.",
   "main": "dist/index.cjs",