@hasna/skills 0.1.59 → 0.1.61

package/dist/cli/cli.test-utils.d.ts

@@ -1,8 +1,19 @@
 export declare const CLI_PATH: string;
 export declare const EXPECTED_ALL_SKILL_COUNT: number;
-export declare const EXPECTED_BASIC_SKILL_COUNT: 17;
+export declare const EXPECTED_BASIC_SKILL_COUNT: 8;
+export declare const EXPECTED_POPULATED_CATEGORY_COUNT: number;
 export declare const PACKAGE_VERSION: string;
-export declare const SLOW_TEST_TIMEOUT = 15000;
+/**
+ * Retained for the ~36 call sites that already pass it. NEW TESTS DO NOT NEED IT:
+ * every test file calls useDefaultTestTimeout(), so a subprocess test written
+ * with no timeout argument is already covered — which is the point, because
+ * remembering to annotate the next one is exactly what did not happen.
+ *
+ * Aliased rather than left at its old 15000 so this constant can never sit BELOW
+ * the suite default and quietly give the slowest tests in the suite the tightest
+ * ceiling in it.
+ */
+export declare const SLOW_TEST_TIMEOUT = 30000;
 export declare const CLEAN_CLI_HOME: string;
 export declare function runCli(args: string[], env?: Record<string, string>): Promise<{
     stdout: string;

package/dist/cli/commands/publish.d.ts

@@ -0,0 +1,30 @@
+import type { Command } from "commander";
+import { RemoteSkillsClient } from "../../lib/remote-client.js";
+import { type PackedSkillBundle } from "../../lib/skill-bundle.js";
+export interface PushSkillOptions {
+    dryRun?: boolean;
+    json?: boolean;
+    version?: string;
+    client?: RemoteSkillsClient | null;
+    /** Overrides the corpus location. Tests only. */
+    rootDir?: string;
+}
+export interface PushSkillResult {
+    slug: string;
+    path: string;
+    sha256: string;
+    fileCount: number;
+    bundleByteSize: number;
+    unpackedByteSize: number;
+    paths: string[];
+    published: boolean;
+    status?: number;
+    response?: unknown;
+}
+export declare class PushSkillError extends Error {
+    readonly detail?: string[] | undefined;
+    constructor(message: string, detail?: string[] | undefined);
+}
+export declare function registerPublish(parent: Command): void;
+export declare function pushSkill(name: string, options?: PushSkillOptions): Promise<PushSkillResult>;
+export type { PackedSkillBundle };

package/dist/cli/commands/registry.d.ts

@@ -1,2 +1,10 @@
 import type { Command } from "commander";
 export declare function registerRegistry(parent: Command): void;
+/**
+ * `skills pull` — fetch skills from the configured instance into this machine's corpus
+ * (~/.hasna/skills/installed/<name>/). Registered here beside `registry sync` because both
+ * are the "instance <-> local registry" surface. Once a skill is in the corpus,
+ * loadRegistry() shows it to `skills list --all` and the MCP `list_skills` with no further
+ * step.
+ */
+export declare function registerPull(parent: Command): void;

package/dist/index.d.ts

@@ -2,7 +2,7 @@
  * Hasna Skills - Open source skill library for AI coding agents
  *
  * Pin AI agent skills with a single command:
- *   skills pin image deepresearch
+ *   skills pin logo-design market-research-report
  *
  * Or use the interactive CLI:
  *   skills
@@ -12,20 +12,22 @@ export { installSkill, pinSkill, unpinSkill, getPinnedSkills, installSkillSource
 export { DEFAULT_EXPORT_DIR, PROJECT_CONFIG_FILE, SKILLS_PROJECT_DIR, ensureProjectConfig, getDisabledProjectSkills, getProjectConfigPath, getProjectStateDir, listPinnedSkills, loadProjectConfig, pinProjectSkill, saveProjectConfig, setSkillDisabled, unpinProjectSkill, type ProjectSkillPin, type SkillsProjectConfig, } from "./lib/project-state.js";
 export { appendRunEvent, completeSkillRun, createSkillRun, findSkillRun, getRunExportDir, listSkillRuns, updateSkillRun, writeRunLogs, type SkillRunArtifact, type SkillRunContext, type SkillRunRecord, type SkillRunStatus, } from "./lib/run-state.js";
 export { getSkillDocs, getSkillBestDoc, getSkillRequirements, runSkill, generateEnvExample, generateSkillMd, type SkillDocs, type SkillRequirements, } from "./lib/skillinfo.js";
-export { loadConfig, saveConfig, getConfigPath, type SkillsConfig, type ConfigScope, } from "./lib/config.js";
+export { loadConfig, saveConfig, unsetConfig, getConfigPath, type SkillsConfig, type ConfigScope, } from "./lib/config.js";
 export { buildSkillsApiUrl, getConfiguredApiUrl, loadRemoteRegistry, loadRemoteSkill, parseRemoteSkillPayload, parseRemoteRegistryPayload, type RemoteRegistryOptions, } from "./lib/remote-registry.js";
-export { ARTICLE_GENERATION_SLUG, getAllPremiumSlugs, getPublicSkillPricing, getSkillCatalogBillingFields, getSkillPricing, getSkillRunCostCents, isPremiumSkill, validateBlogArticleRunOptions, type BlogArticleRunOptions, type BlogArticleValidationResult, type PublicSkillPricing, type SkillPricing, } from "./lib/pricing.js";
-export { getCompactSkillDiscovery, getPublicSkillDiscovery, publicDiscoveryDependencies, publicDiscoveryDocumentation, publicDiscoveryEnvVars, publicDiscoveryPriceLabel, sanitizePublicDiscoveryText, type CompactSkillDiscovery, type PublicSkillDiscovery, } from "./lib/discovery.js";
+export { ARTICLE_GENERATION_SLUG, validateBlogArticleRunOptions, type BlogArticleRunOptions, type BlogArticleValidationResult, } from "./lib/blog-article.js";
+export { getCompactSkillDiscovery, getPublicSkillDiscovery, publicDiscoveryDependencies, publicDiscoveryDocumentation, publicDiscoveryEnvVars, sanitizePublicDiscoveryText, type CompactSkillDiscovery, type PublicSkillDiscovery, } from "./lib/discovery.js";
 export { TOOL_PRIMITIVE_SCHEMA_VERSION, TOOL_PRIMITIVES, createSkillToolDependencies, getSkillToolDependencies, getToolPrimitive, isGatewayBackedSkill, listToolPrimitives, validateToolPrimitiveCoverage, type SkillToolDependencies, type SkillToolDependency, type ToolPrimitive, type ToolPrimitiveCoverageIssue, type ToolPrimitiveCoverageResult, type ToolPrimitiveRuntime, type ToolPrimitiveSummary, } from "./lib/tool-primitives.js";
 export { RemoteSkillsClient, createRemoteSkillsClient, } from "./lib/remote-client.js";
 export { REMOTE_SKILL_RUN_CONTRACT_VERSION, normalizeRemoteSkillRunContract, type RemoteSkillRunContract, } from "./lib/remote-run-contract.js";
 export { addSchedule, listSchedules, removeSchedule, setScheduleEnabled, getDueSchedules, recordScheduleRun, validateCron, getNextRun, type SkillSchedule, } from "./lib/scheduler.js";
 export { parseSkillFrontmatter, validateRegistryConsistency, validateSkillDirectory, type RegistryConsistencyResult, type SkillFrontmatter, type SkillValidationMessage, type SkillValidationResult, } from "./lib/skill-validation.js";
-export { PORTABLE_SKILL_DEFAULT_VERSION, PORTABLE_SKILL_SCHEMA, PORTABLE_SKILL_STANDARD, findPortableSkill, getPortableSkillPath, getPortableSkillsRoot, listPortableSkillMetas, listPortableSkills, normalizePortableSkillName, portPortableSkill, portPortableSkillDirectory, readPortableSkillManifest, runPortableSkill, scaffoldPortableSkill, validatePortableSkillDirectory, type BulkPortImportedEntry, type BulkPortPortableSkillOptions, type BulkPortResult, type BulkPortSkippedEntry, type PortableSkillCommand, type PortableSkillInput, type PortableSkillManifest, type PortableSkillRunOptions, type PortableSkillRunResult, type PortableSkillSummary, type SkillKind, } from "./lib/portable-skills.js";
+export { PORTABLE_SKILL_DEFAULT_VERSION, PORTABLE_SKILL_SCHEMA, PORTABLE_SKILL_STANDARD, findPortableSkill, getPortableSkillPath, getPortableSkillsRoot, listPortableSkillMetas, listPortableSkills, normalizePortableSkillName, portPortableSkill, portPortableSkillDirectory, readPortableSkillManifest, runPortableSkill, scaffoldPortableSkill, validatePortableSkillDirectory, writeCorpusSkill, type BulkPortImportedEntry, type BulkPortPortableSkillOptions, type BulkPortResult, type BulkPortSkippedEntry, type CorpusSkillMeta, type PortableSkillCommand, type PortableSkillInput, type PortableSkillManifest, type PortableSkillRunOptions, type PortableSkillRunResult, type PortableSkillSummary, type SkillKind, type WriteCorpusSkillInput, } from "./lib/portable-skills.js";
+export { pullSkills, PullSkillError, type PullSkillsOptions, type PullSkillsResult, type PulledSkillResult, type SkillPullClient, } from "./lib/pull.js";
+export { SYNC_AGENTS, SYNC_MARKER_FILE, SYNC_MARKER_MANAGED_BY, adaptSkillMdForAgent, agentGlobalSkillsDir, isSyncAgent, pointerSkillMd, removeManagedAgentSkill, resolveSyncAgents, syncSkillsToAgents, writeManagedAgentSkill, writeManagedSkillDir, type AgentSyncAction, type ManagedDirWriteResult, type SyncActionKind, type SyncAgent, type SyncMarker, type SyncSkillsOptions, type SyncSkillsResult, type WriteManagedAgentSkillParams, } from "./lib/agent-sync.js";
 export { SKILLS_CLI_MCP_PARITY, findSkillsParityForCliCommand, findSkillsParityForMcpTool, validateSkillsCliMcpParity, type SkillsCliMcpParityDomain, type SkillsCliMcpParityEntry, } from "./lib/cli-mcp-parity.js";
 export { createRegistrySyncArtifact, writeRegistrySyncArtifact, type RegistrySyncArtifact, type RegistrySyncOptions, type RegistrySyncSkill, } from "./lib/registry-sync.js";
 export { MCP_CONTRACT_SCHEMA_VERSION, createMcpContractManifest, createSkillMcpMetadata, describeMcpToolContracts, getMcpResourceContracts, getMcpToolDescriptions, listMcpToolContracts, summarizeMcpToolContract, type DescribedMcpToolContract, type JsonSchemaObject, type McpContractManifest, type McpResourceContract, type McpToolCategory, type McpToolContract, type McpToolSideEffect, type SkillMcpMetadata, type SkillMcpSchemaContract, type UnknownMcpToolContract, } from "./lib/mcp-contracts.js";
 export { getFeedbackDbPath, saveFeedback, type FeedbackCategory, type FeedbackInput, type FeedbackResult, } from "./lib/feedback.js";
-export { SKILLS_NATIVE_STORAGE_ENV, SKILLS_NATIVE_STORAGE_FALLBACK_ENV, SKILLS_STORAGE_ENV, SKILLS_STORAGE_FALLBACK_ENV, SKILLS_STORAGE_TABLES, STORAGE_TABLES, SkillsPostgresSyncStore, SkillsS3ObjectStore, buildSkillsS3ObjectUrl, createSkillsPostgresSyncStore, createSkillsS3ObjectStore, createSkillsSnapshotSyncRecord, exportSkillsLocalSnapshot, getSkillsNativeStorageStatus, getSkillsStorageDatabaseEnv, getSkillsStorageDatabaseUrl, getSkillsStorageMode, getSkillsStorageStatus, getStorageDatabaseEnv, getStorageDatabaseUrl, getStorageMode, getStorageStatus, importSkillsLocalSnapshot, planSkillsS3SnapshotUpload, resolveSkillsNativeStorageConfig, resolveStorageConfig, signSkillsAwsV4Request, skillsPostgresSyncSchemaSql, uploadSkillsSnapshotFilesToS3, type AwsCredentials, type SignSkillsAwsV4RequestOptions, type SkillsFetch, type SkillsLocalSnapshot, type SkillsNativeStorageConfig, type SkillsNativeStorageStatus, type SkillsPostgresQueryClient, type SkillsS3ObjectStoreOptions, type SkillsS3PutObjectOptions, type SkillsS3SnapshotPlanEntry, type SkillsS3StoredObject, type SkillsSnapshotFile, type SkillsStorageMode, type SkillsStorageTable, type SkillsSyncRecord, } from "./lib/native-storage.js";
+export { SKILLS_NATIVE_STORAGE_ENV, SKILLS_NATIVE_STORAGE_FALLBACK_ENV, SKILLS_STORAGE_ENV, SKILLS_STORAGE_FALLBACK_ENV, SKILLS_STORAGE_TABLES, STORAGE_TABLES, SkillsPostgresSyncStore, SkillsS3ObjectStore, buildSkillsS3ObjectUrl, createSkillsPostgresSyncStore, createSkillsS3ObjectStore, createSkillsSnapshotSyncRecord, exportSkillsLocalSnapshot, getSkillsNativeStorageStatus, getSkillsStorageDatabaseEnv, getSkillsStorageDatabaseUrl, getSkillsStorageStatus, getStorageDatabaseEnv, getStorageDatabaseUrl, getStorageStatus, importSkillsLocalSnapshot, planSkillsS3SnapshotUpload, resolveSkillsNativeStorageConfig, resolveStorageConfig, signSkillsAwsV4Request, skillsPostgresSyncSchemaSql, uploadSkillsSnapshotFilesToS3, type AwsCredentials, type SignSkillsAwsV4RequestOptions, type SkillsFetch, type SkillsLocalSnapshot, type SkillsNativeStorageConfig, type SkillsNativeStorageStatus, type SkillsPostgresQueryClient, type SkillsS3ObjectStoreOptions, type SkillsS3PutObjectOptions, type SkillsS3SnapshotPlanEntry, type SkillsS3StoredObject, type SkillsSnapshotFile, type SkillsStorageTable, type SkillsSyncRecord, } from "./lib/native-storage.js";
 export { SKILL_ALIASES, normalizeSkillSlug, resolveSkillAlias, type SkillAlias, } from "./lib/skill-aliases.js";
 export type { SkillResponse, SkillDetailResponse, CategoryResponse, TagResponse, InstallResponse, RemoveResponse, VersionResponse, ExportResponse, ImportResponse, SearchResponse, CategoryInstallResponse, ErrorResponse, } from "./types/api.js";