@dev-sergeev/datalab-kit 0.1.2 → 0.1.3

package/node_modules/@zigai/pi-extension-settings/package.json

@@ -0,0 +1,97 @@
+{
+  "name": "@zigai/pi-extension-settings",
+  "version": "0.5.3",
+  "description": "TypeBox-first configuration runtime and artifact tooling for Pi extensions.",
+  "keywords": [
+    "configuration",
+    "json-schema",
+    "pi-coding-agent",
+    "pi-extension",
+    "typebox",
+    "typescript"
+  ],
+  "homepage": "https://github.com/zigai/pi-extension-settings#readme",
+  "bugs": {
+    "url": "https://github.com/zigai/pi-extension-settings/issues"
+  },
+  "license": "MIT",
+  "author": "zigai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zigai/pi-extension-settings.git"
+  },
+  "bin": {
+    "pi-extension-settings": "dist/cli-entry.js"
+  },
+  "files": [
+    "dist",
+    "docs",
+    "README.md",
+    "LICENSE"
+  ],
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./pi": {
+      "types": "./dist/pi.d.ts",
+      "import": "./dist/pi.ts"
+    },
+    "./runtime": {
+      "types": "./dist/runtime.d.ts",
+      "import": "./dist/runtime.ts"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
+    "build": "npm run clean && tsc -p tsconfig.build.json && node scripts/build-pi-runtime.ts",
+    "lint": "oxlint -c ./oxlint.config.ts .",
+    "lint:fix": "oxlint -c ./oxlint.config.ts . --fix",
+    "format": "oxfmt .",
+    "format:check": "oxfmt --check .",
+    "test": "vitest run",
+    "test:package": "node scripts/package-check.ts",
+    "coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "check": "npm run format:check && npm run lint && npm run typecheck && npm run build && npm run coverage && npm run test:package",
+    "verify": "npm run check",
+    "prepack": "npm run check"
+  },
+  "dependencies": {
+    "proper-lockfile": "4.1.2"
+  },
+  "devDependencies": {
+    "@earendil-works/pi-coding-agent": "^0.84.2",
+    "@types/node": "^22.19.0",
+    "@types/proper-lockfile": "4.1.4",
+    "@vitest/coverage-v8": "^4.1.9",
+    "esbuild": "^0.28.1",
+    "oxfmt": "^0.44.0",
+    "oxlint": "^1.74.0",
+    "oxlint-rules": "latest",
+    "oxlint-tsgolint": "^7.0.2001",
+    "typebox": "^1.3.11",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.9"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*",
+    "typebox": "*"
+  },
+  "peerDependenciesMeta": {
+    "@earendil-works/pi-coding-agent": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=22.19.0 <27"
+  },
+  "packageManager": "npm@11.19.0"
+}

package/node_modules/@zigai/pi-mention-anything/README.md

@@ -0,0 +1,113 @@
+# Pi Mention Anything
+
+Custom mention pickers for Pi, from simple lists to chained selections. Available through settings and a TypeScript API.
+
+## Install
+
+```sh
+pi install npm:@zigai/pi-mention-anything
+```
+
+Selections become mentions in the editor and expand into context for the model. Chained selections open successive pickers.
+
+<!-- pi-extension-settings:start -->
+## Configuration
+
+Global settings are stored in `~/.pi/agent/extension-settings/pi-mention-anything.json`.
+
+| Option | Type | Default | Description |
+| --- | --- | --- | --- |
+| `mentions` | MentionDefinition[] | `[]` | Mention sources enabled in Pi. |
+
+### Defaults
+
+```json
+{
+  "$schema": "./schemas/pi-mention-anything.schema.json",
+  "mentions": []
+}
+```
+
+### Advanced example
+
+```json
+{
+  "$schema": "./schemas/pi-mention-anything.schema.json",
+  "mentions": [
+    {
+      "id": "environments",
+      "trigger": "%",
+      "completionSuffix": " ",
+      "source": {
+        "type": "static",
+        "items": [
+          {
+            "name": "staging",
+            "description": "Staging environment"
+          },
+          {
+            "name": "production",
+            "description": "Production environment"
+          }
+        ]
+      },
+      "initialSuggestions": {
+        "strategy": "frecency",
+        "pinned": []
+      }
+    },
+    {
+      "id": "tickets",
+      "trigger": "ticket:",
+      "completionSuffix": " ",
+      "source": {
+        "type": "command",
+        "mode": "array",
+        "command": "list-my-tickets",
+        "args": [
+          "--json"
+        ],
+        "cache": true,
+        "refreshOnStartup": true,
+        "cacheTtlMs": 300000
+      },
+      "initialSuggestions": {
+        "strategy": "frecency",
+        "pinned": []
+      }
+    }
+  ]
+}
+```
+<!-- pi-extension-settings:end -->
+
+## TypeScript API
+
+`registerMention` connects a provider to Pi’s pickers and context expansion:
+
+```ts
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { createListProvider, registerMention } from "@zigai/pi-mention-anything/api";
+
+export default function (pi: ExtensionAPI): void {
+  registerMention(pi, {
+    id: "environments",
+    configuration: () => ({ trigger: "%" }),
+    provider: () => createListProvider(async () => [
+      { id: "staging", label: "Staging", segment: "staging", selectable: true, navigable: false, replacement: "environment:staging" },
+      { id: "production", label: "Production", segment: "production", selectable: true, navigable: false, replacement: "environment:production" },
+    ]),
+  });
+}
+```
+
+## Documentation
+
+- [Provider contracts, chained navigation, and cache options](docs/providers.md)
+- [Versioned command protocol](docs/command-protocol.md)
+- [Example: Recursive tree](examples/recursive-tree.ts)
+- [Example: tmux sessions, windows, and panes](examples/tmux.ts)
+
+## License
+
+[MIT](../../LICENSE)

package/node_modules/@zigai/pi-mention-anything/config.schema.json

@@ -0,0 +1,313 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://raw.githubusercontent.com/zigai/pi-tweaks/master/packages/pi-mention-anything/config.schema.json",
+  "title": "Pi Mention Anything settings",
+  "description": "Define custom mention sources and triggers.",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "default": "./schemas/pi-mention-anything.schema.json",
+      "description": "JSON Schema used by editors for this settings file."
+    },
+    "mentions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "id",
+          "trigger",
+          "source"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "minLength": 1,
+            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+            "description": "Stable identifier used for diagnostics and selection history."
+          },
+          "trigger": {
+            "type": "string",
+            "minLength": 1,
+            "pattern": "^[^/\\s]+$",
+            "description": "One or more non-whitespace, non-slash characters that start the mention."
+          },
+          "separator": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 1,
+            "pattern": "^[^\\s\"\\\\]$",
+            "description": "Separator between chained mention segments."
+          },
+          "expansionPolicy": {
+            "anyOf": [
+              {
+                "type": "string",
+                "const": "selected-only"
+              },
+              {
+                "type": "string",
+                "const": "selected-or-resolved"
+              }
+            ],
+            "default": "selected-or-resolved",
+            "description": "Expand only picker selections, or also resolve manually typed mentions."
+          },
+          "replacementTemplate": {
+            "type": "string",
+            "description": "Replacement template. Allowed fields: {{id}}, {{label}}, {{segment}}, {{path}}, {{ids}}. Provider data is never implicitly included."
+          },
+          "completionSuffix": {
+            "type": "string",
+            "default": " ",
+            "description": "Text inserted after a completed mention."
+          },
+          "source": {
+            "anyOf": [
+              {
+                "type": "object",
+                "required": [
+                  "type",
+                  "items"
+                ],
+                "properties": {
+                  "type": {
+                    "type": "string",
+                    "const": "static"
+                  },
+                  "items": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "required": [
+                        "name"
+                      ],
+                      "properties": {
+                        "name": {
+                          "type": "string",
+                          "minLength": 1,
+                          "description": "Name selected and written after the trigger."
+                        },
+                        "id": {
+                          "type": "string",
+                          "minLength": 1,
+                          "description": "Stable identity within the parent path. Defaults to name for simple lists."
+                        },
+                        "segment": {
+                          "type": "string",
+                          "minLength": 1,
+                          "description": "Text inserted as this path segment. Defaults to name."
+                        },
+                        "searchText": {
+                          "type": "string",
+                          "description": "Text used for searching instead of the name and description."
+                        },
+                        "insertionText": {
+                          "type": "string",
+                          "minLength": 1,
+                          "description": "Complete editor text for a selected terminal target."
+                        },
+                        "parentPath": {
+                          "type": "array",
+                          "items": {
+                            "type": "string",
+                            "minLength": 1
+                          },
+                          "description": "Ancestor IDs, from root to parent. Omit for root items."
+                        },
+                        "selectable": {
+                          "type": "boolean",
+                          "description": "Allow selecting this item as a completed target. Defaults to false for navigable items and true otherwise."
+                        },
+                        "navigable": {
+                          "type": "boolean",
+                          "description": "Open a child picker when this item is selected. Defaults to false."
+                        },
+                        "description": {
+                          "type": "string",
+                          "description": "Secondary text shown in autocomplete."
+                        },
+                        "replacement": {
+                          "type": "string",
+                          "description": "Text sent to the model in place of the mention. Defaults to the name."
+                        }
+                      },
+                      "additionalProperties": false,
+                      "title": "MentionItem"
+                    },
+                    "maxItems": 10000,
+                    "description": "Candidates offered by this mention source."
+                  }
+                },
+                "additionalProperties": false,
+                "title": "StaticMentionSource"
+              },
+              {
+                "type": "object",
+                "required": [
+                  "type",
+                  "command",
+                  "args"
+                ],
+                "properties": {
+                  "type": {
+                    "type": "string",
+                    "const": "command"
+                  },
+                  "mode": {
+                    "anyOf": [
+                      {
+                        "type": "string",
+                        "const": "array"
+                      },
+                      {
+                        "type": "string",
+                        "const": "protocol"
+                      }
+                    ],
+                    "default": "array",
+                    "description": "array prints a flat item array; protocol uses version 1 JSON requests on stdin for discovery and exact resolution."
+                  },
+                  "filtering": {
+                    "anyOf": [
+                      {
+                        "type": "string",
+                        "const": "local"
+                      },
+                      {
+                        "type": "string",
+                        "const": "provider"
+                      }
+                    ],
+                    "default": "provider",
+                    "description": "Protocol result ranking owner. Array commands always use local filtering."
+                  },
+                  "maxOutputBytes": {
+                    "type": "integer",
+                    "minimum": 1024,
+                    "maximum": 16777216,
+                    "default": 1048576,
+                    "description": "Maximum combined standard output and standard error size in bytes."
+                  },
+                  "refreshIntervalMs": {
+                    "type": "integer",
+                    "minimum": 1000,
+                    "description": "Periodic refresh interval for active cache entries. Requires caching."
+                  },
+                  "watchFiles": {
+                    "type": "array",
+                    "items": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "maxItems": 32,
+                    "description": "Files whose changes invalidate cached results. Requires caching."
+                  },
+                  "persistentCache": {
+                    "type": "boolean",
+                    "description": "Local disk caching, scoped by configuration, working directory, and trust."
+                  },
+                  "command": {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "Executable that returns candidates in the selected command mode."
+                  },
+                  "args": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    },
+                    "default": [],
+                    "description": "Arguments passed directly to the executable without shell interpretation."
+                  },
+                  "debounceMs": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "default": 100,
+                    "description": "Delay before starting the command so superseded autocomplete requests can cancel."
+                  },
+                  "timeoutMs": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "default": 5000,
+                    "description": "Maximum command runtime in milliseconds."
+                  },
+                  "refreshOnStartup": {
+                    "type": "boolean",
+                    "description": "Background root discovery at session startup. Requires caching."
+                  },
+                  "cacheTtlMs": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "description": "Cache lifetime in milliseconds. Expired results remain available during refresh. Without a lifetime, results last for the session."
+                  },
+                  "cache": {
+                    "type": "boolean",
+                    "default": false,
+                    "description": "Caching of successful command results."
+                  }
+                },
+                "additionalProperties": false,
+                "title": "CommandMentionSource"
+              }
+            ],
+            "description": "Where this mention gets its candidates."
+          },
+          "initialSuggestions": {
+            "type": "object",
+            "required": [
+              "strategy",
+              "pinned"
+            ],
+            "properties": {
+              "strategy": {
+                "anyOf": [
+                  {
+                    "type": "string",
+                    "const": "frecency"
+                  },
+                  {
+                    "type": "string",
+                    "const": "recent"
+                  },
+                  {
+                    "type": "string",
+                    "const": "frequent"
+                  },
+                  {
+                    "type": "string",
+                    "const": "alphabetical"
+                  },
+                  {
+                    "type": "string",
+                    "const": "sourceOrder"
+                  }
+                ],
+                "default": "frecency",
+                "description": "Ordering used before any query text is entered."
+              },
+              "pinned": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "default": [],
+                "uniqueItems": true,
+                "description": "Candidate names placed first, in this order, before the configured strategy."
+              }
+            },
+            "default": {},
+            "additionalProperties": false,
+            "description": "Controls the entries shown immediately after the trigger."
+          }
+        },
+        "additionalProperties": false,
+        "title": "MentionDefinition"
+      },
+      "default": [],
+      "description": "Mention sources enabled in Pi."
+    }
+  }
+}

package/node_modules/@zigai/pi-mention-anything/docs/command-protocol.md

@@ -0,0 +1,106 @@
+# Command sources
+
+Command sources return candidates as JSON. Commands run directly with arguments, without a shell.
+
+| Property                                 | Default                       |
+| ---------------------------------------- | ----------------------------- |
+| Timeout (`timeoutMs`)                    | 5 seconds                     |
+| Combined output limit (`maxOutputBytes`) | 1 MiB                         |
+| Standard output                          | One JSON value                |
+| Diagnostics                              | Exclude raw stdout and stderr |
+
+## Array mode
+
+Array mode is the default. The command receives no stdin and returns a list of settings items:
+
+```json
+[{ "name": "server", "description": "SSH target", "replacement": "SSH host alias server" }]
+```
+
+Items may also supply `id`, `segment`, `searchText`, `parentPath` (ancestor IDs), `selectable`, and `navigable`. Simple items default ID and segment to `name`. Array mode uses local filtering and is intended for bounded enumerable collections.
+
+## Protocol mode
+
+`mode: "protocol"` supports search, pagination, and chains. Each invocation receives one newline-terminated JSON request on stdin, followed by EOF, and returns one JSON response.
+
+Example configuration:
+
+```json
+{
+  "mentions": [
+    {
+      "id": "tickets",
+      "trigger": "ticket:",
+      "source": {
+        "type": "command",
+        "mode": "protocol",
+        "command": "node",
+        "args": ["/absolute/path/query-command.mjs"],
+        "filtering": "provider",
+        "cache": true,
+        "cacheTtlMs": 30000
+      }
+    }
+  ]
+}
+```
+
+Discovery request:
+
+```json
+{
+  "version": 1,
+  "method": "discover",
+  "sourceId": "tickets",
+  "cwd": "/work/project",
+  "trusted": true,
+  "query": "12",
+  "path": [],
+  "limit": 100
+}
+```
+
+Discovery response:
+
+```json
+{
+  "version": 1,
+  "method": "discover",
+  "result": {
+    "items": [
+      {
+        "id": "123",
+        "label": "Ticket 123",
+        "segment": "123",
+        "selectable": true,
+        "navigable": false,
+        "replacement": "issue tracker ticket #123"
+      }
+    ],
+    "nextCursor": "next-page-token"
+  }
+}
+```
+
+Subsequent page requests include `cursor`; the final response omits `nextCursor`. `filtering: "provider"` preserves source ranking.
+
+Chains have a `separator` in the mention definition. Their discovery `path` contains selected ancestors, including stable IDs and optional JSON data.
+
+Exact resolution request:
+
+```json
+{
+  "version": 1,
+  "method": "resolve",
+  "sourceId": "tickets",
+  "cwd": "/work/project",
+  "trusted": true,
+  "segments": ["123"]
+}
+```
+
+Resolution responses use the same version and method envelope. A resolved `result` contains `status: "resolved"`, the candidate `path` from root to target, and an optional whole-target `replacement`. An unresolved result contains `status: "unresolved"` and a reason, such as `"missing"`.
+
+Exact resolution works independently of previously loaded pages.
+
+Reference: [query command example](../examples/query-command.mjs), `CommandRequestV1`, and `CommandResponseV1`.