akm-cli 0.9.0-beta.47 → 0.9.0-beta.49

package/dist/integrations/agent/index.js

@@ -1,26 +1,10 @@
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this
 // file, You can obtain one at https://mozilla.org/MPL/2.0/.
-/**
- * Internal entry point for the `agent` integration. CLI-only project — no
- * public exports map. Other akm modules import from this barrel for the
- * sake of grouping imports.
- *
- * Surface:
- *   • Types: AgentProfile, AgentConfig, AgentRunResult, AgentFailureReason.
- *   • Profiles: getBuiltinAgentProfile, listBuiltinAgentProfiles, BUILTIN_AGENT_PROFILE_NAMES.
- *   • Config: parseAgentConfig, resolveProfileFromConfig, requireAgentProfile, listResolvedAgentProfiles, listAgentProfileNames.
- *   • Spawn: runAgent. Builders: getCommandBuilder, AgentCommandBuilder, AgentDispatchRequest — platform-specific argv construction.
- *   • Detection: detectAgentCliProfiles, pickDefaultAgentProfile, defaultWhich.
- */
-// The OpenCode SDK runner moved to its harness directory in #564
-// (`harnesses/opencode-sdk/`). Re-exported here so existing `agent/index`
-// import sites keep working.
-export { runAgentSdk } from "../harnesses/opencode-sdk/index.js";
 export { getCommandBuilder } from "./builders.js";
-export { DEFAULT_AGENT_TIMEOUT_MS, listAgentProfileNames, listResolvedAgentProfiles, parseAgentConfig, requireAgentProfile, resolveAgentProfile, resolveDefaultProfileName, resolveProfileFromConfig, } from "./config.js";
+export { DEFAULT_AGENT_TIMEOUT_MS, listAgentProfileNames, listResolvedAgentProfiles, requireAgentProfile, resolveAgentProfile, resolveDefaultProfileName, resolveProfileFromConfig, } from "./config.js";
 export { defaultWhich, detectAgentCliProfiles, pickDefaultAgentProfile } from "./detect.js";
 export { listBuiltinModelAliases, resolveModel } from "./model-aliases.js";
 export { BUILTIN_AGENT_PROFILE_NAMES, getBuiltinAgentProfile, listBuiltinAgentProfiles, } from "./profiles.js";
-export { buildProposePrompt, buildReflectPrompt, buildSchemaRepairPrompt, extractDraftConfidence, parseAgentProposalPayload, stripJsonFences, } from "./prompts.js";
+export { buildProposePrompt, buildReflectPrompt, buildSchemaRepairPrompt, extractDraftConfidence, parseAgentProposalPayload, } from "./prompts.js";
 export { runAgent } from "./spawn.js";

package/dist/integrations/agent/prompts.js

@@ -444,11 +444,3 @@ export function parseAgentProposalPayload(stdout) {
     }
     return out;
 }
-/**
- * Strip `\`\`\`json … \`\`\`` fences and `<think>…</think>` reasoning blocks
- * from agent output. Thin wrapper around `core/parse` helpers, kept exported
- * for backward compatibility (re-exported from `integrations/agent/index.ts`).
- */
-export function stripJsonFences(text) {
-    return stripCodeFences(stripThinkBlocks(text));
-}

package/dist/integrations/harnesses/index.js

@@ -60,9 +60,8 @@ const HARNESS_BY_ANY_ID = (() => {
 })();
 /**
  * Canonical, ordered list of valid harness / platform ids. The Zod
- * `AgentPlatformSchema` enum, the `AgentProfileConfigV2` platform union,
- * `parseAgentProfilesMapV2`'s membership check, and setup's `DetectedHarness`
- * union all derive from this so they cannot drift.
+ * `AgentPlatformSchema` enum, the `AgentProfileConfig` platform union, and
+ * setup's `DetectedHarness` union all derive from this so they cannot drift.
  */
 export const VALID_HARNESS_IDS = Object.freeze(HARNESS_REGISTRY.map((h) => h.id));
 /** Harnesses that expose readable native session logs. */

package/dist/integrations/harnesses/opencode-sdk/index.js

@@ -5,7 +5,7 @@
  * OpenCode SDK harness (#564).
  *
  * Per-harness barrel for the SDK-mode dispatch path:
- *   - agent runner → ./sdk-runner.ts (runOpencodeSdk / runAgentSdk)
+ *   - agent runner → ./sdk-runner.ts (runOpencodeSdk)
  *
  * It also defines {@link OpencodeSdkHarness}, the {@link AkmHarness} descriptor
  * that `HARNESS_REGISTRY` registers.
@@ -17,7 +17,7 @@
  * names. Canonical id is `'opencode-sdk'` with no alias.
  */
 import { BaseHarness } from "../types.js";
-export { closeServer, runAgentSdk, runOpencodeSdk } from "./sdk-runner.js";
+export { closeServer, runOpencodeSdk } from "./sdk-runner.js";
 function caps(c) {
     return {
         sessionLogs: false,

package/dist/integrations/harnesses/opencode-sdk/sdk-runner.js

@@ -230,5 +230,3 @@ export async function runOpencodeSdk(profile, prompt, opts = {}, llmConfig) {
         await client.session.delete({ path: { id: sessionId } }).catch(() => { });
     }
 }
-/** @deprecated Use {@link runOpencodeSdk} instead. */
-export const runAgentSdk = runOpencodeSdk;

package/dist/output/context.js

@@ -12,10 +12,10 @@
  * Initialized from `cli.ts` before `runMain`.
  */
 import { UsageError } from "../core/errors.js";
-export const OUTPUT_FORMATS = ["json", "yaml", "text", "jsonl", "md", "html"];
-export const DETAIL_LEVELS = ["brief", "normal", "full"];
-export const SHAPE_MODES = ["human", "agent", "summary"];
-export function parseOutputFormat(value) {
+const OUTPUT_FORMATS = ["json", "yaml", "text", "jsonl", "md", "html"];
+const DETAIL_LEVELS = ["brief", "normal", "full"];
+const SHAPE_MODES = ["human", "agent", "summary"];
+function parseOutputFormat(value) {
     if (!value)
         return undefined;
     if (OUTPUT_FORMATS.includes(value))
@@ -29,7 +29,7 @@ export function parseDetailLevel(value) {
         return value;
     throw new UsageError(`Invalid value for --detail: ${value}. Expected one of: ${DETAIL_LEVELS.join("|")}`, "INVALID_DETAIL_VALUE");
 }
-export function parseShapeMode(value) {
+function parseShapeMode(value) {
     if (!value)
         return undefined;
     if (SHAPE_MODES.includes(value))

package/dist/scripts/migrate-storage.js

@@ -9699,18 +9699,43 @@ function insertProposalIfAbsent(db, proposal, stashDir) {
   const changes = result.changes ?? 0;
   return Number(changes) > 0;
 }
+function isRetryableBeginError(err) {
+  const msg = (err instanceof Error ? err.message : String(err)).toLowerCase();
+  return msg.includes("within a transaction") || msg.includes("database is locked") || msg.includes("database table is locked");
+}
+function sleepSyncMs(ms) {
+  if (ms <= 0)
+    return;
+  Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+}
 function withImmediateTransaction(db, fn) {
-  db.exec("BEGIN IMMEDIATE");
-  try {
-    const result = fn();
-    db.exec("COMMIT");
-    return result;
-  } catch (err) {
+  let lastBeginErr;
+  for (let attempt = 1;attempt <= WITH_IMMEDIATE_TX_MAX_ATTEMPTS; attempt++) {
     try {
-      db.exec("ROLLBACK");
-    } catch {}
-    throw err;
+      db.exec("BEGIN IMMEDIATE");
+    } catch (err) {
+      lastBeginErr = err;
+      if (isRetryableBeginError(err) && attempt < WITH_IMMEDIATE_TX_MAX_ATTEMPTS) {
+        try {
+          db.exec("ROLLBACK");
+        } catch {}
+        sleepSyncMs(2 ** (attempt - 1));
+        continue;
+      }
+      throw err;
+    }
+    try {
+      const result = fn();
+      db.exec("COMMIT");
+      return result;
+    } catch (err) {
+      try {
+        db.exec("ROLLBACK");
+      } catch {}
+      throw err;
+    }
   }
+  throw lastBeginErr;
 }
 function upsertTaskHistory(db, row) {
   db.prepare(`
@@ -10074,6 +10099,7 @@ function upsertBodyEmbeddings(db, entries) {
     }
   })();
 }
+var WITH_IMMEDIATE_TX_MAX_ATTEMPTS = 5;
 var init_state_db = __esm(() => {
   init_managed_db();
   init_improve_types();
@@ -10327,7 +10353,7 @@ function pruneOldBackups(backupDir) {
 function getConfigLockPath() {
   return path7.join(getConfigDir(), "config.json.lck");
 }
-function sleepSyncMs(ms) {
+function sleepSyncMs2(ms) {
   sleepSync(ms);
 }
 function acquireConfigLock() {
@@ -10348,7 +10374,7 @@ function acquireConfigLock() {
       continue;
     }
     if (attempt < CONFIG_LOCK_MAX_RETRIES - 1) {
-      sleepSyncMs(CONFIG_LOCK_RETRY_DELAY_MS);
+      sleepSyncMs2(CONFIG_LOCK_RETRY_DELAY_MS);
     }
   }
   return () => {};
@@ -11241,9 +11267,7 @@ var init_profiles = __esm(() => {
 
 // src/integrations/agent/config.ts
 var init_config = __esm(() => {
-  init_config2();
   init_errors();
-  init_warn();
   init_profiles();
 });
 
@@ -15785,7 +15809,7 @@ var init_config_schema = __esm(() => {
   });
   LlmCapabilitiesSchema = exports_external.object({
     structuredOutput: exports_external.boolean().optional()
-  }).strict();
+  }).passthrough();
   LlmConnectionConfigSchema = exports_external.object({
     provider: exports_external.string().optional(),
     endpoint: exports_external.string(),
@@ -15800,13 +15824,13 @@ var init_config_schema = __esm(() => {
     contextLength: positiveInt.optional(),
     judgeModel: exports_external.string().min(1).optional(),
     enableThinking: exports_external.boolean().optional()
-  }).strict();
+  }).passthrough();
   LlmProfileConfigSchema = LlmConnectionConfigSchema.extend({
     supportsJsonSchema: exports_external.boolean().optional()
-  }).strict();
+  }).passthrough();
   EmbeddingOllamaOptionsSchema = exports_external.object({
     num_ctx: positiveInt.optional()
-  }).strict();
+  }).passthrough();
   EmbeddingConnectionConfigSchema = exports_external.object({
     provider: exports_external.string().optional(),
     endpoint: exports_external.string().optional(),
@@ -15819,7 +15843,7 @@ var init_config_schema = __esm(() => {
     chunkSize: positiveInt.optional(),
     contextLength: positiveInt.optional(),
     ollamaOptions: EmbeddingOllamaOptionsSchema.optional()
-  }).strict();
+  }).passthrough();
   AgentPlatformSchema = exports_external.enum(VALID_HARNESS_IDS);
   AgentProfileConfigSchema = exports_external.object({
     platform: AgentPlatformSchema,
@@ -15827,7 +15851,7 @@ var init_config_schema = __esm(() => {
     args: exports_external.array(exports_external.string()).optional(),
     workspace: exports_external.string().min(1).optional(),
     model: exports_external.string().min(1).optional()
-  }).strict();
+  }).passthrough();
   ImproveProcessConfigSchema = exports_external.object({
     enabled: exports_external.boolean().optional(),
     mode: exports_external.enum(["llm", "agent", "sdk"]).optional(),
@@ -15839,10 +15863,10 @@ var init_config_schema = __esm(() => {
       enabled: exports_external.boolean().optional(),
       cosineThreshold: exports_external.number().min(0).max(1).optional(),
       cosineCandidateLimit: exports_external.number().int().positive().optional()
-    }).strict().optional(),
-    judgedCache: exports_external.object({ enabled: exports_external.boolean().optional() }).strict().optional(),
-    qualityGate: exports_external.object({ enabled: exports_external.boolean().optional() }).strict().optional(),
-    contradictionDetection: exports_external.object({ enabled: exports_external.boolean().optional() }).strict().optional(),
+    }).passthrough().optional(),
+    judgedCache: exports_external.object({ enabled: exports_external.boolean().optional() }).passthrough().optional(),
+    qualityGate: exports_external.object({ enabled: exports_external.boolean().optional() }).passthrough().optional(),
+    contradictionDetection: exports_external.object({ enabled: exports_external.boolean().optional() }).passthrough().optional(),
     defaultSince: exports_external.string().min(1).optional(),
     maxTotalChars: positiveInt.optional(),
     minContentChars: exports_external.number().int().min(0).optional(),
@@ -15864,28 +15888,28 @@ var init_config_schema = __esm(() => {
       enabled: exports_external.boolean().optional(),
       staleDays: exports_external.number().int().min(0).optional(),
       demotionFactor: exports_external.number().min(0).max(1).optional()
-    }).strict().optional(),
+    }).passthrough().optional(),
     schemaSimilarity: exports_external.object({
       enabled: exports_external.boolean().optional(),
       epsilon: exports_external.number().min(0).max(1).optional(),
       confidencePenalty: exports_external.number().min(0).max(1).optional()
-    }).strict().optional(),
+    }).passthrough().optional(),
     hotProbation: exports_external.object({
       enabled: exports_external.boolean().optional()
-    }).strict().optional(),
+    }).passthrough().optional(),
     antiCollapse: exports_external.object({
       enabled: exports_external.boolean().optional(),
       maxGeneration: exports_external.number().int().min(1).optional(),
       lexicalDiversityCheck: exports_external.boolean().optional(),
       randomClusterFraction: exports_external.number().min(0).max(1).optional()
-    }).strict().optional(),
+    }).passthrough().optional(),
     cls: exports_external.object({
       enabled: exports_external.boolean().optional(),
       adjacentCount: exports_external.number().int().min(1).optional()
-    }).strict().optional(),
+    }).passthrough().optional(),
     fidelityCheck: exports_external.object({
       enabled: exports_external.boolean().optional()
-    }).strict().optional(),
+    }).passthrough().optional(),
     minClusterSize: exports_external.number().int().min(2).optional(),
     maxClustersPerRun: positiveInt.optional(),
     maxClusterSize: positiveInt.optional(),
@@ -15896,7 +15920,7 @@ var init_config_schema = __esm(() => {
     minRecurrence: exports_external.number().int().min(2).optional(),
     maxProposalsPerRun: positiveInt.optional(),
     emitAs: exports_external.enum(["workflow", "skill"]).optional(),
-    lowValueFilter: exports_external.object({ enabled: exports_external.boolean().optional() }).strict().optional(),
+    lowValueFilter: exports_external.object({ enabled: exports_external.boolean().optional() }).passthrough().optional(),
     proceduralAwareFloor: exports_external.boolean().optional(),
     applyMode: exports_external.enum(["queue", "promote"]).optional(),
     policy: exports_external.string().min(1).optional(),
@@ -15907,8 +15931,8 @@ var init_config_schema = __esm(() => {
       mode: exports_external.enum(["llm", "agent", "sdk"]).optional(),
       profile: exports_external.string().min(1).optional(),
       timeoutMs: exports_external.union([positiveInt, exports_external.null()]).optional()
-    }).strict().optional()
-  }).strict();
+    }).passthrough().optional()
+  }).passthrough();
   ImproveProfileProcessesSchema = exports_external.object({
     reflect: ImproveProcessConfigSchema.optional(),
     distill: ImproveProcessConfigSchema.optional(),
@@ -15921,35 +15945,11 @@ var init_config_schema = __esm(() => {
     recombine: ImproveProcessConfigSchema.optional(),
     procedural: ImproveProcessConfigSchema.optional()
   }).passthrough().superRefine((val, ctx) => {
-    const raw = val;
-    if ("feedbackDistillation" in raw) {
+    if ("feedbackDistillation" in val) {
       ctx.addIssue({
         code: exports_external.ZodIssueCode.custom,
         message: "feedbackDistillation was removed in 0.8.0 \u2014 use processes.distill.enabled instead. " + "It now controls both the orchestration gate and the LLM-call gate."
       });
-      return;
-    }
-    const allowed = new Set([
-      "reflect",
-      "distill",
-      "consolidate",
-      "memoryInference",
-      "graphExtraction",
-      "validation",
-      "extract",
-      "triage",
-      "proactiveMaintenance",
-      "recombine",
-      "procedural"
-    ]);
-    for (const k of Object.keys(raw)) {
-      if (!allowed.has(k)) {
-        ctx.addIssue({
-          code: exports_external.ZodIssueCode.unrecognized_keys,
-          keys: [k],
-          message: `Unrecognized improve process key: "${k}".`
-        });
-      }
     }
   });
   ImproveProfileConfigSchema = exports_external.object({
@@ -15963,18 +15963,18 @@ var init_config_schema = __esm(() => {
       enabled: exports_external.boolean().optional(),
       push: exports_external.boolean().optional(),
       message: exports_external.string().min(1).optional()
-    }).strict().optional()
-  }).strict();
+    }).passthrough().optional()
+  }).passthrough();
   ProfilesSchema = exports_external.object({
     llm: exports_external.record(exports_external.string(), LlmProfileConfigSchema).optional(),
     agent: exports_external.record(exports_external.string(), AgentProfileConfigSchema).optional(),
     improve: exports_external.record(exports_external.string(), ImproveProfileConfigSchema).optional()
-  }).strict();
+  }).passthrough();
   DefaultsSchema = exports_external.object({
     llm: exports_external.string().min(1).optional(),
     agent: exports_external.string().min(1).optional(),
     improve: exports_external.string().min(1).optional()
-  }).strict();
+  }).passthrough();
   SourceConfigEntryOptionsSchema = exports_external.object({
     pushOnCommit: exports_external.boolean().optional()
   }).passthrough();
@@ -15988,7 +15988,7 @@ var init_config_schema = __esm(() => {
     primary: exports_external.boolean().optional(),
     options: SourceConfigEntryOptionsSchema.optional(),
     wikiName: exports_external.string().min(1).optional()
-  }).strict().superRefine((entry, ctx) => {
+  }).passthrough().superRefine((entry, ctx) => {
     if (entry.writable === true && (entry.type === "website" || entry.type === "npm")) {
       ctx.addIssue({
         code: exports_external.ZodIssueCode.custom,
@@ -16002,7 +16002,7 @@ var init_config_schema = __esm(() => {
     enabled: exports_external.boolean().optional(),
     provider: exports_external.string().min(1).optional(),
     options: exports_external.record(exports_external.unknown()).optional()
-  }).strict();
+  }).passthrough();
   KitSourceSchema = exports_external.enum(["filesystem", "git", "npm", "github", "website", "local"]);
   InstalledStashEntrySchema = exports_external.object({
     id: nonEmptyString,
@@ -16016,7 +16016,7 @@ var init_config_schema = __esm(() => {
     resolvedVersion: exports_external.string().min(1).optional(),
     resolvedRevision: exports_external.string().min(1).optional(),
     wikiName: exports_external.string().min(1).optional()
-  }).strict().superRefine((entry, ctx) => {
+  }).passthrough().superRefine((entry, ctx) => {
     if (entry.writable === true && entry.source !== "git" && entry.source !== "filesystem") {
       ctx.addIssue({
         code: exports_external.ZodIssueCode.custom,
@@ -16027,7 +16027,7 @@ var init_config_schema = __esm(() => {
   OutputConfigSchema = exports_external.object({
     format: exports_external.enum(["json", "yaml", "text"]).optional(),
     detail: exports_external.enum(["brief", "normal", "full"]).optional()
-  }).strict();
+  }).passthrough();
   SearchGraphBoostSchema = exports_external.object({
     directBoostPerEntity: nonNegativeNumber.optional(),
     directBoostCap: nonNegativeNumber.optional(),
@@ -16036,21 +16036,21 @@ var init_config_schema = __esm(() => {
     maxHops: positiveInt.max(3).optional(),
     confidenceMode: exports_external.enum(["off", "blend", "multiply"]).default("blend").optional(),
     confidenceWeight: exports_external.number().finite().min(0).max(1).default(0.2).optional()
-  }).strict();
+  }).passthrough();
   SearchConfigSchema = exports_external.object({
     minScore: nonNegativeNumber.optional(),
     defaultExcludeTypes: exports_external.array(nonEmptyString).optional(),
-    curateRerank: exports_external.object({ enabled: exports_external.boolean().optional() }).strict().optional(),
+    curateRerank: exports_external.object({ enabled: exports_external.boolean().optional() }).passthrough().optional(),
     graphBoost: SearchGraphBoostSchema.optional()
-  }).strict();
+  }).passthrough();
   FeedbackConfigSchema = exports_external.object({
     requireReason: exports_external.boolean().optional(),
     allowedFailureModes: exports_external.array(nonEmptyString).optional()
-  }).strict();
+  }).passthrough();
   ImproveUtilityDecaySchema = exports_external.object({
     halfLifeDays: exports_external.number().finite().min(0.1).optional(),
     feedbackStabilityBoost: exports_external.number().finite().min(1).optional()
-  }).strict();
+  }).passthrough();
   ImproveCalibrationSchema = exports_external.object({
     autoTune: exports_external.boolean().optional(),
     minThreshold: exports_external.number().int().min(0).max(100).optional(),
@@ -16058,23 +16058,23 @@ var init_config_schema = __esm(() => {
     maxStep: positiveInt.optional(),
     minSamples: nonNegativeNumber.optional(),
     targetAcceptRate: exports_external.number().finite().min(0).max(1).optional()
-  }).strict();
+  }).passthrough();
   ImproveExplorationSchema = exports_external.object({
     enabled: exports_external.boolean().optional(),
     budgetFraction: exports_external.number().finite().min(0).max(1).optional()
-  }).strict();
+  }).passthrough();
   ImproveSalienceSchema = exports_external.object({
     outcomeWeightEnabled: exports_external.boolean().optional(),
     salienceThreshold: exports_external.number().min(0).max(1).optional(),
     replayBudget: exports_external.number().int().min(0).optional()
-  }).strict();
+  }).passthrough();
   ImproveConfigSchema = exports_external.object({
     utilityDecay: ImproveUtilityDecaySchema.optional(),
     eventRetentionDays: nonNegativeNumber.optional(),
     calibration: ImproveCalibrationSchema.optional(),
     exploration: ImproveExplorationSchema.optional(),
     salience: ImproveSalienceSchema.optional()
-  }).strict();
+  }).passthrough();
   GRAPH_EXTRACTION_INCLUDE_TYPES_ALLOWED = [
     "memory",
     "knowledge",
@@ -16140,11 +16140,11 @@ var init_config_schema = __esm(() => {
     memoryInferenceBatchSize: positiveInt.optional(),
     lazyGraphExtraction: exports_external.boolean().optional()
   }).passthrough());
-  MetadataEnhanceSchema = exports_external.object({ enabled: exports_external.boolean().optional() }).strict();
+  MetadataEnhanceSchema = exports_external.object({ enabled: exports_external.boolean().optional() }).passthrough();
   StalenessDetectionSchema = exports_external.object({
     enabled: exports_external.boolean().optional(),
     thresholdDays: positiveInt.optional()
-  }).strict();
+  }).passthrough();
   IndexConfigSchema = exports_external.preprocess((raw, ctx) => {
     if (raw === undefined || raw === null)
       return raw;
@@ -16190,10 +16190,10 @@ var init_config_schema = __esm(() => {
   SetupTaskSchedulesSchema = exports_external.object({
     improve: exports_external.string().min(1).optional(),
     index: exports_external.string().min(1).optional()
-  }).strict();
+  }).passthrough();
   SetupConfigSchema = exports_external.object({
     taskSchedules: SetupTaskSchedulesSchema.optional()
-  }).strict();
+  }).passthrough();
   AkmConfigShape = {
     configVersion: exports_external.union([exports_external.string().min(1), exports_external.number()]).optional(),
     profiles: ProfilesSchema.optional(),
@@ -16214,7 +16214,7 @@ var init_config_schema = __esm(() => {
     improve: ImproveConfigSchema.optional(),
     setup: SetupConfigSchema.optional()
   };
-  AkmConfigBaseSchema = exports_external.object(AkmConfigShape).strict();
+  AkmConfigBaseSchema = exports_external.object(AkmConfigShape).passthrough();
   AkmConfigSchema = AkmConfigBaseSchema.superRefine((config, ctx) => {
     if (config.defaultWriteTarget !== undefined) {
       const knownNames = (config.sources ?? []).map((s) => s.name).filter((n) => typeof n === "string" && n.length > 0);

package/dist/sources/wiki-fetchers/youtube.js

@@ -4,6 +4,21 @@
 import { fetchWithRetry } from "../../core/common.js";
 const YOUTUBE_HOSTS = new Set(["www.youtube.com", "youtube.com", "m.youtube.com", "youtu.be"]);
 const WATCH_HOST = "https://www.youtube.com/watch?v=";
+// Captions: the WEB watch-page caption baseUrls are now Proof-of-Origin-Token
+// gated (they carry `exp=xpe` and return an empty body without a `pot` token).
+// The ANDROID InnerTube `player` client still returns UNGATED caption baseUrls
+// that serve the transcript, so captions are sourced from there. See
+// https://github.com/yt-dlp/yt-dlp/issues/13075.
+const INNERTUBE_PLAYER_URL = "https://www.youtube.com/youtubei/v1/player";
+// Long-stable public InnerTube key; only authorizes the player call (not auth).
+const DEFAULT_INNERTUBE_KEY = "AIzaSyAO_FJ2SlqU8Q4STEHLGCilw_Y9_11qcW8";
+const ANDROID_INNERTUBE_CLIENT = {
+    clientName: "ANDROID",
+    clientVersion: "20.10.38",
+    androidSdkVersion: 34,
+    hl: "en",
+    gl: "US",
+};
 function extractVideoId(url) {
     if (!YOUTUBE_HOSTS.has(url.hostname))
         return null;
@@ -129,13 +144,45 @@ async function fetchText(url, timeoutMs, signal) {
     return response.text();
 }
 function parseTranscript(xml) {
-    const texts = [...xml.matchAll(/<text\b[^>]*>([\s\S]*?)<\/text>/g)]
-        .map((match) => decodeEntities(stripTags(match[1] ?? "")).trim())
-        .filter(Boolean);
+    // Two timedtext shapes: legacy srv1 `<text>` cues, and the format-3
+    // `<timedtext format="3">` `<p>` cues that the ANDROID InnerTube caption
+    // URLs return. Strip any nested `<s>` word tags via stripTags.
+    const matches = [...xml.matchAll(/<text\b[^>]*>([\s\S]*?)<\/text>/g), ...xml.matchAll(/<p\b[^>]*>([\s\S]*?)<\/p>/g)];
+    const texts = matches.map((match) => decodeEntities(stripTags(match[1] ?? "")).trim()).filter(Boolean);
     if (texts.length === 0)
         return null;
     return texts.join("\n");
 }
+/**
+ * Fetch caption tracks via the ANDROID InnerTube `player` endpoint, whose
+ * caption baseUrls are not POT-gated. Returns [] on any failure so the caller
+ * can fall back to the (usually empty) watch-page tracks and degrade to a
+ * description-only snapshot.
+ */
+async function fetchInnertubeCaptionTracks(videoId, apiKey, timeoutMs, signal) {
+    try {
+        const response = await fetchWithRetry(`${INNERTUBE_PLAYER_URL}?key=${encodeURIComponent(apiKey)}`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "User-Agent": "com.google.android.youtube/20.10.38 (Linux; U; Android 14) gzip",
+            },
+            body: JSON.stringify({ context: { client: ANDROID_INNERTUBE_CLIENT }, videoId }),
+            signal,
+        }, { timeout: timeoutMs, retries: 1 });
+        if (!response.ok)
+            return [];
+        const json = (await response.json());
+        return json.captions?.playerCaptionsTracklistRenderer?.captionTracks ?? [];
+    }
+    catch {
+        return [];
+    }
+}
+/** Extract the page's InnerTube API key, falling back to the stable default. */
+function extractInnertubeKey(html) {
+    return html.match(/"INNERTUBE_API_KEY":"([^"]+)"/)?.[1] ?? DEFAULT_INNERTUBE_KEY;
+}
 const youtubeFetcher = {
     name: "youtube-transcript",
     matches(url) {
@@ -161,7 +208,14 @@ const youtubeFetcher = {
         if (description) {
             sections.push("## Description", "", description);
         }
-        const tracks = playerResponse.captions?.playerCaptionsTracklistRenderer?.captionTracks ?? [];
+        // Prefer ungated ANDROID InnerTube caption tracks; fall back to the
+        // (now usually empty) watch-page tracks so a description-only snapshot
+        // still works when InnerTube is unavailable.
+        const apiKey = extractInnertubeKey(watchHtml);
+        let tracks = await fetchInnertubeCaptionTracks(videoId, apiKey, context.timeoutMs, context.signal);
+        if (tracks.length === 0) {
+            tracks = playerResponse.captions?.playerCaptionsTracklistRenderer?.captionTracks ?? [];
+        }
         const captionUrl = chooseCaptionTrack(tracks);
         if (captionUrl) {
             const transcriptXml = await fetchText(captionUrl, context.timeoutMs, context.signal);

package/dist/tasks/backends/cron.js

@@ -29,7 +29,7 @@ import fs from "node:fs";
 import path from "node:path";
 import { ConfigError } from "../../core/errors.js";
 import { getTaskLogDir } from "../../core/paths.js";
-import { resolveAkmInvocation } from "../resolveAkmBin.js";
+import { resolveAkmInvocation } from "../resolve-akm-bin.js";
 import { parseSchedule, translateToCron } from "../schedule.js";
 const BEGIN = (id) => `# akm:task ${id} BEGIN`;
 const END = (id) => `# akm:task ${id} END`;

package/dist/tasks/backends/launchd.js

@@ -27,7 +27,7 @@ import path from "node:path";
 import launchdTemplate from "../../assets/backends/launchd-template.xml" with { type: "text" };
 import { ConfigError } from "../../core/errors.js";
 import { getTaskLogDir } from "../../core/paths.js";
-import { resolveAkmInvocation } from "../resolveAkmBin.js";
+import { resolveAkmInvocation } from "../resolve-akm-bin.js";
 import { parseSchedule, translateToLaunchd } from "../schedule.js";
 import { escapeXml, nodeExec, nodeFs } from "./exec-utils.js";
 export const LAUNCHD_LABEL_PREFIX = "com.akm.task.";

package/dist/tasks/backends/schtasks.js

@@ -35,7 +35,7 @@ import path from "node:path";
 import schtasksTemplate from "../../assets/backends/schtasks-template.xml" with { type: "text" };
 import { ConfigError } from "../../core/errors.js";
 import { getTaskLogDir } from "../../core/paths.js";
-import { resolveAkmInvocation } from "../resolveAkmBin.js";
+import { resolveAkmInvocation } from "../resolve-akm-bin.js";
 import { parseSchedule, translateToSchtasks } from "../schedule.js";
 import { escapeXml, nodeExec, nodeFs } from "./exec-utils.js";
 export const DEFAULT_FOLDER_PREFIX = "\\akm\\";

package/dist/tasks/{resolveAkmBin.js → resolve-akm-bin.js}

@@ -44,8 +44,8 @@ export function resolveAkmInvocation(options = {}) {
 /**
  * From the URL of a module inside `src/tasks/` figure out the CLI entry.
  *
- *   • dev      `…/src/tasks/resolveAkmBin.ts`   → `…/src/cli.ts`
- *   • build    `…/dist/tasks/resolveAkmBin.js`  → `…/dist/cli.js`
+ *   • dev      `…/src/tasks/resolve-akm-bin.ts`   → `…/src/cli.ts`
+ *   • build    `…/dist/tasks/resolve-akm-bin.js`  → `…/dist/cli.js`
  */
 function resolveCliEntry(moduleUrl) {
     let modulePath;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akm-cli",
-  "version": "0.9.0-beta.47",
+  "version": "0.9.0-beta.49",
   "type": "module",
   "description": "akm (Agent Knowledge Management) — A package manager for AI agent skills, commands, tools, and knowledge. Works with Claude Code, OpenCode, Cursor, and any AI coding assistant.",
   "keywords": [