@mawaru/sdk 0.11.0 → 0.14.1

package/_schemas/port-spec.ts

@@ -2,12 +2,14 @@ import { z } from "zod"
 import type { GraphPort, JsonSchema, PortIo } from "./node.js"
 
 // ポートの kind 別型システム（docs/tasks/wip/ポートのkind別仕様.md）。
-// 型の決まり方は3分類：宣言（program / AI の in・out）／固定（human reject の
-// content 型）／導出（それ以外。接続元から伝播し、結果は ports.schema にキャッシュする）
+// 型の決まり方は2分類：宣言（program / ai の in・out。human はビューの宣言を転写）／
+// 導出（それ以外。接続元から伝播し、結果は ports.schema にキャッシュする）。
+// mawaru がコードで型を固定するポートは無い
+// （docs/tasks/wip/ポート型固定の撤去とセッション再開のポート属性化.md）
 
 // 「まだ型が決まっていない」＝未宣言を {} で表す（未接続・上流が未宣言・fan-in の型割れ）。
-// 「何でも受ける」型は存在しない：AI の in は接続元の具体型を鏡映し、差し戻しの指示は
-// instruction ポートの宣言型を持つ（docs/tasks/wip/ポートスキーマのany撲滅.md）
+// 「何でも受ける」型は存在しない：program / ai の in は接続元の具体型を鏡映する
+// （docs/tasks/wip/ポートスキーマのany撲滅.md）
 export const UNDECLARED_SCHEMA: JsonSchema = {}
 
 export const isUndeclaredSchema = (schema: JsonSchema): boolean =>
@@ -38,14 +40,12 @@ export const fileSchema = (): JsonSchema => ({
 export const isFileSchema = (schema: JsonSchema): boolean =>
   schema[FILE_SCHEMA_MARKER] === FILE_SCHEMA_TYPE
 
-// ---- 差し戻しの指示（AI の instruction ポート / human の reject ポート） ----
-// AI 入力の既存エンベロープ { prompt, files } と同じ形にする。配管が効く根拠は
-// files が file 型として宣言されていることであって、キー名ではない
-// （runner がマーカーで位置を見つけて materialize する）。
-// スクリーンショットを添えて差し戻すケースがあるので文章だけにしない
-// （docs/tasks/wip/ポートスキーマのany撲滅.md）
-export const AI_INSTRUCTION_PORT_KEY = "instruction"
-
+// ---- 差し戻しの指示のデフォルト型 ----
+// 雛形（エディタの既定ポート・ais/create）と承認ビューの既定宣言が参照する
+// **デフォルトであって強制ではない**：ユーザーはポートの宣言を自由に変えられ、
+// 接続の成立は通常の型検証だけが決める。配管が効く根拠は files が file 型として
+// 宣言されていることであって、キー名ではない（runner がマーカーで位置を見つけて
+// materialize する）。スクリーンショットを添えて差し戻すケースがあるので文章だけにしない
 export const instructionSchema = (): JsonSchema => ({
   type: "object",
   properties: {
@@ -138,38 +138,6 @@ export const dataFormatOf = (schema: JsonSchema): DataFormat | null => {
   return { format: "list", columns }
 }
 
-// 封筒型 { data: T, description: string }。T は任意の JSON Schema、description は
-// AI によるデータの説明（AI が必ず生成する）。AI の全出口に強制する
-export const envelopeSchemaOf = (dataSchema: JsonSchema): JsonSchema => ({
-  type: "object",
-  properties: {
-    data: dataSchema,
-    description: { type: "string" },
-  },
-  required: ["data", "description"],
-})
-
-// 封筒型なら data のサブスキーマを返す（data キー必須の object。それ以外は null）
-export const envelopeDataSchemaOf = (schema: JsonSchema): JsonSchema | null => {
-  if (schema.type !== "object") return null
-  const properties = (schema.properties ?? {}) as Record<string, JsonSchema>
-  const required = (schema.required ?? []) as string[]
-  const data = properties.data
-  if (!data || !required.includes("data")) return null
-  return data
-}
-
-// AI の出口として妥当な封筒型か：data と description: string の両方が必須
-export const isAiEnvelopeSchema = (schema: JsonSchema): boolean => {
-  if (envelopeDataSchemaOf(schema) === null) return false
-  const properties = (schema.properties ?? {}) as Record<string, JsonSchema>
-  const required = (schema.required ?? []) as string[]
-  return (
-    properties.description?.type === "string" &&
-    required.includes("description")
-  )
-}
-
 // ---- kind 別ポート構成 ----
 // human / wait は構成（数・key・io）が固定。program / ai は in 1つ＋out 1つ以上
 // （key 自由。複数 out＝分岐。AIノードの複数出口（分岐）.md）
@@ -187,22 +155,19 @@ const FIXED_PORT_KEYS: Record<string, { in: string[]; out: string[] }> = {
 
 const FREE_OUT_KINDS = new Set(["program", "ai"])
 
-// out は自由（複数出口＝分岐）だが in の構成は固定。ai は上流データを受ける in と、
-// 差し戻しの指示を受ける instruction の2口（意味の違う入力を1つのポートに
-// fan-in させない。docs/tasks/wip/ポートスキーマのany撲滅.md）
+// out は自由（複数出口＝分岐）。program は in の構成も固定（1口）だが、
+// ai は in も自由（追加・削除・key 自由。セッション再開は key ではなくポートの
+// resume 属性で決まる。ポート型固定の撤去とセッション再開のポート属性化.md）
 const FIXED_IN_KEYS: Record<string, string[]> = {
   program: ["in"],
-  ai: ["in", AI_INSTRUCTION_PORT_KEY],
 }
 
 export const fixedInKeysOf = (kind: string): string[] | null =>
   FIXED_IN_KEYS[kind] ?? null
 
 // config.json（manifest）の inputs 検査（適合なら null）。同じルールを二重に持たないため
-// manifest 側はここを参照する（docs/tasks/wip/manifestのin複数対応（instructionポート）.md）。
-// **必須は "in" だけ**で、kind が固定する他の in（ai の instruction）は任意：スキーマは
-// constSchemaOf が焼き込む固定型なのでエディタ側で補え、in を2口に分ける前に同期された
-// config.json もそのまま読める
+// manifest 側はここを参照する。in の構成が固定の kind（program）だけが使う
+// （ai の inputs は key 自由なので ai-manifest 側で件数と key の規則だけ見る）
 export const manifestInKeysViolation = (
   kind: string,
   keys: string[],
@@ -265,13 +230,12 @@ export const kindPortsViolation = (
 
 // ---- 型伝播（導出ポートの解決） ----
 // 接続の両端は同じスキーマになる（値入力フォームのSchemaForm統一.md）。
-// wait / human は素通し（パラメトリック）ノード：in は接続元の out、out は in と同型。
-// 例外は human の approve：接続元が AI ノードのときだけ封筒を剥がして data 型になる。
-// human の reject は未宣言のまま（段階2 で instruction エンベロープを宣言する）。
+// wait は素通し（パラメトリック）ノード：in は接続元の out、out は in と同型。
+// human はビューの宣言を転写（"T" は素通しと同じ挙動。reject もビューの宣言）。
 // 宣言 out（program / ai）は触らない。
-// program / ai の in は接続鏡映（sticky）：接続元 out が具体型のときだけ上書きし、
-// 未接続・型割れ・未宣言は現スキーマ（宣言）を維持する（鏡映結果は repo の config.json
-// へも書き戻される。docs/tasks/wip/ポート編集のrepo書き戻し同期.md）
+// program / ai の in は**全ての口が**接続鏡映（sticky）：接続元 out が具体型のときだけ
+// 上書きし、未接続・型割れ・未宣言は現スキーマ（宣言）を維持する（鏡映結果は repo の
+// config.json へも書き戻される。docs/tasks/wip/ポート編集のrepo書き戻し同期.md）
 
 // 複数の流入（fan-in）から型を1つに決める：未宣言を除いて具体型が1種類ならその型、
 // 0種類なら未宣言。2種類以上は型が割れているので未宣言に落とす
@@ -302,6 +266,30 @@ type PropagationNode = {
 }
 type PortLink = { from_port_id: string; to_port_id: string }
 
+// 「上流の out をそのままコピーする」（in）／「in と同型」（approve）を表す指示。
+// 承認ビューのカタログ（@mawaru/common）の COPY_UPSTREAM と同じ値
+export const COPY_UPSTREAM_SCHEMA = "T"
+
+// ポートの型宣言：具体型か、上流からのコピー指示か
+export type DeclaredPortSchema = JsonSchema | typeof COPY_UPSTREAM_SCHEMA
+
+// 伝播のオプション。sdk は承認ビューのカタログを知らない（非公開。企業向けビューの
+// キーが npm 公開物に載るのを避ける）ので、呼び出し元が解決して渡す
+// → docs/tasks/wip/ポート型固定の撤去とセッション再開のポート属性化.md
+export type PropagationOptions<N> = {
+  // human の in / approve / reject に転写する型（承認ビューの宣言）。null / undefined
+  // ならその node は対象外（human 以外）。上流ノードの kind は一切見ない。
+  // reject は具体型のみ（上流からのコピー指示は意味を持たない）
+  viewPortSchemasOf?: (node: N) =>
+    | {
+        in: DeclaredPortSchema
+        approve: DeclaredPortSchema
+        reject: JsonSchema
+      }
+    | null
+    | undefined
+}
+
 // end も導出ノード（各 in は上流から、out main は未宣言）。個別処理は
 // resolvePortSchemas 内で行うが、初期スキーマを未宣言にするためここに含める。
 // start も導出ノード：out main は接続先の in から逆向きに転写し、in は out と同型
@@ -313,46 +301,29 @@ const MIRROR_KINDS = new Set(["program", "ai"])
 
 const isDerivedPort = (kind: string, port: Pick<GraphPort, "io" | "key">) =>
   DERIVED_KINDS.has(kind) &&
-  (port.io === "in" || port.key === "main" || port.key === "approve")
-
-// AI の in は nodes/ai/<dir>/config.json の inputs.in 由来の宣言型が初期値で、
-// 接続時は program と同じ鏡映で接続元と同値に同期される（const 扱い廃止。
-// 接続バリデーションの「ai の in は常に許可」は維持）
-// 宣言型で固定されるポート（導出も鏡映もしない）。差し戻しの指示エンベロープを
-// human の出口と AI の入口の両方に焼き込むことで、両端が同じ具体型で一致する
-const constSchemaOf = (
-  kind: string,
-  port: Pick<GraphPort, "io" | "key">,
-): JsonSchema | null => {
-  if (kind === "human" && port.io === "out" && port.key === "reject") {
-    return instructionSchema()
-  }
-  if (
-    kind === "ai" &&
-    port.io === "in" &&
-    port.key === AI_INSTRUCTION_PORT_KEY
-  ) {
-    return instructionSchema()
-  }
-  return null
-}
+  (port.io === "in" ||
+    port.key === "main" ||
+    port.key === "approve" ||
+    port.key === "reject")
 
 // port_id → 解決済みスキーマ。導出は接続を遡って固定点まで反復し、
-// 未接続・純パラメトリック閉路・fan-in の型割れは未宣言に落とす
+// 未接続・純パラメトリック閉路・fan-in の型割れは未宣言に落とす。
+// ai の in は nodes/ai/<dir>/config.json の inputs[key].schema 由来の宣言型が初期値で、
+// 接続時は program と同じ鏡映で接続元と同値に同期される（どの in も対等。
+// instruction への型の焼き込みは廃止）
 export const resolvePortSchemas = <N extends PropagationNode>(
   nodes: N[],
   connections: PortLink[],
+  options?: PropagationOptions<N>,
 ): Map<string, JsonSchema> => {
   const resolved = new Map<string, JsonSchema>()
   const kindByPortId = new Map<string, string>()
   for (const node of nodes) {
     for (const port of node.ports) {
       kindByPortId.set(port.id, node.kind)
-      const constSchema = constSchemaOf(node.kind, port)
       resolved.set(
         port.id,
-        constSchema ??
-          (isDerivedPort(node.kind, port) ? UNDECLARED_SCHEMA : port.schema),
+        isDerivedPort(node.kind, port) ? UNDECLARED_SCHEMA : port.schema,
       )
     }
   }
@@ -415,34 +386,50 @@ export const resolvePortSchemas = <N extends PropagationNode>(
       }
       const isMirror = MIRROR_KINDS.has(node.kind)
       if (!DERIVED_KINDS.has(node.kind) && !isMirror) continue
-      // ai は in が2口あるので、上流データの口（key="in"）だけを鏡映・導出の対象にする
-      const inPort = node.ports.find((p) => p.io === "in" && p.key === "in")
+      // 鏡映（program / ai）：全ての in が対象。具体型が流れてきたときだけ上書きする
+      // （宣言を未宣言で潰さない）。ai の in はどの口も対等（instruction の特別扱いは無い）
+      if (isMirror) {
+        for (const port of node.ports) {
+          if (port.io !== "in") continue
+          const sources = inbound.get(port.id) ?? []
+          const inSchema = mergeInboundSchemas(
+            sources.map((id) => resolved.get(id) ?? UNDECLARED_SCHEMA),
+          )
+          if (!isUndeclaredSchema(inSchema)) assign(port.id, inSchema)
+        }
+        continue
+      }
+      // 導出（wait / human）：in は上流から
+      const inPort = node.ports.find((p) => p.io === "in")
       if (!inPort) continue
       const sources = inbound.get(inPort.id) ?? []
       const inSchema = mergeInboundSchemas(
         sources.map((id) => resolved.get(id) ?? UNDECLARED_SCHEMA),
       )
-      // 鏡映（program / ai）は具体型が流れてきたときだけ上書き（宣言を未宣言で潰さない）
-      if (isMirror) {
-        if (!isUndeclaredSchema(inSchema)) assign(inPort.id, inSchema)
-        continue
-      }
-      assign(inPort.id, inSchema)
-      // human の approve：接続元が AI ノードなら封筒 { data, description } を剥がして
-      // data 型を流す（承認は data だけを下流へ渡す）。それ以外の上流は従来どおり素通し
-      const fromAiNode =
-        sources.length === 1 &&
-        sources[0] !== undefined &&
-        kindByPortId.get(sources[0]) === "ai"
+      // 承認ビューの宣言を human のポートへそのまま転写する（上流ノードの kind は見ない）。
+      // "T" は「上流の out をコピー」（in）／「in と同型」（approve）。reject は具体型の宣言
+      // のみで、宣言が無ければ未宣言のまま（mawaru が型を焼き込むことはしない）。
+      // 上流の out は書き換えない：逆伝播すると fan-out 先のビューが食い違ったとき
+      // 型割れが config.json へ write-through され、元の出力宣言を黙って壊す。
+      // ズレは接続の型エラーで見せてユーザーの [修正する] で直す
+      const declared = options?.viewPortSchemasOf?.(node)
+      const effectiveIn =
+        declared && declared.in !== COPY_UPSTREAM_SCHEMA
+          ? declared.in
+          : inSchema
+      assign(inPort.id, effectiveIn)
       for (const port of node.ports) {
-        if (port.io === "out" && isDerivedPort(node.kind, port)) {
-          assign(
-            port.id,
-            node.kind === "human" && port.key === "approve" && fromAiNode
-              ? (envelopeDataSchemaOf(inSchema) ?? UNDECLARED_SCHEMA)
-              : inSchema,
-          )
+        if (port.io !== "out" || !isDerivedPort(node.kind, port)) continue
+        if (node.kind === "human" && port.key === "reject") {
+          if (declared) assign(port.id, declared.reject)
+          continue
         }
+        assign(
+          port.id,
+          declared && declared.approve !== COPY_UPSTREAM_SCHEMA
+            ? declared.approve
+            : effectiveIn,
+        )
       }
     }
     if (!changed) break
@@ -455,8 +442,9 @@ export const resolvePortSchemas = <N extends PropagationNode>(
 export const propagateDerivedPorts = <N extends PropagationNode>(
   nodes: N[],
   connections: PortLink[],
+  options?: PropagationOptions<N>,
 ): N[] => {
-  const resolved = resolvePortSchemas(nodes, connections)
+  const resolved = resolvePortSchemas(nodes, connections, options)
   return nodes.map((node) => {
     let touched = false
     const ports = node.ports.map((port) => {

package/dist/_cli/credentials.d.ts

@@ -0,0 +1,14 @@
+export type Credentials = {
+    refresh_token: string;
+    access_token: string;
+    supabase_url: string;
+    supabase_key: string;
+    api_url: string;
+    email: string;
+};
+export declare const credentialsPath: () => string;
+export declare const loadCredentials: () => Credentials | null;
+export declare const saveCredentials: (credentials: Credentials) => string;
+export declare const clearCredentials: () => boolean;
+export declare const accessTokenFrom: (credentials: Credentials) => Promise<string>;
+export declare const requireCredentials: () => Credentials;

package/dist/_cli/credentials.js

@@ -0,0 +1,81 @@
+import { chmodSync, mkdirSync, readFileSync, rmSync, writeFileSync, } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+export const credentialsPath = () => join(process.env.MAWARU_CONFIG_DIR ?? join(homedir(), ".mawaru"), "credentials.json");
+export const loadCredentials = () => {
+    try {
+        return JSON.parse(readFileSync(credentialsPath(), "utf8"));
+    }
+    catch {
+        return null;
+    }
+};
+// 0600 で保存する（refresh token は実質アカウントそのもの）
+export const saveCredentials = (credentials) => {
+    const path = credentialsPath();
+    mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
+    writeFileSync(path, `${JSON.stringify(credentials, null, 2)}\n`, {
+        mode: 0o600,
+    });
+    chmodSync(path, 0o600);
+    return path;
+};
+export const clearCredentials = () => {
+    try {
+        rmSync(credentialsPath());
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+// JWT の exp を見て、期限が近ければ refresh する。
+// 検証はしない（署名を確かめるのはサーバの仕事）。ここでは「無駄な 401 を避ける」だけ
+const expiresSoon = (accessToken) => {
+    try {
+        const payload = accessToken.split(".")[1];
+        if (!payload)
+            return true;
+        const { exp } = JSON.parse(Buffer.from(payload, "base64url").toString("utf8"));
+        if (typeof exp !== "number")
+            return true;
+        return exp * 1000 - Date.now() < 60_000;
+    }
+    catch {
+        return true;
+    }
+};
+// API を叩くための access token。必要なら refresh して credentials を更新する
+export const accessTokenFrom = async (credentials) => {
+    if (!expiresSoon(credentials.access_token))
+        return credentials.access_token;
+    const res = await fetch(`${credentials.supabase_url}/auth/v1/token?grant_type=refresh_token`, {
+        method: "POST",
+        headers: {
+            "content-type": "application/json",
+            apikey: credentials.supabase_key,
+        },
+        body: JSON.stringify({ refresh_token: credentials.refresh_token }),
+    });
+    if (!res.ok) {
+        throw new Error(`セッションの更新に失敗しました（HTTP ${res.status}）。\`mawaru login\` でログインし直してください。`);
+    }
+    const body = (await res.json());
+    if (!body.access_token || !body.refresh_token) {
+        throw new Error("セッションの更新に失敗しました。`mawaru login` でログインし直してください。");
+    }
+    saveCredentials({
+        ...credentials,
+        access_token: body.access_token,
+        refresh_token: body.refresh_token,
+    });
+    return body.access_token;
+};
+// ログイン必須のコマンドの入口。未ログインは案内して終了させる
+export const requireCredentials = () => {
+    const credentials = loadCredentials();
+    if (!credentials) {
+        throw new Error("ログインしていません。`mawaru login` を実行してください。");
+    }
+    return credentials;
+};

package/dist/_cli/login.d.ts

@@ -0,0 +1,5 @@
+export type LoginResult = {
+    email: string;
+    path: string;
+};
+export declare const runLogin: (timeoutMs?: number) => Promise<LoginResult>;

package/dist/_cli/login.js

@@ -0,0 +1,82 @@
+import { spawn } from "node:child_process";
+import { randomUUID } from "node:crypto";
+import { createServer } from "node:http";
+import { saveCredentials } from "./credentials.js";
+// `gh auth login` と同じループバック方式（RFC 8252）。
+// CLI が 127.0.0.1 の一時ポートで待ち受け、ブラウザで mawaru の /cli-auth を開く。
+// 承認するとブラウザがループバック URL へ**遷移**してトークンを渡す
+//（https のページから http へ fetch は混在コンテンツで塞がれるが、遷移なら通る）。
+const APP_URL = process.env.MAWARU_APP_URL ?? "https://app.mawaru.ai";
+const page = (title, message) => `<!doctype html><meta charset="utf-8"><title>${title}</title>` +
+    `<body style="font-family:system-ui;display:grid;place-items:center;height:100vh;margin:0">` +
+    `<div style="text-align:center"><h1 style="font-size:1.25rem">${title}</h1>` +
+    `<p style="color:#666">${message}</p></div></body>`;
+// ブラウザを開く（開けなければ URL を出して手で開いてもらう。依存は足さない）
+const openBrowser = (url) => {
+    const [command, args] = process.platform === "darwin"
+        ? ["open", [url]]
+        : process.platform === "win32"
+            ? ["cmd", ["/c", "start", "", url]]
+            : ["xdg-open", [url]];
+    try {
+        spawn(command, args, { stdio: "ignore", detached: true }).unref();
+    }
+    catch {
+        // 何もしない（URL は既に印字済み）
+    }
+};
+export const runLogin = async (timeoutMs = 5 * 60 * 1000) => {
+    // 別のローカルプロセスが投げ込んだ応答を受け付けないための照合値
+    const state = randomUUID();
+    return await new Promise((resolve, reject) => {
+        const server = createServer((req, res) => {
+            const url = new URL(req.url ?? "/", "http://127.0.0.1");
+            if (url.pathname !== "/callback") {
+                res.writeHead(404).end();
+                return;
+            }
+            const params = url.searchParams;
+            const finish = (status, title, message) => {
+                res.writeHead(status, { "content-type": "text/html; charset=utf-8" });
+                res.end(page(title, message));
+                server.close();
+            };
+            if (params.get("state") !== state) {
+                finish(400, "承認に失敗しました", "リクエストが一致しませんでした。");
+                reject(new Error("承認の照合値（state）が一致しませんでした"));
+                return;
+            }
+            const credentials = {
+                refresh_token: params.get("refresh_token") ?? "",
+                access_token: params.get("access_token") ?? "",
+                supabase_url: params.get("supabase_url") ?? "",
+                supabase_key: params.get("supabase_key") ?? "",
+                api_url: params.get("api_url") ?? "",
+                email: params.get("email") ?? "",
+            };
+            if (!credentials.refresh_token || !credentials.api_url) {
+                finish(400, "承認に失敗しました", "トークンを受け取れませんでした。");
+                reject(new Error("承認の応答にトークンが含まれていませんでした"));
+                return;
+            }
+            const path = saveCredentials(credentials);
+            finish(200, "ログインしました", "このタブを閉じて、ターミナルに戻ってください。");
+            resolve({ email: credentials.email, path });
+        });
+        server.on("error", reject);
+        // ループバックのみに束ねる（他ホストから叩かれないように）
+        server.listen(0, "127.0.0.1", () => {
+            const { port } = server.address();
+            const authUrl = new URL("/cli-auth", APP_URL);
+            authUrl.searchParams.set("callback", `http://127.0.0.1:${port}/callback`);
+            authUrl.searchParams.set("state", state);
+            console.log(`ブラウザで承認してください: ${authUrl}`);
+            openBrowser(authUrl.toString());
+        });
+        const timer = setTimeout(() => {
+            server.close();
+            reject(new Error("承認がタイムアウトしました。もう一度お試しください。"));
+        }, timeoutMs);
+        server.on("close", () => clearTimeout(timer));
+    });
+};

package/dist/_cli/resumeSession.d.ts

@@ -0,0 +1,21 @@
+import { type Credentials } from "./credentials.js";
+export type StepRef = {
+    tenantId: string;
+    runId: string;
+    stepId: string;
+};
+export declare const parseStepUrl: (raw: string) => StepRef;
+export declare const recordedCwds: (transcript: string) => {
+    all: string[];
+    last: string | null;
+};
+export declare const findProjectDir: (cwd: string) => string | null;
+export type TranscriptRef = {
+    url: string;
+    session_id: string;
+    redacted?: number;
+};
+export declare const fetchTranscriptRef: (credentials: Credentials, ref: StepRef) => Promise<TranscriptRef>;
+export declare const downloadTranscript: (url: string) => Promise<string>;
+export declare const placeTranscript: (cwd: string, sessionId: string, transcript: string) => string;
+export declare const spawnClaudeResume: (sessionId: string) => Promise<number>;

package/dist/_cli/resumeSession.js

@@ -0,0 +1,125 @@
+import { spawn } from "node:child_process";
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { accessTokenFrom } from "./credentials.js";
+// UI がコピーさせる web の URL から tenant / run / step を取り出す。
+// 3つを1つの貼れる文字列で運ぶために URL の形にしている
+export const parseStepUrl = (raw) => {
+    let url;
+    try {
+        url = new URL(raw);
+    }
+    catch {
+        throw new Error(`URL として読めません: ${raw}`);
+    }
+    const segments = url.pathname.split("/").filter(Boolean);
+    const runIndex = segments.indexOf("runs");
+    const stepIndex = segments.indexOf("steps");
+    const runId = runIndex >= 0 ? segments[runIndex + 1] : undefined;
+    const stepId = stepIndex >= 0 ? segments[stepIndex + 1] : undefined;
+    const tenantId = url.searchParams.get("tenant");
+    if (!runId || !stepId) {
+        throw new Error("run / step を含む URL ではありません（例: https://app.mawaru.ai/runs/<runId>/steps/<stepId>?tenant=<tenantId>）");
+    }
+    if (!tenantId) {
+        throw new Error("URL に ?tenant=<tenantId> がありません。run 詳細のコピーボタンで取得した URL をそのまま渡してください。");
+    }
+    return { tenantId, runId, stepId };
+};
+// transcript に記録された作業ディレクトリ（重複は畳み、最後に居た場所も返す）。
+// **現在地がそこと違っていても resume 自体は通ってしまう**ので、人間に見せて確認を取る
+export const recordedCwds = (transcript) => {
+    const all = [];
+    let last = null;
+    for (const line of transcript.split("\n")) {
+        if (!line)
+            continue;
+        let cwd;
+        try {
+            cwd = JSON.parse(line).cwd;
+        }
+        catch {
+            continue;
+        }
+        if (typeof cwd !== "string" || cwd.length === 0)
+            continue;
+        if (!all.includes(cwd))
+            all.push(cwd);
+        last = cwd;
+    }
+    return { all, last };
+};
+const projectsRoot = () => join(process.env.CLAUDE_CONFIG_DIR ?? join(homedir(), ".claude"), "projects");
+// 置き先のディレクトリを **規則を再実装せず観測で決める**（agent-runner の
+// _helpers/session.ts と同じ方針）。~/.claude/projects/*/*.jsonl の cwd を読み、
+// いま居るディレクトリと一致するものを選ぶ
+export const findProjectDir = (cwd) => {
+    const root = projectsRoot();
+    if (!existsSync(root))
+        return null;
+    for (const dir of readdirSync(root)) {
+        const path = join(root, dir);
+        let files;
+        try {
+            files = readdirSync(path).filter((f) => f.endsWith(".jsonl"));
+        }
+        catch {
+            continue;
+        }
+        for (const file of files) {
+            let head;
+            try {
+                head = readFileSync(join(path, file), "utf8");
+            }
+            catch {
+                continue;
+            }
+            if (recordedCwds(head).all.includes(cwd))
+                return path;
+        }
+    }
+    return null;
+};
+// 段階3 のエンドポイントから署名 URL と session_id を得る
+export const fetchTranscriptRef = async (credentials, ref) => {
+    const token = await accessTokenFrom(credentials);
+    const res = await fetch(`${credentials.api_url}/tenants/${ref.tenantId}/runs/${ref.runId}/steps/${ref.stepId}/transcript`, { headers: { Authorization: `Bearer ${token}` } });
+    if (res.status === 404) {
+        throw new Error("この step には退避されたセッションがありません（AI ノード以外か、退避前の実行です）。");
+    }
+    if (!res.ok) {
+        throw new Error(`transcript を取得できませんでした（HTTP ${res.status}）`);
+    }
+    return (await res.json());
+};
+export const downloadTranscript = async (url) => {
+    const res = await fetch(url);
+    if (!res.ok) {
+        throw new Error(`transcript のダウンロードに失敗しました（HTTP ${res.status}）`);
+    }
+    return await res.text();
+};
+// 置き先へ書き込む。ディレクトリが見つからないのは「この repo でまだ claude を
+// 起動していない」ケースなので、観測できるようにしてから再実行してもらう
+export const placeTranscript = (cwd, sessionId, transcript) => {
+    const dir = findProjectDir(cwd);
+    if (!dir) {
+        throw new Error("このディレクトリの Claude Code プロジェクトが見つかりません。" +
+            "ここで一度 `claude` を起動してから、もう一度実行してください。");
+    }
+    mkdirSync(dir, { recursive: true });
+    const file = join(dir, `${sessionId}.jsonl`);
+    writeFileSync(file, transcript);
+    return file;
+};
+// stdio を引き継いで claude を起動する（そのまま対話に入る）
+export const spawnClaudeResume = (sessionId) => new Promise((resolve) => {
+    const child = spawn("claude", ["--resume", sessionId], { stdio: "inherit" });
+    child.on("error", () => {
+        console.error("claude を起動できませんでした。Claude Code をインストールしてから `claude --resume " +
+            `${sessionId}\` を実行してください。`);
+        resolve(1);
+    });
+    child.on("close", (code) => resolve(code ?? 0));
+});

package/dist/_cli/sessionCommand.d.ts

@@ -0,0 +1,3 @@
+export declare const runSessionResume: (stepUrl: string | undefined, options: {
+    yes: boolean;
+}) => Promise<number>;