openryoko 2026.10.8 → 2026.10.13
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/bin/jimmy.js +51 -1
- package/dist/bin/jimmy.js.map +1 -1
- package/dist/package.json +2 -1
- package/dist/src/backup/archive.d.ts +65 -0
- package/dist/src/backup/archive.d.ts.map +1 -0
- package/dist/src/backup/archive.js +214 -0
- package/dist/src/backup/archive.js.map +1 -0
- package/dist/src/backup/catalog.d.ts +64 -0
- package/dist/src/backup/catalog.d.ts.map +1 -0
- package/dist/src/backup/catalog.js +252 -0
- package/dist/src/backup/catalog.js.map +1 -0
- package/dist/src/backup/database-restore.d.ts +63 -0
- package/dist/src/backup/database-restore.d.ts.map +1 -0
- package/dist/src/backup/database-restore.js +236 -0
- package/dist/src/backup/database-restore.js.map +1 -0
- package/dist/src/backup/database-source.d.ts +70 -0
- package/dist/src/backup/database-source.d.ts.map +1 -0
- package/dist/src/backup/database-source.js +70 -0
- package/dist/src/backup/database-source.js.map +1 -0
- package/dist/src/backup/format.d.ts +4 -0
- package/dist/src/backup/format.d.ts.map +1 -0
- package/dist/src/backup/format.js +15 -0
- package/dist/src/backup/format.js.map +1 -0
- package/dist/src/backup/gateway-liveness.d.ts +44 -0
- package/dist/src/backup/gateway-liveness.d.ts.map +1 -0
- package/dist/src/backup/gateway-liveness.js +120 -0
- package/dist/src/backup/gateway-liveness.js.map +1 -0
- package/dist/src/backup/inspect.d.ts +45 -0
- package/dist/src/backup/inspect.d.ts.map +1 -0
- package/dist/src/backup/inspect.js +291 -0
- package/dist/src/backup/inspect.js.map +1 -0
- package/dist/src/backup/layout.d.ts +11 -0
- package/dist/src/backup/layout.d.ts.map +1 -0
- package/dist/src/backup/layout.js +16 -0
- package/dist/src/backup/layout.js.map +1 -0
- package/dist/src/backup/limits.d.ts +54 -0
- package/dist/src/backup/limits.d.ts.map +1 -0
- package/dist/src/backup/limits.js +59 -0
- package/dist/src/backup/limits.js.map +1 -0
- package/dist/src/backup/manifest.d.ts +45 -0
- package/dist/src/backup/manifest.d.ts.map +1 -0
- package/dist/src/backup/manifest.js +77 -0
- package/dist/src/backup/manifest.js.map +1 -0
- package/dist/src/backup/restore.d.ts +73 -0
- package/dist/src/backup/restore.d.ts.map +1 -0
- package/dist/src/backup/restore.js +685 -0
- package/dist/src/backup/restore.js.map +1 -0
- package/dist/src/backup/run.d.ts +76 -0
- package/dist/src/backup/run.d.ts.map +1 -0
- package/dist/src/backup/run.js +181 -0
- package/dist/src/backup/run.js.map +1 -0
- package/dist/src/backup/scheduler.d.ts +51 -0
- package/dist/src/backup/scheduler.d.ts.map +1 -0
- package/dist/src/backup/scheduler.js +198 -0
- package/dist/src/backup/scheduler.js.map +1 -0
- package/dist/src/backup/settings.d.ts +44 -0
- package/dist/src/backup/settings.d.ts.map +1 -0
- package/dist/src/backup/settings.js +91 -0
- package/dist/src/backup/settings.js.map +1 -0
- package/dist/src/backup/space.d.ts +22 -0
- package/dist/src/backup/space.d.ts.map +1 -0
- package/dist/src/backup/space.js +47 -0
- package/dist/src/backup/space.js.map +1 -0
- package/dist/src/backup/state.d.ts +46 -0
- package/dist/src/backup/state.d.ts.map +1 -0
- package/dist/src/backup/state.js +137 -0
- package/dist/src/backup/state.js.map +1 -0
- package/dist/src/backup/tar.d.ts +64 -0
- package/dist/src/backup/tar.d.ts.map +1 -0
- package/dist/src/backup/tar.js +274 -0
- package/dist/src/backup/tar.js.map +1 -0
- package/dist/src/backup/targets.d.ts +85 -0
- package/dist/src/backup/targets.d.ts.map +1 -0
- package/dist/src/backup/targets.js +104 -0
- package/dist/src/backup/targets.js.map +1 -0
- package/dist/src/backup/walk.d.ts +42 -0
- package/dist/src/backup/walk.d.ts.map +1 -0
- package/dist/src/backup/walk.js +324 -0
- package/dist/src/backup/walk.js.map +1 -0
- package/dist/src/cli/backup.d.ts +45 -0
- package/dist/src/cli/backup.d.ts.map +1 -0
- package/dist/src/cli/backup.js +344 -0
- package/dist/src/cli/backup.js.map +1 -0
- package/dist/src/cli/bundled-skills.d.ts +7 -1
- package/dist/src/cli/bundled-skills.d.ts.map +1 -1
- package/dist/src/cli/bundled-skills.js +12 -2
- package/dist/src/cli/bundled-skills.js.map +1 -1
- package/dist/src/cli/config-failure.d.ts +18 -0
- package/dist/src/cli/config-failure.d.ts.map +1 -0
- package/dist/src/cli/config-failure.js +39 -0
- package/dist/src/cli/config-failure.js.map +1 -0
- package/dist/src/cli/gateway-audit.d.ts +3 -0
- package/dist/src/cli/gateway-audit.d.ts.map +1 -1
- package/dist/src/cli/gateway-audit.js +61 -14
- package/dist/src/cli/gateway-audit.js.map +1 -1
- package/dist/src/cli/gateway-url-backup.d.ts +21 -0
- package/dist/src/cli/gateway-url-backup.d.ts.map +1 -0
- package/dist/src/cli/gateway-url-backup.js +87 -0
- package/dist/src/cli/gateway-url-backup.js.map +1 -0
- package/dist/src/cli/home-copy.d.ts +37 -0
- package/dist/src/cli/home-copy.d.ts.map +1 -0
- package/dist/src/cli/home-copy.js +155 -0
- package/dist/src/cli/home-copy.js.map +1 -0
- package/dist/src/cli/interactive-config.d.ts +5 -0
- package/dist/src/cli/interactive-config.d.ts.map +1 -1
- package/dist/src/cli/interactive-config.js +16 -7
- package/dist/src/cli/interactive-config.js.map +1 -1
- package/dist/src/cli/migrate.d.ts +20 -0
- package/dist/src/cli/migrate.d.ts.map +1 -1
- package/dist/src/cli/migrate.js +365 -68
- package/dist/src/cli/migrate.js.map +1 -1
- package/dist/src/cli/migration-declarations.d.ts +24 -0
- package/dist/src/cli/migration-declarations.d.ts.map +1 -0
- package/dist/src/cli/migration-declarations.js +54 -0
- package/dist/src/cli/migration-declarations.js.map +1 -0
- package/dist/src/cli/start.d.ts.map +1 -1
- package/dist/src/cli/start.js +40 -1
- package/dist/src/cli/start.js.map +1 -1
- package/dist/src/connectors/chunked-send.d.ts +27 -0
- package/dist/src/connectors/chunked-send.d.ts.map +1 -0
- package/dist/src/connectors/chunked-send.js +40 -0
- package/dist/src/connectors/chunked-send.js.map +1 -0
- package/dist/src/connectors/cron/index.d.ts +10 -0
- package/dist/src/connectors/cron/index.d.ts.map +1 -1
- package/dist/src/connectors/cron/index.js +26 -3
- package/dist/src/connectors/cron/index.js.map +1 -1
- package/dist/src/connectors/discord/attachments.d.ts +25 -0
- package/dist/src/connectors/discord/attachments.d.ts.map +1 -0
- package/dist/src/connectors/discord/attachments.js +33 -0
- package/dist/src/connectors/discord/attachments.js.map +1 -0
- package/dist/src/connectors/discord/format.d.ts +17 -1
- package/dist/src/connectors/discord/format.d.ts.map +1 -1
- package/dist/src/connectors/discord/format.js +36 -6
- package/dist/src/connectors/discord/format.js.map +1 -1
- package/dist/src/connectors/discord/index.d.ts +12 -0
- package/dist/src/connectors/discord/index.d.ts.map +1 -1
- package/dist/src/connectors/discord/index.js +47 -40
- package/dist/src/connectors/discord/index.js.map +1 -1
- package/dist/src/connectors/discord/remote.d.ts +45 -1
- package/dist/src/connectors/discord/remote.d.ts.map +1 -1
- package/dist/src/connectors/discord/remote.js +147 -22
- package/dist/src/connectors/discord/remote.js.map +1 -1
- package/dist/src/connectors/slack/attachments.d.ts +25 -0
- package/dist/src/connectors/slack/attachments.d.ts.map +1 -0
- package/dist/src/connectors/slack/attachments.js +32 -0
- package/dist/src/connectors/slack/attachments.js.map +1 -0
- package/dist/src/connectors/slack/auth-test-cache.d.ts +22 -0
- package/dist/src/connectors/slack/auth-test-cache.d.ts.map +1 -0
- package/dist/src/connectors/slack/auth-test-cache.js +34 -0
- package/dist/src/connectors/slack/auth-test-cache.js.map +1 -0
- package/dist/src/connectors/slack/format.d.ts +6 -1
- package/dist/src/connectors/slack/format.d.ts.map +1 -1
- package/dist/src/connectors/slack/format.js +65 -13
- package/dist/src/connectors/slack/format.js.map +1 -1
- package/dist/src/connectors/slack/index.d.ts +4 -0
- package/dist/src/connectors/slack/index.d.ts.map +1 -1
- package/dist/src/connectors/slack/index.js +64 -52
- package/dist/src/connectors/slack/index.js.map +1 -1
- package/dist/src/connectors/slack/provider-auth-blocks.d.ts +62 -0
- package/dist/src/connectors/slack/provider-auth-blocks.d.ts.map +1 -0
- package/dist/src/connectors/slack/provider-auth-blocks.js +204 -0
- package/dist/src/connectors/slack/provider-auth-blocks.js.map +1 -0
- package/dist/src/connectors/slack/provider-auth.d.ts +126 -0
- package/dist/src/connectors/slack/provider-auth.d.ts.map +1 -0
- package/dist/src/connectors/slack/provider-auth.js +357 -0
- package/dist/src/connectors/slack/provider-auth.js.map +1 -0
- package/dist/src/connectors/telegram/index.d.ts +5 -0
- package/dist/src/connectors/telegram/index.d.ts.map +1 -1
- package/dist/src/connectors/telegram/index.js +14 -22
- package/dist/src/connectors/telegram/index.js.map +1 -1
- package/dist/src/connectors/whatsapp/index.d.ts +3 -0
- package/dist/src/connectors/whatsapp/index.d.ts.map +1 -1
- package/dist/src/connectors/whatsapp/index.js +33 -14
- package/dist/src/connectors/whatsapp/index.js.map +1 -1
- package/dist/src/cron/alert-throttle.d.ts +28 -0
- package/dist/src/cron/alert-throttle.d.ts.map +1 -0
- package/dist/src/cron/alert-throttle.js +106 -0
- package/dist/src/cron/alert-throttle.js.map +1 -0
- package/dist/src/cron/jobs.d.ts +8 -0
- package/dist/src/cron/jobs.d.ts.map +1 -1
- package/dist/src/cron/jobs.js +27 -1
- package/dist/src/cron/jobs.js.map +1 -1
- package/dist/src/cron/run-outcome.d.ts +28 -0
- package/dist/src/cron/run-outcome.d.ts.map +1 -0
- package/dist/src/cron/run-outcome.js +66 -0
- package/dist/src/cron/run-outcome.js.map +1 -0
- package/dist/src/cron/runner.d.ts.map +1 -1
- package/dist/src/cron/runner.js +68 -5
- package/dist/src/cron/runner.js.map +1 -1
- package/dist/src/cron/scheduler.d.ts +8 -1
- package/dist/src/cron/scheduler.d.ts.map +1 -1
- package/dist/src/cron/scheduler.js +11 -4
- package/dist/src/cron/scheduler.js.map +1 -1
- package/dist/src/cron/waiting-fires.d.ts +18 -0
- package/dist/src/cron/waiting-fires.d.ts.map +1 -0
- package/dist/src/cron/waiting-fires.js +49 -0
- package/dist/src/cron/waiting-fires.js.map +1 -0
- package/dist/src/engines/claude-interactive.d.ts +19 -3
- package/dist/src/engines/claude-interactive.d.ts.map +1 -1
- package/dist/src/engines/claude-interactive.js +42 -17
- package/dist/src/engines/claude-interactive.js.map +1 -1
- package/dist/src/engines/claude.d.ts.map +1 -1
- package/dist/src/engines/claude.js +38 -5
- package/dist/src/engines/claude.js.map +1 -1
- package/dist/src/engines/codex.d.ts.map +1 -1
- package/dist/src/engines/codex.js +1 -0
- package/dist/src/engines/codex.js.map +1 -1
- package/dist/src/engines/gemini.d.ts.map +1 -1
- package/dist/src/engines/gemini.js +1 -0
- package/dist/src/engines/gemini.js.map +1 -1
- package/dist/src/gateway/api.d.ts.map +1 -1
- package/dist/src/gateway/api.js +184 -160
- package/dist/src/gateway/api.js.map +1 -1
- package/dist/src/gateway/config-redaction.d.ts +32 -0
- package/dist/src/gateway/config-redaction.d.ts.map +1 -0
- package/dist/src/gateway/config-redaction.js +139 -0
- package/dist/src/gateway/config-redaction.js.map +1 -0
- package/dist/src/gateway/config-revision.d.ts +46 -0
- package/dist/src/gateway/config-revision.d.ts.map +1 -0
- package/dist/src/gateway/config-revision.js +63 -0
- package/dist/src/gateway/config-revision.js.map +1 -0
- package/dist/src/gateway/connector-config.d.ts +21 -0
- package/dist/src/gateway/connector-config.d.ts.map +1 -0
- package/dist/src/gateway/connector-config.js +24 -0
- package/dist/src/gateway/connector-config.js.map +1 -0
- package/dist/src/gateway/daemon-entry.js +5 -0
- package/dist/src/gateway/daemon-entry.js.map +1 -1
- package/dist/src/gateway/engine-health-monitor.d.ts +67 -0
- package/dist/src/gateway/engine-health-monitor.d.ts.map +1 -0
- package/dist/src/gateway/engine-health-monitor.js +221 -0
- package/dist/src/gateway/engine-health-monitor.js.map +1 -0
- package/dist/src/gateway/files.d.ts +7 -1
- package/dist/src/gateway/files.d.ts.map +1 -1
- package/dist/src/gateway/files.js +110 -217
- package/dist/src/gateway/files.js.map +1 -1
- package/dist/src/gateway/onboarding-personalize.d.ts +2 -0
- package/dist/src/gateway/onboarding-personalize.d.ts.map +1 -1
- package/dist/src/gateway/onboarding-personalize.js +17 -1
- package/dist/src/gateway/onboarding-personalize.js.map +1 -1
- package/dist/src/gateway/portal-config.d.ts +17 -3
- package/dist/src/gateway/portal-config.d.ts.map +1 -1
- package/dist/src/gateway/portal-config.js +52 -3
- package/dist/src/gateway/portal-config.js.map +1 -1
- package/dist/src/gateway/request-origin.d.ts +9 -0
- package/dist/src/gateway/request-origin.d.ts.map +1 -1
- package/dist/src/gateway/request-origin.js +10 -0
- package/dist/src/gateway/request-origin.js.map +1 -1
- package/dist/src/gateway/server.d.ts.map +1 -1
- package/dist/src/gateway/server.js +82 -59
- package/dist/src/gateway/server.js.map +1 -1
- package/dist/src/gateway/slack-connect-rollback.d.ts +23 -0
- package/dist/src/gateway/slack-connect-rollback.d.ts.map +1 -0
- package/dist/src/gateway/slack-connect-rollback.js +53 -0
- package/dist/src/gateway/slack-connect-rollback.js.map +1 -0
- package/dist/src/gateway/status-reconciler.d.ts +25 -7
- package/dist/src/gateway/status-reconciler.d.ts.map +1 -1
- package/dist/src/gateway/status-reconciler.js +86 -43
- package/dist/src/gateway/status-reconciler.js.map +1 -1
- package/dist/src/gateway/watcher.d.ts.map +1 -1
- package/dist/src/gateway/watcher.js +44 -3
- package/dist/src/gateway/watcher.js.map +1 -1
- package/dist/src/mcp/gateway-server.js +21 -3
- package/dist/src/mcp/gateway-server.js.map +1 -1
- package/dist/src/mcp/resolver.d.ts.map +1 -1
- package/dist/src/mcp/resolver.js +51 -1
- package/dist/src/mcp/resolver.js.map +1 -1
- package/dist/src/models/service.d.ts.map +1 -1
- package/dist/src/models/service.js +14 -8
- package/dist/src/models/service.js.map +1 -1
- package/dist/src/provider-auth/discovery.d.ts +16 -0
- package/dist/src/provider-auth/discovery.d.ts.map +1 -0
- package/dist/src/provider-auth/discovery.js +66 -0
- package/dist/src/provider-auth/discovery.js.map +1 -0
- package/dist/src/provider-auth/failure-notices.d.ts +29 -0
- package/dist/src/provider-auth/failure-notices.d.ts.map +1 -0
- package/dist/src/provider-auth/failure-notices.js +48 -0
- package/dist/src/provider-auth/failure-notices.js.map +1 -0
- package/dist/src/provider-auth/failure-signal.d.ts +22 -0
- package/dist/src/provider-auth/failure-signal.d.ts.map +1 -0
- package/dist/src/provider-auth/failure-signal.js +79 -0
- package/dist/src/provider-auth/failure-signal.js.map +1 -0
- package/dist/src/provider-auth/index.d.ts +26 -0
- package/dist/src/provider-auth/index.d.ts.map +1 -0
- package/dist/src/provider-auth/index.js +51 -0
- package/dist/src/provider-auth/index.js.map +1 -0
- package/dist/src/provider-auth/input.d.ts +44 -0
- package/dist/src/provider-auth/input.d.ts.map +1 -0
- package/dist/src/provider-auth/input.js +86 -0
- package/dist/src/provider-auth/input.js.map +1 -0
- package/dist/src/provider-auth/providers.d.ts +26 -0
- package/dist/src/provider-auth/providers.d.ts.map +1 -0
- package/dist/src/provider-auth/providers.js +86 -0
- package/dist/src/provider-auth/providers.js.map +1 -0
- package/dist/src/provider-auth/runtime.d.ts +21 -0
- package/dist/src/provider-auth/runtime.d.ts.map +1 -0
- package/dist/src/provider-auth/runtime.js +104 -0
- package/dist/src/provider-auth/runtime.js.map +1 -0
- package/dist/src/provider-auth/service.d.ts +70 -0
- package/dist/src/provider-auth/service.d.ts.map +1 -0
- package/dist/src/provider-auth/service.js +349 -0
- package/dist/src/provider-auth/service.js.map +1 -0
- package/dist/src/provider-auth/terminal.d.ts +21 -0
- package/dist/src/provider-auth/terminal.d.ts.map +1 -0
- package/dist/src/provider-auth/terminal.js +46 -0
- package/dist/src/provider-auth/terminal.js.map +1 -0
- package/dist/src/provider-auth/types.d.ts +123 -0
- package/dist/src/provider-auth/types.d.ts.map +1 -0
- package/dist/src/provider-auth/types.js +10 -0
- package/dist/src/provider-auth/types.js.map +1 -0
- package/dist/src/sessions/accounting.d.ts +3 -0
- package/dist/src/sessions/accounting.d.ts.map +1 -1
- package/dist/src/sessions/accounting.js +5 -0
- package/dist/src/sessions/accounting.js.map +1 -1
- package/dist/src/sessions/backup-integrity.d.ts +45 -0
- package/dist/src/sessions/backup-integrity.d.ts.map +1 -0
- package/dist/src/sessions/backup-integrity.js +122 -0
- package/dist/src/sessions/backup-integrity.js.map +1 -0
- package/dist/src/sessions/backup.d.ts +40 -2
- package/dist/src/sessions/backup.d.ts.map +1 -1
- package/dist/src/sessions/backup.js +88 -12
- package/dist/src/sessions/backup.js.map +1 -1
- package/dist/src/sessions/callbacks.d.ts +9 -0
- package/dist/src/sessions/callbacks.d.ts.map +1 -1
- package/dist/src/sessions/callbacks.js +55 -10
- package/dist/src/sessions/callbacks.js.map +1 -1
- package/dist/src/sessions/completion-batching.d.ts +82 -0
- package/dist/src/sessions/completion-batching.d.ts.map +1 -0
- package/dist/src/sessions/completion-batching.js +126 -0
- package/dist/src/sessions/completion-batching.js.map +1 -0
- package/dist/src/sessions/connector-command-guard.d.ts +66 -0
- package/dist/src/sessions/connector-command-guard.d.ts.map +1 -0
- package/dist/src/sessions/connector-command-guard.js +145 -0
- package/dist/src/sessions/connector-command-guard.js.map +1 -0
- package/dist/src/sessions/context.d.ts.map +1 -1
- package/dist/src/sessions/context.js +3 -4
- package/dist/src/sessions/context.js.map +1 -1
- package/dist/src/sessions/engine-fallback.d.ts +43 -1
- package/dist/src/sessions/engine-fallback.d.ts.map +1 -1
- package/dist/src/sessions/engine-fallback.js +266 -15
- package/dist/src/sessions/engine-fallback.js.map +1 -1
- package/dist/src/sessions/engine-health-gate.d.ts +83 -0
- package/dist/src/sessions/engine-health-gate.d.ts.map +1 -0
- package/dist/src/sessions/engine-health-gate.js +186 -0
- package/dist/src/sessions/engine-health-gate.js.map +1 -0
- package/dist/src/sessions/engine-login.d.ts +58 -0
- package/dist/src/sessions/engine-login.d.ts.map +1 -0
- package/dist/src/sessions/engine-login.js +107 -0
- package/dist/src/sessions/engine-login.js.map +1 -0
- package/dist/src/sessions/fork.d.ts.map +1 -1
- package/dist/src/sessions/fork.js +3 -1
- package/dist/src/sessions/fork.js.map +1 -1
- package/dist/src/sessions/goal-execution.d.ts.map +1 -1
- package/dist/src/sessions/goal-execution.js +8 -1
- package/dist/src/sessions/goal-execution.js.map +1 -1
- package/dist/src/sessions/limit-failure-notice.d.ts +41 -0
- package/dist/src/sessions/limit-failure-notice.d.ts.map +1 -0
- package/dist/src/sessions/limit-failure-notice.js +87 -0
- package/dist/src/sessions/limit-failure-notice.js.map +1 -0
- package/dist/src/sessions/lost-turn.d.ts +39 -0
- package/dist/src/sessions/lost-turn.d.ts.map +1 -0
- package/dist/src/sessions/lost-turn.js +32 -0
- package/dist/src/sessions/lost-turn.js.map +1 -0
- package/dist/src/sessions/manager.d.ts.map +1 -1
- package/dist/src/sessions/manager.js +104 -47
- package/dist/src/sessions/manager.js.map +1 -1
- package/dist/src/sessions/new-session-engine.d.ts +42 -0
- package/dist/src/sessions/new-session-engine.d.ts.map +1 -0
- package/dist/src/sessions/new-session-engine.js +100 -0
- package/dist/src/sessions/new-session-engine.js.map +1 -0
- package/dist/src/sessions/origin-delivery.d.ts +50 -4
- package/dist/src/sessions/origin-delivery.d.ts.map +1 -1
- package/dist/src/sessions/origin-delivery.js +108 -9
- package/dist/src/sessions/origin-delivery.js.map +1 -1
- package/dist/src/sessions/queue.d.ts +14 -0
- package/dist/src/sessions/queue.d.ts.map +1 -1
- package/dist/src/sessions/queue.js +38 -2
- package/dist/src/sessions/queue.js.map +1 -1
- package/dist/src/sessions/registry.d.ts +4 -2
- package/dist/src/sessions/registry.d.ts.map +1 -1
- package/dist/src/sessions/registry.js +21 -4
- package/dist/src/sessions/registry.js.map +1 -1
- package/dist/src/sessions/reply-disposition.d.ts +8 -0
- package/dist/src/sessions/reply-disposition.d.ts.map +1 -1
- package/dist/src/sessions/reply-disposition.js +8 -0
- package/dist/src/sessions/reply-disposition.js.map +1 -1
- package/dist/src/sessions/restart-resume.d.ts +234 -0
- package/dist/src/sessions/restart-resume.d.ts.map +1 -0
- package/dist/src/sessions/restart-resume.js +596 -0
- package/dist/src/sessions/restart-resume.js.map +1 -0
- package/dist/src/sessions/speaker-prefix.d.ts.map +1 -1
- package/dist/src/sessions/speaker-prefix.js +3 -1
- package/dist/src/sessions/speaker-prefix.js.map +1 -1
- package/dist/src/sessions/turn-delivery.d.ts +26 -0
- package/dist/src/sessions/turn-delivery.d.ts.map +1 -0
- package/dist/src/sessions/turn-delivery.js +34 -0
- package/dist/src/sessions/turn-delivery.js.map +1 -0
- package/dist/src/sessions/unrequested-stop.d.ts +26 -0
- package/dist/src/sessions/unrequested-stop.d.ts.map +1 -0
- package/dist/src/sessions/unrequested-stop.js +19 -0
- package/dist/src/sessions/unrequested-stop.js.map +1 -0
- package/dist/src/sessions/usage-limit-wait.d.ts +14 -0
- package/dist/src/sessions/usage-limit-wait.d.ts.map +1 -0
- package/dist/src/sessions/usage-limit-wait.js +9 -0
- package/dist/src/sessions/usage-limit-wait.js.map +1 -0
- package/dist/src/shared/attachment-download.d.ts +41 -0
- package/dist/src/shared/attachment-download.d.ts.map +1 -0
- package/dist/src/shared/attachment-download.js +110 -0
- package/dist/src/shared/attachment-download.js.map +1 -0
- package/dist/src/shared/attachment-notice.d.ts +24 -0
- package/dist/src/shared/attachment-notice.d.ts.map +1 -0
- package/dist/src/shared/attachment-notice.js +37 -0
- package/dist/src/shared/attachment-notice.js.map +1 -0
- package/dist/src/shared/attachments.d.ts +65 -0
- package/dist/src/shared/attachments.d.ts.map +1 -0
- package/dist/src/shared/attachments.js +153 -0
- package/dist/src/shared/attachments.js.map +1 -0
- package/dist/src/shared/childEnv.d.ts +15 -0
- package/dist/src/shared/childEnv.d.ts.map +1 -1
- package/dist/src/shared/childEnv.js +15 -0
- package/dist/src/shared/childEnv.js.map +1 -1
- package/dist/src/shared/claude-auto-memory.d.ts +33 -0
- package/dist/src/shared/claude-auto-memory.d.ts.map +1 -0
- package/dist/src/shared/claude-auto-memory.js +156 -0
- package/dist/src/shared/claude-auto-memory.js.map +1 -0
- package/dist/src/shared/claude-limit-reset.d.ts +54 -0
- package/dist/src/shared/claude-limit-reset.d.ts.map +1 -0
- package/dist/src/shared/claude-limit-reset.js +99 -0
- package/dist/src/shared/claude-limit-reset.js.map +1 -0
- package/dist/src/shared/config-error.d.ts +21 -0
- package/dist/src/shared/config-error.d.ts.map +1 -0
- package/dist/src/shared/config-error.js +37 -0
- package/dist/src/shared/config-error.js.map +1 -0
- package/dist/src/shared/config-file.d.ts +57 -0
- package/dist/src/shared/config-file.d.ts.map +1 -0
- package/dist/src/shared/config-file.js +217 -0
- package/dist/src/shared/config-file.js.map +1 -0
- package/dist/src/shared/config-yaml-edit.d.ts +20 -0
- package/dist/src/shared/config-yaml-edit.d.ts.map +1 -0
- package/dist/src/shared/config-yaml-edit.js +468 -0
- package/dist/src/shared/config-yaml-edit.js.map +1 -0
- package/dist/src/shared/config.d.ts.map +1 -1
- package/dist/src/shared/config.js +12 -4
- package/dist/src/shared/config.js.map +1 -1
- package/dist/src/shared/engine-fallback.d.ts +22 -0
- package/dist/src/shared/engine-fallback.d.ts.map +1 -1
- package/dist/src/shared/engine-fallback.js +55 -4
- package/dist/src/shared/engine-fallback.js.map +1 -1
- package/dist/src/shared/engine-health.d.ts +16 -0
- package/dist/src/shared/engine-health.d.ts.map +1 -1
- package/dist/src/shared/engine-health.js +42 -0
- package/dist/src/shared/engine-health.js.map +1 -1
- package/dist/src/shared/list-alignment.d.ts +23 -0
- package/dist/src/shared/list-alignment.d.ts.map +1 -0
- package/dist/src/shared/list-alignment.js +61 -0
- package/dist/src/shared/list-alignment.js.map +1 -0
- package/dist/src/shared/logger.d.ts.map +1 -1
- package/dist/src/shared/logger.js +104 -33
- package/dist/src/shared/logger.js.map +1 -1
- package/dist/src/shared/map-limited.d.ts +11 -0
- package/dist/src/shared/map-limited.d.ts.map +1 -0
- package/dist/src/shared/map-limited.js +30 -0
- package/dist/src/shared/map-limited.js.map +1 -0
- package/dist/src/shared/oneShotCli.d.ts.map +1 -1
- package/dist/src/shared/oneShotCli.js +4 -2
- package/dist/src/shared/oneShotCli.js.map +1 -1
- package/dist/src/shared/partial-delivery.d.ts +24 -0
- package/dist/src/shared/partial-delivery.d.ts.map +1 -0
- package/dist/src/shared/partial-delivery.js +46 -0
- package/dist/src/shared/partial-delivery.js.map +1 -0
- package/dist/src/shared/process-safety-net.d.ts +44 -0
- package/dist/src/shared/process-safety-net.d.ts.map +1 -0
- package/dist/src/shared/process-safety-net.js +88 -0
- package/dist/src/shared/process-safety-net.js.map +1 -0
- package/dist/src/shared/rateLimit.d.ts +45 -2
- package/dist/src/shared/rateLimit.d.ts.map +1 -1
- package/dist/src/shared/rateLimit.js +64 -2
- package/dist/src/shared/rateLimit.js.map +1 -1
- package/dist/src/shared/redact.d.ts.map +1 -1
- package/dist/src/shared/redact.js +11 -1
- package/dist/src/shared/redact.js.map +1 -1
- package/dist/src/shared/safe-file-name.d.ts +9 -0
- package/dist/src/shared/safe-file-name.d.ts.map +1 -0
- package/dist/src/shared/safe-file-name.js +16 -0
- package/dist/src/shared/safe-file-name.js.map +1 -0
- package/dist/src/shared/terminal-safe-text.d.ts +2 -0
- package/dist/src/shared/terminal-safe-text.d.ts.map +1 -0
- package/dist/src/shared/terminal-safe-text.js +21 -0
- package/dist/src/shared/terminal-safe-text.js.map +1 -0
- package/dist/src/shared/types.d.ts +75 -4
- package/dist/src/shared/types.d.ts.map +1 -1
- package/dist/src/skills-sync/apply.d.ts +21 -0
- package/dist/src/skills-sync/apply.d.ts.map +1 -0
- package/dist/src/skills-sync/apply.js +209 -0
- package/dist/src/skills-sync/apply.js.map +1 -0
- package/dist/src/skills-sync/backup-run.d.ts +47 -0
- package/dist/src/skills-sync/backup-run.d.ts.map +1 -0
- package/dist/src/skills-sync/backup-run.js +150 -0
- package/dist/src/skills-sync/backup-run.js.map +1 -0
- package/dist/src/skills-sync/bounded-read.d.ts +32 -0
- package/dist/src/skills-sync/bounded-read.d.ts.map +1 -0
- package/dist/src/skills-sync/bounded-read.js +104 -0
- package/dist/src/skills-sync/bounded-read.js.map +1 -0
- package/dist/src/skills-sync/bundled.d.ts +28 -0
- package/dist/src/skills-sync/bundled.d.ts.map +1 -0
- package/dist/src/skills-sync/bundled.js +84 -0
- package/dist/src/skills-sync/bundled.js.map +1 -0
- package/dist/src/skills-sync/fingerprint.d.ts +32 -0
- package/dist/src/skills-sync/fingerprint.d.ts.map +1 -0
- package/dist/src/skills-sync/fingerprint.js +58 -0
- package/dist/src/skills-sync/fingerprint.js.map +1 -0
- package/dist/src/skills-sync/history.d.ts +44 -0
- package/dist/src/skills-sync/history.d.ts.map +1 -0
- package/dist/src/skills-sync/history.js +115 -0
- package/dist/src/skills-sync/history.js.map +1 -0
- package/dist/src/skills-sync/home-skill.d.ts +28 -0
- package/dist/src/skills-sync/home-skill.d.ts.map +1 -0
- package/dist/src/skills-sync/home-skill.js +67 -0
- package/dist/src/skills-sync/home-skill.js.map +1 -0
- package/dist/src/skills-sync/instance.d.ts +26 -0
- package/dist/src/skills-sync/instance.d.ts.map +1 -0
- package/dist/src/skills-sync/instance.js +128 -0
- package/dist/src/skills-sync/instance.js.map +1 -0
- package/dist/src/skills-sync/names.d.ts +25 -0
- package/dist/src/skills-sync/names.d.ts.map +1 -0
- package/dist/src/skills-sync/names.js +56 -0
- package/dist/src/skills-sync/names.js.map +1 -0
- package/dist/src/skills-sync/plan.d.ts +58 -0
- package/dist/src/skills-sync/plan.d.ts.map +1 -0
- package/dist/src/skills-sync/plan.js +132 -0
- package/dist/src/skills-sync/plan.js.map +1 -0
- package/dist/src/skills-sync/receipt.d.ts +61 -0
- package/dist/src/skills-sync/receipt.d.ts.map +1 -0
- package/dist/src/skills-sync/receipt.js +149 -0
- package/dist/src/skills-sync/receipt.js.map +1 -0
- package/dist/src/skills-sync/staging.d.ts +21 -0
- package/dist/src/skills-sync/staging.d.ts.map +1 -0
- package/dist/src/skills-sync/staging.js +81 -0
- package/dist/src/skills-sync/staging.js.map +1 -0
- package/dist/src/skills-sync/sync.d.ts +37 -0
- package/dist/src/skills-sync/sync.d.ts.map +1 -0
- package/dist/src/skills-sync/sync.js +201 -0
- package/dist/src/skills-sync/sync.js.map +1 -0
- package/dist/src/skills-sync/types.d.ts +66 -0
- package/dist/src/skills-sync/types.d.ts.map +1 -0
- package/dist/src/skills-sync/types.js +2 -0
- package/dist/src/skills-sync/types.js.map +1 -0
- package/dist/src/stt/config.d.ts +5 -0
- package/dist/src/stt/config.d.ts.map +1 -0
- package/dist/src/stt/config.js +18 -0
- package/dist/src/stt/config.js.map +1 -0
- package/dist/src/updates/maintenance.d.ts.map +1 -1
- package/dist/src/updates/maintenance.js +24 -4
- package/dist/src/updates/maintenance.js.map +1 -1
- package/dist/src/workflows/repository-mutex.d.ts +1 -1
- package/dist/web/404.html +1 -1
- package/dist/web/__next.__PAGE__.txt +11 -11
- package/dist/web/__next._full.txt +12 -12
- package/dist/web/__next._tree.txt +2 -2
- package/dist/web/_next/static/chunks/{0g5c5ppr8zmup.js → 20v6mri7epga5.js} +1 -1
- package/dist/web/_next/static/chunks/2u0328ngpt-ek.js +1 -0
- package/dist/web/_next/static/chunks/3f9i3f9q6v6_j.css +1 -0
- package/dist/web/_next/static/chunks/{08i7uo3uz6_fn.js → 3yy053rafgrzy.js} +1 -1
- package/dist/web/_not-found/__next._full.txt +10 -10
- package/dist/web/_not-found/__next._not-found.__PAGE__.txt +9 -9
- package/dist/web/_not-found/__next._tree.txt +2 -2
- package/dist/web/_not-found.html +1 -1
- package/dist/web/_not-found.txt +10 -10
- package/dist/web/chat/__next._full.txt +12 -12
- package/dist/web/chat/__next._tree.txt +2 -2
- package/dist/web/chat/__next.chat.__PAGE__.txt +11 -11
- package/dist/web/chat.html +1 -1
- package/dist/web/chat.txt +12 -12
- package/dist/web/cron/__next._full.txt +12 -12
- package/dist/web/cron/__next._tree.txt +2 -2
- package/dist/web/cron/__next.cron.__PAGE__.txt +11 -11
- package/dist/web/cron.html +1 -1
- package/dist/web/cron.txt +12 -12
- package/dist/web/index.html +1 -1
- package/dist/web/index.txt +12 -12
- package/dist/web/kanban/__next._full.txt +12 -12
- package/dist/web/kanban/__next._tree.txt +2 -2
- package/dist/web/kanban/__next.kanban.__PAGE__.txt +11 -11
- package/dist/web/kanban.html +1 -1
- package/dist/web/kanban.txt +12 -12
- package/dist/web/logs/__next._full.txt +12 -12
- package/dist/web/logs/__next._tree.txt +2 -2
- package/dist/web/logs/__next.logs.__PAGE__.txt +11 -11
- package/dist/web/logs.html +1 -1
- package/dist/web/logs.txt +12 -12
- package/dist/web/models/__next._full.txt +12 -12
- package/dist/web/models/__next._tree.txt +2 -2
- package/dist/web/models/__next.models.__PAGE__.txt +11 -11
- package/dist/web/models.html +1 -1
- package/dist/web/models.txt +12 -12
- package/dist/web/org/__next._full.txt +12 -12
- package/dist/web/org/__next._tree.txt +2 -2
- package/dist/web/org/__next.org.__PAGE__.txt +11 -11
- package/dist/web/org.html +1 -1
- package/dist/web/org.txt +12 -12
- package/dist/web/sessions/__next._full.txt +10 -10
- package/dist/web/sessions/__next._tree.txt +2 -2
- package/dist/web/sessions/__next.sessions.__PAGE__.txt +9 -9
- package/dist/web/sessions.html +1 -1
- package/dist/web/sessions.txt +10 -10
- package/dist/web/settings/__next._full.txt +12 -12
- package/dist/web/settings/__next._tree.txt +2 -2
- package/dist/web/settings/__next.settings.__PAGE__.txt +11 -11
- package/dist/web/settings.html +1 -1
- package/dist/web/settings.txt +12 -12
- package/dist/web/skills/__next._full.txt +12 -12
- package/dist/web/skills/__next._tree.txt +2 -2
- package/dist/web/skills/__next.skills.__PAGE__.txt +11 -11
- package/dist/web/skills.html +1 -1
- package/dist/web/skills.txt +12 -12
- package/package.json +2 -1
- package/template/AGENTS.md +48 -308
- package/template/CLAUDE.md +4 -349
- package/template/bundled-skill-history.json +377 -0
- package/template/config.default.yaml +52 -3
- package/template/docs/architecture.md +41 -3
- package/template/docs/backup.md +142 -0
- package/template/docs/connectors.md +192 -16
- package/template/docs/cron.md +30 -11
- package/template/docs/memory.md +47 -0
- package/template/docs/overview.md +6 -2
- package/template/docs/self-modification.md +11 -10
- package/template/docs/skills.md +77 -4
- package/template/migrations/0.3.0/MIGRATION.md +6 -0
- package/template/migrations/0.7.3/MIGRATION.md +6 -0
- package/template/migrations/0.7.5/MIGRATION.md +1 -1
- package/template/migrations/0.9.0/MIGRATION.md +6 -0
- package/template/migrations/2026.10.13/MIGRATION.md +76 -0
- package/template/migrations/2026.10.13/files/docs/architecture.md +112 -0
- package/template/migrations/2026.10.13/files/docs/automations.md +110 -0
- package/template/migrations/2026.10.13/files/docs/backup.md +142 -0
- package/template/migrations/2026.10.13/files/docs/connectors.md +370 -0
- package/template/migrations/2026.10.13/files/docs/cron-commands.md +52 -0
- package/template/migrations/2026.10.13/files/docs/cron.md +178 -0
- package/template/migrations/2026.10.13/files/docs/mcp.md +108 -0
- package/template/migrations/2026.10.13/files/docs/memory.md +47 -0
- package/template/migrations/2026.10.13/files/docs/org.md +111 -0
- package/template/migrations/2026.10.13/files/docs/overview.md +44 -0
- package/template/migrations/2026.10.13/files/docs/self-modification.md +71 -0
- package/template/migrations/2026.10.13/files/docs/skills.md +140 -0
- package/template/migrations/2026.10.13/files/skills/cron-manager/SKILL.md +107 -0
- package/template/migrations/2026.10.13/files/skills/management/SKILL.md +227 -0
- package/template/migrations/2026.10.13/files/skills/migrate/SKILL.md +194 -0
- package/template/migrations/2026.10.13/files/skills/onboarding/SKILL.md +153 -0
- package/template/migrations/2026.10.13/files/skills/openryoko-config/SKILL.md +35 -0
- package/template/migrations/2026.10.13/files/skills/openryoko-config/references/engine-fallback.md +98 -0
- package/template/migrations/2026.10.13/files/skills/openryoko-config/references/jev.md +89 -0
- package/template/migrations/2026.10.13/files/skills/openryoko-config/references/maintenance.md +49 -0
- package/template/migrations/2026.10.13/files/skills/openryoko-config/references/platform.md +100 -0
- package/template/migrations/2026.10.13/files/skills/self-heal/SKILL.md +187 -0
- package/template/migrations/2026.10.9/MIGRATION.md +44 -0
- package/template/migrations/2026.10.9/files/docs/memory.md +47 -0
- package/template/migrations/2026.10.9/files/skills/migrate/SKILL.md +194 -0
- package/template/migrations/2026.5.7/MIGRATION.md +6 -0
- package/template/migrations/2026.8.28/MIGRATION.md +6 -0
- package/template/migrations/2026.9.11/MIGRATION.md +6 -0
- package/template/skills/cron-manager/SKILL.md +10 -0
- package/template/skills/management/SKILL.md +5 -4
- package/template/skills/migrate/SKILL.md +47 -14
- package/template/skills/onboarding/SKILL.md +3 -3
- package/template/skills/openryoko-config/SKILL.md +1 -1
- package/template/skills/openryoko-config/references/engine-fallback.md +16 -5
- package/template/skills/openryoko-config/references/platform.md +23 -4
- package/template/skills/self-heal/SKILL.md +117 -44
- package/dist/src/engines/mock.d.ts +0 -16
- package/dist/src/engines/mock.d.ts.map +0 -1
- package/dist/src/engines/mock.js +0 -47
- package/dist/src/engines/mock.js.map +0 -1
- package/dist/src/shared/test-support/posix-mode.d.ts +0 -17
- package/dist/src/shared/test-support/posix-mode.d.ts.map +0 -1
- package/dist/src/shared/test-support/posix-mode.js +0 -23
- package/dist/src/shared/test-support/posix-mode.js.map +0 -1
- package/dist/web/_next/static/Oux0UBcCkbX5eOp9-vC4k/_buildManifest.js +0 -11
- package/dist/web/_next/static/Oux0UBcCkbX5eOp9-vC4k/_clientMiddlewareManifest.js +0 -1
- package/dist/web/_next/static/Oux0UBcCkbX5eOp9-vC4k/_ssgManifest.js +0 -1
- package/dist/web/_next/static/chunks/02h65sho8c14h.js +0 -1
- package/dist/web/_next/static/chunks/0ic18n-m7ixyw.css +0 -1
- package/dist/web/_next/static/chunks/19s8vn2kgy7q1.js +0 -1
- package/dist/web/_next/static/chunks/1_jm0szyu2the.js +0 -1
- package/dist/web/_next/static/chunks/1omdg4m5w9lgx.js +0 -1
- package/dist/web/_next/static/chunks/25nob1new8t4s.js +0 -79
- package/dist/web/_next/static/chunks/2iqxlc9wtxzm2.js +0 -1
- package/dist/web/_next/static/chunks/3_6klkygi417n.js +0 -1
- package/dist/web/_next/static/chunks/3alc-b00c58_3.css +0 -1
- /package/dist/web/_next/static/{70PNIyOj8-2kywAG6J41- → ov0mWzyHx0B5oEnTHE_pa}/_buildManifest.js +0 -0
- /package/dist/web/_next/static/{70PNIyOj8-2kywAG6J41- → ov0mWzyHx0B5oEnTHE_pa}/_clientMiddlewareManifest.js +0 -0
- /package/dist/web/_next/static/{70PNIyOj8-2kywAG6J41- → ov0mWzyHx0B5oEnTHE_pa}/_ssgManifest.js +0 -0
|
@@ -0,0 +1,150 @@
|
|
|
1
|
+
import fs from "node:fs";
|
|
2
|
+
import path from "node:path";
|
|
3
|
+
/**
|
|
4
|
+
* Where whatever the sync takes out of the way goes:
|
|
5
|
+
* <home>/.migration-backups/<version>-<time>/skills/<name>/ for a replaced or retired
|
|
6
|
+
* skill, and .../staging/<name>/ for a staging directory left in the home.
|
|
7
|
+
*/
|
|
8
|
+
export const BACKUP_ROOT = ".migration-backups";
|
|
9
|
+
const messageOf = (error) => (error instanceof Error ? error.message : String(error));
|
|
10
|
+
/** A replacement failed and so did putting the previous copy back: the skill is now
|
|
11
|
+
* missing from skills/, moved there by the sync itself and not by the operator. */
|
|
12
|
+
export class SkillLostError extends Error {
|
|
13
|
+
}
|
|
14
|
+
/** A backup root that is already a link refuses the whole run, before any write. */
|
|
15
|
+
export function assertBackupRootUsable(home) {
|
|
16
|
+
const root = path.join(home, BACKUP_ROOT);
|
|
17
|
+
let stat;
|
|
18
|
+
try {
|
|
19
|
+
stat = fs.lstatSync(root);
|
|
20
|
+
}
|
|
21
|
+
catch (error) {
|
|
22
|
+
if (error.code === "ENOENT")
|
|
23
|
+
return;
|
|
24
|
+
throw error;
|
|
25
|
+
}
|
|
26
|
+
if (!stat.isDirectory())
|
|
27
|
+
throw new Error(`${root} is not a plain directory, so nothing can be backed up into it`);
|
|
28
|
+
}
|
|
29
|
+
/**
|
|
30
|
+
* Is this path, right now, the real directory it is supposed to be? `directory` is
|
|
31
|
+
* built from the home's real path, so it resolves to itself only while no part of it
|
|
32
|
+
* has been replaced by a link. Called immediately before a rename, never earlier.
|
|
33
|
+
*/
|
|
34
|
+
export function assertPlainDirectory(directory) {
|
|
35
|
+
if (!fs.lstatSync(directory).isDirectory() || fs.realpathSync(directory) !== directory) {
|
|
36
|
+
throw new Error(`${directory} is not a plain directory inside the instance home`);
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
* One backup directory per run, created only when something is about to be moved into
|
|
41
|
+
* it. Everything the sync takes out of the way is moved here with one rename: nothing
|
|
42
|
+
* is deleted, and nothing inside what is moved is read or followed.
|
|
43
|
+
*/
|
|
44
|
+
export function backupRun(context) {
|
|
45
|
+
const root = path.join(context.home, BACKUP_ROOT);
|
|
46
|
+
let run = null;
|
|
47
|
+
let held = 0;
|
|
48
|
+
/** <run>/skills or <run>/staging, made the first time something goes there. */
|
|
49
|
+
const room = (kind) => {
|
|
50
|
+
run ??= { ...createRun(root, context), rooms: new Map() };
|
|
51
|
+
const made = run.rooms.get(kind);
|
|
52
|
+
if (made !== undefined)
|
|
53
|
+
return made;
|
|
54
|
+
const directory = path.join(run.directory, kind);
|
|
55
|
+
fs.mkdirSync(directory);
|
|
56
|
+
run.rooms.set(kind, directory);
|
|
57
|
+
return directory;
|
|
58
|
+
};
|
|
59
|
+
return {
|
|
60
|
+
/** Move a skill out of skills/ and return where it went. */
|
|
61
|
+
take(name, source) {
|
|
62
|
+
const skills = room("skills");
|
|
63
|
+
const target = path.join(skills, name);
|
|
64
|
+
// skills/ last, as everywhere: it is the end the user's own directories hang off.
|
|
65
|
+
assertPlainDirectory(skills);
|
|
66
|
+
assertPlainDirectory(context.skillsRoot);
|
|
67
|
+
fs.renameSync(source, target);
|
|
68
|
+
held += 1;
|
|
69
|
+
return target;
|
|
70
|
+
},
|
|
71
|
+
/** Undo `take` after a failed replacement. */
|
|
72
|
+
giveBack(previous, destination) {
|
|
73
|
+
try {
|
|
74
|
+
assertPlainDirectory(context.skillsRoot);
|
|
75
|
+
fs.renameSync(previous, destination);
|
|
76
|
+
}
|
|
77
|
+
catch (error) {
|
|
78
|
+
throw new SkillLostError(`its previous copy could not be put back and is at ${previous} (${messageOf(error)})`);
|
|
79
|
+
}
|
|
80
|
+
held -= 1;
|
|
81
|
+
},
|
|
82
|
+
/**
|
|
83
|
+
* Move a staging directory out of the top of the home, whole, and return where it
|
|
84
|
+
* went. It has to be a real directory sitting directly in the home, and it goes to
|
|
85
|
+
* a real directory inside this run's: the same two checks as for a skill, with the
|
|
86
|
+
* end through which something could leave the home checked last.
|
|
87
|
+
*/
|
|
88
|
+
setAside(source) {
|
|
89
|
+
const staging = room("staging");
|
|
90
|
+
const target = path.join(staging, path.basename(source));
|
|
91
|
+
assertPlainDirectory(source);
|
|
92
|
+
assertPlainDirectory(staging);
|
|
93
|
+
fs.renameSync(source, target);
|
|
94
|
+
held += 1;
|
|
95
|
+
return target;
|
|
96
|
+
},
|
|
97
|
+
/** Where what was moved is, or null — with nothing left behind — when nothing ended up there. */
|
|
98
|
+
finish() {
|
|
99
|
+
if (!run)
|
|
100
|
+
return null;
|
|
101
|
+
// rmdir removes a directory only if it is empty, and never follows a link.
|
|
102
|
+
for (const directory of run.rooms.values()) {
|
|
103
|
+
try {
|
|
104
|
+
fs.rmdirSync(directory);
|
|
105
|
+
}
|
|
106
|
+
catch { /* it holds something */ }
|
|
107
|
+
}
|
|
108
|
+
if (held > 0)
|
|
109
|
+
return run.directory;
|
|
110
|
+
for (const empty of [run.directory, ...(run.createdRoot ? [root] : [])]) {
|
|
111
|
+
try {
|
|
112
|
+
fs.rmdirSync(empty);
|
|
113
|
+
}
|
|
114
|
+
catch {
|
|
115
|
+
break;
|
|
116
|
+
}
|
|
117
|
+
}
|
|
118
|
+
return null;
|
|
119
|
+
},
|
|
120
|
+
};
|
|
121
|
+
}
|
|
122
|
+
/** Create <root>/<version>-<time>. Nothing is created through a link: the root is made
|
|
123
|
+
* without following one, and must be a real directory once it exists. */
|
|
124
|
+
function createRun(root, context) {
|
|
125
|
+
let createdRoot = true;
|
|
126
|
+
try {
|
|
127
|
+
fs.mkdirSync(root);
|
|
128
|
+
}
|
|
129
|
+
catch (error) {
|
|
130
|
+
if (error.code !== "EEXIST")
|
|
131
|
+
throw error;
|
|
132
|
+
createdRoot = false;
|
|
133
|
+
}
|
|
134
|
+
if (!fs.lstatSync(root).isDirectory())
|
|
135
|
+
throw new Error(`${root} is not a plain directory, so nothing can be backed up into it`);
|
|
136
|
+
const version = context.packageVersion.replace(/[^A-Za-z0-9._+-]/g, "_") || "unknown";
|
|
137
|
+
const base = `${version}-${context.now.toISOString().replace(/[:.]/g, "-")}`;
|
|
138
|
+
for (let attempt = 1;; attempt++) {
|
|
139
|
+
const directory = path.join(root, attempt === 1 ? base : `${base}-${attempt}`);
|
|
140
|
+
try {
|
|
141
|
+
fs.mkdirSync(directory);
|
|
142
|
+
return { directory, createdRoot };
|
|
143
|
+
}
|
|
144
|
+
catch (error) {
|
|
145
|
+
if (error.code !== "EEXIST" || attempt >= 100)
|
|
146
|
+
throw error;
|
|
147
|
+
}
|
|
148
|
+
}
|
|
149
|
+
}
|
|
150
|
+
//# sourceMappingURL=backup-run.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"backup-run.js","sourceRoot":"","sources":["../../../src/skills-sync/backup-run.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
/** A receipt for a few dozen skills is a few kilobytes. Anything near this is not one. */
|
|
2
|
+
export declare const MAX_RECEIPT_BYTES: number;
|
|
3
|
+
/** One file of a skill. Bundled skill files are text; the largest ships at 13 KB. */
|
|
4
|
+
export declare const MAX_SKILL_FILE_BYTES: number;
|
|
5
|
+
/** All the files of one skill together. The largest bundled skill is 35 KB. Without
|
|
6
|
+
* this, a skill of many files each just under the limit above is gigabytes to hash. */
|
|
7
|
+
export declare const MAX_SKILL_BYTES: number;
|
|
8
|
+
/** Files and directories in one skill. The largest bundled skill has five files. */
|
|
9
|
+
export declare const MAX_SKILL_ENTRIES = 500;
|
|
10
|
+
/** What may be read from the files of one skill: `file` bytes of any one of them, and
|
|
11
|
+
* `total` bytes of all of them together. */
|
|
12
|
+
export interface ReadLimits {
|
|
13
|
+
file: number;
|
|
14
|
+
total: number;
|
|
15
|
+
}
|
|
16
|
+
export declare const SKILL_LIMITS: ReadLimits;
|
|
17
|
+
/** The file, or the skill holding it, is bigger than anything the sync has business reading. */
|
|
18
|
+
export declare class TooLargeError extends Error {
|
|
19
|
+
}
|
|
20
|
+
/**
|
|
21
|
+
* The names in a directory, or null when it holds more than `max`. Entries are read
|
|
22
|
+
* one at a time and never more than `max` + 1 of them: a directory in the home can
|
|
23
|
+
* hold any number, and listing it whole is what a start-up must not do.
|
|
24
|
+
*/
|
|
25
|
+
export declare function listBounded(directory: string, max: number): string[] | null;
|
|
26
|
+
/** The whole file, when it is small enough to hold. */
|
|
27
|
+
export declare function readBounded(file: string, maxBytes: number): Buffer;
|
|
28
|
+
/** The sha256 of each file, without ever holding more than one chunk of any. */
|
|
29
|
+
export declare function hashEachBounded(files: readonly string[], limits: ReadLimits): string[];
|
|
30
|
+
/** Each file whole: together they are at most `limits.total` bytes. */
|
|
31
|
+
export declare function readEachBounded(files: readonly string[], limits: ReadLimits): Buffer[];
|
|
32
|
+
//# sourceMappingURL=bounded-read.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"bounded-read.d.ts","sourceRoot":"","sources":["../../../src/skills-sync/bounded-read.ts"],"names":[],"mappings":"AAGA,0FAA0F;AAC1F,eAAO,MAAM,iBAAiB,QAAc,CAAC;AAC7C,qFAAqF;AACrF,eAAO,MAAM,oBAAoB,QAAc,CAAC;AAChD;wFACwF;AACxF,eAAO,MAAM,eAAe,QAAkB,CAAC;AAC/C,oFAAoF;AACpF,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC;6CAC6C;AAC7C,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AACD,eAAO,MAAM,YAAY,EAAE,UAAmE,CAAC;AAM/F,gGAAgG;AAChG,qBAAa,aAAc,SAAQ,KAAK;CAAG;AA6B3C;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAY3E;AAED,uDAAuD;AACvD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIlE;AAgBD,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,EAAE,CAMtF;AAED,uEAAuE;AACvE,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,EAAE,CAKtF"}
|
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
import crypto from "node:crypto";
|
|
2
|
+
import fs from "node:fs";
|
|
3
|
+
/** A receipt for a few dozen skills is a few kilobytes. Anything near this is not one. */
|
|
4
|
+
export const MAX_RECEIPT_BYTES = 1024 * 1024;
|
|
5
|
+
/** One file of a skill. Bundled skill files are text; the largest ships at 13 KB. */
|
|
6
|
+
export const MAX_SKILL_FILE_BYTES = 1024 * 1024;
|
|
7
|
+
/** All the files of one skill together. The largest bundled skill is 35 KB. Without
|
|
8
|
+
* this, a skill of many files each just under the limit above is gigabytes to hash. */
|
|
9
|
+
export const MAX_SKILL_BYTES = 2 * 1024 * 1024;
|
|
10
|
+
/** Files and directories in one skill. The largest bundled skill has five files. */
|
|
11
|
+
export const MAX_SKILL_ENTRIES = 500;
|
|
12
|
+
export const SKILL_LIMITS = { file: MAX_SKILL_FILE_BYTES, total: MAX_SKILL_BYTES };
|
|
13
|
+
const CHUNK_BYTES = 64 * 1024;
|
|
14
|
+
// Never through a link, and never blocking on a FIFO swapped in after the lstat.
|
|
15
|
+
const OPEN_FLAGS = fs.constants.O_RDONLY | (fs.constants.O_NOFOLLOW ?? 0) | (fs.constants.O_NONBLOCK ?? 0);
|
|
16
|
+
/** The file, or the skill holding it, is bigger than anything the sync has business reading. */
|
|
17
|
+
export class TooLargeError extends Error {
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* Feed a regular file of at most `maxBytes` to `consume`, in chunks. The home is the
|
|
21
|
+
* user's: a file there can be any size, and a start-up that reads one whole can be
|
|
22
|
+
* made to run out of memory — which kills the process outright, past any try/catch.
|
|
23
|
+
* The size is checked on the open file and again as it is read, so a file that grows
|
|
24
|
+
* meanwhile is still cut off. Returns the number of bytes read.
|
|
25
|
+
*/
|
|
26
|
+
function readInChunks(file, maxBytes, consume) {
|
|
27
|
+
const fd = fs.openSync(file, OPEN_FLAGS);
|
|
28
|
+
try {
|
|
29
|
+
const stat = fs.fstatSync(fd);
|
|
30
|
+
if (!stat.isFile())
|
|
31
|
+
throw new Error("it is not a regular file");
|
|
32
|
+
if (stat.size > maxBytes)
|
|
33
|
+
throw new TooLargeError(`it is larger than ${maxBytes} bytes`);
|
|
34
|
+
const chunk = Buffer.allocUnsafe(CHUNK_BYTES);
|
|
35
|
+
let total = 0;
|
|
36
|
+
for (;;) {
|
|
37
|
+
const read = fs.readSync(fd, chunk, 0, CHUNK_BYTES, null);
|
|
38
|
+
if (read === 0)
|
|
39
|
+
return total;
|
|
40
|
+
total += read;
|
|
41
|
+
if (total > maxBytes)
|
|
42
|
+
throw new TooLargeError(`it is larger than ${maxBytes} bytes`);
|
|
43
|
+
consume(chunk.subarray(0, read));
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
finally {
|
|
47
|
+
fs.closeSync(fd);
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
/**
|
|
51
|
+
* The names in a directory, or null when it holds more than `max`. Entries are read
|
|
52
|
+
* one at a time and never more than `max` + 1 of them: a directory in the home can
|
|
53
|
+
* hold any number, and listing it whole is what a start-up must not do.
|
|
54
|
+
*/
|
|
55
|
+
export function listBounded(directory, max) {
|
|
56
|
+
const names = [];
|
|
57
|
+
const handle = fs.opendirSync(directory);
|
|
58
|
+
try {
|
|
59
|
+
for (let entry = handle.readSync(); entry !== null; entry = handle.readSync()) {
|
|
60
|
+
if (names.length >= max)
|
|
61
|
+
return null;
|
|
62
|
+
names.push(entry.name);
|
|
63
|
+
}
|
|
64
|
+
return names;
|
|
65
|
+
}
|
|
66
|
+
finally {
|
|
67
|
+
handle.closeSync();
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
/** The whole file, when it is small enough to hold. */
|
|
71
|
+
export function readBounded(file, maxBytes) {
|
|
72
|
+
const chunks = [];
|
|
73
|
+
readInChunks(file, maxBytes, (chunk) => { chunks.push(Buffer.from(chunk)); });
|
|
74
|
+
return Buffer.concat(chunks);
|
|
75
|
+
}
|
|
76
|
+
/**
|
|
77
|
+
* Read the files of one skill, in order, under one budget: each may take what is left
|
|
78
|
+
* of `limits.total`, and never more than `limits.file`. The file that would break the
|
|
79
|
+
* budget is not read, and the ones after it are not opened.
|
|
80
|
+
*/
|
|
81
|
+
function eachBounded(files, limits, read) {
|
|
82
|
+
let remaining = limits.total;
|
|
83
|
+
return files.map((file) => {
|
|
84
|
+
const { value, bytes } = read(file, Math.min(limits.file, remaining));
|
|
85
|
+
remaining -= bytes;
|
|
86
|
+
return value;
|
|
87
|
+
});
|
|
88
|
+
}
|
|
89
|
+
/** The sha256 of each file, without ever holding more than one chunk of any. */
|
|
90
|
+
export function hashEachBounded(files, limits) {
|
|
91
|
+
return eachBounded(files, limits, (file, maxBytes) => {
|
|
92
|
+
const hash = crypto.createHash("sha256");
|
|
93
|
+
const bytes = readInChunks(file, maxBytes, (chunk) => { hash.update(chunk); });
|
|
94
|
+
return { value: hash.digest("hex"), bytes };
|
|
95
|
+
});
|
|
96
|
+
}
|
|
97
|
+
/** Each file whole: together they are at most `limits.total` bytes. */
|
|
98
|
+
export function readEachBounded(files, limits) {
|
|
99
|
+
return eachBounded(files, limits, (file, maxBytes) => {
|
|
100
|
+
const value = readBounded(file, maxBytes);
|
|
101
|
+
return { value, bytes: value.length };
|
|
102
|
+
});
|
|
103
|
+
}
|
|
104
|
+
//# sourceMappingURL=bounded-read.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"bounded-read.js","sourceRoot":"","sources":["../../../src/skills-sync/bounded-read.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
export interface BundledFile {
|
|
2
|
+
/** What gets installed: the packaged file with this instance's placeholders filled in. */
|
|
3
|
+
bytes: Buffer;
|
|
4
|
+
sha256: string;
|
|
5
|
+
/** Hash of the file exactly as packaged. A migration applied by an AI copies files
|
|
6
|
+
* without filling placeholders, and such a copy is still an unmodified one. */
|
|
7
|
+
rawSha256: string;
|
|
8
|
+
mode: number;
|
|
9
|
+
}
|
|
10
|
+
export interface BundledSkill {
|
|
11
|
+
name: string;
|
|
12
|
+
/** Keyed by "/"-separated path inside the skill. */
|
|
13
|
+
files: Record<string, BundledFile>;
|
|
14
|
+
directories: string[];
|
|
15
|
+
}
|
|
16
|
+
export declare function sha256(bytes: Buffer | string): string;
|
|
17
|
+
/** Is a file with this hash the shipped one: as installed, or as packaged (placeholders
|
|
18
|
+
* unfilled)? A migration applied by an AI copies files without filling them in. */
|
|
19
|
+
export declare function isShippedFile(file: BundledFile, hash: string): boolean;
|
|
20
|
+
/** The sha256 of every file of the skill, as it is once installed. */
|
|
21
|
+
export declare function shippedHashes(skill: BundledSkill): Record<string, string>;
|
|
22
|
+
/**
|
|
23
|
+
* Read every skill the package ships, rendered the way setup would install it.
|
|
24
|
+
* A directory without SKILL.md is not a skill. Anything that is not a plain file
|
|
25
|
+
* or directory inside a skill is a packaging error and refuses the whole load.
|
|
26
|
+
*/
|
|
27
|
+
export declare function loadBundledSkills(templateDir: string, replacements: Record<string, string>): BundledSkill[];
|
|
28
|
+
//# sourceMappingURL=bundled.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"bundled.d.ts","sourceRoot":"","sources":["../../../src/skills-sync/bundled.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,WAAW;IAC1B,0FAA0F;IAC1F,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf;oFACgF;IAChF,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACnC,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAErD;AAED;oFACoF;AACpF,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtE;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEzE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,YAAY,EAAE,CAa3G"}
|
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
import crypto from "node:crypto";
|
|
2
|
+
import fs from "node:fs";
|
|
3
|
+
import path from "node:path";
|
|
4
|
+
import { applyTemplateReplacements, isTemplateFile } from "../shared/templateReplacements.js";
|
|
5
|
+
import { MAX_SKILL_BYTES, MAX_SKILL_ENTRIES, MAX_SKILL_FILE_BYTES } from "./bounded-read.js";
|
|
6
|
+
import { assertSkillFilePath, assertSkillName, isHousekeepingFile } from "./names.js";
|
|
7
|
+
export function sha256(bytes) {
|
|
8
|
+
return crypto.createHash("sha256").update(bytes).digest("hex");
|
|
9
|
+
}
|
|
10
|
+
/** Is a file with this hash the shipped one: as installed, or as packaged (placeholders
|
|
11
|
+
* unfilled)? A migration applied by an AI copies files without filling them in. */
|
|
12
|
+
export function isShippedFile(file, hash) {
|
|
13
|
+
return hash === file.sha256 || hash === file.rawSha256;
|
|
14
|
+
}
|
|
15
|
+
/** The sha256 of every file of the skill, as it is once installed. */
|
|
16
|
+
export function shippedHashes(skill) {
|
|
17
|
+
return Object.fromEntries(Object.entries(skill.files).map(([relative, file]) => [relative, file.sha256]));
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* Read every skill the package ships, rendered the way setup would install it.
|
|
21
|
+
* A directory without SKILL.md is not a skill. Anything that is not a plain file
|
|
22
|
+
* or directory inside a skill is a packaging error and refuses the whole load.
|
|
23
|
+
*/
|
|
24
|
+
export function loadBundledSkills(templateDir, replacements) {
|
|
25
|
+
const root = path.join(templateDir, "skills");
|
|
26
|
+
let entries;
|
|
27
|
+
try {
|
|
28
|
+
entries = fs.readdirSync(root, { withFileTypes: true });
|
|
29
|
+
}
|
|
30
|
+
catch (error) {
|
|
31
|
+
if (error.code === "ENOENT")
|
|
32
|
+
return [];
|
|
33
|
+
throw error;
|
|
34
|
+
}
|
|
35
|
+
return entries
|
|
36
|
+
.filter((entry) => entry.isDirectory() && fs.existsSync(path.join(root, entry.name, "SKILL.md")))
|
|
37
|
+
.map((entry) => entry.name)
|
|
38
|
+
.sort()
|
|
39
|
+
.map((name) => loadBundledSkill(root, name, replacements));
|
|
40
|
+
}
|
|
41
|
+
function loadBundledSkill(root, name, replacements) {
|
|
42
|
+
assertSkillName(name, "The package");
|
|
43
|
+
const files = {};
|
|
44
|
+
const directories = [];
|
|
45
|
+
let entries = 0;
|
|
46
|
+
let bytes = 0;
|
|
47
|
+
const walk = (directory, prefix) => {
|
|
48
|
+
for (const entry of fs.readdirSync(directory).sort()) {
|
|
49
|
+
const full = path.join(directory, entry);
|
|
50
|
+
const relative = prefix ? `${prefix}/${entry}` : entry;
|
|
51
|
+
const stat = fs.lstatSync(full);
|
|
52
|
+
if (stat.isFile() && !isHousekeepingFile(entry))
|
|
53
|
+
bytes += stat.size;
|
|
54
|
+
// The sync refuses to read a home copy beyond these limits, so a shipped skill
|
|
55
|
+
// beyond them could never be recognised once installed.
|
|
56
|
+
if (++entries > MAX_SKILL_ENTRIES || (stat.isFile() && stat.size > MAX_SKILL_FILE_BYTES) || bytes > MAX_SKILL_BYTES) {
|
|
57
|
+
throw new Error(`The package's skill "${name}" is larger than a skill may be, at ${relative}`);
|
|
58
|
+
}
|
|
59
|
+
if (stat.isDirectory()) {
|
|
60
|
+
directories.push(relative);
|
|
61
|
+
walk(full, relative);
|
|
62
|
+
}
|
|
63
|
+
else if (!stat.isFile()) {
|
|
64
|
+
throw new Error(`The package's skill "${name}" carries ${relative}, which is not a regular file`);
|
|
65
|
+
}
|
|
66
|
+
else if (!isHousekeepingFile(entry)) {
|
|
67
|
+
assertSkillFilePath(relative, `The package's skill "${name}"`);
|
|
68
|
+
files[relative] = bundledFile(full, entry, stat.mode, replacements);
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
};
|
|
72
|
+
walk(path.join(root, name), "");
|
|
73
|
+
if (!Object.hasOwn(files, "SKILL.md"))
|
|
74
|
+
throw new Error(`The package's skill "${name}" has no SKILL.md file`);
|
|
75
|
+
return { name, files, directories };
|
|
76
|
+
}
|
|
77
|
+
function bundledFile(file, name, mode, replacements) {
|
|
78
|
+
const raw = fs.readFileSync(file);
|
|
79
|
+
const bytes = isTemplateFile(name)
|
|
80
|
+
? Buffer.from(applyTemplateReplacements(raw.toString("utf8"), replacements), "utf8")
|
|
81
|
+
: raw;
|
|
82
|
+
return { bytes, sha256: sha256(bytes), rawSha256: sha256(raw), mode: mode & 0o777 };
|
|
83
|
+
}
|
|
84
|
+
//# sourceMappingURL=bundled.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"bundled.js","sourceRoot":"","sources":["../../../src/skills-sync/bundled.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
/** The placeholders `ryoko setup` fills in, and the files it fills them in.
|
|
2
|
+
* A test holds both in step with shared/templateReplacements.ts. */
|
|
3
|
+
export declare const PLACEHOLDERS: readonly string[];
|
|
4
|
+
/**
|
|
5
|
+
* How one file of an earlier shipped skill is recognised without keeping its text.
|
|
6
|
+
*
|
|
7
|
+
* A file the installer copies as is has one hash. A template with placeholders was
|
|
8
|
+
* written differently into every home, so it is split by line: the lines that carry
|
|
9
|
+
* a placeholder are kept verbatim (`slots`, by zero-based line number) and every
|
|
10
|
+
* other line is covered by `masked`, the hash of the file with those lines blanked.
|
|
11
|
+
*/
|
|
12
|
+
export type FileFingerprint = {
|
|
13
|
+
sha256: string;
|
|
14
|
+
} | {
|
|
15
|
+
lines: number;
|
|
16
|
+
masked: string;
|
|
17
|
+
slots: Record<string, string>;
|
|
18
|
+
};
|
|
19
|
+
export declare function isTemplatePath(relativePath: string): boolean;
|
|
20
|
+
export declare function hasPlaceholder(text: string): boolean;
|
|
21
|
+
export declare function fingerprintFile(relativePath: string, bytes: Buffer): FileFingerprint;
|
|
22
|
+
/**
|
|
23
|
+
* Is `bytes` this file, as the installer would have written it? `render` fills the
|
|
24
|
+
* placeholders of one template line the way the installer does for the whole file;
|
|
25
|
+
* that is the same thing, because no placeholder and no value spans a line.
|
|
26
|
+
*
|
|
27
|
+
* Every line without a placeholder must hash exactly, and every line with one must
|
|
28
|
+
* equal its rendering character for character. Nothing is matched loosely: a home
|
|
29
|
+
* copy that differs in any other way is not this file.
|
|
30
|
+
*/
|
|
31
|
+
export declare function matchesFingerprint(fingerprint: FileFingerprint, bytes: Buffer, render: (templateLine: string) => string): boolean;
|
|
32
|
+
//# sourceMappingURL=fingerprint.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["../../../src/skills-sync/fingerprint.ts"],"names":[],"mappings":"AAMA;qEACqE;AACrE,eAAO,MAAM,YAAY,EAAE,SAAS,MAAM,EAAyC,CAAC;AAGpF;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC;AAErE,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAI5D;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD;AAeD,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,CAMpF;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAQjI"}
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
// Self-contained on purpose: scripts/generate-bundled-skill-history.mjs imports this
|
|
2
|
+
// file directly (Node strips the types), so the generator and the sync can never
|
|
3
|
+
// disagree about what a fingerprint means. Keep it free of relative imports and of
|
|
4
|
+
// TypeScript syntax that needs compiling (enums, namespaces, parameter properties).
|
|
5
|
+
import crypto from "node:crypto";
|
|
6
|
+
/** The placeholders `ryoko setup` fills in, and the files it fills them in.
|
|
7
|
+
* A test holds both in step with shared/templateReplacements.ts. */
|
|
8
|
+
export const PLACEHOLDERS = ["{{portalName}}", "{{portalSlug}}"];
|
|
9
|
+
const TEMPLATE_EXTENSIONS = new Set([".md", ".yaml", ".yml"]);
|
|
10
|
+
export function isTemplatePath(relativePath) {
|
|
11
|
+
const name = relativePath.slice(relativePath.lastIndexOf("/") + 1);
|
|
12
|
+
const dot = name.lastIndexOf(".");
|
|
13
|
+
return dot >= 0 && TEMPLATE_EXTENSIONS.has(name.slice(dot).toLowerCase());
|
|
14
|
+
}
|
|
15
|
+
export function hasPlaceholder(text) {
|
|
16
|
+
return PLACEHOLDERS.some((placeholder) => text.includes(placeholder));
|
|
17
|
+
}
|
|
18
|
+
const sha256 = (value) => crypto.createHash("sha256").update(value).digest("hex");
|
|
19
|
+
/** The text, or null when the bytes are not exactly its UTF-8 encoding. A lossy
|
|
20
|
+
* decode would let two different files compare equal. */
|
|
21
|
+
function decodeExactly(bytes) {
|
|
22
|
+
const text = bytes.toString("utf8");
|
|
23
|
+
return Buffer.from(text, "utf8").equals(bytes) ? text : null;
|
|
24
|
+
}
|
|
25
|
+
function blankSlots(lines, slots) {
|
|
26
|
+
return lines.map((line, index) => (Object.hasOwn(slots, String(index)) ? "" : line)).join("\n");
|
|
27
|
+
}
|
|
28
|
+
export function fingerprintFile(relativePath, bytes) {
|
|
29
|
+
const text = isTemplatePath(relativePath) ? decodeExactly(bytes) : null;
|
|
30
|
+
if (text === null || !hasPlaceholder(text))
|
|
31
|
+
return { sha256: sha256(bytes) };
|
|
32
|
+
const lines = text.split("\n");
|
|
33
|
+
const slots = Object.fromEntries(lines.flatMap((line, index) => (hasPlaceholder(line) ? [[String(index), line]] : [])));
|
|
34
|
+
return { lines: lines.length, masked: sha256(blankSlots(lines, slots)), slots };
|
|
35
|
+
}
|
|
36
|
+
/**
|
|
37
|
+
* Is `bytes` this file, as the installer would have written it? `render` fills the
|
|
38
|
+
* placeholders of one template line the way the installer does for the whole file;
|
|
39
|
+
* that is the same thing, because no placeholder and no value spans a line.
|
|
40
|
+
*
|
|
41
|
+
* Every line without a placeholder must hash exactly, and every line with one must
|
|
42
|
+
* equal its rendering character for character. Nothing is matched loosely: a home
|
|
43
|
+
* copy that differs in any other way is not this file.
|
|
44
|
+
*/
|
|
45
|
+
export function matchesFingerprint(fingerprint, bytes, render) {
|
|
46
|
+
if ("sha256" in fingerprint)
|
|
47
|
+
return sha256(bytes) === fingerprint.sha256;
|
|
48
|
+
const text = decodeExactly(bytes);
|
|
49
|
+
if (text === null)
|
|
50
|
+
return false;
|
|
51
|
+
const lines = text.split("\n");
|
|
52
|
+
if (lines.length !== fingerprint.lines)
|
|
53
|
+
return false;
|
|
54
|
+
if (sha256(blankSlots(lines, fingerprint.slots)) !== fingerprint.masked)
|
|
55
|
+
return false;
|
|
56
|
+
return Object.entries(fingerprint.slots).every(([index, templateLine]) => lines[Number(index)] === render(templateLine));
|
|
57
|
+
}
|
|
58
|
+
//# sourceMappingURL=fingerprint.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"fingerprint.js","sourceRoot":"","sources":["../../../src/skills-sync/fingerprint.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
import { type BundledFile } from "./bundled.js";
|
|
2
|
+
import { type FileFingerprint } from "./fingerprint.js";
|
|
3
|
+
/** Shipped in the package's template directory, beside the skills it describes.
|
|
4
|
+
* Generated by scripts/generate-bundled-skill-history.mjs; not edited by hand. */
|
|
5
|
+
export declare const HISTORY_FILE = "bundled-skill-history.json";
|
|
6
|
+
/** One version of a skill that an earlier release shipped. */
|
|
7
|
+
export interface ShippedVersion {
|
|
8
|
+
/** The first release tag that carried it. */
|
|
9
|
+
since: string;
|
|
10
|
+
files: Record<string, FileFingerprint>;
|
|
11
|
+
}
|
|
12
|
+
/**
|
|
13
|
+
* What earlier releases shipped. A home that was installed before the sync kept a
|
|
14
|
+
* receipt has no record of what was placed in it; this is how a skill in such a home
|
|
15
|
+
* can still be shown to be an untouched shipped copy rather than the user's work.
|
|
16
|
+
*/
|
|
17
|
+
export interface ShippedHistory {
|
|
18
|
+
/** Every skill name the package is known to have shipped. */
|
|
19
|
+
names: ReadonlySet<string>;
|
|
20
|
+
versions: Readonly<Record<string, readonly ShippedVersion[]>>;
|
|
21
|
+
}
|
|
22
|
+
/** No file is a package without history, not an error: nothing unrecorded is then
|
|
23
|
+
* recognised, which is the cautious reading. A file that is there but malformed is
|
|
24
|
+
* refused, like any other damage to the package. */
|
|
25
|
+
export declare function loadShippedHistory(templateDir: string): ShippedHistory;
|
|
26
|
+
/**
|
|
27
|
+
* If the directory is, file for file, one of these earlier shipped versions, return
|
|
28
|
+
* the hashes of its files; otherwise null.
|
|
29
|
+
*
|
|
30
|
+
* `renderings` are the placeholder values the installer could have used. Every file
|
|
31
|
+
* must match the same version under the same rendering: a mix of two releases, or of
|
|
32
|
+
* two names, is not something any release installed.
|
|
33
|
+
*
|
|
34
|
+
* The directory may hold files that version did not have, on one condition: each is,
|
|
35
|
+
* byte for byte, the file the package ships today (`shipped`) at that path. A restore
|
|
36
|
+
* from a backup leaves such a tree, old files beside the newer version's extra ones,
|
|
37
|
+
* and so did updates that only added what was missing. No file of that version may be
|
|
38
|
+
* absent, and a file beyond it that is the user's own, or not exactly the shipped one,
|
|
39
|
+
* makes the tree no version at all.
|
|
40
|
+
*
|
|
41
|
+
* Throws TooLargeError when a file, or all of them together, is bigger than a skill can be.
|
|
42
|
+
*/
|
|
43
|
+
export declare function matchShippedVersion(directory: string, paths: readonly string[], versions: readonly ShippedVersion[], renderings: readonly Record<string, string>[], shipped?: Record<string, BundledFile>): Record<string, string> | null;
|
|
44
|
+
//# sourceMappingURL=history.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../../src/skills-sync/history.ts"],"names":[],"mappings":"AAIA,OAAO,EAAyB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EAAsC,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAG5F;mFACmF;AACnF,eAAO,MAAM,YAAY,+BAA+B,CAAC;AAKzD,8DAA8D;AAC9D,MAAM,WAAW,cAAc;IAC7B,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CACxC;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,6DAA6D;IAC7D,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3B,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,CAAC,CAAC,CAAC;CAC/D;AAED;;qDAEqD;AACrD,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CAatE;AAkDD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,QAAQ,EAAE,SAAS,cAAc,EAAE,EACnC,UAAU,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAC7C,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAM,GACxC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAgB/B"}
|