@aitne/shared 0.1.0

package/dist/docs-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-schema.js","sourceRoot":"","sources":["../src/docs-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;GASG;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAU,CAAC;AAE9C,MAAM,cAAc,GAAG;IACrB,iBAAiB;IACjB,UAAU;IACV,UAAU;IACV,QAAQ;IACR,iBAAiB;IACjB,WAAW;IACX,UAAU;CACF,CAAC;AAGX,MAAM,UAAU,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,CAAU,CAAC;AAGtE;;;;;;;;GAQG;AACH,MAAM,UAAU,GAAG,CAAC;KACjB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,GAAG,CAAC;KACR,KAAK,CACJ,iEAAiE,EACjE,kEAAkE,CACnE,CAAC;AAEJ;;;;GAIG;AACH,MAAM,aAAa,GAAG,UAAU,CAAC;AAEjC,yEAAyE;AACzE,MAAM,WAAW,GAAG,CAAC;KAClB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,EAAE,CAAC;KACP,KAAK,CAAC,4BAA4B,EAAE,iCAAiC,CAAC,CAAC;AAE1E,yDAAyD;AACzD,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,qBAAqB,EAAE,oBAAoB,CAAC,CAAC;AAEpF;;;;GAIG;AACH,MAAM,cAAc,GAAG,CAAC;KACrB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,KAAK,CAAC,2BAA2B,EAAE,oDAAoD,CAAC,CAAC;AAE5F,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC;KACnC,MAAM,CAAC;IACN,8BAA8B;IAC9B,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC;IAC9C,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAEjC,iCAAiC;IACjC,EAAE,EAAE,WAAW,CAAC,QAAQ,EAAE;IAC1B,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IAE/D,oCAAoC;IACpC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC;IAChC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;IAEpC,uCAAuC;IACvC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC7C,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC3D,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE;IACrC,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IAEpE,oCAAoC;IACpC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IAE5C,+BAA+B;IAC/B,OAAO,EAAE,aAAa,CAAC,QAAQ,EAAE;IACjC,OAAO,EAAE,aAAa,CAAC,QAAQ,EAAE;IACjC,UAAU,EAAE,aAAa,CAAC,QAAQ,EAAE;IACpC,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IAErD,yCAAyC;IACzC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IAEhE,iCAAiC;IACjC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IAClD,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IAExD,mEAAmE;IACnE,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IACtD,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpE,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IACnE,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IACrE,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IAErE,sCAAsC;IACtC,kEAAkE;IAClE,mEAAmE;IACnE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CACpD,CAAC;KACD,MAAM,EAAE,CAAC;AAIZ;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,OAAO,OAAO;SACX,WAAW,EAAE;SACb,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC;SAC5B,IAAI,EAAE;SACN,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,qEAAqE;AACrE,MAAM,WAAW,GAAG,4DAA4D,CAAC;AAYjF,sDAAsD;AACtD,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,MAAM,GAAG,GAA0B,EAAE,CAAC;IACtC,WAAW,CAAC,SAAS,GAAG,CAAC,CAAC;IAC1B,IAAI,CAAyB,CAAC;IAC9B,OAAO,CAAC,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC7C,GAAG,CAAC,IAAI,CAAC;YACP,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,GAAG,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM;YAC1B,IAAI,EAAE,CAAC,CAAC,CAAC,CAAE;YACX,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI;YACpB,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;SACV,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/editable-config-keys.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Canonical list of config keys editable via the dashboard PATCH /config endpoint.
+ *
+ * Both the daemon (env-writer.ts) and the dashboard (useSaveConfig) import from here
+ * so the set of accepted keys is enforced at compile time in both packages.
+ */
+export declare const EDITABLE_RUNTIME_KEY_TUPLE: readonly ["advisorEnabled", "advisorModel", "maxConcurrentSessions", "maxReactiveSessions", "delegatedProxyMaxConcurrent", "executeTimeoutMinutes", "delegatedTaskModeEnabled", "delegatedTaskMaxPerDay", "delegatedTaskDefaultMaxToolCalls", "delegatedTaskDefaultMaxBudgetUsd", "delegatedTaskDefaultTimeoutMs", "delegatedTaskHeavyEnabled", "delegatedTaskStructuredOutputEnabled", "delegatedTaskSubprocessPoolEnabled", "delegatedTaskSubprocessPoolTtlSeconds", "delegatedTaskCacheEnabled", "delegatedTaskCacheTtlSeconds", "delegatedTaskCacheMaxEntries", "agentDisplayName", "character", "sessionTimeoutDmMinutes", "sessionTimeoutChannelMinutes", "sessionTimeoutDashboardMinutes", "historyInjectionMaxMessages", "historyInjectionMaxTokens", "historyOtherSurfaceWindowMinutes", "dmStalenessStrict", "proactiveForwardChannelTimelineEnabled", "proactiveForwardForceFreshSession", "timezone", "dayBoundaryHour", "hourlyCheckEnabled", "hourlyCheckIntervalMinutes", "hourlyCheckActiveStartHour", "hourlyCheckActiveEndHour", "hourlyCheckMinObservations", "hourlyCheckGateMode", "hourlyCheckStage2Enabled", "hourlyCheckHeartbeatHours", "hourlyCheckLowSignalPendingCeiling", "authProbeDisabled", "authPreflightFreshnessMs", "maxNotificationsPerHour", "maxNotificationsPerDay", "quietHoursStart", "quietHoursEnd", "batchIntervalMinutes", "primaryPlatform", "defaultNotificationPlatforms", "slackOwnerUserId", "telegramOwnerChatId", "discordOwnerUserId", "whatsappEnabled", "whatsappOwnerPhone", "whatsappAuthDir", "disallowedTools", "allowedToolsOverride", "claudeExecutionPermissionMode", "codexExecutionPermissionMode", "geminiExecutionPermissionMode", "externalObsidianVaultPath", "externalObsidianVaultName", "externalObsidianWatch", "obsidianDebounceSeconds", "primaryVaultPath", "primaryVaultName", "gitAccounts", "googleCalendarId", "notionDatabaseIds", "schedulePollIntervalSeconds", "maxBriefingDelayMinutes", "gitPollIntervalSeconds", "gitPushOverdueMinutes", "gitProjectUpdateDebounceMinutes", "notionPollIntervalSeconds", "calendarPollIntervalSeconds", "gmailPollIntervalSeconds", "githubPollIntervalSeconds", "mcpAutoProbeIntervalMinutes", "delegatedProbeIntervalMinutes", "enabledMailProviders", "mailPollIntervalSeconds", "mailIdleEnabled", "mailIdleInstabilityThreshold", "mailIdleFallbackRecoveryMinutes", "mailMaxMessagesPerPoll", "mailAuthFailureRetryHours", "hourlyObservationCharBudget", "observationSummarizerEnabled", "observationSummarizerConcurrency", "observationSummarizerMaxCallsPerMinute", "observationSummarizerQueueLimit", "observationSummarizerTimeoutMs", "vipMailSenders", "outlookDeltaPageSize", "outlookGraphConcurrency", "imapReconnectBaseMs", "imapReconnectMaxMs", "autonomousDailyCostCapUsd", "autonomousMonthlyCostCapUsd", "primaryLanguage", "vaultMode", "voiceTranscriptionEnabled"];
+export declare const EDITABLE_BOOTSTRAP_KEY_TUPLE: readonly ["apiPort"];
+export declare const RESTART_REQUIRED_KEY_TUPLE: readonly ["apiPort", "externalObsidianVaultName", "externalObsidianVaultPath", "externalObsidianWatch", "primaryVaultPath", "primaryVaultName", "slackOwnerUserId", "telegramOwnerChatId", "discordOwnerUserId", "whatsappEnabled", "whatsappOwnerPhone", "whatsappAuthDir", "notionDatabaseIds", "gmailPollIntervalSeconds", "delegatedProbeIntervalMinutes", "gitPollIntervalSeconds", "githubPollIntervalSeconds", "voiceTranscriptionEnabled", "observationSummarizerEnabled", "observationSummarizerConcurrency", "observationSummarizerMaxCallsPerMinute", "observationSummarizerQueueLimit", "observationSummarizerTimeoutMs"];
+export type EditableRuntimeKey = (typeof EDITABLE_RUNTIME_KEY_TUPLE)[number];
+export type EditableBootstrapKey = (typeof EDITABLE_BOOTSTRAP_KEY_TUPLE)[number];
+export type EditableConfigKey = EditableRuntimeKey | EditableBootstrapKey;
+export type RestartRequiredKey = (typeof RESTART_REQUIRED_KEY_TUPLE)[number];
+//# sourceMappingURL=editable-config-keys.d.ts.map

package/dist/editable-config-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editable-config-keys.d.ts","sourceRoot":"","sources":["../src/editable-config-keys.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,0BAA0B,uvFAkG7B,CAAC;AAEX,eAAO,MAAM,4BAA4B,sBAE/B,CAAC;AAEX,eAAO,MAAM,0BAA0B,umBA+C7B,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC;AAC7E,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,4BAA4B,CAAC,CAAC,MAAM,CAAC,CAAC;AACjF,MAAM,MAAM,iBAAiB,GAAG,kBAAkB,GAAG,oBAAoB,CAAC;AAC1E,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/editable-config-keys.js

@@ -0,0 +1,157 @@
+/**
+ * Canonical list of config keys editable via the dashboard PATCH /config endpoint.
+ *
+ * Both the daemon (env-writer.ts) and the dashboard (useSaveConfig) import from here
+ * so the set of accepted keys is enforced at compile time in both packages.
+ */
+export const EDITABLE_RUNTIME_KEY_TUPLE = [
+    "advisorEnabled", "advisorModel",
+    "maxConcurrentSessions", "maxReactiveSessions", "delegatedProxyMaxConcurrent", "executeTimeoutMinutes",
+    // DELEGATED-TASK-MODE-DESIGN.md §17 — task-mode kill switch / quotas /
+    // defaults. The heavy enable flag is Approve-tier semantically, but is
+    // editable here too so the user can flip it from the dashboard once
+    // they confirm the cost class.
+    "delegatedTaskModeEnabled", "delegatedTaskMaxPerDay",
+    "delegatedTaskDefaultMaxToolCalls", "delegatedTaskDefaultMaxBudgetUsd",
+    "delegatedTaskDefaultTimeoutMs", "delegatedTaskHeavyEnabled",
+    // DELEGATED-TASK-MODE-DESIGN.md §13 Phase 3 — three independent
+    // optimization kill switches. Each defaults off (cache, pool) or on
+    // (structured output) per the design doc; flipping any one does not
+    // affect the others. See runtime-settings.ts for the per-field rationale.
+    "delegatedTaskStructuredOutputEnabled",
+    "delegatedTaskSubprocessPoolEnabled", "delegatedTaskSubprocessPoolTtlSeconds",
+    "delegatedTaskCacheEnabled", "delegatedTaskCacheTtlSeconds",
+    "delegatedTaskCacheMaxEntries",
+    "agentDisplayName",
+    "character",
+    "sessionTimeoutDmMinutes", "sessionTimeoutChannelMinutes", "sessionTimeoutDashboardMinutes",
+    "historyInjectionMaxMessages", "historyInjectionMaxTokens",
+    "historyOtherSurfaceWindowMinutes",
+    "dmStalenessStrict",
+    "proactiveForwardChannelTimelineEnabled",
+    "proactiveForwardForceFreshSession",
+    "timezone", "dayBoundaryHour", "hourlyCheckEnabled", "hourlyCheckIntervalMinutes",
+    "hourlyCheckActiveStartHour", "hourlyCheckActiveEndHour", "hourlyCheckMinObservations",
+    // cost-reduction-structural §B — three-stage gate knobs.
+    "hourlyCheckGateMode", "hourlyCheckStage2Enabled", "hourlyCheckHeartbeatHours",
+    "hourlyCheckLowSignalPendingCeiling",
+    "authProbeDisabled", "authPreflightFreshnessMs",
+    "maxNotificationsPerHour", "maxNotificationsPerDay",
+    "quietHoursStart", "quietHoursEnd", "batchIntervalMinutes", "primaryPlatform",
+    "defaultNotificationPlatforms",
+    "slackOwnerUserId", "telegramOwnerChatId", "discordOwnerUserId",
+    "whatsappEnabled", "whatsappOwnerPhone", "whatsappAuthDir",
+    "disallowedTools", "allowedToolsOverride",
+    "claudeExecutionPermissionMode",
+    "codexExecutionPermissionMode",
+    "geminiExecutionPermissionMode",
+    "externalObsidianVaultPath", "externalObsidianVaultName",
+    // SETUP-FLOW-REDESIGN-PLAN §6.3 — kill switch for the external-vault
+    // branch of `ObsidianWatcher`. Editable so the Notes step's "Watch for
+    // changes" checkbox round-trips through `PATCH /api/config`.
+    "externalObsidianWatch",
+    "obsidianDebounceSeconds",
+    // Management Mode — primary-vault fields introduced by the management-mode
+    // redesign. Editable via the settings dialog once Phase 2's migration API
+    // lands; Phase 1 persists values if set but enters degraded mode if unset
+    // while vaultMode === "obsidian".
+    "primaryVaultPath", "primaryVaultName",
+    // gitRepos / gitWatchedRepos / githubRepos removed at the unified-
+    // repositories cutover (docs/design/appendices/unified-repositories.md);
+    // their data lives in the `repositories` DB table now. `gitAccounts`
+    // stays — it is 1:N over rows.
+    "gitAccounts",
+    "googleCalendarId", "notionDatabaseIds",
+    "schedulePollIntervalSeconds",
+    // SCHEDULED-DM-IMPLEMENTATION-PLAN §3.6.1 / §6.6.1 — max delay budget
+    // for scheduled.dm gate-acquisition before the briefing is dropped.
+    "maxBriefingDelayMinutes",
+    "gitPollIntervalSeconds", "gitPushOverdueMinutes", "gitProjectUpdateDebounceMinutes",
+    "notionPollIntervalSeconds", "calendarPollIntervalSeconds",
+    "gmailPollIntervalSeconds",
+    "githubPollIntervalSeconds",
+    "mcpAutoProbeIntervalMinutes",
+    "delegatedProbeIntervalMinutes",
+    "enabledMailProviders",
+    "mailPollIntervalSeconds",
+    "mailIdleEnabled",
+    "mailIdleInstabilityThreshold",
+    "mailIdleFallbackRecoveryMinutes",
+    "mailMaxMessagesPerPoll",
+    "mailAuthFailureRetryHours",
+    "hourlyObservationCharBudget",
+    // cost-reduction-structural §A — observation summarizer knobs.
+    "observationSummarizerEnabled",
+    "observationSummarizerConcurrency",
+    "observationSummarizerMaxCallsPerMinute",
+    "observationSummarizerQueueLimit",
+    "observationSummarizerTimeoutMs",
+    "vipMailSenders",
+    "outlookDeltaPageSize",
+    "outlookGraphConcurrency",
+    "imapReconnectBaseMs",
+    "imapReconnectMaxMs",
+    "autonomousDailyCostCapUsd",
+    "autonomousMonthlyCostCapUsd",
+    // B-007 — primary language + vault mode selected at setup, editable later
+    "primaryLanguage",
+    "vaultMode",
+    // Voice transcription opt-in (docs/design/appendices/voice-transcription.md).
+    // Direct PATCH is rejected by the voice route — the dashboard goes through
+    // POST /api/voice/install so the model download + auto-restart happen
+    // atomically. Listed here so the env-writer / settings-merge plumbing
+    // accepts the key on read-back.
+    "voiceTranscriptionEnabled",
+];
+export const EDITABLE_BOOTSTRAP_KEY_TUPLE = [
+    "apiPort",
+];
+export const RESTART_REQUIRED_KEY_TUPLE = [
+    "apiPort",
+    "externalObsidianVaultName", "externalObsidianVaultPath",
+    // SETUP-FLOW-REDESIGN-PLAN §6.3 — the kill switch is read once at boot in
+    // index.ts when ObsidianWatcher is registered; flipping it at runtime
+    // updates the integrations.md Note Sources line (via applyConfigUpdates
+    // chokepoint) but does NOT start/stop the live chokidar watcher. Surface
+    // that honestly via the dashboard's restart-required badge — same posture
+    // as `externalObsidianVaultPath` above, which has the same constraint.
+    "externalObsidianWatch",
+    "primaryVaultPath", "primaryVaultName",
+    "slackOwnerUserId",
+    "telegramOwnerChatId",
+    "discordOwnerUserId",
+    "whatsappEnabled", "whatsappOwnerPhone", "whatsappAuthDir",
+    "notionDatabaseIds",
+    "gmailPollIntervalSeconds",
+    // DelegatedProbeObserver (DELEGATED-MODE-V2 §7.1) captures `intervalMs`
+    // at construction time and registers a single setInterval — a hot PATCH
+    // updates `config.delegatedProbeIntervalMinutes` but the timer keeps
+    // firing on the old cadence until restart. Surface that honestly via
+    // the dashboard's restart-required badge rather than silently ignoring
+    // the change.
+    "delegatedProbeIntervalMinutes",
+    // GitWatcher / delegated Git cron / GitHubPoller capture their cadence in
+    // constructors and bind it to timers. Runtime PATCH updates config storage,
+    // but the live timers keep the old cadence until restart; flag honestly.
+    "gitPollIntervalSeconds",
+    "githubPollIntervalSeconds",
+    // VoiceTranscriber binds `enabled` at construction time in index.ts;
+    // toggling the flag at runtime does not affect the live transcriber until
+    // the daemon restarts. The /api/voice/install path triggers the restart
+    // automatically, but flag a manual PATCH honestly via the dashboard badge.
+    "voiceTranscriptionEnabled",
+    // ObservationSummarizerWorker reads these constructor-time options once
+    // at startup (cost-reduction-structural §A): the worker is registered
+    // only when `observationSummarizerEnabled=true` at boot, and concurrency
+    // / per-call timeout / rate limit / queue cap are captured by the
+    // worker constructor and bound to the running drain loops. A runtime
+    // PATCH updates `settings`/`AgentConfig` storage but does not re-create
+    // the worker — flag honestly via the restart badge so an operator that
+    // bumped the rate limit knows the change isn't live yet.
+    "observationSummarizerEnabled",
+    "observationSummarizerConcurrency",
+    "observationSummarizerMaxCallsPerMinute",
+    "observationSummarizerQueueLimit",
+    "observationSummarizerTimeoutMs",
+];
+//# sourceMappingURL=editable-config-keys.js.map

package/dist/editable-config-keys.js.map

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

package/dist/exec-with-stdin.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Run a command with stdin input piped from a string.
+ *
+ * Unlike `promisify(execFile)`, this supports writing to the child's stdin,
+ * which is needed by `secret-tool store` (Linux) and PowerShell DPAPI
+ * (Windows) where values must be passed via stdin to avoid command injection.
+ */
+export declare function execWithStdin(command: string, args: string[], input: string, options?: {
+    timeout?: number;
+}): Promise<{
+    stdout: string;
+    stderr: string;
+}>;
+//# sourceMappingURL=exec-with-stdin.d.ts.map

package/dist/exec-with-stdin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec-with-stdin.d.ts","sourceRoot":"","sources":["../src/exec-with-stdin.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7B,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CA4B7C"}

package/dist/exec-with-stdin.js

@@ -0,0 +1,35 @@
+import { spawn } from "node:child_process";
+/**
+ * Run a command with stdin input piped from a string.
+ *
+ * Unlike `promisify(execFile)`, this supports writing to the child's stdin,
+ * which is needed by `secret-tool store` (Linux) and PowerShell DPAPI
+ * (Windows) where values must be passed via stdin to avoid command injection.
+ */
+export function execWithStdin(command, args, input, options) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, args, {
+            stdio: ["pipe", "pipe", "pipe"],
+            timeout: options?.timeout,
+        });
+        let stdout = "";
+        let stderr = "";
+        child.stdout.on("data", (data) => {
+            stdout += data;
+        });
+        child.stderr.on("data", (data) => {
+            stderr += data;
+        });
+        // Handle spawn errors (e.g., command not found) before writing to stdin
+        child.on("error", reject);
+        child.on("close", (code) => {
+            if (code === 0)
+                resolve({ stdout, stderr });
+            else
+                reject(new Error(`Exit ${code}: ${stderr}`));
+        });
+        child.stdin.write(input);
+        child.stdin.end();
+    });
+}
+//# sourceMappingURL=exec-with-stdin.js.map

package/dist/exec-with-stdin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec-with-stdin.js","sourceRoot":"","sources":["../src/exec-with-stdin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAe,EACf,IAAc,EACd,KAAa,EACb,OAA8B;IAE9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE;YACjC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YAC/B,OAAO,EAAE,OAAO,EAAE,OAAO;SAC1B,CAAC,CAAC;QAEH,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAEhB,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;YACvC,MAAM,IAAI,IAAI,CAAC;QACjB,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;YACvC,MAAM,IAAI,IAAI,CAAC;QACjB,CAAC,CAAC,CAAC;QAEH,wEAAwE;QACxE,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAE1B,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,IAAI,IAAI,KAAK,CAAC;gBAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;;gBACvC,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACzB,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;IACpB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+export { localDateStr, nowInTimezone, getAgentDayBoundsUtc, getAgentDayDateStr, getAgentDayProgressMinutes, nextActiveHoursStart, formatSqliteDatetime, parseSqliteUtcMs, } from "./date-utils.js";
+export { EventPriority, createEvent, isMessageEvent, isDocsQAMessage, isCalendarChangeEvent, isRoutineEvent, isAgentTaskEvent, isScheduledDmEvent, isScheduledEvent, isKnowledgeImportEvent, } from "./types.js";
+export type { Event, MessageEvent, AttachmentRef, CalendarChangeEvent, RoutineEvent, AgentTaskEvent, ScheduledDmEvent, KnowledgeImportEvent, AgentResult, } from "./types.js";
+export type { Alert, AlertSeverity, AlertSource } from "./alerts.js";
+export { APP_NAME, AGENT_ROLE_DESCRIPTOR, APP_TAGLINE, APP_NAME_WITH_TAGLINE, joinTaglineWithSentence, substituteBrandTokens, } from "./branding.js";
+export { BACKEND_IDS, EXECUTION_PERMISSION_MODES, WEB_SEARCH_CAPABLE_BACKENDS, getBackendIds, isBackendId, } from "./backend.js";
+export type { BackendId, BackendCostSource, BackendModel, BackendModelTier, BackendUsage, ExecutionPermissionMode, } from "./backend.js";
+export { CLAUDE_API_KEY_PROVIDERS, CODEX_API_KEY_PROVIDERS, GEMINI_API_KEY_PROVIDERS, API_KEY_PROVIDERS_BY_BACKEND, RECOMMENDED_PINNED_MODELS_BY_PROVIDER, DEFAULT_AZURE_OPENAI_API_VERSION, defaultApiKeyProvider, isApiKeyProviderForBackend, backendApiKeyConfigSchema, anthropicApiKeyConfigSchema, bedrockApiKeyConfigSchema, vertexApiKeyConfigSchema, foundryApiKeyConfigSchema, openaiApiKeyConfigSchema, azureOpenAiApiKeyConfigSchema, googleApiKeyConfigSchema, buildCodexAzureConfigToml, getManagedApiKeyEnvVars, getApiKeyEnvAssignments, parseBackendApiKeyConfig, serializeBackendApiKeyConfig, validateBackendApiKeyConfigFormat, isPlausibleAnthropicApiKey, isPlausibleOpenAiApiKey, isPlausibleGeminiApiKey, } from "./backend-api-key-config.js";
+export type { ApiKeyProvider, ClaudeApiKeyProvider, CodexApiKeyProvider, GeminiApiKeyProvider, AnthropicApiKeyConfig, BedrockApiKeyConfig, VertexApiKeyConfig, FoundryApiKeyConfig, OpenAiApiKeyConfig, AzureOpenAiApiKeyConfig, GoogleApiKeyConfig, PinnedModelDefaults, BackendApiKeyConfig, } from "./backend-api-key-config.js";
+export { CONFIGURABLE_PROCESS_KEYS, DELEGATED_TASK_HARD_CAPS, TIER_LOCKED_PROCESS_KEYS, customRoutineKey, customRoutineSlugFromKey, getDefaultTierForProcessKey, isAutonomousProcessKey, isConfigurableProcessKey, isCustomRoutineKey, isProcessKey, resolveProcessKey, } from "./process-key.js";
+export type { ProcessKey, ProcessModelTier, } from "./process-key.js";
+export { contextPutSchema, contextPatchSchema, notifyRequestSchema, scheduleRequestSchema, scheduleUpdateRequestSchema, scheduleDmRequestSchema, actionLogRequestSchema, skillNameSchema, skillCreateSchema, skillUpdateSchema, calendarCreateEventSchema, calendarUpdateEventSchema, calendarFreeBusySchema, recurrenceRuleSchema, recurringScheduleCreateSchema, recurringScheduleUpdateSchema, triggerCreateSchema, triggerUpdateSchema, } from "./schemas.js";
+export type { NotifyRequest, ScheduleRequest, ScheduleUpdateRequest, ScheduleDmRequest, ActionLogRequest, SkillCreateRequest, SkillUpdateRequest, SkillSummary, SkillDetail, RecurrenceRule, TriggerCreateRequest, TriggerUpdateRequest, } from "./schemas.js";
+export { DEFAULT_AGENT_DISPLAY_NAME, normalizeAgentDisplayName, validateAgentDisplayName, formatAgentOutboundLabel, } from "./agent-identity.js";
+export type { LogEntry, SystemLogsResponse } from "./log-entry.js";
+export { redactSensitiveString, SENSITIVE_KEY_PATTERN, } from "./secret-redaction.js";
+export { CHAT_SIDEBAR_SCOPES, CHAT_SIDEBAR_SCOPE_PARAM, isChatSidebarScope, } from "./chat-session-scope.js";
+export type { ChatSidebarScope } from "./chat-session-scope.js";
+export { EDITABLE_RUNTIME_KEY_TUPLE, EDITABLE_BOOTSTRAP_KEY_TUPLE, RESTART_REQUIRED_KEY_TUPLE, } from "./editable-config-keys.js";
+export type { EditableRuntimeKey, EditableBootstrapKey, EditableConfigKey, RestartRequiredKey, } from "./editable-config-keys.js";
+export { INTEGRATION_KEYS, INTEGRATION_MODES, INTEGRATION_DESCRIPTORS, defaultIntegrationsMap, getIntegrationDescriptor, integrationPatchSchema, integrationStateSchema, integrationsMapSchema, isIntegrationKey, isIntegrationMode, listIntegrationDescriptors, selectSkillVariantFile, selectTaskFlowVariantSuffix, delegatedIntegrationsForProcessKey, backendHasIntegrationConnector, validateDeniedTools, filterDeniedToolsForBackend, matchToolPattern, collectSessionDeniedTools, recommendedStarterDeniedTools, destructiveTaskTools, destructiveTaskToolsBare, applyIntegrationModeFilter, INTEGRATION_MODE_PREDICATES, MCP_PATTERN_REGEX, matchRunAllowedToolPattern, validateRunAllowedTool, validateRunAllowedTools, } from "./integrations.js";
+export type { ValidateRunAllowedToolsResult } from "./integrations.js";
+export type { IntegrationBackendConnector, IntegrationDescriptor, IntegrationDirectSetup, IntegrationKey, IntegrationMode, IntegrationModePredicate, IntegrationPatch, IntegrationState, IntegrationsMap, ValidateDeniedToolsResult, } from "./integrations.js";
+export { INTEGRATION_WRITE_TTL_MS, SNAPSHOT_NORMALIZERS, getSnapshotNormalizer, hasSnapshotNormalizer, listSnapshotNormalizers, stableStringify, } from "./integrations-snapshot.js";
+export type { CalendarSnapshotPayload, IntegrationNormalizer, SnapshotActorHint, } from "./integrations-snapshot.js";
+export { DOCS_SCHEMA_VERSION, docsFrontmatterSchema, slugifyAnchor, parseCitationTokens, } from "./docs-schema.js";
+export type { DocCategory, DocStatus, DocsFrontmatter, ParsedCitationToken, } from "./docs-schema.js";
+export { FrontmatterParseError, parseFrontmatter, } from "./docs-frontmatter.js";
+export type { ParsedFrontmatter } from "./docs-frontmatter.js";
+export { ADVISOR_ALLOWED_MODELS, DEFAULT_ADVISOR_MODEL, isAdvisorModel, } from "./advisor-models.js";
+export type { AdvisorModel } from "./advisor-models.js";
+export { APP_MAX_LENGTH, DOMAINS, ENTITY_TYPES, INTENT_MAX_LENGTH, LAST_RESULT_MAX_LENGTH, MANAGEMENT_ACTIVE_TASKS_SOFT_WARNING, MANAGEMENT_FAILURE_NOTIFY_THRESHOLD_DEFAULT, MANAGEMENT_MAX_ACTIVE_TASKS_DEFAULT, MANAGEMENT_MIN_CADENCE_MINUTES_DEFAULT, TYPE_PLURALS, buildEntityPath, entitySchema, entitySourceEntrySchema, formatManagedTaskId, isDomain, isEntityType, isValidManagedTaskId, isValidOutputPath, isValidSlug, managedTaskCreateSchema, managedTaskPatchSchema, managedTaskRunResultSchema, managedTaskSchema, normalizeAppLabel, parseEntityPath, pluralToType, sotBindingSchema, sotBindingsSchema, typeToPlural, validateAppLabel, validateIntent, } from "./management-domains.js";
+export type { Domain, Entity, EntityPathParts, EntitySourceEntry, EntityType, ManagedTask, ManagedTaskCreate, ManagedTaskPatch, ManagedTaskRunResult, SotBinding, SotBindings, } from "./management-domains.js";
+export { BYTE_BUDGET as SKILL_CURATION_BYTE_BUDGET, ConventionNote, ConventionNotesPayload, CrossReference, CrossReferencesPayload, CurationDeclaration, CurationDeclarationSection, CurationPayload, DEFAULT_SKILL_CURATION_CONFIG, FrontmatterConventionalField, FrontmatterFileType, FrontmatterRequiredField, FrontmatterSchemaPayload, KnowledgeLayoutFile, KnowledgeLayoutPayload, KnowledgeLayoutSection, OverlayEnvelope, RoutingTablePayload, RoutingTableRule, SECTION_KINDS, SKILL_CURATION_SCHEMA_VERSION, SearchRecipe, SearchRecipesPayload, SkillCurationConfig, SubmitProposalRequest, ManualRunRequest, DiscardOrphanRequest, } from "./skill-curation/schemas.js";
+export type { ConventionNotesValue, CrossReferencesValue, CurationDeclarationSectionValue, CurationDeclarationValue, CurationPayloadValue, FrontmatterSchemaValue, KnowledgeLayoutValue, OverlayEnvelopeValue, RoutingTableValue, SearchRecipesValue, SectionKind, SkillCurationConfigValue, SubmitProposalRequestValue, ManualRunRequestValue, DiscardOrphanRequestValue, } from "./skill-curation/schemas.js";
+export { containsDecisionLanguage, noDecisionLanguage, noEmbeddedMarkers, DECISION_LANGUAGE_MESSAGE, EMBEDDED_MARKER_MESSAGE, } from "./skill-curation/decision-language.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,49 @@
+// Date utilities
+export { localDateStr, nowInTimezone, getAgentDayBoundsUtc, getAgentDayDateStr, getAgentDayProgressMinutes, nextActiveHoursStart, formatSqliteDatetime, parseSqliteUtcMs, } from "./date-utils.js";
+// Types
+export { EventPriority, createEvent, isMessageEvent, isDocsQAMessage, isCalendarChangeEvent, isRoutineEvent, isAgentTaskEvent, isScheduledDmEvent, isScheduledEvent, isKnowledgeImportEvent, } from "./types.js";
+// Brand identity (single source of truth for product name / role anchor /
+// tagline — substituted into agent-asset markdown and consumed directly
+// by TS imports across daemon + dashboard). See `branding.ts`.
+export { APP_NAME, AGENT_ROLE_DESCRIPTOR, APP_TAGLINE, APP_NAME_WITH_TAGLINE, joinTaglineWithSentence, substituteBrandTokens, } from "./branding.js";
+// Multi-backend shared types
+export { BACKEND_IDS, EXECUTION_PERMISSION_MODES, WEB_SEARCH_CAPABLE_BACKENDS, getBackendIds, isBackendId, } from "./backend.js";
+// Per-backend provider auth config (direct API key / Bedrock / Vertex /
+// Foundry / Codex Azure / Gemini Vertex). See `backend-api-key-config.ts`.
+export { CLAUDE_API_KEY_PROVIDERS, CODEX_API_KEY_PROVIDERS, GEMINI_API_KEY_PROVIDERS, API_KEY_PROVIDERS_BY_BACKEND, RECOMMENDED_PINNED_MODELS_BY_PROVIDER, DEFAULT_AZURE_OPENAI_API_VERSION, defaultApiKeyProvider, isApiKeyProviderForBackend, backendApiKeyConfigSchema, anthropicApiKeyConfigSchema, bedrockApiKeyConfigSchema, vertexApiKeyConfigSchema, foundryApiKeyConfigSchema, openaiApiKeyConfigSchema, azureOpenAiApiKeyConfigSchema, googleApiKeyConfigSchema, buildCodexAzureConfigToml, getManagedApiKeyEnvVars, getApiKeyEnvAssignments, parseBackendApiKeyConfig, serializeBackendApiKeyConfig, validateBackendApiKeyConfigFormat, isPlausibleAnthropicApiKey, isPlausibleOpenAiApiKey, isPlausibleGeminiApiKey, } from "./backend-api-key-config.js";
+// Process-key helpers
+export { CONFIGURABLE_PROCESS_KEYS, DELEGATED_TASK_HARD_CAPS, TIER_LOCKED_PROCESS_KEYS, customRoutineKey, customRoutineSlugFromKey, getDefaultTierForProcessKey, isAutonomousProcessKey, isConfigurableProcessKey, isCustomRoutineKey, isProcessKey, resolveProcessKey, } from "./process-key.js";
+// Schemas
+export { contextPutSchema, contextPatchSchema, notifyRequestSchema, scheduleRequestSchema, scheduleUpdateRequestSchema, scheduleDmRequestSchema, actionLogRequestSchema, skillNameSchema, skillCreateSchema, skillUpdateSchema, calendarCreateEventSchema, calendarUpdateEventSchema, calendarFreeBusySchema, recurrenceRuleSchema, recurringScheduleCreateSchema, recurringScheduleUpdateSchema, triggerCreateSchema, triggerUpdateSchema, } from "./schemas.js";
+// Agent identity helpers
+export { DEFAULT_AGENT_DISPLAY_NAME, normalizeAgentDisplayName, validateAgentDisplayName, formatAgentOutboundLabel, } from "./agent-identity.js";
+// Secret redaction helpers
+export { redactSensitiveString, SENSITIVE_KEY_PATTERN, } from "./secret-redaction.js";
+// Chat sidebar scope list (shared between daemon delete helper and
+// dashboard useConversations filter — must never drift)
+export { CHAT_SIDEBAR_SCOPES, CHAT_SIDEBAR_SCOPE_PARAM, isChatSidebarScope, } from "./chat-session-scope.js";
+// Editable config key definitions (shared between daemon and dashboard)
+export { EDITABLE_RUNTIME_KEY_TUPLE, EDITABLE_BOOTSTRAP_KEY_TUPLE, RESTART_REQUIRED_KEY_TUPLE, } from "./editable-config-keys.js";
+// Integration delegation framework (shared between daemon registry +
+// dashboard cards — single source of truth for mode vocabulary)
+export { INTEGRATION_KEYS, INTEGRATION_MODES, INTEGRATION_DESCRIPTORS, defaultIntegrationsMap, getIntegrationDescriptor, integrationPatchSchema, integrationStateSchema, integrationsMapSchema, isIntegrationKey, isIntegrationMode, listIntegrationDescriptors, selectSkillVariantFile, selectTaskFlowVariantSuffix, delegatedIntegrationsForProcessKey, backendHasIntegrationConnector, validateDeniedTools, filterDeniedToolsForBackend, matchToolPattern, collectSessionDeniedTools, recommendedStarterDeniedTools, destructiveTaskTools, destructiveTaskToolsBare, applyIntegrationModeFilter, INTEGRATION_MODE_PREDICATES, MCP_PATTERN_REGEX, matchRunAllowedToolPattern, validateRunAllowedTool, validateRunAllowedTools, } from "./integrations.js";
+// Integration drift-detection snapshot normalizers
+// (INTEGRATION-DRIFT-DETECTION-PLAN.md §5.2)
+export { INTEGRATION_WRITE_TTL_MS, SNAPSHOT_NORMALIZERS, getSnapshotNormalizer, hasSnapshotNormalizer, listSnapshotNormalizers, stableStringify, } from "./integrations-snapshot.js";
+// Docs & QA frontmatter schema (shared between daemon indexer + dashboard
+// renderer/page-doc-map drift guard — single source of truth)
+export { DOCS_SCHEMA_VERSION, docsFrontmatterSchema, slugifyAnchor, parseCitationTokens, } from "./docs-schema.js";
+export { FrontmatterParseError, parseFrontmatter, } from "./docs-frontmatter.js";
+// Advisor model allowlist (Claude Agent SDK constraint, shared between
+// daemon validators + dashboard dropdown)
+export { ADVISOR_ALLOWED_MODELS, DEFAULT_ADVISOR_MODEL, isAdvisorModel, } from "./advisor-models.js";
+// Management Registry — domain enum, entity-type map, path validators,
+// and Zod schemas. Shared between daemon (api/routes/managed-tasks,
+// core/management-registry, core/entity-mirror), dashboard (Settings →
+// Management page, entity browser), and skill prompts. See
+// `docs/design/21-management-registry-and-entities.md`.
+export { APP_MAX_LENGTH, DOMAINS, ENTITY_TYPES, INTENT_MAX_LENGTH, LAST_RESULT_MAX_LENGTH, MANAGEMENT_ACTIVE_TASKS_SOFT_WARNING, MANAGEMENT_FAILURE_NOTIFY_THRESHOLD_DEFAULT, MANAGEMENT_MAX_ACTIVE_TASKS_DEFAULT, MANAGEMENT_MIN_CADENCE_MINUTES_DEFAULT, TYPE_PLURALS, buildEntityPath, entitySchema, entitySourceEntrySchema, formatManagedTaskId, isDomain, isEntityType, isValidManagedTaskId, isValidOutputPath, isValidSlug, managedTaskCreateSchema, managedTaskPatchSchema, managedTaskRunResultSchema, managedTaskSchema, normalizeAppLabel, parseEntityPath, pluralToType, sotBindingSchema, sotBindingsSchema, typeToPlural, validateAppLabel, validateIntent, } from "./management-domains.js";
+// Skill-curation typed payloads (P22 §1.4) — appendix p22-skill-self-optimization.md.
+export { BYTE_BUDGET as SKILL_CURATION_BYTE_BUDGET, ConventionNote, ConventionNotesPayload, CrossReference, CrossReferencesPayload, CurationDeclaration, CurationDeclarationSection, CurationPayload, DEFAULT_SKILL_CURATION_CONFIG, FrontmatterConventionalField, FrontmatterFileType, FrontmatterRequiredField, FrontmatterSchemaPayload, KnowledgeLayoutFile, KnowledgeLayoutPayload, KnowledgeLayoutSection, OverlayEnvelope, RoutingTablePayload, RoutingTableRule, SECTION_KINDS, SKILL_CURATION_SCHEMA_VERSION, SearchRecipe, SearchRecipesPayload, SkillCurationConfig, SubmitProposalRequest, ManualRunRequest, DiscardOrphanRequest, } from "./skill-curation/schemas.js";
+export { containsDecisionLanguage, noDecisionLanguage, noEmbeddedMarkers, DECISION_LANGUAGE_MESSAGE, EMBEDDED_MARKER_MESSAGE, } from "./skill-curation/decision-language.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/integrations-snapshot.d.ts

@@ -0,0 +1,183 @@
+import { type IntegrationKey } from "./integrations.js";
+/**
+ * Snapshot normalizers for `integration_snapshots` reconcile pipeline.
+ *
+ * Per INTEGRATION-DRIFT-DETECTION-PLAN.md §5.2: each integration ships a
+ * pure normalizer that turns a raw upstream payload into the canonical
+ * shape stored in `integration_snapshots.payload_json`, plus a stable
+ * sha256 over a sorted JSON encoding of that shape used for diff
+ * comparison. The normalizer is shared between the daemon (CalendarPoller,
+ * DelegatedSyncWorker, reconcile route) and the LLM-driven hourly check
+ * path so behaviour is identical regardless of who writes the snapshot.
+ *
+ * Phase 1 shipped the calendar normalizer; Phase 5 adds Gmail thread and
+ * Notion page normalizers. The registry stays `Partial` so a future
+ * integration can land its connector wiring before its normalizer (route
+ * handlers continue returning a structured 400 in that gap).
+ */
+/**
+ * Actor pre-mark a reconcile caller can attach per-item. Mirrors the
+ * `observations.actor` column / `integration_snapshots.actor_hint` CHECK
+ * constraint vocabulary so a hint flows straight through to either column
+ * without translation. Reconcile still consults `integration_writes` as the
+ * authoritative source — this is only the fallback.
+ */
+export type SnapshotActorHint = "user" | "agent" | "system" | "unknown";
+/**
+ * Default TTL for `integration_writes` entries, per integration.
+ *
+ * INTEGRATION-DRIFT-DETECTION-PLAN.md §17.11 requires `TTL ≥ slowest_cadence
+ * × 1.5` so an agent-originated write at T0 cannot have its attribution
+ * mark expire before the next reconcile sees it as a user write. Phase 7
+ * (c) tightens these constants to cover the §8.3 default cadences with
+ * margin:
+ *
+ *   - google_calendar: slowest cadence is the 24h-window default (60 min)
+ *     → 60 × 1.5 = 90 min. The 10-min imminent cadence is irrelevant for
+ *     TTL because an agent-originated event always lands inside the 24h
+ *     window first; the slowest cadence governs the contract.
+ *   - gmail: 30 min default → 45 min. The 15-min soft floor gives the
+ *     same TTL margin if the operator presses cadence to its minimum.
+ *   - notion: 60 min default → 90 min. Pre-Phase-7 this was 30 min, which
+ *     left the agent's own page edits at risk of mis-attribution on the
+ *     very next worker tick.
+ *
+ * Operators who push a cadence past the corresponding TTL via
+ * `runtime_state.delegatedSync.intervals` opt into the pre-fix regime.
+ * The DelegatedSyncWorker logs warn at start and surfaces the violation
+ * via `getStatus().ttlContractViolations` so the breach is observable
+ * rather than silent.
+ */
+export declare const INTEGRATION_WRITE_TTL_MS: Readonly<Record<IntegrationKey, number>>;
+export interface IntegrationNormalizer<TRaw = unknown, TPayload = unknown> {
+    /** Stable identifier within `(integration, window_key)`. */
+    itemId(raw: TRaw): string;
+    /** Canonical, fully-sorted payload stored in `payload_json`. */
+    payload(raw: TRaw): TPayload;
+    /** sha256 hex digest of a stable JSON encoding of the canonical payload. */
+    hash(payload: TPayload): string;
+    /** ISO-8601 start time, or `null` when the integration has no scheduled
+     *  start (Gmail/Notion). Calendar uses this to feed the imminent-event
+     *  scheduler index. */
+    itemStart(raw: TRaw): string | null;
+    /**
+     * §5.1 sliding-window predicate. Returns true if the (already-normalized)
+     * payload's time field falls within `[windowMin, windowMax)`. Reconcile
+     * uses this to distinguish a prior row that simply slid out of the
+     * window (silent prune, no observation emitted) from one that was truly
+     * deleted upstream (observation emitted). The predicate is per-integration
+     * because each integration's "time field" lives at a different path
+     * (calendar.start, gmail.internalDate, notion.lastEditedTime).
+     */
+    inWindow(payload: TPayload, windowMin: string, windowMax: string): boolean;
+}
+/**
+ * Canonical calendar snapshot payload. Field order in the type does not
+ * affect the hash — `stableStringify` sorts keys at every level — but the
+ * order documents the intent: identity-shaping fields first, then mutable
+ * detail. `htmlLink` is included because it lets the agent render a deep
+ * link without re-fetching, but it is excluded from the hash (it is purely
+ * derivable from the event id).
+ */
+export interface CalendarSnapshotPayload {
+    summary: string | null;
+    start: string | null;
+    end: string | null;
+    location: string | null;
+    description: string | null;
+    status: string | null;
+    /** Sorted by email so attendee-order jitter does not flap the hash. */
+    attendees: Array<{
+        email: string;
+        responseStatus: string;
+    }>;
+    /** Display-only, excluded from hash. */
+    htmlLink: string | null;
+}
+/**
+ * Lexicographic-key JSON encoder. Drop-in replacement for JSON.stringify
+ * that walks objects with a sorted key list at every level so two
+ * structurally-equal payloads always serialize identically. Arrays
+ * preserve order — the calendar normalizer pre-sorts attendees so
+ * `[{email:"a"}, {email:"b"}]` and `[{email:"b"}, {email:"a"}]` are
+ * distinct payloads pre-normalize but identical post-normalize.
+ */
+export declare function stableStringify(value: unknown): string;
+/**
+ * Canonical Gmail thread snapshot payload. The shape is granularity-thread
+ * (per §15.4): `messageIds` lets reconcile detect a new message landing in an
+ * already-seen thread (length growth → hash differs → `modified` diff).
+ *
+ * `snippet` is intentionally display-only (excluded from the hash) — Gmail
+ * regenerates snippets server-side and an unrelated rewrite would otherwise
+ * flap the hash on every poll (§17.10). `from` is canonicalised to a
+ * lowercase email-only string so the hash is stable across `"Name <email>"`
+ * vs. `{ name, email }` connector representations and across capitalisation
+ * jitter.
+ */
+export interface GmailSnapshotPayload {
+    threadId: string;
+    subject: string | null;
+    /** Canonical lowercase email of the most recent sender. */
+    from: string | null;
+    /** Sorted ascending. */
+    labelIds: string[];
+    /** Sorted ascending. */
+    messageIds: string[];
+    /** ISO-8601 of the latest message's `internalDate`, when known. */
+    lastMessageInternalDate: string | null;
+    /** Display-only, excluded from the hash. */
+    snippet: string | null;
+}
+/**
+ * Canonical Notion page snapshot payload. Hash discipline (§17.9):
+ *
+ *   - `title`, `lastEditedTime`, `parentDatabase` — page identity.
+ *   - `propertiesSummaryHash` — sha256 over a canonical projection of the
+ *     page's properties. Property types Notion knows about have stable
+ *     value-shape extractors below; unknown types fall through to a
+ *     conservative "type-tag only" projection so a new property shape does
+ *     not silently flap the hash forever — the `propertiesSummary` display
+ *     string still reflects the values, just not the hash.
+ *   - `relationsHash` — sha256 over sorted relation-target ids per relation
+ *     property. Separated so a future framework upgrade can promote
+ *     relation changes to a first-class diff cause without re-versioning
+ *     the page hash.
+ *
+ * Notion bumps `last_edited_time` whenever any property or block changes,
+ * so the conservative path (just `lastEditedTime` + `parentDatabase` +
+ * `title`) catches every meaningful diff. The properties hash is what
+ * lets the agent reason "what specifically changed" from the diff entry.
+ */
+export interface NotionSnapshotPayload {
+    pageId: string;
+    title: string | null;
+    lastEditedTime: string | null;
+    parentDatabase: string | null;
+    url: string | null;
+    inTrash: boolean;
+    /** Display-only summary string (status / select / date highlights), excluded from the hash. */
+    propertiesSummary: string | null;
+    /** sha256 hex of `{ [propName]: canonical-value-shape }` (sorted keys). */
+    propertiesSummaryHash: string;
+    /** sha256 hex of `{ [propName]: sorted-relation-id-array }` (sorted keys). */
+    relationsHash: string;
+}
+/**
+ * Normalizer registry. Phase 5 ships gmail and notion alongside calendar.
+ * Adding a future integration is one Record entry — the route handler
+ * reads via `getSnapshotNormalizer(key)` and stays integration-key-driven.
+ */
+export declare const SNAPSHOT_NORMALIZERS: Readonly<Partial<Record<IntegrationKey, IntegrationNormalizer>>>;
+/** True if the integration has a Phase-1 normalizer registered. Used by
+ *  the reconcile route to fail fast with a precise error message before
+ *  parsing items. */
+export declare function hasSnapshotNormalizer(key: IntegrationKey): boolean;
+/** List the integrations currently registered with a normalizer. Drives
+ *  the `supportedIntegrations` field in error responses so a caller sees
+ *  the contract without grepping the source. */
+export declare function listSnapshotNormalizers(): IntegrationKey[];
+/** Fetch the normalizer for an integration. Returns `undefined` for
+ *  unsupported integrations so the caller can return a structured 400. */
+export declare function getSnapshotNormalizer(key: IntegrationKey): IntegrationNormalizer | undefined;
+//# sourceMappingURL=integrations-snapshot.d.ts.map

package/dist/integrations-snapshot.d.ts.map

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