@penclipai/plugin-sdk 2026.508.2 → 2026.511.0-canary.0

package/dist/testing.js

@@ -210,6 +210,8 @@ export function createTestHarness(options) {
     const agents = new Map();
     const goals = new Map();
     const projectWorkspaces = new Map();
+    const localFolderStatuses = new Map();
+    const localFolderFiles = new Map();
     const sessions = new Map();
     const sessionEventCallbacks = new Map();
     const events = [];
@@ -218,6 +220,41 @@ export function createTestHarness(options) {
     const dataHandlers = new Map();
     const actionHandlers = new Map();
     const toolHandlers = new Map();
+    function localFolderKey(companyId, folderKey) {
+        return `${companyId}:${folderKey}`;
+    }
+    function localFolderFileKey(companyId, folderKey, relativePath) {
+        return `${localFolderKey(companyId, folderKey)}:${relativePath}`;
+    }
+    function normalizeLocalFolderRelativePath(relativePath) {
+        const parts = [];
+        for (const segment of relativePath.split(/[\\/]+/)) {
+            if (!segment || segment === ".")
+                continue;
+            if (segment === "..")
+                throw new Error("Local folder path traversal is not allowed");
+            parts.push(segment);
+        }
+        return parts.join("/");
+    }
+    function notConfiguredLocalFolderStatus(folderKey) {
+        return {
+            folderKey,
+            configured: false,
+            path: null,
+            realPath: null,
+            access: "readWrite",
+            readable: false,
+            writable: false,
+            requiredDirectories: [],
+            requiredFiles: [],
+            missingDirectories: [],
+            missingFiles: [],
+            healthy: false,
+            problems: [{ code: "not_configured", message: "No local folder path is configured." }],
+            checkedAt: new Date().toISOString(),
+        };
+    }
     function issueRelationSummary(issueId) {
         const issue = issues.get(issueId);
         if (!issue)
@@ -306,7 +343,7 @@ export function createTestHarness(options) {
             },
             async configure(input) {
                 requireCapability(manifest, capabilitySet, "local.folders");
-                return {
+                const status = {
                     folderKey: input.folderKey,
                     configured: true,
                     path: input.path,
@@ -322,57 +359,102 @@ export function createTestHarness(options) {
                     problems: [],
                     checkedAt: new Date().toISOString(),
                 };
+                localFolderStatuses.set(localFolderKey(input.companyId, input.folderKey), status);
+                return status;
             },
-            async status(_companyId, folderKey) {
+            async status(companyId, folderKey) {
                 requireCapability(manifest, capabilitySet, "local.folders");
-                return {
-                    folderKey,
-                    configured: false,
-                    path: null,
-                    realPath: null,
-                    access: "readWrite",
-                    readable: false,
-                    writable: false,
-                    requiredDirectories: [],
-                    requiredFiles: [],
-                    missingDirectories: [],
-                    missingFiles: [],
-                    healthy: false,
-                    problems: [{ code: "not_configured", message: "No local folder path is configured." }],
-                    checkedAt: new Date().toISOString(),
-                };
+                return localFolderStatuses.get(localFolderKey(companyId, folderKey)) ?? notConfiguredLocalFolderStatus(folderKey);
             },
-            async list(_companyId, folderKey, options) {
+            async list(companyId, folderKey, options) {
                 requireCapability(manifest, capabilitySet, "local.folders");
+                const status = localFolderStatuses.get(localFolderKey(companyId, folderKey));
+                if (!status?.configured)
+                    throw new Error("Local folder is not configured");
+                const prefix = normalizeLocalFolderRelativePath(options?.relativePath ?? "");
+                const prefixWithSlash = prefix ? `${prefix}/` : "";
+                const entries = new Map();
+                for (const [key, contents] of localFolderFiles) {
+                    const filePrefix = `${localFolderKey(companyId, folderKey)}:`;
+                    if (!key.startsWith(filePrefix))
+                        continue;
+                    const filePath = key.slice(filePrefix.length);
+                    if (prefix && filePath !== prefix && !filePath.startsWith(prefixWithSlash))
+                        continue;
+                    const remainder = prefix ? filePath.slice(prefixWithSlash.length) : filePath;
+                    const [name] = remainder.split("/");
+                    if (!name)
+                        continue;
+                    const entryPath = prefix ? `${prefix}/${name}` : name;
+                    const isNested = remainder.includes("/");
+                    if (!options?.recursive && isNested) {
+                        entries.set(entryPath, {
+                            path: entryPath,
+                            name,
+                            kind: "directory",
+                            size: null,
+                            modifiedAt: null,
+                        });
+                        continue;
+                    }
+                    entries.set(filePath, {
+                        path: filePath,
+                        name: filePath.split("/").pop() ?? filePath,
+                        kind: "file",
+                        size: Buffer.byteLength(contents, "utf8"),
+                        modifiedAt: null,
+                    });
+                }
+                const maxEntries = options?.maxEntries && options.maxEntries > 0 ? options.maxEntries : entries.size;
+                const allEntries = [...entries.values()].sort((a, b) => a.path.localeCompare(b.path));
                 return {
                     folderKey,
                     relativePath: options?.relativePath ?? null,
-                    entries: [],
-                    truncated: false,
+                    entries: allEntries.slice(0, maxEntries),
+                    truncated: allEntries.length > maxEntries,
                 };
             },
-            async readText() {
+            async readText(companyId, folderKey, relativePath) {
                 requireCapability(manifest, capabilitySet, "local.folders");
-                throw new Error("Test harness local folder readText is not implemented");
+                const normalizedPath = normalizeLocalFolderRelativePath(relativePath);
+                const contents = localFolderFiles.get(localFolderFileKey(companyId, folderKey, normalizedPath));
+                if (contents === undefined)
+                    throw new Error(`Local folder file not found: ${relativePath}`);
+                return contents;
             },
-            async writeTextAtomic(_companyId, folderKey) {
+            async writeTextAtomic(companyId, folderKey, relativePath, contents) {
                 requireCapability(manifest, capabilitySet, "local.folders");
-                return {
+                const status = localFolderStatuses.get(localFolderKey(companyId, folderKey)) ?? {
                     folderKey,
-                    configured: false,
-                    path: null,
-                    realPath: null,
+                    configured: true,
+                    path: `memory://${manifest.id}/${companyId}/${folderKey}`,
+                    realPath: `memory://${manifest.id}/${companyId}/${folderKey}`,
                     access: "readWrite",
-                    readable: false,
-                    writable: false,
+                    readable: true,
+                    writable: true,
                     requiredDirectories: [],
                     requiredFiles: [],
                     missingDirectories: [],
                     missingFiles: [],
-                    healthy: false,
-                    problems: [{ code: "not_configured", message: "No local folder path is configured." }],
+                    healthy: true,
+                    problems: [],
                     checkedAt: new Date().toISOString(),
                 };
+                if (status.access !== "readWrite" || !status.writable) {
+                    throw new Error("Local folder is not configured for writes");
+                }
+                localFolderStatuses.set(localFolderKey(companyId, folderKey), status);
+                localFolderFiles.set(localFolderFileKey(companyId, folderKey, normalizeLocalFolderRelativePath(relativePath)), contents);
+                return status;
+            },
+            async deleteFile(companyId, folderKey, relativePath) {
+                requireCapability(manifest, capabilitySet, "local.folders");
+                const status = localFolderStatuses.get(localFolderKey(companyId, folderKey)) ?? notConfiguredLocalFolderStatus(folderKey);
+                if (status.configured && (status.access !== "readWrite" || !status.writable)) {
+                    throw new Error("Local folder is not configured for writes");
+                }
+                localFolderFiles.delete(localFolderFileKey(companyId, folderKey, normalizeLocalFolderRelativePath(relativePath)));
+                return status;
             },
         },
         events: {
@@ -771,14 +853,14 @@ export function createTestHarness(options) {
                         concurrencyPolicy: declaration.concurrencyPolicy ?? "coalesce_if_active",
                         catchUpPolicy: declaration.catchUpPolicy ?? "skip_missed",
                         variables: declaration.variables ?? [],
+                        latestRevisionId: null,
+                        latestRevisionNumber: 1,
                         createdByAgentId: null,
                         createdByUserId: null,
                         updatedByAgentId: null,
                         updatedByUserId: null,
                         lastTriggeredAt: null,
                         lastEnqueuedAt: null,
-                        latestRevisionId: null,
-                        latestRevisionNumber: 1,
                         createdAt: now,
                         updatedAt: now,
                         managedByPlugin: {
@@ -869,6 +951,173 @@ export function createTestHarness(options) {
                 },
             },
         },
+        skills: {
+            managed: {
+                async get(skillKey, companyId) {
+                    requireCapability(manifest, capabilitySet, "skills.managed");
+                    const declaration = manifest.skills?.find((skill) => skill.skillKey === skillKey);
+                    if (!declaration) {
+                        return {
+                            pluginKey: manifest.id,
+                            resourceKind: "skill",
+                            resourceKey: skillKey,
+                            companyId,
+                            skillId: null,
+                            skill: null,
+                            status: "missing",
+                            defaultDrift: null,
+                        };
+                    }
+                    const externalId = `${manifest.id}:skill:${skillKey}`;
+                    const existingEntity = [...entities.values()].find((entity) => entity.entityType === "managed_resource"
+                        && entity.scopeKind === "company"
+                        && entity.scopeId === companyId
+                        && entity.externalId === externalId);
+                    const existingSkill = existingEntity?.data?.skill;
+                    if (existingSkill && existingSkill.companyId === companyId) {
+                        return {
+                            pluginKey: manifest.id,
+                            resourceKind: "skill",
+                            resourceKey: skillKey,
+                            companyId,
+                            skillId: existingSkill.id,
+                            skill: existingSkill,
+                            status: "resolved",
+                            defaultDrift: null,
+                        };
+                    }
+                    return {
+                        pluginKey: manifest.id,
+                        resourceKind: "skill",
+                        resourceKey: skillKey,
+                        companyId,
+                        skillId: null,
+                        skill: null,
+                        status: "missing",
+                        defaultDrift: null,
+                    };
+                },
+                async reconcile(skillKey, companyId) {
+                    const existing = await this.get(skillKey, companyId);
+                    if (existing.skill)
+                        return existing;
+                    const declaration = manifest.skills?.find((skill) => skill.skillKey === skillKey);
+                    if (!declaration)
+                        return existing;
+                    const now = new Date();
+                    const skill = {
+                        id: randomUUID(),
+                        companyId,
+                        key: `plugin/${manifest.id.replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "")}/${skillKey}`,
+                        slug: declaration.slug ?? skillKey,
+                        name: declaration.displayName,
+                        description: declaration.description ?? null,
+                        markdown: declaration.markdown ?? `# ${declaration.displayName}\n`,
+                        sourceType: "catalog",
+                        sourceLocator: null,
+                        sourceRef: null,
+                        trustLevel: "markdown_only",
+                        compatibility: "compatible",
+                        fileInventory: [{ path: "SKILL.md", kind: "skill" }],
+                        metadata: {
+                            sourceKind: "catalog",
+                            pluginManagedResource: {
+                                pluginKey: manifest.id,
+                                resourceKind: "skill",
+                                resourceKey: skillKey,
+                            },
+                        },
+                        createdAt: now,
+                        updatedAt: now,
+                    };
+                    const nowIso = now.toISOString();
+                    const record = {
+                        id: randomUUID(),
+                        entityType: "managed_resource",
+                        scopeKind: "company",
+                        scopeId: companyId,
+                        externalId: `${manifest.id}:skill:${skillKey}`,
+                        title: declaration.displayName,
+                        status: null,
+                        data: { resourceKind: "skill", resourceKey: skillKey, skillId: skill.id, skill },
+                        createdAt: nowIso,
+                        updatedAt: nowIso,
+                    };
+                    entities.set(record.id, record);
+                    return {
+                        pluginKey: manifest.id,
+                        resourceKind: "skill",
+                        resourceKey: skillKey,
+                        companyId,
+                        skillId: skill.id,
+                        skill,
+                        status: "created",
+                        defaultDrift: null,
+                    };
+                },
+                async reset(skillKey, companyId) {
+                    requireCapability(manifest, capabilitySet, "skills.managed");
+                    const existing = await this.get(skillKey, companyId);
+                    const declaration = manifest.skills?.find((skill) => skill.skillKey === skillKey);
+                    if (!declaration)
+                        return existing;
+                    const now = new Date();
+                    const skill = {
+                        id: existing.skill?.id ?? randomUUID(),
+                        companyId,
+                        key: `plugin/${manifest.id.replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "")}/${skillKey}`,
+                        slug: declaration.slug ?? skillKey,
+                        name: declaration.displayName,
+                        description: declaration.description ?? null,
+                        markdown: declaration.markdown ?? `# ${declaration.displayName}\n`,
+                        sourceType: "catalog",
+                        sourceLocator: null,
+                        sourceRef: null,
+                        trustLevel: "markdown_only",
+                        compatibility: "compatible",
+                        fileInventory: [{ path: "SKILL.md", kind: "skill" }],
+                        metadata: {
+                            sourceKind: "catalog",
+                            pluginManagedResource: {
+                                pluginKey: manifest.id,
+                                resourceKind: "skill",
+                                resourceKey: skillKey,
+                            },
+                        },
+                        createdAt: existing.skill?.createdAt ?? now,
+                        updatedAt: now,
+                    };
+                    const nowIso = now.toISOString();
+                    const existingEntity = [...entities.values()].find((entity) => entity.entityType === "managed_resource" &&
+                        entity.scopeKind === "company" &&
+                        entity.scopeId === companyId &&
+                        entity.externalId === `${manifest.id}:skill:${skillKey}`);
+                    const record = {
+                        id: existingEntity?.id ?? randomUUID(),
+                        entityType: "managed_resource",
+                        scopeKind: "company",
+                        scopeId: companyId,
+                        externalId: `${manifest.id}:skill:${skillKey}`,
+                        title: declaration.displayName,
+                        status: null,
+                        data: { resourceKind: "skill", resourceKey: skillKey, skillId: skill.id, skill },
+                        createdAt: existingEntity?.createdAt ?? nowIso,
+                        updatedAt: nowIso,
+                    };
+                    entities.set(record.id, record);
+                    return {
+                        pluginKey: manifest.id,
+                        resourceKind: "skill",
+                        resourceKey: skillKey,
+                        companyId,
+                        skillId: skill.id,
+                        skill,
+                        status: "reset",
+                        defaultDrift: null,
+                    };
+                },
+            },
+        },
         companies: {
             async list(input) {
                 requireCapability(manifest, capabilitySet, "companies.read");
@@ -934,7 +1183,7 @@ export function createTestHarness(options) {
                     title: input.title,
                     description: input.description ?? null,
                     status: input.status ?? "todo",
-                    workMode: input.workMode ?? "standard",
+                    workMode: "standard",
                     priority: input.priority ?? "medium",
                     assigneeAgentId: input.assigneeAgentId ?? null,
                     assigneeUserId: input.assigneeUserId ?? null,
@@ -951,7 +1200,7 @@ export function createTestHarness(options) {
                     originRunId: input.originRunId ?? null,
                     requestDepth: input.requestDepth ?? 0,
                     billingCode: input.billingCode ?? null,
-                    assigneeAdapterOverrides: null,
+                    assigneeAdapterOverrides: input.assigneeAdapterOverrides ?? null,
                     executionWorkspaceId: input.executionWorkspaceId ?? null,
                     executionWorkspacePreference: input.executionWorkspacePreference ?? null,
                     executionWorkspaceSettings: input.executionWorkspaceSettings ?? null,