@primitive.ai/prim 0.1.0-alpha.8 → 0.1.0-alpha.81

package/dist/chunk-LEMX3IOG.js

@@ -0,0 +1,79 @@
+import {
+  terminalSafeLine
+} from "./chunk-Z7YPFWAZ.js";
+
+// src/lib/ansi.ts
+var ANSI_CODES = {
+  yellow: "\x1B[33m",
+  magenta: "\x1B[35m",
+  blue: "\x1B[34m",
+  cyan: "\x1B[36m",
+  green: "\x1B[32m",
+  red: "\x1B[31m",
+  // 256-color approximation of the orange trigger marker (xterm 208).
+  orange: "\x1B[38;5;208m",
+  gray: "\x1B[90m"
+};
+var ANSI_RESET = "\x1B[0m";
+var ANSI_DIM = "\x1B[2m";
+var ANSI_BOLD = "\x1B[1m";
+function supportsColor() {
+  if (process.env.NO_COLOR !== void 0 && process.env.NO_COLOR !== "") {
+    return false;
+  }
+  return process.stderr.isTTY === true;
+}
+function color(text, c) {
+  if (!supportsColor()) {
+    return text;
+  }
+  return `${ANSI_CODES[c]}${text}${ANSI_RESET}`;
+}
+function dim(text) {
+  if (!supportsColor()) {
+    return text;
+  }
+  return `${ANSI_DIM}${text}${ANSI_RESET}`;
+}
+function bold(text) {
+  if (!supportsColor()) {
+    return text;
+  }
+  return `${ANSI_BOLD}${text}${ANSI_RESET}`;
+}
+var AREA_COLORS = {
+  auth: "yellow",
+  data: "magenta",
+  mobile: "blue",
+  infra: "cyan",
+  ui: "green",
+  billing: "orange",
+  api: "blue",
+  docs: "gray",
+  testing: "gray"
+};
+function colorForArea(area) {
+  if (!area) {
+    return "gray";
+  }
+  return AREA_COLORS[area] ?? "gray";
+}
+var MAX_HEALTH_ERROR_LENGTH = 240;
+function boundedHealthError(value) {
+  if (!value) return void 0;
+  const clean = terminalSafeLine(value);
+  if (!clean) return void 0;
+  return clean.length <= MAX_HEALTH_ERROR_LENGTH ? clean : `${clean.slice(0, MAX_HEALTH_ERROR_LENGTH - 1)}\u2026`;
+}
+function stripAnsi(text) {
+  return text.replace(/\u001b\[[0-9;]*m/g, "");
+}
+
+export {
+  color,
+  dim,
+  bold,
+  colorForArea,
+  boundedHealthError,
+  stripAnsi
+};

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
+};

package/dist/chunk-OUXH3UEP.js

@@ -0,0 +1,247 @@
+import {
+  isCanonicalWorkspaceId
+} from "./chunk-EZXEWFDG.js";
+import {
+  scrubEnvironmentPaths
+} from "./chunk-FI3LIRCB.js";
+import {
+  isValidRepoSyncId
+} from "./chunk-TJTVHDJ5.js";
+
+// src/hooks/prim-hook-core.ts
+import { createHash, randomUUID } from "crypto";
+import { platform } from "os";
+
+// src/protocol/move.ts
+var LEGACY_ENVELOPE_VERSION = 1;
+var AGENT_ENVELOPE_VERSION = 3;
+var ENVELOPE_VERSION = LEGACY_ENVELOPE_VERSION;
+
+// src/hooks/prim-hook-core.ts
+var CORRELATED_TOOL_EVENTS = /* @__PURE__ */ new Set([
+  "PostToolUse",
+  "PostToolUseFailure",
+  "post_tool_call",
+  "post_approval_response"
+]);
+function postToolInvocationId(parsed, agent) {
+  if (typeof parsed.hook_event_name !== "string" || !CORRELATED_TOOL_EVENTS.has(parsed.hook_event_name)) {
+    return void 0;
+  }
+  const raw = agent === "hermes" ? parsed.extra?.tool_call_id : parsed.tool_use_id;
+  return typeof raw === "string" && raw.length > 0 ? raw : void 0;
+}
+function lowerString(value) {
+  return typeof value === "string" ? value.toLowerCase() : void 0;
+}
+function toolOutcomeFor(parsed, agent) {
+  const event = parsed.hook_event_name;
+  if (agent === "claude_code") {
+    if (event === "PostToolUseFailure") {
+      return parsed.is_interrupt === true ? "interrupted" : "failed";
+    }
+    return event === "PostToolUse" ? "succeeded" : void 0;
+  }
+  if (agent === "codex") {
+    return event === "PostToolUse" ? "returned" : void 0;
+  }
+  const extra = parsed.extra;
+  if (event === "post_approval_response") {
+    const choice = lowerString(extra?.choice);
+    return (choice === "deny" || choice === "smart_deny" || choice === "timeout") && postToolInvocationId(parsed, agent) ? "prevented" : void 0;
+  }
+  if (event !== "PostToolUse" && event !== "post_tool_call") {
+    return void 0;
+  }
+  const status = lowerString(extra?.status);
+  if (status === "ok" || status === "success") {
+    return "succeeded";
+  }
+  if (status === "error" || status === "timeout") {
+    return "failed";
+  }
+  if (status === "cancelled") {
+    return "interrupted";
+  }
+  if (status === "blocked") {
+    return "prevented";
+  }
+  return "unknown";
+}
+function toMove(parsed, cliVersion, agent = "claude_code", workspaceId, repository, invocationId) {
+  const sessionId = parsed.session_id ?? "";
+  const eventType = parsed.hook_event_name ?? "unknown";
+  const toolOutcome = toolOutcomeFor(parsed, agent);
+  let moveId;
+  if (CORRELATED_TOOL_EVENTS.has(eventType) && sessionId && invocationId) {
+    moveId = `posttool:v1:${createHash("sha256").update(JSON.stringify([agent, sessionId, eventType, invocationId])).digest("hex")}`;
+  } else if (CORRELATED_TOOL_EVENTS.has(eventType) && sessionId) {
+    moveId = `posttool:fallback:v1:${createHash("sha256").update(
+      JSON.stringify([
+        agent,
+        sessionId,
+        eventType,
+        parsed.turn_id ?? null,
+        parsed.tool_name ?? null,
+        parsed.tool_input ?? null
+      ])
+    ).digest("hex")}`;
+  } else {
+    moveId = randomUUID();
+  }
+  return {
+    moveId,
+    capturedAt: Date.now(),
+    sessionId,
+    eventType,
+    payload: parsed,
+    env: scrubEnvironmentPaths({
+      cwd: parsed.cwd ?? process.cwd(),
+      cliVersion,
+      osPlatform: platform(),
+      ...repository ? {
+        repoRoot: repository.repoRoot,
+        repoKey: repository.repoKey,
+        gitRoot: repository.repoRoot,
+        repoFullName: repository.repoFullName,
+        repoSyncId: repository.repoSyncId
+      } : {},
+      ...workspaceId ? { workspaceId } : {}
+    }),
+    envelopeVersion: AGENT_ENVELOPE_VERSION,
+    producer: agent,
+    ...invocationId ? { invocationId } : {},
+    ...toolOutcome ? { toolOutcome } : {}
+  };
+}
+var MAX_REWRITE_PAIRS_PER_MOVE = 40;
+var MAX_REWRITE_PAIRS_PER_HOOK = 2e3;
+var FULL_SHA_RE = /^(?:[0-9a-f]{40}|[0-9a-f]{64})$/u;
+var MAX_CLASSIFIER_ID_CHARS = 256;
+var INVALID_CLASSIFIER_ID_RE = /[\u0000-\u001f\u007f\uD800-\uDFFF]/u;
+function validSessionHint(value) {
+  return typeof value === "string" && value.trim().length > 0 && value === value.trim() && value.length <= MAX_CLASSIFIER_ID_CHARS && !INVALID_CLASSIFIER_ID_RE.test(value);
+}
+function commitAttributionFromEnvironment(env, workspaceId) {
+  if (env.HERMES_INTERACTIVE) return void 0;
+  if (!workspaceId || !isCanonicalWorkspaceId(workspaceId)) return void 0;
+  const candidates = [
+    validSessionHint(env.CLAUDE_CODE_SESSION_ID) ? { sessionId: env.CLAUDE_CODE_SESSION_ID, producer: "claude_code" } : void 0,
+    validSessionHint(env.CODEX_THREAD_ID) ? { sessionId: env.CODEX_THREAD_ID, producer: "codex" } : void 0
+  ].filter((candidate) => candidate !== void 0);
+  return candidates.length === 1 ? candidates[0] : void 0;
+}
+function toCommitMove(commit, cliVersion, cwd, context = {}) {
+  const { repository, repoFullName, repoSyncId, workspaceId, attribution, capturedAt } = context;
+  const validatedRepoSyncId = isValidRepoSyncId(repoSyncId) ? repoSyncId : void 0;
+  const validatedWorkspaceId = workspaceId && isCanonicalWorkspaceId(workspaceId) ? workspaceId : void 0;
+  const validatedAttribution = validatedWorkspaceId ? attribution : void 0;
+  const validatedCapturedAt = typeof capturedAt === "number" && Number.isSafeInteger(capturedAt) && capturedAt > 0 ? capturedAt : Date.now();
+  const fullSha = /^(?:[0-9a-f]{40}|[0-9a-f]{64})$/u.test(commit.sha);
+  const moveId = validatedRepoSyncId && validatedWorkspaceId && fullSha ? `commit:v2:${createHash("sha256").update(
+    JSON.stringify(["commit:v2", validatedRepoSyncId, validatedWorkspaceId, commit.sha])
+  ).digest("hex")}` : `commit:v2:unscoped:${randomUUID()}`;
+  const base = {
+    moveId,
+    capturedAt: validatedCapturedAt,
+    sessionId: validatedAttribution?.sessionId ?? "",
+    eventType: "git.commit",
+    payload: {
+      kind: "git.commit",
+      sha: commit.sha,
+      parentSha: commit.parentSha,
+      branch: commit.branch,
+      changedFiles: commit.files,
+      changedFilesComplete: commit.filesComplete
+    },
+    env: scrubEnvironmentPaths({
+      cwd,
+      cliVersion,
+      osPlatform: platform(),
+      ...repository ? {
+        repoRoot: repository.repoRoot,
+        repoKey: repository.repoKey,
+        gitRoot: repository.repoRoot
+      } : {},
+      ...repoFullName ? { repoFullName } : {},
+      ...validatedRepoSyncId ? { repoSyncId: validatedRepoSyncId } : {},
+      ...validatedWorkspaceId ? { workspaceId: validatedWorkspaceId } : {}
+    })
+  };
+  return validatedAttribution ? {
+    ...base,
+    envelopeVersion: AGENT_ENVELOPE_VERSION,
+    producer: validatedAttribution.producer
+  } : { ...base, envelopeVersion: ENVELOPE_VERSION };
+}
+function canonicalRewritePairs(pairs) {
+  const unique = /* @__PURE__ */ new Map();
+  for (const pair of pairs) {
+    const oldSha = pair.oldSha.toLowerCase();
+    const newSha = pair.newSha.toLowerCase();
+    if (!FULL_SHA_RE.test(oldSha) || !FULL_SHA_RE.test(newSha)) return null;
+    if (oldSha === newSha) continue;
+    unique.set(`${oldSha}\0${newSha}`, { oldSha, newSha });
+  }
+  return [...unique.values()].sort((left, right) => {
+    const leftKey = `${left.oldSha}\0${left.newSha}`;
+    const rightKey = `${right.oldSha}\0${right.newSha}`;
+    return leftKey < rightKey ? -1 : leftKey > rightKey ? 1 : 0;
+  }).slice(0, MAX_REWRITE_PAIRS_PER_HOOK);
+}
+function toRewriteMove(rewrite, cliVersion, cwd, context) {
+  const { repository, repoFullName, repoSyncId, workspaceId, capturedAt } = context;
+  if (rewrite.source !== "amend" && rewrite.source !== "rebase" || !isValidRepoSyncId(repoSyncId) || !workspaceId || !isCanonicalWorkspaceId(workspaceId)) {
+    return [];
+  }
+  const pairs = canonicalRewritePairs(rewrite.pairs);
+  if (!pairs || pairs.length === 0) return [];
+  const branch = rewrite.branch && rewrite.branch === rewrite.branch.trim() && ![...rewrite.branch].some((char) => char < " " || char === "\x7F") ? rewrite.branch : void 0;
+  const observedAt = typeof capturedAt === "number" && Number.isSafeInteger(capturedAt) && capturedAt > 0 ? capturedAt : Date.now();
+  const moves = [];
+  for (let offset = 0; offset < pairs.length; offset += MAX_REWRITE_PAIRS_PER_MOVE) {
+    const sortedPairs = pairs.slice(offset, offset + MAX_REWRITE_PAIRS_PER_MOVE);
+    const moveId = `rewrite:v1:${createHash("sha256").update(JSON.stringify(["rewrite:v1", repoSyncId, workspaceId, rewrite.source, sortedPairs])).digest("hex")}`;
+    moves.push({
+      moveId,
+      capturedAt: observedAt,
+      sessionId: "",
+      eventType: "git.rewrite",
+      payload: {
+        kind: "git.rewrite",
+        source: rewrite.source,
+        pairs: sortedPairs,
+        ...branch ? { branch } : {}
+      },
+      env: scrubEnvironmentPaths({
+        cwd,
+        cliVersion,
+        osPlatform: platform(),
+        ...repository ? {
+          repoRoot: repository.repoRoot,
+          repoKey: repository.repoKey,
+          gitRoot: repository.repoRoot
+        } : {},
+        ...repoFullName ? { repoFullName } : {},
+        repoSyncId,
+        workspaceId
+      }),
+      envelopeVersion: ENVELOPE_VERSION
+    });
+  }
+  return moves;
+}
+function shouldFlushAfter(eventType) {
+  return eventType === "SessionEnd";
+}
+
+export {
+  postToolInvocationId,
+  toolOutcomeFor,
+  toMove,
+  commitAttributionFromEnvironment,
+  toCommitMove,
+  canonicalRewritePairs,
+  toRewriteMove,
+  shouldFlushAfter
+};