path

func ACPProbeCacheFile ¶

func ACPProbeCacheFile() (string, error)

ACPProbeCacheFile returns the persisted ACP selector snapshot path.

func AgentCatalogFile ¶

func AgentCatalogFile() (string, error)

AgentCatalogFile returns the persistent custom-agent catalog path.

func AuthConfigDir ¶

func AuthConfigDir() (string, error)

AuthConfigDir returns the persistent authentication configuration root.

func AuthRolesDir ¶

func AuthRolesDir() (string, error)

func AuthSessionsDir ¶

func AuthSessionsDir() (string, error)

func AuthSystemFile ¶

func AuthSystemFile() (string, error)

func AuthUsersDir ¶

func AuthUsersDir() (string, error)

func CodexAccountsFile ¶

func CodexAccountsFile() (string, error)

CodexAccountsFile stores private Codex profiles and interrupted file swaps.

func CodexHome ¶

func CodexHome(environment map[string]string) (string, error)

CodexHome resolves the same user-level home used by Codex and its adapter.

func CodexLoginTmpDir ¶

func CodexLoginTmpDir() (string, error)

func FileSharesFile ¶

func FileSharesFile() (string, error)

FileSharesFile returns {LOCAL_MEMORY}/quartet/data/file-shares.json.

func GlobalMessagePresetsFile ¶

func GlobalMessagePresetsFile() (string, error)

func GraphRunDir ¶

func GraphRunDir(wsID, jobID string) string

GraphRunDir returns the runtime artifact directory for a GraphRun bound to a Job: {LOCAL_MEMORY}/quartet/data/workspaces/{wsID}/jobs/{jobID}/graph_run/. The run data lives with the Job, not in the global agent directory.

func GraphRunEdgesFile ¶

func GraphRunEdgesFile(wsID, jobID string) string

GraphRunEdgesFile returns the edge-state snapshot file for a run.

func GraphRunEventsFile ¶

func GraphRunEventsFile(wsID, jobID string) string

GraphRunEventsFile returns the append-only event log file for a run.

func GraphRunFile ¶

func GraphRunFile(wsID, jobID string) string

GraphRunFile returns the persisted GraphRun metadata and baseline snapshot.

func GraphRunInstancesFile ¶

func GraphRunInstancesFile(wsID, jobID string) string

GraphRunInstancesFile returns the instance-state snapshot file for a run.

func GraphRunProgressFile ¶

func GraphRunProgressFile(wsID, jobID string) string

GraphRunProgressFile returns the progress snapshot file for a run.

func GraphRunResumeFile ¶

func GraphRunResumeFile(wsID, jobID string) string

GraphRunResumeFile returns the resume snapshot file for a run.

func GraphRunSessionLineageFile ¶

func GraphRunSessionLineageFile(wsID, jobID string) string

GraphRunSessionLineageFile returns the session-lineage snapshot file for a run.

func GraphRunVariablesFile ¶

func GraphRunVariablesFile(wsID, jobID string) string

GraphRunVariablesFile returns the visible-variable snapshot file for a run.

func GraphWorkflowsDir ¶

func GraphWorkflowsDir() (string, error)

GraphWorkflowsDir returns {LOCAL_MEMORY}/quartet/config/graph-workflows/. Holds one JSON file per GraphWorkflow config (the editable/saved workflow definitions). GraphRun runtime artifacts (snapshots, instance/edge state) live elsewhere and are owned by the execution engine, not here.

func IMJobMappingDir ¶

func IMJobMappingDir() string

IMJobMappingDir returns {LOCAL_MEMORY}/quartet/data/im/mappings/, the persistent IM mapping directory.

func IMJobMappingFilePath ¶

func IMJobMappingFilePath(platform, chatID string) string

IMJobMappingFilePath returns {LOCAL_MEMORY}/quartet/data/im/mappings/{platform}/{chatID}.json.

func IMJobMappingLegacyFilePath ¶

func IMJobMappingLegacyFilePath(platform, chatID string) string

IMJobMappingLegacyFilePath returns the old flat layout used by early versions: {LOCAL_MEMORY}/quartet/data/im/mappings/{platform}_{chatID}.json.

Kept for backward-compatible reads so existing deployments do not lose mappings after upgrading.

func IMMediaCacheDir ¶

func IMMediaCacheDir() (string, error)

IMMediaCacheDir returns {LOCAL_MEMORY}/var/quartet/cache/im-media/, the disposable processing cache for IM media.

func IMMessageDir ¶

func IMMessageDir(chatID string) string

IMMessageDir returns {LOCAL_MEMORY}/quartet/data/im/{chatID}/, the persistent IM message directory for a chat.

func IMMessageFilePath ¶

func IMMessageFilePath(chatID string, t time.Time) string

IMMessageFilePath returns {LOCAL_MEMORY}/quartet/data/im/{chatID}/YYYY-MM-DD.jsonl.

func IconCacheDir ¶

func IconCacheDir() (string, error)

IconCacheDir returns {LOCAL_MEMORY}/var/quartet/cache/icons/.

func JobMetaDir ¶

func JobMetaDir(jobDir string) string

JobMetaDir returns {jobDir}/.meta/.

func JobMetaFilePath ¶

func JobMetaFilePath(jobDir string) string

JobMetaFilePath returns the job.json file path within a job directory

func LocalJobDirInWorkspace ¶

func LocalJobDirInWorkspace(wsID, jobID string) string

LocalJobDirInWorkspace returns {LOCAL_MEMORY}/quartet/data/workspaces/{wsID}/jobs/{jobID}.

func LocalJobsDirInWorkspace ¶

func LocalJobsDirInWorkspace(wsID string) string

LocalJobsDirInWorkspace returns {LOCAL_MEMORY}/quartet/data/workspaces/{wsID}/jobs/.

func LocalMemoryDir ¶

func LocalMemoryDir() (string, error)

LocalMemoryDir returns {LOCAL_MEMORY}/, the stable Memory root configured by the LOCAL_MEMORY env var.

func LocalSessionDirInWorkspaceJob ¶

func LocalSessionDirInWorkspaceJob(wsID, jobID, sessionID string) string

LocalSessionDirInWorkspaceJob returns {LOCAL_MEMORY}/quartet/data/workspaces/{wsID}/jobs/{jobID}/sessions/{sessionID}.

func LocalSessionsDirInWorkspaceJob ¶

func LocalSessionsDirInWorkspaceJob(wsID, jobID string) string

LocalSessionsDirInWorkspaceJob returns {LOCAL_MEMORY}/quartet/data/workspaces/{wsID}/jobs/{jobID}/sessions/.

func LocalWorkspaceDir ¶

func LocalWorkspaceDir(id string) string

LocalWorkspaceDir returns {LOCAL_MEMORY}/quartet/data/workspaces/{id}.

func LocalWorkspacesDir ¶

func LocalWorkspacesDir() string

LocalWorkspacesDir returns {LOCAL_MEMORY}/quartet/data/workspaces/. Panics if the env var is not set — the previous behaviour (falling back to the relative path "workspaces") created data directories in whatever CWD the process happened to have, which routinely caused data to silently land outside LOCAL_MEMORY. Every binary that needs workspace I/O already validates LOCAL_MEMORY at startup, so reaching this path without the env var set is a programming bug. Panic (rather than log.Fatalf) runs deferred cleanup and yields a stack trace so the buggy caller is obvious.

func MessagePresetsDir ¶

func MessagePresetsDir() (string, error)

MessagePresetsDir returns the persistent preset-message configuration root.

func MessagesFilePath ¶

func MessagesFilePath(sessionDir string) string

MessagesFilePath returns the messages.jsonl file path within a session directory

func MetaDir ¶

func MetaDir(sessionDir string) string

MetaDir returns {sessionDir}/.meta/.

func MetaFilePath ¶

func MetaFilePath(sessionDir string) string

MetaFilePath returns the meta.json file path within a session directory

func PersistentIMMediaDir ¶

func PersistentIMMediaDir() (string, error)

PersistentIMMediaDir returns {LOCAL_MEMORY}/quartet/data/uploads/im-media/, the directory for media referenced by durable records.

func PromptsDir ¶

func PromptsDir() (string, error)

PromptsDir returns {LOCAL_MEMORY}/quartet/config/prompts/, the human-maintained prompt directory.

func QuartetCacheDir ¶

func QuartetCacheDir() (string, error)

QuartetCacheDir returns {LOCAL_MEMORY}/var/quartet/cache/.

func QuartetConfigDir ¶

func QuartetConfigDir() (string, error)

QuartetConfigDir returns {LOCAL_MEMORY}/quartet/config/, the root of human-maintained Quartet configuration.

func QuartetDataDir ¶

func QuartetDataDir() (string, error)

QuartetDataDir returns {LOCAL_MEMORY}/quartet/data/, the root of persistent Quartet business data.

func QuartetDir ¶

func QuartetDir() (string, error)

QuartetDir returns {LOCAL_MEMORY}/quartet/, the root of Quartet-owned files.

func QuartetRuntimeDir ¶

func QuartetRuntimeDir() (string, error)

QuartetRuntimeDir returns {LOCAL_MEMORY}/var/quartet/, the root of Quartet runtime state, cache and temp files.

func QuartetStateDir ¶

func QuartetStateDir() (string, error)

QuartetStateDir returns {LOCAL_MEMORY}/var/quartet/state/.

func QuartetTmpDir ¶

func QuartetTmpDir() (string, error)

QuartetTmpDir returns {LOCAL_MEMORY}/var/quartet/tmp/.

func RecentDirsFile ¶

func RecentDirsFile() (string, error)

RecentDirsFile returns the runtime recent-directory state file.

func ScheduleStatesDir ¶

func ScheduleStatesDir() (string, error)

ScheduleStatesDir returns {LOCAL_MEMORY}/var/quartet/state/schedules/, the machine-local Schedule activation and runtime state directory.

func SchedulesDir ¶

func SchedulesDir() (string, error)

SchedulesDir returns {LOCAL_MEMORY}/quartet/config/schedules/, the Schedule definition directory.

func SettingsConfigFile ¶

func SettingsConfigFile() (string, error)

SettingsConfigFile returns the persistent settings.json path.

func ShellTempDir ¶

func ShellTempDir() (string, error)

ShellTempDir returns {LOCAL_MEMORY}/var/quartet/tmp/shell/, the process-owned temp directory for shell helper scripts and control files. Such a script is a process artifact, not user content, so it lives here rather than in the job's workdir — a leaked file then sits in reconstructable state instead of dirtying the user's checkout.

func UploadsDir ¶

func UploadsDir() (string, error)

UploadsDir returns {LOCAL_MEMORY}/quartet/data/uploads/, the persistent upload directory.

func UsageStatsDir ¶

func UsageStatsDir() (string, error)

UsageStatsDir returns {LOCAL_MEMORY}/quartet/usage-stats/. Usage statistics live outside quartet/data as persistent configuration data.

func UsageStatsMonthFile ¶

func UsageStatsMonthFile(t time.Time) (string, error)

UsageStatsMonthFile returns {LOCAL_MEMORY}/quartet/usage-stats/YYYY-MM.json for the given time in the server's local timezone.

func UserInputDir ¶

func UserInputDir() string

UserInputDir returns {LOCAL_MEMORY}/quartet/data/user-input/, the persistent flat user-input directory.

func UserInputFilePath ¶

func UserInputFilePath(t time.Time) string

UserInputFilePath returns {LOCAL_MEMORY}/quartet/data/user-input/YYYY-MM-DD.jsonl for the given time in the server's local timezone.

func WeChatAccountsDir ¶

func WeChatAccountsDir() string

WeChatAccountsDir returns {LOCAL_MEMORY}/quartet/data/wechat/accounts/, the persistent WeChat account directory.

func WeChatOutboxDir ¶

func WeChatOutboxDir() string

WeChatOutboxDir returns the durable proactive-send queue directory. Each task is a standalone JSON file so enqueue/progress updates are atomic and a backend restart can resume from the last acknowledged chunk.

func WeChatOutboxTaskFile ¶

func WeChatOutboxTaskFile(taskID string) string

func WeChatSyncBufFile ¶

func WeChatSyncBufFile(botID string) string

WeChatSyncBufFile returns {LOCAL_MEMORY}/quartet/data/wechat/accounts/{botID}.sync.json. Used by the iLink long-poll monitor to persist get_updates_buf so reconnects after a restart resume from the last seen seq instead of replaying history.

func WeChatUserTokensFile ¶

func WeChatUserTokensFile() string

WeChatUserTokensFile returns {LOCAL_MEMORY}/quartet/data/wechat/accounts/user_tokens.json. It persists the botID → fromUserID → latest ContextToken map so proactive sends (Replier.SendText) keep working across backend restarts and account changes.

func WorkspaceMessagePresetsDir ¶

func WorkspaceMessagePresetsDir() (string, error)

func WorkspaceMessagePresetsFile ¶

func WorkspaceMessagePresetsFile(workspaceID string) (string, error)

func WorkspaceMetaDir ¶

func WorkspaceMetaDir(wsDir string) string

WorkspaceMetaDir returns {wsDir}/.meta/.

func WorkspaceMetaFilePath ¶

func WorkspaceMetaFilePath(wsDir string) string

WorkspaceMetaFilePath returns the workspace.json file path within a workspace directory