aipctl 2026.8.5 → 2026.9.1

package/README.md

@@ -34,6 +34,29 @@ aipctl tunnel link <token>
 
 `install`, `run`, `tunnel`, `logs`는 Go native binary로 lazy dispatch됩니다. `prod` build에서는 `logs` command가 help와 command tree에서 제외됩니다.
 
+## Experimental model execution
+
+`aipctl model-exec`은 CLI 전용 one-shot 모델 실행 namespace입니다. Conversation을 만들지 않고, 사용자가 선택한 모델을 한 번 호출해 stdout 또는 파일로 결과를 받습니다.
+
+```bash
+aipctl model-exec models [--type chat|image-generation] [--json]
+aipctl model-exec get <model-id> [--json]
+aipctl model-exec sample <model-id> [--save input.json]
+aipctl model-exec chat --model <chat-model-id> -m "hello" [--json]
+aipctl model-exec image generate --model <image-model-id> --prompt "cat" --output ./cat.png [--json]
+```
+
+대화형 터미널에서는 `model-exec chat`과 `model-exec image generate`가 완료될 때까지 spinner와 경과 시간을 stderr에 표시합니다. JSON을 포함한 최종 결과는 기존처럼 stdout에만 출력됩니다.
+
+`model-exec image generate`의 이미지 생성 요청 timeout은 최대 5분입니다. 5분 안에 provider 응답이 완료되지 않으면 명령은 실패하며, 이 제한은 one-shot image-generation 요청에만 적용됩니다. `aipctl model-exec image generate --help`와 실행 중 spinner에서도 제한을 확인할 수 있습니다.
+
+Conversation을 유지하는 일반 채팅은 `chat send`를 사용합니다.
+
+```bash
+aipctl chat send -m "hello" --json
+aipctl chat send --conversation <conversation-id> -m "continue" --json
+```
+
 ## Development
 
 ```bash

package/build/index.cjs

@@ -89666,11 +89666,11 @@ const runMain = runMain$1;
 const BUILD_ENVS = ["local", "dev", "qa", "stage", "prod", "test"];
 const isBuildEnv = (value) => BUILD_ENVS.includes(value);
 
-const injectedBuildEnv = "prod".length > 0 ? "prod" : "local";
+const injectedBuildEnv = "dev".length > 0 ? "dev" : "local";
 if (!isBuildEnv(injectedBuildEnv)) {
   throw new Error(`Invalid AIPCTL_BUILD_ENV: ${injectedBuildEnv}`);
 }
-const VERSION = "2026.8.5".length > 0 ? "2026.8.5" : "0.0.0";
+const VERSION = "2026.9.1".length > 0 ? "2026.9.1" : "0.0.0";
 const BUILD_ENV = injectedBuildEnv;
 const INCLUDE_NATIVE_LOGS = BUILD_ENV !== "prod";
 
@@ -94487,6 +94487,30 @@ const ApiServiceLive = effect$1(
           ...res.defaultModel === id ? { isDefault: true } : {}
         }));
       }),
+      listModelExecModels: (orgSlug) => gen(function* () {
+        yield* requireChatBaseUrlEffect();
+        const token = yield* getAccessToken();
+        const path = `/api/${encodeURIComponent(orgSlug)}/cli/model-exec/models`;
+        return yield* makeRequest(chatBaseUrl, path, token);
+      }),
+      executeModelExecChat: (orgSlug, body) => gen(function* () {
+        yield* requireChatBaseUrlEffect();
+        const token = yield* getAccessToken();
+        const path = `/api/${encodeURIComponent(orgSlug)}/cli/model-exec/chat`;
+        return yield* makeRequest(chatBaseUrl, path, token, {
+          method: "POST",
+          body
+        });
+      }),
+      executeModelExecImageGeneration: (orgSlug, body) => gen(function* () {
+        yield* requireChatBaseUrlEffect();
+        const token = yield* getAccessToken();
+        const path = `/api/${encodeURIComponent(orgSlug)}/cli/model-exec/images/generations`;
+        return yield* makeRequest(chatBaseUrl, path, token, {
+          method: "POST",
+          body
+        });
+      }),
       getCreditStatistics: (orgSlug, options) => gen(function* () {
         const token = yield* getAccessToken();
         const params = new URLSearchParams();
@@ -94638,6 +94662,15 @@ const ApiServiceLive = effect$1(
         const path = `/librechat/api/${encodeURIComponent(orgSlug)}/messages/${encodeURIComponent(conversationId)}`;
         return yield* makeRequest(chatBaseUrl, path, token);
       }),
+      sendChatMessage: (orgSlug, body) => gen(function* () {
+        yield* requireChatBaseUrlEffect();
+        const token = yield* getAccessToken();
+        const path = `/api/${encodeURIComponent(orgSlug)}/cli/chats/messages`;
+        return yield* makeRequest(chatBaseUrl, path, token, {
+          method: "POST",
+          body
+        });
+      }),
       // Phase 8: Agent admin CRUD
       createInstalledAgent: (orgSlug, body) => gen(function* () {
         const token = yield* getAccessToken();
@@ -95045,14 +95078,14 @@ function jsonFormat(data, options = {}) {
 }
 
 const agentIdArg$4 = text$2({ name: "id" }).pipe(withDescription$5("Agent ID to export"));
-const outputOption$2 = text("output").pipe(
+const outputOption$3 = text("output").pipe(
   withAlias("o"),
   withDescription$3("Output file path (defaults to {agentId}.yaml)"),
   optional
 );
 const exportCommand = make$4(
   "export",
-  { agentId: agentIdArg$4, org: orgOption, output: outputOption$2 },
+  { agentId: agentIdArg$4, org: orgOption, output: outputOption$3 },
   ({ agentId, org, output }) => gen(function* () {
     const api = yield* ApiService;
     const orgSlug = yield* resolveOrgSlug(org, api);
@@ -95245,7 +95278,7 @@ const adminAgentCommand = make$4("agent", {}).pipe(
   withSubcommands(adminAgentSubcommands)
 );
 
-const typeOption = text("type").pipe(
+const typeOption$1 = text("type").pipe(
   withDescription$3("Filter by event type"),
   optional
 );
@@ -95255,7 +95288,7 @@ const pageOption$3 = integer("page").pipe(
 );
 const listCommand$a = make$4(
   "list",
-  { org: orgOption, type: typeOption, page: pageOption$3 },
+  { org: orgOption, type: typeOption$1, page: pageOption$3 },
   ({ org, type, page }) => gen(function* () {
     const api = yield* ApiService;
     const orgSlug = yield* resolveOrgSlug(org, api);
@@ -95419,7 +95452,7 @@ const deleteCommand$5 = make$4(
 ).pipe(withDescription("Delete an integration by ID (requires --force to confirm)"));
 
 const integrationIdArg$3 = text$2({ name: "id" }).pipe(withDescription$5("Integration ID"));
-const getCommand$6 = make$4(
+const getCommand$7 = make$4(
   "get",
   { integrationId: integrationIdArg$3, org: orgOption },
   ({ integrationId, org }) => gen(function* () {
@@ -95563,7 +95596,7 @@ const updateCommand$2 = make$4(
 
 const adminIntegrationCommandDescription = "Admin integration management (get, update, delete, tools, available)";
 const adminIntegrationSubcommands = [
-  getCommand$6,
+  getCommand$7,
   updateCommand$2,
   deleteCommand$5,
   toolsCommand,
@@ -95873,14 +95906,14 @@ const deleteCommand$4 = make$4(
 const idArg$6 = text$2({ name: "id" }).pipe(
   withDescription$5("Preset ID")
 );
-const jsonOption$c = boolean("json").pipe(
+const jsonOption$h = boolean("json").pipe(
   withDescription$3("Output in JSON format"),
   withDefault(false)
 );
 const formatPresetPrompt = maskSensitiveText;
-const getCommand$5 = make$4(
+const getCommand$6 = make$4(
   "get",
-  { id: idArg$6, org: orgOption, json: jsonOption$c },
+  { id: idArg$6, org: orgOption, json: jsonOption$h },
   ({ id, org, json }) => gen(function* () {
     const api = yield* ApiService;
     yield* resolveOrgSlug(org, api);
@@ -95927,7 +95960,7 @@ const getCommand$5 = make$4(
   })
 ).pipe(withDescription("Get preset details by ID"));
 
-const jsonOption$b = boolean("json").pipe(
+const jsonOption$g = boolean("json").pipe(
   withDescription$3(
     'Output in JSON format: [{"id":"string","name":"string","isDefault":"boolean","prompt":"string|null","createdAt":"ISO-8601","updatedAt":"ISO-8601"}]'
   ),
@@ -95939,7 +95972,7 @@ function formatPresetListPrompt(prompt) {
 }
 const listCommand$9 = make$4(
   "list",
-  { org: orgOption, json: jsonOption$b },
+  { org: orgOption, json: jsonOption$g },
   ({ org, json }) => gen(function* () {
     const api = yield* ApiService;
     const orgSlug = yield* resolveOrgSlug(org, api);
@@ -96165,7 +96198,7 @@ const updateCommand$1 = make$4(
 const presetCommandDescription = "Manage presets (list, get, create, update, rename, delete, set-default, unset-default, regen-key, regen-static-key)";
 const presetSubcommands = [
   listCommand$9,
-  getCommand$5,
+  getCommand$6,
   createCommand$1,
   updateCommand$1,
   renameCommand$1,
@@ -96286,14 +96319,14 @@ const cloneBuiltInCommand = make$4(
 ).pipe(withDescription("Clone built-in skills from the library to your organization"));
 
 const skillIdArg$4 = text$2({ name: "id" }).pipe(withDescription$5("Skill ID to download"));
-const outputOption$1 = text("output").pipe(
+const outputOption$2 = text("output").pipe(
   withAlias("o"),
   withDescription$3("Output file path (defaults to original filename)"),
   optional
 );
 const downloadCommand$1 = make$4(
   "download",
-  { skillId: skillIdArg$4, org: orgOption, output: outputOption$1 },
+  { skillId: skillIdArg$4, org: orgOption, output: outputOption$2 },
   ({ skillId, org, output }) => gen(function* () {
     const api = yield* ApiService;
     const orgSlug = yield* resolveOrgSlug(org, api);
@@ -96372,7 +96405,7 @@ const applyOption = boolean("apply").pipe(
   withDescription$3("Apply the prepared GitHub update immediately"),
   withDefault(false)
 );
-const jsonOption$a = boolean("json").pipe(
+const jsonOption$f = boolean("json").pipe(
   withDescription$3("Output in JSON format"),
   withDefault(false)
 );
@@ -96411,7 +96444,7 @@ const discardPreparedSkill = (api, orgSlug, preparedSkillId) => api.abortAdminUp
 );
 const inspectCommand = make$4(
   "inspect",
-  { githubUrl: githubUrlArg, org: orgOption, patEnv: patEnvOption, json: jsonOption$a },
+  { githubUrl: githubUrlArg, org: orgOption, patEnv: patEnvOption, json: jsonOption$f },
   ({ githubUrl, org, patEnv, json }) => gen(function* () {
     const api = yield* ApiService;
     const orgSlug = yield* resolveOrgSlug(org, api);
@@ -96443,7 +96476,7 @@ const inspectCommand = make$4(
 ).pipe(withDescription("Inspect a GitHub repository for skill import"));
 const importCommand = make$4(
   "import",
-  { githubUrl: githubUrlArg, org: orgOption, patEnv: patEnvOption, overwrite: overwriteOption$2, json: jsonOption$a },
+  { githubUrl: githubUrlArg, org: orgOption, patEnv: patEnvOption, overwrite: overwriteOption$2, json: jsonOption$f },
   ({ githubUrl, org, patEnv, overwrite, json }) => gen(function* () {
     const api = yield* ApiService;
     const orgSlug = yield* resolveOrgSlug(org, api);
@@ -96481,7 +96514,7 @@ const importCommand = make$4(
 ).pipe(withDescription("Import a skill from GitHub"));
 const syncCommand = make$4(
   "sync",
-  { skillId: skillIdArg$3, org: orgOption, apply: applyOption, json: jsonOption$a },
+  { skillId: skillIdArg$3, org: orgOption, apply: applyOption, json: jsonOption$f },
   ({ skillId, org, apply, json }) => gen(function* () {
     const api = yield* ApiService;
     const orgSlug = yield* resolveOrgSlug(org, api);
@@ -96594,7 +96627,7 @@ const pageSizeOption = integer("page-size").pipe(
   withDescription$3("Page size (default: 20)"),
   optional
 );
-const jsonOption$9 = boolean("json").pipe(
+const jsonOption$e = boolean("json").pipe(
   withDescription$3("Output in JSON format"),
   withDefault(false)
 );
@@ -96611,7 +96644,7 @@ const overwriteOption$1 = boolean("overwrite").pipe(
 );
 const listCommand$8 = make$4(
   "list",
-  { org: orgOption, search: searchOption$2, page: pageOption$2, pageSize: pageSizeOption, json: jsonOption$9 },
+  { org: orgOption, search: searchOption$2, page: pageOption$2, pageSize: pageSizeOption, json: jsonOption$e },
   ({ org, search, page, pageSize, json }) => gen(function* () {
     const api = yield* ApiService;
     const orgSlug = yield* resolveOrgSlug(org, api);
@@ -96670,9 +96703,9 @@ const listCommand$8 = make$4(
     }
   })
 ).pipe(withDescription("List organization-wide skills"));
-const getCommand$4 = make$4(
+const getCommand$5 = make$4(
   "get",
-  { skillId: skillIdArg$2, org: orgOption, json: jsonOption$9 },
+  { skillId: skillIdArg$2, org: orgOption, json: jsonOption$e },
   ({ skillId, org, json }) => gen(function* () {
     const api = yield* ApiService;
     const orgSlug = yield* resolveOrgSlug(org, api);
@@ -96863,7 +96896,7 @@ const unpublishCommand = make$4(
 const adminSkillCommandDescription = "Admin skill management (list, get, upload, download, delete, publish, unpublish, built-in, clone-built-in, github)";
 const adminSkillSubcommands = [
   listCommand$8,
-  getCommand$4,
+  getCommand$5,
   uploadCommand$2,
   downloadCommand$1,
   deleteCommand$3,
@@ -97283,7 +97316,7 @@ const agentIdOption = optional(
     withDescription$3("Agent installation ID (UUID) to chat with. Required when starting a new chat.")
   )
 );
-const messageOption = optional(
+const messageOption$2 = optional(
   text("message").pipe(
     withAlias("m"),
     withDescription$3("Message to send to the agent (if not provided, reads from stdin when piped)")
@@ -97294,7 +97327,7 @@ const conversationIdOption = optional(
     withDescription$3("Continue an existing conversation by ID (from a previous --json result)")
   )
 );
-const jsonOption$8 = boolean("json").pipe(
+const jsonOption$d = boolean("json").pipe(
   withDescription$3('Output in JSON format: {"text":"string","conversationId":"string"}'),
   withDefault(false)
 );
@@ -97308,7 +97341,7 @@ const readStdin = () => tryPromise({
   },
   catch: (e) => new ApiError({ message: `Failed to read stdin: ${e instanceof Error ? e.message : String(e)}` })
 });
-const SPINNER_FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
+const SPINNER_FRAMES$1 = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
 const SPINNER_MESSAGES = ["thinking", "churning", "processing", "pondering", "working", "computing"];
 const formatAgentChatTextOutput = maskSensitiveText;
 const startSpinner = () => {
@@ -97316,22 +97349,22 @@ const startSpinner = () => {
   let frameIdx = 0;
   let msgIdx = 0;
   const timer = setInterval(() => {
-    frameIdx = (frameIdx + 1) % SPINNER_FRAMES.length;
+    frameIdx = (frameIdx + 1) % SPINNER_FRAMES$1.length;
     if (frameIdx === 0) msgIdx = (msgIdx + 1) % SPINNER_MESSAGES.length;
-    process.stderr.write(`\r${SPINNER_FRAMES[frameIdx]} ${SPINNER_MESSAGES[msgIdx]}...   `);
+    process.stderr.write(`\r${SPINNER_FRAMES$1[frameIdx]} ${SPINNER_MESSAGES[msgIdx]}...   `);
   }, 80);
   return () => {
     clearInterval(timer);
     process.stderr.write("\r" + " ".repeat(30) + "\r");
   };
 };
-const chatCommand$1 = make$4(
+const chatCommand$2 = make$4(
   "chat",
   {
     agentId: agentIdOption,
-    message: messageOption,
+    message: messageOption$2,
     conversationId: conversationIdOption,
-    json: jsonOption$8,
+    json: jsonOption$d,
     org: orgOption
   },
   ({ agentId, message, conversationId, json, org }) => gen(function* () {
@@ -97411,15 +97444,15 @@ const resolveAgentChatTarget = (agentId, conversationId) => {
 const isContinuationTarget = (target) => target.conversationId !== void 0;
 
 const agentIdArg$1 = text$2({ name: "id" }).pipe(withDescription$5("Agent ID"));
-const jsonOption$7 = boolean("json").pipe(
+const jsonOption$c = boolean("json").pipe(
   withDescription$3(
     'Output in JSON format: {"id":"string","displayName":"string","shortDescription":"string","description":"string|null","createdBy":"string","createdAt":"ISO-8601","updatedAt":"ISO-8601","configRequiredIntegrations":["string"]}'
   ),
   withDefault(false)
 );
-const getCommand$3 = make$4(
+const getCommand$4 = make$4(
   "get",
-  { agentId: agentIdArg$1, org: orgOption, json: jsonOption$7 },
+  { agentId: agentIdArg$1, org: orgOption, json: jsonOption$c },
   ({ agentId, org, json }) => gen(function* () {
     const api = yield* ApiService;
     const orgSlug = yield* resolveOrgSlug(org, api);
@@ -97463,7 +97496,7 @@ const getCommand$3 = make$4(
   })
 ).pipe(withDescription("Get agent details by ID"));
 
-const jsonOption$6 = boolean("json").pipe(
+const jsonOption$b = boolean("json").pipe(
   withDescription$3(
     'Output in JSON format: [{"id":"string","displayName":"string","agentType":"string","shortDescription":"string","createdBy":"string","createdAt":"ISO-8601"}]'
   ),
@@ -97471,7 +97504,7 @@ const jsonOption$6 = boolean("json").pipe(
 );
 const listCommand$7 = make$4(
   "list",
-  { org: orgOption, json: jsonOption$6 },
+  { org: orgOption, json: jsonOption$b },
   ({ org, json }) => gen(function* () {
     const api = yield* ApiService;
     const orgSlug = yield* resolveOrgSlug(org, api);
@@ -97578,7 +97611,7 @@ const disableCommand$1 = make$4(
 ).pipe(withDescription("Disable an agent"));
 
 const agentCommandDescription = "Manage agents (list, get, chat, enable, disable)";
-const agentSubcommands = [listCommand$7, getCommand$3, enableCommand$1, disableCommand$1, chatCommand$1];
+const agentSubcommands = [listCommand$7, getCommand$4, enableCommand$1, disableCommand$1, chatCommand$2];
 const agentCommand = make$4("agent", {}).pipe(
   withDescription(agentCommandDescription),
   withSubcommands(agentSubcommands)
@@ -98133,16 +98166,16 @@ const deleteCommand$2 = make$4(
 ).pipe(withDescription("Delete an automation by ID (requires --force to confirm)"));
 
 const automationIdArg$5 = text$2({ name: "id" }).pipe(withDescription$5("Automation ID"));
-const jsonOption$5 = boolean("json").pipe(
+const jsonOption$a = boolean("json").pipe(
   withDescription$3(
     'Output in JSON format: {"id":"string","name":"string","status":"string","triggerType":"string","triggerProviderType":"string","agentId":"string","prompt":"string","lastExecutionTime":"ISO-8601|null","lastExecutionStatus":"string|null","lastExecutionChatThreadUrl":"string|null","nextExecutionTime":"ISO-8601|null","trigger":"object","createdAt":"ISO-8601","updatedAt":"ISO-8601"}'
   ),
   withDefault(false)
 );
 const formatAutomationTextOutput = maskSensitiveText;
-const getCommand$2 = make$4(
+const getCommand$3 = make$4(
   "get",
-  { automationId: automationIdArg$5, org: orgOption, json: jsonOption$5 },
+  { automationId: automationIdArg$5, org: orgOption, json: jsonOption$a },
   ({ automationId, org, json }) => gen(function* () {
     const api = yield* ApiService;
     const orgSlug = yield* resolveOrgSlug(org, api);
@@ -98253,7 +98286,7 @@ const nameOption = text("name").pipe(
   withDescription$3("Filter automations by name"),
   optional
 );
-const jsonOption$4 = boolean("json").pipe(
+const jsonOption$9 = boolean("json").pipe(
   withDescription$3(
     'Output in JSON format: [{"id":"string","name":"string","status":"string","triggerType":"string","nextExecutionTime":"ISO-8601|null","createdAt":"ISO-8601"}]'
   ),
@@ -98261,7 +98294,7 @@ const jsonOption$4 = boolean("json").pipe(
 );
 const listCommand$6 = make$4(
   "list",
-  { org: orgOption, name: nameOption, json: jsonOption$4 },
+  { org: orgOption, name: nameOption, json: jsonOption$9 },
   ({ org, name, json }) => gen(function* () {
     const api = yield* ApiService;
     const orgSlug = yield* resolveOrgSlug(org, api);
@@ -98564,7 +98597,7 @@ const webhookRegenCommand = make$4(
 const automationCommandDescription = "Manage automations (list, get, create, update, delete, run, enable, disable, history, cancel, webhook-regen, triggers)";
 const automationSubcommands = [
   listCommand$6,
-  getCommand$2,
+  getCommand$3,
   createCommand,
   updateCommand,
   deleteCommand$2,
@@ -98584,7 +98617,7 @@ const automationCommand = make$4("automation", {}).pipe(
 const conversationIdArg$1 = text$2({ name: "conversationId" }).pipe(
   withDescription$5("Conversation ID")
 );
-const getCommand$1 = make$4(
+const getCommand$2 = make$4(
   "get",
   { conversationId: conversationIdArg$1, org: orgOption },
   ({ conversationId, org }) => gen(function* () {
@@ -98623,7 +98656,7 @@ const getCommand$1 = make$4(
   })
 ).pipe(withDescription("Get conversation details by ID"));
 
-const jsonOption$3 = boolean("json").pipe(
+const jsonOption$8 = boolean("json").pipe(
   withDescription$3(
     'Output in JSON format: [{"conversationId":"string","title":"string","type":"string","updatedAt":"ISO-8601"}]'
   ),
@@ -98631,7 +98664,7 @@ const jsonOption$3 = boolean("json").pipe(
 );
 const listCommand$5 = make$4(
   "list",
-  { org: orgOption, json: jsonOption$3 },
+  { org: orgOption, json: jsonOption$8 },
   ({ org, json }) => gen(function* () {
     const api = yield* ApiService;
     const orgSlug = yield* resolveOrgSlug(org, api);
@@ -98723,9 +98756,174 @@ const messagesCommand = make$4(
   })
 ).pipe(withDescription("List messages in a conversation"));
 
-const chatCommandDescription = "Manage conversations (list, get, messages)";
-const chatSubcommands = [listCommand$5, getCommand$1, messagesCommand];
-const chatCommand = make$4("chat", {}).pipe(
+const filterModelExecModels = (catalog, type) => {
+  if (!type) {
+    return catalog.models;
+  }
+  return catalog.models.filter((model) => model.type === type);
+};
+const getModelExecInputSchema = (model) => {
+  if (model.inputSchema) {
+    return model.inputSchema;
+  }
+  if (model.type === "image-generation") {
+    return {
+      type: "object",
+      required: ["prompt"],
+      properties: {
+        prompt: { type: "string" },
+        options: {
+          type: "object",
+          properties: {
+            size: { type: "string" },
+            n: { type: "integer" }
+          }
+        }
+      }
+    };
+  }
+  return {
+    type: "object",
+    required: ["input"],
+    properties: {
+      input: {
+        type: "object",
+        required: ["text"],
+        properties: {
+          text: { type: "string" }
+        }
+      },
+      options: { type: "object" }
+    }
+  };
+};
+const buildModelExecSampleInput = (model) => {
+  if (model.type === "image-generation") {
+    return {
+      prompt: "A small robot reading a book",
+      options: { size: "1024x1024", n: 1 }
+    };
+  }
+  return {
+    input: { text: "Say hello in one sentence." },
+    options: {}
+  };
+};
+const buildModelExecChatRequest = (model, input) => ({
+  model,
+  input
+});
+const buildModelExecImageGenerationRequest = (model, input) => ({
+  model,
+  prompt: input.prompt,
+  ...input.options ? { options: input.options } : {}
+});
+const readJsonInputFile = (path) => tryPromise({
+  try: async () => JSON.parse(await fs$1.readFile(path, "utf8")),
+  catch: (error) => new ApiError({
+    message: `Failed to read JSON input "${path}": ${error instanceof Error ? error.message : String(error)}`
+  })
+});
+const saveJsonFile = (path, value) => tryPromise({
+  try: async () => {
+    await fs$1.writeFile(path, `${JSON.stringify(value, null, 2)}
+`, "utf8");
+  },
+  catch: (error) => new ApiError({
+    message: `Failed to write "${path}": ${error instanceof Error ? error.message : String(error)}`
+  })
+});
+const readStdinText = () => tryPromise({
+  try: async () => {
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+      chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+    }
+    return Buffer.concat(chunks).toString("utf8").trim();
+  },
+  catch: (error) => new ApiError({
+    message: `Failed to read stdin: ${error instanceof Error ? error.message : String(error)}`
+  })
+});
+
+const messageOption$1 = optional(
+  text("message").pipe(
+    withAlias("m"),
+    withDescription$3("Message text. If omitted, stdin is used when piped.")
+  )
+);
+const conversationOption = optional(
+  text("conversation").pipe(
+    withDescription$3("Conversation ID to continue")
+  )
+);
+const modelOption$2 = optional(
+  text("model").pipe(withDescription$3("Chat model ID for a new or continued conversation"))
+);
+const jsonOption$7 = boolean("json").pipe(
+  withDescription$3("Output full response as JSON"),
+  withDefault(false)
+);
+const buildSendChatMessageRequest = (input) => ({
+  conversationId: getOrUndefined(input.conversationId),
+  model: getOrUndefined(input.model),
+  message: { text: input.text }
+});
+const sendCommand = make$4(
+  "send",
+  {
+    message: messageOption$1,
+    conversation: conversationOption,
+    model: modelOption$2,
+    json: jsonOption$7,
+    org: orgOption
+  },
+  ({ message, conversation, model, json, org }) => gen(function* () {
+    const api = yield* ApiService;
+    const orgSlug = yield* resolveOrgSlug(org, api);
+    const text = yield* resolveMessageText(message);
+    const request = buildSendChatMessageRequest({ conversationId: conversation, model, text });
+    const result = yield* api.sendChatMessage(orgSlug, request).pipe(
+      catchTag(
+        "NotLoggedInError",
+        (error) => gen(function* () {
+          yield* error$1(error.message);
+          return yield* fail$3(error);
+        })
+      ),
+      catchTag(
+        "ApiError",
+        (error) => gen(function* () {
+          yield* error$1(`Chat send failed: ${error.message}`);
+          return yield* fail$3(error);
+        })
+      )
+    );
+    if (json) {
+      yield* log(jsonFormat(result));
+      return;
+    }
+    yield* log(maskSensitiveText(result.output.text));
+    yield* log(`
+Conversation: ${result.conversationId}`);
+  })
+).pipe(withDescription("Send a conversation-based chat message and print the assistant response"));
+const resolveMessageText = (message) => gen(function* () {
+  if (isSome(message)) {
+    return message.value;
+  }
+  if (!process.stdin.isTTY) {
+    const text = yield* readStdinText();
+    if (text) {
+      return text;
+    }
+  }
+  return yield* fail$3(new ApiError({ message: "Provide --message/-m or pipe text through stdin." }));
+});
+
+const chatCommandDescription = "Manage conversations (list, get, messages, send)";
+const chatSubcommands = [listCommand$5, getCommand$2, messagesCommand, sendCommand];
+const chatCommand$1 = make$4("chat", {}).pipe(
   withDescription(chatCommandDescription),
   withSubcommands(chatSubcommands)
 );
@@ -98882,13 +99080,13 @@ const deleteCommand$1 = make$4(
 ).pipe(withDescription("Delete drive entries by ID (requires --force to confirm)"));
 
 const entryIdArg$1 = text$2({ name: "id" }).pipe(withDescription$5("Drive entry ID"));
-const outputOption = text("output").pipe(
+const outputOption$1 = text("output").pipe(
   withAlias("o"),
   withDescription$3("Output file path (required, as the API does not return the original filename)")
 );
 const downloadCommand = make$4(
   "download",
-  { entryId: entryIdArg$1, org: orgOption, output: outputOption },
+  { entryId: entryIdArg$1, org: orgOption, output: outputOption$1 },
   ({ entryId, org, output }) => gen(function* () {
     const api = yield* ApiService;
     const orgSlug = yield* resolveOrgSlug(org, api);
@@ -99309,6 +99507,347 @@ const modelCommand = make$4("model", {}).pipe(
   withSubcommands(modelSubcommands)
 );
 
+const SPINNER_FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
+const SPINNER_INTERVAL_MS = 80;
+const CLEAR_WIDTH = 80;
+const startModelExecProgress = (message, options = {}) => {
+  const stream = options.stream ?? process.stderr;
+  if (!stream.isTTY) return () => void 0;
+  const now = options.now ?? Date.now;
+  const startedAt = now();
+  let frameIndex = 0;
+  let stopped = false;
+  const render = () => {
+    const elapsedSeconds = Math.floor((now() - startedAt) / 1e3);
+    stream.write(`\r${SPINNER_FRAMES[frameIndex]} ${message}... ${elapsedSeconds}s`);
+    frameIndex = (frameIndex + 1) % SPINNER_FRAMES.length;
+  };
+  render();
+  const timer = setInterval(render, SPINNER_INTERVAL_MS);
+  return () => {
+    if (stopped) return;
+    stopped = true;
+    clearInterval(timer);
+    stream.write(`\r${" ".repeat(CLEAR_WIDTH)}\r`);
+  };
+};
+
+const modelOption$1 = text("model").pipe(withDescription$3("Chat model ID"));
+const messageOption = optional(
+  text("message").pipe(
+    withAlias("m"),
+    withDescription$3("Message text. If omitted, stdin is used when piped.")
+  )
+);
+const inputOption$1 = optional(
+  text("input").pipe(withDescription$3("JSON input file generated by model-exec sample"))
+);
+const jsonOption$6 = boolean("json").pipe(
+  withDescription$3("Output full response as JSON"),
+  withDefault(false)
+);
+const chatCommand = make$4(
+  "chat",
+  { model: modelOption$1, message: messageOption, input: inputOption$1, json: jsonOption$6, org: orgOption },
+  ({ model, message, input, json, org }) => gen(function* () {
+    const api = yield* ApiService;
+    const orgSlug = yield* resolveOrgSlug(org, api);
+    const request = yield* resolveChatRequest(model, message, input);
+    const stopProgress = startModelExecProgress("Waiting for model response");
+    const result = yield* api.executeModelExecChat(orgSlug, request).pipe(
+      ensuring$1(sync$1(stopProgress)),
+      catchTag(
+        "NotLoggedInError",
+        (error) => gen(function* () {
+          yield* error$1(error.message);
+          return yield* fail$3(error);
+        })
+      ),
+      catchTag(
+        "ApiError",
+        (error) => gen(function* () {
+          yield* error$1(`Model-exec chat failed: ${error.message}`);
+          return yield* fail$3(error);
+        })
+      )
+    );
+    if (json) {
+      yield* log(jsonFormat(result));
+      return;
+    }
+    yield* log(maskSensitiveText(result.output.text));
+  })
+).pipe(withDescription("Execute a chat model once without creating a conversation"));
+const resolveChatRequest = (model, message, input) => gen(function* () {
+  if (isSome(input)) {
+    const parsed = yield* readJsonInputFile(input.value);
+    const text = parsed.input?.text;
+    if (!text) {
+      return yield* fail$3(new ApiError({ message: "Chat input JSON must include input.text" }));
+    }
+    return {
+      model,
+      input: { ...parsed.input, text },
+      ...parsed.options ? { options: parsed.options } : {}
+    };
+  }
+  if (isSome(message)) {
+    return buildModelExecChatRequest(model, { text: message.value });
+  }
+  if (!process.stdin.isTTY) {
+    const text = yield* readStdinText();
+    if (text) {
+      return buildModelExecChatRequest(model, { text });
+    }
+  }
+  return yield* fail$3(new ApiError({ message: "Provide --message/-m, --input, or pipe text through stdin." }));
+});
+
+const modelIdArg$1 = text$2({ name: "model-id" }).pipe(withDescription$5("Model ID"));
+const jsonOption$5 = boolean("json").pipe(
+  withDescription$3("Output model detail as JSON"),
+  withDefault(false)
+);
+const getCommand$1 = make$4(
+  "get",
+  { modelId: modelIdArg$1, org: orgOption, json: jsonOption$5 },
+  ({ modelId, org, json }) => gen(function* () {
+    const api = yield* ApiService;
+    const orgSlug = yield* resolveOrgSlug(org, api);
+    const catalog = yield* api.listModelExecModels(orgSlug).pipe(
+      catchTag(
+        "NotLoggedInError",
+        (error) => gen(function* () {
+          yield* error$1(error.message);
+          return yield* fail$3(error);
+        })
+      ),
+      catchTag(
+        "ApiError",
+        (error) => gen(function* () {
+          yield* error$1(`Failed to fetch model "${modelId}": ${error.message}`);
+          return yield* fail$3(error);
+        })
+      )
+    );
+    const model = catalog.models.find((item) => item.id === modelId);
+    if (!model) {
+      const error = new ApiError({ message: `Model "${modelId}" not found.`, statusCode: 404 });
+      yield* error$1(error.message);
+      return yield* fail$3(error);
+    }
+    const detail = { ...model, inputSchema: getModelExecInputSchema(model) };
+    if (json) {
+      yield* log(jsonFormat(detail));
+      return;
+    }
+    yield* log(`Model: ${detail.id}`);
+    yield* log(`  Type: ${detail.type}`);
+    if (detail.displayName) yield* log(`  Name: ${detail.displayName}`);
+    yield* log("  Input schema:");
+    yield* log(jsonFormat(detail.inputSchema));
+  })
+).pipe(withDescription("Show model-exec model detail and input schema"));
+
+const modelOption = text("model").pipe(withDescription$3("Image-generation model ID"));
+const promptOption = optional(
+  text("prompt").pipe(withDescription$3("Image prompt"))
+);
+const inputOption = optional(
+  text("input").pipe(withDescription$3("JSON input file generated by model-exec sample"))
+);
+const outputOption = text("output").pipe(withDescription$3("Output image file path"));
+const jsonOption$4 = boolean("json").pipe(
+  withDescription$3("Output full response as JSON after saving the image"),
+  withDefault(false)
+);
+const generateCommand = make$4(
+  "generate",
+  {
+    model: modelOption,
+    prompt: promptOption,
+    input: inputOption,
+    output: outputOption,
+    json: jsonOption$4,
+    org: orgOption
+  },
+  ({ model, prompt, input, output, json, org }) => gen(function* () {
+    const api = yield* ApiService;
+    const orgSlug = yield* resolveOrgSlug(org, api);
+    const request = yield* resolveImageRequest(model, prompt, input);
+    const stopProgress = startModelExecProgress("Generating image (timeout: 5m)");
+    const result = yield* gen(function* () {
+      const response = yield* api.executeModelExecImageGeneration(orgSlug, request);
+      const first = response.outputs[0];
+      if (!first) {
+        return yield* fail$3(new ApiError({ message: "Image generation returned no outputs." }));
+      }
+      const buffer = yield* api.downloadFromUrl(first.downloadUrl);
+      yield* writeImageFile(output, buffer);
+      return response;
+    }).pipe(
+      ensuring$1(sync$1(stopProgress)),
+      catchTag(
+        "NotLoggedInError",
+        (error) => gen(function* () {
+          yield* error$1(error.message);
+          return yield* fail$3(error);
+        })
+      ),
+      catchTag(
+        "ApiError",
+        (error) => gen(function* () {
+          yield* error$1(`Image generation failed: ${error.message}`);
+          return yield* fail$3(error);
+        })
+      )
+    );
+    if (json) {
+      yield* log(jsonFormat({ ...result, savedPath: output }));
+      return;
+    }
+    yield* log(`Saved image to ${output}`);
+  })
+).pipe(
+  withDescription(
+    "Generate an image once and save the first output artifact (5-minute timeout)"
+  )
+);
+const imageCommand = make$4("image", {}).pipe(
+  withDescription("Run image-generation model-exec commands"),
+  withSubcommands([generateCommand])
+);
+const resolveImageRequest = (model, prompt, input) => gen(function* () {
+  if (isSome(input)) {
+    const parsed = yield* readJsonInputFile(input.value);
+    if (!parsed.prompt) {
+      return yield* fail$3(new ApiError({ message: "Image input JSON must include prompt" }));
+    }
+    return buildModelExecImageGenerationRequest(model, {
+      prompt: parsed.prompt,
+      ...parsed.options ? { options: parsed.options } : {}
+    });
+  }
+  if (isSome(prompt)) {
+    return buildModelExecImageGenerationRequest(model, { prompt: prompt.value });
+  }
+  return yield* fail$3(new ApiError({ message: "Provide --prompt or --input." }));
+});
+const writeImageFile = (path, buffer) => tryPromise({
+  try: async () => {
+    await fs$1.writeFile(path, buffer);
+  },
+  catch: (error) => new ApiError({
+    message: `Failed to write image "${path}": ${error instanceof Error ? error.message : String(error)}`
+  })
+});
+
+const typeOption = optional(
+  text("type").pipe(
+    withDescription$3("Filter by model type: chat, image-generation, embedding")
+  )
+);
+const jsonOption$3 = boolean("json").pipe(
+  withDescription$3("Output model catalog as JSON"),
+  withDefault(false)
+);
+const modelsCommand = make$4(
+  "models",
+  { org: orgOption, type: typeOption, json: jsonOption$3 },
+  ({ org, type, json }) => gen(function* () {
+    const api = yield* ApiService;
+    const orgSlug = yield* resolveOrgSlug(org, api);
+    const catalog = yield* api.listModelExecModels(orgSlug).pipe(
+      catchTag(
+        "NotLoggedInError",
+        (error) => gen(function* () {
+          yield* error$1(error.message);
+          return yield* fail$3(error);
+        })
+      ),
+      catchTag(
+        "ApiError",
+        (error) => gen(function* () {
+          yield* error$1(`Failed to fetch model-exec models: ${error.message}`);
+          return yield* fail$3(error);
+        })
+      )
+    );
+    const models = filterModelExecModels(catalog, getOrUndefined(type));
+    if (json) {
+      yield* log(jsonFormat({ ...catalog, models }));
+      return;
+    }
+    if (models.length === 0) {
+      yield* log("No model-exec models available.");
+      return;
+    }
+    yield* log(`Model-exec models in organization "${orgSlug}":
+`);
+    for (const model of models) {
+      const name = model.displayName ? ` (${model.displayName})` : "";
+      const marker = model.default ? " default" : "";
+      yield* log(`  ${model.id}${name}`);
+      yield* log(`    Type: ${model.type}${marker}`);
+    }
+  })
+).pipe(withDescription("List experimental model-exec models by capability"));
+
+const modelIdArg = text$2({ name: "model-id" }).pipe(withDescription$5("Model ID"));
+const saveOption = optional(
+  text("save").pipe(withDescription$3("Save sample JSON to a file"))
+);
+const sampleCommand = make$4(
+  "sample",
+  { modelId: modelIdArg, org: orgOption, save: saveOption },
+  ({ modelId, org, save }) => gen(function* () {
+    const api = yield* ApiService;
+    const orgSlug = yield* resolveOrgSlug(org, api);
+    const catalog = yield* api.listModelExecModels(orgSlug).pipe(
+      catchTag(
+        "NotLoggedInError",
+        (error) => gen(function* () {
+          yield* error$1(error.message);
+          return yield* fail$3(error);
+        })
+      ),
+      catchTag(
+        "ApiError",
+        (error) => gen(function* () {
+          yield* error$1(`Failed to fetch model "${modelId}": ${error.message}`);
+          return yield* fail$3(error);
+        })
+      )
+    );
+    const model = catalog.models.find((item) => item.id === modelId);
+    if (!model) {
+      const error = new ApiError({ message: `Model "${modelId}" not found.`, statusCode: 404 });
+      yield* error$1(error.message);
+      return yield* fail$3(error);
+    }
+    const sample = buildModelExecSampleInput(model);
+    if (isSome(save)) {
+      yield* saveJsonFile(save.value, sample);
+      yield* log(`Saved sample input to ${save.value}`);
+      return;
+    }
+    yield* log(jsonFormat(sample));
+  })
+).pipe(withDescription("Generate sample JSON input for a model-exec model"));
+
+const modelExecCommandDescription = "Experimental one-shot model execution for chat and image-generation models";
+const modelExecSubcommands = [
+  modelsCommand,
+  getCommand$1,
+  sampleCommand,
+  chatCommand,
+  imageCommand
+];
+const modelExecCommand = make$4("model-exec", {}).pipe(
+  withDescription(modelExecCommandDescription),
+  withSubcommands(modelExecSubcommands)
+);
+
 const capabilitiesCommand = make$4(
   "capabilities",
   { org: orgOption },
@@ -100001,11 +100540,12 @@ const rootSubcommands = [
   agentCommand,
   authCommand,
   automationCommand,
-  chatCommand,
+  chatCommand$1,
   configCommand,
   driveCommand,
   integrationCommand,
   modelCommand,
+  modelExecCommand,
   orgCommand,
   skillCommand,
   ...nativeSubcommands

package/docs/api-contract-inventory.md

@@ -58,6 +58,7 @@
 | P0-DRIVE-02 | drive | `aipctl drive upload` | `createDriveUploadUrl` → `uploadToS3` → `completeDriveUpload` | api + external | `POST` → `PUT` → `POST` | `/drive/entries/upload-url`; external presigned `uploadUrl`; `/drive/entries/{entryId}/complete` | official upload request `{ parentId: null, filename, fileSize, mimeType }` | official `CreateDriveUploadUrlResponse { id, filename, uploadUrl, headers }` then `void` | `resource/oas/modules/backend/organization/storage/openapi.yaml` | `frontend/packages/api/src/out/modules/organization-storage-types.ts#paths["/api/web/organizations/slug/{organizationSlug}/drive/entries/upload-url"]`, `#paths["/api/web/organizations/slug/{organizationSlug}/drive/entries/{entryId}/complete"]` | `generated-ready` | `P0` | `migrate` | none | `AIP-PUB-05` | updated `src/core/api.test.ts`, `commands/drive/drive.test.ts`; covers `parentId: null` request and response `id`/`filename` usage |
 | P1-INT-01 | integration | `aipctl integration list`, `test`; `aipctl admin integration get`, `update`, `delete`, `tools`, `available` | `listIntegrations`, `testIntegration`, `getIntegration`, `updateIntegration`, `deleteIntegration`, `listIntegrationTools`, `listConfigurableIntegrations` | api | `GET`, `POST`, `GET`, `PUT`, `DELETE`, `GET`, `GET` | `/api/web/integrations/v2`; `/api/web/integration/{integrationId}/test`; `/api/web/admin/organizations/slug/{organizationSlug}/integrations/{integrationId}`; `/{integrationId}/tools`; `/configurable-integrations` | top-level list/test and admin detail/available now follow current/legacy OAS path+body+DTO where available; admin update/delete still accept untyped legacy mutation body/path until admin mutation contract lands | local `Integration`, `IntegrationDetail`, `IntegrationToolsResponse`, `ConfigurableIntegration[]` | legacy admin paths: `resource/oas/duplo-web.yaml`; partial modern source: `resource/oas/modules/backend/integration/openapi.yaml` (does not cover these admin list/CRUD/tools paths) | legacy `frontend/packages/api/src/out/user-types.ts#paths["/api/web/admin/organizations/slug/{organizationSlug}/integrations"]`, `#paths["/api/web/admin/organizations/slug/{organizationSlug}/configurable-integrations"]`; partial current `frontend/packages/api/src/out/modules/integration-types.ts` lacks these admin list/CRUD/tools paths | `legacy-generated` | `P1` | `legacy-exception` | owner=`backend app Integrations / duplo-web legacy OAS`; rationale=`public beta keeps integration list/test/admin detail/tools/available, but admin update/delete still lack an approved current contract outside legacy duplo-web`; removal condition=`independent contract covers user list/test plus admin CRUD/tools/available`; incorporation plan=`extend integration module or independent contract for list/test/admin CRUD/tools/available, then retire legacy path/body mappings and delete/update exception` | N/A | updated `src/core/api.test.ts`, `commands/integration/integration.test.ts`; covers v2 list query, test body `{ organizationSlug }`, admin detail/tools DTO fields, configurable wrapper unwrap, and pinned update/delete legacy paths |
 | P0-MODEL-01 | model | `aipctl model list` | `listModels` | chat | `GET` | `/api/{orgSlug}/models` | none | CLI maps official `{ models: string[], defaultModel? }` into `Model[]` with optional `isDefault` | `resource/oas/chat.yaml` | `frontend/packages/api/src/out/chat-types.ts#paths["/api/{orgSlug}/models"]` | `legacy-generated` | `P0` | `migrate` | none | `AIP-PUB-05` | updated `src/core/api.test.ts`, `commands/model/model.test.ts`; covers official path and string-array response mapping |
+| P1-MODEL-EXEC-01 | model-exec | `aipctl model-exec models`, `get`, `sample`, `chat`, `image generate` | `listModelExecModels`, `executeModelExecChat`, `executeModelExecImageGeneration`; image output uses `downloadFromUrl` | chat + external artifact URL | `GET`, `POST`, `POST`, external `GET` | `/api/{orgSlug}/cli/model-exec/models`; `/chat`; `/images/generations`; response `downloadUrl` | local `ModelExecChatRequest`, `ModelExecImageGenerationRequest`; Chat DTO source `chat/packages/chat/src/modules/cli-model-exec/interface/dto/cli-model-exec.dto.ts` | local `ModelExecModelCatalog`, `ModelExecChatResponse`, `ModelExecImageGenerationResponse`; image bytes from external URL | not found in current `resource/oas`; implemented by `chat/packages/chat/src/modules/cli-model-exec/interface/cli-model-exec.interface.controller.ts` | none | `oas-missing` | `P1` | `legacy-exception` | owner=`chat CLI Model Exec API`; rationale=`experimental public command is implemented with Chat zod DTOs but no current OAS path`; removal condition=`CLI model-exec paths and DTOs are published in the Chat contract`; incorporation plan=`add the three paths and schemas to the Chat OAS, generate an independent reference, then bind CLI DTO/tests` | `AIP-PUB-05` | existing `src/core/api.test.ts`, `commands/model-exec/model-exec.test.ts`, `commands/model-exec/progress.test.ts`; covers three paths, request bodies, required Chat DTO response fields, helper/progress behavior. Needed: image command response → external download → file write regression test |
 | USAGE-01 | usage | `aipctl admin usage credit`, `top-users`, `daily-graph`, `daily-users`, `mcp-top` | `getCreditStatistics`, `getCreditTopUsers`, `getCreditDailyGraph`, `getCreditDailyUsers`, `getMcpTopTools` | api | `GET` | `/api/web/admin/organizations/slug/{organizationSlug}/usage/...` | query `{ startDt,endDt,limit,pageNumber,pageSize,userId }` | local usage DTOs, `DailyUsageDetailsResponse.pagination { page,pageSize,total }` | `resource/oas/modules/backend/usage/openapi.yaml` | `frontend/packages/api/src/out/modules/usage-types.ts#paths[...]` | `generated-ready` | N/A | `keep` | none | N/A | existing `commands/usage/usage.test.ts`; needed generated path snapshots |
 | AUDIT-01 | audit | `aipctl admin audit list`, `types` | `listAuditLogs`, `listAuditEventTypes` | api | `GET` | `/api/web/audit/organization/slug/{organizationSlug}`; `/api/web/audit/event/types` | query `{ eventType,page,pageSize }` | local `ListAuditResponse`, `AuditEventType[]` | `resource/oas/modules/backend/audit/openapi.yaml` | `frontend/packages/api/src/out/modules/backend-audit-types.ts#paths[...]` | `generated-ready` | N/A | `keep` | none | N/A | existing `commands/audit/audit.test.ts`; needed generated path snapshots |
 | TUNNEL-01 | tunnel | `aipctl admin tunnel status`, `config`, `token` | `getTunnelStatus`, `getTunnelConfig`, `createTunnelToken` | api | `GET`, `GET`, `POST` | `/api/web/edge-tunnel/v2/organizations/slug/{organizationSlug}/status`; `/config`; `/token` | none | local `TunnelStatus`, `TunnelConfig`, `void` | `resource/oas/modules/backend/tunnel/openapi.yaml` | `frontend/packages/api/src/out/modules/tunnel-types.ts#paths[...]` | `generated-ready` | N/A | `keep` | none | N/A | existing `commands/tunnel/tunnel.test.ts`; needed v2 path snapshot |
@@ -82,6 +83,7 @@
 - `P1-PRESET-01` preset admin namespace/docs + legacy path tests done
 - `P1-SKILL-01` skill JSON/help/docs field sync done
 - `P1-CHAT-01` chat SSE fixture tests added for final/fallback/error cases
+- `P1-MODEL-EXEC-01` experimental CLI model-exec contract remains OAS-missing; current Chat controller/DTO and CLI path tests are recorded
 
 ## Manual notes
 

package/docs/architecture.md

@@ -59,7 +59,7 @@ desktop/packages/cli/
 
 - package base version: `0.0.0`
 - publish-time CalVer가 `AIPCTL_VERSION`으로 TS bundle과 Go ldflags에 주입됩니다.
-- `AIPCTL_BUILD_ENV`는 `local|dev|stage|prod|test` 중 하나이며 `logs` gating에 사용됩니다.
+- `AIPCTL_BUILD_ENV`는 `local|dev|qa|stage|prod|test` 중 하나이며 `logs` gating에 사용됩니다.
 - native input hash가 이전 발행본과 같으면 platform package를 새로 빌드하지 않고 기존 version을 재사용합니다.
 
 ## Dependency direction

package/docs/desktop-cli-go-coding-guidelines.md

@@ -4,7 +4,7 @@
 
 공통 규칙은 중앙 문서를 따른다.
 
-- [docs/rules/go-coding-guidelines.md](/Users/evan/Desktop/Work/duplo/docs/rules/go-coding-guidelines.md)
+- [docs/rules/go-coding-guidelines.md](../../../../docs/rules/go-coding-guidelines.md)
 
 ## `desktop`에서 특히 중요한 규칙
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aipctl",
-  "version": "2026.8.5",
+  "version": "2026.9.1",
   "description": "QueryPie AIP and MCP CLI tool",
   "author": "QueryPie",
   "license": "UNLICENSED",
@@ -22,16 +22,16 @@
     "node": ">=24.18.0"
   },
   "metadata": {
-    "contentHash": "156db2615eb6ffb678be96f2e25f38d9628decf8121bcbf638755924ef6fe6ca",
-    "wrapperHash": "bf02d1a5ff6b11af9ea359c0e5996a361d47b0f9f5414b7e590477deae7cfe9f",
-    "nativeHash": "bfaa115ac53b30ba141fbe842585a0ed0fca487e2eb356cda219516e53c8b4c0"
+    "contentHash": "436898e8024a53e6caa75dbc99198a467cea9200459511eebcee6e3ca4b39995",
+    "wrapperHash": "a1c87902f0caa915d2dbfd79729e0c4dba47acabaee56f6e37ea6f341b8ac505",
+    "nativeHash": "006b08c3e391f4571d9b7c0f12d684fe2448106259e7e0581b10f9be362452e9"
   },
   "optionalDependencies": {
-    "aipctl-darwin-x64": "2026.8.5",
-    "aipctl-darwin-arm64": "2026.8.5",
-    "aipctl-linux-x64": "2026.8.5",
-    "aipctl-linux-arm64": "2026.8.5",
-    "aipctl-windows-x64": "2026.8.5",
-    "aipctl-windows-arm64": "2026.8.5"
+    "aipctl-darwin-x64": "2026.9.1",
+    "aipctl-darwin-arm64": "2026.9.1",
+    "aipctl-linux-x64": "2026.9.1",
+    "aipctl-linux-arm64": "2026.9.1",
+    "aipctl-windows-x64": "2026.9.1",
+    "aipctl-windows-arm64": "2026.9.1"
   }
 }