@kienmatu/inkos 0.1.0

package/dist/utils.js

@@ -0,0 +1,165 @@
+import { readFile, stat } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { createLLMClient, StateManager, createLogger, createStderrSink, createJsonLineSink, resolveEffectiveLLMConfig, loadLLMEnvLayers, GLOBAL_CONFIG_DIR, GLOBAL_ENV_PATH } from "@kienmatu/inkos-core";
+export { GLOBAL_CONFIG_DIR, GLOBAL_ENV_PATH };
+export async function resolveContext(opts) {
+    if (opts.context)
+        return opts.context;
+    if (opts.contextFile) {
+        return readFile(resolve(opts.contextFile), "utf-8");
+    }
+    // Read from stdin if piped (non-TTY)
+    if (!process.stdin.isTTY) {
+        const chunks = [];
+        for await (const chunk of process.stdin) {
+            chunks.push(chunk);
+        }
+        const text = Buffer.concat(chunks).toString("utf-8").trim();
+        if (text.length > 0)
+            return text;
+    }
+    return undefined;
+}
+export function findProjectRoot() {
+    return process.cwd();
+}
+export async function loadConfig(options) {
+    return (await loadConfigWithDiagnostics(options)).config;
+}
+export async function loadConfigWithDiagnostics(options) {
+    const root = options?.projectRoot ?? findProjectRoot();
+    const cli = {
+        ...parseLLMOverridesFromArgv(process.argv.slice(2)),
+        ...options?.cli,
+    };
+    const envLayers = await loadLLMEnvLayers(root);
+    return resolveEffectiveLLMConfig({
+        consumer: "cli",
+        projectRoot: root,
+        envLayers,
+        cli,
+        requireApiKey: options?.requireApiKey,
+    });
+}
+export function createClient(config) {
+    return createLLMClient(config.llm);
+}
+export function parseLLMOverridesFromArgv(argv) {
+    const overrides = {};
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (!arg)
+            continue;
+        const [flag, inlineValue] = arg.split("=", 2);
+        const nextValue = () => inlineValue ?? argv[++i];
+        if (flag === "--service") {
+            const value = nextValue();
+            if (value)
+                overrides.service = value;
+        }
+        else if (flag === "--model") {
+            const value = nextValue();
+            if (value)
+                overrides.model = value;
+        }
+        else if (flag === "--api-key-env") {
+            const value = nextValue();
+            if (value)
+                overrides.apiKeyEnv = value;
+        }
+        else if (flag === "--base-url") {
+            const value = nextValue();
+            if (value)
+                overrides.baseUrl = value;
+        }
+        else if (flag === "--api-format") {
+            const value = nextValue();
+            if (value === "chat" || value === "responses")
+                overrides.apiFormat = value;
+        }
+        else if (flag === "--stream") {
+            overrides.stream = true;
+        }
+        else if (flag === "--no-stream") {
+            overrides.stream = false;
+        }
+    }
+    return overrides;
+}
+export function buildPipelineConfig(config, root, extra) {
+    const sinks = [];
+    if (!extra?.quiet) {
+        sinks.push(createStderrSink({ minLevel: "info" }));
+    }
+    if (extra?.logFile) {
+        sinks.push(createJsonLineSink(extra.logFile));
+    }
+    const hasLogging = sinks.length > 0;
+    const logger = hasLogging ? createLogger({ tag: "inkos", sinks }) : undefined;
+    const onStreamProgress = hasLogging
+        ? (progress) => {
+            if (progress.status === "streaming") {
+                logger?.info(`streaming ${Math.round(progress.elapsedMs / 1000)}s, ${progress.totalChars} chars (${progress.chineseChars} CJK)`);
+            }
+        }
+        : undefined;
+    return {
+        client: createLLMClient(config.llm),
+        model: config.llm.model,
+        projectRoot: root,
+        defaultLLMConfig: config.llm,
+        foundationReviewRetries: config.foundation.reviewRetries,
+        writingReviewRetries: config.writing?.reviewRetries ?? 1,
+        chapterReviewMode: extra?.chapterReviewMode,
+        revisionGate: extra?.revisionGate,
+        modelOverrides: config.modelOverrides,
+        notifyChannels: extra?.notifyChannels ?? config.notify,
+        radarSources: extra?.radarSources,
+        externalContext: extra?.externalContext,
+        logger,
+        onStreamProgress,
+    };
+}
+export function log(message) {
+    process.stdout.write(`${message}\n`);
+}
+export function logError(message) {
+    process.stderr.write(`[ERROR] ${message}\n`);
+}
+/**
+ * Resolve book-id: if provided use it, otherwise auto-detect when exactly one book exists.
+ * Validates that the book actually exists.
+ */
+export async function resolveBookId(bookIdArg, root) {
+    const state = new StateManager(root);
+    const books = await state.listBooks();
+    if (bookIdArg) {
+        if (!books.includes(bookIdArg)) {
+            const available = books.length > 0 ? books.join(", ") : "(none)";
+            throw new Error(`Book "${bookIdArg}" not found. Available books: ${available}`);
+        }
+        return bookIdArg;
+    }
+    if (books.length === 0) {
+        throw new Error("No books found. Create one first:\n  inkos book create --title '...' --genre xuanhuan");
+    }
+    if (books.length === 1) {
+        return books[0];
+    }
+    throw new Error(`Multiple books found: ${books.join(", ")}\nPlease specify a book-id.`);
+}
+export async function getLegacyMigrationHint(root, bookId) {
+    const state = new StateManager(root);
+    const stateDir = join(state.bookDir(bookId), "story", "state");
+    try {
+        const info = await stat(stateDir);
+        if (info.isDirectory()) {
+            return null;
+        }
+    }
+    catch {
+        return `Book "${bookId}" uses legacy format (pre-v0.6). The next write will auto-migrate its state files.`;
+    }
+    return `Book "${bookId}" uses legacy format (pre-v0.6). The next write will auto-migrate its state files.`;
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@kienmatu/inkos",
+  "version": "0.1.0",
+  "description": "InkOS Story Creation AI Agent CLI and TUI for fiction, scripts, interactive worlds, and translation.",
+  "keywords": [
+    "story-creation-ai-agent",
+    "story-agent",
+    "ai-novel-writing",
+    "ai-writing-agent",
+    "novel-generator",
+    "interactive-fiction",
+    "ip-content",
+    "litrpg",
+    "progression-fantasy",
+    "ai-fiction",
+    "creative-writing-ai",
+    "novel-writing-tool",
+    "ai-storytelling",
+    "openclaw-skill",
+    "cli",
+    "epub",
+    "continuity-tracking"
+  ],
+  "type": "module",
+  "bin": {
+    "inkos": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "!dist/__tests__"
+  ],
+  "license": "AGPL-3.0-only",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kienmatu/inkos.git",
+    "directory": "packages/cli"
+  },
+  "dependencies": {
+    "@kienmatu/inkos-core": "0.1.0",
+    "@kienmatu/inkos-studio": "0.1.0",
+    "commander": "^13.0.0",
+    "dotenv": "^16.4.0",
+    "epub-gen-memory": "^1.0.10",
+    "ink": "7.0.0",
+    "ink-text-input": "^6.0.0",
+    "marked": "^15.0.12",
+    "marked-terminal": "^7.3.0",
+    "react": "^19.2.4"
+  },
+  "devDependencies": {
+    "@types/marked-terminal": "^6.1.1",
+    "@types/node": "^22.0.0",
+    "@types/react": "^19.2.14",
+    "ink-testing-library": "^4.0.0",
+    "typescript": "^5.8.0",
+    "vitest": "^3.0.0"
+  },
+  "overrides": {
+    "@mariozechner/pi-ai": "0.67.1",
+    "@mariozechner/pi-agent-core": "0.67.1"
+  },
+  "scripts": {
+    "prepare:workspace-core": "pnpm --filter @kienmatu/inkos-core build",
+    "prebuild": "pnpm run prepare:workspace-core",
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "pretest": "pnpm run build",
+    "test": "vitest run --passWithNoTests",
+    "pretypecheck": "pnpm run prepare:workspace-core",
+    "typecheck": "tsc --noEmit"
+  }
+}