@5ss/ai-tools 2.11.1

package/dist/modules/scheduler/index.js

@@ -0,0 +1,153 @@
+import { n as defineModule, r as defineTool } from "../../define-CvpJ_pNP.js";
+import { n as requireAuth } from "../../provider-CgDAlg6K.js";
+import { C as scheduleWriteOutputSchema, S as scheduleUpdateInputSchema, _ as scheduleListInputSchema, b as scheduleStateSchema, f as eventBridgeSchedulerAuthSchema, g as scheduleGetOutputSchema, h as scheduleDetailSchema, m as scheduleDeleteOutputSchema, p as scheduleCreateInputSchema, s as EventBridgeSchedulerClient, v as scheduleListOutputSchema, x as scheduleSummarySchema, y as scheduleNameInputSchema } from "../../eventbridge-scheduler-Bh6GqZY2.js";
+import { z } from "zod";
+//#region src/modules/scheduler/contracts.ts
+/**
+* Provider-neutral scheduler seam contracts.
+* Schedule shapes are reused from the EventBridge vendor until another provider
+* requires a broader shared contract.
+*/
+const eventBridgeSchedulerSeamAuthSchema = eventBridgeSchedulerAuthSchema.extend({ provider: z.literal("eventbridge") });
+const schedulerAuthSchema = eventBridgeSchedulerSeamAuthSchema;
+//#endregion
+//#region src/modules/scheduler/providers/eventbridge.ts
+var EventBridgeSchedulerProvider = class {
+	#client;
+	constructor(auth, options = {}) {
+		const { provider: _provider, ...vendorAuth } = auth;
+		this.#client = new EventBridgeSchedulerClient(vendorAuth, options);
+	}
+	create(input) {
+		return this.#client.create(input);
+	}
+	update(input) {
+		return this.#client.update(input);
+	}
+	get(input) {
+		return this.#client.get(input);
+	}
+	list(input = {}) {
+		return this.#client.list(input);
+	}
+	delete(input) {
+		return this.#client.delete(input);
+	}
+};
+//#endregion
+//#region src/modules/scheduler/client.ts
+function transportOptions(ctx) {
+	return {
+		...ctx.fetch && { fetch: ctx.fetch },
+		...ctx.signal && { signal: ctx.signal }
+	};
+}
+function providerFor(auth, ctx) {
+	switch (auth.provider) {
+		case "eventbridge": return new EventBridgeSchedulerProvider(auth, transportOptions(ctx));
+	}
+}
+var SchedulerClient = class SchedulerClient {
+	#ops;
+	constructor(ops) {
+		this.#ops = ops;
+	}
+	static fromContext(ctx) {
+		const auth = requireAuth(ctx, schedulerAuthSchema);
+		return new SchedulerClient(providerFor(auth, ctx));
+	}
+	static fromAuth(auth, ctx = {}) {
+		return new SchedulerClient(providerFor(auth, ctx));
+	}
+	create(input) {
+		return this.#ops.create(input);
+	}
+	update(input) {
+		return this.#ops.update(input);
+	}
+	get(input) {
+		return this.#ops.get(input);
+	}
+	list(input = {}) {
+		return this.#ops.list(input);
+	}
+	delete(input) {
+		return this.#ops.delete(input);
+	}
+};
+//#endregion
+//#region src/modules/scheduler/module.ts
+const schedulerCreateTool = defineTool({
+	id: "scheduler-create",
+	name: "createSchedule",
+	description: "Create a schedule on the bound provider for an opaque task reference. Supports one-time, recurring, and calendar expressions accepted by that provider.",
+	inputSchema: scheduleCreateInputSchema,
+	outputSchema: scheduleWriteOutputSchema,
+	sideEffect: "write",
+	runtime: "both",
+	execute: async (input, ctx) => SchedulerClient.fromContext(ctx).create(input)
+});
+const schedulerUpdateTool = defineTool({
+	id: "scheduler-update",
+	name: "updateSchedule",
+	description: "Replace an existing schedule on the bound provider. Read the schedule first when fields not supplied by this update must be retained.",
+	inputSchema: scheduleUpdateInputSchema,
+	outputSchema: scheduleWriteOutputSchema,
+	sideEffect: "write",
+	runtime: "both",
+	execute: async (input, ctx) => SchedulerClient.fromContext(ctx).update(input)
+});
+const schedulerGetTool = defineTool({
+	id: "scheduler-get",
+	name: "getSchedule",
+	description: "Get one schedule by name from the bound provider, including its task reference when available.",
+	inputSchema: scheduleNameInputSchema,
+	outputSchema: scheduleGetOutputSchema,
+	sideEffect: "read",
+	runtime: "both",
+	execute: async (input, ctx) => SchedulerClient.fromContext(ctx).get(input)
+});
+const schedulerListTool = defineTool({
+	id: "scheduler-list",
+	name: "listSchedules",
+	description: "List schedules from the bound provider with optional name, state, and pagination filters.",
+	inputSchema: scheduleListInputSchema,
+	outputSchema: scheduleListOutputSchema,
+	sideEffect: "read",
+	runtime: "both",
+	execute: async (input, ctx) => SchedulerClient.fromContext(ctx).list(input)
+});
+const schedulerDeleteTool = defineTool({
+	id: "scheduler-delete",
+	name: "deleteSchedule",
+	description: "Delete one schedule by name from the bound provider.",
+	inputSchema: scheduleNameInputSchema,
+	outputSchema: scheduleDeleteOutputSchema,
+	sideEffect: "delete",
+	runtime: "both",
+	execute: async (input, ctx) => SchedulerClient.fromContext(ctx).delete(input)
+});
+const schedulerModule = defineModule({
+	id: "scheduler",
+	title: "Scheduler",
+	description: "Create, replace, inspect, list, and delete schedules through the bound scheduling provider.",
+	runtime: "both",
+	auth: {
+		type: "custom",
+		schema: schedulerAuthSchema
+	},
+	categories: ["scheduler", "async"],
+	classification: "standard",
+	tags: ["cron", "eventbridge"],
+	tools: [
+		schedulerCreateTool,
+		schedulerUpdateTool,
+		schedulerGetTool,
+		schedulerListTool,
+		schedulerDeleteTool
+	]
+});
+//#endregion
+export { EventBridgeSchedulerProvider, SchedulerClient, eventBridgeSchedulerSeamAuthSchema, scheduleCreateInputSchema, scheduleDeleteOutputSchema, scheduleDetailSchema, scheduleGetOutputSchema, scheduleListInputSchema, scheduleListOutputSchema, scheduleNameInputSchema, scheduleStateSchema, scheduleSummarySchema, scheduleUpdateInputSchema, scheduleWriteOutputSchema, schedulerAuthSchema, schedulerCreateTool, schedulerDeleteTool, schedulerGetTool, schedulerListTool, schedulerModule, schedulerUpdateTool };
+
+//# sourceMappingURL=index.js.map

package/dist/modules/scheduler/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["#client","#ops"],"sources":["../../../src/modules/scheduler/contracts.ts","../../../src/modules/scheduler/providers/eventbridge.ts","../../../src/modules/scheduler/client.ts","../../../src/modules/scheduler/module.ts"],"sourcesContent":["/**\n * Provider-neutral scheduler seam contracts.\n * Schedule shapes are reused from the EventBridge vendor until another provider\n * requires a broader shared contract.\n */\n\nimport { z } from 'zod'\n\nimport {\n\teventBridgeSchedulerAuthSchema,\n\tscheduleCreateInputSchema,\n\tscheduleDeleteOutputSchema,\n\tscheduleDetailSchema,\n\tscheduleGetOutputSchema,\n\tscheduleListInputSchema,\n\tscheduleListOutputSchema,\n\tscheduleNameInputSchema,\n\tscheduleStateSchema,\n\tscheduleSummarySchema,\n\tscheduleUpdateInputSchema,\n\tscheduleWriteOutputSchema\n} from '../../vendors/eventbridge-scheduler'\nimport type {\n\tScheduleCreateInput,\n\tScheduleDeleteOutput,\n\tScheduleGetOutput,\n\tScheduleListInput,\n\tScheduleListOutput,\n\tScheduleNameInput,\n\tScheduleUpdateInput,\n\tScheduleWriteOutput\n} from '../../vendors/eventbridge-scheduler'\n\nexport {\n\tscheduleCreateInputSchema,\n\tscheduleDeleteOutputSchema,\n\tscheduleDetailSchema,\n\tscheduleGetOutputSchema,\n\tscheduleListInputSchema,\n\tscheduleListOutputSchema,\n\tscheduleNameInputSchema,\n\tscheduleStateSchema,\n\tscheduleSummarySchema,\n\tscheduleUpdateInputSchema,\n\tscheduleWriteOutputSchema\n}\nexport type {\n\tScheduleCreateInput,\n\tScheduleDeleteOutput,\n\tScheduleDetail,\n\tScheduleGetOutput,\n\tScheduleListInput,\n\tScheduleListOutput,\n\tScheduleNameInput,\n\tScheduleState,\n\tScheduleSummary,\n\tScheduleUpdateInput,\n\tScheduleWriteOutput\n} from '../../vendors/eventbridge-scheduler'\n\nexport const eventBridgeSchedulerSeamAuthSchema = eventBridgeSchedulerAuthSchema.extend({\n\tprovider: z.literal('eventbridge')\n})\n\nexport const schedulerAuthSchema = eventBridgeSchedulerSeamAuthSchema\n\nexport type EventBridgeSchedulerSeamAuth = z.infer<typeof eventBridgeSchedulerSeamAuthSchema>\nexport type SchedulerAuth = z.infer<typeof schedulerAuthSchema>\n\nexport type SchedulerOps = {\n\tcreate(input: ScheduleCreateInput): Promise<ScheduleWriteOutput>\n\tupdate(input: ScheduleUpdateInput): Promise<ScheduleWriteOutput>\n\tget(input: ScheduleNameInput): Promise<ScheduleGetOutput>\n\tlist(input?: ScheduleListInput): Promise<ScheduleListOutput>\n\tdelete(input: ScheduleNameInput): Promise<ScheduleDeleteOutput>\n}\n","import type { HttpServiceOptions } from '../../../transport/http-service'\nimport { EventBridgeSchedulerClient } from '../../../vendors/eventbridge-scheduler'\nimport type {\n\tEventBridgeSchedulerSeamAuth,\n\tScheduleCreateInput,\n\tScheduleListInput,\n\tScheduleNameInput,\n\tScheduleUpdateInput,\n\tSchedulerOps\n} from '../contracts'\n\nexport type EventBridgeSchedulerProviderOptions = Pick<HttpServiceOptions, 'fetch' | 'signal'>\n\nexport class EventBridgeSchedulerProvider implements SchedulerOps {\n\treadonly #client: EventBridgeSchedulerClient\n\n\tconstructor(auth: EventBridgeSchedulerSeamAuth, options: EventBridgeSchedulerProviderOptions = {}) {\n\t\tconst { provider: _provider, ...vendorAuth } = auth\n\t\tthis.#client = new EventBridgeSchedulerClient(vendorAuth, options)\n\t}\n\n\tcreate(input: ScheduleCreateInput) {\n\t\treturn this.#client.create(input)\n\t}\n\n\tupdate(input: ScheduleUpdateInput) {\n\t\treturn this.#client.update(input)\n\t}\n\n\tget(input: ScheduleNameInput) {\n\t\treturn this.#client.get(input)\n\t}\n\n\tlist(input: ScheduleListInput = {}) {\n\t\treturn this.#client.list(input)\n\t}\n\n\tdelete(input: ScheduleNameInput) {\n\t\treturn this.#client.delete(input)\n\t}\n}\n","import { requireAuth } from '../../core/provider'\nimport type { ToolContext } from '../../core/types'\nimport type {\n\tScheduleCreateInput,\n\tScheduleListInput,\n\tScheduleNameInput,\n\tScheduleUpdateInput,\n\tSchedulerAuth,\n\tSchedulerOps\n} from './contracts'\nimport { schedulerAuthSchema } from './contracts'\nimport { EventBridgeSchedulerProvider } from './providers/eventbridge'\n\nfunction transportOptions(ctx: ToolContext) {\n\treturn {\n\t\t...(ctx.fetch && { fetch: ctx.fetch }),\n\t\t...(ctx.signal && { signal: ctx.signal })\n\t}\n}\n\nfunction providerFor(auth: SchedulerAuth, ctx: ToolContext): SchedulerOps {\n\tswitch (auth.provider) {\n\t\tcase 'eventbridge':\n\t\t\treturn new EventBridgeSchedulerProvider(auth, transportOptions(ctx))\n\t}\n}\n\nexport class SchedulerClient implements SchedulerOps {\n\treadonly #ops: SchedulerOps\n\n\tconstructor(ops: SchedulerOps) {\n\t\tthis.#ops = ops\n\t}\n\n\tstatic fromContext(ctx: ToolContext): SchedulerClient {\n\t\tconst auth = requireAuth(ctx, schedulerAuthSchema)\n\t\treturn new SchedulerClient(providerFor(auth, ctx))\n\t}\n\n\tstatic fromAuth(auth: SchedulerAuth, ctx: ToolContext = {}): SchedulerClient {\n\t\treturn new SchedulerClient(providerFor(auth, ctx))\n\t}\n\n\tcreate(input: ScheduleCreateInput) {\n\t\treturn this.#ops.create(input)\n\t}\n\n\tupdate(input: ScheduleUpdateInput) {\n\t\treturn this.#ops.update(input)\n\t}\n\n\tget(input: ScheduleNameInput) {\n\t\treturn this.#ops.get(input)\n\t}\n\n\tlist(input: ScheduleListInput = {}) {\n\t\treturn this.#ops.list(input)\n\t}\n\n\tdelete(input: ScheduleNameInput) {\n\t\treturn this.#ops.delete(input)\n\t}\n}\n","import { defineModule, defineTool } from '../../core/define'\nimport { SchedulerClient } from './client'\nimport {\n\tscheduleCreateInputSchema,\n\tscheduleDeleteOutputSchema,\n\tscheduleGetOutputSchema,\n\tscheduleListInputSchema,\n\tscheduleListOutputSchema,\n\tscheduleNameInputSchema,\n\tscheduleUpdateInputSchema,\n\tscheduleWriteOutputSchema,\n\tschedulerAuthSchema\n} from './contracts'\n\nexport const schedulerCreateTool = defineTool({\n\tid: 'scheduler-create',\n\tname: 'createSchedule',\n\tdescription:\n\t\t'Create a schedule on the bound provider for an opaque task reference. Supports one-time, recurring, and calendar expressions accepted by that provider.',\n\tinputSchema: scheduleCreateInputSchema,\n\toutputSchema: scheduleWriteOutputSchema,\n\tsideEffect: 'write',\n\truntime: 'both',\n\texecute: async (input, ctx) => SchedulerClient.fromContext(ctx).create(input)\n})\n\nexport const schedulerUpdateTool = defineTool({\n\tid: 'scheduler-update',\n\tname: 'updateSchedule',\n\tdescription:\n\t\t'Replace an existing schedule on the bound provider. Read the schedule first when fields not supplied by this update must be retained.',\n\tinputSchema: scheduleUpdateInputSchema,\n\toutputSchema: scheduleWriteOutputSchema,\n\tsideEffect: 'write',\n\truntime: 'both',\n\texecute: async (input, ctx) => SchedulerClient.fromContext(ctx).update(input)\n})\n\nexport const schedulerGetTool = defineTool({\n\tid: 'scheduler-get',\n\tname: 'getSchedule',\n\tdescription: 'Get one schedule by name from the bound provider, including its task reference when available.',\n\tinputSchema: scheduleNameInputSchema,\n\toutputSchema: scheduleGetOutputSchema,\n\tsideEffect: 'read',\n\truntime: 'both',\n\texecute: async (input, ctx) => SchedulerClient.fromContext(ctx).get(input)\n})\n\nexport const schedulerListTool = defineTool({\n\tid: 'scheduler-list',\n\tname: 'listSchedules',\n\tdescription: 'List schedules from the bound provider with optional name, state, and pagination filters.',\n\tinputSchema: scheduleListInputSchema,\n\toutputSchema: scheduleListOutputSchema,\n\tsideEffect: 'read',\n\truntime: 'both',\n\texecute: async (input, ctx) => SchedulerClient.fromContext(ctx).list(input)\n})\n\nexport const schedulerDeleteTool = defineTool({\n\tid: 'scheduler-delete',\n\tname: 'deleteSchedule',\n\tdescription: 'Delete one schedule by name from the bound provider.',\n\tinputSchema: scheduleNameInputSchema,\n\toutputSchema: scheduleDeleteOutputSchema,\n\tsideEffect: 'delete',\n\truntime: 'both',\n\texecute: async (input, ctx) => SchedulerClient.fromContext(ctx).delete(input)\n})\n\nexport const schedulerModule = defineModule({\n\tid: 'scheduler',\n\ttitle: 'Scheduler',\n\tdescription: 'Create, replace, inspect, list, and delete schedules through the bound scheduling provider.',\n\truntime: 'both',\n\tauth: { type: 'custom', schema: schedulerAuthSchema },\n\tcategories: ['scheduler', 'async'],\n\tclassification: 'standard',\n\ttags: ['cron', 'eventbridge'],\n\ttools: [schedulerCreateTool, schedulerUpdateTool, schedulerGetTool, schedulerListTool, schedulerDeleteTool]\n})\n"],"mappings":"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"}

package/dist/modules/skills/index.d.ts

@@ -0,0 +1,205 @@
+import { a as ModuleDefinition, o as ToolContext, s as ToolDefinition } from "../../types-Ccb0DXY9.js";
+import "../../index-CZX5OeOF.js";
+import { z } from "zod";
+//#region src/modules/skills/contracts.d.ts
+declare const MAX_SKILLS = 200;
+declare const MAX_INSTRUCTIONS_CHARS = 100000;
+declare const MAX_SUPPORTING_FILES = 20;
+declare const MAX_SUPPORTING_FILE_CHARS = 50000;
+declare const MAX_SEARCH_RESULTS = 50;
+declare const skillSupportingFileSchema: z.ZodObject<{
+  path: z.ZodString;
+  media_type: z.ZodOptional<z.ZodString>;
+  text: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const skillDefinitionSchema: z.ZodObject<{
+  id: z.ZodString;
+  title: z.ZodString;
+  description: z.ZodString;
+  instructions: z.ZodString;
+  version: z.ZodOptional<z.ZodString>;
+  required_tool_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  required_tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  input_expectations: z.ZodOptional<z.ZodString>;
+  output_expectations: z.ZodOptional<z.ZodString>;
+  supporting_files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    path: z.ZodString;
+    media_type: z.ZodOptional<z.ZodString>;
+    text: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>>;
+}, z.core.$strip>;
+type SkillDefinition = z.infer<typeof skillDefinitionSchema>;
+type SkillSupportingFile = z.infer<typeof skillSupportingFileSchema>;
+/** Host binds the resolved catalog for this agent/org run. */
+declare const skillsAuthSchema: z.ZodObject<{
+  skills: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodString;
+    instructions: z.ZodString;
+    version: z.ZodOptional<z.ZodString>;
+    required_tool_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    required_tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    input_expectations: z.ZodOptional<z.ZodString>;
+    output_expectations: z.ZodOptional<z.ZodString>;
+    supporting_files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      path: z.ZodString;
+      media_type: z.ZodOptional<z.ZodString>;
+      text: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type SkillsAuth = z.infer<typeof skillsAuthSchema>;
+declare const skillSummarySchema: z.ZodObject<{
+  id: z.ZodString;
+  title: z.ZodString;
+  description: z.ZodString;
+  version: z.ZodOptional<z.ZodString>;
+  tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+type SkillSummary = z.infer<typeof skillSummarySchema>;
+declare const skillsListInputSchema: z.ZodObject<{
+  tag: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const skillsListOutputSchema: z.ZodObject<{
+  skills: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodString;
+    version: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const skillsGetInputSchema: z.ZodObject<{
+  id: z.ZodString;
+}, z.core.$strip>;
+declare const skillsGetOutputSchema: z.ZodObject<{
+  skill: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodString;
+    instructions: z.ZodString;
+    version: z.ZodOptional<z.ZodString>;
+    required_tool_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    required_tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    input_expectations: z.ZodOptional<z.ZodString>;
+    output_expectations: z.ZodOptional<z.ZodString>;
+    supporting_files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      path: z.ZodString;
+      media_type: z.ZodOptional<z.ZodString>;
+      text: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+  }, z.core.$strip>;
+}, z.core.$strip>;
+declare const skillsSearchInputSchema: z.ZodObject<{
+  query: z.ZodString;
+  tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  limit: z.ZodOptional<z.ZodInt>;
+}, z.core.$strip>;
+declare const skillsSearchOutputSchema: z.ZodObject<{
+  skills: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodString;
+    version: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type SkillsListInput = z.infer<typeof skillsListInputSchema>;
+type SkillsListOutput = z.infer<typeof skillsListOutputSchema>;
+type SkillsGetInput = z.infer<typeof skillsGetInputSchema>;
+type SkillsGetOutput = z.infer<typeof skillsGetOutputSchema>;
+type SkillsSearchInput = z.infer<typeof skillsSearchInputSchema>;
+type SkillsSearchOutput = z.infer<typeof skillsSearchOutputSchema>;
+//#endregion
+//#region src/modules/skills/client.d.ts
+declare class SkillsClient {
+  #private;
+  constructor(auth: SkillsAuth);
+  static fromContext(ctx: ToolContext): SkillsClient;
+  list(input?: SkillsListInput): SkillsListOutput;
+  get(input: SkillsGetInput): SkillsGetOutput;
+  search(input: SkillsSearchInput): SkillsSearchOutput;
+}
+//#endregion
+//#region src/modules/skills/domain.d.ts
+declare function toSummary(skill: SkillDefinition): SkillSummary;
+declare function listSkills(catalog: readonly SkillDefinition[], tag?: string): SkillSummary[];
+declare function getSkill(catalog: readonly SkillDefinition[], id: string): SkillDefinition;
+declare function searchSkills(catalog: readonly SkillDefinition[], options: {
+  query: string;
+  tags?: readonly string[] | undefined;
+  limit?: number | undefined;
+}): SkillSummary[];
+//#endregion
+//#region src/modules/skills/module.d.ts
+declare const skillsListTool: ToolDefinition<{
+  tag?: string | undefined;
+}, {
+  skills: {
+    id: string;
+    title: string;
+    description: string;
+    version?: string | undefined;
+    tags?: string[] | undefined;
+  }[];
+}>;
+declare const skillsGetTool: ToolDefinition<{
+  id: string;
+}, {
+  skill: {
+    id: string;
+    title: string;
+    description: string;
+    instructions: string;
+    version?: string | undefined;
+    required_tool_ids?: string[] | undefined;
+    required_tags?: string[] | undefined;
+    tags?: string[] | undefined;
+    input_expectations?: string | undefined;
+    output_expectations?: string | undefined;
+    supporting_files?: {
+      path: string;
+      media_type?: string | undefined;
+      text?: string | undefined;
+    }[] | undefined;
+  };
+}>;
+declare const skillsSearchTool: ToolDefinition<{
+  query: string;
+  tags?: string[] | undefined;
+  limit?: number | undefined;
+}, {
+  skills: {
+    id: string;
+    title: string;
+    description: string;
+    version?: string | undefined;
+    tags?: string[] | undefined;
+  }[];
+}>;
+declare const skillsModule: ModuleDefinition<{
+  skills: {
+    id: string;
+    title: string;
+    description: string;
+    instructions: string;
+    version?: string | undefined;
+    required_tool_ids?: string[] | undefined;
+    required_tags?: string[] | undefined;
+    tags?: string[] | undefined;
+    input_expectations?: string | undefined;
+    output_expectations?: string | undefined;
+    supporting_files?: {
+      path: string;
+      media_type?: string | undefined;
+      text?: string | undefined;
+    }[] | undefined;
+  }[];
+}>;
+//#endregion
+export { MAX_INSTRUCTIONS_CHARS, MAX_SEARCH_RESULTS, MAX_SKILLS, MAX_SUPPORTING_FILES, MAX_SUPPORTING_FILE_CHARS, type SkillDefinition, type SkillSummary, type SkillSupportingFile, type SkillsAuth, SkillsClient, type SkillsGetInput, type SkillsGetOutput, type SkillsListInput, type SkillsListOutput, type SkillsSearchInput, type SkillsSearchOutput, getSkill, listSkills, searchSkills, skillDefinitionSchema, skillSummarySchema, skillSupportingFileSchema, skillsAuthSchema, skillsGetInputSchema, skillsGetOutputSchema, skillsGetTool, skillsListInputSchema, skillsListOutputSchema, skillsListTool, skillsModule, skillsSearchInputSchema, skillsSearchOutputSchema, skillsSearchTool, toSummary };
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/skills/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/modules/skills/contracts.ts","../../../src/modules/skills/client.ts","../../../src/modules/skills/domain.ts","../../../src/modules/skills/module.ts"],"mappings":";;;;cAOa;cACA;cACA;cACA;cACA;cAQA,2BAAyB,EAAA;;;;GAIpC,EAAA,KAAA;cAEW,uBAAqB,EAAA;;;;;;;;;;;;;;;;GAoBhC,EAAA,KAAA;KAEU,kBAAkB,EAAE,aAAa;KACjC,sBAAsB,EAAE,aAAa;;cAGpC,kBAAgB,EAAA;;;;;;;;;;;;;;;;;;GAK3B,EAAA,KAAA;KAEU,aAAa,EAAE,aAAa;cAE3B,oBAAkB,EAAA;;;;;;GAM7B,EAAA,KAAA;KAEU,eAAe,EAAE,aAAa;cAE7B,uBAAqB,EAAA;;GAEhC,EAAA,KAAA;cAEW,wBAAsB,EAAA;;;;;;;;GAEjC,EAAA,KAAA;cAEW,sBAAoB,EAAA;;GAE/B,EAAA,KAAA;cAEW,uBAAqB,EAAA;;;;;;;;;;;;;;;;;;GAEhC,EAAA,KAAA;cAEW,yBAAuB,EAAA;;;;GAIlC,EAAA,KAAA;cAEW,0BAAwB,EAAA;;;;;;;;GAEnC,EAAA,KAAA;KAEU,kBAAkB,EAAE,aAAa;KACjC,mBAAmB,EAAE,aAAa;KAClC,iBAAiB,EAAE,aAAa;KAChC,kBAAkB,EAAE,aAAa;KACjC,oBAAoB,EAAE,aAAa;KACnC,qBAAqB,EAAE,aAAa;;;cCjFnC;;EAGZ,YAAY,MAAM;SAWX,YAAY,KAAK,cAAc;EAKtC,KAAK,QAAO,kBAAuB;EAInC,IAAI,OAAO,iBAAiB;EAI5B,OAAO,OAAO,oBAAoB;;;;iBCtCnB,UAAU,OAAO,kBAAkB;iBAWnC,WAAW,kBAAkB,mBAAmB,eAAe;iBAQ/D,SAAS,kBAAkB,mBAAmB,aAAa;iBAgD3D,aACf,kBAAkB,mBAClB;EAAW;EAAe;EAAsC;IAC9D;;;cChEU,gBAAA;;;;;;;;;;;cAYA,eAAA;;;;;;;;;;;;;;;;;;;;;cAYA,kBAAA;;;;;;;;;;;;;cAYA,cAAA"}

package/dist/modules/skills/index.js

@@ -0,0 +1,203 @@
+import { t as ToolError } from "../../errors-DoSpNHvs.js";
+import { n as defineModule, r as defineTool } from "../../define-CvpJ_pNP.js";
+import { n as requireAuth } from "../../provider-CgDAlg6K.js";
+import { isString } from "es-toolkit";
+import { z } from "zod";
+//#region src/modules/skills/contracts.ts
+/**
+* Portable skill definitions + host-bound catalog auth.
+* Org assignment / persistence stays on the host.
+*/
+const MAX_SKILLS = 200;
+const MAX_INSTRUCTIONS_CHARS = 1e5;
+const MAX_SUPPORTING_FILES = 20;
+const MAX_SUPPORTING_FILE_CHARS = 5e4;
+const MAX_SEARCH_RESULTS = 50;
+const kebabId = z.string().min(1).max(128).regex(/^[a-z][a-z0-9]*(-[a-z0-9]+)*$/, "Must be lowercase kebab-case");
+const skillSupportingFileSchema = z.object({
+	path: z.string().min(1).max(512).describe("Relative path for the supporting file"),
+	media_type: z.string().min(1).max(200).optional().describe("MIME type when known"),
+	text: z.string().max(MAX_SUPPORTING_FILE_CHARS).optional().describe("Small text body for the supporting file")
+});
+const skillDefinitionSchema = z.object({
+	id: kebabId.describe("Stable skill id (kebab-case)"),
+	title: z.string().min(1).max(200).describe("Short display title"),
+	description: z.string().min(1).max(2e3).describe("When to use this skill"),
+	instructions: z.string().min(1).max(MAX_INSTRUCTIONS_CHARS).describe("Full skill instructions (markdown or plain text)"),
+	version: z.string().min(1).max(64).optional().describe("Skill version string"),
+	required_tool_ids: z.array(kebabId).max(100).optional().describe("Tool ids this skill expects to be available"),
+	required_tags: z.array(z.string().min(1).max(64)).max(50).optional().describe("Required catalog tags"),
+	tags: z.array(z.string().min(1).max(64)).max(50).optional().describe("Searchable tags"),
+	input_expectations: z.string().max(5e3).optional().describe("What inputs the skill expects"),
+	output_expectations: z.string().max(5e3).optional().describe("What outputs the skill should produce"),
+	supporting_files: z.array(skillSupportingFileSchema).max(20).optional().describe("Optional small supporting text files")
+});
+/** Host binds the resolved catalog for this agent/org run. */
+const skillsAuthSchema = z.object({ skills: z.array(skillDefinitionSchema).max(200).describe("Host-resolved skill catalog for this bind (assignment stays host-side)") });
+const skillSummarySchema = z.object({
+	id: z.string().describe("Skill id"),
+	title: z.string().describe("Display title"),
+	description: z.string().describe("When to use"),
+	version: z.string().optional().describe("Version when set"),
+	tags: z.array(z.string()).optional().describe("Tags when set")
+});
+const skillsListInputSchema = z.object({ tag: z.string().min(1).max(64).optional().describe("Optional tag filter (exact match)") });
+const skillsListOutputSchema = z.object({ skills: z.array(skillSummarySchema).describe("Catalog summaries (instructions omitted)") });
+const skillsGetInputSchema = z.object({ id: kebabId.describe("Skill id to load") });
+const skillsGetOutputSchema = z.object({ skill: skillDefinitionSchema.describe("Full skill definition") });
+const skillsSearchInputSchema = z.object({
+	query: z.string().min(1).max(500).describe("Free-text query over title, description, tags, instructions"),
+	tags: z.array(z.string().min(1).max(64)).max(20).optional().describe("Optional tags that must all match"),
+	limit: z.int().min(1).max(50).optional().describe("Max results (default 10)")
+});
+const skillsSearchOutputSchema = z.object({ skills: z.array(skillSummarySchema).describe("Matching skill summaries, best first") });
+//#endregion
+//#region src/modules/skills/domain.ts
+/**
+* Pure skill catalog helpers (no HTTP).
+*/
+function toSummary(skill) {
+	const out = {
+		id: skill.id,
+		title: skill.title,
+		description: skill.description
+	};
+	if (skill.version !== void 0) out.version = skill.version;
+	if (skill.tags !== void 0) out.tags = skill.tags;
+	return out;
+}
+function listSkills(catalog, tag) {
+	return (tag === void 0 ? catalog : catalog.filter((s) => (s.tags ?? []).some((t) => t.toLowerCase() === tag.toLowerCase()))).map(toSummary);
+}
+function getSkill(catalog, id) {
+	const found = catalog.find((s) => s.id === id);
+	if (!found) throw new ToolError(`Skill not found: ${id}`, {
+		code: "not_found",
+		details: { id }
+	});
+	return found;
+}
+function fieldScore(haystack, token, weight) {
+	return haystack.includes(token) ? weight : 0;
+}
+function scoreSkill(skill, query, requiredTags) {
+	const q = query.toLowerCase().trim();
+	const tags = (skill.tags ?? []).map((t) => t.toLowerCase());
+	for (const t of requiredTags) if (!tags.includes(t.toLowerCase())) return -1;
+	if (q.length === 0) return 0;
+	const id = skill.id.toLowerCase();
+	const title = skill.title.toLowerCase();
+	const description = skill.description.toLowerCase();
+	const instructions = skill.instructions.toLowerCase();
+	const tokens = q.split(/[\s/_-]+/).filter((t) => t.length > 0);
+	let score = 0;
+	if (id === q) score += 100;
+	if (id.includes(q)) score += 40;
+	if (title.includes(q)) score += 30;
+	if (description.includes(q)) score += 20;
+	for (const token of tokens) {
+		score += fieldScore(id, token, 25);
+		score += fieldScore(title, token, 20);
+		score += fieldScore(description, token, 12);
+		if (tags.some((t) => t.includes(token))) score += 15;
+		score += fieldScore(instructions, token, 4);
+		if (isString(skill.input_expectations)) score += fieldScore(skill.input_expectations.toLowerCase(), token, 2);
+		if (isString(skill.output_expectations)) score += fieldScore(skill.output_expectations.toLowerCase(), token, 2);
+	}
+	return score;
+}
+function searchSkills(catalog, options) {
+	const requiredTags = options.tags ?? [];
+	const limit = options.limit ?? 10;
+	return catalog.map((skill) => ({
+		skill,
+		score: scoreSkill(skill, options.query, requiredTags)
+	})).filter((row) => row.score > 0).sort((a, b) => b.score - a.score || a.skill.id.localeCompare(b.skill.id)).slice(0, limit).map((row) => toSummary(row.skill));
+}
+//#endregion
+//#region src/modules/skills/client.ts
+/**
+* Skills catalog client — host binds the resolved skill list.
+*/
+var SkillsClient = class SkillsClient {
+	#catalog;
+	constructor(auth) {
+		const parsed = skillsAuthSchema.safeParse(auth);
+		if (!parsed.success) throw new ToolError("Invalid skills auth catalog", {
+			code: "bad_auth",
+			details: { issues: parsed.error.issues.map((issue) => issue.message) }
+		});
+		this.#catalog = parsed.data.skills;
+	}
+	static fromContext(ctx) {
+		const auth = requireAuth(ctx, skillsAuthSchema);
+		return new SkillsClient(auth);
+	}
+	list(input = {}) {
+		return { skills: listSkills(this.#catalog, input.tag) };
+	}
+	get(input) {
+		return { skill: getSkill(this.#catalog, input.id) };
+	}
+	search(input) {
+		return { skills: searchSkills(this.#catalog, {
+			query: input.query,
+			...input.tags && { tags: input.tags },
+			...input.limit !== void 0 && { limit: input.limit }
+		}) };
+	}
+};
+//#endregion
+//#region src/modules/skills/module.ts
+const skillsListTool = defineTool({
+	id: "skills-list",
+	name: "listSkills",
+	description: "List skills available in the bound catalog as short summaries (id, title, description, tags). Does not return full instructions. Optional tag filter.",
+	inputSchema: skillsListInputSchema,
+	outputSchema: skillsListOutputSchema,
+	sideEffect: "none",
+	runtime: "both",
+	execute: async (input, ctx) => SkillsClient.fromContext(ctx).list(input)
+});
+const skillsGetTool = defineTool({
+	id: "skills-get",
+	name: "getSkill",
+	description: "Load one skill by id from the bound catalog, including full instructions, required tool ids, and supporting files when present.",
+	inputSchema: skillsGetInputSchema,
+	outputSchema: skillsGetOutputSchema,
+	sideEffect: "none",
+	runtime: "both",
+	execute: async (input, ctx) => SkillsClient.fromContext(ctx).get(input)
+});
+const skillsSearchTool = defineTool({
+	id: "skills-search",
+	name: "searchSkills",
+	description: "Search the bound skill catalog by free text and optional tags. Returns matching summaries ordered by relevance. Use skills-get for full instructions.",
+	inputSchema: skillsSearchInputSchema,
+	outputSchema: skillsSearchOutputSchema,
+	sideEffect: "none",
+	runtime: "both",
+	execute: async (input, ctx) => SkillsClient.fromContext(ctx).search(input)
+});
+const skillsModule = defineModule({
+	id: "skills",
+	title: "Skills",
+	description: "List, search, and load portable skill definitions, including instructions and required tool ids.",
+	runtime: "both",
+	auth: {
+		type: "custom",
+		schema: skillsAuthSchema
+	},
+	categories: ["agent", "skills"],
+	classification: "standard",
+	tags: ["catalog"],
+	tools: [
+		skillsListTool,
+		skillsGetTool,
+		skillsSearchTool
+	]
+});
+//#endregion
+export { MAX_INSTRUCTIONS_CHARS, MAX_SEARCH_RESULTS, MAX_SKILLS, MAX_SUPPORTING_FILES, MAX_SUPPORTING_FILE_CHARS, SkillsClient, getSkill, listSkills, searchSkills, skillDefinitionSchema, skillSummarySchema, skillSupportingFileSchema, skillsAuthSchema, skillsGetInputSchema, skillsGetOutputSchema, skillsGetTool, skillsListInputSchema, skillsListOutputSchema, skillsListTool, skillsModule, skillsSearchInputSchema, skillsSearchOutputSchema, skillsSearchTool, toSummary };
+
+//# sourceMappingURL=index.js.map

package/dist/modules/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["#catalog"],"sources":["../../../src/modules/skills/contracts.ts","../../../src/modules/skills/domain.ts","../../../src/modules/skills/client.ts","../../../src/modules/skills/module.ts"],"sourcesContent":["/**\n * Portable skill definitions + host-bound catalog auth.\n * Org assignment / persistence stays on the host.\n */\n\nimport { z } from 'zod'\n\nexport const MAX_SKILLS = 200\nexport const MAX_INSTRUCTIONS_CHARS = 100_000\nexport const MAX_SUPPORTING_FILES = 20\nexport const MAX_SUPPORTING_FILE_CHARS = 50_000\nexport const MAX_SEARCH_RESULTS = 50\n\nconst kebabId = z\n\t.string()\n\t.min(1)\n\t.max(128)\n\t.regex(/^[a-z][a-z0-9]*(-[a-z0-9]+)*$/, 'Must be lowercase kebab-case')\n\nexport const skillSupportingFileSchema = z.object({\n\tpath: z.string().min(1).max(512).describe('Relative path for the supporting file'),\n\tmedia_type: z.string().min(1).max(200).optional().describe('MIME type when known'),\n\ttext: z.string().max(MAX_SUPPORTING_FILE_CHARS).optional().describe('Small text body for the supporting file')\n})\n\nexport const skillDefinitionSchema = z.object({\n\tid: kebabId.describe('Stable skill id (kebab-case)'),\n\ttitle: z.string().min(1).max(200).describe('Short display title'),\n\tdescription: z.string().min(1).max(2_000).describe('When to use this skill'),\n\tinstructions: z\n\t\t.string()\n\t\t.min(1)\n\t\t.max(MAX_INSTRUCTIONS_CHARS)\n\t\t.describe('Full skill instructions (markdown or plain text)'),\n\tversion: z.string().min(1).max(64).optional().describe('Skill version string'),\n\trequired_tool_ids: z.array(kebabId).max(100).optional().describe('Tool ids this skill expects to be available'),\n\trequired_tags: z.array(z.string().min(1).max(64)).max(50).optional().describe('Required catalog tags'),\n\ttags: z.array(z.string().min(1).max(64)).max(50).optional().describe('Searchable tags'),\n\tinput_expectations: z.string().max(5_000).optional().describe('What inputs the skill expects'),\n\toutput_expectations: z.string().max(5_000).optional().describe('What outputs the skill should produce'),\n\tsupporting_files: z\n\t\t.array(skillSupportingFileSchema)\n\t\t.max(MAX_SUPPORTING_FILES)\n\t\t.optional()\n\t\t.describe('Optional small supporting text files')\n})\n\nexport type SkillDefinition = z.infer<typeof skillDefinitionSchema>\nexport type SkillSupportingFile = z.infer<typeof skillSupportingFileSchema>\n\n/** Host binds the resolved catalog for this agent/org run. */\nexport const skillsAuthSchema = z.object({\n\tskills: z\n\t\t.array(skillDefinitionSchema)\n\t\t.max(MAX_SKILLS)\n\t\t.describe('Host-resolved skill catalog for this bind (assignment stays host-side)')\n})\n\nexport type SkillsAuth = z.infer<typeof skillsAuthSchema>\n\nexport const skillSummarySchema = z.object({\n\tid: z.string().describe('Skill id'),\n\ttitle: z.string().describe('Display title'),\n\tdescription: z.string().describe('When to use'),\n\tversion: z.string().optional().describe('Version when set'),\n\ttags: z.array(z.string()).optional().describe('Tags when set')\n})\n\nexport type SkillSummary = z.infer<typeof skillSummarySchema>\n\nexport const skillsListInputSchema = z.object({\n\ttag: z.string().min(1).max(64).optional().describe('Optional tag filter (exact match)')\n})\n\nexport const skillsListOutputSchema = z.object({\n\tskills: z.array(skillSummarySchema).describe('Catalog summaries (instructions omitted)')\n})\n\nexport const skillsGetInputSchema = z.object({\n\tid: kebabId.describe('Skill id to load')\n})\n\nexport const skillsGetOutputSchema = z.object({\n\tskill: skillDefinitionSchema.describe('Full skill definition')\n})\n\nexport const skillsSearchInputSchema = z.object({\n\tquery: z.string().min(1).max(500).describe('Free-text query over title, description, tags, instructions'),\n\ttags: z.array(z.string().min(1).max(64)).max(20).optional().describe('Optional tags that must all match'),\n\tlimit: z.int().min(1).max(MAX_SEARCH_RESULTS).optional().describe('Max results (default 10)')\n})\n\nexport const skillsSearchOutputSchema = z.object({\n\tskills: z.array(skillSummarySchema).describe('Matching skill summaries, best first')\n})\n\nexport type SkillsListInput = z.infer<typeof skillsListInputSchema>\nexport type SkillsListOutput = z.infer<typeof skillsListOutputSchema>\nexport type SkillsGetInput = z.infer<typeof skillsGetInputSchema>\nexport type SkillsGetOutput = z.infer<typeof skillsGetOutputSchema>\nexport type SkillsSearchInput = z.infer<typeof skillsSearchInputSchema>\nexport type SkillsSearchOutput = z.infer<typeof skillsSearchOutputSchema>\n","/**\n * Pure skill catalog helpers (no HTTP).\n */\n\nimport { isString } from 'es-toolkit'\n\nimport { ToolError } from '../../core/errors'\nimport type { SkillDefinition, SkillSummary } from './contracts'\n\nexport function toSummary(skill: SkillDefinition): SkillSummary {\n\tconst out: SkillSummary = {\n\t\tid: skill.id,\n\t\ttitle: skill.title,\n\t\tdescription: skill.description\n\t}\n\tif (skill.version !== undefined) out.version = skill.version\n\tif (skill.tags !== undefined) out.tags = skill.tags\n\treturn out\n}\n\nexport function listSkills(catalog: readonly SkillDefinition[], tag?: string): SkillSummary[] {\n\tconst filtered =\n\t\ttag === undefined\n\t\t\t? catalog\n\t\t\t: catalog.filter((s) => (s.tags ?? []).some((t) => t.toLowerCase() === tag.toLowerCase()))\n\treturn filtered.map(toSummary)\n}\n\nexport function getSkill(catalog: readonly SkillDefinition[], id: string): SkillDefinition {\n\tconst found = catalog.find((s) => s.id === id)\n\tif (!found) {\n\t\tthrow new ToolError(`Skill not found: ${id}`, { code: 'not_found', details: { id } })\n\t}\n\treturn found\n}\n\nfunction fieldScore(haystack: string, token: string, weight: number): number {\n\treturn haystack.includes(token) ? weight : 0\n}\n\nfunction scoreSkill(skill: SkillDefinition, query: string, requiredTags: readonly string[]): number {\n\tconst q = query.toLowerCase().trim()\n\tconst tags = (skill.tags ?? []).map((t) => t.toLowerCase())\n\tfor (const t of requiredTags) {\n\t\tif (!tags.includes(t.toLowerCase())) return -1\n\t}\n\tif (q.length === 0) return 0\n\n\tconst id = skill.id.toLowerCase()\n\tconst title = skill.title.toLowerCase()\n\tconst description = skill.description.toLowerCase()\n\tconst instructions = skill.instructions.toLowerCase()\n\tconst tokens = q.split(/[\\s/_-]+/).filter((t) => t.length > 0)\n\n\tlet score = 0\n\tif (id === q) score += 100\n\tif (id.includes(q)) score += 40\n\tif (title.includes(q)) score += 30\n\tif (description.includes(q)) score += 20\n\n\tfor (const token of tokens) {\n\t\tscore += fieldScore(id, token, 25)\n\t\tscore += fieldScore(title, token, 20)\n\t\tscore += fieldScore(description, token, 12)\n\t\tif (tags.some((t) => t.includes(token))) score += 15\n\t\tscore += fieldScore(instructions, token, 4)\n\t\tif (isString(skill.input_expectations)) {\n\t\t\tscore += fieldScore(skill.input_expectations.toLowerCase(), token, 2)\n\t\t}\n\t\tif (isString(skill.output_expectations)) {\n\t\t\tscore += fieldScore(skill.output_expectations.toLowerCase(), token, 2)\n\t\t}\n\t}\n\treturn score\n}\n\nexport function searchSkills(\n\tcatalog: readonly SkillDefinition[],\n\toptions: { query: string; tags?: readonly string[] | undefined; limit?: number | undefined }\n): SkillSummary[] {\n\tconst requiredTags = options.tags ?? []\n\tconst limit = options.limit ?? 10\n\tconst ranked = catalog\n\t\t.map((skill) => ({ skill, score: scoreSkill(skill, options.query, requiredTags) }))\n\t\t.filter((row) => row.score > 0)\n\t\t.sort((a, b) => b.score - a.score || a.skill.id.localeCompare(b.skill.id))\n\t\t.slice(0, limit)\n\treturn ranked.map((row) => toSummary(row.skill))\n}\n","/**\n * Skills catalog client — host binds the resolved skill list.\n */\n\nimport { ToolError } from '../../core/errors'\nimport { requireAuth } from '../../core/provider'\nimport type { ToolContext } from '../../core/types'\nimport type {\n\tSkillDefinition,\n\tSkillsAuth,\n\tSkillsGetInput,\n\tSkillsGetOutput,\n\tSkillsListInput,\n\tSkillsListOutput,\n\tSkillsSearchInput,\n\tSkillsSearchOutput\n} from './contracts'\nimport { skillsAuthSchema } from './contracts'\nimport { getSkill, listSkills, searchSkills } from './domain'\n\nexport class SkillsClient {\n\treadonly #catalog: readonly SkillDefinition[]\n\n\tconstructor(auth: SkillsAuth) {\n\t\tconst parsed = skillsAuthSchema.safeParse(auth)\n\t\tif (!parsed.success) {\n\t\t\tthrow new ToolError('Invalid skills auth catalog', {\n\t\t\t\tcode: 'bad_auth',\n\t\t\t\tdetails: { issues: parsed.error.issues.map((issue) => issue.message) }\n\t\t\t})\n\t\t}\n\t\tthis.#catalog = parsed.data.skills\n\t}\n\n\tstatic fromContext(ctx: ToolContext): SkillsClient {\n\t\tconst auth = requireAuth(ctx, skillsAuthSchema)\n\t\treturn new SkillsClient(auth)\n\t}\n\n\tlist(input: SkillsListInput = {}): SkillsListOutput {\n\t\treturn { skills: listSkills(this.#catalog, input.tag) }\n\t}\n\n\tget(input: SkillsGetInput): SkillsGetOutput {\n\t\treturn { skill: getSkill(this.#catalog, input.id) }\n\t}\n\n\tsearch(input: SkillsSearchInput): SkillsSearchOutput {\n\t\treturn {\n\t\t\tskills: searchSkills(this.#catalog, {\n\t\t\t\tquery: input.query,\n\t\t\t\t...(input.tags && { tags: input.tags }),\n\t\t\t\t...(input.limit !== undefined && { limit: input.limit })\n\t\t\t})\n\t\t}\n\t}\n}\n","import { defineModule, defineTool } from '../../core/define'\nimport { SkillsClient } from './client'\nimport {\n\tskillsAuthSchema,\n\tskillsGetInputSchema,\n\tskillsGetOutputSchema,\n\tskillsListInputSchema,\n\tskillsListOutputSchema,\n\tskillsSearchInputSchema,\n\tskillsSearchOutputSchema\n} from './contracts'\n\nexport type { SkillsAuth } from './contracts'\nexport { skillsAuthSchema }\n\nexport const skillsListTool = defineTool({\n\tid: 'skills-list',\n\tname: 'listSkills',\n\tdescription:\n\t\t'List skills available in the bound catalog as short summaries (id, title, description, tags). Does not return full instructions. Optional tag filter.',\n\tinputSchema: skillsListInputSchema,\n\toutputSchema: skillsListOutputSchema,\n\tsideEffect: 'none',\n\truntime: 'both',\n\texecute: async (input, ctx) => SkillsClient.fromContext(ctx).list(input)\n})\n\nexport const skillsGetTool = defineTool({\n\tid: 'skills-get',\n\tname: 'getSkill',\n\tdescription:\n\t\t'Load one skill by id from the bound catalog, including full instructions, required tool ids, and supporting files when present.',\n\tinputSchema: skillsGetInputSchema,\n\toutputSchema: skillsGetOutputSchema,\n\tsideEffect: 'none',\n\truntime: 'both',\n\texecute: async (input, ctx) => SkillsClient.fromContext(ctx).get(input)\n})\n\nexport const skillsSearchTool = defineTool({\n\tid: 'skills-search',\n\tname: 'searchSkills',\n\tdescription:\n\t\t'Search the bound skill catalog by free text and optional tags. Returns matching summaries ordered by relevance. Use skills-get for full instructions.',\n\tinputSchema: skillsSearchInputSchema,\n\toutputSchema: skillsSearchOutputSchema,\n\tsideEffect: 'none',\n\truntime: 'both',\n\texecute: async (input, ctx) => SkillsClient.fromContext(ctx).search(input)\n})\n\nexport const skillsModule = defineModule({\n\tid: 'skills',\n\ttitle: 'Skills',\n\tdescription: 'List, search, and load portable skill definitions, including instructions and required tool ids.',\n\truntime: 'both',\n\tauth: { type: 'custom', schema: skillsAuthSchema },\n\tcategories: ['agent', 'skills'],\n\tclassification: 'standard',\n\ttags: ['catalog'],\n\ttools: [skillsListTool, skillsGetTool, skillsSearchTool]\n})\n"],"mappings":"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"}