@troykelly/openclaw-projects 0.0.1 → 0.0.3

package/dist/tools/skill-store.d.ts

@@ -0,0 +1,277 @@
+/**
+ * Skill Store tools for OpenClaw plugin (Issue #800).
+ *
+ * Provides CRUD operations for skill-scoped persistent storage:
+ * - skill_store_put: Create or upsert items
+ * - skill_store_get: Get by ID or composite key
+ * - skill_store_list: List/filter/paginate items
+ * - skill_store_delete: Soft delete by ID or composite key
+ */
+import { z } from 'zod';
+import type { ApiClient } from '../api-client.js';
+import type { Logger } from '../logger.js';
+import type { PluginConfig } from '../config.js';
+/** Zod schema for skill_store_put parameters */
+export declare const SkillStorePutParamsSchema: z.ZodObject<{
+    skill_id: z.ZodString;
+    collection: z.ZodOptional<z.ZodString>;
+    key: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    summary: z.ZodOptional<z.ZodString>;
+    content: z.ZodOptional<z.ZodString>;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    media_url: z.ZodOptional<z.ZodString>;
+    media_type: z.ZodOptional<z.ZodString>;
+    source_url: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    priority: z.ZodOptional<z.ZodNumber>;
+    expires_at: z.ZodOptional<z.ZodString>;
+    pinned: z.ZodOptional<z.ZodBoolean>;
+    user_email: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    skill_id: string;
+    key?: string | undefined;
+    data?: Record<string, unknown> | undefined;
+    tags?: string[] | undefined;
+    content?: string | undefined;
+    title?: string | undefined;
+    summary?: string | undefined;
+    user_email?: string | undefined;
+    collection?: string | undefined;
+    media_url?: string | undefined;
+    media_type?: string | undefined;
+    source_url?: string | undefined;
+    priority?: number | undefined;
+    expires_at?: string | undefined;
+    pinned?: boolean | undefined;
+}, {
+    skill_id: string;
+    key?: string | undefined;
+    data?: Record<string, unknown> | undefined;
+    tags?: string[] | undefined;
+    content?: string | undefined;
+    title?: string | undefined;
+    summary?: string | undefined;
+    user_email?: string | undefined;
+    collection?: string | undefined;
+    media_url?: string | undefined;
+    media_type?: string | undefined;
+    source_url?: string | undefined;
+    priority?: number | undefined;
+    expires_at?: string | undefined;
+    pinned?: boolean | undefined;
+}>;
+export type SkillStorePutParams = z.infer<typeof SkillStorePutParamsSchema>;
+/** Zod schema for skill_store_get parameters */
+export declare const SkillStoreGetParamsSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    skill_id: z.ZodOptional<z.ZodString>;
+    collection: z.ZodOptional<z.ZodString>;
+    key: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    key?: string | undefined;
+    id?: string | undefined;
+    skill_id?: string | undefined;
+    collection?: string | undefined;
+}, {
+    key?: string | undefined;
+    id?: string | undefined;
+    skill_id?: string | undefined;
+    collection?: string | undefined;
+}>;
+export type SkillStoreGetParams = z.infer<typeof SkillStoreGetParamsSchema>;
+/** Zod schema for skill_store_list parameters */
+export declare const SkillStoreListParamsSchema: z.ZodObject<{
+    skill_id: z.ZodString;
+    collection: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<["active", "archived", "processing"]>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    since: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+    order_by: z.ZodOptional<z.ZodEnum<["created_at", "updated_at", "title", "priority"]>>;
+    user_email: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    skill_id: string;
+    status?: "active" | "archived" | "processing" | undefined;
+    limit?: number | undefined;
+    tags?: string[] | undefined;
+    offset?: number | undefined;
+    user_email?: string | undefined;
+    collection?: string | undefined;
+    since?: string | undefined;
+    order_by?: "title" | "priority" | "created_at" | "updated_at" | undefined;
+}, {
+    skill_id: string;
+    status?: "active" | "archived" | "processing" | undefined;
+    limit?: number | undefined;
+    tags?: string[] | undefined;
+    offset?: number | undefined;
+    user_email?: string | undefined;
+    collection?: string | undefined;
+    since?: string | undefined;
+    order_by?: "title" | "priority" | "created_at" | "updated_at" | undefined;
+}>;
+export type SkillStoreListParams = z.infer<typeof SkillStoreListParamsSchema>;
+/** Zod schema for skill_store_delete parameters */
+export declare const SkillStoreDeleteParamsSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    skill_id: z.ZodOptional<z.ZodString>;
+    collection: z.ZodOptional<z.ZodString>;
+    key: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    key?: string | undefined;
+    id?: string | undefined;
+    skill_id?: string | undefined;
+    collection?: string | undefined;
+}, {
+    key?: string | undefined;
+    id?: string | undefined;
+    skill_id?: string | undefined;
+    collection?: string | undefined;
+}>;
+export type SkillStoreDeleteParams = z.infer<typeof SkillStoreDeleteParamsSchema>;
+/** Skill store item response from API */
+export interface SkillStoreItem {
+    id: string;
+    skill_id: string;
+    collection: string;
+    key: string | null;
+    title: string | null;
+    summary: string | null;
+    content: string | null;
+    data: Record<string, unknown>;
+    media_url: string | null;
+    media_type: string | null;
+    source_url: string | null;
+    status: string;
+    tags: string[];
+    priority: number | null;
+    expires_at: string | null;
+    pinned: boolean;
+    user_email: string | null;
+    created_at: string;
+    updated_at: string;
+}
+/** Tool result types */
+export interface SkillStoreToolSuccess {
+    success: true;
+    data: {
+        content: string;
+        details: Record<string, unknown>;
+    };
+}
+export interface SkillStoreToolFailure {
+    success: false;
+    error: string;
+}
+export type SkillStoreToolResult = SkillStoreToolSuccess | SkillStoreToolFailure;
+/** Tool options */
+export interface SkillStoreToolOptions {
+    client: ApiClient;
+    logger: Logger;
+    config?: PluginConfig;
+    userId: string;
+}
+/** Tool definition interface */
+export interface SkillStoreTool {
+    name: string;
+    description: string;
+    parameters: z.ZodType;
+    execute: (params: Record<string, unknown>) => Promise<SkillStoreToolResult>;
+}
+/**
+ * Create the skill_store_put tool.
+ */
+export declare function createSkillStorePutTool(options: SkillStoreToolOptions): SkillStoreTool;
+/**
+ * Create the skill_store_get tool.
+ */
+export declare function createSkillStoreGetTool(options: SkillStoreToolOptions): SkillStoreTool;
+/**
+ * Create the skill_store_list tool.
+ */
+export declare function createSkillStoreListTool(options: SkillStoreToolOptions): SkillStoreTool;
+/**
+ * Create the skill_store_delete tool.
+ */
+export declare function createSkillStoreDeleteTool(options: SkillStoreToolOptions): SkillStoreTool;
+/** Zod schema for skill_store_search parameters */
+export declare const SkillStoreSearchParamsSchema: z.ZodObject<{
+    skill_id: z.ZodString;
+    query: z.ZodString;
+    collection: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    semantic: z.ZodOptional<z.ZodBoolean>;
+    min_similarity: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    user_email: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    skill_id: string;
+    limit?: number | undefined;
+    tags?: string[] | undefined;
+    semantic?: boolean | undefined;
+    user_email?: string | undefined;
+    collection?: string | undefined;
+    min_similarity?: number | undefined;
+}, {
+    query: string;
+    skill_id: string;
+    limit?: number | undefined;
+    tags?: string[] | undefined;
+    semantic?: boolean | undefined;
+    user_email?: string | undefined;
+    collection?: string | undefined;
+    min_similarity?: number | undefined;
+}>;
+export type SkillStoreSearchParams = z.infer<typeof SkillStoreSearchParamsSchema>;
+/** Zod schema for skill_store_collections parameters */
+export declare const SkillStoreCollectionsParamsSchema: z.ZodObject<{
+    skill_id: z.ZodString;
+    user_email: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    skill_id: string;
+    user_email?: string | undefined;
+}, {
+    skill_id: string;
+    user_email?: string | undefined;
+}>;
+export type SkillStoreCollectionsParams = z.infer<typeof SkillStoreCollectionsParamsSchema>;
+/** Zod schema for skill_store_aggregate parameters */
+export declare const SkillStoreAggregateParamsSchema: z.ZodObject<{
+    skill_id: z.ZodString;
+    collection: z.ZodOptional<z.ZodString>;
+    operation: z.ZodEnum<["count", "count_by_tag", "count_by_status", "latest", "oldest"]>;
+    since: z.ZodOptional<z.ZodString>;
+    until: z.ZodOptional<z.ZodString>;
+    user_email: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    skill_id: string;
+    operation: "count" | "count_by_tag" | "count_by_status" | "latest" | "oldest";
+    user_email?: string | undefined;
+    collection?: string | undefined;
+    since?: string | undefined;
+    until?: string | undefined;
+}, {
+    skill_id: string;
+    operation: "count" | "count_by_tag" | "count_by_status" | "latest" | "oldest";
+    user_email?: string | undefined;
+    collection?: string | undefined;
+    since?: string | undefined;
+    until?: string | undefined;
+}>;
+export type SkillStoreAggregateParams = z.infer<typeof SkillStoreAggregateParamsSchema>;
+/**
+ * Create the skill_store_search tool.
+ */
+export declare function createSkillStoreSearchTool(options: SkillStoreToolOptions): SkillStoreTool;
+/**
+ * Create the skill_store_collections tool.
+ */
+export declare function createSkillStoreCollectionsTool(options: SkillStoreToolOptions): SkillStoreTool;
+/**
+ * Create the skill_store_aggregate tool.
+ */
+export declare function createSkillStoreAggregateTool(options: SkillStoreToolOptions): SkillStoreTool;
+//# sourceMappingURL=skill-store.d.ts.map

package/dist/tools/skill-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-store.d.ts","sourceRoot":"","sources":["../../src/tools/skill-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAyChD,gDAAgD;AAChD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgBpC,CAAA;AACF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAE3E,gDAAgD;AAChD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;EAKpC,CAAA;AACF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAE3E,iDAAiD;AACjD,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUrC,CAAA;AACF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAA;AAE7E,mDAAmD;AACnD,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;EAKvC,CAAA;AACF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAA;AAEjF,yCAAyC;AACzC,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,MAAM,EAAE,OAAO,CAAA;IACf,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,wBAAwB;AACxB,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,IAAI,CAAA;IACb,IAAI,EAAE;QACJ,OAAO,EAAE,MAAM,CAAA;QACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KACjC,CAAA;CACF;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,KAAK,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,MAAM,oBAAoB,GAAG,qBAAqB,GAAG,qBAAqB,CAAA;AAEhF,mBAAmB;AACnB,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,SAAS,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,gCAAgC;AAChC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,CAAC,CAAC,OAAO,CAAA;IACrB,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAA;CAC5E;AA2CD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAyHtF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAgGtF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAuFvF;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CA0HzF;AAID,mDAAmD;AACnD,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYvC,CAAA;AACF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAA;AAEjF,wDAAwD;AACxD,eAAO,MAAM,iCAAiC;;;;;;;;;EAG5C,CAAA;AACF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAA;AAE3F,sDAAsD;AACtD,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;EAO1C,CAAA;AACF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAA;AAsHvF;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAyHzF;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAqF9F;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CA2E5F"}