dsh-lcx-codex 0.4.1 → 0.4.2

package/lib/route.js

@@ -3,11 +3,12 @@
 import { createHash, randomUUID } from 'node:crypto'
 import { attributionHeaders, resolveRetryPolicy } from '@deepseek-ai/dsh-llm'
 import { settingsNamespace } from '@deepseek-ai/dsh-settings'
+import { getBuiltinModels } from '@earendil-works/pi-ai/providers/all'
 
 /** @typedef {Record<string, string>} HeaderMap */
 /** @typedef {Parameters<typeof resolveRetryPolicy>[0]} RetryPolicyConfig */
 /** @typedef {'none' | 'short' | 'long'} CacheRetention */
-/** @typedef {{ supportsDeveloperRole?: boolean, supportsStrictMode?: boolean, supportsLongCacheRetention?: boolean }} ResponsesCompat */
+/** @typedef {{ supportsDeveloperRole?: boolean, sessionAffinityFormat?: 'openai' | 'openai-nosession' | 'openrouter', supportsStrictMode?: boolean, supportsLongCacheRetention?: boolean, supportsOpenAIGrammarTools?: boolean, supportsAdditionalTools?: boolean, supportsToolSearch?: boolean, supportsExplicitPromptCacheMode?: boolean }} ResponsesCompat */
 /** @typedef {{ provider: string, model: string, baseURL: string, sessionId: string }} RouteIdentity */
 /** @typedef {{ provider?: unknown, model?: unknown, sessionId?: unknown }} RouteOptions */
 /** @typedef {{ id?: unknown, compat?: unknown }} ProviderModelProfile */
@@ -50,6 +51,7 @@ import { settingsNamespace } from '@deepseek-ai/dsh-settings'
  * @property {HeaderMap} [headers]
  * @property {unknown} [cacheRetention]
  * @property {unknown} [supportsLongCacheRetention]
+ * @property {unknown} [supportsExplicitPromptCacheMode]
  * @property {unknown} [responsesCompat]
  * @property {number} [timeoutMs]
  * @property {number} [maxAttempts]
@@ -76,11 +78,6 @@ export function normalizeBaseURL(value) {
   return String(value ?? '').trim().replace(/\/+$/u, '')
 }
 
-/** @param {unknown} model */
-export function isGptModel(model) {
-  return /(^|[^a-z])gpt(?:[^a-z]|$)/iu.test(String(model ?? ''))
-}
-
 /** @param {unknown} baseURL */
 export function baseURLFingerprint(baseURL) {
   return createHash('sha256').update(normalizeBaseURL(baseURL), 'utf8').digest('hex')
@@ -148,7 +145,7 @@ export function settingsValue(ctx, namespace) {
 }
 
 /** @type {Set<keyof ResponsesCompat>} */
-const RESPONSES_COMPAT_FIELDS = new Set(['supportsDeveloperRole', 'supportsStrictMode', 'supportsLongCacheRetention'])
+const RESPONSES_COMPAT_FIELDS = new Set(['supportsDeveloperRole', 'sessionAffinityFormat', 'supportsStrictMode', 'supportsLongCacheRetention', 'supportsOpenAIGrammarTools', 'supportsAdditionalTools', 'supportsToolSearch', 'supportsExplicitPromptCacheMode'])
 
 /**
  * @param {ResponsesCompat} target
@@ -156,7 +153,22 @@ const RESPONSES_COMPAT_FIELDS = new Set(['supportsDeveloperRole', 'supportsStric
  */
 function copyResponsesCompat(target, source) {
   if (!source || typeof source !== 'object') return
-  for (const field of RESPONSES_COMPAT_FIELDS) if (typeof /** @type {Record<keyof ResponsesCompat, unknown>} */ (source)[field] === 'boolean') target[field] = /** @type {boolean} */ (/** @type {Record<keyof ResponsesCompat, unknown>} */ (source)[field])
+  const values = /** @type {Record<string, unknown>} */ (source)
+  const output = /** @type {Record<string, unknown>} */ (/** @type {unknown} */ (target))
+  for (const field of RESPONSES_COMPAT_FIELDS) {
+    const value = values[field]
+    if (field === 'sessionAffinityFormat') {
+      if (['openai', 'openai-nosession', 'openrouter'].includes(String(value))) output[field] = value
+    } else if (typeof value === 'boolean') output[field] = value
+  }
+}
+
+/** @param {unknown} provider @param {unknown} modelId */
+function builtinResponsesModel(provider, modelId) {
+  try {
+    return getBuiltinModels(/** @type {any} */ (String(provider ?? '')))
+      .find((model) => model?.id === String(modelId ?? '') && model?.api === 'openai-responses')
+  } catch { return undefined }
 }
 
 /**
@@ -183,50 +195,51 @@ function configuredResponsesCompat(profile, modelId) {
  * @returns {ResolvedResponsesRoute | undefined}
  */
 export function resolveResponsesRouteConfig(ctx, options, fallbackConfig) {
-  if (!isGptModel(options?.model)) return undefined
   const provider = String(options?.provider ?? '')
+  const model = String(options?.model ?? '')
   const section = settingsValue(ctx, 'llm-pi-ai')
   const profile = section?.providers?.[provider]
-  if (profile === undefined) {
-    if (provider !== fallbackConfig.provider) return undefined
-    return {
-      ...fallbackConfig,
-      provider,
-      model: String(options.model),
-      api: 'openai-responses',
-      baseURL: normalizeBaseURL(fallbackConfig.baseURL),
-      cacheRetention: /** @type {CacheRetention} */ (['none', 'short', 'long'].includes(/** @type {string} */ (fallbackConfig.cacheRetention)) ? fallbackConfig.cacheRetention : 'short'),
-      supportsLongCacheRetention: fallbackConfig.supportsLongCacheRetention !== false,
-      responsesCompat: fallbackConfig.responsesCompat && typeof fallbackConfig.responsesCompat === 'object' ? /** @type {ResponsesCompat} */ ({ ...fallbackConfig.responsesCompat }) : undefined,
-    }
-  }
-  if (profile.api !== 'openai-responses') return undefined
-  const baseURL = profile.baseURL ?? (provider === fallbackConfig.provider ? fallbackConfig.baseURL : undefined)
-  const apiKeyEnv = profile.apiKeyEnv ?? (provider === fallbackConfig.provider ? fallbackConfig.apiKeyEnv : undefined)
+  const fallbackOwned = provider === fallbackConfig.provider
+  if (profile === undefined && !fallbackOwned) return undefined
+  const configured = /** @type {ProviderProfile} */ (profile ?? {})
+
+  const builtin = builtinResponsesModel(provider, model)
+  const api = configured.api ?? builtin?.api ?? (fallbackOwned ? 'openai-responses' : undefined)
+  if (api !== 'openai-responses') return undefined
+
+  const baseURL = configured.baseURL ?? builtin?.baseUrl ?? (fallbackOwned ? fallbackConfig.baseURL : undefined)
+  const apiKeyEnv = configured.apiKeyEnv ?? (fallbackOwned ? fallbackConfig.apiKeyEnv : undefined)
   if (!baseURL || !apiKeyEnv) return undefined
-  const responsesCompat = configuredResponsesCompat(profile, options.model)
+
+  /** @type {ResponsesCompat} */
+  const responsesCompat = {}
+  copyResponsesCompat(responsesCompat, builtin?.compat)
+  copyResponsesCompat(responsesCompat, fallbackOwned ? fallbackConfig.responsesCompat : undefined)
+  copyResponsesCompat(responsesCompat, configuredResponsesCompat(configured, model))
+  // Host Pi rc.2 withholds this field; the plugin opt-in still requires Pi's exact model capability.
+  const promptCacheModel = fallbackOwned && fallbackConfig.supportsExplicitPromptCacheMode === true
+    ? builtinResponsesModel('openai', model)
+    : undefined
+  const promptCacheCompat = /** @type {ResponsesCompat | undefined} */ (promptCacheModel?.compat)
+  if (promptCacheCompat?.supportsExplicitPromptCacheMode === true) responsesCompat.supportsExplicitPromptCacheMode = true
+  const resolvedCompat = Object.keys(responsesCompat).length > 0 ? responsesCompat : undefined
+
   return {
     ...fallbackConfig,
     provider,
-    model: String(options.model),
+    model,
     api: 'openai-responses',
     baseURL: normalizeBaseURL(baseURL),
     apiKeyEnv,
-    headers: profile.headers && typeof profile.headers === 'object' ? { ...profile.headers } : { ...(fallbackConfig.headers ?? {}) },
-    cacheRetention: /** @type {CacheRetention} */ (['none', 'short', 'long'].includes(/** @type {string} */ (profile.cacheRetention)) ? profile.cacheRetention : (['none', 'short', 'long'].includes(/** @type {string} */ (fallbackConfig.cacheRetention)) ? fallbackConfig.cacheRetention : 'short')),
-    supportsLongCacheRetention: responsesCompat?.supportsLongCacheRetention ?? /** @type {boolean | undefined} */ (fallbackConfig.supportsLongCacheRetention) ?? true,
-    responsesCompat,
-    timeoutMs: Number.isInteger(profile.timeoutMs) && /** @type {number} */ (profile.timeoutMs) > 0 ? profile.timeoutMs : fallbackConfig.timeoutMs,
-    maxAttempts: retryAttempts(profile.retryPolicy, fallbackConfig.maxAttempts),
-    maxRequestImageBytes: Number.isSafeInteger(profile.maxRequestImageBytes) && /** @type {number} */ (profile.maxRequestImageBytes) > 0
-      ? profile.maxRequestImageBytes
-      : fallbackConfig.maxRequestImageBytes,
-    requestImagePixelBudget: Number.isSafeInteger(profile.requestImagePixelBudget) && /** @type {number} */ (profile.requestImagePixelBudget) > 0
-      ? profile.requestImagePixelBudget
-      : fallbackConfig.requestImagePixelBudget,
-    requestImageMaxBytes: Number.isSafeInteger(profile.requestImageMaxBytes) && /** @type {number} */ (profile.requestImageMaxBytes) > 0
-      ? profile.requestImageMaxBytes
-      : fallbackConfig.requestImageMaxBytes,
+    headers: configured.headers && typeof configured.headers === 'object' ? { ...configured.headers } : { ...(fallbackConfig.headers ?? {}) },
+    cacheRetention: /** @type {CacheRetention} */ (['none', 'short', 'long'].includes(/** @type {string} */ (configured.cacheRetention)) ? configured.cacheRetention : (['none', 'short', 'long'].includes(/** @type {string} */ (fallbackConfig.cacheRetention)) ? fallbackConfig.cacheRetention : 'short')),
+    supportsLongCacheRetention: resolvedCompat?.supportsLongCacheRetention ?? /** @type {boolean | undefined} */ (fallbackConfig.supportsLongCacheRetention) ?? true,
+    responsesCompat: resolvedCompat,
+    timeoutMs: Number.isInteger(configured.timeoutMs) && /** @type {number} */ (configured.timeoutMs) > 0 ? /** @type {number} */ (configured.timeoutMs) : fallbackConfig.timeoutMs,
+    maxAttempts: retryAttempts(configured.retryPolicy, fallbackConfig.maxAttempts),
+    maxRequestImageBytes: Number.isSafeInteger(configured.maxRequestImageBytes) && /** @type {number} */ (configured.maxRequestImageBytes) > 0 ? /** @type {number} */ (configured.maxRequestImageBytes) : fallbackConfig.maxRequestImageBytes,
+    requestImagePixelBudget: Number.isSafeInteger(configured.requestImagePixelBudget) && /** @type {number} */ (configured.requestImagePixelBudget) > 0 ? /** @type {number} */ (configured.requestImagePixelBudget) : fallbackConfig.requestImagePixelBudget,
+    requestImageMaxBytes: Number.isSafeInteger(configured.requestImageMaxBytes) && /** @type {number} */ (configured.requestImageMaxBytes) > 0 ? /** @type {number} */ (configured.requestImageMaxBytes) : fallbackConfig.requestImageMaxBytes,
   }
 }
 
@@ -258,6 +271,8 @@ function hasExplicitSessionAffinity(headers) { return ['session-id', 'session_id
 /** @param {Partial<ResolvedResponsesRoute> | null | undefined} config */
 function sessionAffinityFormat(config) {
   if (config?.api && config.api !== 'openai-responses') return 'none'
+  const explicit = config?.responsesCompat?.sessionAffinityFormat
+  if (['openai', 'openai-nosession', 'openrouter'].includes(String(explicit))) return explicit
   const provider = String(config?.provider ?? '').toLowerCase()
   const baseURL = String(config?.baseURL ?? '').toLowerCase()
   return provider === 'openrouter' || baseURL.includes('openrouter.ai') ? 'openrouter' : 'openai'
@@ -284,7 +299,7 @@ export async function authenticatedHeaders(ctx, config, sessionId, requestId) {
     else if (format === 'openrouter') headers['x-session-id'] = sid
   }
   if (requestId !== null && !hasHeader(explicit, 'x-client-request-id')) {
-    const correlation = requestId ?? (sid && format === 'openai' ? sid : (!sid ? randomUUID() : undefined))
+    const correlation = requestId ?? (sid && (format === 'openai' || format === 'openai-nosession') ? sid : (!sid ? randomUUID() : undefined))
     if (correlation) headers['x-client-request-id'] = correlation
   }
   return { ...headers, ...explicit }

package/lib/transport.js

@@ -6,9 +6,14 @@ export function abortIfNeeded(signal) {
 }
 function makeError(message, code, extra = {}) { const error = new Error(message); error.code = code; Object.assign(error, extra); return error }
 function retryableStatus(status) { return status === 408 || status === 409 || status === 425 || status === 429 || (status >= 500 && status <= 599) }
-function delayFromHeaders(headers, attempt) {
-  const millis = Number(headers?.get?.('retry-after-ms')); if (Number.isFinite(millis) && millis >= 0) return Math.min(millis, 30_000)
+function retryAfterFromHeaders(headers) {
+  const rawMillis = headers?.get?.('retry-after-ms'); const millis = Number(rawMillis); if (rawMillis !== null && rawMillis !== undefined && rawMillis !== '' && Number.isFinite(millis) && millis >= 0) return Math.min(millis, 30_000)
   const retryAfter = headers?.get?.('retry-after'); if (retryAfter) { const seconds = Number(retryAfter); if (Number.isFinite(seconds) && seconds >= 0) return Math.min(seconds * 1000, 30_000); const date = Date.parse(retryAfter); if (!Number.isNaN(date)) return Math.min(Math.max(0, date - Date.now()), 30_000) }
+  return undefined
+}
+function delayFromHeaders(headers, attempt) {
+  const retryAfter = retryAfterFromHeaders(headers)
+  if (retryAfter !== undefined) return retryAfter
   return Math.min(10_000, 500 * 2 ** Math.max(0, attempt - 1))
 }
 async function sleep(ms, signal) { if (ms <= 0) return; await new Promise((resolve, reject) => { if (signal?.aborted) return reject(signal.reason); const timer = setTimeout(resolve, ms); signal?.addEventListener('abort', () => { clearTimeout(timer); reject(signal.reason) }, { once: true }) }) }
@@ -25,7 +30,8 @@ export async function fetchJsonWithRetry(url, body, headers = {}, signal, timeou
       const text = await readLimited(response, maxResponseBytes)
       if (!response.ok) {
         const retryable = retryableStatus(response.status)
-        const error = makeError(`HTTP ${response.status}`, retryable ? 'LCX_HTTP_RETRYABLE' : 'LCX_HTTP_ERROR', { status: response.status, retryable, requestId: response.headers.get('x-request-id') ?? response.headers.get('request-id') ?? undefined })
+        const providerRetryAfterMs = retryAfterFromHeaders(response.headers)
+        const error = makeError(`HTTP ${response.status}`, retryable ? 'LCX_HTTP_RETRYABLE' : 'LCX_HTTP_ERROR', { status: response.status, retryable, requestId: response.headers.get('x-request-id') ?? response.headers.get('request-id') ?? undefined, ...(providerRetryAfterMs === undefined ? {} : { providerRetryAfterMs }) })
         if (!error.retryable || attempt >= maxAttempts) throw error; last = error; await sleep(delayFromHeaders(response.headers, attempt), signal); continue
       }
       let parsed
@@ -50,7 +56,7 @@ export async function fetchSseWithRetry(url, body, headers = {}, signal, timeout
       const response = await fetch(url, { method: 'POST', headers: { 'content-type': 'application/json', accept: 'text/event-stream', ...headers }, body: JSON.stringify(body), signal: requestSignal, redirect: 'error' })
       if (!response.ok) {
         await readLimited(response, Math.min(options.maxResponseBytes ?? DEFAULT_MAX_BYTES, 512 * 1024))
-        const retryable = retryableStatus(response.status); const error = makeError(`HTTP ${response.status}`, retryable ? 'LCX_HTTP_RETRYABLE' : 'LCX_HTTP_ERROR', { status: response.status, retryable, requestId: response.headers.get('x-request-id') ?? response.headers.get('request-id') ?? undefined })
+        const retryable = retryableStatus(response.status); const providerRetryAfterMs = retryAfterFromHeaders(response.headers); const error = makeError(`HTTP ${response.status}`, retryable ? 'LCX_HTTP_RETRYABLE' : 'LCX_HTTP_ERROR', { status: response.status, retryable, requestId: response.headers.get('x-request-id') ?? response.headers.get('request-id') ?? undefined, ...(providerRetryAfterMs === undefined ? {} : { providerRetryAfterMs }) })
         if (!retryable || attempt >= maxAttempts) throw error; last = error; await sleep(delayFromHeaders(response.headers, attempt), signal); continue
       }
       if (typeof options.consume === 'function') return await options.consume(response, { requestSignal }); return response

package/lib/web-search-alpha.js

@@ -9,7 +9,7 @@ const RESPONSE_LENGTHS = ['short','medium','long']
 export const ALPHA_SEARCH_PARAMETERS = { type: 'object', properties: { action: { type: 'string', enum: ALPHA_ACTIONS }, query: { type: 'string' }, domains: { type: 'array', items: { type: 'string' } }, recency: { type: 'integer' }, refId: { type: 'string' }, lineNumber: { type: 'integer' }, linkId: { type: 'integer' }, pattern: { type: 'string' }, pageNumber: { type: 'integer' }, ticker: { type: 'string' }, assetType: { type: 'string', enum: ASSET_TYPES }, market: { type: 'string' }, location: { type: 'string' }, start: { type: 'string' }, duration: { type: 'integer' }, fn: { type: 'string', enum: ['schedule','standings'] }, league: { type: 'string', enum: LEAGUES }, team: { type: 'string' }, opponent: { type: 'string' }, dateFrom: { type: 'string' }, dateTo: { type: 'string' }, numberOfGames: { type: 'integer' }, locale: { type: 'string' }, utcOffset: { type: 'string' }, responseLength: { type: 'string', enum: RESPONSE_LENGTHS } }, required: ['action'], additionalProperties: false }
 export const ALPHA_SEARCH_OUTPUT = { type: 'object', properties: { mode: { type:'string' }, action: { type:'string' }, capability:{type:'string'}, emulation:{type:'string'}, content:{type:'string'}, results:{type:'array',items:{type:'object'}}, refs:{type:'array',items:{type:'string'}}, sources:{type:'array',items:{type:'object'}}, citations:{type:'array',items:{type:'object'}}, outputBlocks:{type:'array',items:{type:'object'}}, links:{type:'array',items:{type:'object'}}, pdfRefs:{type:'array',items:{type:'string'}}, domains:{type:'array',items:{type:'string'}}, lineRange:{type:'object'}, requestId:{type:'string'}, responseId:{type:'string'}, retrievedAt:{type:'string'}, warnings:{type:'array',items:{type:'string'}} }, required:['mode','action','capability','emulation','content','results','refs','sources','citations','outputBlocks','links','pdfRefs','domains','requestId','retrievedAt','warnings'], additionalProperties:false }
 export const ALPHA_SCHEMA_FINGERPRINT = createHash('sha256').update(JSON.stringify(ALPHA_SEARCH_PARAMETERS)).digest('hex')
-export const ALPHA_PROBE_VERSION = 10
+export const ALPHA_PROBE_VERSION = 11
 function failure(message, code='WEB_INVALID_REQUEST') { const e=new Error(message); e.code=code; return e }
 function isObject(v){ return v!==null && typeof v==='object' && !Array.isArray(v) }
 function text(value,field,max=1000){ if(typeof value!=='string'||!value.trim()||value.trim().length>max) throw failure(`websearch_alpha.${field} is invalid`); return value.trim() }
@@ -101,7 +101,9 @@ function safeResult(value,seen=new Set()){ if(value===null||typeof value!=='obje
 function artifacts(results){ const refs=[],refRecords=[],sources=[],seenRefs=new Set(),seenSources=new Set(); const visit=(value)=>{ if(!value||typeof value!=='object') return; if(Array.isArray(value)){ value.forEach(visit); return } const candidate=typeof value.ref_id==='string'&&value.ref_id?value.ref_id:typeof value.id==='string'&&/^turn[\w-]+$/u.test(value.id)?value.id:undefined; const refId=isAlphaHttpUrl(candidate)?undefined:candidate; const url=httpUrl(value.url??value.source_url??value.source_website_url??candidate); if(refId&&!seenRefs.has(refId)){seenRefs.add(refId);refs.push(refId);refRecords.push({refId,...(url?{url}:{})})} if(url&&!seenSources.has(url)){seenSources.add(url);sources.push({url,...(typeof value.title==='string'?{title:value.title}:{}),...(typeof value.snippet==='string'?{snippet:value.snippet}:{}),...(refId?{refId}:{})})} Object.values(value).forEach(visit) }; visit(results); return {refs,refRecords,sources} }
 const ACTION_ERROR=/^\s*(?:Error parsing function call\b|Invalid function_name=|Invalid function call\b)/iu
 const ALPHA_SEMANTIC_FAILURE=/^\s*(?:reference(?: id)?\s+(?:is\s+)?(?:invalid|unavailable)\b|unable to access requested content\b|service unavailable\b)/iu
-export function parseAlphaSearchResponse(response,options){ if(!isObject(response)||typeof response.output!=='string'||(response.results!==undefined&&!Array.isArray(response.results))) throw failure('LCX Alpha Web Search returned an invalid response','LCX_ALPHA_INVALID_RESPONSE'); if(ACTION_ERROR.test(response.output)||(['open','find','click','screenshot'].includes(options.action)&&ALPHA_SEMANTIC_FAILURE.test(response.output))) throw failure('LCX Alpha Web Search could not execute the requested action','LCX_ALPHA_ACTION_FAILED'); const results=safeResult(response.results??[]); const a=artifacts(results); const outputBlocks=parseWebRunOutput(response.output); for(const block of outputBlocks) if(block.url){ const url=httpUrl(block.url); if(url) block.url=url; else delete block.url } for(const block of outputBlocks) for(const ref of block.references??[]){ if(isAlphaHttpUrl(ref)) continue; if(!a.refs.includes(ref)) a.refs.push(ref); if(!a.refRecords.some((item)=>item.refId===ref)) a.refRecords.push({refId:ref,...(block.url?{url:block.url}:{})}) } for(const source of outputBlocks.flatMap((b)=>b.url?[{url:b.url,...(b.title?{title:b.title}:{})}]:[])) if(!a.sources.some((x)=>x.url===source.url)) a.sources.push(source); return {mode:'alpha',action:options.action,capability:options.capability,emulation:options.capability==='native'?'native':'unknown',content:response.output,results,refs:a.refs,sources:a.sources,citations:a.sources.map((s)=>({...s})),outputBlocks,links:outputLinks(outputBlocks),pdfRefs:outputPdfRefs(outputBlocks),domains:outputDomains(outputBlocks),...(outputLineRange(outputBlocks)?{lineRange:outputLineRange(outputBlocks)}:{}),requestId:options.requestId,...(typeof response.id==='string'&&response.id?{responseId:response.id}:{}),retrievedAt:options.retrievedAt??new Date().toISOString(),warnings:options.capability==='command-capable'?['Alpha command behavior is verified, but trusted native backend provenance is unavailable.']:[],refRecords:a.refRecords} }
+const ALPHA_COMMAND_ERROR_ENVELOPE=/^\s*Internal Error\s*\([^\r\n)]*\)\s*(?:\r?\n[ \t]*)+(?:\uE200cite\uE202[^\uE201\r\n]+\uE201[ \t]*(?:\[wordlim:\s*\d+\][ \t]*)?)?Unable to resolve (open|find|click|screenshot) call\s*:/iu
+function alphaCommandErrorEnvelope(output,action){ const match=String(output??'').match(ALPHA_COMMAND_ERROR_ENVELOPE); return match?.[1]?.toLowerCase()===action }
+export function parseAlphaSearchResponse(response,options){ if(!isObject(response)||typeof response.output!=='string'||(response.results!==undefined&&!Array.isArray(response.results))) throw failure('LCX Alpha Web Search returned an invalid response','LCX_ALPHA_INVALID_RESPONSE'); if(ACTION_ERROR.test(response.output)||(['open','find','click','screenshot'].includes(options.action)&&(ALPHA_SEMANTIC_FAILURE.test(response.output)||alphaCommandErrorEnvelope(response.output,options.action)))) throw failure('LCX Alpha Web Search could not execute the requested action','LCX_ALPHA_ACTION_FAILED'); const results=safeResult(response.results??[]); const a=artifacts(results); const outputBlocks=parseWebRunOutput(response.output); for(const block of outputBlocks) if(block.url){ const url=httpUrl(block.url); if(url) block.url=url; else delete block.url } for(const block of outputBlocks) for(const ref of block.references??[]){ if(isAlphaHttpUrl(ref)) continue; if(!a.refs.includes(ref)) a.refs.push(ref); if(!a.refRecords.some((item)=>item.refId===ref)) a.refRecords.push({refId:ref,...(block.url?{url:block.url}:{})}) } for(const source of outputBlocks.flatMap((b)=>b.url?[{url:b.url,...(b.title?{title:b.title}:{})}]:[])) if(!a.sources.some((x)=>x.url===source.url)) a.sources.push(source); return {mode:'alpha',action:options.action,capability:options.capability,emulation:options.capability==='native'?'native':'unknown',content:response.output,results,refs:a.refs,sources:a.sources,citations:a.sources.map((s)=>({...s})),outputBlocks,links:outputLinks(outputBlocks),pdfRefs:outputPdfRefs(outputBlocks),domains:outputDomains(outputBlocks),...(outputLineRange(outputBlocks)?{lineRange:outputLineRange(outputBlocks)}:{}),requestId:options.requestId,...(typeof response.id==='string'&&response.id?{responseId:response.id}:{}),retrievedAt:options.retrievedAt??new Date().toISOString(),warnings:options.capability==='command-capable'?['Alpha command behavior is verified, but trusted native backend provenance is unavailable.']:[],refRecords:a.refRecords} }
 export function renderAlphaSearchResult(value){ const parts=[value.content]; if(value.sources?.length) parts.push(`来源：\n${value.sources.map((s)=>`- [${s.title??s.url}](${s.url})`).join('\n')}`); if(value.warnings?.length) parts.push(value.warnings.map((w)=>`警告：${w}`).join('\n')); parts.push(`检索时间：${value.retrievedAt}`); return [{type:'text',text:parts.filter(Boolean).join('\n\n')}] }
 function probeFailureState(error){ if([404,405].includes(error?.status)||['LCX_ALPHA_ACTION_UNAVAILABLE','LCX_ALPHA_ACTION_FAILED'].includes(error?.code)||/channel does not support|unsupported action|not implemented/iu.test(String(error?.message??''))) return 'unsupported'; return 'unknown' }
 function alphaProbeStructuredResult(value,seen=new Set()){
@@ -122,6 +124,7 @@ function alphaProbeStructuredBlock(block){
 }
 const ALPHA_PROBE_SEMANTIC_FAILURE=/\breference(?: id)?\s+(?:is\s+)?(?:invalid|unavailable)\b/iu
 function alphaProbeResultHasEvidence(action,value){
+  if(alphaCommandErrorEnvelope(value?.content,action)) return false
   if(ALPHA_PROBE_SEMANTIC_FAILURE.test(String(value?.content??''))&&!(Array.isArray(value?.results)&&value.results.length)) return false
   const refs=Array.isArray(value?.refs)&&value.refs.some((ref)=>typeof ref==='string'&&ref&&!isAlphaHttpUrl(ref))
   const links=Array.isArray(value?.links)&&value.links.some((link)=>Number.isSafeInteger(link?.id))

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-lcx-codex",
-  "version": "0.4.1",
-  "description": "DSH Codex/Responses capabilities for existing openai-responses routes: hosted/alpha search and session-native V2 compaction",
+  "version": "0.4.2",
+  "description": "DSH GPT Responses lifecycle owner with Native V2 compaction/replay and Hosted/Alpha Search capabilities",
   "keywords": [
     "deepseek-harness",
     "dsh",
@@ -53,7 +53,7 @@
     }
   },
   "dependencies": {
-    "@earendil-works/pi-ai": "0.82.1"
+    "@earendil-works/pi-ai": "0.84.3"
   },
   "devDependencies": {
     "@deepseek-ai/dsh-llm": "0.1.1-rc.2",
@@ -84,7 +84,7 @@
     "test:schema": "node scripts/validate-dsh-schema.mjs"
   },
   "engines": {
-    "node": ">=20"
+    "node": "^22.19.0 || >=24.0.0"
   },
   "publishConfig": {
     "access": "public"