@spotpatch/shared 1.12.0 → 1.13.0

package/dist/contextual-ask-browser.cjs

@@ -0,0 +1,200 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/contextual-ask-browser.ts
+var contextual_ask_browser_exports = {};
+__export(contextual_ask_browser_exports, {
+  ASK_ANSWER_WARNING_CODES: () => ASK_ANSWER_WARNING_CODES,
+  ASK_EXECUTOR_ANSWER_WARNING_CODES: () => ASK_EXECUTOR_ANSWER_WARNING_CODES,
+  ASK_FILE_COUNT_BUCKETS: () => ASK_FILE_COUNT_BUCKETS,
+  ASK_JOB_STATUSES: () => ASK_JOB_STATUSES,
+  ASK_READ_ACTIVITY_STATES: () => ASK_READ_ACTIVITY_STATES,
+  ASK_SOURCE_CONFIDENCES: () => ASK_SOURCE_CONFIDENCES,
+  CONTEXTUAL_ASK_EXECUTOR_KINDS: () => CONTEXTUAL_ASK_EXECUTOR_KINDS,
+  CONTEXTUAL_ASK_EXECUTOR_STATES: () => CONTEXTUAL_ASK_EXECUTOR_STATES,
+  CONTEXTUAL_ASK_LIMITS: () => CONTEXTUAL_ASK_LIMITS,
+  CONTEXTUAL_ASK_SCHEMA_VERSION: () => CONTEXTUAL_ASK_SCHEMA_VERSION,
+  ERROR_CODES: () => ERROR_CODES,
+  SPOTPATCH_ENDPOINTS: () => SPOTPATCH_ENDPOINTS,
+  SPOTPATCH_TOKEN_HEADER: () => SPOTPATCH_TOKEN_HEADER,
+  getAskJobEndpoint: () => getAskJobEndpoint,
+  isErrorCode: () => isErrorCode
+});
+module.exports = __toCommonJS(contextual_ask_browser_exports);
+
+// src/protocol/contextual-ask-constants.ts
+var CONTEXTUAL_ASK_SCHEMA_VERSION = 1;
+var CONTEXTUAL_ASK_LIMITS = Object.freeze({
+  maximumTargets: 20,
+  maximumQuestionCharacters: 4e3,
+  maximumAnswerCharacters: 4e4,
+  maximumAnswerBlocks: 40,
+  maximumSources: 64,
+  maximumReadFiles: 32,
+  maximumReadBytesPerFile: 64 * 1024,
+  maximumReadBytesTotal: 512 * 1024,
+  maximumToolCalls: 48,
+  maximumModelTurns: 12,
+  jobTimeoutMs: 3e5,
+  resultTtlMs: 9e5,
+  maximumActiveJobsPerSession: 1,
+  maximumRetainedResultsPerSession: 1,
+  maximumRetainedEvents: 256,
+  maximumEventSubscribers: 4,
+  eventHeartbeatMs: 15e3,
+  maximumRequestBodyBytes: 256 * 1024,
+  maximumSearchQueryCharacters: 256,
+  maximumSearchResults: 64,
+  maximumSearchPreviewCharacters: 500,
+  capabilityTimeoutMs: 3e4,
+  maximumIdCharacters: 128,
+  maximumProfileIdCharacters: 64,
+  maximumLabelCharacters: 256,
+  maximumRelativePathCharacters: 1024,
+  maximumLanguageCharacters: 64,
+  maximumPhaseMessageCharacters: 1024,
+  maximumExecutors: 32,
+  contentHashHexCharacters: 64
+});
+var CONTEXTUAL_ASK_EXECUTOR_KINDS = Object.freeze([
+  "configured-key",
+  "managed-codex"
+]);
+var CONTEXTUAL_ASK_EXECUTOR_STATES = Object.freeze([
+  "ready",
+  "degraded",
+  "unavailable"
+]);
+var ASK_JOB_STATUSES = Object.freeze([
+  "queued",
+  "authorizing",
+  "running",
+  "cancelling",
+  "answered",
+  "cancelled",
+  "failed"
+]);
+var ASK_ANSWER_WARNING_CODES = Object.freeze([
+  "insufficient-evidence",
+  "partial-context",
+  "source-truncated",
+  "source-stale"
+]);
+var ASK_EXECUTOR_ANSWER_WARNING_CODES = Object.freeze([
+  "insufficient-evidence",
+  "partial-context"
+]);
+var ASK_READ_ACTIVITY_STATES = Object.freeze([
+  "started",
+  "succeeded",
+  "failed"
+]);
+var ASK_FILE_COUNT_BUCKETS = Object.freeze(["one", "few", "many"]);
+var ASK_SOURCE_CONFIDENCES = Object.freeze([
+  "exact",
+  "probable",
+  "approximate"
+]);
+
+// src/protocol/endpoints.ts
+var SPOTPATCH_API_BASE = "/__spotpatch/v1";
+var SPOTPATCH_TOKEN_HEADER = "X-SpotPatch-Token";
+var SPOTPATCH_ENDPOINTS = Object.freeze({
+  bootstrap: `${SPOTPATCH_API_BASE}/bootstrap`,
+  sourceContext: `${SPOTPATCH_API_BASE}/source-context`,
+  openEditor: `${SPOTPATCH_API_BASE}/open-editor`,
+  dataFlowComponentReport: `${SPOTPATCH_API_BASE}/data-flow/component-report`,
+  dataFlowPageReport: `${SPOTPATCH_API_BASE}/data-flow/page-report`,
+  agentCapability: `${SPOTPATCH_API_BASE}/agent/capability`,
+  agentWorkspaceHealth: `${SPOTPATCH_API_BASE}/agent/workspace-health`,
+  agentJobs: `${SPOTPATCH_API_BASE}/agent/jobs`,
+  askCapability: `${SPOTPATCH_API_BASE}/ask/capability`,
+  askJobs: `${SPOTPATCH_API_BASE}/ask/jobs`,
+  externalHandoffCapability: `${SPOTPATCH_API_BASE}/external-handoff/capability`,
+  externalHandoffPublish: `${SPOTPATCH_API_BASE}/external-handoff/publish`,
+  externalHandoffStatus: `${SPOTPATCH_API_BASE}/external-handoff/status`,
+  externalHandoffResolveDelivery: `${SPOTPATCH_API_BASE}/external-handoff/resolve-delivery`,
+  externalAgentControlStatus: `${SPOTPATCH_API_BASE}/external-agent/control/status`,
+  externalAgentControlConnect: `${SPOTPATCH_API_BASE}/external-agent/control/connect`,
+  externalAgentControlDisconnect: `${SPOTPATCH_API_BASE}/external-agent/control/disconnect`,
+  externalAgentControlCancel: `${SPOTPATCH_API_BASE}/external-agent/control/cancel`,
+  externalAgentEvents: `${SPOTPATCH_API_BASE}/external-agent/events`,
+  externalAgentResult: `${SPOTPATCH_API_BASE}/external-agent/result`
+});
+function getAskJobEndpoint(jobId, action, options = {}) {
+  const endpoint = `${SPOTPATCH_ENDPOINTS.askJobs}/${encodeURIComponent(jobId)}/${action}`;
+  if (action !== "events" && options.afterSequence !== void 0) {
+    throw new RangeError("afterSequence is only valid for the events endpoint.");
+  }
+  if (options.afterSequence === void 0) return endpoint;
+  if (!Number.isSafeInteger(options.afterSequence) || options.afterSequence < 0) {
+    throw new RangeError("afterSequence must be a non-negative safe integer.");
+  }
+  return `${endpoint}?afterSequence=${String(options.afterSequence)}`;
+}
+
+// src/contextual-ask-browser.ts
+var CONTEXTUAL_ASK_ERRORS = {
+  ASK_DISABLED: "ASK_DISABLED",
+  ASK_SELECTION_REQUIRED: "ASK_SELECTION_REQUIRED",
+  ASK_SELECTION_STALE: "ASK_SELECTION_STALE",
+  ASK_QUESTION_INVALID: "ASK_QUESTION_INVALID",
+  ASK_EXECUTOR_UNAVAILABLE: "ASK_EXECUTOR_UNAVAILABLE",
+  ASK_TIMEOUT: "ASK_TIMEOUT",
+  ASK_CONSENT_REQUIRED: "ASK_CONSENT_REQUIRED",
+  ASK_BUSY: "ASK_BUSY",
+  ASK_IDEMPOTENCY_CONFLICT: "ASK_IDEMPOTENCY_CONFLICT",
+  ASK_SOURCE_SCOPE_DENIED: "ASK_SOURCE_SCOPE_DENIED",
+  ASK_LIMIT_EXCEEDED: "ASK_LIMIT_EXCEEDED",
+  ASK_ANSWER_INVALID: "ASK_ANSWER_INVALID",
+  ASK_WRITE_ATTEMPTED: "ASK_WRITE_ATTEMPTED",
+  ASK_CANCELLED: "ASK_CANCELLED",
+  ASK_RESULT_EXPIRED: "ASK_RESULT_EXPIRED",
+  ASK_PROTOCOL_INCOMPATIBLE: "ASK_PROTOCOL_INCOMPATIBLE"
+};
+var ERROR_CODES = Object.freeze({
+  INVALID_REQUEST: "INVALID_REQUEST",
+  INVALID_TOKEN: "INVALID_TOKEN",
+  ORIGIN_NOT_ALLOWED: "ORIGIN_NOT_ALLOWED",
+  ...CONTEXTUAL_ASK_ERRORS,
+  INTERNAL_ERROR: "INTERNAL_ERROR"
+});
+var ERROR_CODE_VALUES = Object.values(ERROR_CODES);
+function isErrorCode(value) {
+  return typeof value === "string" && ERROR_CODE_VALUES.includes(value);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ASK_ANSWER_WARNING_CODES,
+  ASK_EXECUTOR_ANSWER_WARNING_CODES,
+  ASK_FILE_COUNT_BUCKETS,
+  ASK_JOB_STATUSES,
+  ASK_READ_ACTIVITY_STATES,
+  ASK_SOURCE_CONFIDENCES,
+  CONTEXTUAL_ASK_EXECUTOR_KINDS,
+  CONTEXTUAL_ASK_EXECUTOR_STATES,
+  CONTEXTUAL_ASK_LIMITS,
+  CONTEXTUAL_ASK_SCHEMA_VERSION,
+  ERROR_CODES,
+  SPOTPATCH_ENDPOINTS,
+  SPOTPATCH_TOKEN_HEADER,
+  getAskJobEndpoint,
+  isErrorCode
+});
+//# sourceMappingURL=contextual-ask-browser.cjs.map

package/dist/contextual-ask-browser.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/contextual-ask-browser.ts","../src/protocol/contextual-ask-constants.ts","../src/protocol/endpoints.ts"],"sourcesContent":["import type { ERROR_CODES as GLOBAL_ERROR_CODES } from \"./errors/error-code.js\";\nimport type { ContextualAskErrorCode } from \"./errors/error-code.js\";\n\nconst CONTEXTUAL_ASK_ERRORS = {\n  ASK_DISABLED: \"ASK_DISABLED\",\n  ASK_SELECTION_REQUIRED: \"ASK_SELECTION_REQUIRED\",\n  ASK_SELECTION_STALE: \"ASK_SELECTION_STALE\",\n  ASK_QUESTION_INVALID: \"ASK_QUESTION_INVALID\",\n  ASK_EXECUTOR_UNAVAILABLE: \"ASK_EXECUTOR_UNAVAILABLE\",\n  ASK_TIMEOUT: \"ASK_TIMEOUT\",\n  ASK_CONSENT_REQUIRED: \"ASK_CONSENT_REQUIRED\",\n  ASK_BUSY: \"ASK_BUSY\",\n  ASK_IDEMPOTENCY_CONFLICT: \"ASK_IDEMPOTENCY_CONFLICT\",\n  ASK_SOURCE_SCOPE_DENIED: \"ASK_SOURCE_SCOPE_DENIED\",\n  ASK_LIMIT_EXCEEDED: \"ASK_LIMIT_EXCEEDED\",\n  ASK_ANSWER_INVALID: \"ASK_ANSWER_INVALID\",\n  ASK_WRITE_ATTEMPTED: \"ASK_WRITE_ATTEMPTED\",\n  ASK_CANCELLED: \"ASK_CANCELLED\",\n  ASK_RESULT_EXPIRED: \"ASK_RESULT_EXPIRED\",\n  ASK_PROTOCOL_INCOMPATIBLE: \"ASK_PROTOCOL_INCOMPATIBLE\",\n} as const satisfies Record<ContextualAskErrorCode, ContextualAskErrorCode>;\n\n/** Browser-reachable Ask errors only; no provider details or Node failures. */\nexport const ERROR_CODES = Object.freeze({\n  INVALID_REQUEST: \"INVALID_REQUEST\",\n  INVALID_TOKEN: \"INVALID_TOKEN\",\n  ORIGIN_NOT_ALLOWED: \"ORIGIN_NOT_ALLOWED\",\n  ...CONTEXTUAL_ASK_ERRORS,\n  INTERNAL_ERROR: \"INTERNAL_ERROR\",\n} as const satisfies Pick<\n  typeof GLOBAL_ERROR_CODES,\n  \"INTERNAL_ERROR\" | \"INVALID_REQUEST\" | \"INVALID_TOKEN\" | \"ORIGIN_NOT_ALLOWED\"\n>);\nexport type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];\nconst ERROR_CODE_VALUES: readonly string[] = Object.values(ERROR_CODES);\n\nexport function isErrorCode(value: unknown): value is ErrorCode {\n  return typeof value === \"string\" && ERROR_CODE_VALUES.includes(value);\n}\n\nexport {\n  ASK_ANSWER_WARNING_CODES,\n  ASK_EXECUTOR_ANSWER_WARNING_CODES,\n  ASK_FILE_COUNT_BUCKETS,\n  ASK_JOB_STATUSES,\n  ASK_READ_ACTIVITY_STATES,\n  ASK_SOURCE_CONFIDENCES,\n  CONTEXTUAL_ASK_EXECUTOR_KINDS,\n  CONTEXTUAL_ASK_EXECUTOR_STATES,\n  CONTEXTUAL_ASK_LIMITS,\n  CONTEXTUAL_ASK_SCHEMA_VERSION,\n  type AskAnswerWarningCode,\n  type AskExecutorAnswerWarningCode,\n  type AskFileCountBucket,\n  type AskJobStatus,\n  type AskReadActivityState,\n  type AskSourceConfidence,\n  type ContextualAskExecutorKind,\n  type ContextualAskExecutorState,\n} from \"./protocol/contextual-ask-constants.js\";\nexport {\n  getAskJobEndpoint,\n  SPOTPATCH_ENDPOINTS,\n  SPOTPATCH_TOKEN_HEADER,\n  type AskJobAction,\n} from \"./protocol/endpoints.js\";\nexport type {\n  AskAnswerBlock,\n  AskAnswerResult,\n  AskAnswerWarning,\n  AskDraftOrigin,\n  AskSourceReference,\n  ContextualAskCapability,\n  ContextualAskExecutorCapability,\n  SpotAskTaskEnvelope,\n  SpotChangeTaskEnvelope,\n  SpotSelectionContext,\n  SpotSelectionTarget,\n  SpotTaskEnvelope,\n} from \"./model/contextual-ask.js\";\nexport type {\n  AskJobActionRequest,\n  AskJobCreateRequest,\n  AskJobEvent,\n  AskJobEventsRequest,\n  AskJobResultResponse,\n  AskJobSnapshot,\n  ContextualAskCapabilityRequest,\n} from \"./protocol/contextual-ask.js\";\n","export const CONTEXTUAL_ASK_SCHEMA_VERSION = 1 as const;\n\nexport const CONTEXTUAL_ASK_LIMITS = Object.freeze({\n  maximumTargets: 20,\n  maximumQuestionCharacters: 4_000,\n  maximumAnswerCharacters: 40_000,\n  maximumAnswerBlocks: 40,\n  maximumSources: 64,\n  maximumReadFiles: 32,\n  maximumReadBytesPerFile: 64 * 1_024,\n  maximumReadBytesTotal: 512 * 1_024,\n  maximumToolCalls: 48,\n  maximumModelTurns: 12,\n  jobTimeoutMs: 300_000,\n  resultTtlMs: 900_000,\n  maximumActiveJobsPerSession: 1,\n  maximumRetainedResultsPerSession: 1,\n  maximumRetainedEvents: 256,\n  maximumEventSubscribers: 4,\n  eventHeartbeatMs: 15_000,\n  maximumRequestBodyBytes: 256 * 1_024,\n  maximumSearchQueryCharacters: 256,\n  maximumSearchResults: 64,\n  maximumSearchPreviewCharacters: 500,\n  capabilityTimeoutMs: 30_000,\n  maximumIdCharacters: 128,\n  maximumProfileIdCharacters: 64,\n  maximumLabelCharacters: 256,\n  maximumRelativePathCharacters: 1_024,\n  maximumLanguageCharacters: 64,\n  maximumPhaseMessageCharacters: 1_024,\n  maximumExecutors: 32,\n  contentHashHexCharacters: 64,\n} as const);\n\nexport const CONTEXTUAL_ASK_EXECUTOR_KINDS = Object.freeze([\n  \"configured-key\",\n  \"managed-codex\",\n] as const);\nexport type ContextualAskExecutorKind = (typeof CONTEXTUAL_ASK_EXECUTOR_KINDS)[number];\n\nexport const CONTEXTUAL_ASK_EXECUTOR_STATES = Object.freeze([\n  \"ready\",\n  \"degraded\",\n  \"unavailable\",\n] as const);\nexport type ContextualAskExecutorState =\n  (typeof CONTEXTUAL_ASK_EXECUTOR_STATES)[number];\n\nexport const ASK_JOB_STATUSES = Object.freeze([\n  \"queued\",\n  \"authorizing\",\n  \"running\",\n  \"cancelling\",\n  \"answered\",\n  \"cancelled\",\n  \"failed\",\n] as const);\nexport type AskJobStatus = (typeof ASK_JOB_STATUSES)[number];\n\nexport const ASK_ANSWER_WARNING_CODES = Object.freeze([\n  \"insufficient-evidence\",\n  \"partial-context\",\n  \"source-truncated\",\n  \"source-stale\",\n] as const);\nexport type AskAnswerWarningCode = (typeof ASK_ANSWER_WARNING_CODES)[number];\n\n/** Warnings an executor may declare from its own evidence assessment. */\nexport const ASK_EXECUTOR_ANSWER_WARNING_CODES = Object.freeze([\n  \"insufficient-evidence\",\n  \"partial-context\",\n] as const satisfies readonly AskAnswerWarningCode[]);\nexport type AskExecutorAnswerWarningCode =\n  (typeof ASK_EXECUTOR_ANSWER_WARNING_CODES)[number];\n\nexport const ASK_READ_ACTIVITY_STATES = Object.freeze([\n  \"started\",\n  \"succeeded\",\n  \"failed\",\n] as const);\nexport type AskReadActivityState = (typeof ASK_READ_ACTIVITY_STATES)[number];\n\nexport const ASK_FILE_COUNT_BUCKETS = Object.freeze([\"one\", \"few\", \"many\"] as const);\nexport type AskFileCountBucket = (typeof ASK_FILE_COUNT_BUCKETS)[number];\n\nexport const ASK_SOURCE_CONFIDENCES = Object.freeze([\n  \"exact\",\n  \"probable\",\n  \"approximate\",\n] as const);\nexport type AskSourceConfidence = (typeof ASK_SOURCE_CONFIDENCES)[number];\n\nexport const CONTEXTUAL_ASK_PERMISSION_PROFILE = \"spotpatch-ask-readonly\" as const;\n","export const SPOTPATCH_API_BASE = \"/__spotpatch/v1\" as const;\nexport const SPOTPATCH_TOKEN_HEADER = \"X-SpotPatch-Token\" as const;\n\nexport const SPOTPATCH_ENDPOINTS = Object.freeze({\n  bootstrap: `${SPOTPATCH_API_BASE}/bootstrap`,\n  sourceContext: `${SPOTPATCH_API_BASE}/source-context`,\n  openEditor: `${SPOTPATCH_API_BASE}/open-editor`,\n  dataFlowComponentReport: `${SPOTPATCH_API_BASE}/data-flow/component-report`,\n  dataFlowPageReport: `${SPOTPATCH_API_BASE}/data-flow/page-report`,\n  agentCapability: `${SPOTPATCH_API_BASE}/agent/capability`,\n  agentWorkspaceHealth: `${SPOTPATCH_API_BASE}/agent/workspace-health`,\n  agentJobs: `${SPOTPATCH_API_BASE}/agent/jobs`,\n  askCapability: `${SPOTPATCH_API_BASE}/ask/capability`,\n  askJobs: `${SPOTPATCH_API_BASE}/ask/jobs`,\n  externalHandoffCapability: `${SPOTPATCH_API_BASE}/external-handoff/capability`,\n  externalHandoffPublish: `${SPOTPATCH_API_BASE}/external-handoff/publish`,\n  externalHandoffStatus: `${SPOTPATCH_API_BASE}/external-handoff/status`,\n  externalHandoffResolveDelivery: `${SPOTPATCH_API_BASE}/external-handoff/resolve-delivery`,\n  externalAgentControlStatus: `${SPOTPATCH_API_BASE}/external-agent/control/status`,\n  externalAgentControlConnect: `${SPOTPATCH_API_BASE}/external-agent/control/connect`,\n  externalAgentControlDisconnect: `${SPOTPATCH_API_BASE}/external-agent/control/disconnect`,\n  externalAgentControlCancel: `${SPOTPATCH_API_BASE}/external-agent/control/cancel`,\n  externalAgentEvents: `${SPOTPATCH_API_BASE}/external-agent/events`,\n  externalAgentResult: `${SPOTPATCH_API_BASE}/external-agent/result`,\n});\n\nexport type AgentJobAction = \"events\" | \"result\" | \"cancel\" | \"apply\" | \"revert\";\nexport type AskJobAction = \"events\" | \"result\" | \"cancel\";\n\nexport function getAgentJobEndpoint(jobId: string, action: AgentJobAction): string {\n  return `${SPOTPATCH_ENDPOINTS.agentJobs}/${encodeURIComponent(jobId)}/${action}`;\n}\n\nexport function getAskJobEndpoint(\n  jobId: string,\n  action: AskJobAction,\n  options: Readonly<{ afterSequence?: number }> = {},\n): string {\n  const endpoint = `${SPOTPATCH_ENDPOINTS.askJobs}/${encodeURIComponent(jobId)}/${action}`;\n  if (action !== \"events\" && options.afterSequence !== undefined) {\n    throw new RangeError(\"afterSequence is only valid for the events endpoint.\");\n  }\n  if (options.afterSequence === undefined) return endpoint;\n  if (!Number.isSafeInteger(options.afterSequence) || options.afterSequence < 0) {\n    throw new RangeError(\"afterSequence must be a non-negative safe integer.\");\n  }\n  return `${endpoint}?afterSequence=${String(options.afterSequence)}`;\n}\n"],"mappings":"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","names":[]}

package/dist/contextual-ask-browser.d.cts

@@ -0,0 +1,31 @@
+export { A as ASK_ANSWER_WARNING_CODES, a as ASK_EXECUTOR_ANSWER_WARNING_CODES, b as ASK_FILE_COUNT_BUCKETS, c as ASK_JOB_STATUSES, d as ASK_READ_ACTIVITY_STATES, e as ASK_SOURCE_CONFIDENCES, f as AskAnswerBlock, g as AskAnswerResult, h as AskAnswerWarning, i as AskAnswerWarningCode, j as AskDraftOrigin, k as AskExecutorAnswerWarningCode, l as AskFileCountBucket, m as AskJobActionRequest, n as AskJobCreateRequest, o as AskJobEvent, p as AskJobEventsRequest, q as AskJobResultResponse, r as AskJobSnapshot, s as AskJobStatus, t as AskReadActivityState, u as AskSourceConfidence, v as AskSourceReference, C as CONTEXTUAL_ASK_EXECUTOR_KINDS, w as CONTEXTUAL_ASK_EXECUTOR_STATES, x as CONTEXTUAL_ASK_LIMITS, y as CONTEXTUAL_ASK_SCHEMA_VERSION, z as ContextualAskCapability, B as ContextualAskCapabilityRequest, D as ContextualAskExecutorCapability, E as ContextualAskExecutorKind, F as ContextualAskExecutorState, S as SpotAskTaskEnvelope, G as SpotChangeTaskEnvelope, H as SpotSelectionContext, I as SpotSelectionTarget, J as SpotTaskEnvelope } from './contextual-ask-B0mCFn92.cjs';
+export { A as AskJobAction, S as SPOTPATCH_ENDPOINTS, a as SPOTPATCH_TOKEN_HEADER, g as getAskJobEndpoint } from './endpoints-O3ohYyAo.cjs';
+import 'zod';
+
+/** Browser-reachable Ask errors only; no provider details or Node failures. */
+declare const ERROR_CODES: Readonly<{
+    readonly INTERNAL_ERROR: "INTERNAL_ERROR";
+    readonly ASK_DISABLED: "ASK_DISABLED";
+    readonly ASK_SELECTION_REQUIRED: "ASK_SELECTION_REQUIRED";
+    readonly ASK_SELECTION_STALE: "ASK_SELECTION_STALE";
+    readonly ASK_QUESTION_INVALID: "ASK_QUESTION_INVALID";
+    readonly ASK_EXECUTOR_UNAVAILABLE: "ASK_EXECUTOR_UNAVAILABLE";
+    readonly ASK_TIMEOUT: "ASK_TIMEOUT";
+    readonly ASK_CONSENT_REQUIRED: "ASK_CONSENT_REQUIRED";
+    readonly ASK_BUSY: "ASK_BUSY";
+    readonly ASK_IDEMPOTENCY_CONFLICT: "ASK_IDEMPOTENCY_CONFLICT";
+    readonly ASK_SOURCE_SCOPE_DENIED: "ASK_SOURCE_SCOPE_DENIED";
+    readonly ASK_LIMIT_EXCEEDED: "ASK_LIMIT_EXCEEDED";
+    readonly ASK_ANSWER_INVALID: "ASK_ANSWER_INVALID";
+    readonly ASK_WRITE_ATTEMPTED: "ASK_WRITE_ATTEMPTED";
+    readonly ASK_CANCELLED: "ASK_CANCELLED";
+    readonly ASK_RESULT_EXPIRED: "ASK_RESULT_EXPIRED";
+    readonly ASK_PROTOCOL_INCOMPATIBLE: "ASK_PROTOCOL_INCOMPATIBLE";
+    readonly INVALID_REQUEST: "INVALID_REQUEST";
+    readonly INVALID_TOKEN: "INVALID_TOKEN";
+    readonly ORIGIN_NOT_ALLOWED: "ORIGIN_NOT_ALLOWED";
+}>;
+type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];
+declare function isErrorCode(value: unknown): value is ErrorCode;
+
+export { ERROR_CODES, type ErrorCode, isErrorCode };

package/dist/contextual-ask-browser.d.ts

@@ -0,0 +1,31 @@
+export { A as ASK_ANSWER_WARNING_CODES, a as ASK_EXECUTOR_ANSWER_WARNING_CODES, b as ASK_FILE_COUNT_BUCKETS, c as ASK_JOB_STATUSES, d as ASK_READ_ACTIVITY_STATES, e as ASK_SOURCE_CONFIDENCES, f as AskAnswerBlock, g as AskAnswerResult, h as AskAnswerWarning, i as AskAnswerWarningCode, j as AskDraftOrigin, k as AskExecutorAnswerWarningCode, l as AskFileCountBucket, m as AskJobActionRequest, n as AskJobCreateRequest, o as AskJobEvent, p as AskJobEventsRequest, q as AskJobResultResponse, r as AskJobSnapshot, s as AskJobStatus, t as AskReadActivityState, u as AskSourceConfidence, v as AskSourceReference, C as CONTEXTUAL_ASK_EXECUTOR_KINDS, w as CONTEXTUAL_ASK_EXECUTOR_STATES, x as CONTEXTUAL_ASK_LIMITS, y as CONTEXTUAL_ASK_SCHEMA_VERSION, z as ContextualAskCapability, B as ContextualAskCapabilityRequest, D as ContextualAskExecutorCapability, E as ContextualAskExecutorKind, F as ContextualAskExecutorState, S as SpotAskTaskEnvelope, G as SpotChangeTaskEnvelope, H as SpotSelectionContext, I as SpotSelectionTarget, J as SpotTaskEnvelope } from './contextual-ask-B0mCFn92.js';
+export { A as AskJobAction, S as SPOTPATCH_ENDPOINTS, a as SPOTPATCH_TOKEN_HEADER, g as getAskJobEndpoint } from './endpoints-O3ohYyAo.js';
+import 'zod';
+
+/** Browser-reachable Ask errors only; no provider details or Node failures. */
+declare const ERROR_CODES: Readonly<{
+    readonly INTERNAL_ERROR: "INTERNAL_ERROR";
+    readonly ASK_DISABLED: "ASK_DISABLED";
+    readonly ASK_SELECTION_REQUIRED: "ASK_SELECTION_REQUIRED";
+    readonly ASK_SELECTION_STALE: "ASK_SELECTION_STALE";
+    readonly ASK_QUESTION_INVALID: "ASK_QUESTION_INVALID";
+    readonly ASK_EXECUTOR_UNAVAILABLE: "ASK_EXECUTOR_UNAVAILABLE";
+    readonly ASK_TIMEOUT: "ASK_TIMEOUT";
+    readonly ASK_CONSENT_REQUIRED: "ASK_CONSENT_REQUIRED";
+    readonly ASK_BUSY: "ASK_BUSY";
+    readonly ASK_IDEMPOTENCY_CONFLICT: "ASK_IDEMPOTENCY_CONFLICT";
+    readonly ASK_SOURCE_SCOPE_DENIED: "ASK_SOURCE_SCOPE_DENIED";
+    readonly ASK_LIMIT_EXCEEDED: "ASK_LIMIT_EXCEEDED";
+    readonly ASK_ANSWER_INVALID: "ASK_ANSWER_INVALID";
+    readonly ASK_WRITE_ATTEMPTED: "ASK_WRITE_ATTEMPTED";
+    readonly ASK_CANCELLED: "ASK_CANCELLED";
+    readonly ASK_RESULT_EXPIRED: "ASK_RESULT_EXPIRED";
+    readonly ASK_PROTOCOL_INCOMPATIBLE: "ASK_PROTOCOL_INCOMPATIBLE";
+    readonly INVALID_REQUEST: "INVALID_REQUEST";
+    readonly INVALID_TOKEN: "INVALID_TOKEN";
+    readonly ORIGIN_NOT_ALLOWED: "ORIGIN_NOT_ALLOWED";
+}>;
+type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];
+declare function isErrorCode(value: unknown): value is ErrorCode;
+
+export { ERROR_CODES, type ErrorCode, isErrorCode };

package/dist/contextual-ask-browser.js

@@ -0,0 +1,66 @@
+import {
+  ASK_ANSWER_WARNING_CODES,
+  ASK_EXECUTOR_ANSWER_WARNING_CODES,
+  ASK_FILE_COUNT_BUCKETS,
+  ASK_JOB_STATUSES,
+  ASK_READ_ACTIVITY_STATES,
+  ASK_SOURCE_CONFIDENCES,
+  CONTEXTUAL_ASK_EXECUTOR_KINDS,
+  CONTEXTUAL_ASK_EXECUTOR_STATES,
+  CONTEXTUAL_ASK_LIMITS,
+  CONTEXTUAL_ASK_SCHEMA_VERSION
+} from "./chunk-DYTWEIES.js";
+import {
+  SPOTPATCH_ENDPOINTS,
+  SPOTPATCH_TOKEN_HEADER,
+  getAskJobEndpoint
+} from "./chunk-FPDSZDP2.js";
+
+// src/contextual-ask-browser.ts
+var CONTEXTUAL_ASK_ERRORS = {
+  ASK_DISABLED: "ASK_DISABLED",
+  ASK_SELECTION_REQUIRED: "ASK_SELECTION_REQUIRED",
+  ASK_SELECTION_STALE: "ASK_SELECTION_STALE",
+  ASK_QUESTION_INVALID: "ASK_QUESTION_INVALID",
+  ASK_EXECUTOR_UNAVAILABLE: "ASK_EXECUTOR_UNAVAILABLE",
+  ASK_TIMEOUT: "ASK_TIMEOUT",
+  ASK_CONSENT_REQUIRED: "ASK_CONSENT_REQUIRED",
+  ASK_BUSY: "ASK_BUSY",
+  ASK_IDEMPOTENCY_CONFLICT: "ASK_IDEMPOTENCY_CONFLICT",
+  ASK_SOURCE_SCOPE_DENIED: "ASK_SOURCE_SCOPE_DENIED",
+  ASK_LIMIT_EXCEEDED: "ASK_LIMIT_EXCEEDED",
+  ASK_ANSWER_INVALID: "ASK_ANSWER_INVALID",
+  ASK_WRITE_ATTEMPTED: "ASK_WRITE_ATTEMPTED",
+  ASK_CANCELLED: "ASK_CANCELLED",
+  ASK_RESULT_EXPIRED: "ASK_RESULT_EXPIRED",
+  ASK_PROTOCOL_INCOMPATIBLE: "ASK_PROTOCOL_INCOMPATIBLE"
+};
+var ERROR_CODES = Object.freeze({
+  INVALID_REQUEST: "INVALID_REQUEST",
+  INVALID_TOKEN: "INVALID_TOKEN",
+  ORIGIN_NOT_ALLOWED: "ORIGIN_NOT_ALLOWED",
+  ...CONTEXTUAL_ASK_ERRORS,
+  INTERNAL_ERROR: "INTERNAL_ERROR"
+});
+var ERROR_CODE_VALUES = Object.values(ERROR_CODES);
+function isErrorCode(value) {
+  return typeof value === "string" && ERROR_CODE_VALUES.includes(value);
+}
+export {
+  ASK_ANSWER_WARNING_CODES,
+  ASK_EXECUTOR_ANSWER_WARNING_CODES,
+  ASK_FILE_COUNT_BUCKETS,
+  ASK_JOB_STATUSES,
+  ASK_READ_ACTIVITY_STATES,
+  ASK_SOURCE_CONFIDENCES,
+  CONTEXTUAL_ASK_EXECUTOR_KINDS,
+  CONTEXTUAL_ASK_EXECUTOR_STATES,
+  CONTEXTUAL_ASK_LIMITS,
+  CONTEXTUAL_ASK_SCHEMA_VERSION,
+  ERROR_CODES,
+  SPOTPATCH_ENDPOINTS,
+  SPOTPATCH_TOKEN_HEADER,
+  getAskJobEndpoint,
+  isErrorCode
+};
+//# sourceMappingURL=contextual-ask-browser.js.map

package/dist/contextual-ask-browser.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/contextual-ask-browser.ts"],"sourcesContent":["import type { ERROR_CODES as GLOBAL_ERROR_CODES } from \"./errors/error-code.js\";\nimport type { ContextualAskErrorCode } from \"./errors/error-code.js\";\n\nconst CONTEXTUAL_ASK_ERRORS = {\n  ASK_DISABLED: \"ASK_DISABLED\",\n  ASK_SELECTION_REQUIRED: \"ASK_SELECTION_REQUIRED\",\n  ASK_SELECTION_STALE: \"ASK_SELECTION_STALE\",\n  ASK_QUESTION_INVALID: \"ASK_QUESTION_INVALID\",\n  ASK_EXECUTOR_UNAVAILABLE: \"ASK_EXECUTOR_UNAVAILABLE\",\n  ASK_TIMEOUT: \"ASK_TIMEOUT\",\n  ASK_CONSENT_REQUIRED: \"ASK_CONSENT_REQUIRED\",\n  ASK_BUSY: \"ASK_BUSY\",\n  ASK_IDEMPOTENCY_CONFLICT: \"ASK_IDEMPOTENCY_CONFLICT\",\n  ASK_SOURCE_SCOPE_DENIED: \"ASK_SOURCE_SCOPE_DENIED\",\n  ASK_LIMIT_EXCEEDED: \"ASK_LIMIT_EXCEEDED\",\n  ASK_ANSWER_INVALID: \"ASK_ANSWER_INVALID\",\n  ASK_WRITE_ATTEMPTED: \"ASK_WRITE_ATTEMPTED\",\n  ASK_CANCELLED: \"ASK_CANCELLED\",\n  ASK_RESULT_EXPIRED: \"ASK_RESULT_EXPIRED\",\n  ASK_PROTOCOL_INCOMPATIBLE: \"ASK_PROTOCOL_INCOMPATIBLE\",\n} as const satisfies Record<ContextualAskErrorCode, ContextualAskErrorCode>;\n\n/** Browser-reachable Ask errors only; no provider details or Node failures. */\nexport const ERROR_CODES = Object.freeze({\n  INVALID_REQUEST: \"INVALID_REQUEST\",\n  INVALID_TOKEN: \"INVALID_TOKEN\",\n  ORIGIN_NOT_ALLOWED: \"ORIGIN_NOT_ALLOWED\",\n  ...CONTEXTUAL_ASK_ERRORS,\n  INTERNAL_ERROR: \"INTERNAL_ERROR\",\n} as const satisfies Pick<\n  typeof GLOBAL_ERROR_CODES,\n  \"INTERNAL_ERROR\" | \"INVALID_REQUEST\" | \"INVALID_TOKEN\" | \"ORIGIN_NOT_ALLOWED\"\n>);\nexport type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];\nconst ERROR_CODE_VALUES: readonly string[] = Object.values(ERROR_CODES);\n\nexport function isErrorCode(value: unknown): value is ErrorCode {\n  return typeof value === \"string\" && ERROR_CODE_VALUES.includes(value);\n}\n\nexport {\n  ASK_ANSWER_WARNING_CODES,\n  ASK_EXECUTOR_ANSWER_WARNING_CODES,\n  ASK_FILE_COUNT_BUCKETS,\n  ASK_JOB_STATUSES,\n  ASK_READ_ACTIVITY_STATES,\n  ASK_SOURCE_CONFIDENCES,\n  CONTEXTUAL_ASK_EXECUTOR_KINDS,\n  CONTEXTUAL_ASK_EXECUTOR_STATES,\n  CONTEXTUAL_ASK_LIMITS,\n  CONTEXTUAL_ASK_SCHEMA_VERSION,\n  type AskAnswerWarningCode,\n  type AskExecutorAnswerWarningCode,\n  type AskFileCountBucket,\n  type AskJobStatus,\n  type AskReadActivityState,\n  type AskSourceConfidence,\n  type ContextualAskExecutorKind,\n  type ContextualAskExecutorState,\n} from \"./protocol/contextual-ask-constants.js\";\nexport {\n  getAskJobEndpoint,\n  SPOTPATCH_ENDPOINTS,\n  SPOTPATCH_TOKEN_HEADER,\n  type AskJobAction,\n} from \"./protocol/endpoints.js\";\nexport type {\n  AskAnswerBlock,\n  AskAnswerResult,\n  AskAnswerWarning,\n  AskDraftOrigin,\n  AskSourceReference,\n  ContextualAskCapability,\n  ContextualAskExecutorCapability,\n  SpotAskTaskEnvelope,\n  SpotChangeTaskEnvelope,\n  SpotSelectionContext,\n  SpotSelectionTarget,\n  SpotTaskEnvelope,\n} from \"./model/contextual-ask.js\";\nexport type {\n  AskJobActionRequest,\n  AskJobCreateRequest,\n  AskJobEvent,\n  AskJobEventsRequest,\n  AskJobResultResponse,\n  AskJobSnapshot,\n  ContextualAskCapabilityRequest,\n} from \"./protocol/contextual-ask.js\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAGA,IAAM,wBAAwB;AAAA,EAC5B,cAAc;AAAA,EACd,wBAAwB;AAAA,EACxB,qBAAqB;AAAA,EACrB,sBAAsB;AAAA,EACtB,0BAA0B;AAAA,EAC1B,aAAa;AAAA,EACb,sBAAsB;AAAA,EACtB,UAAU;AAAA,EACV,0BAA0B;AAAA,EAC1B,yBAAyB;AAAA,EACzB,oBAAoB;AAAA,EACpB,oBAAoB;AAAA,EACpB,qBAAqB;AAAA,EACrB,eAAe;AAAA,EACf,oBAAoB;AAAA,EACpB,2BAA2B;AAC7B;AAGO,IAAM,cAAc,OAAO,OAAO;AAAA,EACvC,iBAAiB;AAAA,EACjB,eAAe;AAAA,EACf,oBAAoB;AAAA,EACpB,GAAG;AAAA,EACH,gBAAgB;AAClB,CAGC;AAED,IAAM,oBAAuC,OAAO,OAAO,WAAW;AAE/D,SAAS,YAAY,OAAoC;AAC9D,SAAO,OAAO,UAAU,YAAY,kBAAkB,SAAS,KAAK;AACtE;","names":[]}