node.js api

[pelikhan]

It's now easier to call genaiscript from another js/ts program

https://microsoft.github.io/genaiscript/blog/node-api/

[Colmea]

Thank you !

One question, let say I want to create dynamic scripts/prompts through my API. Is there an easy way to do that ?
I though about inlinePrompt but I'm not sure I understand how to use it with the CLI.

Another solution would be to simply use a script with a single big variable, and set the whole prompt from API to this variable, but not sure it's a good idea.

Btw, thank you so much for genAIScript. I'm building a software that I though impossible few months ago. I hope to share this soon.
Congrats from Belgium !

[pelikhan]

I see. You could read the content of stdin and use writeText/ importTemplate to "render" it then the execution would continue as usual.

// script.genai.mjs
const stdin = await getStdin()
writeText(stdin)

Then you can pipe text into your script:

cat prompt | genaiscript run ...

Also take a look at the copilot-chat script which acts as a universal starter script too.

[pelikhan]

I might have misunderstood your question. Are you looking for an API similar to runPrompt to assemble and run prompts on the fly? The current node.js api (run) is really meant to run an existing genai script.

[Colmea]

EDIT: your first answer is what I need. thank you !

==
Sorry I will reformulate:

My need: Basically, I have a web UI with a textarea. I want my user to be able to directly create a custom prompt and it's then run by genAI engine. No existing genAiScript used.

So I need to both create a promp on the fly and use the API.

The flow:
User prompt aCustomPrompt -> API call to my Node.js server -> call await run(aCustomPrompt )
(I know it's not posible to pass the custom prompt to the run() function, but you get the idea)

I think I'm confused on where I can use each command.
run() can run on a classic javascript/node.js environment, but runPrompt should run inside a genAiScript env, right ?

[pelikhan]

This sounds similar to the copilotchat script ( https://github.com/microsoft/genaiscript/blob/main/packages/sample/genaisrc/samples/copilotchat.genai.mts ). The user prompt is passed as a variable to genaiscript and inserted in the prompt using a def.

You really do NOT want to take a 3rd-party string and run it as a genaiscript source because of the security risks, since you would be basically running javascript in a node.js process on your server. Happy to chat more about this and I should probably discuss this in docs.

I think I'm confused on where I can use each command.
run() can run on a classic javascript/node.js environment, but runPrompt should run inside a genAiScript env, right ?

yes correct. runPrompt only exists when genaiscript is running the javavcscript. run is a basically like the cli run command but in a worker thread.