developer-tools Static interface comparison

jobseek

0.3.0 0.4.0

FAILPending human review

3 new write capabilities require explicit review.

View the upgrade review as Markdown

A shareable summary of this comparison for an issue, pull request or ticket. Select the text and copy it.

Tools6 → 9
Added3
Removed0
Schema changes3
Input schema changes3
Output schema changes0
Unclassified schema changes0
Description changes6
New write authority3
New destructive authority0
New unknown authority0
AnalysisFAIL

INTERFACE DIFF

What changed, tool by tool

Classification from the recorded findings · definitions from the published snapshots

9 tools with recorded changes

  1. get_job_detailModifiedDescriptionINFO

    What changed

    • get_job_detail: description changed.

    Why it could matter

    • Models choose and call tools partly from their descriptions.

    What to verify

    • Spot-check that agents still select this tool as intended.
    Declared effect
    read → read
    Description
    PreviousGet full structured metadata for a job posting by ID. Returns salary, technologies, seniority, experience, and locations. Does not include the job description — visit the returned URL on jseek.co to read the full posting. Use posting IDs from search_jobs results.
    CurrentInspect a job returned by search_jobs using its posting ID. Returns title, company, locations, seniority, technologies, salary with original currency/period, experience, employment type, firstSeenAt and the posting URL. Fields may be missing or null; do not infer missing salary or experience. The full description and application are accessed through the returned URL, not this tool.

    Input schema

    Input schema unchanged.

    3 unchanged entries
    • (schema root)
    • id
    • locale

    No output schema is recorded for this tool in either release.

    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool
  2. give_feedbackAddedAuthorityFAIL

    What changed

    • New tool give_feedback, declared with write effect.

    Why it could matter

    • Agents connected to this release can be offered an operation that changes data, which the earlier release did not expose.

    What to verify

    • Review whether this operation should be exposed through your agent’s tool configuration.
    Declared effect
    — → write

    Input schema

    PropertyPrevious (0.3.0)Current (0.4.0)Change
    (schema root)not presentobject, additionalProperties=false
    • Added
    affectedToolnot presentstring, enum (9)optional
    • Added
    goalnot presentstring, maxLength=500, minLength=1required
    • Added
    improvementnot presentstring, maxLength=1000, minLength=1optional
    • Added
    observationnot presentstring, maxLength=1000, minLength=1required
    • Added

    Output schema

    PropertyPrevious (0.3.0)Current (0.4.0)Change
    (schema root)not presentobject, additionalProperties=false
    • Added
    successnot presentboolean, const=truerequired
    • Added
    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool
  3. list_taxonomiesModifiedDescriptionINFO

    What changed

    • list_taxonomies: description changed.

    Why it could matter

    • Models choose and call tools partly from their descriptions.

    What to verify

    • Spot-check that agents still select this tool as intended.
    Declared effect
    read → read
    Description
    PreviousList all valid values for a taxonomy type (seniority levels, occupations, technologies, or industries). Use this to discover available filter values before searching.
    CurrentDiscover Job Seek's available seniority, occupation and technology filter values, or industry suggestions. Seniority items contain slugs/names; occupations and technologies are grouped; industry suggestions contain IDs/names and are not a search_jobs filter. Use resolve_slugs for locations and specific freetext matches. The same English data is available as jobseek://taxonomies/{type} resources.

    Input schema

    Input schema unchanged.

    3 unchanged entries
    • (schema root)
    • locale
    • type

    No output schema is recorded for this tool in either release.

    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool
  4. report_bugAddedAuthorityFAIL

    What changed

    • New tool report_bug, declared with write effect.

    Why it could matter

    • Agents connected to this release can be offered an operation that changes data, which the earlier release did not expose.

    What to verify

    • Review whether this operation should be exposed through your agent’s tool configuration.
    Declared effect
    — → write

    Input schema

    PropertyPrevious (0.3.0)Current (0.4.0)Change
    (schema root)not presentobject, additionalProperties=false
    • Added
    affectedToolnot presentstring, enum (9)optional
    • Added
    expectednot presentstring, maxLength=1000, minLength=1required
    • Added
    goalnot presentstring, maxLength=500, minLength=1required
    • Added
    impactnot presentstring, enum (3)required
    • Added
    observednot presentstring, maxLength=1000, minLength=1required
    • Added
    reproductionnot presentstring, maxLength=1000, minLength=1optional
    • Added
    workaroundnot presentstring, maxLength=500, minLength=1optional
    • Added

    Output schema

    PropertyPrevious (0.3.0)Current (0.4.0)Change
    (schema root)not presentobject, additionalProperties=false
    • Added
    successnot presentboolean, const=truerequired
    • Added
    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool
  5. resolve_slugsModifiedSchemaDescriptionREVIEWINFO

    What changed

    • resolve_slugs — Schema change: input property q changed: +minLength=2.
    • resolve_slugs: description changed.

    Why it could matter

    • Calls or consumers built for the earlier schema may need to change.
    • Models choose and call tools partly from their descriptions.

    What to verify

    • Validate representative existing tool calls against the new argument schema.
    • Spot-check that agents still select this tool as intended.
    Declared effect
    read → read
    Description
    PreviousConvert freetext to exact taxonomy slugs needed for filter parameters. ALWAYS call this before using loc/occ/sen/tech params in search_jobs. For example, resolve 'Zurich' to get the slug 'zurich', or 'machine learning' to get 'machine-learning'.
    CurrentFind matching locations, occupations, seniority levels, technologies or industries from freetext and return their current slugs and names. Use it before loc/occ/sen/tech filters when you do not already have a slug returned by Job Seek. Pick from returned matches; clarify ambiguity and do not invent slugs. Industries are discovery information, not a search_jobs filter.

    Input schema

    PropertyPrevious (0.3.0)Current (0.4.0)Change
    qstringrequiredstring, minLength=2required
    • Constraint: minLength

    minLength: — → 2

    3 unchanged entries
    • (schema root)
    • locale
    • type

    No output schema is recorded for this tool in either release.

    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool
  6. search_companiesModifiedSchemaDescriptionREVIEWINFO

    What changed

    • search_companies — Schema change: input property q changed: +minLength=2.
    • search_companies: description changed.

    Why it could matter

    • Calls or consumers built for the earlier schema may need to change.
    • Models choose and call tools partly from their descriptions.

    What to verify

    • Validate representative existing tool calls against the new argument schema.
    • Spot-check that agents still select this tool as intended.
    Declared effect
    read → read
    Description
    PreviousSearch companies by name on jseek.co. Returns up to 10 matching companies with links to their company pages.
    CurrentFind companies in Job Seek's current catalogue by name. Returns up to 10 matches with names, slugs, icons and company-page URLs. Open a returned company page to browse that company's listings. Company slugs can prefill create_watchlist_link; search_jobs does not accept a company filter.

    Input schema

    PropertyPrevious (0.3.0)Current (0.4.0)Change
    qstringrequiredstring, minLength=2required
    • Constraint: minLength

    minLength: — → 2

    2 unchanged entries
    • (schema root)
    • locale

    No output schema is recorded for this tool in either release.

    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool
  7. search_jobsModifiedSchemaDescriptionREVIEWINFO

    What changed

    • search_jobs — Schema change: input property exp changed: description "Experience range i… → "Experience bounds ….
    • search_jobs — Schema change: input property lang changed: description "Job document langu… → "Two-letter posting….
    • search_jobs — Schema change: input property sal changed: description "Salary range in EU… → "Salary bounds in E….
    • search_jobs: description changed.

    Why it could matter

    • Calls or consumers built for the earlier schema may need to change.
    • Models choose and call tools partly from their descriptions.

    What to verify

    • Validate representative existing tool calls against the new argument schema.
    • Spot-check that agents still select this tool as intended.
    Declared effect
    read → read
    Description
    PreviousSearch job postings across companies on jseek.co. Returns up to 5 companies with their top 3 matching postings. The 'q' parameter accepts freetext keywords. All filter params (loc, occ, sen, tech) require exact slugs — use resolve_slugs first to convert freetext to slugs.
    CurrentFind matching jobs sourced directly from company career pages: keywords, location, occupation, seniority, technology, remote/hybrid/onsite, employment type, EUR salary, experience and document language. Returns up to 5 companies with up to 3 posting summaries each, totalCompanies and a moreAt browsing link; no pagination or company filter. q accepts freetext; loc/occ/sen/tech use exact slugs returned by resolve_slugs or list_taxonomies. Use get_job_detail for salary and other available metadata, and create_watchlist_link for email-alert setup.

    Input schema

    PropertyPrevious (0.3.0)Current (0.4.0)Change
    expstring, pattern="^\\s*(?:\\d+\\s*-\\s*\\d+|\\d+\\s*-\\s*|-\\s*\\d+)\\s*$"optionalstring, pattern="^\\s*(?:\\d+\\s*-\\s*\\d+|\\d+\\s*-\\s*|-\\s*\\d+)\\s*$"optional
    • Description changed
    langstring, pattern="^\\s*(?:en|de|fr|it)(?:\\s*,\\s*(?:en|de|fr|it))*\\s*$"optionalstring, pattern="^\\s*(?:en|de|fr|it)(?:\\s*,\\s*(?:en|de|fr|it))*\\s*$"optional
    • Description changed
    salstring, pattern="^\\s*(?:\\d+\\s*-\\s*\\d+|\\d+\\s*-\\s*|-\\s*\\d+)\\s*$"optionalstring, pattern="^\\s*(?:\\d+\\s*-\\s*\\d+|\\d+\\s*-\\s*|-\\s*\\d+)\\s*$"optional
    • Description changed
    9 unchanged entries
    • (schema root)
    • etype
    • loc
    • locale
    • occ
    • q
    • sen
    • tech
    • wm

    No output schema is recorded for this tool in either release.

    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool
  8. suggest_featureAddedAuthorityFAIL

    What changed

    • New tool suggest_feature, declared with write effect.

    Why it could matter

    • Agents connected to this release can be offered an operation that changes data, which the earlier release did not expose.

    What to verify

    • Review whether this operation should be exposed through your agent’s tool configuration.
    Declared effect
    — → write

    Input schema

    PropertyPrevious (0.3.0)Current (0.4.0)Change
    (schema root)not presentobject, additionalProperties=false
    • Added
    affectedToolnot presentstring, enum (9)optional
    • Added
    benefitnot presentstring, maxLength=1000, minLength=1required
    • Added
    capabilitynot presentstring, maxLength=1000, minLength=1required
    • Added
    goalnot presentstring, maxLength=500, minLength=1required
    • Added
    impactnot presentstring, enum (3)required
    • Added
    workaroundnot presentstring, maxLength=500, minLength=1optional
    • Added

    Output schema

    PropertyPrevious (0.3.0)Current (0.4.0)Change
    (schema root)not presentobject, additionalProperties=false
    • Added
    successnot presentboolean, const=truerequired
    • Added
    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool

Evidence and provenance

Static findings
FAIL from Modelara’s automated analysis of the two declared interfaces. A policy outcome, not a security rating or a runtime test.
Human review
Pending human review. No reviewer decision is recorded for this comparison.
Published evidence
Part of Valyd’s published data generation listed in valyd-data-source.json. Published records are not rewritten.
Show provenance and exact files
Comparison
colophon-group-jobseek/0.3.0~0.4.0The published comparison identifier.
Analyzer
modelara v0.1.8Policy version not recorded.Analyzed Nov 17, 2026, 12:20 AM UTC.
Distribution
npm
Previous release
@jseek/mcp-server@0.3.06 tools · published by the registry Oct 6, 2026, 9:09 AM UTCArtifact integritysha512-Pc2G3eV38q1iuO6Lt+FdA7Vq0C/QmcPiWEe9aBl4VzbCl6GtkVjH/E+CB0Vls6TtaJav2TYgm34O5Dsu/jh9gg==Interface fingerprintsha256:15de002427527f2d8d4714b4db5d476949e99343d9859fa3b8a3f7e3d7531496Exact interface snapshot (JSON)
Current release
@jseek/mcp-server@0.4.09 tools · published by the registry Oct 8, 2026, 8:33 AM UTCArtifact integritysha512-xRkbAZ2KKy+R5yjGymDqOsvX8hlu9aeDyUBUyPXyma1HAwMvEF1/FX0pZR+wibsjNOnUFeVRr0t/axgt1jc1Ag==Interface fingerprintsha256:000cce117daa651c80f588639f417829a62540132daa532bbd23a620e076b8b5Exact interface snapshot (JSON)

The integrity value or digest identifies the exact artifact that was inspected; it does not show that the package is safe. The interface fingerprint identifies the declared tools and schemas Modelara recorded for that release.

MODELARA ANALYSIS OUTPUT

Interface findings

Analyzed with Modelara v0.1.8 · Nov 17, 2026

Policy failures

3 findings
  • give_feedbackFAILAdded

    New capability with write effect

    Authority
    —WRITE
  • report_bugFAILAdded

    New capability with write effect

    Authority
    —WRITE
  • suggest_featureFAILAdded

    New capability with write effect

    Authority
    —WRITE

Requires review

3 findings
  • resolve_slugsREVIEWChanged

    Input schema changed

    Show details
    • input property q changed: +minLength=2
    Authority
    READREAD
    Authority unchanged
  • search_companiesREVIEWChanged

    Input schema changed

    Show details
    • input property q changed: +minLength=2
    Authority
    READREAD
    Authority unchanged
  • search_jobsREVIEWChanged

    Input schema changed

    Show details
    • input property exp changed: description "Experience range i… → "Experience bounds …
    • input property lang changed: description "Job document langu… → "Two-letter posting…
    • input property sal changed: description "Salary range in EU… → "Salary bounds in E…
    Authority
    READREAD
    Authority unchanged

Informational

6 findings
  • create_watchlist_linkINFOChanged

    Description changed

    Authority
    READREAD
    Authority unchanged
  • get_job_detailINFOChanged

    Description changed

    Authority
    READREAD
    Authority unchanged
  • list_taxonomiesINFOChanged

    Description changed

    Authority
    READREAD
    Authority unchanged
  • resolve_slugsINFOChanged

    Description changed

    Authority
    READREAD
    Authority unchanged
  • search_companiesINFOChanged

    Description changed

    Authority
    READREAD
    Authority unchanged
  • search_jobsINFOChanged

    Description changed

    Authority
    READREAD
    Authority unchanged
What do these results mean?
PASS
No policy-significant interface change detected.
REVIEW
Interface changes require inspection.
FAIL
A policy-significant change was detected.
INVALID
The comparison could not be evaluated reliably.
← Back to jobseek release history