Merge remote-tracking branch 'origin/master' into issue-14212

Author: michelle0927

components/cliento/cliento.app.mjs

@@ -0,0 +1,11 @@
+export default {
+  type: "app",
+  app: "cliento",
+  propDefinitions: {},
+  methods: {
+    // this.$auth contains connected account data
+    authKeys() {
+      console.log(Object.keys(this.$auth));
+    },
+  },
+};

components/cliento/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "@pipedream/cliento",
+  "version": "0.0.1",
+  "description": "Pipedream Cliento Components",
+  "main": "cliento.app.mjs",
+  "keywords": [
+    "pipedream",
+    "cliento"
+  ],
+  "homepage": "https://pipedream.com/apps/cliento",
+  "author": "Pipedream <[email protected]> (https://pipedream.com/)",
+  "publishConfig": {
+    "access": "public"
+  }
+}

components/twin/actions/browse/browse.mjs

@@ -0,0 +1,70 @@
+import twin from "../../twin.app.mjs";
+
+export default {
+  key: "twin-browse",
+  name: "Browse",
+  description: "Browse the internet with an AI web navigation agent that can find information for you. [See the documentation](https://docs.twin.so/api-reference/endpoint/browse)",
+  version: "0.0.1",
+  type: "action",
+  props: {
+    twin,
+    startUrl: {
+      type: "string",
+      label: "Start URL",
+      description: "The URL where the browsing task should begin",
+    },
+    goal: {
+      type: "string",
+      label: "Goal",
+      description: "The goal or objective of the browsing task. Example: \"Find the latest price of AAPL stock.\"",
+    },
+    outputType: {
+      type: "string",
+      label: "Output Type",
+      description: "The type of output expected from the task",
+      options: [
+        "string",
+        "url",
+        "list[url]",
+      ],
+      default: "string",
+      optional: true,
+    },
+    callbackWithRerun: {
+      type: "boolean",
+      label: "Callback With Rerun",
+      description: "Use the `$.flow.rerun` Node.js helper to rerun the step when the search is completed. This will increase execution time and credit usage as a result. [See the documentation](https://pipedream.com/docs/code/nodejs/rerun/#flow-rerun)",
+      optional: true,
+    },
+  },
+  async run({ $ }) {
+    let response, completionCallbackUrl;
+    const { run } = $.context;
+    if (run.runs === 1) {
+      if (this.callbackWithRerun) {
+        ({ resume_url: completionCallbackUrl } = $.flow.rerun(600000, null, 1));
+      }
+      response = await this.twin.browse({
+        $,
+        data: {
+          startUrl: this.startUrl,
+          goal: this.goal,
+          outputType: this.outputType,
+          completionCallbackUrl,
+        },
+      });
+    }
+
+    if (run.callback_request) {
+      const { task_id: taskId } = run.callback_request.body;
+      response = await this.twin.getTask({
+        taskId,
+      });
+    }
+
+    if (response.status === "COMPLETED") {
+      $.export("$summary", "Successfully completed browsing");
+    }
+    return response;
+  },
+};

components/twin/actions/get-task-details/get-task-details.mjs

@@ -0,0 +1,26 @@
+import twin from "../../twin.app.mjs";
+
+export default {
+  key: "twin-get-task-details",
+  name: "Get Task Details",
+  description: "Retrieve details of a specific task. [See the documentation](https://docs.twin.so/api-reference/endpoint/get-task)",
+  version: "0.0.1",
+  type: "action",
+  props: {
+    twin,
+    taskId: {
+      propDefinition: [
+        twin,
+        "taskId",
+      ],
+    },
+  },
+  async run({ $ }) {
+    const response = await this.twin.getTask({
+      $,
+      taskId: this.taskId,
+    });
+    $.export("$summary", `Successfully retrieved details for task with ID: ${this.taskId}`);
+    return response;
+  },
+};

components/twin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pipedream/twin",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "description": "Pipedream Twin Components",
   "main": "twin.app.mjs",
   "keywords": [
@@ -11,5 +11,8 @@
   "author": "Pipedream <[email protected]> (https://pipedream.com/)",
   "publishConfig": {
     "access": "public"
+  },
+  "dependencies": {
+    "@pipedream/platform": "^3.0.3"
   }
-}
+}

components/twin/twin.app.mjs

@@ -1,11 +1,64 @@
+import { axios } from "@pipedream/platform";
+
 export default {
   type: "app",
   app: "twin",
-  propDefinitions: {},
+  propDefinitions: {
+    taskId: {
+      type: "string",
+      label: "Task ID",
+      description: "Identifier of a task",
+      async options() {
+        const tasks = await this.listTasks();
+        return tasks?.map(({
+          id: value, goal,
+        }) => ({
+          value,
+          label: `${goal.slice(0, 50)}...`,
+        })) || [];
+      },
+    },
+  },
   methods: {
-    // this.$auth contains connected account data
-    authKeys() {
-      console.log(Object.keys(this.$auth));
+    _baseUrl() {
+      return "https://api.twin.so";
+    },
+    _headers() {
+      return {
+        "x-api-key": this.$auth.api_key,
+      };
+    },
+    _makeRequest({
+      $ = this,
+      path,
+      ...args
+    }) {
+      return axios($, {
+        url: `${this._baseUrl()}${path}`,
+        headers: this._headers(),
+        ...args,
+      });
+    },
+    browse(args = {}) {
+      return this._makeRequest({
+        method: "POST",
+        path: "/browse",
+        ...args,
+      });
+    },
+    getTask({
+      taskId, ...args
+    }) {
+      return this._makeRequest({
+        path: `/task/${taskId}`,
+        ...args,
+      });
+    },
+    listTasks(args = {}) {
+      return this._makeRequest({
+        path: "/tasks",
+        ...args,
+      });
     },
   },
-};
+};

docs-v2/pages/code/nodejs/index.mdx

@@ -352,6 +352,27 @@ In general, if you just need to make an HTTP request but don't care about the re
 
 You can return HTTP responses from [HTTP-triggered workflows](/workflows/steps/triggers/#http) using the [`$.respond()` function](/workflows/steps/triggers/#http-responses).
 
+## Invoke another workflow
+
+<Callout type="warning">
+This is an alpha feature and is subject to change without prior notice.
+</Callout>
+
+You can invoke another workflow in your workspace with `$.flow.trigger`:
+
+```
+await $.flow.trigger(
+  workflowId, // your Pipedream workflow ID, e.g. p_abc123
+  payload, // any JSON-serializable data
+)
+```
+
+[Find your workflow's ID here.](/troubleshooting#where-do-i-find-my-workflows-id)
+
+This invokes the workflow directly -- you don't need to configure a trigger, and the request does not leave the platform.
+
+We also provide a [Trigger Workflow](https://pipedream.com/apps/helper-functions/actions/trigger-workflow) action in the [Helper Functions](https://pipedream.com/apps/helper-functions) app so you don't need to do it by code!
+
 ## Ending a workflow early
 
 <VideoPlayer title="Conditionally run Workflows" src="https://www.youtube.com/embed/sajgIH3dG58" startAt="205" />

docs-v2/pages/troubleshooting.mdx

@@ -62,6 +62,12 @@ https://pipedream.com/@dylburger/p_abc123/edit
 
 Your workflow's ID is the value that starts with `p_`. In this example: `p_abc123`.
 
+## How do I invoke another workflow?
+
+We provide a [Trigger Workflow](https://pipedream.com/apps/helper-functions/actions/trigger-workflow) action in the [Helper Functions](https://pipedream.com/apps/helper-functions) app. [See more here](/code/nodejs#invoke-another-workflow).
+
+Another option is to make an HTTP request to a Pipedream HTTP webhook trigger.
+
 ## Where do I find my event source's ID?
 
 Open [https://pipedream.com/sources](https://pipedream.com/sources) and click on your event source. Copy the URL that appears in your browser's address bar. For example: