@agentage/extension-probe 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Agentage Contributors
+
+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

@@ -1,3 +1,46 @@
-# Temporary Holding Version
+# extension-probe
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The probe extension: one agentage extension with every part kind, the template every later
+extension copies. Today it has the api part: `GET /api/v1/echo?msg=hi` answers
+`{"success":true,"data":{"msg":"hi"}}` in the standard envelope, with an `agcid` header. The part
+code is only `create(ctx)` in [`src/api/index.ts`](src/api/index.ts); the kit
+[`@agentage/extension`](https://github.com/agentage/platform) owns the server, `/health`, the
+discovery document and the envelope. There is no Dockerfile: the kit's build tool builds the image.
+
+## Install
+
+```bash
+npm ci
+npm run build
+```
+
+Until `@agentage/extension` is on npm, install it from a packed kit (see `scripts/kit-lock.mjs`):
+
+```bash
+(cd ../platform && npm ci && npm run build && npm pack -w @agentage/extension --pack-destination ../extension-probe/.kit)
+node scripts/kit-lock.mjs local .kit/agentage-extension-0.1.0.tgz && npm ci
+node scripts/kit-lock.mjs registry   # before committing
+```
+
+## Run the image locally
+
+```bash
+node ../platform/packages/extension/dist/tool/cli.js build     # or: agentage extension build
+docker run --rm --network host ghcr.io/agentage/probe-api:0.1.0
+curl -s 127.0.0.1:3000/health                     # loopback only; commit = the build commit
+curl -s '127.0.0.1:3000/api/v1/echo?msg=hi'
+curl -s 127.0.0.1:3000/.well-known/agentage-extension.json
+```
+
+## Verify
+
+```bash
+npm run verify
+```
+
+## Release
+
+A `v*` tag equal to the `package.json` version runs `.github/workflows/release.yml`: it builds and
+pushes `ghcr.io/agentage/probe-api:{version}`, attaches the build record with the image digests to
+the GitHub release as `agentage-extension.json`, and publishes `@agentage/extension-probe` to npm
+with provenance.

package/dist/agentage-extension.json

@@ -0,0 +1,11 @@
+{
+  "id": "probe",
+  "version": "0.1.0",
+  "commit": "471a6d3373c868b4b19fed3cb1d48cdf4c0282d7",
+  "buildTime": "2026-11-03T22:56:15Z",
+  "parts": {
+    "api": {
+      "image": "ghcr.io/agentage/probe-api@sha256:1a89dafc7eec2cb388b0b77c1c8ebc52bf65d49e7f9b6cf8a47a2ca979666850"
+    }
+  }
+}

package/dist/api/echo.schema.d.ts

@@ -0,0 +1,5 @@
+import { z } from 'zod';
+export declare const EchoQuerySchema: z.ZodObject<{
+    msg: z.ZodString;
+}, z.core.$strip>;
+export type EchoQuery = z.infer<typeof EchoQuerySchema>;

package/dist/api/echo.schema.js

@@ -0,0 +1,4 @@
+import { z } from 'zod';
+export const EchoQuerySchema = z.object({
+    msg: z.string().min(1).max(200),
+});

package/dist/api/index.d.ts

@@ -0,0 +1,3 @@
+import { Router } from 'express';
+import { type PartContext } from '@agentage/extension';
+export declare const create: (_ctx: PartContext) => Router;

package/dist/api/index.js

@@ -0,0 +1,12 @@
+import { Router } from 'express';
+import { ok, parse } from '@agentage/extension';
+import { EchoQuerySchema } from './echo.schema.js';
+// The api part: mounted by the kit at /api/v1/; the caller field arrives with the token check.
+export const create = (_ctx) => {
+    const router = Router();
+    router.get('/echo', (req, res) => {
+        const { msg } = parse(EchoQuerySchema, req.query, 'Invalid query');
+        res.json(ok({ msg }));
+    });
+    return router;
+};

package/package.json

@@ -1,6 +1,73 @@
 {
   "name": "@agentage/extension-probe",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "The probe extension: one of every agentage part kind, the template every later extension copies",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/agentage/extension-probe.git"
+  },
+  "homepage": "https://agentage.io",
+  "bugs": {
+    "url": "https://github.com/agentage/extension-probe/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22",
+    "agentage": "^0.1"
+  },
+  "agentage": {
+    "id": "probe",
+    "parts": {
+      "api": true
+    }
+  },
+  "exports": {
+    "./api": {
+      "types": "./dist/api/index.d.ts",
+      "default": "./dist/api/index.js"
+    },
+    "./agentage-extension.json": "./dist/agentage-extension.json",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.test.*"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "type-check": "tsc --noEmit",
+    "lint": "eslint .",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "verify": "npm run type-check && npm run lint && npm run format:check && npm run test:coverage && npm run build",
+    "prepublishOnly": "npm run verify"
+  },
+  "dependencies": {
+    "@agentage/extension": "^0.1.0",
+    "express": "^5.1.0",
+    "zod": "^4.2.0"
+  },
+  "devDependencies": {
+    "@types/express": "5.0.6",
+    "@types/node": "26.6.5",
+    "@typescript-eslint/eslint-plugin": "8.72.1",
+    "@typescript-eslint/parser": "8.72.1",
+    "@vitest/coverage-v8": "5.0.5",
+    "eslint": "10.13.0",
+    "eslint-config-prettier": "10.1.8",
+    "eslint-plugin-prettier": "5.5.7",
+    "prettier": "3.9.10",
+    "typescript": "6.0.3",
+    "vitest": "5.0.5"
+  },
+  "keywords": [
+    "agentage",
+    "agentage-extension"
+  ]
+}