@ampless/plugin-ai-actions 0.1.0-beta.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ampless 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.ja.md

@@ -0,0 +1,101 @@
+> English: [README.md](./README.md)
+>
+
+# @ampless/plugin-ai-actions
+
+[ampless](https://github.com/heavymoons/ampless) の投稿ページ向け、人間から AI への導線プラグイン。本文の前後に最大 3 つのリンクを持つ小さな `<p class="ampless-ai-actions">` 要素を挿入します。
+
+> **プレリリース / ベータ版。** v1.0 まではマイナーバージョンでも破壊的変更が入る可能性があります。
+
+リンクは `publicHtmlForPost` capability（Phase 6d）経由で出力されます。`ampless.publicHtmlForPost(post)` を呼ぶテーマなら自動的に描画されます。HTML はランタイムが `sanitize-html` で strict allowlist に沿ってサニタイズするため、テーマ側で `dangerouslySetInnerHTML` を使う必要はありません。
+
+AWS のデータ権限は不要です。すべて公開 Next.js プロセスのリクエスト時に動作します。`trust_level` は `untrusted`。
+
+## `ai.markdownRoutes` が前提
+
+**このプラグインが出力する全アクションは投稿の `/<slug>.md` Markdown 投影に依存します** — 2 つの外部 AI リンクも、prompt の `?q=` に絶対 `.md` URL を渡します。`cms.config.ts` で `ai.markdownRoutes: false` を設定しているサイトでは、「View as Markdown」リンクは 404 になり、Claude/ChatGPT リンク自体は開くものの、AI に渡る `.md` URL が存在しないため機能しません。**`ai.markdownRoutes` を無効化したサイトではこのプラグインを登録しないでください** — `ai.markdownRoutes` はデフォルトで有効なのでほとんどのサイトでは意識不要ですが、インストール前に確認してください。
+
+## インストール
+
+```bash
+npm install @ampless/plugin-ai-actions@beta
+```
+
+## 設定
+
+`cms.config.ts` に記述します:
+
+```ts
+import { defineConfig } from 'ampless'
+import aiActionsPlugin from '@ampless/plugin-ai-actions'
+
+export default defineConfig({
+  // ...
+  plugins: [
+    aiActionsPlugin(),
+  ],
+})
+```
+
+| オプション | デフォルト | 備考 |
+|---|---|---|
+| `showMarkdownLink` | `true` | `/<slug>.md` への「Markdown で表示」リンク。 |
+| `showClaude` | `false` | 「Claude で開く」リンク。**opt-in** — 下記[外部 AI リンクについて](#外部-ai-リンクopt-in)を参照。 |
+| `showChatgpt` | `false` | 「ChatGPT で開く」リンク。**opt-in** — 同上の注意点。 |
+| `promptTemplate` | `'Read {url}'` | Claude/ChatGPT の `?q=` prefill に使うプロンプト。`{url}` は絶対 `.md` URL に置換されます。 |
+| `position` | `'afterContent'` | `'beforeContent'` または `'afterContent'`。`@ampless/plugin-reading-time` とは逆のデフォルト — 記事を読んでから AI アクションを提示する意図。 |
+| `instanceId` | `'ai-actions'` | ランタイムのキー解決に使う namespace。同じサイトで 2 回登録する場合のみ変更する。 |
+
+`instanceId` を除く表示設定はデプロイなしで `/admin/plugins → AI アクション` から編集できます。コンストラクタの値は初期デフォルトに過ぎません。`instanceId` は `settings.public` に含まれないため、`cms.config.ts` でのみ設定できます。
+
+## 外部 AI リンク（opt-in）
+
+`showClaude` と `showChatgpt` はデフォルト **オフ** です。`https://claude.ai/new?q=...` と `https://chatgpt.com/?q=...` の URL prefill パターンは**広く使われているコミュニティ慣習**であり、Anthropic / OpenAI が公式に文書化・バージョン管理している URL 契約ではありません。ログイン状態（ログイン済み / 未ログイン）やプラットフォーム（デスクトップ / モバイル）によって挙動が異なる可能性があり、どちらのベンダーも予告なくこのクエリパラメータを変更・廃止し得ます。
+
+どちらかのリンクを有効化する前に、自サイトで以下を確認してください:
+
+- デスクトップでログイン済みの状態でプロンプトが正しく prefill されるか
+- モバイルで正しく prefill されるか（ネイティブアプリとモバイルブラウザで挙動が異なることがある）
+- 未ログイン状態でどうなるか
+
+挙動が不安定であれば、リンクをオフのままにしてください — 「Markdown で表示」リンク（デフォルトでオン）だけでも、読者や AI ツールに綺麗な Markdown の入口を提供できます。読者はそれを開いて任意の AI チャットに手動でコピー & ペーストできます。
+
+## 「Copy Markdown」ボタンが無い理由
+
+初期検討では「Copy Markdown」ボタン（`onclick` によるクリップボード書き込み）も候補にありましたが、現行のプラグイン surface では安全に実現できないため実装していません:
+
+- `publicHtmlForPost` の sanitizer はすべてのインラインイベントハンドラ（`onclick` 等）と `<button>` 要素を drop します — サニタイズ仕様は `@ampless/runtime` を参照。
+- `publicPostScript`（ページ JS を追加できるもう一つの plugin surface）は外部の絶対 `http(s)` script `src` のみを受け付け、投稿単位のロジックを書けるインラインスクリプトチャネルは現状ありません。
+
+inline-script capability の新設か plugin asset 配信の仕組みが無いと、この descriptor ベースの surface にクリップボード動作を配線する方法がありません。将来 Copy を実現できる capability が入るまでは、「Markdown で表示」+ ブラウザの「全選択 → コピー」が実用上の代替です。
+
+## 出力 HTML
+
+```html
+<p class="ampless-ai-actions">
+  <a class="ampless-ai-actions-md" href="/my-post.md">View as Markdown</a>
+  <span class="ampless-ai-actions-sep"> · </span>
+  <a class="ampless-ai-actions-claude" href="https://claude.ai/new?q=Read%20https%3A%2F%2Fexample.com%2Fmy-post.md" target="_blank" rel="noopener noreferrer">Open in Claude</a>
+  <span class="ampless-ai-actions-sep"> · </span>
+  <a class="ampless-ai-actions-chatgpt" href="https://chatgpt.com/?q=Read%20https%3A%2F%2Fexample.com%2Fmy-post.md" target="_blank" rel="noopener noreferrer">Open in ChatGPT</a>
+</p>
+```
+
+（読みやすさのために改行・インデントを加えています。実際の出力に要素間の空白はありません。）
+
+- クラス名（`ampless-ai-actions` / `ampless-ai-actions-md` / `ampless-ai-actions-claude` / `ampless-ai-actions-chatgpt` / `ampless-ai-actions-sep`）はテーマ CSS のための安定したフックです。デフォルト CSS は注入しません。
+- ラベル（"View as Markdown" / "Open in Claude" / "Open in ChatGPT"）は v1 では英語固定です。ロケール対応は要望が出てから検討します。
+- 「Markdown で表示」リンクは `site.url` が設定されていても常に**相対パス**（`/<slug>.md`）です — ページがどのドメインで配信されていても機能します。
+- Claude/ChatGPT リンクは外部サービスに渡すため**絶対 URL** が必要です。実効 `site.url` が空の場合、有効化していてもこの 2 リンクは省略され、「Markdown で表示」のみ描画されます。
+- 外部リンク（`target="_blank"`）には常に `rel="noopener noreferrer"` が付きます。プラグイン側で生成時点で付与しています（ランタイムの sanitizer も同じ属性を注入しますが、生成元で先に付けておくことでプラグイン自身の sanitize round-trip テストが完全一致になります）。
+
+## トラストレベル
+
+`untrusted`。`@ampless/runtime` が検証・サニタイズする HTML descriptor を返すだけです。DynamoDB、S3、Lambda プロセッサーには一切触れません。
+
+## v1 では対応しないこと
+
+- **Copy Markdown（クリップボード）** — 上記[「Copy Markdown」ボタンが無い理由](#copy-markdown-ボタンが無い理由)を参照。
+- **MCP 接続情報** — サイトの MCP endpoint を案内するリンク / QR コードは、将来の公開読み取り専用 MCP サーバーの提供後に検討予定です。
+- **テーマ CSS** — 安定したクラス名は提供しますが、デフォルト CSS は注入しません。
+- **ロケール別ラベル** — 未対応です。リンクテキストは英語固定で、プラグインを複数回登録しても解決になりません（全 instance が同じ position バケットに描画されるため、テーマがロケール別のスロットを選べません）。要望が出た時点で検討します。

package/README.md

@@ -0,0 +1,101 @@
+> 日本語版: [README.ja.md](./README.ja.md)
+>
+
+# @ampless/plugin-ai-actions
+
+Human-to-AI bridge links for [ampless](https://github.com/heavymoons/ampless) post pages. Injects a small `<p class="ampless-ai-actions">` element with up to three links, before or after the post content.
+
+> **Pre-release / beta.** Breaking changes possible in any minor version until v1.0.
+
+The links are emitted via the `publicHtmlForPost` capability (Phase 6d). Themes that call `ampless.publicHtmlForPost(post)` automatically render it. The runtime sanitizes the HTML with `sanitize-html` under a strict allowlist before it reaches the page — no `dangerouslySetInnerHTML` needed in the theme.
+
+No AWS data permissions are required — everything runs at request time inside the public Next.js process. The plugin's `trust_level` is `untrusted`.
+
+## Requires `ai.markdownRoutes`
+
+**Every action this plugin renders depends on the post's `/<slug>.md` markdown projection** — including the two external AI links, which pass the absolute `.md` URL in the `?q=` prompt. If `ai.markdownRoutes: false` is set in `cms.config.ts`, the "View as Markdown" link 404s, and the Claude/ChatGPT links still open but hand the AI a `.md` URL that doesn't exist. **Do not register this plugin on a site with `ai.markdownRoutes` disabled** — `ai.markdownRoutes` defaults to enabled, so most sites don't need to think about this, but double-check before installing.
+
+## Install
+
+```bash
+npm install @ampless/plugin-ai-actions@beta
+```
+
+## Configure
+
+In `cms.config.ts`:
+
+```ts
+import { defineConfig } from 'ampless'
+import aiActionsPlugin from '@ampless/plugin-ai-actions'
+
+export default defineConfig({
+  // ...
+  plugins: [
+    aiActionsPlugin(),
+  ],
+})
+```
+
+| Option | Default | Notes |
+|---|---|---|
+| `showMarkdownLink` | `true` | "View as Markdown" link to `/<slug>.md`. |
+| `showClaude` | `false` | "Open in Claude" link. **Opt-in** — see [External AI links](#external-ai-links-opt-in) below. |
+| `showChatgpt` | `false` | "Open in ChatGPT" link. **Opt-in** — same caveat. |
+| `promptTemplate` | `'Read {url}'` | Prompt used for the Claude/ChatGPT `?q=` prefill. `{url}` is replaced with the absolute `.md` URL. |
+| `position` | `'afterContent'` | `'beforeContent'` or `'afterContent'`. Opposite default of `@ampless/plugin-reading-time` — read the article, *then* offer the AI actions. |
+| `instanceId` | `'ai-actions'` | Namespace used for runtime key resolution. Change only if registering the plugin twice. |
+
+All display options except `instanceId` are also editable from `/admin/plugins → AI actions` without a redeploy — the constructor values above are just the initial defaults. `instanceId` is not part of `settings.public`, so it can only be set in `cms.config.ts`.
+
+## External AI links (opt-in)
+
+`showClaude` and `showChatgpt` default to **off**. The `https://claude.ai/new?q=...` and `https://chatgpt.com/?q=...` URL prefill pattern is a **widely-used community convention**, not a documented, versioned URL contract published by Anthropic or OpenAI. Behavior may differ by login state (signed in vs. signed out) and by platform (desktop vs. mobile), and either vendor could change or remove the query parameter without notice.
+
+Before enabling either link, verify on your own site:
+
+- Does the prompt prefill correctly when the visitor is logged in on desktop?
+- Does it prefill correctly on mobile (native app vs. mobile browser can differ)?
+- What happens when the visitor is signed out?
+
+If the behavior is unreliable for your audience, leave the link off — the "View as Markdown" link alone (default on) already gives readers and AI tools a clean markdown entry point; a reader can open it and copy/paste into any AI chat manually.
+
+## Why no "Copy Markdown" button
+
+An earlier design considered a "Copy Markdown" button (clipboard write via `onclick`). It isn't implemented because the current plugin surface can't support it safely:
+
+- `publicHtmlForPost`'s sanitizer drops all inline event handlers (`onclick`, etc.) and `<button>` elements — see the sanitizer profile in `@ampless/runtime`.
+- `publicPostScript` (the other plugin surface that can add page JS) only accepts an external absolute `http(s)` script `src`; there is no inline-script channel for per-post logic today.
+
+Without an inline-script capability or a plugin asset delivery mechanism, there's no way to wire a clipboard action into this descriptor-based surface. "View as Markdown" + browser "select all → copy" is the pragmatic substitute until a future capability makes Copy possible.
+
+## Output HTML
+
+```html
+<p class="ampless-ai-actions">
+  <a class="ampless-ai-actions-md" href="/my-post.md">View as Markdown</a>
+  <span class="ampless-ai-actions-sep"> · </span>
+  <a class="ampless-ai-actions-claude" href="https://claude.ai/new?q=Read%20https%3A%2F%2Fexample.com%2Fmy-post.md" target="_blank" rel="noopener noreferrer">Open in Claude</a>
+  <span class="ampless-ai-actions-sep"> · </span>
+  <a class="ampless-ai-actions-chatgpt" href="https://chatgpt.com/?q=Read%20https%3A%2F%2Fexample.com%2Fmy-post.md" target="_blank" rel="noopener noreferrer">Open in ChatGPT</a>
+</p>
+```
+
+(Whitespace added above for readability — the actual output has no whitespace between elements.)
+
+- The class names (`ampless-ai-actions`, `ampless-ai-actions-md`, `ampless-ai-actions-claude`, `ampless-ai-actions-chatgpt`, `ampless-ai-actions-sep`) are stable hooks for theme CSS. No default styling is injected.
+- Labels ("View as Markdown", "Open in Claude", "Open in ChatGPT") are fixed English strings in v1 — locale-aware labels are deferred until requested.
+- The "View as Markdown" link is always **relative** (`/<slug>.md`), even when `site.url` is configured — it works regardless of the domain the page is served from.
+- The Claude/ChatGPT links require an **absolute** `.md` URL (external services need a full URL). When the effective `site.url` is empty, those two links are omitted even if enabled — only "View as Markdown" renders.
+- External links (`target="_blank"`) always carry `rel="noopener noreferrer"`, generated up front by the plugin (the runtime's sanitizer would also inject it, but generating it at the source keeps the plugin's own sanitize round-trip test exact-match).
+
+## Trust level
+
+`untrusted`. The plugin only emits an HTML descriptor validated and sanitized by `@ampless/runtime`. It does not access DynamoDB, S3, or any Lambda processor.
+
+## What it does not do (v1)
+
+- **Copy Markdown (clipboard)** — see [Why no "Copy Markdown" button](#why-no-copy-markdown-button) above.
+- **MCP connection info** — a link/QR code pointing readers at the site's MCP endpoint is planned for a later phase, once the public read-only MCP server ships.
+- **Theme CSS** — stable class names are provided; no default CSS is injected.
+- **Locale-aware labels** — not supported. Link text is a fixed English string, and registering the plugin multiple times does not help: all instances render into the same position bucket, so themes cannot pick a per-locale slot. Deferred until requested.

package/dist/index.d.ts

@@ -0,0 +1,73 @@
+import { AmplessPlugin } from 'ampless';
+
+type AiActionsPosition = 'beforeContent' | 'afterContent';
+interface AiActionsOptions {
+    /** Show the "View as Markdown" link. Default `true`. */
+    showMarkdownLink?: boolean;
+    /**
+     * Show the "Open in Claude" link. Default `false` — opt-in.
+     * `https://claude.ai/new?q=` prefill is a community convention, not a
+     * documented URL contract; verify it works for your site before
+     * enabling. See README.md.
+     */
+    showClaude?: boolean;
+    /**
+     * Show the "Open in ChatGPT" link. Default `false` — opt-in. Same
+     * caveat as `showClaude`: `https://chatgpt.com/?q=` prefill is not a
+     * documented, versioned contract.
+     */
+    showChatgpt?: boolean;
+    /**
+     * Prompt template used to build the `?q=` query param for the Claude /
+     * ChatGPT links. `{url}` is replaced with the absolute `.md` URL of the
+     * post, then the whole string is `encodeURIComponent`-escaped. Default
+     * `'Read {url}'`.
+     */
+    promptTemplate?: string;
+    /**
+     * Where to inject the actions relative to the post body. Default
+     * `'afterContent'` — read the article first, then offer the AI actions
+     * (intentionally the opposite of `@ampless/plugin-reading-time`'s
+     * `'beforeContent'` default).
+     */
+    position?: AiActionsPosition;
+    /**
+     * Optional namespace for this instance. Defaults to `'ai-actions'`.
+     * Set a distinct value if registering the plugin more than once.
+     */
+    instanceId?: string;
+}
+/**
+ * Escape characters that have special meaning in HTML attribute values and
+ * text content. Same narrow five-character escape used by
+ * `@ampless/plugin-reading-time` — no external library needed for this
+ * use case (the runtime's `sanitize-html` pass is the actual safety
+ * boundary; this is defense in depth on the string we hand it).
+ */
+declare function escapeHtml(s: string): string;
+/**
+ * Factory for the AI-actions plugin. Returns a plugin that injects a
+ * `<p class="ampless-ai-actions">` element containing up to three links
+ * (View as Markdown / Open in Claude / Open in ChatGPT) before or after
+ * the post body via the `publicHtmlForPost` capability. Emits no
+ * descriptor at all when every link resolves to hidden.
+ *
+ * Usage in `cms.config.ts` (only if `ai.markdownRoutes` is enabled —
+ * the default — since every link this plugin renders points at the
+ * post's `/<slug>.md` route):
+ *
+ * ```ts
+ * import aiActionsPlugin from '@ampless/plugin-ai-actions'
+ *
+ * export default defineConfig({
+ *   plugins: [aiActionsPlugin()],
+ * })
+ * ```
+ *
+ * All options are also editable from `/admin/plugins → AI actions`
+ * without a redeploy — the constructor values below are the initial
+ * defaults.
+ */
+declare function aiActionsPlugin(options?: AiActionsOptions): AmplessPlugin;
+
+export { type AiActionsOptions, type AiActionsPosition, aiActionsPlugin as default, escapeHtml };

package/dist/index.js

@@ -0,0 +1,158 @@
+// src/index.ts
+import { definePlugin } from "ampless";
+function escapeHtml(s) {
+  return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+}
+var escapeAttr = escapeHtml;
+function fixedEncodeURIComponent(s) {
+  return encodeURIComponent(s).replace(
+    /[!'()*]/g,
+    (c) => "%" + c.charCodeAt(0).toString(16).toUpperCase()
+  );
+}
+function stripTrailingSlashes(s) {
+  return s.replace(/\/+$/, "");
+}
+function aiActionsPlugin(options = {}) {
+  const {
+    showMarkdownLink: defaultShowMarkdownLink = true,
+    showClaude: defaultShowClaude = false,
+    showChatgpt: defaultShowChatgpt = false,
+    promptTemplate: defaultPromptTemplate = "Read {url}",
+    position: defaultPosition = "afterContent",
+    instanceId
+  } = options;
+  return definePlugin({
+    name: "ai-actions",
+    packageName: "@ampless/plugin-ai-actions",
+    instanceId,
+    displayName: { en: "AI actions", ja: "AI \u30A2\u30AF\u30B7\u30E7\u30F3" },
+    apiVersion: 1,
+    trust_level: "untrusted",
+    capabilities: ["publicHtmlForPost", "adminSettings"],
+    settings: {
+      public: [
+        {
+          type: "boolean",
+          key: "showMarkdownLink",
+          label: {
+            en: 'Show "View as Markdown" link',
+            ja: "\u300CMarkdown \u3067\u8868\u793A\u300D\u30EA\u30F3\u30AF\u3092\u8868\u793A"
+          },
+          description: {
+            en: "Links to the post's /<slug>.md projection. Requires ai.markdownRoutes to be enabled in cms.config.ts.",
+            ja: "\u6295\u7A3F\u306E /<slug>.md \u3078\u306E\u76F8\u5BFE\u30EA\u30F3\u30AF\u3002cms.config.ts \u306E ai.markdownRoutes \u304C\u6709\u52B9\u3067\u3042\u308B\u5FC5\u8981\u304C\u3042\u308A\u307E\u3059\u3002"
+          },
+          default: defaultShowMarkdownLink
+        },
+        {
+          type: "boolean",
+          key: "showClaude",
+          label: {
+            en: 'Show "Open in Claude" link',
+            ja: "\u300CClaude \u3067\u958B\u304F\u300D\u30EA\u30F3\u30AF\u3092\u8868\u793A"
+          },
+          description: {
+            en: "Opt-in: links to https://claude.ai/new?q=... prefilled with the prompt template below. This URL prefill is a community convention, not a documented contract \u2014 verify it works on your site (logged-in desktop + mobile) before enabling.",
+            ja: "opt-in: \u4E0B\u8A18\u306E\u30D7\u30ED\u30F3\u30D7\u30C8\u30C6\u30F3\u30D7\u30EC\u30FC\u30C8\u3067 prefill \u3057\u305F https://claude.ai/new?q=... \u3078\u306E\u30EA\u30F3\u30AF\u3002\u3053\u306E URL prefill \u306F\u516C\u5F0F\u306B\u6587\u66F8\u5316\u3055\u308C\u305F\u5951\u7D04\u3067\u306F\u306A\u304F\u30B3\u30DF\u30E5\u30CB\u30C6\u30A3\u6163\u7FD2\u3067\u3059\u3002\u6709\u52B9\u5316\u524D\u306B\u81EA\u30B5\u30A4\u30C8\u3067\u52D5\u4F5C\u78BA\u8A8D\uFF08\u30ED\u30B0\u30A4\u30F3\u6E08\u307F PC / \u30E2\u30D0\u30A4\u30EB\uFF09\u3057\u3066\u304F\u3060\u3055\u3044\u3002"
+          },
+          default: defaultShowClaude
+        },
+        {
+          type: "boolean",
+          key: "showChatgpt",
+          label: {
+            en: 'Show "Open in ChatGPT" link',
+            ja: "\u300CChatGPT \u3067\u958B\u304F\u300D\u30EA\u30F3\u30AF\u3092\u8868\u793A"
+          },
+          description: {
+            en: 'Opt-in: links to https://chatgpt.com/?q=... prefilled with the prompt template below. Same caveat as "Open in Claude" \u2014 this is a community convention, not a documented contract.',
+            ja: "opt-in: \u4E0B\u8A18\u306E\u30D7\u30ED\u30F3\u30D7\u30C8\u30C6\u30F3\u30D7\u30EC\u30FC\u30C8\u3067 prefill \u3057\u305F https://chatgpt.com/?q=... \u3078\u306E\u30EA\u30F3\u30AF\u3002\u300CClaude \u3067\u958B\u304F\u300D\u3068\u540C\u69D8\u3001\u516C\u5F0F\u306B\u6587\u66F8\u5316\u3055\u308C\u305F\u5951\u7D04\u3067\u306F\u306A\u304F\u30B3\u30DF\u30E5\u30CB\u30C6\u30A3\u6163\u7FD2\u3067\u3059\u3002"
+          },
+          default: defaultShowChatgpt
+        },
+        {
+          type: "text",
+          key: "promptTemplate",
+          maxLength: 500,
+          label: {
+            en: "Prompt template",
+            ja: "\u30D7\u30ED\u30F3\u30D7\u30C8\u30C6\u30F3\u30D7\u30EC\u30FC\u30C8"
+          },
+          description: {
+            en: "Template for the Claude / ChatGPT prefill prompt. Use {url} for the absolute .md URL of the post.",
+            ja: "Claude / ChatGPT \u306E prefill \u30D7\u30ED\u30F3\u30D7\u30C8\u306E\u30C6\u30F3\u30D7\u30EC\u30FC\u30C8\u3002{url} \u3067\u6295\u7A3F\u306E\u7D76\u5BFE .md URL \u3092\u57CB\u3081\u8FBC\u3081\u307E\u3059\u3002"
+          },
+          default: defaultPromptTemplate
+        },
+        {
+          type: "select",
+          key: "position",
+          label: {
+            en: "Position",
+            ja: "\u8868\u793A\u4F4D\u7F6E"
+          },
+          description: {
+            en: "Where to inject the AI actions relative to the post content.",
+            ja: "AI \u30A2\u30AF\u30B7\u30E7\u30F3\u3092\u672C\u6587\u306E\u524D\u5F8C\u3069\u3061\u3089\u306B\u633F\u5165\u3059\u308B\u304B\u3002"
+          },
+          options: [
+            {
+              value: "beforeContent",
+              label: { en: "Before content", ja: "\u672C\u6587\u306E\u524D" }
+            },
+            {
+              value: "afterContent",
+              label: { en: "After content", ja: "\u672C\u6587\u306E\u5F8C" }
+            }
+          ],
+          default: defaultPosition
+        }
+      ]
+    },
+    publicHtmlForPost(post, ctx) {
+      const showMarkdownLink = ctx.setting("showMarkdownLink") ?? defaultShowMarkdownLink;
+      const showClaude = ctx.setting("showClaude") ?? defaultShowClaude;
+      const showChatgpt = ctx.setting("showChatgpt") ?? defaultShowChatgpt;
+      const promptTemplate = (ctx.setting("promptTemplate") ?? "").trim() || defaultPromptTemplate;
+      const position = ctx.setting("position") ?? defaultPosition;
+      const relativeMdUrl = `/${fixedEncodeURIComponent(post.slug)}.md`;
+      const siteUrl = stripTrailingSlashes((ctx.site.url ?? "").trim());
+      const absoluteMdUrl = siteUrl ? `${siteUrl}${relativeMdUrl}` : null;
+      const buttons = [];
+      if (showMarkdownLink) {
+        buttons.push(
+          `<a class="ampless-ai-actions-md" href="${escapeAttr(relativeMdUrl)}">View as Markdown</a>`
+        );
+      }
+      if (showClaude && absoluteMdUrl) {
+        const q = encodeURIComponent(promptTemplate.replace("{url}", absoluteMdUrl));
+        const href = `https://claude.ai/new?q=${q}`;
+        buttons.push(
+          `<a class="ampless-ai-actions-claude" href="${escapeAttr(href)}" target="_blank" rel="noopener noreferrer">Open in Claude</a>`
+        );
+      }
+      if (showChatgpt && absoluteMdUrl) {
+        const q = encodeURIComponent(promptTemplate.replace("{url}", absoluteMdUrl));
+        const href = `https://chatgpt.com/?q=${q}`;
+        buttons.push(
+          `<a class="ampless-ai-actions-chatgpt" href="${escapeAttr(href)}" target="_blank" rel="noopener noreferrer">Open in ChatGPT</a>`
+        );
+      }
+      if (buttons.length === 0) return [];
+      const body = `<p class="ampless-ai-actions">${buttons.join('<span class="ampless-ai-actions-sep"> \xB7 </span>')}</p>`;
+      return [
+        {
+          type: "html",
+          id: "actions",
+          body,
+          position
+        }
+      ];
+    }
+  });
+}
+export {
+  aiActionsPlugin as default,
+  escapeHtml
+};

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@ampless/plugin-ai-actions",
+  "version": "0.1.0-beta.0",
+  "description": "AI actions plugin for ampless — injects a View as Markdown link (and optional opt-in Open in Claude / Open in ChatGPT links) after (or before) the post content",
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/heavymoons/ampless.git",
+    "directory": "packages/plugin-ai-actions"
+  },
+  "homepage": "https://github.com/heavymoons/ampless/tree/main/packages/plugin-ai-actions#readme",
+  "bugs": "https://github.com/heavymoons/ampless/issues",
+  "dependencies": {
+    "ampless": "1.0.0-beta.58"
+  },
+  "devDependencies": {
+    "@types/sanitize-html": "^2.16.1",
+    "sanitize-html": "^2.17.4"
+  },
+  "keywords": [
+    "ampless",
+    "plugin",
+    "ampless-plugin",
+    "ai",
+    "markdown",
+    "llm",
+    "cms"
+  ],
+  "amplessPlugin": {
+    "apiVersion": 1,
+    "name": "ai-actions",
+    "trustLevel": "untrusted",
+    "capabilities": [
+      "publicHtmlForPost",
+      "adminSettings"
+    ],
+    "displayName": {
+      "en": "AI actions",
+      "ja": "AI アクション"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests"
+  }
+}