@joshski/dust 0.1.111 → 0.1.113

package/README.md

@@ -40,6 +40,23 @@ npx dust loop claude
 
 This runs Claude Code in a [ralph loop](https://ghuntley.com/loop/), picking up tasks until they are all done.
 
+## Codex Hook (Optional)
+
+For [Codex](https://github.com/openai/codex) 0.125.0 or newer, you can replace the `AGENTS.md` instruction with a `SessionStart` hook that loads dust's instructions directly into the model's context — once per session, with no extra agent commands. Add this to `~/.codex/config.toml` (or your project's Codex config):
+
+```toml
+[features]
+codex_hooks = true
+
+[[hooks.SessionStart]]
+matcher = "^startup$"
+
+[[hooks.SessionStart.hooks]]
+type = "command"
+command = "bunx dust codex hook"
+statusMessage = "Loading dust agent instructions"
+```
+
 ## Learn More
 
 Details live in the [.dust/facts](./.dust/facts) directory:

package/dist/cli/shared/agent-shared.d.ts

@@ -16,7 +16,7 @@ export interface TemplateVars {
     isClaudeCodeWeb: boolean;
     hasIdeaFile: boolean;
 }
-export interface TemplateVarsWithInstructions extends TemplateVars {
+interface TemplateVarsWithInstructions extends TemplateVars {
     agentInstructions: string;
 }
 /**
@@ -33,6 +33,13 @@ export declare function templateVariables(settings: DustSettings, hooksInstalled
 export declare function templateVariablesWithInstructions(cwd: string, fileSystem: FileReader, settings: DustSettings, hooksInstalled: boolean, env: NodeJS.ProcessEnv, options?: {
     hasIdeaFile?: boolean;
 }): Promise<TemplateVarsWithInstructions>;
+/**
+ * Renders the dust agent greeting text.
+ *
+ * Used by both `dust agent` (printed to the user) and `dust codex hook`
+ * (injected as `additionalContext` into the model's session context).
+ */
+export declare function agentGreeting(vars: TemplateVarsWithInstructions): string;
 /**
  * Manages git hook installation for agent commands.
  * Automatically installs pre-push hooks if:
@@ -42,3 +49,4 @@ export declare function templateVariablesWithInstructions(cwd: string, fileSyste
  * Returns whether hooks are installed.
  */
 export declare function manageGitHooks(dependencies: CommandDependencies): Promise<boolean>;
+export {};

package/dist/cli/types.d.ts

@@ -29,7 +29,11 @@ export interface DustSettings {
     excludeCorePrinciples?: string[];
     extraDirectories?: string[];
 }
-export type DirectoryFileSorter = (dir: string, files: string[]) => Promise<string[]>;
+export interface FileWithTimestamp {
+    file: string;
+    lastCommittedAt: string | null;
+}
+export type DirectoryFileSorter = (dir: string, files: string[]) => Promise<FileWithTimestamp[]>;
 /**
  * Dependencies passed to all CLI commands
  */