zam-core 0.4.4 → 0.5.1

package/dist/index.d.ts

@@ -1795,6 +1795,40 @@ interface InstallConfig {
     mode?: InstallMode;
     /** How this copy was installed; drives the self-update mechanism. */
     channel?: InstallChannel;
+    /** Machine-local AI provider choices; never synchronized through the DB. */
+    ai?: MachineAiConfig;
+    /** Machine-local paths to existing personal/team/community workspaces. */
+    workspaces?: WorkspaceConfig[];
+}
+type MachineAiRole = "vision" | "recall" | "text";
+type MachineApiFlavor = "chat-completions" | "anthropic-messages";
+interface MachineProviderRecord {
+    label?: string;
+    url?: string;
+    model?: string;
+    apiFlavor?: MachineApiFlavor;
+    apiKeyRef?: string;
+    local?: boolean;
+    runner?: string;
+}
+interface MachineRoleBinding {
+    primary?: string;
+    fallback?: string;
+}
+interface MachineAiConfig {
+    providers?: Record<string, MachineProviderRecord>;
+    roles?: Partial<Record<MachineAiRole, MachineRoleBinding>>;
+}
+type WorkspaceKind = "personal" | "team" | "family" | "community" | "organization" | "custom";
+type WorkspaceSourceControl = "github" | "azure-devops" | "git" | "none";
+interface WorkspaceConfig {
+    id: string;
+    label?: string;
+    kind: WorkspaceKind;
+    path: string;
+    sourceControl?: WorkspaceSourceControl;
+    knowledgeScopes?: string[];
+    defaultAgent?: string;
 }
 /** Load ~/.zam/config.json. Returns an empty config if missing or unreadable. */
 declare function loadInstallConfig(path?: string): InstallConfig;
@@ -1814,6 +1848,12 @@ declare function setInstallMode(mode: InstallMode, path?: string): void;
  */
 declare function getInstallChannel(path?: string): InstallChannel;
 declare function setInstallChannel(channel: InstallChannel, path?: string): void;
+declare function getMachineAiConfig(path?: string): MachineAiConfig;
+declare function saveMachineAiConfig(ai: MachineAiConfig, path?: string): void;
+declare function getConfiguredWorkspaces(path?: string): WorkspaceConfig[];
+declare function saveConfiguredWorkspaces(workspaces: WorkspaceConfig[], path?: string): void;
+declare function upsertConfiguredWorkspace(workspace: WorkspaceConfig, path?: string): WorkspaceConfig[];
+declare function removeConfiguredWorkspace(id: string, path?: string): WorkspaceConfig[];
 /**
  * Best-effort detection of the file-sync provider a folder lives in, from its
  * path. Used only for friendly messaging ("this folder syncs via OneDrive —
@@ -1908,4 +1948,4 @@ declare function resolveAllBeliefPaths(db: Database): Promise<string[]>;
  */
 declare function resolveAllGoalPaths(db: Database): Promise<string[]>;
 
-export { type ADOConfig, type ADOCredentials, type AgentSkill, type AnalysisResult, type ApplySessionSynthesisInput, type ApplySessionSynthesisResult, BUILT_IN_SENSITIVE_MATCHERS, type BloomLevel$1 as BloomLevel, type CaptureDecision, type CaptureDenialReason, type CaptureRequest, type Card, type CardDeletionImpact, type CardState$1 as CardState, type CascadeBlockResult, type CommandRecord, type CommandSequence, type ConnectionOptions, type CreateAgentSkillInput, type CreateGoalInput, type CreateReviewInput, type CreateSessionInput, type CreateTokenInput, type Credentials, DEFAULT_OBSERVER_POLICY, DEFAULT_REVIEW_CONTEXT_MAX_CHARS, type Database, type DatabaseProvider, type DatabaseTargetInfo, type DatabaseValue, type DeleteCardResult, type DeleteTokenResult, type DiscoveryOptions, type DomainCompetence, type EvaluateInput, type EvaluateResult, type ExecuteReviewActionInput, type ExecutionContext, type FSRSParameters, type Goal, type GoalFrontmatter, type GoalStatus, type GoalSummary, HOMEBREW_CASK, type ImportResult, type InstallChannel, type InstallConfig, type InstallMode, type InstallPlan, type InstallResult, type LocalLLMRunner, type LogStepInput, type MonitorEvent, type Neighborhood, type NeighborhoodToken, OBSERVER_POLICY_UNSET_HINT, OBSERVER_POLICY_VERSION, type ObservationRating, type ObserverConsent, type ObserverPolicy, type ObserverRetention, type ObserverScope, type ObserverSettingKey, type PrepareSessionSynthesisInput, type Prerequisite, type PrerequisiteWithToken, type PromptInput, type Rating, type RecallPrompt, type RemoteDatabaseOptions, type RepoPaths, type ResolvedCaptureTarget, type ResolvedReference, type ReviewActionResult, type ReviewActionType, type ReviewContext, type ReviewLog, type ReviewQueue, type ReviewQueueItem, type ReviewQueueOptions, type RunResult, SIDECAR_POLICY_FILE, SNAPSHOT_VERSION, type SchedulingCard, type Session, type SessionStep, type SessionSummary, type SessionSynthesisCandidate, type SessionSynthesisEvidence, type SessionSynthesisPreview, type SessionSynthesisRecord, type SidecarPrivacyPolicy, type SkillProposal, type SkillSource, type SnapshotManifest, type Statement, type SupportedLocale, type SymbiosisMode, type SynthesisConfidence, type SystemProfile, type Token, type TokenDeleteImpact, type TokenPattern, type TranslationKey, type TursoCredentials, UI_OBSERVATION_PROTOCOL_VERSION, type UiActionType, type UiApplicationContext, type UiCandidateToken, type UiEvidenceRef, type UiEvidenceType, type UiObservationKind, type UiObservationReport, type UiObservedAction, type UnblockResult, type UpdateActionKind, type UpdateCardInput, type UpdateDecision, type UpdateStep, type UpdateStepKind, type UpdateTokenInput, type UserSetting, type UserStats, WINGET_PACKAGE_ID, type WorkItem, addPrerequisite, analyzeObservation, appendUiObservationReport, applySessionSynthesis, buildReviewQueue, buildUiSynthesisCandidates, cascadeBlock, clearADOCredentials, clearProviderApiKey, clearTursoCredentials, compareVersions, createAgentSkill, createFSRS, createGoal, createToken, decidePostCapture, decidePreCapture, decideUpdate, deleteCardForUser, deleteSetting, deleteToken, deprecateToken, detectSyncProvider, detectSystemLocale, discoverSkills, distributeGlobalSkills, endSession, ensureCard, ensureMonitorDir, ensureUiObserverDir, evaluateRating, executeReviewAction, exportSnapshot, extractTasks, extractTokenRefs, fetchActiveWorkItems, findTokens, generateBashHooks, generateBashUnhooks, generateConceptFreeCue, generatePowerShellHooks, generatePowerShellUnhooks, generatePrompt, generateZshHooks, generateZshUnhooks, getADOCredentials, getAgentSkill, getAllSettings, getAllSettingsDetailed, getBlockedCards, getCard, getCardById, getCardDeletionImpact, getDatabaseTargetInfo, getDefaultDbPath, getDependents, getDomainCompetence, getDueCards, getGoal, getGoalTree, getInstallChannel, getInstallMode, getMonitorDir, getMonitorLogStats, getMonitorPath, getPackageSkillPath, getPrerequisites, getProviderApiKey, getRepoPaths, getReviewsForCard, getReviewsForUser, getSessionSummary, getSessionSynthesisRecords, getSetting, getSystemProfile, getTokenById, getTokenBySlug, getTokenDeleteImpact, getTokenNeighborhood, getTursoCredentials, getUiObservationPath, getUiObserverDir, getUserStats, hasCommand, importSnapshot, injectShellHooks, installFastFlowLM, installOllama, installOpenCode, interleave, isObserverPolicyConfigured, isUiObservationReport, listAgentSkills, listGoals, listProviderApiKeyRefs, listTokens, loadADOConfig, loadCredentials, loadInstallConfig, logReview, logStep, matchBuiltInSensitive, matchDenylist, matchesFilePath, monitorLogExists, normalizeLocale, normalizePath, openDatabase, openDatabaseWithSync, openRemoteDatabase, pairCommands, parseGoalFile, parseMonitorLog, parseObserverList, parseObserverPolicy, parseSnapshot, parseUiObservationLog, planOpenCodeInstall, planUpdate, prepareLocalModel, prepareSessionSynthesis, readMonitorLog, readUiObservationLog, resolveAllBeliefPaths, resolveAllGoalPaths, resolveObserverPolicy, resolveReference, resolveRepoPath, resolveReviewContext, saveCredentials, saveInstallConfig, serializeGoal, setADOCredentials, setInstallChannel, setInstallMode, setProviderApiKey, setSetting, setTursoCredentials, startSession, syncObserverSidecarPolicy, t, toSidecarPrivacyPolicy, uiObservationLogExists, uiObservationTimeSpan, unblockReady, updateCard, updateGoalStatus, updateToken, verifySnapshot, wouldCreateCycle, writeMonitorEvent };
+export { type ADOConfig, type ADOCredentials, type AgentSkill, type AnalysisResult, type ApplySessionSynthesisInput, type ApplySessionSynthesisResult, BUILT_IN_SENSITIVE_MATCHERS, type BloomLevel$1 as BloomLevel, type CaptureDecision, type CaptureDenialReason, type CaptureRequest, type Card, type CardDeletionImpact, type CardState$1 as CardState, type CascadeBlockResult, type CommandRecord, type CommandSequence, type ConnectionOptions, type CreateAgentSkillInput, type CreateGoalInput, type CreateReviewInput, type CreateSessionInput, type CreateTokenInput, type Credentials, DEFAULT_OBSERVER_POLICY, DEFAULT_REVIEW_CONTEXT_MAX_CHARS, type Database, type DatabaseProvider, type DatabaseTargetInfo, type DatabaseValue, type DeleteCardResult, type DeleteTokenResult, type DiscoveryOptions, type DomainCompetence, type EvaluateInput, type EvaluateResult, type ExecuteReviewActionInput, type ExecutionContext, type FSRSParameters, type Goal, type GoalFrontmatter, type GoalStatus, type GoalSummary, HOMEBREW_CASK, type ImportResult, type InstallChannel, type InstallConfig, type InstallMode, type InstallPlan, type InstallResult, type LocalLLMRunner, type LogStepInput, type MachineAiConfig, type MachineProviderRecord, type MachineRoleBinding, type MonitorEvent, type Neighborhood, type NeighborhoodToken, OBSERVER_POLICY_UNSET_HINT, OBSERVER_POLICY_VERSION, type ObservationRating, type ObserverConsent, type ObserverPolicy, type ObserverRetention, type ObserverScope, type ObserverSettingKey, type PrepareSessionSynthesisInput, type Prerequisite, type PrerequisiteWithToken, type PromptInput, type Rating, type RecallPrompt, type RemoteDatabaseOptions, type RepoPaths, type ResolvedCaptureTarget, type ResolvedReference, type ReviewActionResult, type ReviewActionType, type ReviewContext, type ReviewLog, type ReviewQueue, type ReviewQueueItem, type ReviewQueueOptions, type RunResult, SIDECAR_POLICY_FILE, SNAPSHOT_VERSION, type SchedulingCard, type Session, type SessionStep, type SessionSummary, type SessionSynthesisCandidate, type SessionSynthesisEvidence, type SessionSynthesisPreview, type SessionSynthesisRecord, type SidecarPrivacyPolicy, type SkillProposal, type SkillSource, type SnapshotManifest, type Statement, type SupportedLocale, type SymbiosisMode, type SynthesisConfidence, type SystemProfile, type Token, type TokenDeleteImpact, type TokenPattern, type TranslationKey, type TursoCredentials, UI_OBSERVATION_PROTOCOL_VERSION, type UiActionType, type UiApplicationContext, type UiCandidateToken, type UiEvidenceRef, type UiEvidenceType, type UiObservationKind, type UiObservationReport, type UiObservedAction, type UnblockResult, type UpdateActionKind, type UpdateCardInput, type UpdateDecision, type UpdateStep, type UpdateStepKind, type UpdateTokenInput, type UserSetting, type UserStats, WINGET_PACKAGE_ID, type WorkItem, type WorkspaceConfig, type WorkspaceKind, type WorkspaceSourceControl, addPrerequisite, analyzeObservation, appendUiObservationReport, applySessionSynthesis, buildReviewQueue, buildUiSynthesisCandidates, cascadeBlock, clearADOCredentials, clearProviderApiKey, clearTursoCredentials, compareVersions, createAgentSkill, createFSRS, createGoal, createToken, decidePostCapture, decidePreCapture, decideUpdate, deleteCardForUser, deleteSetting, deleteToken, deprecateToken, detectSyncProvider, detectSystemLocale, discoverSkills, distributeGlobalSkills, endSession, ensureCard, ensureMonitorDir, ensureUiObserverDir, evaluateRating, executeReviewAction, exportSnapshot, extractTasks, extractTokenRefs, fetchActiveWorkItems, findTokens, generateBashHooks, generateBashUnhooks, generateConceptFreeCue, generatePowerShellHooks, generatePowerShellUnhooks, generatePrompt, generateZshHooks, generateZshUnhooks, getADOCredentials, getAgentSkill, getAllSettings, getAllSettingsDetailed, getBlockedCards, getCard, getCardById, getCardDeletionImpact, getConfiguredWorkspaces, getDatabaseTargetInfo, getDefaultDbPath, getDependents, getDomainCompetence, getDueCards, getGoal, getGoalTree, getInstallChannel, getInstallMode, getMachineAiConfig, getMonitorDir, getMonitorLogStats, getMonitorPath, getPackageSkillPath, getPrerequisites, getProviderApiKey, getRepoPaths, getReviewsForCard, getReviewsForUser, getSessionSummary, getSessionSynthesisRecords, getSetting, getSystemProfile, getTokenById, getTokenBySlug, getTokenDeleteImpact, getTokenNeighborhood, getTursoCredentials, getUiObservationPath, getUiObserverDir, getUserStats, hasCommand, importSnapshot, injectShellHooks, installFastFlowLM, installOllama, installOpenCode, interleave, isObserverPolicyConfigured, isUiObservationReport, listAgentSkills, listGoals, listProviderApiKeyRefs, listTokens, loadADOConfig, loadCredentials, loadInstallConfig, logReview, logStep, matchBuiltInSensitive, matchDenylist, matchesFilePath, monitorLogExists, normalizeLocale, normalizePath, openDatabase, openDatabaseWithSync, openRemoteDatabase, pairCommands, parseGoalFile, parseMonitorLog, parseObserverList, parseObserverPolicy, parseSnapshot, parseUiObservationLog, planOpenCodeInstall, planUpdate, prepareLocalModel, prepareSessionSynthesis, readMonitorLog, readUiObservationLog, removeConfiguredWorkspace, resolveAllBeliefPaths, resolveAllGoalPaths, resolveObserverPolicy, resolveReference, resolveRepoPath, resolveReviewContext, saveConfiguredWorkspaces, saveCredentials, saveInstallConfig, saveMachineAiConfig, serializeGoal, setADOCredentials, setInstallChannel, setInstallMode, setProviderApiKey, setSetting, setTursoCredentials, startSession, syncObserverSidecarPolicy, t, toSidecarPrivacyPolicy, uiObservationLogExists, uiObservationTimeSpan, unblockReady, updateCard, updateGoalStatus, updateToken, upsertConfiguredWorkspace, verifySnapshot, wouldCreateCycle, writeMonitorEvent };

package/dist/index.js

@@ -4466,8 +4466,10 @@ function t(locale, key, params = {}) {
 import { existsSync as existsSync8, mkdirSync as mkdirSync7, readFileSync as readFileSync8, writeFileSync as writeFileSync5 } from "fs";
 import { homedir as homedir6 } from "os";
 import { dirname as dirname4, join as join9 } from "path";
-var DEFAULT_CONFIG_PATH = join9(homedir6(), ".zam", "config.json");
-function loadInstallConfig(path = DEFAULT_CONFIG_PATH) {
+function defaultConfigPath() {
+  return process.env.ZAM_CONFIG_PATH || join9(homedir6(), ".zam", "config.json");
+}
+function loadInstallConfig(path = defaultConfigPath()) {
   if (!existsSync8(path)) return {};
   try {
     return JSON.parse(readFileSync8(path, "utf-8"));
@@ -4475,30 +4477,62 @@ function loadInstallConfig(path = DEFAULT_CONFIG_PATH) {
     return {};
   }
 }
-function saveInstallConfig(config, path = DEFAULT_CONFIG_PATH) {
+function saveInstallConfig(config, path = defaultConfigPath()) {
   const dir = dirname4(path);
   if (!existsSync8(dir)) mkdirSync7(dir, { recursive: true });
   writeFileSync5(path, `${JSON.stringify(config, null, 2)}
 `, "utf-8");
 }
-function getInstallMode(path = DEFAULT_CONFIG_PATH) {
+function getInstallMode(path = defaultConfigPath()) {
   return loadInstallConfig(path).mode ?? "developer";
 }
-function setInstallMode(mode, path = DEFAULT_CONFIG_PATH) {
+function setInstallMode(mode, path = defaultConfigPath()) {
   const config = loadInstallConfig(path);
   config.mode = mode;
   saveInstallConfig(config, path);
 }
-function getInstallChannel(path = DEFAULT_CONFIG_PATH) {
+function getInstallChannel(path = defaultConfigPath()) {
   const config = loadInstallConfig(path);
   if (config.channel) return config.channel;
   return (config.mode ?? "developer") === "developer" ? "developer" : "direct";
 }
-function setInstallChannel(channel, path = DEFAULT_CONFIG_PATH) {
+function setInstallChannel(channel, path = defaultConfigPath()) {
   const config = loadInstallConfig(path);
   config.channel = channel;
   saveInstallConfig(config, path);
 }
+function getMachineAiConfig(path = defaultConfigPath()) {
+  return loadInstallConfig(path).ai ?? {};
+}
+function saveMachineAiConfig(ai, path = defaultConfigPath()) {
+  const config = loadInstallConfig(path);
+  config.ai = ai;
+  saveInstallConfig(config, path);
+}
+function getConfiguredWorkspaces(path = defaultConfigPath()) {
+  return loadInstallConfig(path).workspaces ?? [];
+}
+function saveConfiguredWorkspaces(workspaces, path = defaultConfigPath()) {
+  const config = loadInstallConfig(path);
+  config.workspaces = workspaces;
+  saveInstallConfig(config, path);
+}
+function upsertConfiguredWorkspace(workspace, path = defaultConfigPath()) {
+  const current = getConfiguredWorkspaces(path);
+  const next = [
+    ...current.filter((candidate) => candidate.id !== workspace.id),
+    workspace
+  ];
+  saveConfiguredWorkspaces(next, path);
+  return next;
+}
+function removeConfiguredWorkspace(id, path = defaultConfigPath()) {
+  const next = getConfiguredWorkspaces(path).filter(
+    (workspace) => workspace.id !== id
+  );
+  saveConfiguredWorkspaces(next, path);
+  return next;
+}
 function detectSyncProvider(dir) {
   const p = dir.toLowerCase();
   if (p.includes("onedrive")) return "OneDrive";
@@ -5055,6 +5089,7 @@ export {
   getCard,
   getCardById,
   getCardDeletionImpact,
+  getConfiguredWorkspaces,
   getDatabaseTargetInfo,
   getDefaultDbPath,
   getDependents,
@@ -5064,6 +5099,7 @@ export {
   getGoalTree,
   getInstallChannel,
   getInstallMode,
+  getMachineAiConfig,
   getMonitorDir,
   getMonitorLogStats,
   getMonitorPath,
@@ -5125,14 +5161,17 @@ export {
   prepareSessionSynthesis,
   readMonitorLog,
   readUiObservationLog,
+  removeConfiguredWorkspace,
   resolveAllBeliefPaths,
   resolveAllGoalPaths,
   resolveObserverPolicy,
   resolveReference,
   resolveRepoPath,
   resolveReviewContext,
+  saveConfiguredWorkspaces,
   saveCredentials,
   saveInstallConfig,
+  saveMachineAiConfig,
   serializeGoal,
   setADOCredentials,
   setInstallChannel,
@@ -5150,6 +5189,7 @@ export {
   updateCard,
   updateGoalStatus,
   updateToken,
+  upsertConfiguredWorkspace,
   verifySnapshot,
   wouldCreateCycle,
   writeMonitorEvent