@selesai/code 0.13.4 → 0.13.5

package/dist/extensions/pi-web-agent/src/orchestration/answer-synthesizer.ts

@@ -1,60 +1,60 @@
-import type { ResearchEvidence } from './research-types.js';
-import type { EvidenceCaveatReason } from './evidence-quality.js';
-
-function normalizeSummary(summary: string) {
-  return summary.replace(/\s+/g, ' ').trim();
-}
-
-function sentenceForReason(reason: EvidenceCaveatReason): string {
-  switch (reason) {
-    case 'community-only':
-      return 'the strongest readable sources were mostly community/practical context';
-    case 'low-diversity':
-      return 'the source set was narrow';
-    case 'unreadable-direct-source':
-      return 'one or more linked sources could not be read reliably';
-    case 'unreadable-thread-source':
-      return 'one or more thread sources could not be read reliably';
-    case 'possible-conflict':
-      return 'readable sources include cautionary or possibly conflicting guidance';
-    case 'bot-check':
-      return 'some candidate sources showed bot-check or security verification pages';
-  }
-}
-
-function joinReasons(reasons: string[]) {
-  if (reasons.length === 0) return '';
-  if (reasons.length === 1) return reasons[0];
-  return `${reasons.slice(0, -1).join(', ')}, and ${reasons.at(-1)}`;
-}
-
-function caveatText(partial: boolean, caveatReasons: EvidenceCaveatReason[] = []) {
-  if (!partial) return undefined;
-  const specificReasons = caveatReasons.map(sentenceForReason);
-  if (specificReasons.length > 0) {
-    return `Evidence is partial: ${joinReasons(specificReasons)}.`;
-  }
-  return 'Evidence is partial, so this answer is based on the strongest source found within the bounded research budget.';
-}
-
-export function synthesizeAnswer({
-  evidence,
-  partial,
-  caveatReasons = []
-}: {
-  evidence: ResearchEvidence[];
-  partial: boolean;
-  caveatReasons?: EvidenceCaveatReason[];
-}) {
-  const findings = evidence.slice(0, 5).map((item) => {
-    const summary = normalizeSummary(item.summary);
-    return item.sourceKind === 'community' || item.sourceKind === 'issue-thread'
-      ? `Community/practical context: ${summary}`
-      : summary;
-  });
-
-  return {
-    findings,
-    caveat: caveatText(partial, caveatReasons)
-  };
-}
+import type { ResearchEvidence } from './research-types.js';
+import type { EvidenceCaveatReason } from './evidence-quality.js';
+
+function normalizeSummary(summary: string) {
+  return summary.replace(/\s+/g, ' ').trim();
+}
+
+function sentenceForReason(reason: EvidenceCaveatReason): string {
+  switch (reason) {
+    case 'community-only':
+      return 'the strongest readable sources were mostly community/practical context';
+    case 'low-diversity':
+      return 'the source set was narrow';
+    case 'unreadable-direct-source':
+      return 'one or more linked sources could not be read reliably';
+    case 'unreadable-thread-source':
+      return 'one or more thread sources could not be read reliably';
+    case 'possible-conflict':
+      return 'readable sources include cautionary or possibly conflicting guidance';
+    case 'bot-check':
+      return 'some candidate sources showed bot-check or security verification pages';
+  }
+}
+
+function joinReasons(reasons: string[]) {
+  if (reasons.length === 0) return '';
+  if (reasons.length === 1) return reasons[0];
+  return `${reasons.slice(0, -1).join(', ')}, and ${reasons.at(-1)}`;
+}
+
+function caveatText(partial: boolean, caveatReasons: EvidenceCaveatReason[] = []) {
+  if (!partial) return undefined;
+  const specificReasons = caveatReasons.map(sentenceForReason);
+  if (specificReasons.length > 0) {
+    return `Evidence is partial: ${joinReasons(specificReasons)}.`;
+  }
+  return 'Evidence is partial, so this answer is based on the strongest source found within the bounded research budget.';
+}
+
+export function synthesizeAnswer({
+  evidence,
+  partial,
+  caveatReasons = []
+}: {
+  evidence: ResearchEvidence[];
+  partial: boolean;
+  caveatReasons?: EvidenceCaveatReason[];
+}) {
+  const findings = evidence.slice(0, 5).map((item) => {
+    const summary = normalizeSummary(item.summary);
+    return item.sourceKind === 'community' || item.sourceKind === 'issue-thread'
+      ? `Community/practical context: ${summary}`
+      : summary;
+  });
+
+  return {
+    findings,
+    caveat: caveatText(partial, caveatReasons)
+  };
+}

package/dist/extensions/pi-web-agent/src/orchestration/index.ts

@@ -1,28 +1,28 @@
-import { createBackendSet } from '../backends/factory.js';
-import type { BackendConfig } from '../backends/config.js';
-import type { WebFetchHeadlessResponse, WebFetchResponse, WebSearchResponse } from '../types.js';
-import { createResearchOrchestrator } from './research-orchestrator.js';
-import { createResearchWorker } from './research-worker.js';
-
-export function createResearchWorkflow({
-  backendConfig,
-  search,
-  fetchPage,
-  headlessFetch
-}: {
-  backendConfig?: BackendConfig;
-  search?: (input: { query: string }) => Promise<WebSearchResponse>;
-  fetchPage?: (input: { url: string }) => Promise<WebFetchResponse>;
-  headlessFetch?: (input: { url: string }) => Promise<WebFetchHeadlessResponse>;
-} = {}) {
-  const backends = createBackendSet(backendConfig);
-  const resolvedSearch = search ?? backends.search;
-  const resolvedFetchPage = fetchPage ?? backends.fetchPage;
-  const resolvedHeadlessFetch = headlessFetch ?? backends.headlessFetch;
-  const worker = createResearchWorker({ search: resolvedSearch, fetchPage: resolvedFetchPage });
-  return createResearchOrchestrator({
-    worker,
-    fetchDirect: resolvedFetchPage,
-    headlessFetch: resolvedHeadlessFetch
-  });
-}
+import { createBackendSet } from '../backends/factory.js';
+import type { BackendConfig } from '../backends/config.js';
+import type { WebFetchHeadlessResponse, WebFetchResponse, WebSearchResponse } from '../types.js';
+import { createResearchOrchestrator } from './research-orchestrator.js';
+import { createResearchWorker } from './research-worker.js';
+
+export function createResearchWorkflow({
+  backendConfig,
+  search,
+  fetchPage,
+  headlessFetch
+}: {
+  backendConfig?: BackendConfig;
+  search?: (input: { query: string }) => Promise<WebSearchResponse>;
+  fetchPage?: (input: { url: string }) => Promise<WebFetchResponse>;
+  headlessFetch?: (input: { url: string }) => Promise<WebFetchHeadlessResponse>;
+} = {}) {
+  const backends = createBackendSet(backendConfig);
+  const resolvedSearch = search ?? backends.search;
+  const resolvedFetchPage = fetchPage ?? backends.fetchPage;
+  const resolvedHeadlessFetch = headlessFetch ?? backends.headlessFetch;
+  const worker = createResearchWorker({ search: resolvedSearch, fetchPage: resolvedFetchPage });
+  return createResearchOrchestrator({
+    worker,
+    fetchDirect: resolvedFetchPage,
+    headlessFetch: resolvedHeadlessFetch
+  });
+}

package/dist/extensions/pi-web-agent/src/orchestration/query-planner.ts

@@ -1,47 +1,47 @@
-export type QueryPlanInput = {
-  originalQuery: string;
-  passIndex: number;
-  previousQueries: string[];
-  gaps: string[];
-};
-
-function normalizeWhitespace(value: string) {
-  return value.replace(/\s+/g, ' ').trim();
-}
-
-function extractImportantWords(query: string) {
-  return normalizeWhitespace(query)
-    .replace(/\b(find|current|tell|me|how|to|the|and|with|for|in|a|an)\b/gi, ' ')
-    .replace(/\s+/g, ' ')
-    .trim();
-}
-
-function officialSiteQuery(query: string) {
-  const lower = query.toLowerCase();
-  const terms = extractImportantWords(query);
-  if (lower.includes('vitest')) return `site:vitest.dev ${terms}`;
-  if (lower.includes('playwright')) return `site:playwright.dev ${terms}`;
-  if (lower.includes('microsoft edge') || lower.includes('edge')) return `site:learn.microsoft.com ${terms}`;
-  return `${terms} official docs`;
-}
-
-function implementationQuery(query: string) {
-  return `site:github.com ${extractImportantWords(query)}`;
-}
-
-export function planSearchQueries(input: QueryPlanInput): string[] {
-  const planned =
-    input.passIndex === 0
-      ? [input.originalQuery]
-      : [
-          officialSiteQuery(input.originalQuery),
-          implementationQuery(input.originalQuery),
-          `${extractImportantWords(input.originalQuery)} discussion`
-        ];
-
-  const previous = new Set(input.previousQueries.map(normalizeWhitespace));
-  return planned
-    .map(normalizeWhitespace)
-    .filter((query) => query && !previous.has(query))
-    .slice(0, 3);
-}
+export type QueryPlanInput = {
+  originalQuery: string;
+  passIndex: number;
+  previousQueries: string[];
+  gaps: string[];
+};
+
+function normalizeWhitespace(value: string) {
+  return value.replace(/\s+/g, ' ').trim();
+}
+
+function extractImportantWords(query: string) {
+  return normalizeWhitespace(query)
+    .replace(/\b(find|current|tell|me|how|to|the|and|with|for|in|a|an)\b/gi, ' ')
+    .replace(/\s+/g, ' ')
+    .trim();
+}
+
+function officialSiteQuery(query: string) {
+  const lower = query.toLowerCase();
+  const terms = extractImportantWords(query);
+  if (lower.includes('vitest')) return `site:vitest.dev ${terms}`;
+  if (lower.includes('playwright')) return `site:playwright.dev ${terms}`;
+  if (lower.includes('microsoft edge') || lower.includes('edge')) return `site:learn.microsoft.com ${terms}`;
+  return `${terms} official docs`;
+}
+
+function implementationQuery(query: string) {
+  return `site:github.com ${extractImportantWords(query)}`;
+}
+
+export function planSearchQueries(input: QueryPlanInput): string[] {
+  const planned =
+    input.passIndex === 0
+      ? [input.originalQuery]
+      : [
+          officialSiteQuery(input.originalQuery),
+          implementationQuery(input.originalQuery),
+          `${extractImportantWords(input.originalQuery)} discussion`
+        ];
+
+  const previous = new Set(input.previousQueries.map(normalizeWhitespace));
+  return planned
+    .map(normalizeWhitespace)
+    .filter((query) => query && !previous.has(query))
+    .slice(0, 3);
+}

package/dist/extensions/pi-web-agent/src/orchestration/stop-decider.ts

@@ -1,81 +1,81 @@
-import type { ResearchEvidence } from './research-types.js';
-import type { EvidenceQualityReport } from './evidence-quality.js';
-import { hasOfficialEvidence, strongEvidenceCount } from './evidence-ranker.js';
-
-export type ResearchStepDecision =
-  | { action: 'answer' }
-  | { action: 'answer-with-caveat' }
-  | { action: 'search-again' }
-  | { action: 'headless'; url: string };
-
-function activeCaveatReasons(evidence: ResearchEvidence[], quality?: EvidenceQualityReport) {
-  const reasons = quality?.caveatReasons ?? [];
-  if (!hasOfficialDocsAndApi(evidence)) return reasons;
-  return reasons.filter((reason) => reason !== 'low-diversity');
-}
-
-function hasQualityConcern(evidence: ResearchEvidence[], quality?: EvidenceQualityReport) {
-  return activeCaveatReasons(evidence, quality).length > 0;
-}
-
-function hasOfficialDocsAndApi(evidence: ResearchEvidence[]) {
-  return evidence.some((item) => item.sourceKind === 'official-docs') &&
-    evidence.some((item) => item.sourceKind === 'official-api');
-}
-
-function shouldSearchForBetterQuality({
-  evidence,
-  quality,
-  passIndex,
-  maxPasses
-}: {
-  evidence: ResearchEvidence[];
-  quality?: EvidenceQualityReport;
-  passIndex: number;
-  maxPasses: number;
-}) {
-  if (!quality) return false;
-  if (passIndex + 1 >= maxPasses) return false;
-  if (quality.flags.hasOnlyCommunityEvidence) return true;
-  if (quality.flags.hasLowDiversity && !hasOfficialDocsAndApi(evidence)) return true;
-  return false;
-}
-
-export function decideNextResearchStep({
-  evidence,
-  suggestedHeadlessUrls,
-  passIndex,
-  maxPasses,
-  headlessAttempts,
-  maxHeadlessAttempts,
-  quality
-}: {
-  evidence: ResearchEvidence[];
-  suggestedHeadlessUrls: string[];
-  passIndex: number;
-  maxPasses: number;
-  headlessAttempts: number;
-  maxHeadlessAttempts: number;
-  quality?: EvidenceQualityReport;
-}): ResearchStepDecision {
-  const strongEnough = strongEvidenceCount(evidence) >= 2 && hasOfficialEvidence(evidence);
-
-  if (strongEnough && shouldSearchForBetterQuality({ evidence, quality, passIndex, maxPasses })) {
-    return { action: 'search-again' };
-  }
-
-  if (strongEnough) {
-    return hasQualityConcern(evidence, quality) ? { action: 'answer-with-caveat' } : { action: 'answer' };
-  }
-
-  const headlessUrl = suggestedHeadlessUrls.find((url) => !url.includes('npmjs.com/package/'));
-  if (headlessUrl && headlessAttempts < maxHeadlessAttempts) {
-    return { action: 'headless', url: headlessUrl };
-  }
-
-  if (passIndex + 1 < maxPasses) {
-    return { action: 'search-again' };
-  }
-
-  return { action: 'answer-with-caveat' };
-}
+import type { ResearchEvidence } from './research-types.js';
+import type { EvidenceQualityReport } from './evidence-quality.js';
+import { hasOfficialEvidence, strongEvidenceCount } from './evidence-ranker.js';
+
+export type ResearchStepDecision =
+  | { action: 'answer' }
+  | { action: 'answer-with-caveat' }
+  | { action: 'search-again' }
+  | { action: 'headless'; url: string };
+
+function activeCaveatReasons(evidence: ResearchEvidence[], quality?: EvidenceQualityReport) {
+  const reasons = quality?.caveatReasons ?? [];
+  if (!hasOfficialDocsAndApi(evidence)) return reasons;
+  return reasons.filter((reason) => reason !== 'low-diversity');
+}
+
+function hasQualityConcern(evidence: ResearchEvidence[], quality?: EvidenceQualityReport) {
+  return activeCaveatReasons(evidence, quality).length > 0;
+}
+
+function hasOfficialDocsAndApi(evidence: ResearchEvidence[]) {
+  return evidence.some((item) => item.sourceKind === 'official-docs') &&
+    evidence.some((item) => item.sourceKind === 'official-api');
+}
+
+function shouldSearchForBetterQuality({
+  evidence,
+  quality,
+  passIndex,
+  maxPasses
+}: {
+  evidence: ResearchEvidence[];
+  quality?: EvidenceQualityReport;
+  passIndex: number;
+  maxPasses: number;
+}) {
+  if (!quality) return false;
+  if (passIndex + 1 >= maxPasses) return false;
+  if (quality.flags.hasOnlyCommunityEvidence) return true;
+  if (quality.flags.hasLowDiversity && !hasOfficialDocsAndApi(evidence)) return true;
+  return false;
+}
+
+export function decideNextResearchStep({
+  evidence,
+  suggestedHeadlessUrls,
+  passIndex,
+  maxPasses,
+  headlessAttempts,
+  maxHeadlessAttempts,
+  quality
+}: {
+  evidence: ResearchEvidence[];
+  suggestedHeadlessUrls: string[];
+  passIndex: number;
+  maxPasses: number;
+  headlessAttempts: number;
+  maxHeadlessAttempts: number;
+  quality?: EvidenceQualityReport;
+}): ResearchStepDecision {
+  const strongEnough = strongEvidenceCount(evidence) >= 2 && hasOfficialEvidence(evidence);
+
+  if (strongEnough && shouldSearchForBetterQuality({ evidence, quality, passIndex, maxPasses })) {
+    return { action: 'search-again' };
+  }
+
+  if (strongEnough) {
+    return hasQualityConcern(evidence, quality) ? { action: 'answer-with-caveat' } : { action: 'answer' };
+  }
+
+  const headlessUrl = suggestedHeadlessUrls.find((url) => !url.includes('npmjs.com/package/'));
+  if (headlessUrl && headlessAttempts < maxHeadlessAttempts) {
+    return { action: 'headless', url: headlessUrl };
+  }
+
+  if (passIndex + 1 < maxPasses) {
+    return { action: 'search-again' };
+  }
+
+  return { action: 'answer-with-caveat' };
+}