@xortex/xcode 3.0.0

package/tools/SkillTool/UI.tsx

@@ -0,0 +1,128 @@
+import type { ToolResultBlockParam } from '@anthropic-ai/sdk/resources/index.mjs';
+import * as React from 'react';
+import { SubAgentProvider } from 'src/components/CtrlOToExpand.js';
+import { FallbackToolUseErrorMessage } from 'src/components/FallbackToolUseErrorMessage.js';
+import { FallbackToolUseRejectedMessage } from 'src/components/FallbackToolUseRejectedMessage.js';
+import type { z } from 'zod/v4';
+import type { Command } from '../../commands.js';
+import { Byline } from '../../components/design-system/Byline.js';
+import { Message as MessageComponent } from '../../components/Message.js';
+import { MessageResponse } from '../../components/MessageResponse.js';
+import { Box, Text } from '../../ink.js';
+import type { Tools } from '../../Tool.js';
+import type { ProgressMessage } from '../../types/message.js';
+import { buildSubagentLookups, EMPTY_LOOKUPS } from '../../utils/messages.js';
+import { plural } from '../../utils/stringUtils.js';
+import type { inputSchema, Output, Progress } from './SkillTool.js';
+type Input = z.infer<ReturnType<typeof inputSchema>>;
+const MAX_PROGRESS_MESSAGES_TO_SHOW = 3;
+const INITIALIZING_TEXT = 'Initializing…';
+export function renderToolResultMessage(output: Output): React.ReactNode {
+  // Handle forked skill result
+  if ('status' in output && output.status === 'forked') {
+    return <MessageResponse height={1}>
+        <Text>
+          <Byline>{['Done']}</Byline>
+        </Text>
+      </MessageResponse>;
+  }
+  const parts: string[] = ['Successfully loaded skill'];
+
+  // Show tools count (only for inline skills)
+  if ('allowedTools' in output && output.allowedTools && output.allowedTools.length > 0) {
+    const count = output.allowedTools.length;
+    parts.push(`${count} ${plural(count, 'tool')} allowed`);
+  }
+
+  // Show model if non-default (only for inline skills)
+  if ('model' in output && output.model) {
+    parts.push(output.model);
+  }
+  return <MessageResponse height={1}>
+      <Text>
+        <Byline>{parts}</Byline>
+      </Text>
+    </MessageResponse>;
+}
+export function renderToolUseMessage({
+  skill
+}: Partial<Input>, {
+  commands
+}: {
+  commands?: Command[];
+}): React.ReactNode {
+  if (!skill) {
+    return null;
+  }
+  // Look up the command to check if it came from the legacy /commands folder
+  const command = commands?.find(c => c.name === skill);
+  const displayName = command?.loadedFrom === 'commands_DEPRECATED' ? `/${skill}` : skill;
+  return displayName;
+}
+export function renderToolUseProgressMessage(progressMessages: ProgressMessage<Progress>[], {
+  tools,
+  verbose
+}: {
+  tools: Tools;
+  verbose: boolean;
+}): React.ReactNode {
+  if (!progressMessages.length) {
+    return <MessageResponse height={1}>
+        <Text dimColor>{INITIALIZING_TEXT}</Text>
+      </MessageResponse>;
+  }
+
+  // Take only the last few messages for display in non-verbose mode
+  const displayedMessages = verbose ? progressMessages : progressMessages.slice(-MAX_PROGRESS_MESSAGES_TO_SHOW);
+  const hiddenCount = progressMessages.length - displayedMessages.length;
+  const {
+    inProgressToolUseIDs
+  } = buildSubagentLookups(progressMessages.map(pm => pm.data));
+  return <MessageResponse>
+      <Box flexDirection="column">
+        <SubAgentProvider>
+          {displayedMessages.map(progressMessage => <Box key={progressMessage.uuid} height={1} overflow="hidden">
+              <MessageComponent message={progressMessage.data.message} lookups={EMPTY_LOOKUPS} addMargin={false} tools={tools} commands={[]} verbose={verbose} inProgressToolUseIDs={inProgressToolUseIDs} progressMessagesForMessage={[]} shouldAnimate={false} shouldShowDot={false} style="condensed" isTranscriptMode={false} isStatic={true} />
+            </Box>)}
+        </SubAgentProvider>
+        {hiddenCount > 0 && <Text dimColor>
+            +{hiddenCount} more tool {plural(hiddenCount, 'use')}
+          </Text>}
+      </Box>
+    </MessageResponse>;
+}
+export function renderToolUseRejectedMessage(_input: Input, {
+  progressMessagesForMessage,
+  tools,
+  verbose
+}: {
+  progressMessagesForMessage: ProgressMessage<Progress>[];
+  tools: Tools;
+  verbose: boolean;
+}): React.ReactNode {
+  return <>
+      {renderToolUseProgressMessage(progressMessagesForMessage, {
+      tools,
+      verbose
+    })}
+      <FallbackToolUseRejectedMessage />
+    </>;
+}
+export function renderToolUseErrorMessage(result: ToolResultBlockParam['content'], {
+  progressMessagesForMessage,
+  tools,
+  verbose
+}: {
+  progressMessagesForMessage: ProgressMessage<Progress>[];
+  tools: Tools;
+  verbose: boolean;
+}): React.ReactNode {
+  return <>
+      {renderToolUseProgressMessage(progressMessagesForMessage, {
+      tools,
+      verbose
+    })}
+      <FallbackToolUseErrorMessage result={result} verbose={verbose} />
+    </>;
+}
+//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJuYW1lcyI6WyJUb29sUmVzdWx0QmxvY2tQYXJhbSIsIlJlYWN0IiwiU3ViQWdlbnRQcm92aWRlciIsIkZhbGxiYWNrVG9vbFVzZUVycm9yTWVzc2FnZSIsIkZhbGxiYWNrVG9vbFVzZVJlamVjdGVkTWVzc2FnZSIsInoiLCJDb21tYW5kIiwiQnlsaW5lIiwiTWVzc2FnZSIsIk1lc3NhZ2VDb21wb25lbnQiLCJNZXNzYWdlUmVzcG9uc2UiLCJCb3giLCJUZXh0IiwiVG9vbHMiLCJQcm9ncmVzc01lc3NhZ2UiLCJidWlsZFN1YmFnZW50TG9va3VwcyIsIkVNUFRZX0xPT0tVUFMiLCJwbHVyYWwiLCJpbnB1dFNjaGVtYSIsIk91dHB1dCIsIlByb2dyZXNzIiwiSW5wdXQiLCJpbmZlciIsIlJldHVyblR5cGUiLCJNQVhfUFJPR1JFU1NfTUVTU0FHRVNfVE9fU0hPVyIsIklOSVRJQUxJWklOR19URVhUIiwicmVuZGVyVG9vbFJlc3VsdE1lc3NhZ2UiLCJvdXRwdXQiLCJSZWFjdE5vZGUiLCJzdGF0dXMiLCJwYXJ0cyIsImFsbG93ZWRUb29scyIsImxlbmd0aCIsImNvdW50IiwicHVzaCIsIm1vZGVsIiwicmVuZGVyVG9vbFVzZU1lc3NhZ2UiLCJza2lsbCIsIlBhcnRpYWwiLCJjb21tYW5kcyIsImNvbW1hbmQiLCJmaW5kIiwiYyIsIm5hbWUiLCJkaXNwbGF5TmFtZSIsImxvYWRlZEZyb20iLCJyZW5kZXJUb29sVXNlUHJvZ3Jlc3NNZXNzYWdlIiwicHJvZ3Jlc3NNZXNzYWdlcyIsInRvb2xzIiwidmVyYm9zZSIsImRpc3BsYXllZE1lc3NhZ2VzIiwic2xpY2UiLCJoaWRkZW5Db3VudCIsImluUHJvZ3Jlc3NUb29sVXNlSURzIiwibWFwIiwicG0iLCJkYXRhIiwicHJvZ3Jlc3NNZXNzYWdlIiwidXVpZCIsIm1lc3NhZ2UiLCJyZW5kZXJUb29sVXNlUmVqZWN0ZWRNZXNzYWdlIiwiX2lucHV0IiwicHJvZ3Jlc3NNZXNzYWdlc0Zvck1lc3NhZ2UiLCJyZW5kZXJUb29sVXNlRXJyb3JNZXNzYWdlIiwicmVzdWx0Il0sInNvdXJjZXMiOlsiVUkudHN4Il0sInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB0eXBlIHsgVG9vbFJlc3VsdEJsb2NrUGFyYW0gfSBmcm9tICdAYW50aHJvcGljLWFpL3Nkay9yZXNvdXJjZXMvaW5kZXgubWpzJ1xuaW1wb3J0ICogYXMgUmVhY3QgZnJvbSAncmVhY3QnXG5pbXBvcnQgeyBTdWJBZ2VudFByb3ZpZGVyIH0gZnJvbSAnc3JjL2NvbXBvbmVudHMvQ3RybE9Ub0V4cGFuZC5qcydcbmltcG9ydCB7IEZhbGxiYWNrVG9vbFVzZUVycm9yTWVzc2FnZSB9IGZyb20gJ3NyYy9jb21wb25lbnRzL0ZhbGxiYWNrVG9vbFVzZUVycm9yTWVzc2FnZS5qcydcbmltcG9ydCB7IEZhbGxiYWNrVG9vbFVzZVJlamVjdGVkTWVzc2FnZSB9IGZyb20gJ3NyYy9jb21wb25lbnRzL0ZhbGxiYWNrVG9vbFVzZVJlamVjdGVkTWVzc2FnZS5qcydcbmltcG9ydCB0eXBlIHsgeiB9IGZyb20gJ3pvZC92NCdcbmltcG9ydCB0eXBlIHsgQ29tbWFuZCB9IGZyb20gJy4uLy4uL2NvbW1hbmRzLmpzJ1xuaW1wb3J0IHsgQnlsaW5lIH0gZnJvbSAnLi4vLi4vY29tcG9uZW50cy9kZXNpZ24tc3lzdGVtL0J5bGluZS5qcydcbmltcG9ydCB7IE1lc3NhZ2UgYXMgTWVzc2FnZUNvbXBvbmVudCB9IGZyb20gJy4uLy4uL2NvbXBvbmVudHMvTWVzc2FnZS5qcydcbmltcG9ydCB7IE1lc3NhZ2VSZXNwb25zZSB9IGZyb20gJy4uLy4uL2NvbXBvbmVudHMvTWVzc2FnZVJlc3BvbnNlLmpzJ1xuaW1wb3J0IHsgQm94LCBUZXh0IH0gZnJvbSAnLi4vLi4vaW5rLmpzJ1xuaW1wb3J0IHR5cGUgeyBUb29scyB9IGZyb20gJy4uLy4uL1Rvb2wuanMnXG5pbXBvcnQgdHlwZSB7IFByb2dyZXNzTWVzc2FnZSB9IGZyb20gJy4uLy4uL3R5cGVzL21lc3NhZ2UuanMnXG5pbXBvcnQgeyBidWlsZFN1YmFnZW50TG9va3VwcywgRU1QVFlfTE9PS1VQUyB9IGZyb20gJy4uLy4uL3V0aWxzL21lc3NhZ2VzLmpzJ1xuaW1wb3J0IHsgcGx1cmFsIH0gZnJvbSAnLi4vLi4vdXRpbHMvc3RyaW5nVXRpbHMuanMnXG5pbXBvcnQgdHlwZSB7IGlucHV0U2NoZW1hLCBPdXRwdXQsIFByb2dyZXNzIH0gZnJvbSAnLi9Ta2lsbFRvb2wuanMnXG5cbnR5cGUgSW5wdXQgPSB6LmluZmVyPFJldHVyblR5cGU8dHlwZW9mIGlucHV0U2NoZW1hPj5cblxuY29uc3QgTUFYX1BST0dSRVNTX01FU1NBR0VTX1RPX1NIT1cgPSAzXG5jb25zdCBJTklUSUFMSVpJTkdfVEVYVCA9ICdJbml0aWFsaXppbmfigKYnXG5cbmV4cG9ydCBmdW5jdGlvbiByZW5kZXJUb29sUmVzdWx0TWVzc2FnZShvdXRwdXQ6IE91dHB1dCk6IFJlYWN0LlJlYWN0Tm9kZSB7XG4gIC8vIEhhbmRsZSBmb3JrZWQgc2tpbGwgcmVzdWx0XG4gIGlmICgnc3RhdHVzJyBpbiBvdXRwdXQgJiYgb3V0cHV0LnN0YXR1cyA9PT0gJ2ZvcmtlZCcpIHtcbiAgICByZXR1cm4gKFxuICAgICAgPE1lc3NhZ2VSZXNwb25zZSBoZWlnaHQ9ezF9PlxuICAgICAgICA8VGV4dD5cbiAgICAgICAgICA8QnlsaW5lPntbJ0RvbmUnXX08L0J5bGluZT5cbiAgICAgICAgPC9UZXh0PlxuICAgICAgPC9NZXNzYWdlUmVzcG9uc2U+XG4gICAgKVxuICB9XG5cbiAgY29uc3QgcGFydHM6IHN0cmluZ1tdID0gWydTdWNjZXNzZnVsbHkgbG9hZGVkIHNraWxsJ11cblxuICAvLyBTaG93IHRvb2xzIGNvdW50IChvbmx5IGZvciBpbmxpbmUgc2tpbGxzKVxuICBpZiAoXG4gICAgJ2FsbG93ZWRUb29scycgaW4gb3V0cHV0ICYmXG4gICAgb3V0cHV0LmFsbG93ZWRUb29scyAmJlxuICAgIG91dHB1dC5hbGxvd2VkVG9vbHMubGVuZ3RoID4gMFxuICApIHtcbiAgICBjb25zdCBjb3VudCA9IG91dHB1dC5hbGxvd2VkVG9vbHMubGVuZ3RoXG4gICAgcGFydHMucHVzaChgJHtjb3VudH0gJHtwbHVyYWwoY291bnQsICd0b29sJyl9IGFsbG93ZWRgKVxuICB9XG5cbiAgLy8gU2hvdyBtb2RlbCBpZiBub24tZGVmYXVsdCAob25seSBmb3IgaW5saW5lIHNraWxscylcbiAgaWYgKCdtb2RlbCcgaW4gb3V0cHV0ICYmIG91dHB1dC5tb2RlbCkge1xuICAgIHBhcnRzLnB1c2gob3V0cHV0Lm1vZGVsKVxuICB9XG5cbiAgcmV0dXJuIChcbiAgICA8TWVzc2FnZVJlc3BvbnNlIGhlaWdodD17MX0+XG4gICAgICA8VGV4dD5cbiAgICAgICAgPEJ5bGluZT57cGFydHN9PC9CeWxpbmU+XG4gICAgICA8L1RleHQ+XG4gICAgPC9NZXNzYWdlUmVzcG9uc2U+XG4gIClcbn1cblxuZXhwb3J0IGZ1bmN0aW9uIHJlbmRlclRvb2xVc2VNZXNzYWdlKFxuICB7IHNraWxsIH06IFBhcnRpYWw8SW5wdXQ+LFxuICB7IGNvbW1hbmRzIH06IHsgY29tbWFuZHM/OiBDb21tYW5kW10gfSxcbik6IFJlYWN0LlJlYWN0Tm9kZSB7XG4gIGlmICghc2tpbGwpIHtcbiAgICByZXR1cm4gbnVsbFxuICB9XG4gIC8vIExvb2sgdXAgdGhlIGNvbW1hbmQgdG8gY2hlY2sgaWYgaXQgY2FtZSBmcm9tIHRoZSBsZWdhY3kgL2NvbW1hbmRzIGZvbGRlclxuICBjb25zdCBjb21tYW5kID0gY29tbWFuZHM/LmZpbmQoYyA9PiBjLm5hbWUgPT09IHNraWxsKVxuICBjb25zdCBkaXNwbGF5TmFtZSA9XG4gICAgY29tbWFuZD8ubG9hZGVkRnJvbSA9PT0gJ2NvbW1hbmRzX0RFUFJFQ0FURUQnID8gYC8ke3NraWxsfWAgOiBza2lsbFxuICByZXR1cm4gZGlzcGxheU5hbWVcbn1cblxuZXhwb3J0IGZ1bmN0aW9uIHJlbmRlclRvb2xVc2VQcm9ncmVzc01lc3NhZ2UoXG4gIHByb2dyZXNzTWVzc2FnZXM6IFByb2dyZXNzTWVzc2FnZTxQcm9ncmVzcz5bXSxcbiAge1xuICAgIHRvb2xzLFxuICAgIHZlcmJvc2UsXG4gIH06IHtcbiAgICB0b29sczogVG9vbHNcbiAgICB2ZXJib3NlOiBib29sZWFuXG4gIH0sXG4pOiBSZWFjdC5SZWFjdE5vZGUge1xuICBpZiAoIXByb2dyZXNzTWVzc2FnZXMubGVuZ3RoKSB7XG4gICAgcmV0dXJuIChcbiAgICAgIDxNZXNzYWdlUmVzcG9uc2UgaGVpZ2h0PXsxfT5cbiAgICAgICAgPFRleHQgZGltQ29sb3I+e0lOSVRJQUxJWklOR19URVhUfTwvVGV4dD5cbiAgICAgIDwvTWVzc2FnZVJlc3BvbnNlPlxuICAgIClcbiAgfVxuXG4gIC8vIFRha2Ugb25seSB0aGUgbGFzdCBmZXcgbWVzc2FnZXMgZm9yIGRpc3BsYXkgaW4gbm9uLXZlcmJvc2UgbW9kZVxuICBjb25zdCBkaXNwbGF5ZWRNZXNzYWdlcyA9IHZlcmJvc2VcbiAgICA/IHByb2dyZXNzTWVzc2FnZXNcbiAgICA6IHByb2dyZXNzTWVzc2FnZXMuc2xpY2UoLU1BWF9QUk9HUkVTU19NRVNTQUdFU19UT19TSE9XKVxuXG4gIGNvbnN0IGhpZGRlbkNvdW50ID0gcHJvZ3Jlc3NNZXNzYWdlcy5sZW5ndGggLSBkaXNwbGF5ZWRNZXNzYWdlcy5sZW5ndGhcbiAgY29uc3QgeyBpblByb2dyZXNzVG9vbFVzZUlEcyB9ID0gYnVpbGRTdWJhZ2VudExvb2t1cHMoXG4gICAgcHJvZ3Jlc3NNZXNzYWdlcy5tYXAocG0gPT4gcG0uZGF0YSksXG4gIClcblxuICByZXR1cm4gKFxuICAgIDxNZXNzYWdlUmVzcG9uc2U+XG4gICAgICA8Qm94IGZsZXhEaXJlY3Rpb249XCJjb2x1bW5cIj5cbiAgICAgICAgPFN1YkFnZW50UHJvdmlkZXI+XG4gICAgICAgICAge2Rpc3BsYXllZE1lc3NhZ2VzLm1hcChwcm9ncmVzc01lc3NhZ2UgPT4gKFxuICAgICAgICAgICAgPEJveCBrZXk9e3Byb2dyZXNzTWVzc2FnZS51dWlkfSBoZWlnaHQ9ezF9IG92ZXJmbG93PVwiaGlkZGVuXCI+XG4gICAgICAgICAgICAgIDxNZXNzYWdlQ29tcG9uZW50XG4gICAgICAgICAgICAgICAgbWVzc2FnZT17cHJvZ3Jlc3NNZXNzYWdlLmRhdGEubWVzc2FnZX1cbiAgICAgICAgICAgICAgICBsb29rdXBzPXtFTVBUWV9MT09LVVBTfVxuICAgICAgICAgICAgICAgIGFkZE1hcmdpbj17ZmFsc2V9XG4gICAgICAgICAgICAgICAgdG9vbHM9e3Rvb2xzfVxuICAgICAgICAgICAgICAgIGNvbW1hbmRzPXtbXX1cbiAgICAgICAgICAgICAgICB2ZXJib3NlPXt2ZXJib3NlfVxuICAgICAgICAgICAgICAgIGluUHJvZ3Jlc3NUb29sVXNlSURzPXtpblByb2dyZXNzVG9vbFVzZUlEc31cbiAgICAgICAgICAgICAgICBwcm9ncmVzc01lc3NhZ2VzRm9yTWVzc2FnZT17W119XG4gICAgICAgICAgICAgICAgc2hvdWxkQW5pbWF0ZT17ZmFsc2V9XG4gICAgICAgICAgICAgICAgc2hvdWxkU2hvd0RvdD17ZmFsc2V9XG4gICAgICAgICAgICAgICAgc3R5bGU9XCJjb25kZW5zZWRcIlxuICAgICAgICAgICAgICAgIGlzVHJhbnNjcmlwdE1vZGU9e2ZhbHNlfVxuICAgICAgICAgICAgICAgIGlzU3RhdGljPXt0cnVlfVxuICAgICAgICAgICAgICAvPlxuICAgICAgICAgICAgPC9Cb3g+XG4gICAgICAgICAgKSl9XG4gICAgICAgIDwvU3ViQWdlbnRQcm92aWRlcj5cbiAgICAgICAge2hpZGRlbkNvdW50ID4gMCAmJiAoXG4gICAgICAgICAgPFRleHQgZGltQ29sb3I+XG4gICAgICAgICAgICAre2hpZGRlbkNvdW50fSBtb3JlIHRvb2wge3BsdXJhbChoaWRkZW5Db3VudCwgJ3VzZScpfVxuICAgICAgICAgIDwvVGV4dD5cbiAgICAgICAgKX1cbiAgICAgIDwvQm94PlxuICAgIDwvTWVzc2FnZVJlc3BvbnNlPlxuICApXG59XG5cbmV4cG9ydCBmdW5jdGlvbiByZW5kZXJUb29sVXNlUmVqZWN0ZWRNZXNzYWdlKFxuICBfaW5wdXQ6IElucHV0LFxuICB7XG4gICAgcHJvZ3Jlc3NNZXNzYWdlc0Zvck1lc3NhZ2UsXG4gICAgdG9vbHMsXG4gICAgdmVyYm9zZSxcbiAgfToge1xuICAgIHByb2dyZXNzTWVzc2FnZXNGb3JNZXNzYWdlOiBQcm9ncmVzc01lc3NhZ2U8UHJvZ3Jlc3M+W11cbiAgICB0b29sczogVG9vbHNcbiAgICB2ZXJib3NlOiBib29sZWFuXG4gIH0sXG4pOiBSZWFjdC5SZWFjdE5vZGUge1xuICByZXR1cm4gKFxuICAgIDw+XG4gICAgICB7cmVuZGVyVG9vbFVzZVByb2dyZXNzTWVzc2FnZShwcm9ncmVzc01lc3NhZ2VzRm9yTWVzc2FnZSwge1xuICAgICAgICB0b29scyxcbiAgICAgICAgdmVyYm9zZSxcbiAgICAgIH0pfVxuICAgICAgPEZhbGxiYWNrVG9vbFVzZVJlamVjdGVkTWVzc2FnZSAvPlxuICAgIDwvPlxuICApXG59XG5cbmV4cG9ydCBmdW5jdGlvbiByZW5kZXJUb29sVXNlRXJyb3JNZXNzYWdlKFxuICByZXN1bHQ6IFRvb2xSZXN1bHRCbG9ja1BhcmFtWydjb250ZW50J10sXG4gIHtcbiAgICBwcm9ncmVzc01lc3NhZ2VzRm9yTWVzc2FnZSxcbiAgICB0b29scyxcbiAgICB2ZXJib3NlLFxuICB9OiB7XG4gICAgcHJvZ3Jlc3NNZXNzYWdlc0Zvck1lc3NhZ2U6IFByb2dyZXNzTWVzc2FnZTxQcm9ncmVzcz5bXVxuICAgIHRvb2xzOiBUb29sc1xuICAgIHZlcmJvc2U6IGJvb2xlYW5cbiAgfSxcbik6IFJlYWN0LlJlYWN0Tm9kZSB7XG4gIHJldHVybiAoXG4gICAgPD5cbiAgICAgIHtyZW5kZXJUb29sVXNlUHJvZ3Jlc3NNZXNzYWdlKHByb2dyZXNzTWVzc2FnZXNGb3JNZXNzYWdlLCB7XG4gICAgICAgIHRvb2xzLFxuICAgICAgICB2ZXJib3NlLFxuICAgICAgfSl9XG4gICAgICA8RmFsbGJhY2tUb29sVXNlRXJyb3JNZXNzYWdlIHJlc3VsdD17cmVzdWx0fSB2ZXJib3NlPXt2ZXJib3NlfSAvPlxuICAgIDwvPlxu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

package/tools/SkillTool/constants.ts

@@ -0,0 +1 @@
+export const SKILL_TOOL_NAME = 'Skill'

package/tools/SkillTool/prompt.ts

@@ -0,0 +1,241 @@
+import { memoize } from 'lodash-es'
+import type { Command } from 'src/commands.js'
+import {
+  getCommandName,
+  getSkillToolCommands,
+  getSlashCommandToolSkills,
+} from 'src/commands.js'
+import { COMMAND_NAME_TAG } from '../../constants/xml.js'
+import { stringWidth } from '../../ink/stringWidth.js'
+import {
+  type AnalyticsMetadata_I_VERIFIED_THIS_IS_NOT_CODE_OR_FILEPATHS,
+  logEvent,
+} from '../../services/analytics/index.js'
+import { count } from '../../utils/array.js'
+import { logForDebugging } from '../../utils/debug.js'
+import { toError } from '../../utils/errors.js'
+import { truncate } from '../../utils/format.js'
+import { logError } from '../../utils/log.js'
+
+// Skill listing gets 1% of the context window (in characters)
+export const SKILL_BUDGET_CONTEXT_PERCENT = 0.01
+export const CHARS_PER_TOKEN = 4
+export const DEFAULT_CHAR_BUDGET = 8_000 // Fallback: 1% of 200k × 4
+
+// Per-entry hard cap. The listing is for discovery only — the Skill tool loads
+// full content on invoke, so verbose whenToUse strings waste turn-1 cache_creation
+// tokens without improving match rate. Applies to all entries, including bundled,
+// since the cap is generous enough to preserve the core use case.
+export const MAX_LISTING_DESC_CHARS = 250
+
+export function getCharBudget(contextWindowTokens?: number): number {
+  if (Number(process.env.SLASH_COMMAND_TOOL_CHAR_BUDGET)) {
+    return Number(process.env.SLASH_COMMAND_TOOL_CHAR_BUDGET)
+  }
+  if (contextWindowTokens) {
+    return Math.floor(
+      contextWindowTokens * CHARS_PER_TOKEN * SKILL_BUDGET_CONTEXT_PERCENT,
+    )
+  }
+  return DEFAULT_CHAR_BUDGET
+}
+
+function getCommandDescription(cmd: Command): string {
+  const desc = cmd.whenToUse
+    ? `${cmd.description} - ${cmd.whenToUse}`
+    : cmd.description
+  return desc.length > MAX_LISTING_DESC_CHARS
+    ? desc.slice(0, MAX_LISTING_DESC_CHARS - 1) + '\u2026'
+    : desc
+}
+
+function formatCommandDescription(cmd: Command): string {
+  // Debug: log if userFacingName differs from cmd.name for plugin skills
+  const displayName = getCommandName(cmd)
+  if (
+    cmd.name !== displayName &&
+    cmd.type === 'prompt' &&
+    cmd.source === 'plugin'
+  ) {
+    logForDebugging(
+      `Skill prompt: showing "${cmd.name}" (userFacingName="${displayName}")`,
+    )
+  }
+
+  return `- ${cmd.name}: ${getCommandDescription(cmd)}`
+}
+
+const MIN_DESC_LENGTH = 20
+
+export function formatCommandsWithinBudget(
+  commands: Command[],
+  contextWindowTokens?: number,
+): string {
+  if (commands.length === 0) return ''
+
+  const budget = getCharBudget(contextWindowTokens)
+
+  // Try full descriptions first
+  const fullEntries = commands.map(cmd => ({
+    cmd,
+    full: formatCommandDescription(cmd),
+  }))
+  // join('\n') produces N-1 newlines for N entries
+  const fullTotal =
+    fullEntries.reduce((sum, e) => sum + stringWidth(e.full), 0) +
+    (fullEntries.length - 1)
+
+  if (fullTotal <= budget) {
+    return fullEntries.map(e => e.full).join('\n')
+  }
+
+  // Partition into bundled (never truncated) and rest
+  const bundledIndices = new Set<number>()
+  const restCommands: Command[] = []
+  for (let i = 0; i < commands.length; i++) {
+    const cmd = commands[i]!
+    if (cmd.type === 'prompt' && cmd.source === 'bundled') {
+      bundledIndices.add(i)
+    } else {
+      restCommands.push(cmd)
+    }
+  }
+
+  // Compute space used by bundled skills (full descriptions, always preserved)
+  const bundledChars = fullEntries.reduce(
+    (sum, e, i) =>
+      bundledIndices.has(i) ? sum + stringWidth(e.full) + 1 : sum,
+    0,
+  )
+  const remainingBudget = budget - bundledChars
+
+  // Calculate max description length for non-bundled commands
+  if (restCommands.length === 0) {
+    return fullEntries.map(e => e.full).join('\n')
+  }
+
+  const restNameOverhead =
+    restCommands.reduce((sum, cmd) => sum + stringWidth(cmd.name) + 4, 0) +
+    (restCommands.length - 1)
+  const availableForDescs = remainingBudget - restNameOverhead
+  const maxDescLen = Math.floor(availableForDescs / restCommands.length)
+
+  if (maxDescLen < MIN_DESC_LENGTH) {
+    // Extreme case: non-bundled go names-only, bundled keep descriptions
+    if (process.env.USER_TYPE === 'ant') {
+      logEvent('tengu_skill_descriptions_truncated', {
+        skill_count: commands.length,
+        budget,
+        full_total: fullTotal,
+        truncation_mode:
+          'names_only' as AnalyticsMetadata_I_VERIFIED_THIS_IS_NOT_CODE_OR_FILEPATHS,
+        max_desc_length: maxDescLen,
+        bundled_count: bundledIndices.size,
+        bundled_chars: bundledChars,
+      })
+    }
+    return commands
+      .map((cmd, i) =>
+        bundledIndices.has(i) ? fullEntries[i]!.full : `- ${cmd.name}`,
+      )
+      .join('\n')
+  }
+
+  // Truncate non-bundled descriptions to fit within budget
+  const truncatedCount = count(
+    restCommands,
+    cmd => stringWidth(getCommandDescription(cmd)) > maxDescLen,
+  )
+  if (process.env.USER_TYPE === 'ant') {
+    logEvent('tengu_skill_descriptions_truncated', {
+      skill_count: commands.length,
+      budget,
+      full_total: fullTotal,
+      truncation_mode:
+        'description_trimmed' as AnalyticsMetadata_I_VERIFIED_THIS_IS_NOT_CODE_OR_FILEPATHS,
+      max_desc_length: maxDescLen,
+      truncated_count: truncatedCount,
+      // Count of bundled skills included in this prompt (excludes skills with disableModelInvocation)
+      bundled_count: bundledIndices.size,
+      bundled_chars: bundledChars,
+    })
+  }
+  return commands
+    .map((cmd, i) => {
+      // Bundled skills always get full descriptions
+      if (bundledIndices.has(i)) return fullEntries[i]!.full
+      const description = getCommandDescription(cmd)
+      return `- ${cmd.name}: ${truncate(description, maxDescLen)}`
+    })
+    .join('\n')
+}
+
+export const getPrompt = memoize(async (_cwd: string): Promise<string> => {
+  return `Execute a skill within the main conversation
+
+When users ask you to perform tasks, check if any of the available skills match. Skills provide specialized capabilities and domain knowledge.
+
+When users reference a "slash command" or "/<something>" (e.g., "/commit", "/review-pr"), they are referring to a skill. Use this tool to invoke it.
+
+How to invoke:
+- Use this tool with the skill name and optional arguments
+- Examples:
+  - \`skill: "pdf"\` - invoke the pdf skill
+  - \`skill: "commit", args: "-m 'Fix bug'"\` - invoke with arguments
+  - \`skill: "review-pr", args: "123"\` - invoke with arguments
+  - \`skill: "ms-office-suite:pdf"\` - invoke using fully qualified name
+
+Important:
+- Available skills are listed in system-reminder messages in the conversation
+- When a skill matches the user's request, this is a BLOCKING REQUIREMENT: invoke the relevant Skill tool BEFORE generating any other response about the task
+- NEVER mention a skill without actually calling this tool
+- Do not invoke a skill that is already running
+- Do not use this tool for built-in CLI commands (like /help, /clear, etc.)
+- If you see a <${COMMAND_NAME_TAG}> tag in the current conversation turn, the skill has ALREADY been loaded - follow the instructions directly instead of calling this tool again
+`
+})
+
+export async function getSkillToolInfo(cwd: string): Promise<{
+  totalCommands: number
+  includedCommands: number
+}> {
+  const agentCommands = await getSkillToolCommands(cwd)
+
+  return {
+    totalCommands: agentCommands.length,
+    includedCommands: agentCommands.length,
+  }
+}
+
+// Returns the commands included in the SkillTool prompt.
+// All commands are always included (descriptions may be truncated to fit budget).
+// Used by analyzeContext to count skill tokens.
+export function getLimitedSkillToolCommands(cwd: string): Promise<Command[]> {
+  return getSkillToolCommands(cwd)
+}
+
+export function clearPromptCache(): void {
+  getPrompt.cache?.clear?.()
+}
+
+export async function getSkillInfo(cwd: string): Promise<{
+  totalSkills: number
+  includedSkills: number
+}> {
+  try {
+    const skills = await getSlashCommandToolSkills(cwd)
+
+    return {
+      totalSkills: skills.length,
+      includedSkills: skills.length,
+    }
+  } catch (error) {
+    logError(toError(error))
+
+    // Return zeros rather than throwing - let caller decide how to handle
+    return {
+      totalSkills: 0,
+      includedSkills: 0,
+    }
+  }
+}

package/tools/SleepTool/prompt.ts

@@ -0,0 +1,17 @@
+import { TICK_TAG } from '../../constants/xml.js'
+
+export const SLEEP_TOOL_NAME = 'Sleep'
+
+export const DESCRIPTION = 'Wait for a specified duration'
+
+export const SLEEP_TOOL_PROMPT = `Wait for a specified duration. The user can interrupt the sleep at any time.
+
+Use this when the user tells you to sleep or rest, when you have nothing to do, or when you're waiting for something.
+
+You may receive <${TICK_TAG}> prompts — these are periodic check-ins. Look for useful work to do before sleeping.
+
+You can call this concurrently with other tools — it won't interfere with them.
+
+Prefer this over \`Bash(sleep ...)\` — it doesn't hold a shell process.
+
+Each wake-up costs an API call, but the prompt cache expires after 5 minutes of inactivity — balance accordingly.`

package/tools/SyntheticOutputTool/SyntheticOutputTool.ts

@@ -0,0 +1,163 @@
+import { Ajv } from 'ajv'
+import { z } from 'zod/v4'
+import type { Tool, ToolInputJSONSchema } from '../../Tool.js'
+import { buildTool, type ToolDef } from '../../Tool.js'
+import { TelemetrySafeError_I_VERIFIED_THIS_IS_NOT_CODE_OR_FILEPATHS } from '../../utils/errors.js'
+import { lazySchema } from '../../utils/lazySchema.js'
+import type { PermissionResult } from '../../utils/permissions/PermissionResult.js'
+import { jsonStringify } from '../../utils/slowOperations.js'
+
+// Allow any input object since the schema is provided dynamically
+const inputSchema = lazySchema(() => z.object({}).passthrough())
+type InputSchema = ReturnType<typeof inputSchema>
+
+const outputSchema = lazySchema(() =>
+  z.string().describe('Structured output tool result'),
+)
+type OutputSchema = ReturnType<typeof outputSchema>
+export type Output = z.infer<OutputSchema>
+
+export const SYNTHETIC_OUTPUT_TOOL_NAME = 'StructuredOutput'
+
+export function isSyntheticOutputToolEnabled(opts: {
+  isNonInteractiveSession: boolean
+}): boolean {
+  return opts.isNonInteractiveSession
+}
+
+export const SyntheticOutputTool = buildTool({
+  isMcp: false,
+  isEnabled() {
+    // This tool is only created when conditions are met (see main.tsx where
+    // isSyntheticOutputToolEnabled() gates tool creation). Once created, always enabled.
+    return true
+  },
+  isConcurrencySafe() {
+    return true
+  },
+  isReadOnly() {
+    return true
+  },
+  isOpenWorld() {
+    return false
+  },
+  name: SYNTHETIC_OUTPUT_TOOL_NAME,
+  searchHint: 'return the final response as structured JSON',
+  maxResultSizeChars: 100_000,
+  async description(): Promise<string> {
+    return 'Return structured output in the requested format'
+  },
+  async prompt(): Promise<string> {
+    return `Use this tool to return your final response in the requested structured format. You MUST call this tool exactly once at the end of your response to provide the structured output.`
+  },
+  get inputSchema(): InputSchema {
+    return inputSchema()
+  },
+  get outputSchema(): OutputSchema {
+    return outputSchema()
+  },
+  async call(input) {
+    // The tool just validates and returns the input as the structured output
+    return {
+      data: 'Structured output provided successfully',
+      structured_output: input,
+    }
+  },
+  async checkPermissions(input): Promise<PermissionResult> {
+    // Always allow this tool - it's just returning data
+    return {
+      behavior: 'allow',
+      updatedInput: input,
+    }
+  },
+  // Minimal UI implementations - this tool is for non-interactive SDK/CLI use
+  renderToolUseMessage(input: Record<string, unknown>) {
+    const keys = Object.keys(input)
+    if (keys.length === 0) return null
+    if (keys.length <= 3) {
+      return keys.map(k => `${k}: ${jsonStringify(input[k])}`).join(', ')
+    }
+    return `${keys.length} fields: ${keys.slice(0, 3).join(', ')}…`
+  },
+  renderToolUseRejectedMessage() {
+    return 'Structured output rejected'
+  },
+  renderToolUseErrorMessage() {
+    return 'Structured output error'
+  },
+  renderToolUseProgressMessage() {
+    return null
+  },
+  renderToolResultMessage(output: string) {
+    return output
+  },
+  mapToolResultToToolResultBlockParam(content: string, toolUseID: string) {
+    return {
+      tool_use_id: toolUseID,
+      type: 'tool_result' as const,
+      content,
+    }
+  },
+} satisfies ToolDef<InputSchema, Output>)
+
+type CreateResult = { tool: Tool<InputSchema> } | { error: string }
+
+// Workflow scripts call agent({schema: BUGS_SCHEMA}) 30-80 times per run with
+// the same schema object reference. Without caching, each call does
+// new Ajv() + validateSchema() + compile() (~1.4ms of JIT codegen). Identity
+// cache brings 80-call workflows from ~110ms to ~4ms Ajv overhead.
+const toolCache = new WeakMap<object, CreateResult>()
+
+/**
+ * Create a SyntheticOutputTool configured with the given JSON schema.
+ * Returns {tool} on success or {error} with Ajv's diagnostic message
+ * (e.g. "data/properties/bugs should be object") on invalid schema.
+ */
+export function createSyntheticOutputTool(
+  jsonSchema: Record<string, unknown>,
+): CreateResult {
+  const cached = toolCache.get(jsonSchema)
+  if (cached) return cached
+
+  const result = buildSyntheticOutputTool(jsonSchema)
+  toolCache.set(jsonSchema, result)
+  return result
+}
+
+function buildSyntheticOutputTool(
+  jsonSchema: Record<string, unknown>,
+): CreateResult {
+  try {
+    const ajv = new Ajv({ allErrors: true })
+    const isValidSchema = ajv.validateSchema(jsonSchema)
+    if (!isValidSchema) {
+      return { error: ajv.errorsText(ajv.errors) }
+    }
+    const validateSchema = ajv.compile(jsonSchema)
+
+    return {
+      tool: {
+        ...SyntheticOutputTool,
+        inputJSONSchema: jsonSchema as ToolInputJSONSchema,
+        async call(input) {
+          const isValid = validateSchema(input)
+          if (!isValid) {
+            const errors = validateSchema.errors
+              ?.map(e => `${e.instancePath || 'root'}: ${e.message}`)
+              .join(', ')
+            throw new TelemetrySafeError_I_VERIFIED_THIS_IS_NOT_CODE_OR_FILEPATHS(
+              `Output does not match required schema: ${errors}`,
+              `StructuredOutput schema mismatch: ${(errors ?? '').slice(0, 150)}`,
+            )
+          }
+          return {
+            data: 'Structured output provided successfully',
+            structured_output: input,
+          }
+        },
+      },
+    }
+  } catch (e) {
+    return { error: e instanceof Error ? e.message : String(e) }
+  }
+}