@seed-app-studio/cli 0.1.1-canary.0

package/dist/index.d.mts

@@ -0,0 +1,139 @@
+import { SeedAppValidationIssue } from "@seed-app-studio/protocol";
+//#region src/types.d.ts
+type SeedAppCliCommand = "init" | "validate" | "package" | "example" | "inspect-archive";
+type SeedAppInitOptions = {
+  rootDir: string;
+  appId: string;
+  appName: string;
+  devUrl: string;
+  sdkDependency?: string;
+  force?: boolean;
+};
+type SeedAppValidationOptions = {
+  rootDir: string;
+  manifestPath?: string;
+  bundlePath?: string;
+  gatewayChecksum?: string;
+};
+type SeedAppPackageOptions = SeedAppValidationOptions & {
+  outFile?: string;
+};
+type SeedAppPackageArchiveSummary = {
+  outFile: string;
+  files: string[];
+};
+type SeedAppPackageArchiveInspection = {
+  ok: boolean;
+  archiveFile: string;
+  files: string[];
+  manifestPath?: string;
+  bundlePath?: string;
+  reportPath?: string;
+  appId?: string;
+  version?: string;
+  assetCount: number;
+  expectedText?: string;
+  expectedTextFound?: boolean;
+  issues: SeedAppValidationIssue[];
+};
+type SeedAppPackageCliReport = SeedAppIntegrityReport & {
+  packageArchive?: SeedAppPackageArchiveSummary;
+};
+type SeedAppExampleOptions = {
+  outFile?: string;
+  sdkDependency?: string;
+  cliDependency?: string;
+};
+type SeedAppAssetReport = {
+  path: string;
+  expectedSha256: string;
+  actualSha256?: string;
+  expectedSize: number;
+  actualSize?: number;
+  ok: boolean;
+};
+type SeedAppIntegrityReport = {
+  ok: boolean;
+  appId?: string;
+  version?: string;
+  entryHtml?: string;
+  entryIntegrity?: string;
+  computedBundleChecksum?: string;
+  manifestPath: string;
+  bundlePath: string;
+  assets: SeedAppAssetReport[];
+  issues: SeedAppValidationIssue[];
+};
+type SeedAppCliResult = {
+  exitCode: number;
+  stdout: string;
+  stderr: string;
+};
+//#endregion
+//#region src/commands.d.ts
+type SeedAppCliInvocation = {
+  command: SeedAppCliCommand | "help";
+  rootDir: string;
+  appId?: string;
+  appName?: string;
+  devUrl?: string;
+  manifestPath?: string;
+  bundlePath?: string;
+  gatewayChecksum?: string;
+  outFile?: string;
+  zipFile?: string;
+  expectedText?: string;
+  sdkDependency?: string;
+  cliDependency?: string;
+  force: boolean;
+  json: boolean;
+};
+declare function parseSeedAppCliArgs(args: string[], cwd?: string): SeedAppCliInvocation;
+declare function runSeedAppCli(invocation: SeedAppCliInvocation): Promise<SeedAppCliResult>;
+//#endregion
+//#region src/scaffold.d.ts
+type SeedAppInitResult = {
+  rootDir: string;
+  files: string[];
+};
+declare function initSeedAppProject(options: SeedAppInitOptions): Promise<SeedAppInitResult>;
+//#endregion
+//#region src/exampleArchive.d.ts
+type SeedAppExampleArchiveOptions = {
+  outFile?: string;
+  sdkDependency?: string;
+  cliDependency?: string;
+};
+type SeedAppExampleArchiveResult = {
+  exampleId: "react-spa-stories";
+  outFile: string;
+  files: string[];
+};
+declare function writeSeedAppExampleArchive(options?: SeedAppExampleArchiveOptions): Promise<SeedAppExampleArchiveResult>;
+//#endregion
+//#region src/packageArchive.d.ts
+type SeedAppPackageArchiveOptions = {
+  rootDir: string;
+  zipFile: string;
+  manifestPath?: string;
+  bundlePath?: string;
+  reportPath?: string;
+  report: SeedAppIntegrityReport;
+};
+type SeedAppPackageArchiveResult = {
+  outFile: string;
+  files: string[];
+};
+type SeedAppPackageArchiveInspectOptions = {
+  rootDir: string;
+  zipFile: string;
+  expectedText?: string;
+};
+declare function writeSeedAppPackageArchive(options: SeedAppPackageArchiveOptions): Promise<SeedAppPackageArchiveResult>;
+declare function inspectSeedAppPackageArchive(options: SeedAppPackageArchiveInspectOptions): Promise<SeedAppPackageArchiveInspection>;
+//#endregion
+//#region src/validator.d.ts
+declare function validateSeedAppPackage(options: SeedAppValidationOptions): Promise<SeedAppIntegrityReport>;
+declare function writeSeedAppPackageReport(options: SeedAppPackageOptions): Promise<SeedAppIntegrityReport>;
+//#endregion
+export { type SeedAppAssetReport, type SeedAppCliCommand, type SeedAppCliInvocation, type SeedAppCliResult, type SeedAppExampleArchiveResult, type SeedAppExampleOptions, type SeedAppInitOptions, type SeedAppInitResult, type SeedAppIntegrityReport, type SeedAppPackageArchiveInspectOptions, type SeedAppPackageArchiveInspection, type SeedAppPackageArchiveResult, type SeedAppPackageArchiveSummary, type SeedAppPackageCliReport, type SeedAppPackageOptions, type SeedAppValidationOptions, initSeedAppProject, inspectSeedAppPackageArchive, parseSeedAppCliArgs, runSeedAppCli, validateSeedAppPackage, writeSeedAppExampleArchive, writeSeedAppPackageArchive, writeSeedAppPackageReport };

package/dist/index.mjs

@@ -0,0 +1,2 @@
+import { a as inspectSeedAppPackageArchive, c as initSeedAppProject, i as writeSeedAppPackageReport, n as runSeedAppCli, o as writeSeedAppPackageArchive, r as validateSeedAppPackage, s as writeSeedAppExampleArchive, t as parseSeedAppCliArgs } from "./commands-TM-KX_MV.mjs";
+export { initSeedAppProject, inspectSeedAppPackageArchive, parseSeedAppCliArgs, runSeedAppCli, validateSeedAppPackage, writeSeedAppExampleArchive, writeSeedAppPackageArchive, writeSeedAppPackageReport };

package/examples/react-spa-stories/README.md

@@ -0,0 +1,44 @@
+# SEED React SPA Stories
+
+This example is the acceptance app for SEED App Host development. It is a plain React + Vite SPA that can be loaded by App Studio through `http://localhost:5173`.
+
+## Run
+
+```bash
+pnpm install
+pnpm dev
+```
+
+Then open SEED App Studio and register:
+
+- App ID: `seed.react-spa-stories`
+- Root directory: this folder
+- Dev URL: `http://localhost:5173`
+- Manifest path: `seed-app.json`
+
+## Before npm publish
+
+If `@seed-app-studio/sdk` or `@seed-app-studio/cli` is not published yet, pack local tarballs first and generate the example with explicit dependency sources:
+
+```bash
+pnpm --dir packages/seed-runtime-state/app-sdk pack --pack-destination /tmp/seed-app-deps
+pnpm --dir packages/seed-runtime-state/app-cli pack --pack-destination /tmp/seed-app-deps
+seed-app example \
+  --sdk-dependency file:/tmp/seed-app-deps/seed-app-sdk-0.1.0.tgz \
+  --cli-dependency file:/tmp/seed-app-deps/seed-app-cli-0.1.0.tgz
+```
+
+## Stories
+
+- Handshake with the host.
+- Query granted, approval-required, and denied capabilities.
+- Run an agent task.
+- Replay the Bridge-projected agent stream lifecycle: message, thought, tool, permission, elicitation, subagent, backup event, and turn barrier.
+- Download the same Bridge-projected replay stream as JSON.
+- Search memory.
+- List and call MCP tools.
+- Trigger an approval flow.
+- Trigger a denied capability flow.
+- Subscribe to host events.
+
+The app intentionally includes both allowed and blocked stories so developers can verify UX behavior before submitting a production app.

package/examples/react-spa-stories/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>SEED React SPA Stories</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/examples/react-spa-stories/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "seed-react-spa-stories",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite --host 127.0.0.1 --port 5173",
+    "build": "vite build",
+    "typecheck": "tsc --noEmit",
+    "seed:validate": "seed-app validate",
+    "seed:package": "bun run build && seed-app package",
+    "topo": "node -e \"\"",
+    "check-types": "tsc --noEmit",
+    "test:coverage": "node -e \"\""
+  },
+  "dependencies": {
+    "@seed-app-studio/sdk": "workspace:*",
+    "@vitejs/plugin-react": "^5.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "typescript": "^5.8.3",
+    "vite": "^6.4.1"
+  },
+  "devDependencies": {
+    "@seed-app-studio/cli": "workspace:*",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0"
+  }
+}

package/examples/react-spa-stories/seed-app.json

@@ -0,0 +1,74 @@
+{
+  "schemaVersion": 1,
+  "id": "seed.react-spa-stories",
+  "version": "0.1.0",
+  "name": "SEED React SPA Stories",
+  "kind": "vertical-app",
+  "entry": {
+    "type": "iframe",
+    "url": "http://localhost:5173"
+  },
+  "contributes": {
+    "launcher": {
+      "label": "React SPA Stories",
+      "icon": "experiment",
+      "order": 10
+    },
+    "routes": [
+      {
+        "path": "/stories",
+        "title": "Capability Stories"
+      }
+    ],
+    "conversationPanels": [
+      {
+        "id": "story-assistant",
+        "title": "Story Assistant"
+      }
+    ]
+  },
+  "runtime": {
+    "sdkVersion": "^0.1.0",
+    "framework": "react"
+  },
+  "capabilities": {
+    "agent": ["run", "approval.respond", "elicitation.respond"],
+    "brain-bundle": ["preview-summaries"],
+    "bridge": ["diagnostics"],
+    "memory": ["search"],
+    "mcp": ["listTools", "callTool"],
+    "workspace": ["write"]
+  },
+  "permissions": {
+    "network": {
+      "allowedDomains": ["localhost", "127.0.0.1"]
+    },
+    "memoryScopes": ["demo.customer", "demo.ticket"],
+    "mcpServers": ["seed.knowledgebase"],
+    "sensitiveActionsRequireApproval": true
+  },
+  "grantDefaults": {
+    "agent.run": "enabled",
+    "agent.approval.respond": "enabled",
+    "agent.elicitation.respond": "enabled",
+    "brain-bundle.preview-summaries": "enabled",
+    "bridge.diagnostics": "enabled",
+    "memory.search": "enabled",
+    "mcp.listTools": "enabled",
+    "mcp.callTool": "ask",
+    "workspace.write": "disabled"
+  },
+  "userConfigurable": {
+    "agent.run": true,
+    "brain-bundle.preview-summaries": true,
+    "bridge.diagnostics": true,
+    "memory.search": true,
+    "mcp.listTools": true,
+    "mcp.callTool": true,
+    "workspace.write": true
+  },
+  "tenantPolicy": {
+    "installScope": "user",
+    "dataResidency": "inherit"
+  }
+}