create-lousho 0.0.0-stage → 0.1.2-alpha.12

package/README.md

@@ -1,3 +1,45 @@
-# Temporary Holding Version
+# create-lousho
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Scaffold a new [`lousho`](https://www.npmjs.com/package/lousho) project with one command:
+
+```bash
+npm create lousho my-agent
+cd my-agent
+# copy .env.example to .env (cp on macOS/Linux, copy on Windows), then put your API key in it
+npm run dev              # chat with your agent in the terminal
+npm test                 # offline tests: no API key needed
+```
+
+You get an agent with an example tool, an offline test that uses a mock model, a `.env.example` for your provider, a strict `tsconfig.json` and a README. Dependencies are installed and `git init` is run for you. Requires Node.js 22.19 or newer.
+
+## Options
+
+Without arguments it asks for the directory, the provider and the template. For scripts, pass `--yes` and any of:
+
+| Option | Values |
+| ------ | ------ |
+| `--provider` | `openai`, `anthropic`, `openrouter`, `ollama`, `pi` |
+| `--template` | `minimal`, `tools`, `yaml` |
+| `--package-manager` | `npm`, `pnpm`, `yarn`, `bun` |
+| `--no-install` | skip installing dependencies |
+| `--no-git` | skip `git init` |
+| `--force` | write into a non-empty directory |
+| `--sdk-path <dir\|tgz>` | for SDK development: depend on an SDK checkout or a packed `.tgz` instead of the published version |
+
+With npm, put the options after `--`:
+
+```bash
+npm create lousho my-agent -- --yes --provider anthropic --template tools
+```
+
+Running a packed `.tgz` of this package on Windows: `npx C:\abs\path\create-lousho-<version>.tgz` silently does nothing (an npm quirk with absolute drive-letter paths). Use a relative path (`npx ./create-lousho-<version>.tgz my-agent`) or a `file:` spec (`npx file:C:/abs/path/create-lousho-<version>.tgz my-agent`).
+
+This package is a thin wrapper: it runs `lousho init` from the SDK, so `npx lousho init --help` lists every option.
+
+## Links
+
+- Documentation: [lousho.com](https://lousho.com) (English and Arabic)
+- Quick start: [lousho.com/quickstart](https://lousho.com/quickstart)
+- Source: [github.com/LinuxDevil/agent-sdk](https://github.com/LinuxDevil/agent-sdk)
+
+MIT licensed.

package/bin/cli.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+'use strict';
+
+const { main } = require('../dist/index.js');
+
+main(process.argv.slice(2)).then(
+  (code) => {
+    process.exitCode = typeof code === 'number' ? code : 0;
+  },
+  (err) => {
+    console.error(err && err.stack ? err.stack : String(err));
+    process.exitCode = 1;
+  }
+);

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `npm create lousho [dir] [options]` is `lousho init [dir] [options]`.
+ *
+ * The generator lives in the SDK (`src/cli/init.ts`) so there is exactly one
+ * copy of it; this package only depends on the SDK (same version line) and
+ * runs its `lousho` binary. `lousho init --help` lists the options.
+ */
+/** Absolute path of the `lousho` bin of the installed `lousho`. */
+declare function loushoBin(): string;
+/** Runs `lousho init <argv>`; resolves to its exit code. */
+declare function main(argv: string[]): Promise<number>;
+
+export { loushoBin, main };

package/dist/index.js

@@ -0,0 +1,38 @@
+'use strict';
+
+var child_process = require('child_process');
+var path = require('path');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var path__default = /*#__PURE__*/_interopDefault(path);
+
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+function loushoBin() {
+  const entry = __require.resolve("lousho");
+  return path__default.default.join(path__default.default.dirname(entry), "..", "bin", "lousho.js");
+}
+function main(argv) {
+  if (argv.includes("--help") || argv.includes("-h")) {
+    process.stdout.write("npm create lousho [dir] -- [options] runs `lousho init [dir] [options]`:\n\n");
+  }
+  return new Promise((resolve) => {
+    const child = child_process.spawn(process.execPath, [loushoBin(), "init", ...argv], { stdio: "inherit" });
+    child.on("error", (error) => {
+      process.stderr.write(`create-lousho: could not run lousho init: ${error.message}
+`);
+      resolve(1);
+    });
+    child.on("close", (code) => resolve(code ?? 1));
+  });
+}
+
+exports.loushoBin = loushoBin;
+exports.main = main;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["path","spawn"],"mappings":";;;;;;;;;;;;;;;AAYO,SAAS,SAAA,GAAoB;AAGlC,EAAA,MAAM,KAAA,GAAQ,SAAA,CAAQ,OAAA,CAAQ,QAAQ,CAAA;AACtC,EAAA,OAAOA,qBAAA,CAAK,KAAKA,qBAAA,CAAK,OAAA,CAAQ,KAAK,CAAA,EAAG,IAAA,EAAM,OAAO,WAAW,CAAA;AAChE;AAGO,SAAS,KAAK,IAAA,EAAiC;AACpD,EAAA,IAAI,KAAK,QAAA,CAAS,QAAQ,KAAK,IAAA,CAAK,QAAA,CAAS,IAAI,CAAA,EAAG;AAElD,IAAA,OAAA,CAAQ,MAAA,CAAO,MAAM,8EAA8E,CAAA;AAAA,EACrG;AACA,EAAA,OAAO,IAAI,OAAA,CAAQ,CAAC,OAAA,KAAY;AAC9B,IAAA,MAAM,KAAA,GAAQC,mBAAA,CAAM,OAAA,CAAQ,QAAA,EAAU,CAAC,SAAA,EAAU,EAAG,MAAA,EAAQ,GAAG,IAAI,CAAA,EAAG,EAAE,KAAA,EAAO,WAAW,CAAA;AAC1F,IAAA,KAAA,CAAM,EAAA,CAAG,OAAA,EAAS,CAAC,KAAA,KAAU;AAC3B,MAAA,OAAA,CAAQ,MAAA,CAAO,KAAA,CAAM,CAAA,0CAAA,EAA6C,KAAA,CAAM,OAAO;AAAA,CAAI,CAAA;AACnF,MAAA,OAAA,CAAQ,CAAC,CAAA;AAAA,IACX,CAAC,CAAA;AACD,IAAA,KAAA,CAAM,GAAG,OAAA,EAAS,CAAC,SAAS,OAAA,CAAQ,IAAA,IAAQ,CAAC,CAAC,CAAA;AAAA,EAChD,CAAC,CAAA;AACH","file":"index.js","sourcesContent":["import { spawn } from 'node:child_process';\nimport path from 'node:path';\n\n/**\n * `npm create lousho [dir] [options]` is `lousho init [dir] [options]`.\n *\n * The generator lives in the SDK (`src/cli/init.ts`) so there is exactly one\n * copy of it; this package only depends on the SDK (same version line) and\n * runs its `lousho` binary. `lousho init --help` lists the options.\n */\n\n/** Absolute path of the `lousho` bin of the installed `lousho`. */\nexport function loushoBin(): string {\n  // The package's \"exports\" map hides package.json, but the \".\" entry\n  // (<root>/dist/index.js) is resolvable and bin/ is its sibling of dist/.\n  const entry = require.resolve('lousho');\n  return path.join(path.dirname(entry), '..', 'bin', 'lousho.js');\n}\n\n/** Runs `lousho init <argv>`; resolves to its exit code. */\nexport function main(argv: string[]): Promise<number> {\n  if (argv.includes('--help') || argv.includes('-h')) {\n    // The usage below is `lousho init`'s; say how it maps to this command.\n    process.stdout.write('npm create lousho [dir] -- [options] runs `lousho init [dir] [options]`:\\n\\n');\n  }\n  return new Promise((resolve) => {\n    const child = spawn(process.execPath, [loushoBin(), 'init', ...argv], { stdio: 'inherit' });\n    child.on('error', (error) => {\n      process.stderr.write(`create-lousho: could not run lousho init: ${error.message}\\n`);\n      resolve(1);\n    });\n    child.on('close', (code) => resolve(code ?? 1));\n  });\n}\n"]}

package/package.json

@@ -1,6 +1,45 @@
 {
   "name": "create-lousho",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.2-alpha.12",
+  "description": "npm create lousho: scaffold a new lousho project (runs `lousho init`)",
+  "license": "MIT",
+  "homepage": "https://lousho.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/LinuxDevil/agent-sdk.git",
+    "directory": "packages/create-lousho"
+  },
+  "keywords": [
+    "lousho",
+    "ai",
+    "agents",
+    "create",
+    "scaffold"
+  ],
+  "type": "commonjs",
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "bin": {
+    "create-lousho": "bin/cli.js"
+  },
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "lousho": "^1.0.0-alpha.33",
+    "prompts": "^2.4.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^1.6.1"
+  }
+}