Plan Documentation

Text Plans (Paternova™ v.0.9.9)

A text is an ordered list of Unicode characters. The following functions, or "plans," can be used to create, modify, calculate, read, write, and otherwise manipulate texts in Paternova.

Get a Text

These plans create a text using the information provided by the user.

Custom Text

Plan to generate a custom text.

Description

This plan generates a text based on the specified text x. The text parameter can be specified either as a text expression or as a reference to the output text in another cell. A text expression parameter is enclosed in a leading and a preceding quotes (") that are stripped to produce the output text.

Example

x = {Welcome☺}	⇒	{Welcome☺}
x = {"F14"}	⇒	{F14}

Fill Text

Plan to generate a filled text.

Description

This plan fills a text of length n with the characters in the text a. If there are not enough characters available in a, its last character is used to fill the remainder of the output text.

Example

n = {10};	a = {Welcome☺}	⇒	{Welcome☺☺☺}
n = {4};	a = {いらっしゃいませ}	⇒	{いらっし}

Import From Text File

Plan to import a text from a text file.

Description

This plan imports a text from a text file with the given file name. The complete file is imported to produce the output text.

Example

file name = {tests\text.txt}

⇒

{Texts need to be refreshed!}

Import From Network

Plan to import a text from network.

Description

This plan requests and imports a text from a network address.

Example

address = {https://www.npr.org}

⇒

{...}

Current Date/Time

Plan to generate a text for the current date and time.

Description

This plan generates a text to represent the current date and time with a specified format. Non-formatting characters, as well as any sequence of characters enclosed in single quotes (stripped of the quotes), even if it contains formatting characters, in format are included verbatim in the output text. Two consecutive single quotes ("''") are replaced by a single quote.

Example

format = {dd.MM.yyyy}	⇒	{27.05.2025}
format = {ddd MMMM d yy}	⇒	{Tue May 27 25}
format = {hh:mm:ss.zzz}	⇒	{08:51:35.720}
format = {hh:mm:ss.z}	⇒	{08:51:35.72}
format = {h:m:s ap}	⇒	{8:52:57 am}

Convert Array

Plan to generate a text from an array.

Description

This plan generates a text from the array x. The text representation of values in the array x, either separated by a delimiter or enclosed by ltag on the left and rtag on the right, are used to produce the output text. When specified, the format of the floating-point numbers is controlled by the width and precision parameters.

Example

x = {1,2,3,4,5,6,7};	delimiter = { \| }			⇒	{1 \| 2 \| 3 \| 4 \| 5 \| 6 \| 7}
x = {1,2,3,4,5,6,7};	ltag = {<};	rtag = {>}		⇒	{<1><2><3><4><5><6><7>}
x = {pi,-2,e};	delimiter = {, };	width = {8};	precision = {3}	⇒	{ 3.14, -2, 2.72}

Convert Matrix

Plan to generate a text from a matrix.

Description

This plan generates a text from the matrix x. The text representation of elements, separated by the specified e_delimiter in each row, and rows separated by the specified r_delimiter, are used to produce the output text. When specified, the format of the floating-point numbers is controlled by the width and precision parameters.

Example

x = {1,2,3;4,5,6};	e_delimiter = { \| };	r_delimiter = { ; }			⇒	{1+0I \| 2+0I \| 3+0I ; 4+0I \| 5+0I \| 6+0I}
x = {pi,2;e,-1};	e_delimiter = {,};	r_delimiter = {;};	width = {8};	precision = {3}	⇒	{ 3.14 +0I, 2 +0I; 2.72 +0I, -1 +0I}

Convert Text List

Plan to generate a text from a text list.

Description

This plan generates a text from the text list x. When the indices parameter is specified, only text items at those indices are used to produce the output text. The text items are separated by a delimiter, or enclosed by ltag on the left and rtag on the right, when specified.

Example

x = {ab,cd,ef};	indices = {};	delimiter = { ; }		⇒	{ab ; cd ; ef}
x = {ab,cd,ef};	indices = {1,0,1};	ltag = {<<};	rtag = {>>}	⇒	{<<cd>><<ab>><<cd>>}

Gemini - Vision

Plan to describe images with Gemini API.

Description

This plan generates a text description for the images x₀, x₁, etc. with a specified user message and a system message using the Gemini API. Requests are authenticated with an api key.

This plan is configured with several parameters: A higher value for the freq_penalty parameter leads to less repetitive tokens. max_tokens sets an upper bound for the number of tokens in the response. A higher value for the pres_penalty parameter leads to a larger vocabulary. A higher temperature parameter (between 0 and 2.0) leads to a more random and less deterministic response. Finally, top_p parameter (between 0 and 1.0) is an alternative to the temperature parameter.

Notes:

To acquire an api key, go to https://aistudio.google.com/apikey.
To learn more about the API parameters, visit https://ai.google.dev/gemini-api/docs/vision.
This plan requests data from Google's servers by sharing the plan parameters. The Terms of Service for Gemini are available at https://ai.google.dev/gemini-api/terms.
You may need to increase the network timeout (Preferences > Network Timeout) to allow enough time for the API response to arrive.
A corresponding plan to generate the complete API response is available under Text Plans/Get/3rd-Party Importers - Raw Response.

Example

user message = {What is in these photos?};

system message = {You are a cat.};

api key = {...};

x₀ = {flower(100,100)};

x₁ = {circle(50,blue)}

⇒

{...}

OpenAI - Vision

Plan to describe images with OpenAI API.

Description

This plan generates a text description for the images x₀, x₁, etc. with a specified user message and a developer message using the OpenAI API. Requests are authenticated with an api key.

This plan is configured with several parameters: A higher value for the freq_penalty parameter (between -2.0 and 2.0) leads to less repetitive tokens. max_tokens sets an upper bound for the number of the generated tokens. A higher value for the pres_penalty parameter (between -2.0 and 2.0) requests the model to talk about new things. A higher temperature parameter (between -2.0 and 2.0) leads to a more random and less deterministic response. Finally, top_p parameter (between 0 and 1.0) is an alternative to the temperature parameter.

Notes:

To acquire an api key, go to https://platform.openai.com.
To learn more about the API parameters, visit https://platform.openai.com/docs/guides/vision.
This plan requests data from OpenAI's servers by sharing the plan parameters. The Terms of Use for OpenAI are available at https://openai.com/policies/terms-of-use.
You may need to increase the network timeout (Preferences > Network Timeout) to allow enough time for the API response to arrive.
A corresponding plan to generate the complete API response is available under Text Plans/Get/3rd-Party Importers - Raw Response.

Example

user message = {What is in these photos?};

developer message = {You are a cat.};

api key = {...};

x₀ = {flower(100,100)};

x₁ = {circle(50,blue)}

⇒

{...}

Alpha Vantage - Response

Plan to produce a historical price request response from Alpha Vantage API.

Description

This plan produces the raw response for a request to import historical prices for a stock or cryptocurrency symbol from the Alpha Vantage API. Requests are made using the specified function and are authenticated with an api key. Some functions may require specifying an exchange market or a time interval. If not_adjusted is empty, the response will be adjusted for historical split and dividend events. If no_extended_hours is empty, the response will include the extended (pre- and post-market) trading hours (4:00 a.m. to 8:00 p.m. EST for the US market). If is_full is empty, the response will include only the most recent data.

Notes:

To acquire an api key, go to https://www.alphavantage.co/support.
To learn more about the API parameters, visit https://www.alphavantage.co/documentation.
This plan requests data from Alpha Vantage's servers by sharing the plan parameters. The Alpha Vantage privacy policy is available at https://www.alphavantage.co/privacy.
You may need to increase the network timeout (Preferences > Network Timeout) to allow enough time for the API response to arrive.
A corresponding plan to extract an output array from the API response is available under Array Plans/Get/3rd-Party Importers.

Example

function = {TIME_SERIES_DAILY};	symbol = {IBM};	token = {close};	market = {};	interval = {};	api key = {demo}	⇒	{...}
function = {CRYPTO_INTRADAY};	symbol = {ETH};	token = {high};	market = {USD};	interval = {5min};	api key = {demo}	⇒	{...}

Gemini - Vision Response

Plan to produce an image description request response from Gemini API.

Description

This plan produces the raw response for a text description request for the images x₀, x₁, etc. with a specified user message and a system message using the Gemini API. Requests are authenticated with an api key.

This plan is configured with several parameters: A higher value for the freq_penalty parameter leads to less repetitive tokens. max_tokens sets an upper bound for the number of tokens in the response. A higher value for the pres_penalty parameter leads to a larger vocabulary. A higher temperature parameter (between 0 and 2.0) leads to a more random and less deterministic response. Finally, top_p parameter (between 0 and 1.0) is an alternative to the temperature parameter.

Notes:

To acquire an api key, go to https://aistudio.google.com/apikey.
To learn more about the API parameters, visit https://ai.google.dev/gemini-api/docs/vision.
This plan requests data from Google's servers by sharing the plan parameters. The Terms of Service for Gemini are available at https://ai.google.dev/gemini-api/terms.
You may need to increase the network timeout (Preferences > Network Timeout) to allow enough time for the API response to arrive.
A corresponding plan to extract the output text from the API response is available under Text Plans/Get/3rd-Party Importers.

Example

user message = {What is in these photos?};

system message = {You are a cat.};

api key = {...};

x₀ = {flower(100,100)};

x₁ = {circle(50,blue)}

⇒

{...}

OpenAI - Image Generation Response

Plan to produce an image generation request response from OpenAI API.

Description

This plan produces the raw response for a request to generate a w×h image based on a prompt using the OpenAI API. Requests are authenticated with an api key.

Notes:

To acquire an api key, go to https://platform.openai.com.
To learn more about the API parameters, visit https://platform.openai.com/docs/api-reference/images/create.
This plan requests data from OpenAI's servers by sharing the plan parameters. The Terms of Use for OpenAI are available at https://openai.com/policies/terms-of-use.
You may need to increase the network timeout (Preferences > Network Timeout) to allow enough time for the API response to arrive.
A corresponding plan to extract the output image from the API response is available under Image Plans/Get/3rd-Party Importers.

Example

w = {1024};

h = {1024};

prompt = {A photograph of a fancy cat with a hat.};

api key = {...}

⇒

{...}

OpenAI - Image Edit Response

Plan to produce an image edit request response from OpenAI API.

Description

This plan produces the raw response for a request to edit a masked area in the image x, as defined by the transparent areas in the image mask, following a prompt. It uses the OpenAI API, with requests authenticated using an api key. The specified mask image is trimmed or extended by adding transparent rows and columns to match the size of image x.

Notes:

To acquire an api key, go to https://platform.openai.com.
To learn more about the API parameters, visit https://platform.openai.com/docs/api-reference/images/createEdit.
This plan requests data from OpenAI's servers by sharing the plan parameters. The Terms of Use for OpenAI are available at https://openai.com/policies/terms-of-use.
You may need to increase the network timeout (Preferences > Network Timeout) to allow enough time for the API response to arrive.
A corresponding plan to extract the output image from the API response is available under Image Plans/Modify an Image/3rd-Party Modifiers.

Example

x = {flower(512,512)};

mask = {circle(200,white)};

prompt = {A flower with fiery corners.};

api key = {...}

⇒

{...}

OpenAI - Image Variation Response

Plan to produce an image variation request response from OpenAI API.

Description

This plan produces the raw response to generate a variation of the image x using the OpenAI API. Requests are authenticated with an api key.

Notes:

To acquire an api key, go to https://platform.openai.com.
To learn more about the API parameters, visit https://platform.openai.com/docs/api-reference/images/createVariation.
This plan requests data from OpenAI's servers by sharing the plan parameters. The Terms of Use for OpenAI are available at https://openai.com/policies/terms-of-use.
You may need to increase the network timeout (Preferences > Network Timeout) to allow enough time for the API response to arrive.
A corresponding plan to extract the output image from the API response is available under Image Plans/Modify an Image/3rd-Party Modifiers.

Example

x = {flower(512,512)};

api key = {...}

⇒

{...}

OpenAI - Vision Response

Plan to produce an image description request response from OpenAI API.

Description

This plan produces the raw response for a request to generate a text description for the images x₀, x₁, etc. with a specified user message and a developer message using the OpenAI API. Requests are authenticated with an api key.

This plan is configured with several parameters: A higher value for the freq_penalty parameter (between -2.0 and 2.0) leads to less repetitive tokens. max_tokens sets an upper bound for the number of the generated tokens. A higher value for the pres_penalty parameter (between -2.0 and 2.0) requests the model to talk about new things. A higher temperature parameter (between -2.0 and 2.0) leads to a more random and less deterministic response. Finally, top_p parameter (between 0 and 1.0) is an alternative to the temperature parameter.

Notes:

To acquire an api key, go to https://platform.openai.com.
To learn more about the API parameters, visit https://platform.openai.com/docs/guides/vision.
This plan requests data from OpenAI's servers by sharing the plan parameters. The Terms of Use for OpenAI are available at https://openai.com/policies/terms-of-use.
You may need to increase the network timeout (Preferences > Network Timeout) to allow enough time for the API response to arrive.
A corresponding plan to extract the output text from the API response is available under Text Plans/Get/3rd-Party Importers.

Example

user message = {What is in these photos?};

developer message = {You are a cat.};

api key = {...};

x₀ = {flower(100,100)};

x₁ = {circle(50,blue)}

⇒

{...}

TextRequest - Image Message Response

Plan to produce the request response to send images over the cellular network with TextRequest API.

Description

This plan produces the raw response for a request to send the images x₀, x₁, etc. together with an optional text message, from a source phone number (assigned by TextRequest) to a destination mobile phone number using the TextRequest API. Requests are authenticated with an api key.

Notes:

To acquire an api key and a source phone number, go to https://www.textrequest.com/pricing.
To learn more about the API parameters, visit https://www.textrequest.com/api/v3#/.
This plan requests data from TextRequest's servers by sharing the plan parameters. The Terms of Service for TextRequest are available at https://www.textrequest.com/terms-of-service.
By calling the TextRequest API, users agree to follow the Acceptable Use Policy provided by TextRequest at https://www.textrequest.com/acceptable-use.
You may need to increase the network timeout (Preferences > Network Timeout) to allow enough time for the API response to arrive.
A corresponding plan to only post the request and ignore the response is available under Image Plans/Post/3rd-Party Exporters.

Example

source = {...};

destination = {...};

api key = {...};

message = {};

x₀ = {flower(100,100)};

x₁ = {circle(200,lightgreen)}

Rearrange a Text

These plans produce a text by rearranging another text.

Copy Text

Plan to copy a text.

Description

This plan copies all the characters in the text x.

Example

x = {Welcome☺}

⇒

{Welcome☺}

Replicate Text

Plan to replicate a text.

Description

This plan replicates the text x by duplicating each character m times, and then repeating the resulting text n times, producing {x[0](m times), x[1](m times),...}(n times).

Example

x = {Welcome ☺};

m = {2};

n = {3}

⇒

{WWeellccoommee ☺☺WWeellccoommee ☺☺WWeellccoommee ☺☺}

Resize Text From End

Plan to resize a text from the end.

Description

This plan resizes a copy of text x to a length of n by either removing characters from the end or filling the end with repeats of the text a.

Example

x = {Welcome!};	n = {10};	a = {~}	⇒	{Welcome!~~}
x = {いらっしゃいませ};	n = {4};	a = {~}	⇒	{いらっし}

Resize Text From Start

Plan to resize a text from the beginning.

Description

This plan resizes a copy of text x to a length of n by either removing characters from the beginning or filling the beginning with repeats of the text a.

Example

x = {Welcome!};	n = {10};	a = {~}	⇒	{~~Welcome!}
x = {いらっしゃいませ};	n = {4};	a = {~}	⇒	{ゃいませ}

Reverse Text

Plan to reverse a text.

Description

This plan reverses the order of the characters in a copy of text x.

Example

x = {Welcome☺}

⇒

{☺emocleW}

First Character

Plan to copy the first character.

Description

This plan copies the first character in the text x.

Example

x = {Welcome!}	⇒	{W}
x = {いらっしゃいませ}	⇒	{い}

Last Character

Plan to copy the last character.

Description

This plan copies the last character in the text x.

Example

x = {Welcome!}	⇒	{!}
x = {いらっしゃいませ}	⇒	{せ}

Copy Characters From Start

Plan to copy characters at indices counted from the beginning.

Description

This plan copies the characters at the indices specified by n from the text x to produce the output text. The result at index i is a copy of the n[i]-th character in the text x, counted from the beginning.

Example

x = {Welcome!};	n = {1}	⇒	{e}
x = {いらっしゃいませ};	n = {2,0,1,2,1,3}	⇒	{っいらっらし}

Copy Characters From End

Plan to copy characters at indices counted from the end.

Description

This plan copies the characters at the reverse indices specified by n from the text x to produce the output text. The result at index i is a copy of the n[i]-th character in the text x, counted from the end. Reverse indices traverse the text in reverse order.

Example

x = {Welcome!};	n = {1}	⇒	{e}
x = {いらっしゃいませ};	n = {2,0,1,2,1,3}	⇒	{いせまいまゃ}

Remove Characters From Start

Plan to remove characters at indices counted from the beginning.

Description

This plan removes, from a copy of text x, the characters at the indices specified by n[k] for each k.

Example

x = {Welcome!};	n = {1}	⇒	{Wlcome!}
x = {いらっしゃいませ};	n = {2,0,1,2,1,3}	⇒	{ゃいませ}

Remove Characters From End

Plan to remove characters at indices counted from the end.

Description

This plan removes, from a copy of text x, the characters at the reverse indices specified by n[k] for each k. Reverse indices traverse the text in reverse order.

Example

x = {Welcome!};	n = {1}	⇒	{Welcom!}
x = {いらっしゃいませ};	n = {2,0,1,2,1,3}	⇒	{いらっし}

Keep Ranges From Start

Plan to keep characters in index ranges counted from the beginning.

Description

This plan retains, in a copy of text x, only the characters at indices that fall within any of the ranges [a[k], b[k]).

Example

x = {Welcome!};	a = {0,2};	b = {1,5}	⇒	{Wlco}
x = {いらっしゃいませ};	a = {0,2};	b = {1,5}	⇒	{いっしゃ}

Keep Ranges From End

Plan to keep characters in index ranges counted from the end.

Description

This plan retains, in a copy of text x, only the characters at reverse indices that fall within any of the ranges [a[k], b[k]). Reverse indices traverse the text in reverse order.

Example

x = {Welcome!};	a = {0,2};	b = {1,5}	⇒	{com!}
x = {いらっしゃいませ};	a = {0,2};	b = {1,5}	⇒	{しゃいせ}

Remove Ranges From Start

Plan to remove characters in index ranges counted from the beginning.

Description

This plan removes, from a copy of text x, the characters at indices that fall within any of the ranges [a[k], b[k]).

Example

x = {Welcome!};	a = {0,2};	b = {1,5}	⇒	{eme!}
x = {いらっしゃいませ};	a = {0,2};	b = {1,5}	⇒	{らいませ}

Remove Ranges From End

Plan to remove characters in index ranges counted from the end.

Description

This plan removes, from a copy of text x, the characters at reverse indices that fall within any of the ranges [a[k], b[k]). Reverse indices traverse the text in reverse order.

Example

x = {Welcome!};	a = {0,2};	b = {1,5}	⇒	{Wele}
x = {いらっしゃいませ};	a = {0,2};	b = {1,5}	⇒	{いらっま}

Insert Characters From Start

Plan to insert characters at indices counted from the beginning.

Description

This plan inserts N[k] copies of a[k] into a copy of text x at index p[k] for each k. The last character in a and the last value in N are used when k is out of bounds. The text a may include escape sequences.

Example

x = {He!};	p = {2,2};	N = {2,1};	a = {lo}	⇒	{Hello!}
x = {らしいせ};	p = {0,1,2,3};	N = {1};	a = {いっゃま}	⇒	{いらっしゃいませ}

Insert Characters From End

Plan to insert characters at indices counted from the end.

Description

This plan inserts N[k] copies of a[k] into a copy of text x at reverse index p[k] for each k. The last character in a and the last value in N are used when k is out of bounds. The text a may include escape sequences. Reverse indices traverse the text in reverse order.

Example

x = {He!};	p = {1,1};	N = {1,2};	a = {ol}	⇒	{Hello!}
x = {いっゃま};	p = {0,1,2,3};	N = {1};	a = {せいしら}	⇒	{いらっしゃいませ}

Keep Characters

Plan to keep characters.

Description

This plan retains, in a copy of text x, only those characters that are equal to any of the characters in the text a. The text a may include escape sequences.

Example

x = {Welcome!};	a = {!abcdef}	⇒	{ece!}
x = {いらっしゃいませ};	a = {ゃら!}	⇒	{らゃ}

Remove Characters

Plan to remove characters.

Description

This plan removes, from a copy of text x, any characters that are equal to any of the characters in the text a. The text a may include escape sequences.

Example

x = {Welcome!};	a = {!abcdef}	⇒	{Wlom}
x = {いらっしゃいませ};	a = {ゃら!}	⇒	{いっしいませ}

Trim Side Characters

Plan to trim characters from the ends while equal to given characters.

Description

This plan removes characters from the beginning of a copy of text x as long as they are equal to any character in the text a, and removes characters from the end as long as they are equal to any character in the text b. The texts a and b may include escape sequences.

Example

x = {Welcome!};	a = {!abcdef};	b = {!abcdef}	⇒	{Welcom}
x = {いらっしゃいませ};	a = {ゃせいいら};	b = {ゃいいら}	⇒	{っしゃいませ}

Keep Subtexts

Plan to keep subtexts.

Description

This plan retains, in a copy of text x, only those subtexts that are equal to any of the text items in the text list a.

Example

x = {Welcome!};	a = {!,a,b,c,d,e,f}	⇒	{ece!}
x = {いらっしゃいませ};	a = {ませ,ゃら,っし,ab,!}	⇒	{っしませ}

Remove Subtexts

Plan to remove subtexts.

Description

This plan removes, from a copy of text x, any subtexts that are equal to any of the text items in the text list a.

Example

x = {Welcome!};	a = {!,a,b,c,d,e,f}	⇒	{Wlom}
x = {いらっしゃいませ};	a = {ませ,ゃら,っし,ab,!}	⇒	{いらゃい}

Rearrange Multiple Texts

These plans produce a text by rearranging multiple texts.

Conditional Copy

Plan to conditionally copy a text.

Description

This plan copies the text x if text z is not empty; otherwise, it copies the text y. Note that refresh requests are not propagated to the parameters x, y, and z.

Example

x = {Hello};	y = {World!};	z = {yes}	⇒	{Hello}
x = {Hello};	y = {World!};	z = {}	⇒	{World!}

Stitch

Plan to stitch texts.

Description

This plan combines copies of the given texts in the following order: {x₀[0],x₀[1],...,x₁[0],x₁[1],...} to produce the output text.

Example

x₀ = {Hello};

x₁ = { World!}

⇒

{Hello World!}

Stitch and Repeat

Plan to stitch and replicate texts.

Description

This plan produces the output text by copying each of the given texts m times and then replicating the resulting text n times. The output is structured as follows: {(x₀[0],x₀[1],...)(m times),(x₁[0],x₁[1],...)(m times),...}(n times).

Example

m = {2};

n = {3};

x₀ = {Ho};

x₁ = {!}

⇒

{HoHo!!HoHo!!HoHo!!}

Insert Texts From Start

Plan to insert texts at indices counted from the beginning.

Description

This plan inserts a copy of the text y_k into a copy of text x at index p[k] for each k. The last text among the y texts is used when k is out of bounds.

Example

x = {lo!};	p = {0,0,2};	y₀ = {He};	y₁ = {l};	y₂ = { World}	⇒	{Hello World!}
x = {lo};	p = {0,2,2,20};	y₀ = {Hel};	y₁ = { World};	y₂ = {!}	⇒	{Hello World!!}

Insert Texts From End

Plan to insert texts at indices counted from the end.

Description

This plan inserts a copy of the text y_k into a copy of text x at reverse index p[k] for each k. The last text among the y texts is used when k is out of bounds. Reverse indices traverse the text in reverse order.

Example

x = {lo!};	p = {3,3,1};	y₀ = {l};	y₁ = {He};	y₂ = { World}	⇒	{Hello World!}
x = {lo};	p = {20,0,0,0};	y₀ = {Hel};	y₁ = { World};	y₂ = {!}	⇒	{Hello!! World}

Characters From Texts

Plan to copy characters from texts.

Description

This plan copies the k-th character of the n[k]-th text for each index k, when available.

Example

n = {1};	x₀ = {Welcome!};	x₁ = {Hello};	x₂ = {World}	⇒	{H}
n = {1,0,1};	x₀ = {いらっし};	x₁ = {ゃいませ}		⇒	{ゃらま}

Modify a Text

These plans produce a text by modifying another text.

Set Characters From Start

Plan to set characters at indices counted from the beginning.

Description

This plan sets, in a copy of text x, the character at index n[k] to c[k] for each k. The last character in c is used when k is out of bounds. If c is not specified, those characters are removed instead.

Example

x = {Halo World!};	n = {1,3};	c = {ep}	⇒	{Help World!}
x = {いらっしゃいませ};	n = {7};	c = {す}	⇒	{いらっしゃいます}
x = {いらっしゃいませ};	n = {7};	c = {}	⇒	{いらっしゃいま}

Set Characters From End

Plan to set characters at indices counted from the end.

Description

This plan sets, in a copy of text x, the character at reverse index n[k] to c[k] for each k. The last character in c is used when k is out of bounds. If c is not specified, those characters are removed instead. Reverse indices traverse the text in reverse order.

Example

x = {Halo World!};	n = {1,3};	c = {ep}	⇒	{Halo Wople!}
x = {いらっしゃいませ};	n = {7};	c = {す}	⇒	{すらっしゃいませ}
x = {いらっしゃいませ};	n = {7};	c = {}	⇒	{らっしゃいませ}

Set Ranges From Start

Plan to set characters in index ranges counted from the beginning.

Description

This plan sets, in a copy of text x, the characters at indices that fall within the ranges [a[k], b[k]) to c[k] for each k. The last character in c is used when k is out of bounds. If c is not specified, those characters are removed instead. Similarly, the last values in a and b are used when k is out of bounds.

Example

x = {Halo World!};	a = {1,3};	b = {2,4};	c = {ep}	⇒	{Help World!}
x = {Halo World!};	a = {6};	b = {10};	c = {~p}	⇒	{Halo W~~~~!}
x = {いらっしゃいませ~~};	a = {7,8};	b = {8,10};	c = {す }	⇒	{いらっしゃいます }
x = {いらっしゃいませ~~};	a = {7,8};	b = {8,10};	c = {}	⇒	{いらっしゃいま}

Set Ranges From End

Plan to set characters in index ranges counted from the end.

Description

This plan sets, in a copy of text x, the characters at reverse indices that fall within the ranges [a[k], b[k]) to c[k] for each k. The last character in c is used when k is out of bounds. If c is not specified, those characters are removed instead. Similarly, the last values in a and b are used when k is out of bounds. Reverse indices traverse the text in reverse order.

Example

x = {Halo World!};	a = {1,3};	b = {2,4};	c = {ep}	⇒	{Halo Wople!}
x = {Halo World!};	a = {6};	b = {10};	c = {~p}	⇒	{H~~~~World!}
x = {いらっしゃいませ~~};	a = {7,8};	b = {8,10};	c = {す }	⇒	{ すっしゃいませ~~}
x = {いらっしゃいませ~~};	a = {7,8};	b = {8,10};	c = {}	⇒	{しゃいませ~~}

Replace Characters

Plan to replace characters.

Description

This plan replaces, in a copy of text x, any characters that are equal to a[k] with c[k] for each k. The last character in c is used when k is out of bounds. If c is not specified, those characters are removed instead. The texts a and c may include escape sequences.

Example

x = {Hello World!};	a = {o!a};	c = {u?}	⇒	{Hellu Wurld?}
x = {Hello World!};	a = {lmnop!};	c = {~}	⇒	{He~~~ W~rld~}
x = {いらっしゃいませ};	a = {せ};	c = {す}	⇒	{いらっしゃいます}
x = {いらっしゃいませ};	a = {せ};	c = {}	⇒	{いらっしゃいま}

Replace Subtexts

Plan to replace subtexts.

Description

This plan replaces, in a copy of text x, any subtexts that are equal to a[k] with c[k] for each k. The last text item in c is used when k is out of bounds. If c is not specified, those subtexts are removed instead.

Example

x = {Hello World!};	a = {World};	c = {Paternova}	⇒	{Hello Paternova!}
x = {Hello World!};	a = {Hello,World,!};	c = {Help,the World,?}	⇒	{Help the World?}
x = {いらっしゃいませ~~};	a = {せ,~};	c = {す}	⇒	{いらっしゃいますすす}
x = {いらっしゃいませ~~};	a = {せ,~};	c = {}	⇒	{いらっしゃいま}

Uppercase

Plan to convert to uppercase.

Description

This plan converts the characters in a copy of text x to uppercase.

Example

x = {Hello World!}

⇒

{HELLO WORLD!}

Lowercase

Plan to convert to lowercase.

Description

This plan converts the characters in a copy of text x to lowercase.

Example

x = {Hello World!}

⇒

{hello world!}

Gemini - Text Generation

Plan to convert a text with Gemini API.

Description

This plan converts the text x "user message" with a specified system message using the Gemini API. Requests are authenticated with an api key.

This plan is configured with several parameters: A higher value for the freq_penalty parameter leads to less repetitive tokens. max_tokens sets an upper bound for the number of tokens in the response. A higher value for the pres_penalty parameter leads to a larger vocabulary. A higher temperature parameter (between 0 and 2.0) leads to a more random and less deterministic response. Finally, top_p parameter (between 0 and 1.0) is an alternative to the temperature parameter.

Notes:

To acquire an api key, go to https://aistudio.google.com/apikey.
To learn more about the API parameters, visit https://ai.google.dev/gemini-api/docs/text-generation.
This plan requests data from Google's servers by sharing the plan parameters. The Terms of Service for Gemini are available at https://ai.google.dev/gemini-api/terms.
You may need to increase the network timeout (Preferences > Network Timeout) to allow enough time for the API response to arrive.
A corresponding plan to generate the complete API response is available under Text Plans/Modify a Text/3rd-Party Modifiers - Raw Response.

Example

x = {Write a haiku about recursion in programming.};	system message = {You are a cat.};	api key = {...}	⇒	{...}
x = {Write a calculator program in C++.};	system message = {};	api key = {...}	⇒	{...}

OpenAI - Text Generation

Plan to convert a text with OpenAI API.

Description

This plan converts the text x "user message" with a specified developer message using the OpenAI API. Requests are authenticated with an api key.

This plan is configured with several parameters: A higher value for the freq_penalty parameter (between -2.0 and 2.0) leads to less repetitive tokens. max_tokens sets an upper bound for the number of the generated tokens. A higher value for the pres_penalty parameter (between -2.0 and 2.0) requests the model to talk about new things. A higher temperature parameter (between -2.0 and 2.0) leads to a more random and less deterministic response. Finally, top_p parameter (between 0 and 1.0) is an alternative to the temperature parameter.

Notes:

To acquire an api key, go to https://platform.openai.com.
To learn more about the API parameters, visit https://platform.openai.com/docs/api-reference/chat.
This plan requests data from OpenAI's servers by sharing the plan parameters. The Terms of Use for OpenAI are available at https://openai.com/policies/terms-of-use.
You may need to increase the network timeout (Preferences > Network Timeout) to allow enough time for the API response to arrive.
A corresponding plan to generate the complete API response is available under Text Plans/Modify a Text/3rd-Party Modifiers - Raw Response.

Example

x = {Write a haiku about recursion in programming.};	developer message = {You are a cat.};	api key = {...}	⇒	{...}
x = {Write a calculator program in C++.};	developer message = {};	api key = {...}	⇒	{...}

DeepSeek - Text Generation

Plan to convert a text with DeepSeek API.

Description

This plan converts the text x "user message" with a specified system message using the DeepSeek API. Requests are authenticated with an api key.

This plan is configured with several parameters: A higher value for the freq_penalty parameter (between -2.0 and 2.0) leads to less repetitive tokens. max_tokens sets an upper bound for the number of the generated tokens. A higher value for the pres_penalty parameter (between -2.0 and 2.0) requests the model to talk about new things. A higher temperature parameter (between -2.0 and 2.0) leads to a more random and less deterministic response. Finally, top_p parameter (between 0 and 1.0) is an alternative to the temperature parameter.

Notes:

To acquire an api key, go to https://platform.deepseek.com/api_keys.
To learn more about the API parameters, visit https://api-docs.deepseek.com/api/create-chat-completion.
This plan requests data from DeepSeek's servers by sharing the plan parameters. The Terms of Service for DeepSeek are available at https://cdn.deepseek.com/policies/en-US/deepseek-open-platform-terms-of-service.html.
You may need to increase the network timeout (Preferences > Network Timeout) to allow enough time for the API response to arrive.
A corresponding plan to generate the complete API response is available under Text Plans/Modify a Text/3rd-Party Modifiers - Raw Response.

Example

x = {Write a haiku about recursion in programming.};	system message = {You are a cat.};	api key = {...}	⇒	{...}
x = {Write a calculator program in C++.};	system message = {};	api key = {...}	⇒	{...}

Gemini - Text Generation Response

Plan to produce a text conversion request response from Gemini API.

Description

This plan produces the raw response for a request to convert the text x "user message" with a specified system message using the Gemini API. Requests are authenticated with an api key.

This plan is configured with several parameters: A higher value for the freq_penalty parameter leads to less repetitive tokens. max_tokens sets an upper bound for the number of tokens in the response. A higher value for the pres_penalty parameter leads to a larger vocabulary. A higher temperature parameter (between 0 and 2.0) leads to a more random and less deterministic response. Finally, top_p parameter (between 0 and 1.0) is an alternative to the temperature parameter.

Notes:

To acquire an api key, go to https://aistudio.google.com/apikey.
To learn more about the API parameters, visit https://ai.google.dev/gemini-api/docs/text-generation.
This plan requests data from Google's servers by sharing the plan parameters. The Terms of Service for Gemini are available at https://ai.google.dev/gemini-api/terms.
You may need to increase the network timeout (Preferences > Network Timeout) to allow enough time for the API response to arrive.
A corresponding plan to extract the output text from the API response is available under Text Plans/Modify a Text/3rd-Party Modifiers.

Example

x = {Write a haiku about recursion in programming.};	system message = {You are a cat.};	api key = {...}	⇒	{...}
x = {Write a calculator program in C++.};	system message = {};	api key = {...}	⇒	{...}

OpenAI - Text Generation Response

Plan to produce a text conversion request response from OpenAI API.

Description

This plan produces the raw response for a request to convert the text x "user message" with a specified developer message using the OpenAI API. Requests are authenticated with an api key.

This plan is configured with several parameters: A higher value for the freq_penalty parameter (between -2.0 and 2.0) leads to less repetitive tokens. max_tokens sets an upper bound for the number of the generated tokens. A higher value for the pres_penalty parameter (between -2.0 and 2.0) requests the model to talk about new things. A higher temperature parameter (between -2.0 and 2.0) leads to a more random and less deterministic response. Finally, top_p parameter (between 0 and 1.0) is an alternative to the temperature parameter.

Notes:

To acquire an api key, go to https://platform.openai.com.
To learn more about the API parameters, visit https://platform.openai.com/docs/api-reference/chat.
This plan requests data from OpenAI's servers by sharing the plan parameters. The Terms of Use for OpenAI are available at https://openai.com/policies/terms-of-use.
You may need to increase the network timeout (Preferences > Network Timeout) to allow enough time for the API response to arrive.
A corresponding plan to extract the output text from the API response is available under Text Plans/Modify a Text/3rd-Party Modifiers.

Example

x = {Write a haiku about recursion in programming.};	developer message = {You are a cat.};	api key = {...}	⇒	{...}
x = {Write a calculator program in C++.};	developer message = {};	api key = {...}	⇒	{...}

DeepSeek - Text Generation Response

Plan to produce a text conversion request response from DeepSeek API.

Description

This plan produces the raw response for a request to convert the text x "user message" with a specified system message using the DeepSeek API. Requests are authenticated with an api key.

This plan is configured with several parameters: A higher value for the freq_penalty parameter (between -2.0 and 2.0) leads to less repetitive tokens. max_tokens sets an upper bound for the number of the generated tokens. A higher value for the pres_penalty parameter (between -2.0 and 2.0) requests the model to talk about new things. A higher temperature parameter (between -2.0 and 2.0) leads to a more random and less deterministic response. Finally, top_p parameter (between 0 and 1.0) is an alternative to the temperature parameter.

Notes:

To acquire an api key, go to https://platform.deepseek.com/api_keys.
To learn more about the API parameters, visit https://api-docs.deepseek.com/api/create-chat-completion.
This plan requests data from DeepSeek's servers by sharing the plan parameters. The Terms of Service for DeepSeek are available at https://cdn.deepseek.com/policies/en-US/deepseek-open-platform-terms-of-service.html.
You may need to increase the network timeout (Preferences > Network Timeout) to allow enough time for the API response to arrive.
A corresponding plan to extract the output text from the API response is available under Text Plans/Modify a Text/3rd-Party Modifiers.

Example

x = {Write a haiku about recursion in programming.};	system message = {You are a cat.};	api key = {...}	⇒	{...}
x = {Write a calculator program in C++.};	system message = {};	api key = {...}	⇒	{...}

Wolfram Alpha - Query Response

Plan to produce a text conversion request response from Wolfram Alpha API.

Description

This plan produces the raw response for a request to convert the text x "free-form query" using the Wolfram Alpha API. Requests are authenticated with an appid.

Notes:

To acquire an appid, go to https://developer.wolframalpha.com.
To learn more about the API parameters, visit https://products.wolframalpha.com/api/documentation.
This plan requests data from Wolfram|Alpha's servers by sharing the plan parameters. The Terms of Use for Wolfram|Alpha API are available at https://products.wolframalpha.com/api/termsofuse.
You may need to increase the network timeout (Preferences > Network Timeout) to allow enough time for the API response to arrive.

Example

x = {population of france};

appid = {DEMO}

⇒

{...}

TextRequest - Text Message Response

Plan to produce the request response to send a text message over the cellular network with TextRequest API.

Description

This plan produces the raw response for a request to send the text x "text message" from a source phone number (assigned by TextRequest) to a destination mobile phone number using the TextRequest API. Requests are authenticated with an api key.

Notes:

To acquire an api key and a source phone number, go to https://www.textrequest.com/pricing.
To learn more about the API parameters, visit https://www.textrequest.com/api/v3#/.
This plan requests data from TextRequest's servers by sharing the plan parameters. The Terms of Service for TextRequest are available at https://www.textrequest.com/terms-of-service.
By calling the TextRequest API, users agree to follow the Acceptable Use Policy provided by TextRequest at https://www.textrequest.com/acceptable-use.
You may need to increase the network timeout (Preferences > Network Timeout) to allow enough time for the API response to arrive.
A corresponding plan to only post the request and ignore the response is available under Text Plans/Post/3rd-Party Exporters.

Example

x = {Your bid is accepted!};

source = {...};

destination = {...};

api key = {...}

⇒

{...}

Modify Multiple Texts

These plans produce a text by modifying multiple texts.

Gemini - Multi-Turn Text Generation

Plan to convert multiple texts with Gemini API.

Description

This plan converts the texts x₀, x₁, etc. with a specified system message using the Gemini API. The text x_2i specifies the i-th user message, and x_2i+1 specifies its corresponding assistant message, i.e. the previous model response. Requests are authenticated with an api key.

This plan is configured with several parameters: A higher value for the freq_penalty parameter leads to less repetitive tokens. max_tokens sets an upper bound for the number of tokens in the response. A higher value for the pres_penalty parameter leads to a larger vocabulary. A higher temperature parameter (between 0 and 2.0) leads to a more random and less deterministic response. Finally, top_p parameter (between 0 and 1.0) is an alternative to the temperature parameter.

Notes:

To acquire an api key, go to https://aistudio.google.com/apikey.
To learn more about the API parameters, visit https://ai.google.dev/gemini-api/docs/text-generation.
This plan requests data from Google's servers by sharing the plan parameters. The Terms of Service for Gemini are available at https://ai.google.dev/gemini-api/terms.
You may need to increase the network timeout (Preferences > Network Timeout) to allow enough time for the API response to arrive.
A corresponding plan to generate the complete API response is available under Text Plans/Modify Multiple Texts/3rd-Party Modifiers - Raw Response.

Example

api key = {...};	system message = {You are a cat.};	x₀ = {Write a haiku about recursion in programming.}					⇒	{...}
api key = {...};	system message = {};	x₀ = {Write a calculator program in C++.}					⇒	{...}
api key = {...};	system message = {};	x₀ = {Knock Knock.};	x₁ = {Who’s there?};	x₂ = {Candice};	x₃ = {Candice who?};	x₄ = {Candice joke get any worse?}	⇒	{...}

OpenAI - Multi-Turn Text Generation

Plan to convert multiple texts with OpenAI API.

Description

This plan converts the texts x₀, x₁, etc. using the OpenAI API. The text x_3i specifies the i-th developer message, x_3i+1 specifies its corresponding user message, and x_3i+2 the corresponding assistant message, i.e. the previous model response. Requests are authenticated with an api key.

This plan is configured with several parameters: A higher value for the freq_penalty parameter (between -2.0 and 2.0) leads to less repetitive tokens. max_tokens sets an upper bound for the number of the generated tokens. A higher value for the pres_penalty parameter (between -2.0 and 2.0) requests the model to talk about new things. A higher temperature parameter (between -2.0 and 2.0) leads to a more random and less deterministic response. Finally, top_p parameter (between 0 and 1.0) is an alternative to the temperature parameter.

Notes:

To acquire an api key, go to https://platform.openai.com.
To learn more about the API parameters, visit https://platform.openai.com/docs/api-reference/chat.
This plan requests data from OpenAI's servers by sharing the plan parameters. The Terms of Use for OpenAI are available at https://openai.com/policies/terms-of-use.
You may need to increase the network timeout (Preferences > Network Timeout) to allow enough time for the API response to arrive.
A corresponding plan to generate the complete API response is available under Text Plans/Modify Multiple Texts/3rd-Party Modifiers - Raw Response.

Example

api key = {...};	x₀ = {You are a cat.};	x₁ = {Write a haiku about recursion in programming.}							⇒	{...}
api key = {...};	x₀ = {};	x₁ = {Write a calculator program in C++.}							⇒	{...}
api key = {...};	x₀ = {};	x₁ = {Knock Knock.};	x₂ = {Who’s there?};	x₃ = {};	x₄ = {Candice};	x₅ = {Candice who?};	x₆ = {};	x₇ = {Candice joke get any worse?}	⇒	{...}

DeepSeek - Multi-Turn Text Generation

Plan to convert multiple texts with DeepSeek API.

Description

This plan converts the texts x₀, x₁, etc. using the DeepSeek API. The text x_3i specifies the i-th system message, x_3i+1 specifies its corresponding user message, and x_3i+2 the corresponding assistant message, i.e. the previous model response. Requests are authenticated with an api key.

This plan is configured with several parameters: A higher value for the freq_penalty parameter (between -2.0 and 2.0) leads to less repetitive tokens. max_tokens sets an upper bound for the number of the generated tokens. A higher value for the pres_penalty parameter (between -2.0 and 2.0) requests the model to talk about new things. A higher temperature parameter (between -2.0 and 2.0) leads to a more random and less deterministic response. Finally, top_p parameter (between 0 and 1.0) is an alternative to the temperature parameter.

Notes:

To acquire an api key, go to https://platform.deepseek.com/api_keys.
To learn more about the API parameters, visit https://api-docs.deepseek.com/api/create-chat-completion.
This plan requests data from DeepSeek's servers by sharing the plan parameters. The Terms of Service for DeepSeek are available at https://cdn.deepseek.com/policies/en-US/deepseek-open-platform-terms-of-service.html.
You may need to increase the network timeout (Preferences > Network Timeout) to allow enough time for the API response to arrive.
A corresponding plan to generate the complete API response is available under Text Plans/Modify Multiple Texts/3rd-Party Modifiers - Raw Response.

Example

api key = {...};	x₀ = {You are a cat.};	x₁ = {Write a haiku about recursion in programming.}							⇒	{...}
api key = {...};	x₀ = {};	x₁ = {Write a calculator program in C++.}							⇒	{...}
api key = {...};	x₀ = {};	x₁ = {Knock Knock.};	x₂ = {Who’s there?};	x₃ = {};	x₄ = {Candice};	x₅ = {Candice who?};	x₆ = {};	x₇ = {Candice joke get any worse?}	⇒	{...}

Gemini - Multi-Turn Text Generation Response

Plan to produce a multi-turn text conversion request response from Gemini API.

Description

This plan produces the raw response for a request to convert the texts x₀, x₁, etc. with a specified system message using the Gemini API. The text x_2i specifies the i-th user message, and x_2i+1 specifies its corresponding assistant message, i.e. the previous model response. Requests are authenticated with an api key.

This plan is configured with several parameters: A higher value for the freq_penalty parameter leads to less repetitive tokens. max_tokens sets an upper bound for the number of tokens in the response. A higher value for the pres_penalty parameter leads to a larger vocabulary. A higher temperature parameter (between 0 and 2.0) leads to a more random and less deterministic response. Finally, top_p parameter (between 0 and 1.0) is an alternative to the temperature parameter.

Notes:

To acquire an api key, go to https://aistudio.google.com/apikey.
To learn more about the API parameters, visit https://ai.google.dev/gemini-api/docs/text-generation.
This plan requests data from Google's servers by sharing the plan parameters. The Terms of Service for Gemini are available at https://ai.google.dev/gemini-api/terms.
You may need to increase the network timeout (Preferences > Network Timeout) to allow enough time for the API response to arrive.
A corresponding plan to extract the output text from the API response is available under Text Plans/Modify Multiple Texts/3rd-Party Modifiers.

Example

api key = {...};	system message = {You are a cat.};	x₀ = {Write a haiku about recursion in programming.}					⇒	{...}
api key = {...};	system message = {};	x₀ = {Write a calculator program in C++.}					⇒	{...}
api key = {...};	system message = {};	x₀ = {Knock Knock.};	x₁ = {Who’s there?};	x₂ = {Candice};	x₃ = {Candice who?};	x₄ = {Candice joke get any worse?}	⇒	{...}

OpenAI - Multi-Turn Text Generation Response

Plan to produce a multi-turn text conversion request response from OpenAI API.

Description

This plan produces the raw response for a request to convert the texts x₀, x₁, etc. using the OpenAI API. The text x_3i specifies the i-th developer message, x_3i+1 specifies its corresponding user message, and x_3i+2 the corresponding assistant message, i.e. the previous model response. Requests are authenticated with an api key.

This plan is configured with several parameters: A higher value for the freq_penalty parameter (between -2.0 and 2.0) leads to less repetitive tokens. max_tokens sets an upper bound for the number of the generated tokens. A higher value for the pres_penalty parameter (between -2.0 and 2.0) requests the model to talk about new things. A higher temperature parameter (between -2.0 and 2.0) leads to a more random and less deterministic response. Finally, top_p parameter (between 0 and 1.0) is an alternative to the temperature parameter.

Notes:

To acquire an api key, go to https://platform.openai.com.
To learn more about the API parameters, visit https://platform.openai.com/docs/api-reference/chat.
This plan requests data from OpenAI's servers by sharing the plan parameters. The Terms of Use for OpenAI are available at https://openai.com/policies/terms-of-use.
You may need to increase the network timeout (Preferences > Network Timeout) to allow enough time for the API response to arrive.
A corresponding plan to extract the output text from the API response is available under Text Plans/Modify Multiple Texts/3rd-Party Modifiers.

Example

api key = {...};	x₀ = {You are a cat.};	x₁ = {Write a haiku about recursion in programming.}							⇒	{...}
api key = {...};	x₀ = {};	x₁ = {Write a calculator program in C++.}							⇒	{...}
api key = {...};	x₀ = {};	x₁ = {Knock Knock.};	x₂ = {Who’s there?};	x₃ = {};	x₄ = {Candice};	x₅ = {Candice who?};	x₆ = {};	x₇ = {Candice joke get any worse?}	⇒	{...}

DeepSeek - Multi-Turn Text Generation Response

Plan to produce a multi-turn text conversion request response from DeepSeek API.

Description

This plan produces the raw response for a request to convert the texts x₀, x₁, etc. using the DeepSeek API. The text x_3i specifies the i-th system message, x_3i+1 specifies its corresponding user message, and x_3i+2 the corresponding assistant message, i.e. the previous model response. Requests are authenticated with an api key.

This plan is configured with several parameters: A higher value for the freq_penalty parameter (between -2.0 and 2.0) leads to less repetitive tokens. max_tokens sets an upper bound for the number of the generated tokens. A higher value for the pres_penalty parameter (between -2.0 and 2.0) requests the model to talk about new things. A higher temperature parameter (between -2.0 and 2.0) leads to a more random and less deterministic response. Finally, top_p parameter (between 0 and 1.0) is an alternative to the temperature parameter.

Notes:

To acquire an api key, go to https://platform.deepseek.com/api_keys.
To learn more about the API parameters, visit https://api-docs.deepseek.com/api/create-chat-completion.
This plan requests data from DeepSeek's servers by sharing the plan parameters. The Terms of Service for DeepSeek are available at https://cdn.deepseek.com/policies/en-US/deepseek-open-platform-terms-of-service.html.
You may need to increase the network timeout (Preferences > Network Timeout) to allow enough time for the API response to arrive.
A corresponding plan to extract the output text from the API response is available under Text Plans/Modify Multiple Texts/3rd-Party Modifiers.

Example

api key = {...};	x₀ = {You are a cat.};	x₁ = {Write a haiku about recursion in programming.}							⇒	{...}
api key = {...};	x₀ = {};	x₁ = {Write a calculator program in C++.}							⇒	{...}
api key = {...};	x₀ = {};	x₁ = {Knock Knock.};	x₂ = {Who’s there?};	x₃ = {};	x₄ = {Candice};	x₅ = {Candice who?};	x₆ = {};	x₇ = {Candice joke get any worse?}	⇒	{...}

Highlight a Text

These plans produce a text by extracting information from another text.

Count of Characters

Plan to count characters.

Description

This plan counts the characters in the text x. The result is the number of characters in x.

Example

x = {Hello World!}

⇒

{12}

Count of Character Occurrences

Plan to count occurrences of given characters.

Description

This plan counts the number of characters in the text x that are equal to any of the characters in the text a. The result is the number of characters in x that match any character in a. The text a may include escape sequences.

Example

x = {Hello World!};	a = {o}	⇒	{2}
x = {Hello World!};	a = {lemon}	⇒	{6}
x = {Hello World!};	a = {World}	⇒	{8}

Count of Subtext Occurrences

Plan to count occurrences of given subtexts.

Description

This plan counts the number of subtexts in the text x that are equal to any of the text items in the text list a. The result is the number of subtexts in x that match any text item in a.

Example

x = {Hello World!};	a = {o}	⇒	{2}
x = {Hello World!};	a = {lemon}	⇒	{0}
x = {Hello World!};	a = {World,Hello}	⇒	{2}

Highlight Multiple Texts

These plans produce a text by extracting information from multiple texts.

Count of Texts with Any Character Occurrences

Plan to count texts containing any of the given characters.

Description

This plan counts the number of texts x_k that contain at least one character present in the text a. The result is the count of texts among x₀, x₁, etc. that have at least one character matching a character in a. The text a may include escape sequences.

Example

a = {o};	x₀ = {Hello };	x₁ = {World};	x₂ = {!}	⇒	{2}
a = {lemon!};	x₀ = {Hello };	x₁ = {World};	x₂ = {!}	⇒	{3}
a = {!World};	x₀ = {Hello };	x₁ = {World};	x₂ = {!}	⇒	{3}

Count of Texts with All Character Occurrences

Plan to count texts containing only the given characters.

Description

This plan counts the number of texts x_k that contain only characters present in the text a. The result is the count of texts among x₀, x₁, etc. that have only characters found in a. The text a may include escape sequences.

Example

a = {o};	x₀ = {Hello };	x₁ = {World};	x₂ = {!}	⇒	{0}
a = {lemon!};	x₀ = {Hello };	x₁ = {World};	x₂ = {!}	⇒	{1}
a = {!World};	x₀ = {Hello };	x₁ = {World};	x₂ = {!}	⇒	{2}

Count of Texts with Any Subtext Occurrences

Plan to count texts containing any of the given subtexts.

Description

This plan counts the number of texts x_k that contain at least one subtext present in the text list a. The result is the count of texts among x₀, x₁, etc. that have at least one subtext matching a text item in a.

Example

a = {o};	x₀ = {Hello };	x₁ = {World};	x₂ = {!}	⇒	{2}
a = {lemon!};	x₀ = {Hello };	x₁ = {World};	x₂ = {!}	⇒	{0}
a = {World,!,o};	x₀ = {Hello };	x₁ = {World};	x₂ = {!}	⇒	{3}

Count of Texts with All Subtext Occurrences

Plan to count texts containing only the given subtexts.

Description

This plan counts the number of texts x_k that contain only subtexts present in the text list a. The result is the count of texts among x₀, x₁, etc. that have only subtexts found in a.

Example

a = {o};	x₀ = {Hello };	x₁ = {World};	x₂ = {!}	⇒	{0}
a = {lemon!};	x₀ = {Hello };	x₁ = {World};	x₂ = {!}	⇒	{0}
a = {World,!,o};	x₀ = {Hello };	x₁ = {World};	x₂ = {!}	⇒	{2}

Post Texts

These plans output texts without producing any new data.

Export to Text File

Plan to export texts to a text file.

Description

This plan exports the texts x₀, x₁, etc. to a text file with the given file name. The exported texts are separated by the specified delimiter, which may include escape sequences. If the append parameter is not empty, the texts are appended to the end of the file.

Example

file name = {tests\text.txt};	append = {};	delimiter = {\n};	x₀ = {Hello};	x₁ = {World};	x₂ = {!!!}
file name = {tests\text.txt};	append = {Yes};	delimiter = {\n\n};	x₀ = {Hello};	x₁ = {Again!}

Insert into Database Row

Plan to insert texts into a database as a record.

Description

This plan exports the texts x₀, x₁, etc. to a database table as the fields of a new record. Databases are identified by their connection index as listed in the database manager. This plan opens the database connection if it is not open.

Example

table = {Persons};

index = {0};

x₀ = {0};

x₁ = {Tolkien};

x₂ = {John};

x₃ = {20 Northmoor Road};

x₄ = {Oxford}

⇒

{...}

Insert into Database Column

Plan to insert texts into a database as a column.

Description

This plan exports the texts x₀, x₁, etc. to a database table to populate a column. Databases are identified by their connection index as listed in the database manager. This plan opens the database connection if it is not open.

Example

x₃ = {141.1}

table = {2025-07-11-Mod1};

column = {capacity};

index = {0};

x₀ = {143.9};

x₁ = {142.0};

x₂ = {141.1};

⇒

{...}

SQL Statement

Plan to execute an sql statement on a database.

Description

This plan executes an sql statement on a database. Databases are identified by their connection index as listed in the database manager. This plan opens the database connection if it is not open.

Example

statement = {CREATE TABLE Persons (PersonID int, LastName varchar(255), FirstName varchar(255), Address varchar(255), City varchar(255))};

index = {0}

⇒

{...}

Export to Console

Plan to export texts to the standard output stream.

Description

This plan exports the texts x₀, x₁, etc. to the standard output stream which is typically the console. The exported texts are separated by the specified delimiter, which may include escape sequences.

Example

delimiter = {\n};

x₀ = {Hello};

x₁ = {World};

x₂ = {!!!}

TextRequest - Text Message

Plan to send a text message over the cellular network with TextRequest API.

Description

This plan sends the text x "text message" from a source phone number (assigned by TextRequest) to a destination mobile phone number using the TextRequest API. Requests are authenticated with an api key.

Notes:

To acquire an api key and a source phone number, go to https://www.textrequest.com/pricing.
To learn more about the API parameters, visit https://www.textrequest.com/api/v3#/.
This plan requests data from TextRequest's servers by sharing the plan parameters. The Terms of Service for TextRequest are available at https://www.textrequest.com/terms-of-service.
By calling the TextRequest API, users agree to follow the Acceptable Use Policy provided by TextRequest at https://www.textrequest.com/acceptable-use.
You may need to increase the network timeout (Preferences > Network Timeout) to allow enough time for the API response to arrive.
A corresponding plan to generate the complete API response is available under Text Plans/Modify a Text/3rd-Party Modifiers - Raw Response.

Example

x = {Your bid is accepted!};

source = {...};

destination = {...};

api key = {...}