@runtypelabs/sdk 4.19.2 → 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
@@ -5072,7 +5094,7 @@ var Runtype = class {
 
 // src/version.ts
 var FALLBACK_VERSION = "0.0.0";
-var SDK_VERSION = "4.19.2".length > 0 ? "4.19.2" : FALLBACK_VERSION;
+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)`;
 
@@ -12818,6 +12840,7 @@ export {
   parseOffloadedOutputId,
   parseSSEChunk,
   processStream,
+  pullFpo,
   registerWorkflowHook,
   resolveStallStopAfter,
   resolveWorkflowHook,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runtypelabs/sdk",
-  "version": "4.19.2",
+  "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",