@j-o-r/hello-dave 0.1.1 → 0.1.4

package/lib/API/openai.com/{reponses/text.js → responses.js}

@@ -3,7 +3,7 @@ https://platform.openai.com/docs/api-reference/responses/create
 Allthough we can use store = true and previous_response_id: response.id,
 Stil all tokens are billed.
 */
-import { GLOBAL } from '../../../fafs.js'
+import { GLOBAL } from '../../fafs.js'
 import { request as doRequest } from '@j-o-r/apiserver';
 import { sleep } from '@j-o-r/sh';
 /**
@@ -22,7 +22,7 @@ import { sleep } from '@j-o-r/sh';
 * @property {number} [max_output_tokens=4000] - Maximum number of output tokens.
 * @property {number} [max_tool_calls=10] - Maximum number of tool calls allowed.
 * @property {?Object} [metadata=null] - Optional metadata object.
-* @property {'gpt-5.4'|'gpt-5-mini'|'gpt-5-nano'|'gpt-5-pro'} [model='gpt-5-mini'] - Model version to use.
+* @property {'gpt-5.5'|'gpt-5.4'|'gpt-5.4-mini'} [model='gpt-5.4-mini'] - Model version to use.
 * @property {?string} [prompt=null] - Reusable prompt string.
 * @property {Object} [reasoning={effort: 'medium', summary: 'auto'}] - Reasoning configuration.
 * @property {'low'|'medium'|'high'|null} reasoning.effort - Effort level for reasoning.
@@ -37,8 +37,8 @@ import { sleep } from '@j-o-r/sh';
 * @property {boolean} [parallel_tool_calls=true] - Allow parallel tool calls if true.
 * @property {'auto'} [tool_choice='auto'] - Tool choice setting, default is auto-selected.
 * @property {OpenAITool[]} [tools=[]] - Array of tool objects: custom function tools (`OAToolCall`) or built-in OpenAI tools (e.g., `{type: "web_search_preview"}`).
-* @property {?number } top_logprobs=null An integer between 0 and 20 specifying the number of most likely tokens to return at each token position, each with an associated log probability.
-* @property {?number } top_p=1 Top-p sampling value between 0 and 1.
+* @property {?number } [top_logprobs=null] An integer between 0 and 20 specifying the number of most likely tokens to return at each token position, each with an associated log probability.
+* @property {?number } [top_p=1] Top-p sampling value between 0 and 1.
 * @property {?string} [previous_response_id] - Needed reponse_id to validate tool calls on the next request
 */
 /**
@@ -101,7 +101,7 @@ const API_URL = 'https://api.openai.com/v1/responses';
 * Get the default headers
 * @returns {object}
 */
-const getHeaders = (USER_AGENT = '@j-o-r/agents') => {
+const getHeaders = (USER_AGENT = '@j-o-r/hello-world') => {
 	if (!process.env['OPENAIKEY']) {
 		throw new Error('Missing OPENAIKEY!export OPENAIKEY=<OPENAI_API_KEY>')
 	}
@@ -196,7 +196,40 @@ const generateHistory = (messages) => {
 	}, []);
 }
 
-
+/**
+ * Convert only the latest tool response message to OpenAI Responses API
+ * `function_call_output` input items.
+ *
+ * This is required when `previous_response_id` is set: OpenAI already has the
+ * assistant function_call items from the previous response, so the follow-up
+ * request should contain only the matching function_call_output items.
+ *
+ * @param {import('../../../Prompt.js').Message[]} messages - Prompt messages.
+ * @returns {OAFunctionCallOutput[]} Latest function call outputs.
+ * @throws {Error} If the last message is not a tool response message.
+ */
+const generateLastFunctionCallOutputs = (messages) => {
+	const last = messages[messages.length - 1];
+	if (!last || last.role !== 'tool') {
+		throw new Error('Expected last message to be tool when previous_response_id is set');
+	}
+	const outputs = last.content.map(
+		/** @param {import('../../../Prompt.js').FunctionResponse} item */
+		(item) => {
+			if (item.type === 'function_response') {
+				return {
+					type: 'function_call_output',
+					call_id: item.function_response.call_id,
+					output: item.function_response.response
+				}
+			}
+		}
+	).filter(item => item !== undefined);
+	if (outputs.length === 0) {
+		throw new Error('Expected at least one function_response in last tool message');
+	}
+	return outputs;
+}
 
 // tools": [{"type": "web_search_preview"}],
 //** @type {OAOptions} */
@@ -208,7 +241,7 @@ const defaultSettings = {
 	// instructions: '',
 	// max_output_tokens: 4000,
 	// metadata: null,
-	model: 'o3',
+	model: 'gpt-5.4-mini',
 	// // https://platform.openai.com/docs/guides/text?api-mode=responses#reusable-prompts
 	// prompt: null,
 	// https://platform.openai.com/docs/api-reference/responses/create#responses-create-reasoning
@@ -223,9 +256,8 @@ const defaultSettings = {
 	// temperature: 0.2, // value between 0 -2
 	// text: { format: { type: "text" } }, // optional
 	parallel_tool_calls: true,
-	max_tool_calls: 10,
-	// // tool_choice: 'auto', // optional
-	// // tools: [], 
+	// tool_choice: 'auto', // optional
+	tools: [], 
 	// top_logprobs: 0,
 	// top_p: 1,
 	// truncation: null,
@@ -239,19 +271,33 @@ const defaultSettings = {
 * @param {ToolSet} [toolset]
 * @param {OAOptions} [options]
 */
-function getBody(prompt, toolset, options) {
+function getBody(prompt, toolset, options = {}) {
 	// From the messages I only want assistant and user
 	/** @type {OAOptions} */
 	// @ts-ignore
 	const body = { ...defaultSettings, ...options };
 	// const body = options ? mergeOptions(DEFAULT_OPTIONS, options) : DEFAULT_OPTIONS;
 	body.instructions = prompt.hasSystemprompt ? prompt.system_prompt : '';
-	// the last messages should be a role tool or user else the model cannot handle the request
-	const messages = prompt.messages;
-	if (!['user', 'tool'].includes(messages[messages.length - 1].role)) {
-		throw new Error('Missing last user question or tool');
+
+	if (body.previous_response_id) {
+		// Recursive tool-continuation request: send only the latest tool outputs.
+		// Sending full history here can make OpenAI reject the request because the
+		// referenced function_call items already live under previous_response_id.
+		const messages = prompt.messages;
+		body.input = generateLastFunctionCallOutputs(messages);
+	} else {
+		// Fresh/stateless request: reduce tokens and prevent conflicts before
+		// copying prompt.messages. prompt.messages returns a deep copy, so pruning
+		// after this line would not affect the history sent in this request.
+		prompt.pruneResolvedFunctionCallsExceptLast();
+
+		// the last messages should be a role tool or user else the model cannot handle the request
+		const messages = prompt.messages;
+		if (!['user', 'tool'].includes(messages[messages.length - 1].role)) {
+			throw new Error('Missing last user question or tool');
+		}
+		body.input = generateHistory(messages);
 	}
-	body.input = generateHistory(messages);
 	if (toolset) {
 		// @ts-ignore
 		body.tool_choice = toolset.toolChoice;
@@ -308,7 +354,7 @@ function parseMessages(messages, prompt) {
 			}
 		} else if (type === 'image_generation_call') {
 			prompt.addMultiModal('assistant', [{ type: 'image_url', url: msg.result }]);
-		} else if (type === 'function_call' || msg.status === 'complete') {
+		} else if (type === 'function_call') {
 			toolcall.push({
 				type: 'function_request',
 				function_request: {
@@ -363,7 +409,7 @@ async function parseResponse(duration, prompt, res, toolset) {
 * @param {number} [counter] - leave empty this counts the number of requests when doing recursive request calls
 * @return {Promise<import('../../../Session.js').Message>}
 */
-async function request(prompt, toolset = null, options, counter = 0) {
+async function request(prompt, toolset = null, options = {}, counter = 0) {
 	// Max number of recurusive calls
 	const counterMax = GLOBAL.max_recursive_requests;
 	const start = new Date().getTime();

package/lib/API/openai.com/video.create.character.md

@@ -0,0 +1,40 @@
+## Create a character from an uploaded video.
+[source](https://developers.openai.com/api/reference/resources/videos/methods/create_character)
+**post** `/videos/characters`
+
+Create a character from an uploaded video.
+
+### Returns
+
+- `id: string`
+
+  Identifier for the character creation cameo.
+
+- `created_at: number`
+
+  Unix timestamp (in seconds) when the character was created.
+
+- `name: string`
+
+  Display name for the character.
+
+### Example
+
+```http
+curl https://api.openai.com/v1/videos/characters \
+    -H 'Content-Type: multipart/form-data' \
+    -H "Authorization: Bearer $OPENAI_API_KEY" \
+    -F name=x \
+    -F 'video=@/path/to/video'
+```
+
+#### Response
+
+```json
+{
+  "id": "id",
+  "created_at": 0,
+  "name": "name"
+}
+```
+

package/lib/API/openai.com/video.create.md

@@ -0,0 +1,219 @@
+## [Create video](https://developers.openai.com/api/reference/resources/videos/methods/create)
+
+**post** `/videos`
+
+Create a new video generation job from a prompt and optional reference assets.
+
+### Body Parameters
+
+- `prompt: string`
+
+  Text prompt that describes the video to generate.
+
+- `input_reference: optional ImageInputReferenceParam`
+
+  Optional reference object that guides generation. Provide exactly one of `image_url` or `file_id`.
+
+  - `file_id: optional string`
+
+  - `image_url: optional string`
+
+    A fully qualified URL or base64-encoded data URL.
+
+- `model: optional VideoModel`
+
+  The video generation model to use (allowed values: sora-2, sora-2-pro). Defaults to `sora-2`.
+
+  - `string`
+
+  - `"sora-2" or "sora-2-pro" or "sora-2-2025-10-06" or 2 more`
+
+    - `"sora-2"`
+
+    - `"sora-2-pro"`
+
+    - `"sora-2-2025-10-06"`
+
+    - `"sora-2-pro-2025-10-06"`
+
+    - `"sora-2-2025-12-08"`
+
+- `seconds: optional VideoSeconds`
+
+  Clip duration in seconds (allowed values: 4, 8, 12). Defaults to 4 seconds.
+
+  - `"4"`
+
+  - `"8"`
+
+  - `"12"`
+
+- `size: optional VideoSize`
+
+  Output resolution formatted as width x height (allowed values: 720x1280, 1280x720, 1024x1792, 1792x1024). Defaults to 720x1280.
+
+  - `"720x1280"`
+
+  - `"1280x720"`
+
+  - `"1024x1792"`
+
+  - `"1792x1024"`
+
+### Returns
+
+- `Video object { id, completed_at, created_at, 10 more }`
+
+  Structured information describing a generated video job.
+
+  - `id: string`
+
+    Unique identifier for the video job.
+
+  - `completed_at: number`
+
+    Unix timestamp (seconds) for when the job completed, if finished.
+
+  - `created_at: number`
+
+    Unix timestamp (seconds) for when the job was created.
+
+  - `error: VideoCreateError`
+
+    Error payload that explains why generation failed, if applicable.
+
+    - `code: string`
+
+      A machine-readable error code that was returned.
+
+    - `message: string`
+
+      A human-readable description of the error that was returned.
+
+  - `expires_at: number`
+
+    Unix timestamp (seconds) for when the downloadable assets expire, if set.
+
+  - `model: VideoModel`
+
+    The video generation model that produced the job.
+
+    - `string`
+
+    - `"sora-2" or "sora-2-pro" or "sora-2-2025-10-06" or 2 more`
+
+      - `"sora-2"`
+
+      - `"sora-2-pro"`
+
+      - `"sora-2-2025-10-06"`
+
+      - `"sora-2-pro-2025-10-06"`
+
+      - `"sora-2-2025-12-08"`
+
+  - `object: "video"`
+
+    The object type, which is always `video`.
+
+    - `"video"`
+
+  - `progress: number`
+
+    Approximate completion percentage for the generation task.
+
+  - `prompt: string`
+
+    The prompt that was used to generate the video.
+
+  - `remixed_from_video_id: string`
+
+    Identifier of the source video if this video is a remix.
+
+  - `seconds: string`
+
+    Duration of the generated clip in seconds. For extensions, this is the stitched total duration.
+
+  - `size: VideoSize`
+
+    The resolution of the generated video.
+
+    - `"720x1280"`
+
+    - `"1280x720"`
+
+    - `"1024x1792"`
+
+    - `"1792x1024"`
+
+  - `status: "queued" or "in_progress" or "completed" or "failed"`
+
+    Current lifecycle status of the video job.
+
+    - `"queued"`
+
+    - `"in_progress"`
+
+    - `"completed"`
+
+    - `"failed"`
+
+### Example
+
+```http
+curl https://api.openai.com/v1/videos \
+    -H 'Content-Type: application/json' \
+    -H "Authorization: Bearer $OPENAI_API_KEY" \
+    -d '{
+          "prompt": "x"
+        }'
+```
+
+#### Response
+
+```json
+{
+  "id": "id",
+  "completed_at": 0,
+  "created_at": 0,
+  "error": {
+    "code": "code",
+    "message": "message"
+  },
+  "expires_at": 0,
+  "model": "sora-2",
+  "object": "video",
+  "progress": 0,
+  "prompt": "prompt",
+  "remixed_from_video_id": "remixed_from_video_id",
+  "seconds": "seconds",
+  "size": "720x1280",
+  "status": "queued"
+}
+```
+
+### Example
+
+```http
+curl https://api.openai.com/v1/videos \
+  -H "Authorization: Bearer $OPENAI_API_KEY" \
+  -F "model=sora-2" \
+  -F "prompt=A calico cat playing a piano on stage"
+```
+
+#### Response
+
+```json
+{
+  "id": "video_123",
+  "object": "video",
+  "model": "sora-2",
+  "status": "queued",
+  "progress": 0,
+  "created_at": 1712697600,
+  "size": "1024x1792",
+  "seconds": "8",
+  "quality": "standard"
+}
+```
+

package/lib/API/openai.com/video.delete.md

@@ -0,0 +1,44 @@
+## [Delete video](https://developers.openai.com/api/reference/resources/videos/methods/delete)
+
+**delete** `/videos/{video_id}`
+
+Permanently delete a completed or failed video and its stored assets.
+
+### Path Parameters
+
+- `video_id: string`
+
+### Returns
+
+- `id: string`
+
+  Identifier of the deleted video.
+
+- `deleted: boolean`
+
+  Indicates that the video resource was deleted.
+
+- `object: "video.deleted"`
+
+  The object type that signals the deletion response.
+
+  - `"video.deleted"`
+
+### Example
+
+```http
+curl https://api.openai.com/v1/videos/$VIDEO_ID \
+    -X DELETE \
+    -H "Authorization: Bearer $OPENAI_API_KEY"
+```
+
+#### Response
+
+```json
+{
+  "id": "id",
+  "deleted": true,
+  "object": "video.deleted"
+}
+```
+

package/lib/API/openai.com/video.download.md

@@ -0,0 +1,31 @@
+## [Retrieve video content](https://developers.openai.com/api/reference/resources/videos/methods/download_content)
+
+**get** `/videos/{video_id}/content`
+
+Download the generated video bytes or a derived preview asset.
+
+Streams the rendered video content for the specified video job.
+
+### Path Parameters
+
+- `video_id: string`
+
+### Query Parameters
+
+- `variant: optional "video" or "thumbnail" or "spritesheet"`
+
+  Which downloadable asset to return. Defaults to the MP4 video.
+
+  - `"video"`
+
+  - `"thumbnail"`
+
+  - `"spritesheet"`
+
+### Example
+
+```http
+curl https://api.openai.com/v1/videos/$VIDEO_ID/content \
+    -H "Authorization: Bearer $OPENAI_API_KEY"
+```
+

package/lib/API/openai.com/video.edit.md

@@ -0,0 +1,155 @@
+## Create a new video generation job by editing a source video or existing generated video.
+[source](https://developers.openai.com/api/reference/resources/videos/methods/edit)
+**post** `/videos/edits`
+
+Create a new video generation job by editing a source video or existing generated video.
+
+### Body Parameters
+
+- `prompt: string`
+
+  Text prompt that describes how to edit the source video.
+
+- `video: object { id }`
+
+  Reference to the completed video to edit.
+
+  - `id: string`
+
+    The identifier of the completed video.
+
+### Returns
+
+- `Video object { id, completed_at, created_at, 10 more }`
+
+  Structured information describing a generated video job.
+
+  - `id: string`
+
+    Unique identifier for the video job.
+
+  - `completed_at: number`
+
+    Unix timestamp (seconds) for when the job completed, if finished.
+
+  - `created_at: number`
+
+    Unix timestamp (seconds) for when the job was created.
+
+  - `error: VideoCreateError`
+
+    Error payload that explains why generation failed, if applicable.
+
+    - `code: string`
+
+      A machine-readable error code that was returned.
+
+    - `message: string`
+
+      A human-readable description of the error that was returned.
+
+  - `expires_at: number`
+
+    Unix timestamp (seconds) for when the downloadable assets expire, if set.
+
+  - `model: VideoModel`
+
+    The video generation model that produced the job.
+
+    - `string`
+
+    - `"sora-2" or "sora-2-pro" or "sora-2-2025-10-06" or 2 more`
+
+      - `"sora-2"`
+
+      - `"sora-2-pro"`
+
+      - `"sora-2-2025-10-06"`
+
+      - `"sora-2-pro-2025-10-06"`
+
+      - `"sora-2-2025-12-08"`
+
+  - `object: "video"`
+
+    The object type, which is always `video`.
+
+    - `"video"`
+
+  - `progress: number`
+
+    Approximate completion percentage for the generation task.
+
+  - `prompt: string`
+
+    The prompt that was used to generate the video.
+
+  - `remixed_from_video_id: string`
+
+    Identifier of the source video if this video is a remix.
+
+  - `seconds: string`
+
+    Duration of the generated clip in seconds. For extensions, this is the stitched total duration.
+
+  - `size: VideoSize`
+
+    The resolution of the generated video.
+
+    - `"720x1280"`
+
+    - `"1280x720"`
+
+    - `"1024x1792"`
+
+    - `"1792x1024"`
+
+  - `status: "queued" or "in_progress" or "completed" or "failed"`
+
+    Current lifecycle status of the video job.
+
+    - `"queued"`
+
+    - `"in_progress"`
+
+    - `"completed"`
+
+    - `"failed"`
+
+### Example
+
+```http
+curl https://api.openai.com/v1/videos/edits \
+    -H 'Content-Type: application/json' \
+    -H "Authorization: Bearer $OPENAI_API_KEY" \
+    -d '{
+          "prompt": "x",
+          "video": {
+            "id": "video_123"
+          }
+        }'
+```
+
+#### Response
+
+```json
+{
+  "id": "id",
+  "completed_at": 0,
+  "created_at": 0,
+  "error": {
+    "code": "code",
+    "message": "message"
+  },
+  "expires_at": 0,
+  "model": "sora-2",
+  "object": "video",
+  "progress": 0,
+  "prompt": "prompt",
+  "remixed_from_video_id": "remixed_from_video_id",
+  "seconds": "seconds",
+  "size": "720x1280",
+  "status": "queued"
+}
+```
+