@pi-harness/pi-harness 0.1.16 → 0.1.18

package/README.ar.md

@@ -0,0 +1,59 @@
+# Pi Harness
+
+‏Pi Harness هو مضيف ويب يعتمد على الإضافات لـ [Pi](https://github.com/earendil-works/pi)، ومبني على DeepSeek Cordis. يوفّر وحدة تحكم للمتصفح وواجهة HTTP وأداة CLI.
+
+اللغات: [English](README.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Español](README.es.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [Português](README.pt-BR.md) · [Русский](README.ru.md) · [Italiano](README.it.md)
+
+## التثبيت
+
+يتطلب Node.js 22.19 أو أحدث و npm 10 أو أحدث.
+
+```sh
+npm install --global @pi-harness/pi-harness
+pi-harness
+```
+
+يكفي عادةً تثبيت الحزمة الرئيسية؛ إذ تُثبّت تبعيات التنفيذ، ومنها `@pi-harness/core`، تلقائياً.
+
+## التشغيل من المصدر
+
+```sh
+npm ci
+npm run build
+npm run web
+```
+
+## التحديث والإعداد
+
+عند التشغيل، يتحقق Pi Harness في الخلفية من وجود إصدار متوافق أحدث من `@pi-harness/core`. لا يؤخر ذلك بدء التشغيل، ويعرض الأمر عند توفر تحديث ويتجاهل أخطاء الشبكة. للتحديث شغّل `npm update --global @pi-harness/pi-harness`، أو عطّل التحقق باستخدام `PI_HARNESS_DISABLE_UPDATE_CHECK=1`.
+
+أهم متغيرات البيئة هي `PI_HARNESS_HOST` و`PI_HARNESS_PORT` و`PI_AGENT_DIR`. العنوان الافتراضي هو `http://127.0.0.1:3141`.
+
+## CLI
+
+```sh
+pih --profile default "لخّص المجلد الحالي"
+pih --profile development "لخّص المجلد الحالي"
+pih --config ./cordis.yml "لخّص المجلد الحالي"
+```
+
+الخيارات هي `--profile` و`--config` و`--dump-config` و`--help` و`--version`. Profile هو قائمة من إدخالات Cordis Loader، ويحتاج كل إدخال إلى `id` فريد واسم وحدة في `name`.
+
+## البنية والإضافات
+
+تجمع مكوّنات Loader وInclude وGroup في Cordis إضافات النماذج والموارد والجلسات والأدوات وruntime وWeb/API وstdio. إن `@pi-harness/core` حزمة npm مستقلة تحتوي عدة إضافات Cordis وليست إضافة واحدة. تُثبّت الإضافات الخارجية عبر npm وتُذكر في `cordis.yml`.
+
+## التطوير
+
+```sh
+npm test
+npm run typecheck
+npm run lint
+npm run build
+```
+
+للاطلاع على كتالوج الإضافات الكامل والإعدادات وواجهة API والحدود الأمنية، راجع [المرجع الكامل بالإنجليزية](README.reference.md).
+
+## الترخيص
+
+MIT. راجع [LICENSE](LICENSE).

package/README.de.md

@@ -0,0 +1,59 @@
+# Pi Harness
+
+Pi Harness ist ein plugin-orientierter Web-Host für [Pi](https://github.com/earendil-works/pi), aufgebaut auf DeepSeek Cordis. Enthalten sind Web-Konsole, HTTP-API und CLI.
+
+Sprachen: [English](README.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Español](README.es.md) · [Français](README.fr.md) · [Português](README.pt-BR.md) · [Русский](README.ru.md) · [Italiano](README.it.md) · [العربية](README.ar.md)
+
+## Installation
+
+Erforderlich sind Node.js 22.19 oder neuer und npm 10 oder neuer.
+
+```sh
+npm install --global @pi-harness/pi-harness
+pi-harness
+```
+
+Normalerweise wird nur das Hauptpaket installiert; Implementierungsabhängigkeiten wie `@pi-harness/core` werden automatisch installiert.
+
+## Aus dem Quellcode ausführen
+
+```sh
+npm ci
+npm run build
+npm run web
+```
+
+## Updates und Konfiguration
+
+Beim Start prüft Pi Harness im Hintergrund auf eine kompatible neue Version von `@pi-harness/core`. Der Start wird nicht blockiert; bei einem Update wird ein Befehl ausgegeben, Netzwerkfehler werden ignoriert. Aktualisieren Sie mit `npm update --global @pi-harness/pi-harness` oder deaktivieren Sie die Prüfung mit `PI_HARNESS_DISABLE_UPDATE_CHECK=1`.
+
+Wichtige Umgebungsvariablen sind `PI_HARNESS_HOST`, `PI_HARNESS_PORT` und `PI_AGENT_DIR`. Die Standardadresse lautet `http://127.0.0.1:3141`.
+
+## CLI
+
+```sh
+pih --profile default "Aktuelles Verzeichnis zusammenfassen"
+pih --profile development "Aktuelles Verzeichnis zusammenfassen"
+pih --config ./cordis.yml "Aktuelles Verzeichnis zusammenfassen"
+```
+
+Optionen: `--profile`, `--config`, `--dump-config`, `--help` und `--version`. Ein Profile ist eine Liste von Cordis-Loader-Einträgen mit eindeutiger `id` und Modul-`name`.
+
+## Architektur und Plugins
+
+Cordis Loader, Include und Group laden die Plugins für Modelle, Ressourcen, Sitzungen, Tools, Runtime, Web/API und stdio. `@pi-harness/core` ist ein unabhängiges npm-Paket mit mehreren Cordis-Plugins, kein einzelnes Plugin. Externe Plugins werden mit npm installiert und in `cordis.yml` eingetragen.
+
+## Entwicklung
+
+```sh
+npm test
+npm run typecheck
+npm run lint
+npm run build
+```
+
+Der vollständige Plugin-Katalog sowie Konfiguration, API, Limits und Sicherheitsgrenzen stehen in der [vollständigen englischen Referenz](README.reference.md).
+
+## Lizenz
+
+MIT. Siehe [LICENSE](LICENSE).

package/README.es.md

@@ -0,0 +1,59 @@
+# Pi Harness
+
+Pi Harness es un host web centrado en plugins para [Pi](https://github.com/earendil-works/pi), construido sobre DeepSeek Cordis. Incluye consola web, API HTTP y CLI.
+
+Idiomas: [English](README.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [Português](README.pt-BR.md) · [Русский](README.ru.md) · [Italiano](README.it.md) · [العربية](README.ar.md)
+
+## Instalación
+
+Requiere Node.js 22.19 o posterior y npm 10 o posterior.
+
+```sh
+npm install --global @pi-harness/pi-harness
+pi-harness
+```
+
+Normalmente solo hay que instalar el paquete principal; las dependencias de implementación, incluido `@pi-harness/core`, se instalan automáticamente.
+
+## Ejecutar desde el código fuente
+
+```sh
+npm ci
+npm run build
+npm run web
+```
+
+## Actualizaciones y configuración
+
+Al iniciar, Pi Harness comprueba en segundo plano si existe una versión compatible nueva de `@pi-harness/core`. No bloquea el arranque, muestra el comando si encuentra una actualización e ignora los fallos de red. Ejecuta `npm update --global @pi-harness/pi-harness` para actualizar o usa `PI_HARNESS_DISABLE_UPDATE_CHECK=1` para desactivar la comprobación.
+
+Variables habituales: `PI_HARNESS_HOST`, `PI_HARNESS_PORT` y `PI_AGENT_DIR`. La dirección predeterminada es `http://127.0.0.1:3141`.
+
+## CLI
+
+```sh
+pih --profile default "Resume el directorio actual"
+pih --profile development "Resume el directorio actual"
+pih --config ./cordis.yml "Resume el directorio actual"
+```
+
+Las opciones son `--profile`, `--config`, `--dump-config`, `--help` y `--version`. Un profile es una lista de entradas de Cordis Loader; cada entrada necesita un `id` único y un `name` de módulo.
+
+## Arquitectura y plugins
+
+Loader, Include y Group de Cordis montan los plugins de modelos, recursos, sesiones, herramientas, runtime, Web/API y stdio. `@pi-harness/core` es un paquete npm independiente que contiene varios plugins Cordis, no un único plugin. Los plugins externos se instalan con npm y se declaran en `cordis.yml`.
+
+## Desarrollo
+
+```sh
+npm test
+npm run typecheck
+npm run lint
+npm run build
+```
+
+Consulta la [referencia completa en inglés](README.reference.md) para el catálogo de plugins, configuración, API, límites y seguridad.
+
+## Licencia
+
+MIT. Consulta [LICENSE](LICENSE).

package/README.fr.md

@@ -0,0 +1,59 @@
+# Pi Harness
+
+Pi Harness est un hôte web orienté plugins pour [Pi](https://github.com/earendil-works/pi), construit avec DeepSeek Cordis. Il fournit une console web, une API HTTP et une CLI.
+
+Langues : [English](README.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Español](README.es.md) · [Deutsch](README.de.md) · [Português](README.pt-BR.md) · [Русский](README.ru.md) · [Italiano](README.it.md) · [العربية](README.ar.md)
+
+## Installation
+
+Node.js 22.19 ou plus récent et npm 10 ou plus récent sont requis.
+
+```sh
+npm install --global @pi-harness/pi-harness
+pi-harness
+```
+
+Installez normalement uniquement le paquet principal ; les dépendances d’implémentation, dont `@pi-harness/core`, sont installées automatiquement.
+
+## Exécution depuis les sources
+
+```sh
+npm ci
+npm run build
+npm run web
+```
+
+## Mises à jour et configuration
+
+Au démarrage, Pi Harness vérifie en arrière-plan les nouvelles versions compatibles de `@pi-harness/core`. Cette vérification ne bloque pas le démarrage, affiche une commande si une mise à jour est disponible et ignore les erreurs réseau. Utilisez `npm update --global @pi-harness/pi-harness` pour mettre à jour ou `PI_HARNESS_DISABLE_UPDATE_CHECK=1` pour désactiver la vérification.
+
+Variables courantes : `PI_HARNESS_HOST`, `PI_HARNESS_PORT` et `PI_AGENT_DIR`. L’adresse par défaut est `http://127.0.0.1:3141`.
+
+## CLI
+
+```sh
+pih --profile default "Résumer le répertoire courant"
+pih --profile development "Résumer le répertoire courant"
+pih --config ./cordis.yml "Résumer le répertoire courant"
+```
+
+Options : `--profile`, `--config`, `--dump-config`, `--help` et `--version`. Un profile est une liste d’entrées Cordis Loader ; chaque entrée doit avoir un `id` unique et un `name` de module.
+
+## Architecture et plugins
+
+Loader, Include et Group de Cordis assemblent les plugins de modèles, ressources, sessions, outils, runtime, Web/API et stdio. `@pi-harness/core` est un paquet npm indépendant contenant plusieurs plugins Cordis, et non un plugin unique. Les plugins externes s’installent avec npm puis se déclarent dans `cordis.yml`.
+
+## Développement
+
+```sh
+npm test
+npm run typecheck
+npm run lint
+npm run build
+```
+
+Consultez la [référence complète en anglais](README.reference.md) pour le catalogue des plugins, la configuration, l’API, les limites et la sécurité.
+
+## Licence
+
+MIT. Voir [LICENSE](LICENSE).

package/README.it.md

@@ -0,0 +1,59 @@
+# Pi Harness
+
+Pi Harness è un host web basato sui plugin per [Pi](https://github.com/earendil-works/pi), costruito su DeepSeek Cordis. Offre console web, API HTTP e CLI.
+
+Lingue: [English](README.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Español](README.es.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [Português](README.pt-BR.md) · [Русский](README.ru.md) · [العربية](README.ar.md)
+
+## Installazione
+
+Sono richiesti Node.js 22.19 o superiore e npm 10 o superiore.
+
+```sh
+npm install --global @pi-harness/pi-harness
+pi-harness
+```
+
+Di norma è sufficiente installare il pacchetto principale; le dipendenze, incluso `@pi-harness/core`, vengono installate automaticamente.
+
+## Esecuzione dal sorgente
+
+```sh
+npm ci
+npm run build
+npm run web
+```
+
+## Aggiornamenti e configurazione
+
+All’avvio Pi Harness verifica in background la presenza di una versione compatibile più recente di `@pi-harness/core`. L’avvio non viene bloccato, il comando viene mostrato quando è disponibile un aggiornamento e gli errori di rete vengono ignorati. Usa `npm update --global @pi-harness/pi-harness` per aggiornare oppure `PI_HARNESS_DISABLE_UPDATE_CHECK=1` per disattivare il controllo.
+
+Le variabili principali sono `PI_HARNESS_HOST`, `PI_HARNESS_PORT` e `PI_AGENT_DIR`. L’indirizzo predefinito è `http://127.0.0.1:3141`.
+
+## CLI
+
+```sh
+pih --profile default "Riassumi la directory corrente"
+pih --profile development "Riassumi la directory corrente"
+pih --config ./cordis.yml "Riassumi la directory corrente"
+```
+
+Le opzioni sono `--profile`, `--config`, `--dump-config`, `--help` e `--version`. Un profile è un elenco di voci Cordis Loader; ogni voce richiede un `id` univoco e un `name` di modulo.
+
+## Architettura e plugin
+
+Loader, Include e Group di Cordis compongono i plugin per modelli, risorse, sessioni, strumenti, runtime, Web/API e stdio. `@pi-harness/core` è un pacchetto npm indipendente che contiene più plugin Cordis, non un singolo plugin. I plugin esterni si installano con npm e si dichiarano in `cordis.yml`.
+
+## Sviluppo
+
+```sh
+npm test
+npm run typecheck
+npm run lint
+npm run build
+```
+
+Consulta il [riferimento completo in inglese](README.reference.md) per catalogo dei plugin, configurazione, API, limiti e sicurezza.
+
+## Licenza
+
+MIT. Vedi [LICENSE](LICENSE).

package/README.ja.md

@@ -0,0 +1,59 @@
+# Pi Harness
+
+Pi Harness は [Pi](https://github.com/earendil-works/pi) 向けのプラグイン中心 Web ホストです。DeepSeek Cordis を基盤に、ブラウザコンソール、HTTP API、CLI を提供します。
+
+言語: [English](README.md) · [简体中文](README.zh-CN.md) · [한국어](README.ko.md) · [Español](README.es.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [Português](README.pt-BR.md) · [Русский](README.ru.md) · [Italiano](README.it.md) · [العربية](README.ar.md)
+
+## インストール
+
+Node.js 22.19 以上、npm 10 以上が必要です。
+
+```sh
+npm install --global @pi-harness/pi-harness
+pi-harness
+```
+
+通常はメインパッケージだけをインストールします。`@pi-harness/core` などの依存パッケージは自動的に入ります。
+
+## ソースから実行
+
+```sh
+npm ci
+npm run build
+npm run web
+```
+
+## 更新と設定
+
+起動時に互換性のある `@pi-harness/core` の更新をバックグラウンドで確認します。起動をブロックせず、更新があればコマンドを表示し、ネットワーク障害は無視します。`npm update --global @pi-harness/pi-harness` で更新し、`PI_HARNESS_DISABLE_UPDATE_CHECK=1` で確認を無効化できます。
+
+主な環境変数は `PI_HARNESS_HOST`、`PI_HARNESS_PORT`、`PI_AGENT_DIR` です。既定の URL は `http://127.0.0.1:3141` です。
+
+## CLI
+
+```sh
+pih --profile default "現在のディレクトリを要約"
+pih --profile development "現在のディレクトリを要約"
+pih --config ./cordis.yml "現在のディレクトリを要約"
+```
+
+`--profile`、`--config`、`--dump-config`、`--help`、`--version` を利用できます。Profile は Cordis Loader のエントリ配列で、各エントリには一意な `id` と `name` が必要です。
+
+## アーキテクチャとプラグイン
+
+Cordis の Loader、Include、Group がモデル、リソース、セッション、ツール、ランタイム、Web/API、stdio プラグインを構成します。`@pi-harness/core` は複数の Cordis プラグインを含む独立 npm パッケージです。外部プラグインは npm で追加し、`cordis.yml` から読み込みます。
+
+## 開発
+
+```sh
+npm test
+npm run typecheck
+npm run lint
+npm run build
+```
+
+完全なプラグイン一覧、設定、API、制限事項、セキュリティ境界は [英語の完全リファレンス](README.reference.md) を参照してください。
+
+## ライセンス
+
+MIT。[LICENSE](LICENSE) を参照してください。

package/README.ko.md

@@ -0,0 +1,59 @@
+# Pi Harness
+
+Pi Harness는 DeepSeek Cordis로 구축된 [Pi](https://github.com/earendil-works/pi)용 플러그인 중심 웹 호스트입니다. 브라우저 콘솔, HTTP API, CLI를 제공합니다.
+
+언어: [English](README.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [Español](README.es.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [Português](README.pt-BR.md) · [Русский](README.ru.md) · [Italiano](README.it.md) · [العربية](README.ar.md)
+
+## 설치
+
+Node.js 22.19 이상과 npm 10 이상이 필요합니다.
+
+```sh
+npm install --global @pi-harness/pi-harness
+pi-harness
+```
+
+일반적으로 메인 패키지만 설치하면 됩니다. `@pi-harness/core` 같은 구현 의존성은 자동으로 설치됩니다.
+
+## 소스에서 실행
+
+```sh
+npm ci
+npm run build
+npm run web
+```
+
+## 업데이트 및 설정
+
+시작 시 호환 가능한 `@pi-harness/core` 업데이트를 백그라운드에서 확인합니다. 시작을 지연하지 않으며, 업데이트가 있으면 명령을 출력하고 네트워크 오류는 무시합니다. `npm update --global @pi-harness/pi-harness`로 업데이트하고 `PI_HARNESS_DISABLE_UPDATE_CHECK=1`로 확인을 끌 수 있습니다.
+
+주요 환경 변수는 `PI_HARNESS_HOST`, `PI_HARNESS_PORT`, `PI_AGENT_DIR`입니다. 기본 주소는 `http://127.0.0.1:3141`입니다.
+
+## CLI
+
+```sh
+pih --profile default "현재 디렉터리 요약"
+pih --profile development "현재 디렉터리 요약"
+pih --config ./cordis.yml "현재 디렉터리 요약"
+```
+
+사용 가능한 런처 옵션은 `--profile`, `--config`, `--dump-config`, `--help`, `--version`입니다. Profile은 Cordis Loader 항목 배열이며 각 항목에는 고유한 `id`와 모듈 `name`이 필요합니다.
+
+## 아키텍처와 플러그인
+
+Cordis Loader, Include, Group이 모델, 리소스, 세션, 도구, 런타임, Web/API, stdio 플러그인을 구성합니다. `@pi-harness/core`는 여러 Cordis 플러그인을 포함하는 독립 npm 패키지이며 단일 플러그인이 아닙니다. 외부 플러그인은 npm으로 설치한 뒤 `cordis.yml`에서 불러옵니다.
+
+## 개발
+
+```sh
+npm test
+npm run typecheck
+npm run lint
+npm run build
+```
+
+전체 플러그인 목록, 설정, API, 제한 및 보안 경계는 [영문 전체 참조 문서](README.reference.md)를 확인하세요.
+
+## 라이선스
+
+MIT. [LICENSE](LICENSE)를 참조하세요.