@gyoungwe/research-suite 0.1.3 → 0.1.6

package/node_modules/@gyoungwe/pi-core/dist/index.mjs

@@ -101,7 +101,8 @@ function createStandaloneRuntime(log = {}) {
   return runtime;
 }
 function currentRuntime() {
-  if (contexts.getStore()) return contexts.getStore();
+  const scoped = contexts.getStore();
+  if (scoped) return scoped;
   if (installedRuntime) return installedRuntime;
   if (!standaloneRuntime) standaloneRuntime = createStandaloneRuntime();
   return standaloneRuntime;
@@ -144,10 +145,7 @@ function runtimeSlot(domain, slot, create) {
       }
     }
   );
-  return (
-    /** @type {T} */
-    proxy
-  );
+  return proxy;
 }
 
 // ../tasks/src/runtime-compiled/acceptance.mjs
@@ -2818,6 +2816,257 @@ Use task_status for operational delivery. Verify unknown outcomes before repeati
   return journal;
 }
 
+// src/drone-commands.ts
+import { readFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+var DRONE_COMMAND_SCHEMA_VERSION = 1;
+var PI_CORE_PACKAGE_VERSION = "0.1.5";
+var PI_HOST_RANGE = ">=1.1.0 <2.0.0";
+var CORE_TOOLS = [
+  "ask_user",
+  "set_status",
+  "todo",
+  "deliver_files",
+  "memory_save",
+  "task_plan",
+  "task_status",
+  "task_wait",
+  "task_reconcile",
+  "task_evidence_restore"
+];
+var EXAMPLE_PROFILES = {
+  knowledge: {
+    title: "Knowledge Vault example",
+    steps: ["check the local Vault", "search local knowledge", "cite the retrieved note paths"],
+    requiredTools: ["knowledge_status", "knowledge_search"],
+    missingToolsNext: "\u5B89\u88C5\u5E76\u542F\u7528 pi-knowledge \u540E\u91CD\u8BD5 /drone-example knowledge",
+    missingDataNext: "\u63D0\u4F9B\u4E00\u4E2A\u77E5\u8BC6\u95EE\u9898\uFF1A/drone-example knowledge --run <\u95EE\u9898>"
+  },
+  research: {
+    title: "Evidence-gated local research example",
+    steps: ["inspect local knowledge", "read at least two sources", "answer with source receipts"],
+    requiredTools: ["research_search_sources", "research_read_source", "research_answer_sources"],
+    missingToolsNext: "\u5B89\u88C5\u5E76\u542F\u7528 pi-research \u540E\u91CD\u8BD5 /drone-example research",
+    missingDataNext: "\u63D0\u4F9B\u4E00\u4E2A\u7814\u7A76\u95EE\u9898\uFF1A/drone-example research --run <\u7814\u7A76\u95EE\u9898>"
+  },
+  analysis: {
+    title: "Analysis readiness example",
+    requiresContainer: true,
+    steps: [
+      "list compatible analysis adapters",
+      "assess input readiness",
+      "report missing data before execution"
+    ],
+    requiredTools: ["analysis_list_adapters", "analysis_assess_readiness"],
+    missingToolsNext: "\u5B89\u88C5\u5E76\u542F\u7528 pi-analysis \u540E\u91CD\u8BD5 /drone-example analysis",
+    missingDataNext: "\u63D0\u4F9B\u8F93\u5165\u4E0E\u5206\u6790\u95EE\u9898\uFF1A/drone-example analysis --run <\u5206\u6790\u95EE\u9898>"
+  },
+  evidence: {
+    title: "Evidence validation example",
+    steps: ["validate an artifact manifest", "validate an evidence capsule", "verify replay metadata"],
+    requiredTools: ["evidence_validate_manifest", "evidence_validate_capsule", "evidence_verify_replay"],
+    missingToolsNext: "\u5B89\u88C5\u5E76\u542F\u7528 pi-evidence \u540E\u91CD\u8BD5 /drone-example evidence",
+    missingDataNext: "\u63D0\u4F9B\u5F85\u6838\u9A8C\u7684\u8BC1\u636E\u5BF9\u8C61\uFF1A/drone-example evidence --run <\u5BF9\u8C61>"
+  }
+};
+var EXAMPLE_KINDS = new Set(Object.keys(EXAMPLE_PROFILES));
+function packageVersion() {
+  const configured = process.env.PI_VERSION?.trim();
+  if (configured) return { version: configured, source: "PI_VERSION" };
+  const readPackageFrom = (entry) => {
+    let current = entry;
+    try {
+      current = dirname(current);
+    } catch {
+      return void 0;
+    }
+    for (let depth = 0; depth < 8; depth += 1) {
+      const packagePath = join(current, "package.json");
+      try {
+        const metadata = JSON.parse(readFileSync(packagePath, "utf8"));
+        if (metadata?.name === "@earendil-works/pi-coding-agent" && typeof metadata.version === "string" && metadata.version.length > 0)
+          return { version: metadata.version, source: "resolved-package" };
+      } catch {
+      }
+      const parent = dirname(current);
+      if (parent === current) break;
+      current = parent;
+    }
+    return void 0;
+  };
+  const candidates = [fileURLToPath(import.meta.url), process.argv[1], process.cwd()].filter(
+    (entry) => typeof entry === "string" && entry.length > 0
+  );
+  for (const candidate of candidates) {
+    const resolved = readPackageFrom(candidate);
+    if (resolved) return resolved;
+  }
+  try {
+    const require2 = createRequire(import.meta.url);
+    for (const base of require2.resolve.paths("@earendil-works/pi-coding-agent") ?? []) {
+      const packagePath = join(base, "@earendil-works/pi-coding-agent", "package.json");
+      try {
+        const metadata = JSON.parse(readFileSync(packagePath, "utf8"));
+        if (metadata.name === "@earendil-works/pi-coding-agent" && typeof metadata.version === "string" && metadata.version.length > 0)
+          return { version: metadata.version, source: "resolved-package" };
+      } catch {
+      }
+    }
+  } catch {
+  }
+  return { version: null, source: "unavailable" };
+}
+function snapshot(pi) {
+  const tools = typeof pi?.getAllTools === "function" ? pi.getAllTools().map((tool) => String(tool?.name || "")).filter(Boolean) : typeof pi?.getActiveTools === "function" ? pi.getActiveTools().map((name) => String(name)).filter(Boolean) : [];
+  const commands = typeof pi?.getCommands === "function" ? pi.getCommands().map((command) => String(command?.name || "")).filter(Boolean) : [];
+  return { tools: [...new Set(tools)].sort(), commands: [...new Set(commands)].sort() };
+}
+function isSupportedPiHost(version) {
+  const match = /^(\d+)\.(\d+)\.(\d+)(?:[-+].*)?$/.exec(version.trim());
+  if (!match) return false;
+  const major = Number(match[1]);
+  const minor = Number(match[2]);
+  const patch = Number(match[3]);
+  return major === 1 && (minor > 1 || minor === 1 && patch >= 0);
+}
+function buildDoctorReport(pi, options = {}) {
+  const current = snapshot(pi);
+  const missingTools = CORE_TOOLS.filter((name) => !current.tools.includes(name));
+  const missingCommands = ["drone-doctor", "drone-example"].filter(
+    (name) => !current.commands.includes(name)
+  );
+  const resolved = options.hostVersion === void 0 ? packageVersion() : { version: options.hostVersion, source: "host-contract" };
+  const hostCompatible = resolved.version ? isSupportedPiHost(resolved.version) : null;
+  const hostKind = options.hostKind || "native-pi";
+  const checks = [
+    {
+      id: "core-tools",
+      status: missingTools.length ? "blocked" : "pass",
+      detail: missingTools.length ? "pi-core tools are missing" : "all pi-core tools are registered",
+      ...missingTools.length ? { missing: missingTools } : {}
+    },
+    {
+      id: "drone-commands",
+      status: missingCommands.length ? "blocked" : "pass",
+      detail: missingCommands.length ? "Drone onboarding commands are missing" : "doctor and example commands are registered",
+      ...missingCommands.length ? { missing: missingCommands } : {}
+    },
+    {
+      id: "pi-host-version",
+      status: resolved.version ? hostCompatible ? "pass" : "incompatible" : "unknown",
+      detail: resolved.version ? hostCompatible ? `resolved Pi host ${resolved.version}` : `Pi host ${resolved.version} is outside ${PI_HOST_RANGE}` : "Pi host version is not exposed by this host"
+    }
+  ];
+  const blocked = checks.some((check) => check.status === "blocked");
+  const incompatible = checks.some((check) => check.status === "incompatible");
+  return {
+    schemaVersion: DRONE_COMMAND_SCHEMA_VERSION,
+    command: "drone-doctor",
+    status: blocked ? "blocked" : incompatible ? "incompatible" : resolved.version ? "pass" : "unknown",
+    plugin: { name: "@gyoungwe/pi-core", version: PI_CORE_PACKAGE_VERSION, piRange: PI_HOST_RANGE },
+    host: { kind: hostKind, version: resolved.version || null, source: resolved.source },
+    checks,
+    commands: current.commands,
+    tools: current.tools,
+    next: blocked ? "\u5B89\u88C5\u6216\u91CD\u65B0\u52A0\u8F7D\u7F3A\u5931\u7684 Drone \u63D2\u4EF6\u540E\u91CD\u8BD5 /drone-doctor" : incompatible ? `\u5347\u7EA7 Pi \u5230 ${PI_HOST_RANGE} \u540E\u91CD\u8BD5 /drone-doctor` : null
+  };
+}
+function buildExampleReport(pi, mode = "preview", question, options = {}) {
+  const example = options.example ?? "research";
+  const profile = EXAMPLE_PROFILES[example];
+  const current = snapshot(pi);
+  const missingTools = profile.requiredTools.filter((name) => !current.tools.includes(name));
+  const hasQuestion = Boolean(question?.trim());
+  const knowledgeStatus = example === "knowledge" ? options.knowledgeStatus ?? (process.env.DRONE_KNOWLEDGE_DIR?.trim() ? "unknown" : "unconfigured") : void 0;
+  const containerAvailable = options.containerAvailable ?? Boolean(process.env.DRONE_CONTAINER_RUNTIME?.trim());
+  const missingContainer = Boolean(profile.requiresContainer && !containerAvailable);
+  const status2 = missingTools.length ? "blocked" : knowledgeStatus === "unconfigured" ? "unconfigured" : knowledgeStatus === "unknown" ? "needs-data" : missingContainer ? "needs-container" : mode === "run" && hasQuestion ? "started" : hasQuestion ? "ready" : "needs-data";
+  return {
+    schemaVersion: DRONE_COMMAND_SCHEMA_VERSION,
+    command: "drone-example",
+    example,
+    status: status2,
+    mode,
+    title: profile.title,
+    steps: [...profile.steps],
+    requiredTools: [...profile.requiredTools],
+    missingTools: [...missingTools],
+    next: missingTools.length ? profile.missingToolsNext : missingContainer ? "\u767B\u8BB0\u5E76\u542F\u7528\u4E00\u4E2A\u5BB9\u5668\u8FD0\u884C\u65F6\u540E\u91CD\u8BD5 /drone-example analysis" : knowledgeStatus === "unconfigured" ? "\u5148\u8FD0\u884C /drone-init \u7ED1\u5B9A\u672C\u5730 Vault\uFF0C\u518D\u91CD\u8BD5 /drone-example knowledge" : knowledgeStatus === "unknown" ? "\u65E0\u6CD5\u786E\u8BA4\u672C\u5730 Vault \u72B6\u6001\uFF1B\u5148\u8FD0\u884C /drone-init \u6216\u68C0\u67E5\u77E5\u8BC6\u5E93\u63D2\u4EF6\u540E\u91CD\u8BD5" : hasQuestion ? mode === "run" ? `${profile.title} \u5DF2\u6392\u961F\uFF1B\u7B49\u5F85\u771F\u5B9E\u56DE\u6267` : `\u8FD0\u884C /drone-example ${example} --run <\u95EE\u9898> \u5F00\u59CB\u53EA\u8BFB\u793A\u4F8B` : profile.missingDataNext,
+    ...hasQuestion ? { question: question?.trim() } : {}
+  };
+}
+function parseExampleArgs(args) {
+  const tokens = args.trim().split(/\s+/).filter(Boolean);
+  let mode = "preview";
+  const remaining = tokens.filter((token) => {
+    if (token === "--run") {
+      mode = "run";
+      return false;
+    }
+    return true;
+  });
+  const candidate = remaining[0]?.toLowerCase();
+  const example = candidate && EXAMPLE_KINDS.has(candidate) ? candidate : "research";
+  if (candidate && EXAMPLE_KINDS.has(candidate)) remaining.shift();
+  const question = remaining.join(" ").trim();
+  return { mode, example, ...question ? { question } : {} };
+}
+async function resolveKnowledgeStatus(pi, ctx) {
+  if (!process.env.DRONE_KNOWLEDGE_DIR?.trim()) return "unconfigured";
+  const tool = typeof pi?.getAllTools === "function" ? pi.getAllTools().find((candidate) => candidate?.name === "knowledge_status") : void 0;
+  if (typeof tool?.execute !== "function") return "unknown";
+  try {
+    const result = await tool.execute(
+      "drone-example:knowledge-status",
+      {},
+      new AbortController().signal,
+      () => void 0,
+      ctx
+    );
+    const status2 = result?.details?.status ?? result?.status;
+    if (status2 === "unconfigured") return "unconfigured";
+    if (status2 === "configured") return "configured";
+  } catch {
+  }
+  return "unknown";
+}
+function emitReport(report, ctx) {
+  const message = JSON.stringify(report);
+  if (ctx.mode === "print" || ctx.mode === "json") console.log(message);
+  else
+    ctx.ui.notify(
+      message,
+      report.status === "blocked" || report.status === "unconfigured" || report.status === "needs-container" || report.status === "incompatible" ? "warning" : "info"
+    );
+}
+function registerDroneCommands(pi, options = {}) {
+  pi.registerCommand("drone-doctor", {
+    description: "Check the resolved Pi host, core tools and Drone command contract",
+    handler: async (_args, ctx) => emitReport(buildDoctorReport(pi, options), ctx)
+  });
+  pi.registerCommand("drone-example", {
+    description: "Preview or start a read-only Drone knowledge, research, analysis or evidence example",
+    handler: async (args, ctx) => {
+      const parsed = parseExampleArgs(args);
+      const knowledgeStatus = parsed.example === "knowledge" ? await resolveKnowledgeStatus(pi, ctx) : void 0;
+      const report = buildExampleReport(pi, parsed.mode, parsed.question, {
+        example: parsed.example,
+        knowledgeStatus
+      });
+      if (parsed.mode === "run" && report.status === "started" && typeof pi.sendUserMessage === "function") {
+        await pi.sendUserMessage(
+          `Run a read-only Drone ${report.example} example for this question: ${parsed.question}
+Use local evidence first, preserve source URIs and hashes, and report blocked/unknown states instead of guessing.`,
+          { deliverAs: "followUp", expandPromptTemplates: true }
+        );
+      }
+      emitReport(report, ctx);
+    }
+  });
+}
+
 // ../shared/src/analysis-orchestration.ts
 var ANALYSIS_STAGES = Object.freeze([
   "intake",
@@ -10685,6 +10934,18 @@ var ComputeHostInputSchema = typebox_exports.Object(
   },
   { additionalProperties: false }
 );
+var ComputeSshConfigHostSchema = typebox_exports.Object(
+  {
+    alias: typebox_exports.String({ minLength: 1, maxLength: 64, pattern: "^[A-Za-z0-9._-]+$" }),
+    hostname: typebox_exports.Optional(typebox_exports.String({ maxLength: 512 })),
+    port: typebox_exports.Optional(typebox_exports.Integer({ minimum: 1, maximum: 65535 })),
+    user: typebox_exports.Optional(typebox_exports.String({ maxLength: 128 })),
+    identityFiles: typebox_exports.Array(typebox_exports.String({ maxLength: 1024 }), { maxItems: 8 }),
+    proxyJump: typebox_exports.Optional(typebox_exports.String({ maxLength: 512 })),
+    source: typebox_exports.Literal("ssh-config")
+  },
+  { additionalProperties: false }
+);
 var ComputeBudgetSchema = typebox_exports.Object(
   {
     /** Total CPU core-hours allowed for this task. */
@@ -11608,6 +11869,61 @@ var GitBranchesSchema = typebox_exports.Object(
   { additionalProperties: false }
 );
 var NullableString = typebox_exports.Union([typebox_exports.String(), typebox_exports.Null()]);
+var SkillRepositoryAddInputSchema = typebox_exports.Unsafe(
+  typebox_exports.Object(
+    {
+      kind: typebox_exports.Union([typebox_exports.Literal("git"), typebox_exports.Literal("local")]),
+      source: typebox_exports.String({ minLength: 1, maxLength: 4096 }),
+      ref: typebox_exports.Optional(typebox_exports.String({ minLength: 1, maxLength: 256 })),
+      subpath: typebox_exports.Optional(typebox_exports.String({ maxLength: 1024 })),
+      license: typebox_exports.String({ minLength: 1, maxLength: 256 }),
+      licenseEvidence: typebox_exports.Optional(typebox_exports.String({ maxLength: 4096 })),
+      name: typebox_exports.Optional(typebox_exports.String({ maxLength: 256 }))
+    },
+    { additionalProperties: false }
+  )
+);
+var SkillRepositoryRecordSchema = typebox_exports.Unsafe(
+  typebox_exports.Object(
+    {
+      id: typebox_exports.String({ minLength: 1, maxLength: 64 }),
+      name: typebox_exports.String({ minLength: 1, maxLength: 256 }),
+      kind: typebox_exports.Union([typebox_exports.Literal("git"), typebox_exports.Literal("local")]),
+      source: typebox_exports.String({ minLength: 1, maxLength: 4096 }),
+      ref: typebox_exports.Optional(typebox_exports.String({ maxLength: 256 })),
+      subpath: typebox_exports.Optional(typebox_exports.String({ maxLength: 1024 })),
+      license: typebox_exports.String({ minLength: 1, maxLength: 256 }),
+      licenseEvidence: typebox_exports.Optional(typebox_exports.String({ maxLength: 4096 })),
+      status: typebox_exports.Union([typebox_exports.Literal("ready"), typebox_exports.Literal("update-available"), typebox_exports.Literal("error")]),
+      skillCount: typebox_exports.Integer({ minimum: 0, maximum: 1e3 }),
+      lastCheckedAt: typebox_exports.Optional(typebox_exports.String({ maxLength: 64 })),
+      lastAppliedAt: typebox_exports.Optional(typebox_exports.String({ maxLength: 64 })),
+      lastError: typebox_exports.Optional(typebox_exports.String({ maxLength: 2e3 })),
+      updateAvailable: typebox_exports.Optional(typebox_exports.Boolean())
+    },
+    { additionalProperties: false }
+  )
+);
+var SkillRepositoryListSchema = typebox_exports.Array(SkillRepositoryRecordSchema, { maxItems: 100 });
+var SkillRepositoryCheckResultSchema = typebox_exports.Unsafe(
+  typebox_exports.Object(
+    {
+      repository: SkillRepositoryRecordSchema,
+      changedFiles: typebox_exports.Array(typebox_exports.String({ maxLength: 1024 }), { maxItems: 1e3 })
+    },
+    { additionalProperties: false }
+  )
+);
+var SkillRepositoryUpdateResultSchema = typebox_exports.Unsafe(
+  typebox_exports.Object(
+    {
+      repository: SkillRepositoryRecordSchema,
+      changedFiles: typebox_exports.Array(typebox_exports.String({ maxLength: 1024 }), { maxItems: 1e3 }),
+      restartedRequired: typebox_exports.Literal(true)
+    },
+    { additionalProperties: false }
+  )
+);
 var AppContract = defineDomain("app", {
   methods: {
     getInfo: {
@@ -11695,8 +12011,26 @@ var AppContract = defineDomain("app", {
     checkForUpdates: { args: typebox_exports.Tuple([]), result: typebox_exports.Void() },
     downloadUpdate: { args: typebox_exports.Tuple([]), result: typebox_exports.Void() },
     installUpdate: { args: typebox_exports.Tuple([]), result: typebox_exports.Void() },
+    checkResearchSkills: { args: typebox_exports.Tuple([]), result: typebox_exports.Void() },
     updateResearchSkills: { args: typebox_exports.Tuple([]), result: typebox_exports.Void() },
     restartForResearchSkills: { args: typebox_exports.Tuple([]), result: typebox_exports.Void() },
+    listSkillRepositories: { args: typebox_exports.Tuple([]), result: SkillRepositoryListSchema },
+    addSkillRepository: {
+      args: typebox_exports.Tuple([SkillRepositoryAddInputSchema]),
+      result: SkillRepositoryRecordSchema
+    },
+    checkSkillRepository: {
+      args: typebox_exports.Tuple([typebox_exports.String({ minLength: 1, maxLength: 64 })]),
+      result: SkillRepositoryCheckResultSchema
+    },
+    updateSkillRepository: {
+      args: typebox_exports.Tuple([typebox_exports.String({ minLength: 1, maxLength: 64 })]),
+      result: SkillRepositoryUpdateResultSchema
+    },
+    removeSkillRepository: {
+      args: typebox_exports.Tuple([typebox_exports.String({ minLength: 1, maxLength: 64 })]),
+      result: typebox_exports.Void()
+    },
     saveFileDialog: {
       args: typebox_exports.Tuple([typebox_exports.String(), typebox_exports.String()]),
       result: NullableString
@@ -11709,6 +12043,7 @@ var AppContract = defineDomain("app", {
       result: NullableString
     },
     pickDirectory: { args: typebox_exports.Tuple([]), result: NullableString },
+    formalKnowledgeVault: { args: typebox_exports.Tuple([]), result: NullableString },
     getGitBranch: { args: typebox_exports.Tuple([typebox_exports.String()]), result: NullableString },
     listGitBranches: { args: typebox_exports.Tuple([typebox_exports.String()]), result: GitBranchesSchema },
     checkoutBranch: { args: typebox_exports.Tuple([typebox_exports.String(), typebox_exports.String()]), result: typebox_exports.String() }
@@ -11786,6 +12121,7 @@ var OnboardingStepArgs = typebox_exports.Tuple([
 var ComputeContract = defineDomain("compute", {
   methods: {
     listHosts: { args: EmptyArgs, result: typebox_exports.Array(ComputeHostSchema, { maxItems: 256 }) },
+    listSshConfig: { args: EmptyArgs, result: typebox_exports.Array(ComputeSshConfigHostSchema, { maxItems: 256 }) },
     getHost: { args: IdArgs, result: typebox_exports.Union([ComputeHostSchema, typebox_exports.Null()]) },
     saveHost: { args: typebox_exports.Tuple([ComputeHostInputSchema]), result: ComputeHostSchema },
     removeHost: { args: IdArgs, result: typebox_exports.Void() },
@@ -12129,9 +12465,10 @@ var SpecialistSettingsInput = typebox_exports.Object(
 );
 var ZoteroStatusSchema = typebox_exports.Object(
   {
-    registered: typebox_exports.Boolean(),
-    enabled: typebox_exports.Boolean(),
+    registered: typebox_exports.Optional(typebox_exports.Boolean()),
+    enabled: typebox_exports.Optional(typebox_exports.Boolean()),
     command: typebox_exports.Union([typebox_exports.String(), typebox_exports.Null()]),
+    version: typebox_exports.Optional(typebox_exports.Union([typebox_exports.String(), typebox_exports.Null()])),
     localApiReachable: typebox_exports.Boolean(),
     desktopDetected: typebox_exports.Boolean(),
     desktopPath: typebox_exports.Union([typebox_exports.String(), typebox_exports.Null()]),
@@ -12327,6 +12664,13 @@ var KnowledgeContract = defineDomain("knowledge", {
       args: OneObject(),
       result: typebox_exports.Unknown()
     },
+    getMaintenanceSettings: { args: typebox_exports.Tuple([]), result: ResultObject() },
+    saveMaintenanceSettings: {
+      args: OneObject(),
+      result: ResultObject()
+    },
+    runMaintenance: { args: OneObject(), result: ResultObject() },
+    getMaintenanceRuns: { args: typebox_exports.Tuple([]), result: typebox_exports.Array(ResultObject()) },
     getZoteroStatus: {
       args: typebox_exports.Tuple([]),
       result: ZoteroStatusSchema
@@ -12558,6 +12902,60 @@ var ConfiguredPackageInfoSchema = typebox_exports.Object(
   },
   { additionalProperties: false }
 );
+var PackageLifecycleEventSchema = typebox_exports.Object(
+  {
+    type: typebox_exports.Union([
+      typebox_exports.Literal("staged"),
+      typebox_exports.Literal("verified"),
+      typebox_exports.Literal("enabled"),
+      typebox_exports.Literal("disabled"),
+      typebox_exports.Literal("drained"),
+      typebox_exports.Literal("reloaded"),
+      typebox_exports.Literal("reload_deferred"),
+      typebox_exports.Literal("rolled_back"),
+      typebox_exports.Literal("failed")
+    ]),
+    at: typebox_exports.Number({ minimum: 0 }),
+    sessionId: typebox_exports.Optional(typebox_exports.String({ minLength: 1 })),
+    detail: typebox_exports.Optional(typebox_exports.String())
+  },
+  { additionalProperties: false }
+);
+var PackageLifecycleErrorSchema = typebox_exports.Object(
+  {
+    code: typebox_exports.Union([
+      typebox_exports.Literal("invalid-source"),
+      typebox_exports.Literal("builtin"),
+      typebox_exports.Literal("not-installed"),
+      typebox_exports.Literal("unavailable"),
+      typebox_exports.Literal("operation-failed")
+    ]),
+    message: typebox_exports.String({ minLength: 1 }),
+    retryable: typebox_exports.Boolean()
+  },
+  { additionalProperties: false }
+);
+var PackageLifecycleReceiptSchema = typebox_exports.Object(
+  {
+    operation: typebox_exports.Union([typebox_exports.Literal("install"), typebox_exports.Literal("update"), typebox_exports.Literal("remove")]),
+    packageName: typebox_exports.String({ minLength: 1 }),
+    source: typebox_exports.String({ minLength: 1 }),
+    scope: typebox_exports.Union([typebox_exports.Literal("user"), typebox_exports.Literal("project")]),
+    status: typebox_exports.Union([typebox_exports.Literal("succeeded"), typebox_exports.Literal("failed")]),
+    effect: typebox_exports.Union([
+      typebox_exports.Literal("current-session"),
+      typebox_exports.Literal("next-session"),
+      typebox_exports.Literal("app-restart")
+    ]),
+    version: typebox_exports.Optional(typebox_exports.String({ minLength: 1 })),
+    previousVersion: typebox_exports.Optional(typebox_exports.String({ minLength: 1 })),
+    events: typebox_exports.Array(PackageLifecycleEventSchema),
+    error: typebox_exports.Optional(PackageLifecycleErrorSchema),
+    reloadedSessionIds: typebox_exports.Optional(typebox_exports.Array(typebox_exports.String({ minLength: 1 }))),
+    deferredSessionIds: typebox_exports.Optional(typebox_exports.Array(typebox_exports.String({ minLength: 1 })))
+  },
+  { additionalProperties: false }
+);
 var PackagesContract = defineDomain("packages", {
   methods: {
     searchCatalog: {
@@ -12566,16 +12964,25 @@ var PackagesContract = defineDomain("packages", {
       args: SearchCatalogArgsSchema,
       result: typebox_exports.Unsafe(CatalogSearchResultSchema)
     },
+    /** Latest published npm version per package name (null when unknown/offline). */
+    latestPackageVersions: {
+      args: typebox_exports.Tuple([typebox_exports.Array(typebox_exports.String({ minLength: 1 }), { maxItems: 50 })]),
+      result: typebox_exports.Record(typebox_exports.String(), typebox_exports.Union([typebox_exports.String(), typebox_exports.Null()]))
+    },
     installPackage: {
       args: typebox_exports.Tuple([typebox_exports.String({ minLength: 1 })]),
-      result: typebox_exports.Void()
+      result: typebox_exports.Unsafe(PackageLifecycleReceiptSchema)
+    },
+    updatePackage: {
+      args: typebox_exports.Tuple([typebox_exports.String({ minLength: 1 })]),
+      result: typebox_exports.Unsafe(PackageLifecycleReceiptSchema)
     },
     removePackage: {
       args: typebox_exports.Tuple([
         typebox_exports.String({ minLength: 1 }),
         typebox_exports.Union([typebox_exports.Literal("user"), typebox_exports.Literal("project")])
       ]),
-      result: typebox_exports.Void()
+      result: typebox_exports.Unsafe(PackageLifecycleReceiptSchema)
     },
     listConfiguredPackages: {
       args: typebox_exports.Tuple([]),
@@ -12892,6 +13299,10 @@ var SessionsContract = defineDomain("sessions", {
         { additionalProperties: false }
       )
     },
+    setSkillNamesEnabled: {
+      args: typebox_exports.Tuple([Id2, typebox_exports.Array(typebox_exports.String()), typebox_exports.Boolean()]),
+      result: typebox_exports.Object({ disabled: typebox_exports.Array(typebox_exports.String()) }, { additionalProperties: false })
+    },
     compact: {
       args: typebox_exports.Union([typebox_exports.Tuple([Id2]), typebox_exports.Tuple([Id2, typebox_exports.String()])]),
       result: typebox_exports.Void()
@@ -16954,12 +17365,12 @@ import { stat as stat2 } from "node:fs/promises";
 
 // src/path.ts
 import { homedir as homedir2 } from "node:os";
-import { isAbsolute as isAbsolute5, join, resolve as resolve6 } from "node:path";
+import { isAbsolute as isAbsolute5, join as join2, resolve as resolve6 } from "node:path";
 var UNICODE_SPACES = /[\u00A0\u1680\u2000-\u200A\u202F\u205F\u3000\uFEFF]/g;
 function resolveToolPath(rawPath, cwd, home = homedir2()) {
   let path = rawPath.replace(UNICODE_SPACES, " ");
   if (path === "~") path = home;
-  else if (path.startsWith("~/")) path = join(home, path.slice(2));
+  else if (path.startsWith("~/")) path = join2(home, path.slice(2));
   return isAbsolute5(path) ? path : resolve6(cwd, path);
 }
 
@@ -17020,13 +17431,13 @@ function makeDeliverFilesTool() {
 }
 
 // src/memory.ts
-import { mkdirSync, readdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
-import { join as join2 } from "node:path";
+import { mkdirSync, readdirSync, readFileSync as readFileSync2, renameSync, rmSync, writeFileSync } from "node:fs";
+import { join as join3 } from "node:path";
 var MEMORY_TYPES = ["user", "feedback", "project", "reference"];
 var MEMORY_INDEX = "MEMORY.md";
 var MAX_INDEX_LINES = 200;
 function memoryDir(cwd) {
-  return join2(cwd, ".pi", "memory");
+  return join3(cwd, ".pi", "memory");
 }
 function memorySlug(name) {
   const slug = name.trim().toLowerCase().replace(/[^\p{L}\p{N}]+/gu, "-").replace(/^-+|-+$/g, "").slice(0, 64);
@@ -17079,7 +17490,7 @@ function listMemories(cwd) {
   }
   const out = [];
   for (const file of files) {
-    const entry = parseMemory(readFileSync(join2(dir, file), "utf8"));
+    const entry = parseMemory(readFileSync2(join3(dir, file), "utf8"));
     if (entry) out.push({ ...entry, file });
   }
   return out;
@@ -17088,14 +17499,14 @@ function writeMemory(cwd, entry) {
   const dir = memoryDir(cwd);
   mkdirSync(dir, { recursive: true });
   const file = `${entry.type}_${memorySlug(entry.name)}.md`;
-  atomicWrite(join2(dir, file), serializeMemory(entry));
-  atomicWrite(join2(dir, MEMORY_INDEX), renderMemoryIndex(listMemories(cwd)));
+  atomicWrite(join3(dir, file), serializeMemory(entry));
+  atomicWrite(join3(dir, MEMORY_INDEX), renderMemoryIndex(listMemories(cwd)));
   return file;
 }
 function memoryIndexPrompt(cwd) {
   let index;
   try {
-    index = readFileSync(join2(memoryDir(cwd), MEMORY_INDEX), "utf8");
+    index = readFileSync2(join3(memoryDir(cwd), MEMORY_INDEX), "utf8");
   } catch {
     return [];
   }
@@ -17111,8 +17522,8 @@ ${shown.join("\n")}${lines.length > shown.length ? `
 function forgetMemory(cwd, file) {
   if (!/^[^\\/]+\.md$/.test(file) || file === MEMORY_INDEX) return false;
   if (!listMemories(cwd).some((e) => e.file === file)) return false;
-  rmSync(join2(memoryDir(cwd), file));
-  atomicWrite(join2(memoryDir(cwd), MEMORY_INDEX), renderMemoryIndex(listMemories(cwd)));
+  rmSync(join3(memoryDir(cwd), file));
+  atomicWrite(join3(memoryDir(cwd), MEMORY_INDEX), renderMemoryIndex(listMemories(cwd)));
   return true;
 }
 
@@ -17309,136 +17720,6 @@ ${formatTodoList(todos)}`;
   };
 }
 
-// src/drone-commands.ts
-import { readFileSync as readFileSync2 } from "node:fs";
-import { createRequire } from "node:module";
-import { dirname, join as join3 } from "node:path";
-var DRONE_COMMAND_SCHEMA_VERSION = 1;
-var PI_CORE_PACKAGE_VERSION = "0.1.1";
-var PI_HOST_RANGE = ">=1.1.0 <2.0.0";
-var CORE_TOOLS = [
-  "ask_user",
-  "set_status",
-  "todo",
-  "deliver_files",
-  "memory_save",
-  "task_plan",
-  "task_status",
-  "task_wait",
-  "task_reconcile",
-  "task_evidence_restore"
-];
-var EXAMPLE_TOOLS = [
-  "knowledge_status",
-  "knowledge_search",
-  "research_search_sources",
-  "research_read_source",
-  "research_answer_sources"
-];
-function packageVersion() {
-  const configured = process.env.PI_VERSION?.trim();
-  if (configured) return { version: configured, source: "PI_VERSION" };
-  try {
-    const require2 = createRequire(import.meta.url);
-    const entry = require2.resolve("@earendil-works/pi-coding-agent");
-    const packagePath = join3(dirname(entry), "..", "package.json");
-    const metadata = JSON.parse(readFileSync2(packagePath, "utf8"));
-    if (typeof metadata.version === "string" && metadata.version.length > 0)
-      return { version: metadata.version, source: "resolved-package" };
-  } catch {
-  }
-  return { version: null, source: "unavailable" };
-}
-function snapshot(pi) {
-  const tools = typeof pi?.getAllTools === "function" ? pi.getAllTools().map((tool) => String(tool?.name || "")).filter(Boolean) : typeof pi?.getActiveTools === "function" ? pi.getActiveTools().map((name) => String(name)).filter(Boolean) : [];
-  const commands = typeof pi?.getCommands === "function" ? pi.getCommands().map((command) => String(command?.name || "")).filter(Boolean) : [];
-  return { tools: [...new Set(tools)].sort(), commands: [...new Set(commands)].sort() };
-}
-function buildDoctorReport(pi, options = {}) {
-  const current = snapshot(pi);
-  const missingTools = CORE_TOOLS.filter((name) => !current.tools.includes(name));
-  const missingCommands = ["drone-doctor", "drone-example"].filter((name) => !current.commands.includes(name));
-  const resolved = options.hostVersion === void 0 ? packageVersion() : { version: options.hostVersion, source: "host-contract" };
-  const hostKind = options.hostKind || "native-pi";
-  const checks = [
-    {
-      id: "core-tools",
-      status: missingTools.length ? "blocked" : "pass",
-      detail: missingTools.length ? "pi-core tools are missing" : "all pi-core tools are registered",
-      ...missingTools.length ? { missing: missingTools } : {}
-    },
-    {
-      id: "drone-commands",
-      status: missingCommands.length ? "blocked" : "pass",
-      detail: missingCommands.length ? "Drone onboarding commands are missing" : "doctor and example commands are registered",
-      ...missingCommands.length ? { missing: missingCommands } : {}
-    },
-    {
-      id: "pi-host-version",
-      status: resolved.version ? "pass" : "unknown",
-      detail: resolved.version ? `resolved Pi host ${resolved.version}` : "Pi host version is not exposed by this host"
-    }
-  ];
-  const blocked = checks.some((check) => check.status === "blocked");
-  return {
-    schemaVersion: DRONE_COMMAND_SCHEMA_VERSION,
-    command: "drone-doctor",
-    status: blocked ? "blocked" : resolved.version ? "pass" : "unknown",
-    plugin: { name: "@gyoungwe/pi-core", version: PI_CORE_PACKAGE_VERSION, piRange: PI_HOST_RANGE },
-    host: { kind: hostKind, version: resolved.version || null, source: resolved.source },
-    checks,
-    commands: current.commands,
-    tools: current.tools,
-    next: blocked ? "\u5B89\u88C5\u6216\u91CD\u65B0\u52A0\u8F7D\u7F3A\u5931\u7684 Drone \u63D2\u4EF6\u540E\u91CD\u8BD5 /drone-doctor" : null
-  };
-}
-function buildExampleReport(pi, mode = "preview", question) {
-  const current = snapshot(pi);
-  const missingTools = EXAMPLE_TOOLS.filter((name) => !current.tools.includes(name));
-  const hasQuestion = Boolean(question?.trim());
-  const status2 = missingTools.length ? "blocked" : mode === "run" && hasQuestion ? "started" : hasQuestion ? "ready" : "needs-data";
-  return {
-    schemaVersion: DRONE_COMMAND_SCHEMA_VERSION,
-    command: "drone-example",
-    status: status2,
-    mode,
-    title: "Evidence-gated local research example",
-    steps: ["inspect local knowledge", "read at least two sources", "answer with source receipts"],
-    requiredTools: [...EXAMPLE_TOOLS],
-    missingTools: [...missingTools],
-    next: missingTools.length ? "\u5B89\u88C5\u5E76\u542F\u7528 pi-knowledge \u4E0E pi-research \u540E\u91CD\u8BD5 /drone-example" : hasQuestion ? mode === "run" ? "\u7814\u7A76\u56DE\u5408\u5DF2\u6392\u961F\uFF1B\u7B49\u5F85\u771F\u5B9E\u6765\u6E90\u56DE\u6267" : "\u8FD0\u884C /drone-example --run <\u7814\u7A76\u95EE\u9898> \u5F00\u59CB\u53EA\u8BFB\u793A\u4F8B" : "\u63D0\u4F9B\u4E00\u4E2A\u7814\u7A76\u95EE\u9898\uFF1A/drone-example --run <\u7814\u7A76\u95EE\u9898>",
-    ...hasQuestion ? { question: question?.trim() } : {}
-  };
-}
-function emitReport(report, ctx) {
-  const message = JSON.stringify(report);
-  if (ctx.mode === "print" || ctx.mode === "json") console.log(message);
-  else ctx.ui.notify(message, report.status === "blocked" ? "warning" : "info");
-}
-function registerDroneCommands(pi, options = {}) {
-  pi.registerCommand("drone-doctor", {
-    description: "Check the resolved Pi host, core tools and Drone command contract",
-    handler: async (_args, ctx) => emitReport(buildDoctorReport(pi, options), ctx)
-  });
-  pi.registerCommand("drone-example", {
-    description: "Preview or start a read-only evidence-gated research example",
-    handler: async (args, ctx) => {
-      const trimmed = args.trim();
-      const run = trimmed.startsWith("--run");
-      const question = run ? trimmed.slice("--run".length).trim() : trimmed;
-      const report = buildExampleReport(pi, run ? "run" : "preview", question || void 0);
-      if (run && report.status === "started" && typeof pi.sendUserMessage === "function") {
-        await pi.sendUserMessage(
-          `Run a read-only Drone research example for this question: ${question}
-Use local evidence first, read at least two sources, preserve source URIs and hashes, and report blocked/unknown states instead of guessing.`,
-          { deliverAs: "followUp", expandPromptTemplates: true }
-        );
-      }
-      emitReport(report, ctx);
-    }
-  });
-}
-
 // src/index.ts
 var DEFAULT_HOST_VERSION = "1.1.0";
 function createNativePiHostPort(ctx, hostVersion = DEFAULT_HOST_VERSION) {
@@ -17511,7 +17792,9 @@ function registerPiCore(pi, options = {}) {
     activeContext = void 0;
   });
   registerTaskRuntime(pi);
-  registerDroneCommands(pi, { hostKind: options.host?.host === "drone-desktop" ? "drone-desktop" : "native-pi" });
+  registerDroneCommands(pi, {
+    hostKind: options.host?.host === "drone-desktop" ? "drone-desktop" : "native-pi"
+  });
   const ask = options.ask || ((request, signal, context) => askWithNativeUi(request, signal, context || activeContext));
   pi.registerTool(makeAskUserTool({ ask }));
   pi.registerTool(makeStatusTool());
@@ -17543,6 +17826,7 @@ export {
   makeTodoTool,
   memoryIndexPrompt,
   normalizeTodos,
+  parseExampleArgs,
   registerDroneCommands,
   registerPiCore,
   writeMemory