@zigai/pi-autoname-session 1.1.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 zigai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,73 @@
+# Pi Autoname Session
+
+Automatically name Pi sessions from the user's request and repository context.
+
+The extension can name a session after a configurable activity threshold and optionally refresh that name as work continues.
+
+## Install
+
+```sh
+pi install npm:@zigai/pi-autoname-session
+```
+
+<!-- pi-extension-settings:start -->
+## Configuration
+
+Global settings are stored in `~/.pi/agent/extension-settings/pi-autoname-session.json`.
+
+| Option | Type | Default | Description |
+| --- | --- | --- | --- |
+| `enabled` | boolean | `true` | Enable the extension. |
+| `initialNaming.enabled` | boolean | `true` | Automatically name an otherwise unnamed session once. |
+| `initialNaming.timing` | `prompt` \| `settled` | `"prompt"` | When to first check the naming trigger: before the agent starts on a prompt, or after the agent has settled. |
+| `initialNaming.trigger` | `messages` \| `turns` \| `tool_calls` \| `tokens` \| `minutes` | `"messages"` | The session activity that starts a naming attempt. |
+| `initialNaming.threshold` | integer | `1` | The initial activity threshold. |
+| `refreshNaming.enabled` | boolean | `false` | Periodically refresh the name as the session develops. |
+| `refreshNaming.trigger` | `messages` \| `turns` \| `tool_calls` \| `tokens` \| `minutes` | `"turns"` | The activity that starts a naming refresh. |
+| `refreshNaming.threshold` | integer | `10` | The amount of activity between refreshes. |
+| `model` | string | `"current"` | Picker model: provider/model-id, or current for the active model. |
+| `reasoningEffort` | `off` \| `minimal` \| `low` \| `medium` \| `high` \| `xhigh` \| `max` | `"low"` | Reasoning effort used by the session-name picker. |
+| `timeoutMs` | integer | `30000` | Maximum time in milliseconds for picker authentication and the model response before the naming attempt is treated as failed. |
+| `conversationScope` | `minimized` \| `full` | `"minimized"` | How much refresh context to send. Minimized sends only user and assistant text; full also includes tool arguments, results, and shell output. Initial naming always uses only the first user request. |
+| `prompt` | string | *See JSON below* | Prompt used by the picker. Available placeholders are {{repository_context}}, {{conversation}}, {{current_name}}, {{cwd}}, and {{reason}}. |
+| `nameConstraints.minLength` | integer | `6` | Minimum number of characters in a name returned by the picker. |
+| `nameConstraints.maxLength` | integer | `40` | Maximum number of characters in a name returned by the picker. |
+
+```json
+{
+  "$schema": "./schemas/pi-autoname-session.schema.json",
+  "enabled": true,
+  "initialNaming": {
+    "enabled": true,
+    "timing": "prompt",
+    "trigger": "messages",
+    "threshold": 1
+  },
+  "refreshNaming": {
+    "enabled": false,
+    "trigger": "turns",
+    "threshold": 10
+  },
+  "model": "current",
+  "reasoningEffort": "low",
+  "timeoutMs": 30000,
+  "conversationScope": "minimized",
+  "prompt": "Generate a title that will help the user recognize this coding session weeks later.\n\nBefore answering, silently identify:\n- Subject: the system, feature, or problem the request is really about.\n- Outcome: what the user ultimately wants to understand or change.\n- Incidental instructions: details about tools, process, output, or how the agent should work.\n\nTitle the durable subject and desired outcome. Discard incidental instructions.\nPrioritize user requests over assistant discoveries. Preserve the original subject until the user clearly changes goals.\n\nEditorial rules:\n- Use 3 to 8 words and a compact noun phrase or clear action phrase.\n- Capture the umbrella goal when the request lists several symptoms or steps.\n- Name the product change, not a plan, report, branch, commit, PR, test run, or monitoring step used to produce it.\n- Exclude models, subagents, tools, and output formats unless they are themselves the topic.\n- For reviews, name what is being reviewed and the relevant concern.\n- For research, name the question domain rather than the research process.\n- Do not claim the work is complete or merely copy and truncate the request.\n- Avoid repository names already visible in the workspace metadata, quotes, labels, filler, and trailing punctuation.\n\nWorkspace metadata:\n<workspace>\n{{repository_context}}\n</workspace>\n\nConversation:\n<conversation>\n{{conversation}}\n</conversation>\n\nCurrent title: {{current_name}}\nNaming phase: {{reason}}",
+  "nameConstraints": {
+    "minLength": 6,
+    "maxLength": 40
+  }
+}
+```
+<!-- pi-extension-settings:end -->
+
+## Development
+
+```sh
+just setup
+just coverage
+```
+
+## License
+
+[MIT](LICENSE)

package/config.schema.json

@@ -0,0 +1,163 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://raw.githubusercontent.com/zigai/pi-autoname-session/HEAD/config.schema.json",
+  "title": "Pi Autoname Session settings",
+  "description": "Settings for Pi Autoname Session.",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "default": "./schemas/pi-autoname-session.schema.json",
+      "description": "JSON Schema used by editors for this settings file."
+    },
+    "enabled": {
+      "type": "boolean",
+      "default": true,
+      "description": "Enable the extension."
+    },
+    "initialNaming": {
+      "type": "object",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": true,
+          "description": "Automatically name an otherwise unnamed session once."
+        },
+        "timing": {
+          "type": "string",
+          "enum": [
+            "prompt",
+            "settled"
+          ],
+          "description": "When to first check the naming trigger: before the agent starts on a prompt, or after the agent has settled.",
+          "default": "prompt"
+        },
+        "trigger": {
+          "type": "string",
+          "enum": [
+            "messages",
+            "turns",
+            "tool_calls",
+            "tokens",
+            "minutes"
+          ],
+          "description": "The session activity that starts a naming attempt.",
+          "default": "messages"
+        },
+        "threshold": {
+          "type": "integer",
+          "default": 1,
+          "minimum": 1,
+          "description": "The initial activity threshold."
+        }
+      },
+      "additionalProperties": false,
+      "default": {
+        "enabled": true,
+        "timing": "prompt",
+        "trigger": "messages",
+        "threshold": 1
+      }
+    },
+    "refreshNaming": {
+      "type": "object",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": false,
+          "description": "Periodically refresh the name as the session develops."
+        },
+        "trigger": {
+          "type": "string",
+          "enum": [
+            "messages",
+            "turns",
+            "tool_calls",
+            "tokens",
+            "minutes"
+          ],
+          "description": "The activity that starts a naming refresh.",
+          "default": "turns"
+        },
+        "threshold": {
+          "type": "integer",
+          "default": 10,
+          "minimum": 1,
+          "description": "The amount of activity between refreshes."
+        }
+      },
+      "additionalProperties": false,
+      "default": {
+        "enabled": false,
+        "trigger": "turns",
+        "threshold": 10
+      }
+    },
+    "model": {
+      "type": "string",
+      "default": "current",
+      "minLength": 1,
+      "pattern": "^(?:current|[^/\\s]+/\\S+)$",
+      "description": "Picker model: provider/model-id, or current for the active model."
+    },
+    "reasoningEffort": {
+      "type": "string",
+      "enum": [
+        "off",
+        "minimal",
+        "low",
+        "medium",
+        "high",
+        "xhigh",
+        "max"
+      ],
+      "description": "Reasoning effort used by the session-name picker.",
+      "default": "low"
+    },
+    "timeoutMs": {
+      "type": "integer",
+      "default": 30000,
+      "minimum": 1000,
+      "description": "Maximum time in milliseconds for picker authentication and the model response before the naming attempt is treated as failed."
+    },
+    "conversationScope": {
+      "type": "string",
+      "enum": [
+        "minimized",
+        "full"
+      ],
+      "description": "How much refresh context to send. Minimized sends only user and assistant text; full also includes tool arguments, results, and shell output. Initial naming always uses only the first user request.",
+      "default": "minimized"
+    },
+    "prompt": {
+      "type": "string",
+      "default": "Generate a title that will help the user recognize this coding session weeks later.\n\nBefore answering, silently identify:\n- Subject: the system, feature, or problem the request is really about.\n- Outcome: what the user ultimately wants to understand or change.\n- Incidental instructions: details about tools, process, output, or how the agent should work.\n\nTitle the durable subject and desired outcome. Discard incidental instructions.\nPrioritize user requests over assistant discoveries. Preserve the original subject until the user clearly changes goals.\n\nEditorial rules:\n- Use 3 to 8 words and a compact noun phrase or clear action phrase.\n- Capture the umbrella goal when the request lists several symptoms or steps.\n- Name the product change, not a plan, report, branch, commit, PR, test run, or monitoring step used to produce it.\n- Exclude models, subagents, tools, and output formats unless they are themselves the topic.\n- For reviews, name what is being reviewed and the relevant concern.\n- For research, name the question domain rather than the research process.\n- Do not claim the work is complete or merely copy and truncate the request.\n- Avoid repository names already visible in the workspace metadata, quotes, labels, filler, and trailing punctuation.\n\nWorkspace metadata:\n<workspace>\n{{repository_context}}\n</workspace>\n\nConversation:\n<conversation>\n{{conversation}}\n</conversation>\n\nCurrent title: {{current_name}}\nNaming phase: {{reason}}",
+      "minLength": 1,
+      "x-control": "textarea",
+      "description": "Prompt used by the picker. Available placeholders are {{repository_context}}, {{conversation}}, {{current_name}}, {{cwd}}, and {{reason}}."
+    },
+    "nameConstraints": {
+      "type": "object",
+      "properties": {
+        "minLength": {
+          "type": "integer",
+          "default": 6,
+          "minimum": 1,
+          "description": "Minimum number of characters in a name returned by the picker."
+        },
+        "maxLength": {
+          "type": "integer",
+          "default": 40,
+          "minimum": 1,
+          "description": "Maximum number of characters in a name returned by the picker."
+        }
+      },
+      "additionalProperties": false,
+      "default": {
+        "minLength": 6,
+        "maxLength": 40
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,95 @@
+{
+  "name": "@zigai/pi-autoname-session",
+  "version": "1.1.4",
+  "description": "Automatically name and keep Pi sessions organized",
+  "keywords": [
+    "autoname-session",
+    "pi",
+    "pi-coding-agent",
+    "pi-extension",
+    "pi-package"
+  ],
+  "homepage": "https://github.com/zigai/pi-autoname-session#readme",
+  "bugs": {
+    "url": "https://github.com/zigai/pi-autoname-session/issues"
+  },
+  "license": "MIT",
+  "author": "zigai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zigai/pi-autoname-session.git"
+  },
+  "files": [
+    "src",
+    "README.md",
+    "config.schema.json",
+    "LICENSE"
+  ],
+  "type": "module",
+  "main": "src/index.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "lint": "oxlint -c ./oxlint.config.ts .",
+    "lint:fix": "oxlint -c ./oxlint.config.ts . --fix",
+    "format": "oxfmt .",
+    "format:check": "oxfmt --check .",
+    "test": "vitest run",
+    "coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "check": "npm run config:check && npm run format:check && npm run lint && npm run typecheck && npm test",
+    "verify": "npm run check",
+    "config:generate": "pi-extension-settings generate",
+    "config:check": "pi-extension-settings check",
+    "release": "release --root .",
+    "release:dry-run": "release --dry --root ."
+  },
+  "dependencies": {
+    "@zigai/pi-extension-settings": "0.5.3"
+  },
+  "devDependencies": {
+    "@earendil-works/pi-ai": "^0.83.0",
+    "@earendil-works/pi-coding-agent": "^0.83.0",
+    "@types/node": "^24.13.3",
+    "@vitest/coverage-v8": "^4.1.10",
+    "oxfmt": "^0.59.0",
+    "oxlint": "^1.74.0",
+    "oxlint-rules": "0.4.3",
+    "oxlint-tsgolint": "^7.0.2001",
+    "typebox": "^1.3.8",
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.10"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-ai": "*",
+    "@earendil-works/pi-coding-agent": "*",
+    "typebox": "*"
+  },
+  "peerDependenciesMeta": {
+    "@earendil-works/pi-coding-agent": {
+      "optional": true
+    },
+    "@earendil-works/pi-ai": {
+      "optional": true
+    },
+    "typebox": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=22.19.0 <27"
+  },
+  "packageManager": "npm@11.18.0",
+  "pi": {
+    "extensions": [
+      "./src/index.ts"
+    ]
+  },
+  "piExtensionSettings": {
+    "definition": "./src/settings-input.ts",
+    "prevalidation": "./src/settings.prevalidated.ts",
+    "schema": "./config.schema.json",
+    "readme": "./README.md"
+  }
+}