@alashi/cli 0.1.0

package/dist/cli.d.mts

@@ -0,0 +1 @@
+export {}

package/dist/cli.mjs

@@ -0,0 +1,148 @@
+#!/usr/bin/env node
+import { a as installApp, c as addRegistry, d as removeRegistry, g as loadApp, i as resolveAppConfig, n as createServer, o as removeApp, s as updateApp, t as Store } from "./store-CwgDCAAx.mjs";
+import { APP_NAME_PATTERN, AppSdkError } from "@alashi/apps-sdk";
+import { mkdir, readFile, readdir, writeFile } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { serve } from "@hono/node-server";
+import { ClaudeCodeProvider } from "alashi-provider-claude";
+import { Command } from "commander";
+//#region src/create.ts
+const TEMPLATE_DIR = fileURLToPath(new URL("../templates/basic-app", import.meta.url));
+const RENAMES = { gitignore: ".gitignore" };
+/**
+* Scaffolds a new app from the basic-app template into targetDir,
+* substituting the app name. Returns the created files, relative to
+* targetDir. Refuses to write into a non-empty directory.
+*/
+async function scaffoldApp(name, targetDir) {
+	if (!APP_NAME_PATTERN.test(name)) throw new AppSdkError(`Invalid app name "${name}": use lowercase letters, digits, and hyphens (max 64 chars)`);
+	const existing = await readdir(targetDir).catch(() => void 0);
+	if (existing && existing.length > 0) throw new AppSdkError(`Directory is not empty: ${targetDir}`);
+	const written = [];
+	async function copyDir(rel) {
+		const entries = await readdir(join(TEMPLATE_DIR, rel), { withFileTypes: true });
+		await mkdir(join(targetDir, rel), { recursive: true });
+		for (const entry of entries) {
+			const relPath = join(rel, entry.name);
+			if (entry.isDirectory()) {
+				await copyDir(relPath);
+				continue;
+			}
+			const content = await readFile(join(TEMPLATE_DIR, relPath), "utf8");
+			const outPath = join(rel, RENAMES[entry.name] ?? entry.name);
+			await writeFile(join(targetDir, outPath), content.replaceAll("__APP_NAME__", name), "utf8");
+			written.push(outPath);
+		}
+	}
+	await copyDir("");
+	return written.sort();
+}
+//#endregion
+//#region src/cli.ts
+const program = new Command();
+const store = new Store();
+program.name("alashi").description("Install, manage, and run Claude Code-powered apps");
+async function serveDashboard(portArg) {
+	const config = await store.readGlobalConfig();
+	const port = portArg ? Number(portArg) : config.port ?? 4141;
+	if (!Number.isInteger(port) || port < 0 || port > 65535) throw new Error(`Invalid port: ${portArg}`);
+	const server = createServer(store, new ClaudeCodeProvider());
+	await server.scheduler.start();
+	const httpServer = serve({
+		fetch: server.app.fetch,
+		port
+	}, (info) => {
+		console.log(`alashi dashboard at http://localhost:${info.port}`);
+	});
+	const shutdown = () => {
+		httpServer.close();
+		server.close().finally(() => process.exit(0));
+	};
+	process.on("SIGINT", shutdown);
+	process.on("SIGTERM", shutdown);
+}
+program.command("serve", { isDefault: true }).option("-p, --port <port>", "port to listen on (default: config port or 4141)").description("Serve the web dashboard (the default when no command is given)").action(async (options) => serveDashboard(options.port));
+program.command("create").argument("<name>", "app name (lowercase letters, digits, hyphens)").argument("[directory]", "target directory (default: ./<name>)").description("Scaffold a new app from the basic template").action(async (name, directory) => {
+	const target = directory ?? name;
+	const files = await scaffoldApp(name, resolve(target));
+	console.log(`Created ${name}/`);
+	for (const file of files) console.log(`  ${file}`);
+	console.log("\nNext steps:");
+	console.log(`  cd ${target}`);
+	console.log("  npm install");
+	console.log("  alashi install .");
+	console.log("  alashi    # dashboard at http://localhost:4141");
+});
+program.command("install").argument("<source>", "app name (via registry), git URL, or local path").description("Install an app").action(async (source) => {
+	const record = await installApp(store, source);
+	console.log(`Installed ${record.name}@${record.version} (${record.source.type})`);
+	console.log(`  data:   ${store.appDataDir(record.name)}`);
+	console.log(`  config: ${store.appConfigPath(record.name)}`);
+	await printSetupHints(record.name);
+});
+/** After install: what still needs configuring, and which integrations exist. */
+async function printSetupHints(name) {
+	let manifest;
+	try {
+		({manifest} = await loadApp(store.appRepoDir(name)));
+	} catch {
+		return;
+	}
+	const { status } = await resolveAppConfig(store, manifest);
+	if (status.missing.length > 0) console.log(`  requires: ${status.missing.join(", ")}`);
+	const optional = status.integrations.filter((i) => i.optional && !i.configured);
+	if (optional.length > 0) {
+		const list = optional.map((i) => `${i.name} (needs ${i.missing.join(", ")})`).join(", ");
+		console.log(`  optional integrations: ${list}`);
+	}
+	if (status.missing.length > 0 || optional.length > 0) console.log(`  configure via the dashboard settings page or the config file above`);
+}
+program.command("update").argument("<name>", "installed app name").description("Update an installed app").action(async (name) => {
+	const record = await updateApp(store, name);
+	console.log(`Updated ${record.name} to ${record.version}`);
+});
+program.command("remove").argument("<name>", "installed app name").option("--purge", "also delete the app data and config").description("Remove an installed app (keeps data unless --purge)").action(async (name, options) => {
+	await removeApp(store, name, { purge: options.purge ?? false });
+	console.log(options.purge ? `Removed ${name} (purged)` : `Removed ${name} (data kept)`);
+});
+program.command("list").option("--json", "machine-readable output").description("List installed apps").action(async (options) => {
+	const records = await store.listInstalled();
+	if (options.json) {
+		console.log(JSON.stringify(records, null, 2));
+		return;
+	}
+	if (records.length === 0) {
+		console.log("No apps installed. Try: alashi install <name|git-url|path>");
+		return;
+	}
+	for (const record of records) {
+		const origin = record.source.type === "git" ? record.source.url : record.source.path;
+		console.log(`${record.name}@${record.version}  ${record.source.type}  ${origin}`);
+	}
+});
+const registry = program.command("registry").description("Manage app registries");
+registry.command("add").argument("<name>", "registry name").argument("<url>", "index.json URL or git repo URL").action(async (name, url) => {
+	const index = await addRegistry(store, name, url);
+	console.log(`Added registry "${name}" (${index.apps.length} apps)`);
+});
+registry.command("remove").argument("<name>", "registry name").action(async (name) => {
+	await removeRegistry(store, name);
+	console.log(`Removed registry "${name}"`);
+});
+registry.command("list").action(async () => {
+	const config = await store.readGlobalConfig();
+	if (config.registries.length === 0) {
+		console.log("No registries configured.");
+		return;
+	}
+	for (const r of config.registries) console.log(`${r.name}  ${r.url}`);
+});
+program.parseAsync().catch((err) => {
+	console.error(err instanceof Error ? err.message : err);
+	process.exitCode = 1;
+});
+//#endregion
+export {};
+
+//# sourceMappingURL=cli.mjs.map

package/dist/cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.mjs","names":[],"sources":["../src/create.ts","../src/cli.ts"],"sourcesContent":["import { mkdir, readdir, readFile, writeFile } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { APP_NAME_PATTERN, AppSdkError } from '@alashi/apps-sdk';\n\n// Works from both src/ (tests) and dist/ (published build) — the templates\n// dir sits one level up in the package root either way.\nconst TEMPLATE_DIR = fileURLToPath(new URL('../templates/basic-app', import.meta.url));\n\n// npm strips .gitignore from published packages, so it ships unprefixed.\nconst RENAMES: Record<string, string> = { gitignore: '.gitignore' };\n\n/**\n * Scaffolds a new app from the basic-app template into targetDir,\n * substituting the app name. Returns the created files, relative to\n * targetDir. Refuses to write into a non-empty directory.\n */\nexport async function scaffoldApp(name: string, targetDir: string): Promise<string[]> {\n  if (!APP_NAME_PATTERN.test(name)) {\n    throw new AppSdkError(\n      `Invalid app name \"${name}\": use lowercase letters, digits, and hyphens (max 64 chars)`,\n    );\n  }\n  const existing = await readdir(targetDir).catch(() => undefined);\n  if (existing && existing.length > 0) {\n    throw new AppSdkError(`Directory is not empty: ${targetDir}`);\n  }\n\n  const written: string[] = [];\n  async function copyDir(rel: string): Promise<void> {\n    const entries = await readdir(join(TEMPLATE_DIR, rel), { withFileTypes: true });\n    await mkdir(join(targetDir, rel), { recursive: true });\n    for (const entry of entries) {\n      const relPath = join(rel, entry.name);\n      if (entry.isDirectory()) {\n        await copyDir(relPath);\n        continue;\n      }\n      const content = await readFile(join(TEMPLATE_DIR, relPath), 'utf8');\n      const outPath = join(rel, RENAMES[entry.name] ?? entry.name);\n      await writeFile(join(targetDir, outPath), content.replaceAll('__APP_NAME__', name), 'utf8');\n      written.push(outPath);\n    }\n  }\n  await copyDir('');\n  return written.sort();\n}\n","#!/usr/bin/env node\nimport { resolve } from 'node:path';\nimport { serve } from '@hono/node-server';\nimport { ClaudeCodeProvider } from 'alashi-provider-claude';\nimport { Command } from 'commander';\nimport { scaffoldApp } from './create.js';\nimport { installApp, removeApp, updateApp } from './installer.js';\nimport { loadApp } from './loader.js';\nimport { addRegistry, removeRegistry } from './registry.js';\nimport { resolveAppConfig } from './runtime.js';\nimport { createServer } from './server.js';\nimport { Store } from './store.js';\n\nconst program = new Command();\nconst store = new Store();\n\nprogram.name('alashi').description('Install, manage, and run Claude Code-powered apps');\n\nasync function serveDashboard(portArg?: string): Promise<void> {\n  const config = await store.readGlobalConfig();\n  const port = portArg ? Number(portArg) : (config.port ?? 4141);\n  if (!Number.isInteger(port) || port < 0 || port > 65535) {\n    throw new Error(`Invalid port: ${portArg}`);\n  }\n  const server = createServer(store, new ClaudeCodeProvider());\n  await server.scheduler.start();\n  const httpServer = serve({ fetch: server.app.fetch, port }, (info) => {\n    console.log(`alashi dashboard at http://localhost:${info.port}`);\n  });\n  const shutdown = (): void => {\n    httpServer.close();\n    void server.close().finally(() => process.exit(0));\n  };\n  process.on('SIGINT', shutdown);\n  process.on('SIGTERM', shutdown);\n}\n\nprogram\n  .command('serve', { isDefault: true })\n  .option('-p, --port <port>', 'port to listen on (default: config port or 4141)')\n  .description('Serve the web dashboard (the default when no command is given)')\n  .action(async (options: { port?: string }) => serveDashboard(options.port));\n\nprogram\n  .command('create')\n  .argument('<name>', 'app name (lowercase letters, digits, hyphens)')\n  .argument('[directory]', 'target directory (default: ./<name>)')\n  .description('Scaffold a new app from the basic template')\n  .action(async (name: string, directory?: string) => {\n    const target = directory ?? name;\n    const files = await scaffoldApp(name, resolve(target));\n    console.log(`Created ${name}/`);\n    for (const file of files) console.log(`  ${file}`);\n    console.log('\\nNext steps:');\n    console.log(`  cd ${target}`);\n    console.log('  npm install');\n    console.log('  alashi install .');\n    console.log('  alashi    # dashboard at http://localhost:4141');\n  });\n\nprogram\n  .command('install')\n  .argument('<source>', 'app name (via registry), git URL, or local path')\n  .description('Install an app')\n  .action(async (source: string) => {\n    const record = await installApp(store, source);\n    console.log(`Installed ${record.name}@${record.version} (${record.source.type})`);\n    console.log(`  data:   ${store.appDataDir(record.name)}`);\n    console.log(`  config: ${store.appConfigPath(record.name)}`);\n    await printSetupHints(record.name);\n  });\n\n/** After install: what still needs configuring, and which integrations exist. */\nasync function printSetupHints(name: string): Promise<void> {\n  let manifest: Awaited<ReturnType<typeof loadApp>>['manifest'];\n  try {\n    ({ manifest } = await loadApp(store.appRepoDir(name)));\n  } catch {\n    return; // install already succeeded; hints are best-effort\n  }\n  const { status } = await resolveAppConfig(store, manifest);\n  if (status.missing.length > 0) {\n    console.log(`  requires: ${status.missing.join(', ')}`);\n  }\n  const optional = status.integrations.filter((i) => i.optional && !i.configured);\n  if (optional.length > 0) {\n    const list = optional.map((i) => `${i.name} (needs ${i.missing.join(', ')})`).join(', ');\n    console.log(`  optional integrations: ${list}`);\n  }\n  if (status.missing.length > 0 || optional.length > 0) {\n    console.log(`  configure via the dashboard settings page or the config file above`);\n  }\n}\n\nprogram\n  .command('update')\n  .argument('<name>', 'installed app name')\n  .description('Update an installed app')\n  .action(async (name: string) => {\n    const record = await updateApp(store, name);\n    console.log(`Updated ${record.name} to ${record.version}`);\n  });\n\nprogram\n  .command('remove')\n  .argument('<name>', 'installed app name')\n  .option('--purge', 'also delete the app data and config')\n  .description('Remove an installed app (keeps data unless --purge)')\n  .action(async (name: string, options: { purge?: boolean }) => {\n    await removeApp(store, name, { purge: options.purge ?? false });\n    console.log(options.purge ? `Removed ${name} (purged)` : `Removed ${name} (data kept)`);\n  });\n\nprogram\n  .command('list')\n  .option('--json', 'machine-readable output')\n  .description('List installed apps')\n  .action(async (options: { json?: boolean }) => {\n    const records = await store.listInstalled();\n    if (options.json) {\n      console.log(JSON.stringify(records, null, 2));\n      return;\n    }\n    if (records.length === 0) {\n      console.log('No apps installed. Try: alashi install <name|git-url|path>');\n      return;\n    }\n    for (const record of records) {\n      const origin = record.source.type === 'git' ? record.source.url : record.source.path;\n      console.log(`${record.name}@${record.version}  ${record.source.type}  ${origin}`);\n    }\n  });\n\nconst registry = program.command('registry').description('Manage app registries');\n\nregistry\n  .command('add')\n  .argument('<name>', 'registry name')\n  .argument('<url>', 'index.json URL or git repo URL')\n  .action(async (name: string, url: string) => {\n    const index = await addRegistry(store, name, url);\n    console.log(`Added registry \"${name}\" (${index.apps.length} apps)`);\n  });\n\nregistry\n  .command('remove')\n  .argument('<name>', 'registry name')\n  .action(async (name: string) => {\n    await removeRegistry(store, name);\n    console.log(`Removed registry \"${name}\"`);\n  });\n\nregistry.command('list').action(async () => {\n  const config = await store.readGlobalConfig();\n  if (config.registries.length === 0) {\n    console.log('No registries configured.');\n    return;\n  }\n  for (const r of config.registries) console.log(`${r.name}  ${r.url}`);\n});\n\nprogram.parseAsync().catch((err: unknown) => {\n  console.error(err instanceof Error ? err.message : err);\n  process.exitCode = 1;\n});\n"],"mappings":"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"}

package/dist/index.d.mts

@@ -0,0 +1,256 @@
+import { AIProvider, AppContext, AppDefinition, AppManifest, ConfigObject } from "@alashi/apps-sdk";
+import { Hono } from "hono";
+//#region src/compat.d.ts
+/**
+ * Enforces the manifest's declared `sdkVersion` range against the SDK
+ * this host is built with. Apps that declare nothing are accepted.
+ */
+declare function checkSdkCompatibility(manifest: AppManifest): void;
+//#endregion
+//#region src/sources.d.ts
+type AppSourceSpec = {
+  type: "git";
+  url: string;
+  ref?: string;
+} | {
+  type: "local";
+  path: string;
+};
+/** How the CLI argument was understood: a source, or a name to resolve via registries. */
+type SourceArg = AppSourceSpec | {
+  type: "registry";
+  name: string;
+};
+declare function parseSourceArg(arg: string): SourceArg;
+/** Materializes a source at destDir: git clone, or symlink for local dev installs. */
+declare function fetchSource(spec: AppSourceSpec, destDir: string): Promise<void>;
+/** Brings an installed source up to date in place. Local symlinks are always live. */
+declare function updateSource(spec: AppSourceSpec, repoDir: string): Promise<void>;
+//#endregion
+//#region src/store.d.ts
+interface RegistryRef {
+  name: string;
+  url: string;
+}
+interface GlobalConfig {
+  registries: RegistryRef[];
+  port?: number;
+  /** Per-app global overrides, keyed by app name (middle config layer). */
+  apps?: Record<string, ConfigObject>;
+}
+interface Conversation {
+  id: string;
+  /** Provider session backing this conversation; set after the first turn. */
+  sessionId?: string;
+  title?: string;
+  updatedAt: string;
+}
+/** Host-side chat state for an app; the transcripts themselves live with the AI provider. */
+interface ChatState {
+  conversations: Conversation[];
+}
+interface JobRun {
+  job: string;
+  trigger: "schedule" | "catchup" | "manual";
+  startedAt: string;
+  finishedAt: string;
+  ok: boolean;
+  error?: string;
+}
+/** Host-side job state for an app: last run start per job plus a capped run log. */
+interface JobState {
+  lastRun: Record<string, string>;
+  runs: JobRun[];
+}
+interface InstallRecord {
+  name: string;
+  version: string;
+  /** The SDK range the app's manifest declared at install/update time. */
+  sdkVersion?: string;
+  source: AppSourceSpec;
+  installedAt: string;
+  updatedAt: string;
+}
+/**
+ * The portable state directory ($ALASHI_HOME, default ~/.alashi).
+ * Everything the host knows lives under this root so it can be moved
+ * between machines as a unit.
+ */
+declare class Store {
+  readonly root: string;
+  constructor(root?: string);
+  get configPath(): string;
+  get appsDir(): string;
+  get registriesDir(): string;
+  get stagingDir(): string;
+  /** Validates the name before using it in a path (traversal guard). */
+  appDir(name: string): string;
+  appRepoDir(name: string): string;
+  appDataDir(name: string): string;
+  appConfigPath(name: string): string;
+  appRecordPath(name: string): string;
+  appChatStatePath(name: string): string;
+  appJobStatePath(name: string): string;
+  registryCachePath(name: string): string;
+  readGlobalConfig(): Promise<GlobalConfig>;
+  writeGlobalConfig(config: GlobalConfig): Promise<void>;
+  readAppRecord(name: string): Promise<InstallRecord | undefined>;
+  writeAppRecord(record: InstallRecord): Promise<void>;
+  readAppConfig(name: string): Promise<ConfigObject>;
+  writeAppConfig(name: string, config: ConfigObject): Promise<void>;
+  readChatState(name: string): Promise<ChatState>;
+  writeChatState(name: string, state: ChatState): Promise<void>;
+  readJobState(name: string): Promise<JobState>;
+  writeJobState(name: string, state: JobState): Promise<void>;
+  listInstalled(): Promise<InstallRecord[]>;
+}
+//#endregion
+//#region src/installer.d.ts
+interface InstallOptions {
+  /** Expected app name (enforced against the manifest when set). */
+  expectName?: string;
+}
+/**
+ * Install flow: materialize the source into a staging dir, install deps
+ * (scripts disabled), import + validate the manifest, and only then move
+ * it into apps/<name>/repo. A failed validation never leaves a broken app.
+ */
+declare function installApp(store: Store, source: string | AppSourceSpec, options?: InstallOptions): Promise<InstallRecord>;
+declare function updateApp(store: Store, name: string): Promise<InstallRecord>;
+interface RemoveOptions {
+  /** Also delete the app's data/ and config (default keeps them). */
+  purge?: boolean;
+}
+declare function removeApp(store: Store, name: string, options?: RemoveOptions): Promise<void>;
+//#endregion
+//#region src/loader.d.ts
+interface LoadedApp {
+  definition: AppDefinition;
+  manifest: AppManifest;
+  entryPath: string;
+}
+/**
+ * Imports an app's entry module and validates its default export.
+ * The manifest is always re-validated here — the host never trusts
+ * that an app used defineApp().
+ */
+declare function loadApp(repoDir: string): Promise<LoadedApp>;
+//#endregion
+//#region src/registry.d.ts
+interface RegistryApp {
+  name: string;
+  repo: string;
+  description?: string;
+  ref?: string;
+  sdkVersion?: string;
+}
+interface RegistryIndex {
+  apps: RegistryApp[];
+}
+/**
+ * Fetches a registry index and caches it under registries/<name>.json.
+ * URLs ending in .json are fetched over HTTP; anything else is treated
+ * as a git repo containing index.json at its root (brew-tap style).
+ */
+declare function refreshRegistry(store: Store, registry: RegistryRef): Promise<RegistryIndex>;
+declare function readCachedIndex(store: Store, name: string): Promise<RegistryIndex | undefined>;
+declare function addRegistry(store: Store, name: string, url: string): Promise<RegistryIndex>;
+declare function removeRegistry(store: Store, name: string): Promise<void>;
+interface ResolvedApp {
+  registry: string;
+  app: RegistryApp;
+}
+/** Finds an app by name across configured registries (refreshing caches). */
+declare function resolveApp(store: Store, appName: string): Promise<ResolvedApp>;
+//#endregion
+//#region src/runtime.d.ts
+/**
+ * Builds the AppContext for an installed app: merges the config layers
+ * (manifest defaults < global apps[name] < per-app config), resolves
+ * `${config.*}` placeholders (with `dataDir` available as a built-in key),
+ * and scopes the AI provider to the app's manifest.
+ *
+ * Setup state shapes the session defaults: unconfigured MCP servers are
+ * dropped (with their tools) so interpolation never hits a missing key, and
+ * while required keys are missing the scoped provider fails closed.
+ */
+declare function buildAppContext(store: Store, manifest: AppManifest, provider: AIProvider): Promise<AppContext>;
+//#endregion
+//#region src/scheduler.d.ts
+interface SchedulableApp {
+  manifest: AppManifest;
+  ctx: AppContext;
+  jobHandlers?: Record<string, (ctx: AppContext) => Promise<void>>;
+}
+interface JobStatus {
+  name: string;
+  schedule: string;
+  description?: string;
+  /** False when the cron expression failed to parse (job never fires). */
+  valid: boolean;
+  running: boolean;
+  nextRun?: string;
+  lastRun?: string;
+  recentRuns: JobRun[];
+}
+/**
+ * Runs manifest-declared jobs on their cron schedules. One instance per host
+ * process; start() schedules every installed app's jobs, stop() cancels them.
+ * A job missed while the host was down runs once at startup ("catchup"), but
+ * only if it has run before — a fresh install waits for its first slot.
+ */
+declare class Scheduler {
+  private readonly store;
+  private readonly getApp;
+  private crons;
+  private runningJobs;
+  private started;
+  /** Serializes jobs.json read-modify-write across concurrently finishing jobs. */
+  private stateQueue;
+  constructor(store: Store, getApp: (name: string) => Promise<SchedulableApp | undefined>);
+  start(): Promise<void>;
+  stop(): void;
+  /**
+   * Runs one job immediately. Returns the recorded run, 'skipped' when that
+   * job is already mid-run, or undefined when the app/job doesn't exist.
+   */
+  run(appName: string, jobName: string, trigger?: JobRun["trigger"]): Promise<JobRun | "skipped" | undefined>;
+  /** Job statuses for an app, or undefined when the app isn't installed. */
+  status(appName: string): Promise<JobStatus[] | undefined>;
+  private recordRun;
+}
+//#endregion
+//#region src/server.d.ts
+interface AppServer {
+  /** The Hono app — pass its fetch to a Node server or call request() in tests. */
+  app: Hono;
+  /** Cron scheduler for manifest-declared jobs; call start() to begin firing. */
+  scheduler: Scheduler;
+  /** Stops the scheduler and closes all warm AI sessions. */
+  close(): Promise<void>;
+}
+/**
+ * The host HTTP surface:
+ *   GET  /                      dashboard of installed apps
+ *   GET  /settings/:name        per-app settings page (config form)
+ *   GET  /api/apps              installed apps as JSON
+ *   POST /api/apps/:name/chat   { message, conversationId? } -> SSE stream of AgentEvents
+ *                               (omit conversationId to start a new conversation; the
+ *                                id is echoed in the x-conversation-id response header)
+ *   GET  /api/apps/:name/chat/conversations          conversations, most recent first
+ *   GET  /api/apps/:name/chat/:conversationId/history  past turns from the provider transcript
+ *   GET  /api/apps/:name/jobs           manifest-declared jobs with schedule/status
+ *   POST /api/apps/:name/jobs/:job/run  trigger a job now (409 while already running)
+ *   GET  /api/apps/:name/config         declared config schema + merged values
+ *                                       (secrets masked) + readiness/integrations
+ *   PUT  /api/apps/:name/config         merge keys into the per-app config layer
+ *                                       (null deletes a key) and restart the app
+ *   ALL  /app/:name/api/*       dispatched to the app's fetch handler (prefix stripped)
+ *   ALL  /app/:name/*           a matching static file from the app's ui dir wins,
+ *                               otherwise the app's fetch handler (/app/:name stripped),
+ *                               otherwise 404
+ */
+declare function createServer(store: Store, provider: AIProvider): AppServer;
+//#endregion
+export { type AppServer, type AppSourceSpec, type GlobalConfig, type InstallOptions, type InstallRecord, type LoadedApp, type RegistryApp, type RegistryIndex, type RegistryRef, type RemoveOptions, type ResolvedApp, type SourceArg, Store, addRegistry, buildAppContext, checkSdkCompatibility, createServer, fetchSource, installApp, loadApp, parseSourceArg, readCachedIndex, refreshRegistry, removeApp, removeRegistry, resolveApp, updateApp, updateSource };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/compat.ts","../src/sources.ts","../src/store.ts","../src/installer.ts","../src/loader.ts","../src/registry.ts","../src/runtime.ts","../src/scheduler.ts","../src/server.ts"],"mappings":";;;;;;;iBAOgB,sBAAsB,UAAU;;;KCCpC;EACN;EAAa;EAAa;;EAC1B;EAAe;;;KAGT,YAAY;EAAkB;EAAkB;;iBAE5C,eAAe,cAAc;;iBAwBvB,YAAY,MAAM,eAAe,kBAAkB;;iBAanD,aAAa,MAAM,eAAe,kBAAkB;;;UC9CzD;EACf;EACA;;UAGe;EACf,YAAY;EACZ;;EAEA,OAAO,eAAe;;UAGP;EACf;;EAEA;EACA;EACA;;;UAIe;EACf,eAAe;;UAGA;EACf;EACA;EACA;EACA;EACA;EACA;;;UAIe;EACf,SAAS;EACT,MAAM;;UAGS;EACf;EACA;;EAEA;EACA,QAAQ;EACR;EACA;;;;;;;cAwBW;WACF;EAET,YAAY;MAIR;MAIA;MAIA;MAIA;;EAKJ,OAAO;EAOP,WAAW;EAIX,WAAW;EAIX,cAAc;EAId,cAAc;EAId,iBAAiB;EAIjB,gBAAgB;EAIhB,kBAAkB;EAOlB,oBAA0B,QAAQ;EAIlC,kBAAwB,QAAQ,eAAe;EAI/C,cAAoB,eAAe,QAAQ;EAI3C,eAAqB,QAAQ,gBAAgB;EAI7C,cAAoB,eAAe,QAAQ;EAI3C,eAAqB,cAAc,QAAQ,eAAe;EAI1D,cAAoB,eAAe,QAAQ;EAK3C,eAAqB,cAAc,OAAO,YAAY;EAItD,aAAmB,eAAe,QAAQ;EAK1C,cAAoB,cAAc,OAAO,WAAW;EAIpD,iBAAuB,QAAQ;;;;UC5IhB;;EAEf;;;;;;;iBAQoB,WACpB,OAAO,OACP,iBAAiB,eACjB,UAAS,iBACR,QAAQ;iBA0EW,UAAU,OAAO,OAAO,eAAe,QAAQ;UAuBpD;;EAEf;;iBAGoB,UACpB,OAAO,OACP,cACA,UAAS,gBACR;;;UCzIc;EACf,YAAY;EACZ,UAAU;EACV;;;;;;;iBAQoB,QAAQ,kBAAkB,QAAQ;;;UC5BvC;EACf;EACA;EACA;EACA;EACA;;UAGe;EACf,MAAM;;;;;;;iBAkCc,gBAAgB,OAAO,OAAO,UAAU,cAAc,QAAQ;iBAuB9D,gBACpB,OAAO,OACP,eACC,QAAQ;iBASW,YAAY,OAAO,OAAO,cAAc,cAAc,QAAQ;iBAW9D,eAAe,OAAO,OAAO,eAAe;UAWjD;EACf;EACA,KAAK;;;iBAIe,WAAW,OAAO,OAAO,kBAAkB,QAAQ;;;;;;;;;;;;;iBCFnD,gBACpB,OAAO,OACP,UAAU,aACV,UAAU,aACT,QAAQ;;;UC/GM;EACf,UAAU;EACV,KAAK;EACL,cAAc,gBAAgB,KAAK,eAAe;;UAGnC;EACf;EACA;EACA;;EAEA;EACA;EACA;EACA;EACA,YAAY;;;;;;;;cAiBD;mBAQT;mBACA;UARM;UACA;UACA;;UAEA;EAER,YACE,OAAwB,OACxB,SAA0B,iBAAiB,QAAQ;EAGrD,SAAe;EAuCf;;;;;EAUA,IACE,iBACA,iBACA,UAAS,oBACR,QAAQ;;EAmCX,OAAa,kBAAkB,QAAQ;UA4B/B;;;;UCtHO;;EAEf,KAAK;;EAEL,WAAW;;EAEX,SAAS;;;;;;;;;;;;;;;;;;;;;;;iBAwBK,aAAa,OAAO,OAAO,UAAU,aAAa"}

package/dist/index.mjs

@@ -0,0 +1,2 @@
+import { _ as checkSdkCompatibility, a as installApp, c as addRegistry, d as removeRegistry, f as resolveApp, g as loadApp, h as updateSource, l as readCachedIndex, m as parseSourceArg, n as createServer, o as removeApp, p as fetchSource, r as buildAppContext, s as updateApp, t as Store, u as refreshRegistry } from "./store-CwgDCAAx.mjs";
+export { Store, addRegistry, buildAppContext, checkSdkCompatibility, createServer, fetchSource, installApp, loadApp, parseSourceArg, readCachedIndex, refreshRegistry, removeApp, removeRegistry, resolveApp, updateApp, updateSource };