@primitive.ai/prim 0.1.0-alpha.9 → 0.1.0-alpha.90

package/dist/chunk-LMRYZL3D.js

@@ -0,0 +1,209 @@
+import {
+  getClient,
+  isTerminalSafeText,
+  terminalSafeLine,
+  terminalSafeText
+} from "./chunk-Z7YPFWAZ.js";
+
+// src/decisions/feedback.ts
+var FEEDBACK_PROTOCOL_VERSION = 2;
+var FEEDBACK_MIN_PROTOCOL_VERSION = 1;
+var FEEDBACK_DEADLINE_MS = 3e3;
+var MAX_FEEDBACK_EVENTS = 40;
+var MAX_FEEDBACK_MESSAGE_CODE_POINTS = 8e3;
+var MAX_FEEDBACK_INTENT_CODE_POINTS = 180;
+var LEASE_PATH = "/api/cli/decisions/feedback/lease";
+var ACK_PATH = "/api/cli/decisions/feedback/ack";
+var STATUS_PATH = "/api/cli/decisions/feedback/status";
+var SHORT_ID = /^[0-9a-f]{8}$/u;
+var MAX_EVENT_ID_CHARS = 128;
+var MAX_RAW_INTENT_CODE_UNITS = 512;
+var MAX_FEEDBACK_WEB_URL_CHARS = 2048;
+var SAFE_PUBLISH_DECISION_ID = /^[A-Za-z0-9_-]+$/u;
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isSupportedProtocolVersion(value) {
+  return Number.isSafeInteger(value) && Number(value) >= FEEDBACK_MIN_PROTOCOL_VERSION && Number(value) <= FEEDBACK_PROTOCOL_VERSION;
+}
+function normalizeFeedbackIntent(value) {
+  const withoutControls = terminalSafeLine(value);
+  const points = Array.from(withoutControls);
+  if (points.length <= MAX_FEEDBACK_INTENT_CODE_POINTS) {
+    return withoutControls;
+  }
+  return `${points.slice(0, MAX_FEEDBACK_INTENT_CODE_POINTS - 1).join("")}\u2026`;
+}
+function parseFeedbackWebUrl(value) {
+  if (typeof value !== "string" || value.length === 0 || value.length > MAX_FEEDBACK_WEB_URL_CHARS || !/^https:\/\//iu.test(value) || /\s/u.test(value) || !isTerminalSafeText(value)) {
+    return void 0;
+  }
+  try {
+    const url = new URL(value);
+    if (url.protocol !== "https:" || !url.hostname || url.username.length > 0 || url.password.length > 0) {
+      return void 0;
+    }
+  } catch {
+    return void 0;
+  }
+  return value;
+}
+function parseFeedbackDecisionId(value) {
+  if (typeof value !== "string" || value.length === 0 || value.length > MAX_EVENT_ID_CHARS || terminalSafeText(value) !== value || !SAFE_PUBLISH_DECISION_ID.test(value)) {
+    return void 0;
+  }
+  return value;
+}
+function parseEvent(value, protocolVersion) {
+  if (!isRecord(value)) return void 0;
+  if (typeof value.eventId !== "string" || value.eventId.length === 0 || value.eventId.length > MAX_EVENT_ID_CHARS || terminalSafeText(value.eventId) !== value.eventId) {
+    return void 0;
+  }
+  if (!Number.isSafeInteger(value.leaseVersion) || Number(value.leaseVersion) < 1) {
+    return void 0;
+  }
+  if (typeof value.shortId !== "string" || !SHORT_ID.test(value.shortId)) {
+    return void 0;
+  }
+  if (typeof value.intent !== "string" || value.intent.length > MAX_RAW_INTENT_CODE_UNITS) {
+    return void 0;
+  }
+  const intent = normalizeFeedbackIntent(value.intent);
+  if (!intent) return void 0;
+  const webUrl = value.webUrl === void 0 ? void 0 : parseFeedbackWebUrl(value.webUrl);
+  if (value.webUrl !== void 0 && webUrl === void 0) return void 0;
+  const kind = value.kind === void 0 && protocolVersion === 1 ? "confirm_prompt" : value.kind;
+  if (kind !== "confirm_prompt" && kind !== "publish_prompt") return void 0;
+  if (protocolVersion === 1 && kind === "publish_prompt") return void 0;
+  const decisionId = value.decisionId === void 0 ? void 0 : parseFeedbackDecisionId(value.decisionId);
+  if (value.decisionId !== void 0 && decisionId === void 0) return void 0;
+  if (decisionId !== void 0 && (protocolVersion !== 2 || kind !== "publish_prompt")) {
+    return void 0;
+  }
+  if (protocolVersion === 2 && kind === "publish_prompt" && decisionId === void 0) {
+    return void 0;
+  }
+  return {
+    eventId: value.eventId,
+    leaseVersion: Number(value.leaseVersion),
+    shortId: value.shortId,
+    intent,
+    ...webUrl === void 0 ? {} : { webUrl },
+    ...decisionId === void 0 ? {} : { decisionId },
+    kind
+  };
+}
+function parseFeedbackLease(value) {
+  if (!isRecord(value) || !isSupportedProtocolVersion(value.protocolVersion)) return void 0;
+  const protocolVersion = value.protocolVersion;
+  if (value.status === "empty") {
+    return value.hasMore === false ? { protocolVersion, events: [], hasMore: false } : void 0;
+  }
+  if (value.status === "unavailable") {
+    return value.reason === "organization_unbound" ? { protocolVersion, events: [], hasMore: false } : void 0;
+  }
+  if (value.status !== "leased" || typeof value.hasMore !== "boolean") return void 0;
+  if (!Array.isArray(value.events) || value.events.length === 0 || value.events.length > MAX_FEEDBACK_EVENTS) {
+    return void 0;
+  }
+  const events = value.events.map((event) => parseEvent(event, protocolVersion));
+  if (events.some((event) => event === void 0)) return void 0;
+  const parsedEvents = events;
+  if (new Set(parsedEvents.map((event) => event.eventId)).size !== parsedEvents.length) {
+    return void 0;
+  }
+  return { protocolVersion, events: parsedEvents, hasMore: value.hasMore };
+}
+function renderFeedback(lease) {
+  const lines = [];
+  const deliveries = [];
+  let pointCount = 0;
+  for (const event of lease.events) {
+    const decisionId = event.kind === "publish_prompt" ? parseFeedbackDecisionId(event.decisionId) : void 0;
+    if (event.kind === "publish_prompt" && decisionId === void 0) continue;
+    const identifier = `dec_${event.shortId}`;
+    const detail = `${event.intent}${event.webUrl ? ` (${event.webUrl})` : ""}`;
+    const line = event.kind === "publish_prompt" ? `[prim] publish this Decision draft (${identifier})? ${detail} Run \`prim decisions publish ${decisionId}\` to share it with your team.` : `[prim] response \u2192 created Decision (${identifier}): ${detail}`;
+    const extra = Array.from(line).length + (lines.length === 0 ? 0 : 1);
+    if (pointCount + extra > MAX_FEEDBACK_MESSAGE_CODE_POINTS) break;
+    lines.push(line);
+    deliveries.push({ eventId: event.eventId, leaseVersion: event.leaseVersion });
+    pointCount += extra;
+  }
+  if (lines.length === 0) return void 0;
+  return { protocolVersion: lease.protocolVersion, systemMessage: lines.join("\n"), deliveries };
+}
+async function leaseDecisionFeedback(input, dependencies = {}) {
+  try {
+    const response = await (dependencies.client ?? getClient()).post(
+      LEASE_PATH,
+      {
+        protocolVersion: FEEDBACK_PROTOCOL_VERSION,
+        workspaceId: input.workspaceId,
+        currentSessionId: input.currentSessionId
+      },
+      { signal: input.signal, quietRefresh: true }
+    );
+    const parsed = parseFeedbackLease(response);
+    if (!parsed) {
+      dependencies.onError?.(
+        new Error("server returned an unsupported decision-feedback contract")
+      );
+    }
+    return parsed;
+  } catch (error) {
+    dependencies.onError?.(error);
+    return void 0;
+  }
+}
+async function acknowledgeDecisionFeedback(input, dependencies = {}) {
+  if (!isSupportedProtocolVersion(input.protocolVersion) || input.deliveries.length === 0 || input.deliveries.length > MAX_FEEDBACK_EVENTS) {
+    return false;
+  }
+  try {
+    const response = await (dependencies.client ?? getClient()).post(
+      ACK_PATH,
+      {
+        protocolVersion: input.protocolVersion,
+        workspaceId: input.workspaceId,
+        deliveries: input.deliveries
+      },
+      { signal: input.signal, quietRefresh: true }
+    );
+    const acknowledgedEventIds = isRecord(response) ? response.acknowledgedEventIds : void 0;
+    const expectedEventIds = new Set(input.deliveries.map((delivery) => delivery.eventId));
+    const valid = isRecord(response) && response.protocolVersion === input.protocolVersion && response.status === "acked" && Array.isArray(acknowledgedEventIds) && acknowledgedEventIds.length <= input.deliveries.length && acknowledgedEventIds.every(
+      (id) => typeof id === "string" && id.length > 0 && id.length <= MAX_EVENT_ID_CHARS && expectedEventIds.has(id)
+    ) && new Set(acknowledgedEventIds).size === acknowledgedEventIds.length;
+    if (!valid) {
+      dependencies.onError?.(
+        new Error("server returned an unsupported decision-feedback acknowledgement")
+      );
+    }
+    return valid;
+  } catch (error) {
+    dependencies.onError?.(error);
+    return false;
+  }
+}
+function parseFeedbackCapability(value) {
+  if (!isRecord(value) || !isSupportedProtocolVersion(value.protocolVersion)) return void 0;
+  if (value.status === "available") return { status: "available" };
+  if (value.status === "unavailable" && value.reason === "organization_unbound") {
+    return { status: "unavailable", reason: "organization_unbound" };
+  }
+  return void 0;
+}
+async function fetchFeedbackCapability(signal, client = getClient()) {
+  const result = parseFeedbackCapability(await client.get(STATUS_PATH, { signal }));
+  if (!result) throw new Error("server returned an unsupported decision-feedback contract");
+  return result;
+}
+
+export {
+  FEEDBACK_DEADLINE_MS,
+  renderFeedback,
+  leaseDecisionFeedback,
+  acknowledgeDecisionFeedback,
+  fetchFeedbackCapability
+};