@salesforce/sfdx-agent-harness-openai 0.0.1

package/dist/text-stream.d.ts

@@ -0,0 +1,30 @@
+import type { ChatEvent } from '@salesforce/sfdx-agent-sdk';
+/**
+ * Tees a `ChatEvent` source into the `eventStream` / `textStream` pair the SDK's
+ * `ChatStreamResult` contract requires. The OpenAI harness owns the iteration
+ * loop over the `@openai/agents` run stream, so it has to derive `textStream`
+ * itself rather than getting two parallel streams from the runtime.
+ *
+ * Iterating either of the returned streams starts a single shared pump that
+ * drains the source generator once and fans events out to two internal
+ * buffers — one for the full event stream, one filtered to `text-delta`
+ * texts. Both streams can be iterated independently or concurrently. If only
+ * one is iterated, the other's buffer accumulates until the source ends; the
+ * bound that makes this safe is the SDK invariant that every chat turn ends
+ * with exactly one terminal `finish` event, so the source always completes
+ * within one bounded chat turn.
+ *
+ * Errors raised while iterating the source are not expected on the harness code
+ * path: the `stream()` pump catches underlying exceptions and pushes a
+ * synthetic `error` + `finish` `ChatEvent` pair onto the sink instead of
+ * throwing. As a defense in depth, a thrown error from the source is forwarded
+ * to the primary stream and ends the derived stream silently, so a regression
+ * that starts throwing here doesn't deadlock either consumer.
+ *
+ * Internal to `@salesforce/sfdx-agent-harness-openai`; not part of the public
+ * harness surface.
+ */
+export declare function teeTextStream(source: AsyncGenerator<ChatEvent>): {
+    eventStream: AsyncGenerator<ChatEvent>;
+    textStream: AsyncGenerator<string>;
+};

package/dist/text-stream.js

@@ -0,0 +1,103 @@
+/*
+ * Copyright 2026, Salesforce, Inc. All rights reserved.
+ * See LICENSE.txt for license terms.
+ */
+/**
+ * Tees a `ChatEvent` source into the `eventStream` / `textStream` pair the SDK's
+ * `ChatStreamResult` contract requires. The OpenAI harness owns the iteration
+ * loop over the `@openai/agents` run stream, so it has to derive `textStream`
+ * itself rather than getting two parallel streams from the runtime.
+ *
+ * Iterating either of the returned streams starts a single shared pump that
+ * drains the source generator once and fans events out to two internal
+ * buffers — one for the full event stream, one filtered to `text-delta`
+ * texts. Both streams can be iterated independently or concurrently. If only
+ * one is iterated, the other's buffer accumulates until the source ends; the
+ * bound that makes this safe is the SDK invariant that every chat turn ends
+ * with exactly one terminal `finish` event, so the source always completes
+ * within one bounded chat turn.
+ *
+ * Errors raised while iterating the source are not expected on the harness code
+ * path: the `stream()` pump catches underlying exceptions and pushes a
+ * synthetic `error` + `finish` `ChatEvent` pair onto the sink instead of
+ * throwing. As a defense in depth, a thrown error from the source is forwarded
+ * to the primary stream and ends the derived stream silently, so a regression
+ * that starts throwing here doesn't deadlock either consumer.
+ *
+ * Internal to `@salesforce/sfdx-agent-harness-openai`; not part of the public
+ * harness surface.
+ */
+export function teeTextStream(source) {
+    const eventBuf = [];
+    const textBuf = [];
+    let pumpStarted = false;
+    let pumpDone = false;
+    let pumpError;
+    let eventWaiter = null;
+    let textWaiter = null;
+    const wakeAll = () => {
+        eventWaiter?.();
+        eventWaiter = null;
+        textWaiter?.();
+        textWaiter = null;
+    };
+    const startPump = () => {
+        if (pumpStarted)
+            return;
+        pumpStarted = true;
+        void (async () => {
+            try {
+                for await (const event of source) {
+                    eventBuf.push(event);
+                    eventWaiter?.();
+                    eventWaiter = null;
+                    if (event.type === 'text-delta') {
+                        textBuf.push(event.text);
+                        textWaiter?.();
+                        textWaiter = null;
+                    }
+                }
+            }
+            catch (err) {
+                pumpError = err;
+            }
+            finally {
+                pumpDone = true;
+                wakeAll();
+            }
+        })();
+    };
+    async function* eventStream() {
+        startPump();
+        while (true) {
+            if (eventBuf.length > 0) {
+                yield eventBuf.shift();
+                continue;
+            }
+            if (pumpDone) {
+                if (pumpError !== undefined)
+                    throw pumpError;
+                return;
+            }
+            await new Promise((resolve) => {
+                eventWaiter = resolve;
+            });
+        }
+    }
+    async function* textStream() {
+        startPump();
+        while (true) {
+            if (textBuf.length > 0) {
+                yield textBuf.shift();
+                continue;
+            }
+            if (pumpDone)
+                return;
+            await new Promise((resolve) => {
+                textWaiter = resolve;
+            });
+        }
+    }
+    return { eventStream: eventStream(), textStream: textStream() };
+}
+//# sourceMappingURL=text-stream.js.map

package/dist/text-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-stream.js","sourceRoot":"","sources":["../src/text-stream.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,aAAa,CAAC,MAAiC;IAI3D,MAAM,QAAQ,GAAgB,EAAE,CAAC;IACjC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,SAAkB,CAAC;IACvB,IAAI,WAAW,GAAwB,IAAI,CAAC;IAC5C,IAAI,UAAU,GAAwB,IAAI,CAAC;IAE3C,MAAM,OAAO,GAAG,GAAS,EAAE;QACvB,WAAW,EAAE,EAAE,CAAC;QAChB,WAAW,GAAG,IAAI,CAAC;QACnB,UAAU,EAAE,EAAE,CAAC;QACf,UAAU,GAAG,IAAI,CAAC;IACtB,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,GAAS,EAAE;QACzB,IAAI,WAAW;YAAE,OAAO;QACxB,WAAW,GAAG,IAAI,CAAC;QACnB,KAAK,CAAC,KAAK,IAAI,EAAE;YACb,IAAI,CAAC;gBACD,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;oBAC/B,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBACrB,WAAW,EAAE,EAAE,CAAC;oBAChB,WAAW,GAAG,IAAI,CAAC;oBACnB,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;wBAC9B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;wBACzB,UAAU,EAAE,EAAE,CAAC;wBACf,UAAU,GAAG,IAAI,CAAC;oBACtB,CAAC;gBACL,CAAC;YACL,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACX,SAAS,GAAG,GAAG,CAAC;YACpB,CAAC;oBAAS,CAAC;gBACP,QAAQ,GAAG,IAAI,CAAC;gBAChB,OAAO,EAAE,CAAC;YACd,CAAC;QACL,CAAC,CAAC,EAAE,CAAC;IACT,CAAC,CAAC;IAEF,KAAK,SAAS,CAAC,CAAC,WAAW;QACvB,SAAS,EAAE,CAAC;QACZ,OAAO,IAAI,EAAE,CAAC;YACV,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtB,MAAM,QAAQ,CAAC,KAAK,EAAe,CAAC;gBACpC,SAAS;YACb,CAAC;YACD,IAAI,QAAQ,EAAE,CAAC;gBACX,IAAI,SAAS,KAAK,SAAS;oBAAE,MAAM,SAAS,CAAC;gBAC7C,OAAO;YACX,CAAC;YACD,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBAChC,WAAW,GAAG,OAAO,CAAC;YAC1B,CAAC,CAAC,CAAC;QACP,CAAC;IACL,CAAC;IAED,KAAK,SAAS,CAAC,CAAC,UAAU;QACtB,SAAS,EAAE,CAAC;QACZ,OAAO,IAAI,EAAE,CAAC;YACV,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrB,MAAM,OAAO,CAAC,KAAK,EAAY,CAAC;gBAChC,SAAS;YACb,CAAC;YACD,IAAI,QAAQ;gBAAE,OAAO;YACrB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBAChC,UAAU,GAAG,OAAO,CAAC;YACzB,CAAC,CAAC,CAAC;QACP,CAAC;IACL,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,EAAE,UAAU,EAAE,UAAU,EAAE,EAAE,CAAC;AACpE,CAAC"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@salesforce/sfdx-agent-harness-openai",
+  "version": "0.0.1",
+  "description": "OpenAI Agents SDK-backed AgentHarness implementation for @salesforce/sfdx-agent-sdk",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "clean": "tsc --build --clean",
+    "clean:all": "npm run clean && rimraf node_modules",
+    "postclean": "rimraf coverage && rimraf dist",
+    "format": "prettier --write .",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "showcoverage": "open ./coverage/lcov-report/index.html",
+    "test": "tsc --build ./test/tsconfig.json && vitest run --coverage",
+    "test:conformance": "tsc --build ./test/tsconfig.json && vitest run test/conformance"
+  },
+  "license": "SEE LICENSE IN LICENSE.txt",
+  "files": [
+    "dist",
+    "CHANGELOG.md",
+    "LICENSE.txt"
+  ],
+  "dependencies": {
+    "@openai/agents": "^0.13.0",
+    "@salesforce/agentic-common": "0.13.0",
+    "openai": "^6.0.0"
+  },
+  "peerDependencies": {
+    "@salesforce/sfdx-agent-sdk": "0.35.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@salesforce/harness-conformance": "0.0.1",
+    "@salesforce/sfdx-agent-sdk": "0.35.0",
+    "@types/node": "^22.20.0",
+    "@vitest/coverage-istanbul": "^4.1.10",
+    "@vitest/eslint-plugin": "^1.6.22",
+    "eslint": "^10.7.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-import-resolver-typescript": "^4.4.5",
+    "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-n": "^18.2.1",
+    "globals": "^17.6.0",
+    "lint-staged": "^17.0.7",
+    "prettier": "^3.9.4",
+    "rimraf": "^6.1.3",
+    "tsx": "^4.23.0",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.63.0",
+    "vitest": "^4.1.8"
+  },
+  "engines": {
+    "node": ">=22.22.0"
+  },
+  "lint-staged": {
+    "*.{js,jsx,ts,tsx,json,md}": [
+      "prettier --write"
+    ]
+  }
+}