copilotkit 4.9.60 → 4.10.0

package/index.js

@@ -96,14 +96,14 @@ function getTelemetryEndpointUrl() {
 }
 function getBuildInfo() {
   return {
-    version: true ? "4.9.60" : "dev",
-    buildNumber: true ? "34616405214" : "dev",
-    commitSha: true ? "5f0f9a7cf15492544f1341f562fa5cd55387099c" : "dev",
+    version: true ? "4.10.0" : "dev",
+    buildNumber: true ? "35011911410" : "dev",
+    commitSha: true ? "c8e38c8634104047e47545c1ed45a21c259a8658" : "dev",
     copilotKitCommit: getTemplateRef()
   };
 }
 function getTemplateRef() {
-  return true ? "d1584b840f904674b470be5d2b16c4ccca99c4f4" : "main";
+  return true ? "ce490419d046abe697438b070a99ad5d674365cc" : "main";
 }
 function getC15tBackendUrl() {
   return true ? "https://calm-hazelnut-joy-copilotkit.inth.app" : "";
@@ -1033,6 +1033,12 @@ function classifyError(err2, depth = 0) {
   if (err2.name === "AbortError") {
     return "timeout";
   }
+  const apiErrorCode = err2.code;
+  if (apiErrorCode === "LEARNING_NOT_ENABLED")
+    return "learning_not_enabled";
+  if (apiErrorCode === "LEARNING_CONTAINER_NOT_FOUND") {
+    return "learning_container_absent";
+  }
   const status = err2.status;
   if (err2.name === "ApiClientError" && typeof status === "number") {
     if (status === 401 || status === 403)
@@ -1070,7 +1076,7 @@ function classifyError(err2, depth = 0) {
       return "validation";
     if (code === "ONBOARDING_PROMPT_UNREADABLE")
       return "filesystem";
-    if (code === "CLI_PRODUCT_BINARY_TOO_LARGE" || code === "LEARNING_CANDIDATE_CONFLICT" || code === "LEARNING_CANDIDATE_SETTLED" || code === "LEARNING_CANDIDATE_ID_INVALID" || code === "LEARNING_CONTAINER_ID_INVALID" || code === "LEARNING_CONTAINER_INPUT_INVALID" || code === "LEARNING_CONTAINER_NOT_FOUND" || code === "LEARNING_CONTAINER_RESPONSE_INVALID" || code === "LEARNING_PROJECT_ID_INVALID" || code === "LEARNING_RESPONSE_INVALID" || code === "LEARNING_SKILLS_BUNDLE_INVALID" || code === "LEARNING_SKILLS_INTEGRITY_FAILED" || code === "LEARNING_SKILLS_OUTPUT_EXISTS") {
+    if (code === "CLI_PRODUCT_BINARY_TOO_LARGE" || code === "LEARNING_CANDIDATE_CONFLICT" || code === "LEARNING_CANDIDATE_SETTLED" || code === "LEARNING_CANDIDATE_ID_INVALID" || code === "LEARNING_CONTAINER_ID_INVALID" || code === "LEARNING_CONTAINER_INPUT_INVALID" || code === "LEARNING_CONTAINER_RESPONSE_INVALID" || code === "LEARNING_PROJECT_ID_INVALID" || code === "LEARNING_RESPONSE_INVALID" || code === "LEARNING_SKILLS_BUNDLE_INVALID" || code === "LEARNING_SKILLS_INTEGRITY_FAILED" || code === "LEARNING_SKILLS_OUTPUT_EXISTS") {
       return "validation";
     }
     if (code === "KEY_PROVISION_FAILED")
@@ -28858,6 +28864,29 @@ function recordServedPrompt(dependencies, runId, promptName) {
     route: [...previous, promptName]
   });
 }
+function markRunEnded(dependencies, runId) {
+  const key = stateKey("route", resolveAnchoredRoot(dependencies));
+  const stored = readStoredRoute(dependencies.store, key);
+  if (stored === void 0 || stored.runId !== runId)
+    return;
+  dependencies.store.set(key, { ...stored, ended: true });
+}
+function readAbandonedRun(dependencies, currentRunId) {
+  const stored = readStoredRoute(
+    dependencies.store,
+    stateKey("route", resolveAnchoredRoot(dependencies))
+  );
+  if (stored === void 0)
+    return void 0;
+  if (stored.runId === currentRunId)
+    return void 0;
+  if (stored.ended === true)
+    return void 0;
+  const lastPrompt = stored.route[stored.route.length - 1];
+  if (lastPrompt === void 0)
+    return void 0;
+  return { runId: stored.runId, lastPrompt, steps: stored.route.length };
+}
 function readOnboardingRoute(dependencies) {
   const root2 = resolveAnchoredRoot(dependencies);
   const stored = readStoredRoute(dependencies.store, stateKey("route", root2));
@@ -91701,7 +91730,7 @@ function formatTelemetryNotice(privacyPolicyUrl) {
   return [
     "The CopilotKit CLI collects usage data to help improve the product.",
     "While you are signed in, that data is linked to your CopilotKit account.",
-    "The onboarding feedback command may send up to 2,048 UTF-8 bytes of text.",
+    "The onboarding friction command sends up to 2,048 UTF-8 bytes of text.",
     "",
     "  Disable anytime:  copilotkit telemetry disable (or set DO_NOT_TRACK=1)",
     `  Privacy policy:   ${privacyPolicyUrl}`,
@@ -91748,6 +91777,15 @@ function createTelemetryService(deps) {
     return typeof deps.installationId === "function" ? deps.installationId() : deps.installationId;
   }
   async function sendOne(prepared) {
+    if (prepared.installationId === "") {
+      deps.logger.error({
+        msg: "telemetry.dropped.no_identity",
+        event: prepared.body.event,
+        outcome: prepared.outcome,
+        command: prepared.command
+      });
+      return { status: "no_identity" };
+    }
     const controller = new AbortController();
     const timer = setTimeout(() => controller.abort(), perRequestTimeoutMs);
     timer.unref?.();
@@ -91763,33 +91801,38 @@ function createTelemetryService(deps) {
         signal: controller.signal
       });
       if (!res.ok) {
+        const latencyMs = Date.now() - started;
         deps.logger.warn({
           msg: "telemetry.sink.failed",
+          event: prepared.body.event,
           status: res.status,
-          latency_ms: Date.now() - started,
+          latency_ms: latencyMs,
           outcome: prepared.outcome,
           command: prepared.command
         });
-        return false;
+        return { status: "http_error", httpStatus: res.status, latencyMs };
       }
       deps.logger.debug({
         msg: "telemetry.sink.succeeded",
+        event: prepared.body.event,
         status: res.status,
         latency_ms: Date.now() - started,
         outcome: prepared.outcome,
         command: prepared.command
       });
-      return true;
+      return { status: "sent" };
     } catch (err2) {
       const isAbort = err2 instanceof Error && err2.name === "AbortError";
+      const latencyMs = Date.now() - started;
       deps.logger.warn({
         msg: "telemetry.sink.failed",
-        latency_ms: Date.now() - started,
+        event: prepared.body.event,
+        latency_ms: latencyMs,
         outcome: prepared.outcome,
         command: prepared.command,
         error_code: isAbort ? "timeout" : "network"
       });
-      return false;
+      return isAbort ? { status: "timeout", timeoutMs: perRequestTimeoutMs, latencyMs } : { status: "network", latencyMs };
     } finally {
       clearTimeout(timer);
     }
@@ -91816,6 +91859,7 @@ function createTelemetryService(deps) {
     if (inFlight.size >= maxInFlight) {
       deps.logger.error({
         msg: "telemetry.dropped.queue_full",
+        event: event.event ?? CLI_TELEMETRY_EVENT_NAME,
         outcome: event.properties.outcome,
         command: event.properties.command
       });
@@ -91831,8 +91875,17 @@ function createTelemetryService(deps) {
     });
   }
   async function submitEvent(event) {
-    if (!deps.enabled || inFlight.size >= maxInFlight)
-      return false;
+    if (!deps.enabled)
+      return { status: "disabled" };
+    if (inFlight.size >= maxInFlight) {
+      deps.logger.error({
+        msg: "telemetry.dropped.queue_full",
+        event: event.event ?? CLI_TELEMETRY_EVENT_NAME,
+        outcome: event.properties.outcome,
+        command: event.properties.command
+      });
+      return { status: "queue_full", inFlight: inFlight.size };
+    }
     const promise3 = (async () => {
       await new Promise((resolve9) => setImmediate(resolve9));
       return await sendOne(prepareEvent(event));
@@ -92017,14 +92070,47 @@ async function submitTelemetryEvent(event) {
   if (!gate.send)
     return { status: "declined" };
   try {
-    const accepted = await getTelemetry().submitEvent(
+    const delivery = await getTelemetry().submitEvent(
       withProjectIdentity(event)
     );
-    return accepted ? { status: "sent" } : { status: "failed", detail: "the transport did not accept the event" };
+    return describeDelivery(delivery);
   } catch (error98) {
     return { status: "failed", detail: describeSubmissionError(error98) };
   }
 }
+function describeDelivery(delivery) {
+  switch (delivery.status) {
+    case "sent":
+      return { status: "sent" };
+    case "disabled":
+      return { status: "declined" };
+    case "no_identity":
+      return {
+        status: "failed",
+        detail: "this install has no telemetry id, so nothing was sent"
+      };
+    case "queue_full":
+      return {
+        status: "failed",
+        detail: `the send queue was full at ${delivery.inFlight} requests, so nothing was sent`
+      };
+    case "http_error":
+      return {
+        status: "failed",
+        detail: `the sink refused the event with HTTP ${delivery.httpStatus}`
+      };
+    case "timeout":
+      return {
+        status: "failed",
+        detail: `the send timed out after ${delivery.timeoutMs}ms`
+      };
+    case "network":
+      return {
+        status: "failed",
+        detail: "the network request failed before the sink answered"
+      };
+  }
+}
 function describeSubmissionError(error98) {
   if (error98 instanceof Error && error98.message !== "")
     return error98.message;
@@ -94899,13 +94985,25 @@ import * as fs18 from "node:fs";
 import * as path14 from "node:path";
 import * as os7 from "node:os";
 import { execFileSync as execFileSync3 } from "node:child_process";
+function isCredentialEnvFile(entry) {
+  if (!entry.startsWith(".env"))
+    return false;
+  if (ENV_TEMPLATE_SUFFIXES.some((suffix) => entry.endsWith(suffix)))
+    return false;
+  return entry === ".env" || entry.startsWith(".env.");
+}
+function entryHoldsProject(entry) {
+  if (isCredentialEnvFile(entry))
+    return true;
+  return PROJECT_DIRECTORY_NAMES.has(entry) || PROJECT_MANIFEST_NAMES.has(entry);
+}
 function isProjectDirOccupied(projectDir) {
-  return fs18.existsSync(projectDir) && fs18.readdirSync(projectDir).length > 0;
+  return fs18.existsSync(projectDir) && fs18.readdirSync(projectDir).some(entryHoldsProject);
 }
 function assertProjectDirAvailable(projectDir) {
   if (isProjectDirOccupied(projectDir)) {
     throw tagError(
-      new Error(`${projectDir} already exists and is not empty`),
+      new Error(`${projectDir} already holds a project`),
       TELEMETRY_ERROR_CODES.PREREQUISITE_MISSING
     );
   }
@@ -95155,12 +95253,36 @@ async function initializeProjectGit(projectDir) {
   }
   return { kind: "initialized" };
 }
-var TEST_HARNESS_ARTIFACTS, LICENSE_TOKEN_LINE_RE;
+var PROJECT_DIRECTORY_NAMES, PROJECT_MANIFEST_NAMES, ENV_TEMPLATE_SUFFIXES, TEST_HARNESS_ARTIFACTS, LICENSE_TOKEN_LINE_RE;
 var init_project_scaffold = __esm({
   "apps/cli/src/services/project-scaffold.ts"() {
     "use strict";
     init_repository_root();
     init_event_properties();
+    PROJECT_DIRECTORY_NAMES = /* @__PURE__ */ new Set([
+      "agent",
+      "api",
+      "app",
+      "components",
+      "lib",
+      "packages",
+      "pages",
+      "server",
+      "src",
+      "web"
+    ]);
+    PROJECT_MANIFEST_NAMES = /* @__PURE__ */ new Set([
+      "Cargo.toml",
+      "Gemfile",
+      "build.gradle",
+      "composer.json",
+      "go.mod",
+      "package.json",
+      "pom.xml",
+      "pyproject.toml",
+      "requirements.txt"
+    ]);
+    ENV_TEMPLATE_SUFFIXES = [".example", ".sample", ".template"];
     TEST_HARNESS_ARTIFACTS = [
       "docker",
       ".dockerignore",
@@ -100013,6 +100135,70 @@ var init_learning = __esm({
   }
 });
 
+// libs/app-api-contracts/src/learning-schedule.ts
+var localTimeSchema, timeZoneSchema, learningScheduleInputSchema, learningScheduleSchema, learningScheduleResponseSchema, projectLearningScheduleSchema, projectLearningScheduleResponseSchema;
+var init_learning_schedule = __esm({
+  "libs/app-api-contracts/src/learning-schedule.ts"() {
+    "use strict";
+    init_zod();
+    localTimeSchema = external_exports.string().regex(/^(?:[01]\d|2[0-3]):[0-5]\d$/, {
+      message: "Use a local time in HH:mm format."
+    }).length(5);
+    timeZoneSchema = external_exports.string().min(1).max(255).refine(
+      (timeZone) => {
+        if (/^[+-]/.test(timeZone) || timeZone.trim() !== timeZone)
+          return false;
+        try {
+          new Intl.DateTimeFormat("en-US", { timeZone }).format(0);
+          return true;
+        } catch {
+          return false;
+        }
+      },
+      { message: "Use a valid IANA time zone." }
+    );
+    learningScheduleInputSchema = external_exports.object({
+      localTime: localTimeSchema,
+      timeZone: timeZoneSchema
+    }).strict();
+    learningScheduleSchema = learningScheduleInputSchema.extend({
+      organizationId: external_exports.string(),
+      nextRunAt: external_exports.string().datetime(),
+      updatedAt: external_exports.string().datetime()
+    });
+    learningScheduleResponseSchema = external_exports.object({
+      schedule: learningScheduleSchema
+    }).strict();
+    projectLearningScheduleSchema = learningScheduleSchema.extend({
+      projectId: external_exports.number().int().positive(),
+      source: external_exports.enum(["organization", "project"]),
+      automationEnabled: external_exports.boolean().optional()
+    });
+    projectLearningScheduleResponseSchema = external_exports.object({ schedule: projectLearningScheduleSchema }).strict();
+  }
+});
+
+// libs/app-api-contracts/src/learning-automation.ts
+var learningAutomationReadinessSchema, learningAutomationReadinessResponseSchema;
+var init_learning_automation = __esm({
+  "libs/app-api-contracts/src/learning-automation.ts"() {
+    "use strict";
+    init_zod();
+    learningAutomationReadinessSchema = external_exports.object({
+      containerId: external_exports.string().min(1).max(64),
+      projectId: external_exports.number().int().positive(),
+      enabled: external_exports.boolean(),
+      eligibleThreadCount: external_exports.number().int().nonnegative(),
+      requiredThreadCount: external_exports.number().int().positive(),
+      blocked: external_exports.boolean(),
+      activeRun: external_exports.boolean()
+    });
+    learningAutomationReadinessResponseSchema = external_exports.object({
+      automation: learningAutomationReadinessSchema
+    }).strict();
+  }
+});
+
 // libs/app-api-contracts/src/threads.ts
 var threadIdSchema, appUserAliasSchema, collapseAppUserAliases, refuseInternalAppUserForms, threadAppUserSchema, threadReadQuerySchema;
 var init_threads = __esm({
@@ -100124,6 +100310,8 @@ var init_src6 = __esm({
     init_inspector_metadata();
     init_inspector_learning();
     init_learning();
+    init_learning_schedule();
+    init_learning_automation();
     init_threads();
     init_usage();
   }
@@ -383639,7 +383827,7 @@ function createHostedProjectApiClient(auth2) {
     productOrganizationId: auth2.clerkOrgId
   });
 }
-function buildInitNextSteps(templateDefinition, projectName, result, unsatisfiedKeys, installAlreadyRan = false, mockProvider = void 0) {
+function buildInitNextSteps(templateDefinition, projectName, result, unsatisfiedKeys, installAlreadyRan = false, mockProvider = void 0, mockAvailable = false) {
   const missingPrerequisites = templateDefinition.prerequisites.filter(
     (prerequisite) => result.missingPrerequisites.includes(prerequisite.command)
   );
@@ -383700,6 +383888,13 @@ function buildInitNextSteps(templateDefinition, projectName, result, unsatisfied
       code: `${requirement.key}=${requirement.example}`
     });
   }
+  if (unsatisfiedKeys.length > 0 && mockProvider === void 0 && mockAvailable) {
+    steps.push({ text: "  Or run without a key:" });
+    steps.push({
+      text: `    Start a local mock model${SEP2}`,
+      code: "copilotkit mock"
+    });
+  }
   for (const note of templateDefinition.setupNotes ?? []) {
     steps.push(note.code !== void 0 ? { ...note } : { text: note.text });
   }
@@ -384492,7 +384687,12 @@ function ScaffoldProgress({
         result,
         unsatisfied,
         installAlreadyRan,
-        activeMockProvider
+        activeMockProvider,
+        // Gated on the flag as well as on the framework. `copilotkit mock` is
+        // dark in released binaries (`cli.aimock-mock-mode`, prod: false), and a
+        // run told to reach for a command its own CLI does not implement spends
+        // real time discovering that -- which is itself a reported friction.
+        scaffoldedMockProvider !== void 0 && isCliFlagEnabled("cli.aimock-mock-mode")
       )
     );
     setScaffoldWarnings((prev) => mergeScaffoldWarnings(prev, result.warnings));
@@ -385464,7 +385664,16 @@ function reviewFrictionReport(input) {
       `--category must be one of: ${FRICTION_CATEGORIES.join(", ")}.`
     );
   }
-  if (input.costSeconds === void 0 || !COST_SECONDS_PATTERN.test(input.costSeconds) || Number(input.costSeconds) > MAX_COST_SECONDS_ESTIMATED) {
+  const phase = input.phase === void 0 ? DEFAULT_FRICTION_PHASE : FRICTION_PHASES.find((candidate) => candidate === input.phase);
+  if (phase === void 0) {
+    return refuse(
+      "FRICTION_PHASE_INVALID",
+      `--phase must be one of: ${FRICTION_PHASES.join(", ")}.`
+    );
+  }
+  const costOmitted = input.costSeconds === void 0;
+  const costMalformed = !costOmitted && (!COST_SECONDS_PATTERN.test(input.costSeconds) || Number(input.costSeconds) > MAX_COST_SECONDS_ESTIMATED);
+  if (costMalformed || costOmitted && phase !== "stop") {
     return refuse(
       "FRICTION_COST_INVALID",
       `--cost-seconds must be a whole number of seconds from 0 to ${MAX_COST_SECONDS_ESTIMATED}.`
@@ -385516,7 +385725,10 @@ function reviewFrictionReport(input) {
     ok: true,
     report: {
       category,
-      costSecondsEstimated: Number(input.costSeconds),
+      phase,
+      // Spread so a stop report that named no cost leaves the key off rather
+      // than reporting a zero it never estimated.
+      ...costOmitted ? {} : { costSecondsEstimated: Number(input.costSeconds) },
       // Spread so an absent path leaves the key off entirely, matching how the
       // telemetry properties treat every optional dimension.
       ...docsPath === void 0 ? {} : { docsPath },
@@ -385524,7 +385736,7 @@ function reviewFrictionReport(input) {
     }
   };
 }
-var FRICTION_CATEGORIES, MAX_FRICTION_TEXT_CHARS, MAX_FRICTION_TEXT_NEWLINES, MAX_COST_SECONDS_ESTIMATED, MAX_FRICTION_INPUT_BYTES, FRICTION_SIZE_LIMIT, MAX_FRICTION_DOCS_PATH_CHARS, DOCS_PATH_PATTERN, COST_SECONDS_PATTERN;
+var FRICTION_CATEGORIES, FRICTION_PHASES, DEFAULT_FRICTION_PHASE, MAX_FRICTION_TEXT_CHARS, MAX_FRICTION_TEXT_NEWLINES, MAX_COST_SECONDS_ESTIMATED, MAX_FRICTION_INPUT_BYTES, FRICTION_SIZE_LIMIT, MAX_FRICTION_DOCS_PATH_CHARS, DOCS_PATH_PATTERN, COST_SECONDS_PATTERN;
 var init_onboarding_friction = __esm({
   "apps/cli/src/services/onboarding-friction.ts"() {
     "use strict";
@@ -385541,6 +385753,8 @@ var init_onboarding_friction = __esm({
       "validation-loop",
       "other"
     ];
+    FRICTION_PHASES = ["repair", "stop", "completion"];
+    DEFAULT_FRICTION_PHASE = "completion";
     MAX_FRICTION_TEXT_CHARS = 2e3;
     MAX_FRICTION_TEXT_NEWLINES = 3;
     MAX_COST_SECONDS_ESTIMATED = 86400;
@@ -385555,76 +385769,6 @@ var init_onboarding_friction = __esm({
   }
 });
 
-// apps/cli/src/services/onboarding-feedback.ts
-function refuse2(code, message) {
-  return { ok: false, refusal: { code, message } };
-}
-async function readFeedbackInput(stdin) {
-  const read = await readBoundedReportText(stdin, MAX_FEEDBACK_INPUT_BYTES);
-  if (read.ok)
-    return { ok: true, text: read.text };
-  if (read.kind === "invalid-utf8") {
-    return refuse2(
-      "ONBOARDING_FEEDBACK_INVALID_UTF8",
-      "Nothing was sent: the report is not valid UTF-8. Send it again as plain UTF-8 text."
-    );
-  }
-  return refuse2(
-    "ONBOARDING_FEEDBACK_TOO_LARGE",
-    `Nothing was sent: the report is too large to read. Shorten it to at most ${MAX_FEEDBACK_TEXT_BYTES} UTF-8 bytes and send it again.`
-  );
-}
-function reviewFeedbackReport(text2) {
-  const violation = reviewReportText({
-    text: text2,
-    size: FEEDBACK_SIZE_LIMIT,
-    maxNewlines: MAX_FEEDBACK_TEXT_NEWLINES
-  });
-  if (violation === void 0)
-    return { ok: true, text: text2.trim() };
-  switch (violation.kind) {
-    case "empty":
-      return refuse2(
-        "ONBOARDING_FEEDBACK_EMPTY",
-        "Nothing was sent: the report was empty. Name the step that failed, in one or two sentences, on standard input."
-      );
-    case "possible-secret":
-      return refuse2(
-        "ONBOARDING_FEEDBACK_POSSIBLE_SECRET",
-        `Nothing was sent: the report looks like it contains ${violation.shape}. Describe the problem in words and send it again without the value.`
-      );
-    case "code-block":
-      return refuse2(
-        "ONBOARDING_FEEDBACK_CODE_BLOCK",
-        "Nothing was sent: the report contains a fenced code block. Describe the problem in words, without source code, logs, or command output."
-      );
-    case "too-many-lines":
-      return refuse2(
-        "ONBOARDING_FEEDBACK_TOO_MANY_LINES",
-        `Nothing was sent: the report has more than ${MAX_FEEDBACK_TEXT_NEWLINES + 1} lines, so it reads as pasted output. Send at most ${MAX_FEEDBACK_TEXT_NEWLINES + 1} lines of plain prose.`
-      );
-    case "too-long":
-      return refuse2(
-        "ONBOARDING_FEEDBACK_TOO_LARGE",
-        `Nothing was sent: the report is ${violation.measured} UTF-8 bytes. Shorten it to at most ${MAX_FEEDBACK_TEXT_BYTES} and send it again.`
-      );
-  }
-}
-var MAX_FEEDBACK_TEXT_BYTES, MAX_FEEDBACK_TEXT_NEWLINES, MAX_FEEDBACK_INPUT_BYTES, FEEDBACK_SIZE_LIMIT;
-var init_onboarding_feedback = __esm({
-  "apps/cli/src/services/onboarding-feedback.ts"() {
-    "use strict";
-    init_onboarding_report_text();
-    MAX_FEEDBACK_TEXT_BYTES = 2048;
-    MAX_FEEDBACK_TEXT_NEWLINES = 3;
-    MAX_FEEDBACK_INPUT_BYTES = 2050;
-    FEEDBACK_SIZE_LIMIT = {
-      unit: "utf8-bytes",
-      max: MAX_FEEDBACK_TEXT_BYTES
-    };
-  }
-});
-
 // apps/cli/src/services/onboarding-checkpoint.ts
 function reviewCheckpoint(input) {
   const phase = CHECKPOINT_PHASES.find((known) => known === input.phase);
@@ -385858,6 +386002,9 @@ function probeGraphOwned(root2, cwd2) {
   }
   return found;
 }
+function toRequestedPath(root2, path45) {
+  return isAbsolute(path45) ? path45 : resolve7(root2, path45);
+}
 function toRepositoryRelative(root2, absolute) {
   const relativePath = relative3(root2, absolute);
   if (relativePath === "" || relativePath.startsWith(".."))
@@ -385888,7 +386035,7 @@ function captureProtectedPaths(dependencies, input) {
   const existing = ownBaseline?.entries ?? [];
   const requested = [];
   for (const path45 of input.paths) {
-    const absolute = isAbsolute(path45) ? path45 : resolve7(dependencies.cwd, path45);
+    const absolute = toRequestedPath(root2, path45);
     const relativePath = toRepositoryRelative(root2, absolute);
     if (relativePath === void 0) {
       return {
@@ -386025,7 +386172,7 @@ function rebaselineProtectedPaths(dependencies, input) {
   }
   const targets = [];
   for (const path45 of input.paths) {
-    const absolute = isAbsolute(path45) ? path45 : resolve7(dependencies.cwd, path45);
+    const absolute = toRequestedPath(root2, path45);
     const relativePath = toRepositoryRelative(root2, absolute);
     if (relativePath === void 0) {
       return { status: "blocked", reason: "unknown-path", detail: path45 };
@@ -386115,7 +386262,7 @@ function acceptProtectedPathDrift(dependencies, input) {
   const drift = /* @__PURE__ */ new Map();
   const accepted = [];
   for (const path45 of input.paths) {
-    const absolute = isAbsolute(path45) ? path45 : resolve7(dependencies.cwd, path45);
+    const absolute = toRequestedPath(root2, path45);
     const relativePath = toRepositoryRelative(root2, absolute);
     if (relativePath === void 0) {
       return { status: "blocked", reason: "unknown-path", detail: path45 };
@@ -386218,7 +386365,7 @@ function acceptCredentialPlacement(dependencies, input) {
   const placed = /* @__PURE__ */ new Map();
   const accepted = [];
   for (const path45 of input.paths) {
-    const absolute = isAbsolute(path45) ? path45 : resolve7(dependencies.cwd, path45);
+    const absolute = toRequestedPath(root2, path45);
     const relativePath = toRepositoryRelative(root2, absolute);
     if (relativePath === void 0) {
       return { status: "blocked", reason: "unknown-path", detail: path45 };
@@ -386367,7 +386514,7 @@ function authorizeProtectedPathChange(dependencies, input) {
   const priorDrift = /* @__PURE__ */ new Map();
   const authorized = [];
   for (const path45 of input.paths) {
-    const absolute = isAbsolute(path45) ? path45 : resolve7(dependencies.cwd, path45);
+    const absolute = toRequestedPath(root2, path45);
     const relativePath = toRepositoryRelative(root2, absolute);
     if (relativePath === void 0) {
       return { status: "blocked", reason: "unknown-path", detail: path45 };
@@ -386488,6 +386635,11 @@ var init_onboarding_protected_paths = __esm({
 });
 
 // apps/cli/src/services/onboarding-classification.ts
+function resolveAgentFrameworkAlias(value) {
+  if (value === void 0)
+    return void 0;
+  return ONBOARDING_AGENT_FRAMEWORK_ALIASES[value] ?? value;
+}
 function unprovenBaselineRefusal(startingState, route, proof) {
   if (startingState !== "both-oss" && startingState !== "both-copilotkit-unproved") {
     return void 0;
@@ -386534,7 +386686,7 @@ function requireOnboardingChoice(flag, value, choices) {
   }
   return selected;
 }
-var ONBOARDING_STARTING_STATES, ONBOARDING_AGENT_FRAMEWORKS, ONBOARDING_FRONTENDS, ONBOARDING_PROOF_STEPS, ONBOARDING_PROOF_OUTCOMES, ABSENCE_STATES, OSS_BASELINE_NODE, TERMINAL_NODES, REPOSITORY_RESEARCH_NODE;
+var ONBOARDING_STARTING_STATES, ONBOARDING_AGENT_FRAMEWORKS, ONBOARDING_AGENT_FRAMEWORK_ALIASES, ONBOARDING_FRONTENDS, ONBOARDING_PROOF_STEPS, ONBOARDING_PROOF_OUTCOMES, ABSENCE_STATES, OSS_BASELINE_NODE, TERMINAL_NODES, REPOSITORY_RESEARCH_NODE;
 var init_onboarding_classification = __esm({
   "apps/cli/src/services/onboarding-classification.ts"() {
     "use strict";
@@ -386567,6 +386719,9 @@ var init_onboarding_classification = __esm({
       "strands-python",
       "strands-typescript"
     ];
+    ONBOARDING_AGENT_FRAMEWORK_ALIASES = {
+      langgraph: "langgraph-python"
+    };
     ONBOARDING_FRONTENDS = [
       "react-spa",
       "nextjs",
@@ -386595,6 +386750,12 @@ var init_onboarding_classification = __esm({
       // feature run must not enter, because a stop reported from inside a route the
       // run never took is a stop that never happened.
       "feature/stop": "feature-blocked",
+      // A run that broke gets its own ending. 52 outside runs ended at
+      // `unsupported/no-validated-path` in the three weeks to 2026-09-13, and 10 of
+      // them had classified as `built-in` with `nextjs` -- a stack this graph serves.
+      // While one terminal absorbs both, "we do not support this" and "this run
+      // broke" are the same row, and neither can be counted.
+      "stopped/run-failed": "run-failed",
       "unsupported/no-validated-path": "unsupported"
     };
     REPOSITORY_RESEARCH_NODE = "subagent/inspect-repository";
@@ -386787,6 +386948,7 @@ async function runOnboard(argv, dependencies) {
         parsed.values["coding-agent"]
       );
     }
+    recordAbandonedRunWhenFound(deps, binding.runId);
     printRunId(deps, binding.runId);
     await printGraphTree(deps);
     writePrompt(deps, binding.runId, startPrompt);
@@ -386848,6 +387010,7 @@ async function runOnboard(argv, dependencies) {
       throw new Error(SURFACE_CHECK_USAGE);
     const accepted = readAcceptedDriftBestEffort(deps, runId);
     const authorized = readAuthorizationsBestEffort(deps, runId);
+    markRunEndedBestEffort(deps, runId);
     recordBestEffort(deps, {
       event: "cli.onboarding.completed",
       properties: {
@@ -386905,7 +387068,7 @@ async function runOnboard(argv, dependencies) {
       { requested_agent_framework: reportableSlug(requestedFramework) },
       () => requireOnboardingChoice(
         "--agent-framework",
-        requestedFramework,
+        resolveAgentFrameworkAlias(requestedFramework),
         ONBOARDING_AGENT_FRAMEWORKS
       )
     );
@@ -386953,13 +387116,6 @@ async function runOnboard(argv, dependencies) {
     deps.stdout.write("Onboarding path included in telemetry when enabled.\n");
     return;
   }
-  if (subcommand === "feedback") {
-    if (argv.length !== 1) {
-      throw new Error("Usage: copilotkit onboard feedback");
-    }
-    await reportFeedback(deps, runId);
-    return;
-  }
   if (subcommand === "friction") {
     await reportFriction(deps, runId, argv.slice(1));
     return;
@@ -387627,6 +387783,7 @@ function recordTerminalWhenReached(dependencies, runId, promptName) {
   const terminal = TERMINAL_NODES[promptName];
   if (terminal === void 0)
     return;
+  markRunEndedBestEffort(dependencies, runId);
   recordBestEffort(dependencies, {
     event: "cli.onboarding.terminal_reached",
     properties: {
@@ -387638,6 +387795,40 @@ function recordTerminalWhenReached(dependencies, runId, promptName) {
     }
   });
 }
+function recordAbandonedRunWhenFound(dependencies, currentRunId) {
+  let abandoned;
+  try {
+    abandoned = readAbandonedRun(
+      { cwd: dependencies.cwd, store: dependencies.store },
+      currentRunId
+    );
+  } catch {
+    return;
+  }
+  if (abandoned === void 0)
+    return;
+  recordBestEffort(dependencies, {
+    event: "cli.onboarding.run_abandoned",
+    properties: {
+      command: "onboard",
+      ...onboardingIntentProperties(dependencies),
+      // The run that is reporting, the way every other event binds. The run
+      // being reported cannot emit anything: it is over, and reporting it is
+      // the whole point. It rides as its own property instead.
+      onboarding_run_id: currentRunId,
+      cli_version: dependencies.cliVersion,
+      abandoned_run_id: abandoned.runId,
+      abandoned_at_prompt: abandoned.lastPrompt,
+      abandoned_after_steps: abandoned.steps
+    }
+  });
+}
+function markRunEndedBestEffort(dependencies, runId) {
+  try {
+    markRunEnded({ cwd: dependencies.cwd, store: dependencies.store }, runId);
+  } catch {
+  }
+}
 function joinChanges(changes) {
   return [...new Set(changes)].sort().join(",");
 }
@@ -387765,53 +387956,16 @@ function completionReport(input) {
   }
   return input.blocker === void 0 ? "CopilotKit onboarding marked complete.\n" : blockedAfterProof(input.blocker);
 }
-async function reportFeedback(dependencies, runId) {
-  const input = await readFeedbackInput(dependencies.stdin);
-  if (!input.ok)
-    return printFeedbackRefusal(dependencies, runId, input.refusal);
-  const reviewed = reviewFeedbackReport(input.text);
-  if (!reviewed.ok)
-    return printFeedbackRefusal(dependencies, runId, reviewed.refusal);
-  const feedbackText = reviewed.text;
-  let submission;
-  try {
-    submission = await dependencies.submitFeedbackEvent({
-      event: "cli.onboarding.feedback_submitted",
-      properties: {
-        command: "onboard",
-        ...onboardingIntentProperties(dependencies),
-        onboarding_run_id: runId,
-        cli_version: dependencies.cliVersion,
-        feedback_text: feedbackText
-      }
-    });
-  } catch (error98) {
-    submission = { status: "failed", detail: describeSubmissionError(error98) };
-  }
-  dependencies.stdout.write(
-    `${describeSubmission("Feedback", submission)}
-report: ${feedbackText}
-`
-  );
-}
 function describeSubmission(subject, submission) {
   switch (submission.status) {
     case "sent":
-      return subject === "Feedback" ? "Feedback sent." : "Friction reported.";
+      return "Friction reported.";
     case "declined":
       return `${subject} was not sent because telemetry is off.`;
     default:
       return `${subject} was not sent because the telemetry send failed: ${submission.detail}`;
   }
 }
-function printFeedbackRefusal(dependencies, runId, refusal) {
-  recordReportRefused(dependencies, runId, "feedback", refusal.code);
-  dependencies.stdout.write(
-    `Feedback refused, and nothing was sent.
-${refusal.code}: ${refusal.message}
-`
-  );
-}
 async function reportFriction(dependencies, runId, args) {
   const parsed = parseFrictionArguments(args);
   if (!parsed.ok)
@@ -387823,6 +387977,7 @@ async function reportFriction(dependencies, runId, args) {
     category: parsed.category,
     costSeconds: parsed.costSeconds,
     docsPath: parsed.docsPath,
+    phase: parsed.phase,
     text: input.text
   });
   if (!reviewed.ok)
@@ -387838,7 +387993,10 @@ async function reportFriction(dependencies, runId, args) {
         onboarding_run_id: runId,
         cli_version: dependencies.cliVersion,
         friction_category: report.category,
-        cost_seconds_estimated: report.costSecondsEstimated,
+        friction_phase: report.phase,
+        // Spread so a stop report that named no cost leaves the key off rather
+        // than sending an undefined the sink stores as a value.
+        ...report.costSecondsEstimated === void 0 ? {} : { cost_seconds_estimated: report.costSecondsEstimated },
         // Spread so a report about no particular page leaves the key off
         // rather than joining to an empty one.
         ...report.docsPath === void 0 ? {} : { friction_docs_path: report.docsPath },
@@ -387858,7 +388016,8 @@ function parseFrictionArguments(args) {
       options: {
         category: { type: "string" },
         "cost-seconds": { type: "string" },
-        "docs-path": { type: "string" }
+        "docs-path": { type: "string" },
+        phase: { type: "string" }
       },
       strict: true
     });
@@ -387866,14 +388025,15 @@ function parseFrictionArguments(args) {
       ok: true,
       category: parsed.values.category,
       costSeconds: parsed.values["cost-seconds"],
-      docsPath: parsed.values["docs-path"]
+      docsPath: parsed.values["docs-path"],
+      phase: parsed.values.phase
     };
   } catch {
     return {
       ok: false,
       refusal: {
         code: "FRICTION_ARGUMENTS_INVALID",
-        message: `Usage: copilotkit onboard friction --category <${FRICTION_CATEGORIES.join("|")}> --cost-seconds <seconds> [--docs-path <page path or URL>]`
+        message: `Usage: copilotkit onboard friction --category <${FRICTION_CATEGORIES.join("|")}> --cost-seconds <seconds> [--phase <${FRICTION_PHASES.join("|")}>] [--docs-path <page path or URL>]`
       }
     };
   }
@@ -387890,8 +388050,9 @@ function printFrictionReport(dependencies, report, submission) {
   dependencies.stdout.write(
     `${describeSubmission("Friction", submission)}
 category: ${report.category}
-cost_seconds_estimated: ${report.costSecondsEstimated}
-` + (report.docsPath === void 0 ? "" : `docs_path: ${report.docsPath}
+phase: ${report.phase}
+` + (report.costSecondsEstimated === void 0 ? "" : `cost_seconds_estimated: ${report.costSecondsEstimated}
+`) + (report.docsPath === void 0 ? "" : `docs_path: ${report.docsPath}
 `) + `report: ${report.text}
 `
   );
@@ -388118,7 +388279,6 @@ var init_onboard = __esm({
     init_config_service();
     init_onboarding_graph();
     init_onboarding_friction();
-    init_onboarding_feedback();
     init_onboarding_checkpoint();
     init_onboarding_state();
     init_onboarding_protected_paths();
@@ -388140,7 +388300,6 @@ var init_onboard = __esm({
       "checkpoint",
       "proof",
       "complete",
-      "feedback",
       "friction"
     ];
     READ_RUN_NOT_BOUND = runNotBound(
@@ -391409,8 +391568,8 @@ General:
   --verbose              Mirror CLI diagnostics to stderr
 
 Privacy:
-  CopilotKit collects CLI usage data to improve the product. Onboarding feedback
-  may send up to 2,048 UTF-8 bytes through this telemetry path. To opt out, set
+  CopilotKit collects CLI usage data to improve the product. An onboarding
+  friction report sends up to 2,048 UTF-8 bytes through this telemetry path. To opt out, set
   DO_NOT_TRACK=1 or COPILOTKIT_TELEMETRY_DISABLED=1 in your environment.
 `,
   login: `Usage: copilotkit login [--json]
@@ -391436,8 +391595,8 @@ Options:
        copilotkit onboard proof --step <oss-baseline|round-trip> --outcome <passed|failed|skipped>
                                 [--predicate <1-6>]
        copilotkit onboard complete
-       copilotkit onboard feedback
-       copilotkit onboard friction --category <slug> --cost-seconds <seconds>
+       copilotkit onboard friction --category <slug> [--cost-seconds <seconds>]
+                                [--phase <repair|stop|completion>]
 
 Guide a coding agent through the Markdown graph bundled with this exact CLI.
 
@@ -391452,12 +391611,12 @@ Subcommands:
   checkpoint             Report how far a long step has got
   proof                  Record what one proof gate returned
   complete               Mark a proven onboarding run complete
-  feedback               Read one non-empty message from standard input
   friction               Report one papercut that slowed a run down
 
-Feedback must be no larger than 2,048 UTF-8 bytes. Do not include secrets,
-source code, logs, or command output. The global telemetry setting applies.
-When telemetry is off, or the send fails, feedback exits zero and says which.
+A friction report must be no larger than 2,048 UTF-8 bytes. Do not include
+secrets, source code, logs, or command output. The global telemetry setting
+applies. When telemetry is off, or the send fails, the command exits zero and
+says which.
 
 Protect captures the paths this run must not change -- the developer's work in
 progress -- as path and digest, derived from the working tree rather than taken
@@ -391536,6 +391695,10 @@ report from standard input, at most 2,000 characters and four lines of prose.
 --category takes one of: docs-missing, docs-wrong, docs-sequential, cli-gap,
 sdk-gap, environment, port-collision, credential, validation-loop, other.
 --cost-seconds takes the reporting agent's own estimate of the seconds lost.
+--phase takes one of: repair, stop, completion, and defaults to completion. A
+repair report is filed once a repair cycle has resolved. A stop report is the
+one that can leave --cost-seconds off, because a run that stopped cannot
+separate one papercut's cost from the cost of the whole run.
 
 A report containing a secret shape, a fenced code block, or pasted output is
 refused before anything is sent, and the reason is printed. Both commands print
@@ -393796,7 +393959,6 @@ var ONBOARD_SUBCOMMANDS2 = [
   "checkpoint",
   "classify",
   "complete",
-  "feedback",
   "friction",
   "identify",
   "proof",