@k2b/cloud 0.30.0 → 0.32.0

package/src/ai/browser.ts

@@ -17,29 +17,104 @@ export {
   type CloudAiChartColumn,
   type CloudAiChartRow,
   type CloudAiChartTable,
+  chartDrawingIssue,
+  cloudAiChartLegend,
+  cloudAiChartMarkKey,
+  cloudAiChartMarks,
+  cloudAiChartReferenceMark,
+  cloudAiChartRenderOptions,
+  cloudAiChartRows,
   cloudAiChartTable,
+  cloudAiChartXValueFormat,
+  cloudAiNumberFormatters,
 } from "./chart-block";
 export { parseAiSse } from "./client/transport";
 export {
   CLOUD_AI_CHART_MAX_SERIES,
   CLOUD_AI_CHART_MAX_VALUES,
+  CLOUD_AI_GROUP_MAX_CHARTS,
   CLOUD_AI_TEXT_EDITOR_MAX_CHARS,
+  CLOUD_AI_VIEW_MAX_MARKS,
   CloudAiCardInputSchema,
+  type CloudAiChartInput,
   CloudAiChartInputSchema,
+  type CloudAiDateFormat,
+  type CloudAiFormat,
   CloudAiLocalBashInputSchema,
+  type CloudAiNumberFormat,
   CloudAiSurveyInputSchema,
+  CloudAiSurveyOutputSchema,
   CloudAiTextEditorInputSchema,
+  CloudAiTextEditorOutputSchema,
+  cloudAiAppChartSchema,
+  cloudAiChartSchema,
+  cloudAiFormatSchema,
+  cloudAiNumberFormatSchema,
   parseCloudAiChartInput,
 } from "./default-tool-contracts";
 export { guessAiMediaType } from "./file-media-type";
+export { AI_PROJECT_FILE_MOUNT, AI_SKILL_FILE_MOUNT } from "./file-mount";
 export { AI_IMAGE_INPUT_MAX_BYTES, AI_TURN_ATTACHMENT_MAX_ITEMS, AI_TURN_IMAGE_MAX_TOTAL_BYTES } from "./limits";
 export {
+  AI_LOCAL_BATCH_MAX_ITEMS,
+  AI_LOCAL_INSTRUCTIONS_MAX_BYTES,
+  AI_LOCAL_LIST_MAX_LIMIT,
+  AI_LOCAL_READ_MAX_BYTES,
+  AI_LOCAL_SELECTED_SKILLS_MAX_ITEMS,
+  AI_LOCAL_SKILL_FILES_MAX_ITEMS,
+  AI_LOCAL_SKILLS_MAX_ITEMS,
+  AI_LOCAL_TOOL_NAMES,
+  AI_LOCAL_WRITE_MAX_BYTES,
+  type AiLocalClient,
+  AiLocalClientSchema,
+  type AiLocalContext,
+  AiLocalContextSchema,
+  type AiLocalToolName,
+  type CloudAiLoadLocalSkillInput,
+  CloudAiLoadLocalSkillInputSchema,
+  type CloudAiLoadLocalSkillOutput,
+  CloudAiLoadLocalSkillOutputSchema,
+  type CloudAiLocalDownloadInput,
+  CloudAiLocalDownloadInputSchema,
+  type CloudAiLocalDownloadOutput,
+  CloudAiLocalDownloadOutputSchema,
+  type CloudAiLocalListInput,
+  CloudAiLocalListInputSchema,
+  type CloudAiLocalListOutput,
+  CloudAiLocalListOutputSchema,
+  type CloudAiLocalMoveInput,
+  CloudAiLocalMoveInputSchema,
+  type CloudAiLocalMoveOutput,
+  CloudAiLocalMoveOutputSchema,
+  type CloudAiLocalReadInput,
+  CloudAiLocalReadInputSchema,
+  type CloudAiLocalReadOutput,
+  CloudAiLocalReadOutputSchema,
+  type CloudAiLocalUploadInput,
+  CloudAiLocalUploadInputSchema,
+  type CloudAiLocalUploadOutput,
+  CloudAiLocalUploadOutputSchema,
+  type CloudAiLocalWriteInput,
+  CloudAiLocalWriteInputSchema,
+  type CloudAiLocalWriteOutput,
+  CloudAiLocalWriteOutputSchema,
+} from "./local-tool-contracts";
+export {
+  AI_SKILL_DESCRIPTION_MAX_CHARS,
+  AI_SKILL_EXTRA_FRONTMATTER_MAX_CHARS,
+  AI_SKILL_INSTRUCTIONS_MAX_CHARS,
+  AI_SKILL_NAME_MAX_CHARS,
+  AI_SKILL_REFERENCE_MAX_CHARS,
   AI_SKILL_REFERENCE_MAX_ITEMS,
+  AI_SKILL_REFERENCE_PATH_PATTERN,
   AI_SKILL_REFERENCES_MAX_CHARS,
   type AiSkillDocument,
   type AiSkillReferenceInput,
+  isAiSkillManualOnly,
+  mountAiSkillInstructionLinks,
   parseAiSkillMarkdown,
   serializeAiSkillMarkdown,
+  splitAiSkillMarkdown,
   validateAiSkillReferences,
 } from "./skill-format";
 export { isAiImageMediaType } from "./types";
@@ -112,3 +187,37 @@ export const launchAssistant = async (input: LaunchAssistantInput): Promise<Assi
     href: `/app/assistant?conversation=${encodeURIComponent(conversation.id)}`,
   };
 };
+
+export {
+  CLOUD_AI_STATS_MAX_ITEMS,
+  CLOUD_AI_TABLE_MAX_COLUMNS,
+  CLOUD_AI_TABLE_MAX_ROWS,
+  CLOUD_AI_VIEW_DIRECTORY,
+  CLOUD_AI_VIEW_MAX_BYTES,
+  CLOUD_AI_VIEW_SUFFIX,
+  type CloudAiChartView,
+  type CloudAiDetailsView,
+  type CloudAiExplorerRequest,
+  type CloudAiExplorerView,
+  type CloudAiGroupView,
+  type CloudAiStatsView,
+  type CloudAiTableView,
+  type CloudAiView,
+  type CloudAiViewReference,
+  type CloudAiViewSummary,
+  CloudAiViewSummarySchema,
+  type CloudAiViewTable,
+  checkCloudAiView,
+  cloudAiDetailsRows,
+  cloudAiExplorerControls,
+  cloudAiExplorerState,
+  cloudAiStatsTiles,
+  cloudAiTableTsv,
+  cloudAiViewSummary,
+  cloudAiViewTable,
+  isAiViewFile,
+  isAiViewPath,
+  parseCloudAiChartToolView,
+  parseCloudAiView,
+  sortCloudAiViewRows,
+} from "./view-block";

package/src/ai/capabilities.ts

@@ -84,12 +84,13 @@ export type AiRememberableCapabilityApprovals = ReadonlyMap<string, string>;
 
 /**
  * Why `load_tools` could not make a requested name callable:
+ * - `skill`: the name is an Assistant Skill; load_skill loads it, not load_tools;
  * - `unknown`: no tool has this exact name;
  * - `not_offered_in_turn`: the tool exists, but this turn's client or task does not provide it;
  * - `not_allowed`: the conversation's fixed tool scope or task grants exclude it;
  * - `app_offline`: the app operation is not in the live registry now.
  */
-export const AI_TOOL_UNAVAILABLE_REASONS = ["unknown", "not_offered_in_turn", "not_allowed", "app_offline"] as const;
+export const AI_TOOL_UNAVAILABLE_REASONS = ["unknown", "skill", "not_offered_in_turn", "not_allowed", "app_offline"] as const;
 export type AiToolUnavailableReason = (typeof AI_TOOL_UNAVAILABLE_REASONS)[number];
 
 const DEFAULT_SEARCH_LIMIT = 10;
@@ -585,7 +586,7 @@ export const createAiToolMetaTools = (input: {
   const load = defineAiTool({
     name: "load_tools",
     description:
-      "Load stable capability ids such as mail.conversation.list, or exact built-in names returned by search_tools, as ordinary tools for the next model turn. Skills may name capability ids directly, so load them without searching first. Call each loaded tool by the `call` name returned for it. `unavailable` gives a reason per name: unknown means no tool has this exact name, so look it up once with search_tools instead of guessing; not_offered_in_turn means this client or task does not provide the tool; not_allowed means this chat's fixed tool scope or task grants exclude it; app_offline means its app is not reachable now. For the last three, do not search or load the name again in this turn.",
+      "Load stable capability ids such as mail.conversation.list, or exact built-in names returned by search_tools, as ordinary tools for the next model turn. Skills may name capability ids directly, so load them without searching first. Call each loaded tool by the `call` name returned for it. `unavailable` gives a reason per name: unknown means no tool has this exact name, so look it up once with search_tools instead of guessing; not_offered_in_turn means this client or task does not provide the tool; not_allowed means this chat's fixed tool scope or task grants exclude it; app_offline means its app is not reachable now; skill means the name is an Assistant Skill: call load_skill with it instead. For not_offered_in_turn, not_allowed and app_offline, do not search or load the name again in this turn.",
     inputSchema: z.object({ names: z.array(z.string().trim().min(1)).min(1).max(25) }).strict(),
     outputSchema: z
       .object({
@@ -749,6 +750,8 @@ export const createAiToolResolver =
     mandatePolicy?: MandatePolicyV1 | null;
     /** Built-in tools that exist but that this turn does not offer, such as client tools its client did not declare or tools outside `allowedTools`. */
     unofferedTools?: readonly string[];
+    /** Assistant Skills this turn can load with load_skill. */
+    skillNames?: readonly string[];
     runtimeContext?: Omit<AiToolPreparationContext, "actor" | "conversationId">;
     store: Pick<AiConversationService, "getLoadedTools" | "loadTools">;
     listRegistry?: () => Promise<CapabilityRegistryEntry[]>;
@@ -823,6 +826,7 @@ export const createAiToolResolver =
     );
     // App operation IDs always contain a dot; built-in names never do.
     const unavailableReason = (requested: string): AiToolUnavailableReason => {
+      if (input.skillNames?.includes(requested)) return "skill";
       const name = loadedByProviderName.get(requested) ?? requested;
       if (mandateExcluded.has(name)) return "not_allowed";
       if (allowed && outOfScope.has(name) && !allowed.has(name)) return "not_allowed";